Guide de migration du référentiel Github d'Amazon-FreeRTOS

Si vous avez un projet FreeRTOS existant basé sur le référentiel amazon-freertos désormais obsolète, procédez comme suit :

1. Restez à jour avec les derniers correctifs de sécurité accessibles au public. VérifiezBibliothèques FreeRTOS LTSpage pour les mises à jour, ou abonnez-vous auFreeRTOS-LTS GitHub référentiel pour recevoir les derniers correctifs LTS avec des corrections de bogues critiques et de sécurité. Vous pouvez télécharger ou cloner les derniers correctifs FreeRTOS LTS requis directement auprès de l'utilisateur GitHub référentiels.

2. Envisagez de refactoriser l'implémentation de l'interface de transport réseau afin d'optimiser votre plate-forme matérielle. Les API abstraites telles queprises sécuriséesetAPI Wifine sont pas exigés par le plus récentNoyau MQTTbibliothèque. VoirInterface de transportpour plus de détails.

Annexe

Le tableau suivant fournit des recommandations pour tous les projets de démonstration, les bibliothèques existantes et les API abstraites du référentiel Amazon-FreeRTOS.

Bibliothèques et démos migrées
Nom	Type	Recommandations
Noyau HTTP	démos et bibliothèque	Clonez ou téléchargez la bibliothèque CoreHTTP directement à partir deNoyau HTTPdépôt (sous-module si vous utilisez git) dansOrganisation FreeRTOS sur Github. Les démos de CoreHTTP se trouvent dans ledistribution FreeRTOS principale. Pour plus de détails, consultezPage HTTP de base.
Noyau MQTT	démos et bibliothèque	Clonez ou téléchargez la bibliothèque CoreMQTT directement à partir deNoyau MQTTdépôt (sous-module si vous utilisez git) dansOrganisation FreeRTOS sur Github. Les démos de CoreMQTT se trouvent dansdistribution FreeRTOS principale. Pour plus de détails, consultezLa page CoreMQTT.
Agent MQTT de base	démos et bibliothèque	Clonez ou téléchargez la bibliothèque CoreMQTT-Agent directement depuisAgent MQTT de basedépôt (sous-module si vous utilisez git) dansOrganisation FreeRTOS sur Github. Les démos de l'agent CoreMQTT se trouvent dansDémos de l'agent CoreMQTTréférentiel. Pour plus de détails, consultezPage de l'agent CoreMQTT.
device_defender_pour_aws	démos et bibliothèque	LeAWS IoTLa bibliothèque Device Defender se trouve dans son dépôt dans leAWS GitHub organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuisAWS IoTDéfenseur de l'appareilréférentiel. LeAWS IoTLes démos de Device Defender se trouvent dans ledistribution FreeRTOS principale. Pour plus de détails, consultezAWS IoTpage Device Defender.
device_shadow_for_aws	démos et bibliothèque	LeAWS IoTLa bibliothèque Device Shadow se trouve dans son dépôt dans leAWS GitHub organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuisAWS IoTDevice Shadow) référentiel. LeAWS IoTLes démos de Device Shadow se trouvent dans ledistribution FreeRTOS principale. Pour plus de détails, consultezAWS IoTpage Device Shadow.
jobs_for_aws	démos et bibliothèque	LeAWS IoTLa bibliothèque d'emplois se trouve dans son dépôt dans leAWS GitHub organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuisAWS IoTEmploisréférentiel. LeAWS IoTLes démos d'emplois se trouvent dans ledistribution FreeRTOS principale. Pour plus de détails, consultezAWS IoTPage d'offres d'emploi.
OTA	démos et bibliothèque	LeAWS IoTLa bibliothèque de mises à jour Over-The-Air (OTA) se trouve dans son dépôt dans leAWS GitHub organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuisAWS IoTOTAréférentiel. LeAWS IoTLes démos OTA se trouvent dans ledistribution FreeRTOS principale. Pour plus de détails, consultezAWS IoTPage OTA.
CLI et FreeRTOS_Plus_CLI	démos et bibliothèque	Un exemple de CLI est en cours d'exécution sur WinSim. Reportez-vous auInterface de ligne de commande FreeRTOS Pluspage pour plus de détails. Les intégrations de référence FreeRTOS IoT présentées surNXP i.MX RT1060etSTM32U5plateformes, fournissez également des exemples de CLI sur le matériel réel.
logging	macro	Il existe des implémentations de la macro de journalisation pour des plateformes matérielles spécifiques utilisées par certaines bibliothèques FreeRTOS. Reportez-vous àpage de journalisationpour savoir comment implémenter la macro de journalisation. Référez-vous àl'une des références relatives à l'IoT proposées par FreeRTOSpour un exemple exécuté sur du matériel réel.
greengrass connectivity	démo	[Migration en cours] Ce projet de démonstration partait du principe que la connectivité au cloud était disponible avant de se connecter à unAWS IoTAppareil Greengrass. Un nouveau projet qui démontre les capacités locales d'authentification et de découverte est en cours de développement. Attendez-vous à ce que le nouveau projet de démonstration soit publié prochainement dans leOrganisation FreeRTOS sur Github.

