Guida alla migrazione del repository Github di Amazon-FreeRTOS - FreeRTOS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Guida alla migrazione del repository Github di Amazon-FreeRTOS

Se disponi di un progetto FreeRTOS esistente basato sull'ormai obsoleto repository amazon-freertos, segui questi passaggi:

  1. Rimani aggiornato sulle ultime correzioni di sicurezza disponibili pubblicamente. Controlla la pagina delle librerie FreerTOS LTS per gli aggiornamenti o iscriviti al repository GitHub FreerTOS-LTS per ricevere le ultime patch LTS con correzioni di bug critici e di sicurezza. Puoi scaricare o clonare le ultime patch FreerTOS LTS richieste direttamente dai singoli repository. GitHub

  2. Prendi in considerazione la possibilità di rifattorizzare l'implementazione dell'interfaccia di trasporto di rete per ottimizzare la tua piattaforma hardware. Aspetti astratti APIs come socket sicuri e Wifi non APIs sono richiesti dalla più recente libreria CoreMQTT. Vedi Transport Interface per ulteriori dettagli.

Appendice

La tabella seguente fornisce consigli per tutti i progetti demo, le librerie legacy e gli abstract APIs all'interno del repository Amazon-FreeRTOS.

Librerie e demo migrate
Nome Tipo Raccomandazioni

CoreHTTP

demo e libreria

Clona o scarica la libreria CoreHTTP direttamente dal repository CoreHTTP (sottomodulo se usi git) nell'organizzazione Github di FreerTOS. Le demo CoreHTTP si trovano nella distribuzione FreerTOS primaria. Per maggiori dettagli, consultate la pagina CoreHTTP.

CoreMQTT

demo e libreria

Clona o scarica la libreria CoreMQTT direttamente dal repository CoreMQTT (sottomodulo se usi git) nell'organizzazione Github di FreerTOS. Le demo di CoreMQTT si trovano nella distribuzione FreerTOS primaria. Per maggiori dettagli, consultate la pagina CoreMQTT.

Agente CoreMQTT

demo e libreria

Clona o scarica la libreria CoreMQTT-Agent direttamente dal repository CoreMQTT-Agent (sottomodulo se usi git) nell'organizzazione Github di FreerTOS. Le demo di CoreMQTT-Agent si trovano nel repository CoreMQTT-Agent-Demos. Per maggiori dettagli, consultate la pagina CoreMQTT-Agent.

device_defender_for_aws

demo e libreria

La libreria AWS IoT Device Defender si trova nel suo archivio all'interno dell'organizzazione.AWS GitHub Clonala o scaricala (sottomodulo se usi git) direttamente dal repository Device Defender.AWS IoT Le demo di AWS IoT Device Defender si trovano nella distribuzione FreerTOS principale. Per maggiori dettagli, consulta la pagina Device Defender AWS IoT .

device_shadow_for_aws

demo e libreria

La libreria AWS IoT Device Shadow si trova nel suo repository all'interno dell'AWS GitHub organizzazione. Clonalo o scaricalo (sottomodulo se usi git) direttamente dal repository AWS IoT Device (Shadow). Le demo di AWS IoT Device Shadow si trovano nella distribuzione FreerTOS principale. Per maggiori dettagli, consulta la pagina AWS IoT Device Shadow.

jobs_for_aws

demo e libreria

La libreria AWS IoT Jobs si trova nel relativo archivio all'interno dell'AWS GitHub organizzazione. Clonala o scaricala (sottomodulo se usi git) direttamente dal repository Jobs.AWS IoT Le demo AWS IoT di Jobs si trovano nella distribuzione principale di FreerTOS. Per maggiori dettagli, consulta la pagina Jobs.AWS IoT

OTA

demo e libreria

La libreria AWS IoT Over-The-Air (OTA) Update si trova nel relativo archivio all'interno dell'AWS GitHub organizzazione. Clonala o scaricala (sottomodulo se usi git) direttamente dal repository OTA.AWS IoT Le demo AWS IoT OTA si trovano nella distribuzione principale di FreerTOS. Per maggiori dettagli, consulta la AWS IoT pagina OTA.

CLI e FreerTOS_plus_CLI

demo e libreria

È in esecuzione un esempio di CLI. WinSim Consulta la pagina dell'interfaccia a riga di comando di FreerTOS Plus per maggiori dettagli. Le integrazioni di riferimento Featured FreerTOS IoT sulle piattaforme RT1 NXP i.MX STM32060 e U5 forniscono anche esempi CLI sull'hardware reale.

logging

macro

Esistono implementazioni della macro di registrazione per piattaforme hardware specifiche utilizzate da alcune librerie FreerTOS. Fate riferimento alla pagina di registrazione per sapere come implementare la macro di registrazione. Fai riferimento a uno dei riferimenti IoT presenti su FreerTOS per un esempio di esecuzione su hardware reale.

greengrass_connectivity

manifestazione

[Migrazione in corso] Questo progetto dimostrativo presupponeva che la connettività cloud fosse disponibile prima della connessione a un AWS IoT dispositivo Greengrass. È in fase di sviluppo un nuovo progetto che dimostra la capacità di autenticazione e scoperta locali. Aspettatevi che il nuovo progetto demo venga pubblicato a breve nell'organizzazione Github di FreerTOS.

Librerie e demo obsolete
Nome Tipo Raccomandazioni

BLU

demo e librerie

La libreria FreerTOS BLE implementa il protocollo MQTT proprietario e supporta la pubblicazione e la sottoscrizione di argomenti MQTT tramite Bluetooth Low Energy (BLE) tramite un dispositivo proxy come un telefono cellulare. Questo non è più obbligatorio. Usa il tuo stack BLE o un'opzione di terze parti come NimBLE per ottimizzare al meglio il tuo progetto.

dev_mode_key_provisioning

demo

Le integrazioni di riferimento IoT di Featured FreerTOS sulle piattaforme RT1 NXP i.MX STM32060, U5 o -C3 forniscono esempi di provisioning ESP32cruciale utilizzando una CLI.

posix

astrazione e demo

Non consigliato per l'uso.

wifi_provisioning

example

Questo esempio ha dimostrato come fornire WiFi le credenziali su un dispositivo utilizzando la libreria BLE Amazon-FreeRTOS. Fai riferimento al riferimento FreerTOS Featured IoT ESP32sulla piattaforma C3 per un WiFi esempio di provisioning tramite BLE.

Riassunto di Legacy APIs

code

Questi sono stati APIs creati per fornire un'interfaccia astratta per vari stack software di terze parti, moduli di connettività e piattaforme MCU di vari fornitori. Ad esempio, esistono interfacce per l' WiFi astrazione, socket sicuri e così via. Sono supportati nel repository Amazon-FreeRTOS e si trovano nella cartella. /libraries/abstractions/ Questi non APIs sono necessari quando si utilizzano le librerie FreerTOS LTS.

Le librerie e le demo nella tabella precedente non riceveranno patch di sicurezza o correzioni di bug.

Librerie di terze parti

Quando le demo in Amazon-FreeRTOS utilizzano librerie di terze parti, ti consigliamo di sottomodularle direttamente dai loro repository di terze parti.

Test di porting e test di integrazione

Tutti i test nella /tests cartella necessari per convalidare l'integrazione delle librerie FreerTOS sono stati migrati nel repository. FreeRTOS-Libraries-Integration-Tests Questi possono essere usati per testare l'implementazione PAL e l'integrazione delle librerie. Gli stessi test vengono utilizzati da AWS IoT Device Tester (IDT) per il AWS Device Qualification Program for FreerTOS.