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. Resta aggiornato con il pubblico. Consulta.Librerie FreerTOS LTSpagina per gli aggiornamenti, oppure iscriviti alDa RT a. GitHub archivio 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 dall'utente GitHub archivi.

2. Prendi in considerazione la possibilità di rifattorizzare l'implementazione dell'interfaccia di trasporto di rete per ottimizzare la piattaforma hardware. Le API astratte comeprese sicureeAPI Wifinon sono richiesti dalla versione più recenteCore MQTTbiblioteca. VediInterfaccia di trasportoper ulteriori dettagli.

Appendice

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

Librerie e demo migrate
Nome	Type (Tipo)	Raccomandazioni
CoreHTTP	demo e libreria	Clona o scarica la libreria CoreHTTP con ilCoreHTTPrepository (sottomodulo se si usa git) nelOrganizzazione FreerTOS su Github. Le demo CoreHTTP si trovano indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.Pagina CoreHTTP.
CoreMQTT	demo e libreria	Clona o scarica la libreria CoreMQTT conCoreMQTTrepository (sottomodulo se si usa git) nelOrganizzazione FreerTOS su Github. Le demo di CoreMQTT si trovano indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.Pagina CoreMQTT.
Agente CoreMQTT	demo e libreria	Clona o scarica la libreria CoreMQTT-Agent direttamente dalAgente CoreMQTTrepository (sottomodulo se si usa git) nelOrganizzazione FreerTOS su Github. Le demo di CoreMQTT-Agent si trovano indemo di CoreMQTT-Agent-Demosdeposito. Per ulteriori informazioni, consulta.pagina CoreMQTT-Agent.
device_defender_per_aws	demo e libreria	LaAWS IoTLa libreria Device Defender si trova nel suo repository inAWS GitHub organizzazione. Clonalo o scaricalo (sottomodulo se usi git) direttamente dalAWS IoTDevice Defenderdeposito. IlAWS IoTLe demo di Device Defender sono disponibili indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.AWS IoTPagina Device Defender.
device_shadow_per_aws	demo e libreria	LaAWS IoTLa libreria Device Shadow si trova nel suo repository nelAWS GitHub organizzazione. Clonalo o scaricalo (sottomodulo se usi git) direttamente dalAWS IoTDevice Shadow) archivio. IlAWS IoTLe demo di Device Shadow sono disponibili indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.AWS IoTPagina Device Shadow.
offerte di lavoro per AWS	demo e libreria	LaAWS IoTLa libreria Jobs si trova nel suo archivio inAWS GitHub organizzazione. Clonalo o scaricalo (sottomodulo se usi git) direttamente dalAWS IoTLavorideposito. IlAWS IoTLe demo di Jobs sono disponibili indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.AWS IoTPagina delle offerte di lavoro.
OTA	demo e libreria	LaAWS IoTLo stack è aggiornato con ilAWS GitHub organizzazione. Clonalo o scaricalo (sottomodulo se usi git) direttamente dalAWS IoTOTAdeposito. IlAWS IoTLe demo OTA sono disponibili indistribuzione FreerTOS primaria. Per ulteriori informazioni, consulta.AWS IoTPagina OTA.
CLI e FreerTOS_plus_CLI	demo e libreria	Lo stack è aggiornato con WinSim. Fare riferimento alInterfaccia a riga di comandopagina per maggiori dettagli. Le integrazioni di riferimento FreerTOS IoT in primo piano suNXP i.MX RT1060eSTM32U5piattaforme, forniscono anche esempi CLI su hardware reale.
logging	macro	Esistono implementazioni della macro di registrazione per piattaforme hardware specifiche utilizzate da alcune librerie FreerTOS. Fate riferimento alpagina di registrazioneper come implementare la macro di registrazione. Fare riferimento auno dei riferimenti IoT con FreerTOSper esempio in esecuzione su hardware reale.
greengrass_connettività	manifestazione	[Migrazione in corso] Questo progetto dimostrativo presupponeva che la connettività cloud fosse disponibile prima della connessione a unAWS IoTDispositivo Greengrass. È in fase di sviluppo un nuovo progetto che dimostra la capacità di autenticazione e scoperta locali. Aspettatevi che il nuovo progetto dimostrativo venga pubblicato a breve nelOrganizzazione FreerTOS su Github.

Librerie e demo obsolete
Nome	Type (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. Non è più obbligatorio. Usa il tuo stack BLE o un'opzione di terze parti comeNimBLEper ottimizzare al meglio il tuo progetto.
dev_mode_key_provisioning	demo	Le integrazioni di riferimento FreerTOS IoT in primo piano suNXP i.MX RT1060,STM32U5, oppureESP32-C3le piattaforme forniscono esempi di provisioning cruciale utilizzando una CLI.
posix	astrazione e demo	Non consigliato per l'uso.
wifi_provisioning	example	Questo esempio ha dimostrato come effettuare il provisioning WiFi credenziali su un dispositivo che utilizza la libreria BLE Amazon-FreeRTOS. Fai riferimento al riferimento FreerTOS Featured IoT sulPiattaforma ESP32C3per un esempio di WiFi fornitura tramite BLE.
API astratte precedenti	code	Si tratta di API create per fornire un'interfaccia astratta per vari stack software di terze parti, moduli di connettività e piattaforme MCU di diversi fornitori. Ad esempio, esistono interfacce per WiFi astrazione, socket sicuri e così via. Sono supportati nel repository Amazon-FreeRTOS e si trovano nella cartella/libraries/abstractions/. Queste API non sono necessarie quando si utilizza ilLibrerie 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.

• CMOCK: clonalo (sottomodulo se usi git) direttamente dalCmockdeposito.

• jsmn: non consigliato e non è aggiornato.

• labbro: clonalo (sottomodulo se usi git) direttamente dallwip-tcpipdeposito.

• lwip_osal: fai riferimento alle integrazioni di riferimento in primo piano di FreerTOS sui.MX RT1060oSTM32U5per sapere come implementare lwip_osal sulla tua piattaforma hardware/scheda.

• mbedtls: clonalo (sottomodulo se usi git) direttamente dalMBed-TLSdeposito. La configurazione e le utilità di mbedtls possono essere riutilizzate; in questo caso creane una copia locale.

• pizze 11: clonalo (sottomodulo se usi git) direttamente da uno deicore PKCS 11biblioteca oIMMAGINI DI OASI 11deposito.

• minuscolo: clonalo (sottomodulo se usi git) direttamente daltinycbordeposito.

• minycrypt: ti consigliamo di utilizzare gli acceleratori di crittografia della tua piattaforma MCU, se disponibili. Se vuoi continuare a usare tinycrypt, clonalo (sottomodulo se usi git) direttamente daltinycryptdeposito.

• tracealyzer_recorder: clonalo (sottomodulo se usi git) direttamente da Percepioregistratore di traccedeposito.

• unità: clonalo (sottomodulo se usi git) direttamente dalThrowTheSwitch/Unitydeposito.

• win_pcap: win_pcap non viene più mantenuto. Si consiglia di utilizzare invece libslirp, libpcap (posix) o npcap.

Test di portabilità e test di integrazione

Tutti i test effettuati nell'ambito del/testsle cartelle necessarie per convalidare l'integrazione delle librerie FreerTOS sono state migrate alTest di integrazione delle librerie ERTOS gratuitideposito. Questi possono essere usati per testare l'implementazione PAL e l'integrazione delle librerie. Gli stessi test vengono utilizzati daAWS IoTDevice Tester (IDT) perAWSProgramma di qualificazione dei dispositivi per FreerTOS.