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

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

Restez à jour avec les derniers correctifs de sécurité accessibles au public. Consultez la page des bibliothèques FreeRTOS LTS pour les mises à jour, ou abonnez-vous au dépôt pour recevoir FreeRTOS-LTS GitHub les derniers correctifs LTS contenant des corrections de bogues critiques et de sécurité. Vous pouvez télécharger ou cloner les derniers correctifs FreeRTOS LTS requis directement à partir des référentiels individuels. GitHub
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 que les sockets sécurisés et les API Wifi ne sont pas requises par la dernière bibliothèque CoreMQTT. Voir Interface de transport pour 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 Amazon-FreeRTOS référentiel.

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 depuis le dépôt CoreHTTP (sous-module si vous utilisez git) dans l'organisation FreeRTOS Github. Les démos CoreHTTP se trouvent dans la distribution FreeRTOS principale. Pour plus de détails, consultez la page CoreHTTP.
Noyau MQTT	démos et bibliothèque	Clonez ou téléchargez la bibliothèque CoreMQTT directement depuis le dépôt CoreMQTT (sous-module si vous utilisez git) dans l'organisation FreeRTOS Github. Les démos de CoreMQTT se trouvent dans la distribution principale de FreeRTOS. Pour plus de détails, consultez la page CoreMQTT.
noyau MQTT-Agent	démos et bibliothèque	Clonez ou téléchargez la MQTT-Agent bibliothèque principale directement depuis le MQTT-Agent référentiel principal (sous-module si vous utilisez git) dans l'organisation FreeRTOS Github. Les principales MQTT-Agent démos se trouvent dans le MQTT-Agent-Demos référentiel principal. Pour plus de détails, reportez-vous à la MQTT-Agent page principale.
device_defender_pour_aws	démos et bibliothèque	La bibliothèque AWS IoT Device Defender se trouve dans son référentiel au AWS GitHub sein de l'organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuis le dépôt AWS IoT Device Defender. Les démos de AWS IoT Device Defender se trouvent dans la distribution principale de FreeRTOS. Pour plus de détails, consultez la page AWS IoT Device Defender.
device_shadow_for_aws	démos et bibliothèque	La bibliothèque AWS IoT Device Shadow se trouve dans son référentiel au AWS GitHub sein de l'organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuis le dépôt AWS IoT Device (Shadow). Les démos de AWS IoT Device Shadow se trouvent dans la distribution principale de FreeRTOS. Pour plus de détails, consultez la page AWS IoT Device Shadow.
jobs_for_aws	démos et bibliothèque	La bibliothèque AWS IoT d'emplois se trouve dans son référentiel au sein de l'AWS GitHub organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuis le dépôt AWS IoT Jobs. Les démos de AWS IoT Jobs se trouvent dans la distribution principale de FreeRTOS. Pour plus de détails, consultez la page AWS IoT Offres d'emploi.
OTA	démos et bibliothèque	La bibliothèque de mises à jour AWS IoT Over-The-Air (OTA) se trouve dans son référentiel au AWS GitHub sein de l'organisation. Clonez-le ou téléchargez-le (sous-module si vous utilisez git) directement depuis le dépôt AWS IoT OTA. Les démos AWS IoT OTA se trouvent dans la distribution principale de FreeRTOS. Pour plus de détails, consultez la page AWS IoT 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 à la page de l'interface de ligne de commande FreeRTOS Plus pour plus de détails. Les intégrations de référence FreeRTOS IoT présentées sur les plateformes NXP i.MX RT1060 et STM32U5 fournissent également des exemples de CLI sur du matériel réel.
journalisation	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 à la page de journalisation pour savoir comment implémenter la macro de journalisation. Reportez-vous à l'une des références IoT proposées par FreeRTOS pour un exemple d'exécution 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 la connexion à un appareil AWS IoT Greengrass. Un nouveau projet démontrant 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 l'organisation FreeRTOS 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 que NimBLE pour optimiser au mieux votre projet.
dev_mode_key_provisioning	démos	Les intégrations de référence FreeRTOS IoT présentées sur les plateformes NXP i.MX RT1060, STM32U5 ESP32-C3ou sur les 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 fournir des WiFi informations d'identification sur un appareil à l'aide de la bibliothèque Amazon-FreeRTOS BLE. Reportez-vous à la référence FreeRTOS Featured IoT sur la plateforme ESP32C3 pour un exemple de provisionnement via BLE. WiFi
API abstraites héritées	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 l'abstraction, des sockets sécurisés, etc. Ils sont pris en charge dans le Amazon-FreeRTOS référentiel et se trouvent dans le dossier`/libraries/abstractions/`. Ces API ne sont pas requises lors de l'utilisation des bibliothè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.

Third-party bibliothèques

Lorsque des démos 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 depuis le dépôt Cmock.
jsmn : non recommandé et n'est plus pris en charge.
lwip : clonez-le (sous-module si vous utilisez git) directement depuis le dépôt lwip-tcpip.
lwip_osal : reportez-vous aux intégrations de référence proposées par FreeRTOS sur i.MX RT1060 ou STM32U5 pour savoir comment implémenter lwip_osal sur votre matériel. platform/board
mbedtls : clonez-le (sous-module si vous utilisez git) directement depuis le dépôt. Mbed-TLS 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 la bibliothèque CorePKCS11 ou depuis le dépôt OASIS PKCS 11.
tinycbor : clonez-le (sous-module si vous utilisez git) directement depuis le dépôt tinycbor.
tinycrypt : 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 depuis le dépôt tinycrypt.
tracealyzer_recorder : clonez-le (sous-module si vous utilisez git) directement depuis le référentiel d'enregistreurs de traces de Percepio.
unity : clonez-le (sous-module si vous utilisez git) directement depuis le ThrowTheSwitch/Unitydépôt.
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 du /tests dossier requis pour valider l'intégration des bibliothèques FreeRTOS ont été migrés vers le référentiel. FreeRTOS-Libraries-Integration-Tests 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 par AWS IoT Device Tester (IDT) pour le programme de qualification des AWS appareils pour FreeRTOS.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Sécurité de l’infrastructure

Archivage