Bibliothèques et démos obsolètes
Nom	Type	Recommandations
BLE	démos et bibliothèques	La bibliothèque FreeRTOS BLE implémente le protocole propriétaire MQTT et prend en charge la publication et l'abonnement à des sujets MQTT via Bluetooth Low Energy (BLE) via un périphérique proxy tel qu'un téléphone mobile. Cela n'est plus obligatoire. Utilisez votre propre stack BLE ou une option tierce telle queAgilepour optimiser au mieux votre projet.
dev_mode_key_provisioning	démos	Les intégrations de référence FreeRTOS IoT présentées surNXP i.MX RT1060,STM32U5, ouESP32-C3les plateformes fournissent des exemples de provisionnement crucial à l'aide d'une CLI.
posix	abstraction et démo	L'utilisation n'est pas recommandée.
provisionnement wifi	exemple	Cet exemple montre comment approvisionner WiFi informations d'identification sur un appareil utilisant la bibliothèque Amazon FreeRTOS BLE. Reportez-vous à la référence FreeRTOS Featured IoT sur lePlateforme ESP32C3pour un exemple de WiFi approvisionnement via BLE.
API abstraites d'ancienne génération	code	Il s'agit d'API qui ont été créées pour fournir une interface abstraite pour diverses piles de logiciels tiers, modules de connectivité et plateformes de microcontrôleurs de divers fournisseurs. Par exemple, il existe des interfaces pour WiFi abstraction, sockets sécurisés, etc. Ils sont pris en charge dans le référentiel Amazon-FreeRTOS et se trouvent dans le dossier/libraries/abstractions/. Ces API ne sont pas requises lors de l'utilisation duBibliothèques FreeRTOS LTS.

Les bibliothèques et les démos du tableau ci-dessus ne recevront pas de correctifs de sécurité ni de corrections de bogues.

Bibliothèques tierces

Lorsque des démos dans Amazon-freeRTOS utilisent des bibliothèques tierces, nous vous recommandons de les sous-modules directement à partir de leurs référentiels tiers.

• Cmock: clonez-le (sous-module si vous utilisez git) directement depuisCmockréférentiel.

• jsmn: déconseillé et n'est plus pris en charge.

• lwip: clonez-le (sous-module si vous utilisez git) directement depuislwip-tcpipréférentiel.

• lwip_osal: reportez-vous aux intégrations de référence proposées par FreeRTOS suri.MX RT1060ouSTM32U5pour savoir comment implémenter lwip_osal sur votre plate-forme/carte matérielle.

• mbedtls: clonez-le (sous-module si vous utilisez git) directement depuisMBED-TLSréférentiel. La configuration et les utilitaires mbedtls peuvent être réutilisés ; faites une copie locale dans ce cas.

• pkcs11: clonez-le (sous-module si vous utilisez git) directement depuis l'un desCode PKCS11la bibliothèque ouPHOTOS D'OASIS 11référentiel.

• tinycbor: clonez-le (sous-module si vous utilisez git) directement depuistinycborréférentiel.

• minuscule crypte: nous vous recommandons d'utiliser les accélérateurs cryptographiques de votre plateforme MCU, s'ils sont disponibles. Si vous souhaitez continuer à utiliser tinycrypt, clonez-le (sous-module si vous utilisez git) directement à partir duminuscule crypteréférentiel.

• enregistreur Tracealyzer: clonez-le (sous-module si vous utilisez git) directement depuis Percepioenregistreur de tracesréférentiel.

• unité: clonez-le (sous-module si vous utilisez git) directement depuisThrowTheSwitch/Unitéréférentiel.

• win_pcap: win_pcap n'est plus maintenu. Nous vous recommandons d'utiliser libslirp, libpcap (posix) ou npcap à la place.

Tests de portage et tests d'intégration

Tous les tests effectués dans le cadre du/testsle dossier requis pour valider l'intégration des bibliothèques FreeRTOS a été migré vers leTests d'intégration des bibliothèques FreeRTOSréférentiel. Ils peuvent être utilisés pour tester la mise en œuvre de PAL et l'intégration de bibliothèques. Les mêmes tests sont utilisés parAWS IoTTesteur d'appareils (IDT) pourAWSProgramme de qualification des appareils pour FreeRTOS.