Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 :
-
Restez à jour avec les derniers correctifs de sécurité accessibles au public. VérifiezBibliothèques FreeRTOS LTS
page 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. -
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 MQTT
bibliothèque. VoirInterface 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 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 HTTP |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Noyau MQTT |
démos et bibliothèque |
Clonez ou téléchargez la bibliothèque CoreMQTT directement à partir deNoyau MQTT |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Agent MQTT de base |
démos et bibliothèque |
Clonez ou téléchargez la bibliothèque CoreMQTT-Agent directement depuisAgent MQTT de base |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 Plus |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 journalisation |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 queAgile |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dev_mode_key_provisioning |
démos |
Les intégrations de référence FreeRTOS IoT présentées surNXP i.MX RT1060 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 ESP32C3 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
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 depuisCmock
référentiel. -
jsmn: déconseillé et n'est plus pris en charge.
-
lwip: clonez-le (sous-module si vous utilisez git) directement depuislwip-tcpip
référentiel. -
lwip_osal: reportez-vous aux intégrations de référence proposées par FreeRTOS suri.MX RT1060
ouSTM32U5 pour savoir comment implémenter lwip_osal sur votre plate-forme/carte matérielle. -
mbedtls: clonez-le (sous-module si vous utilisez git) directement depuisMBED-TLS
ré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 PKCS11
la bibliothèque ouPHOTOS D'OASIS 11 référentiel. -
tinycbor: clonez-le (sous-module si vous utilisez git) directement depuistinycbor
ré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 crypte
référentiel. -
enregistreur Tracealyzer: clonez-le (sous-module si vous utilisez git) directement depuis Percepioenregistreur de traces
ré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/tests
le dossier requis pour valider l'intégration des bibliothèques FreeRTOS a été migré vers leTests d'intégration des bibliothèques FreeRTOS