View a markdown version of this page

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

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à.

Amazon-FreeRTOS Guida alla migrazione del repository Github

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 per ricevere FreeRTOS-LTS GitHub 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. Le API astratte come i socket sicuri e le API Wifi non sono richieste 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 le API astratte all'interno del Amazon-FreeRTOS repository.

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.

core MQTT-Agent

demo e libreria

Clona o scarica la MQTT-Agent libreria principale direttamente dal MQTT-Agent repository principale (sottomodulo se usi git) nell'organizzazione Github di FreerTOS. Le demo principali si trovano nel repository principaleMQTT-Agent . MQTT-Agent-Demos Per maggiori dettagli, consulta la pagina principale MQTT-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 FreerTOS principale. Per maggiori dettagli, consulta la AWS IoT pagina OTA.

CLI e FreeRTOS_ Plus_CLI

demo e libreria

È in esecuzione un esempio 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 NXP i.MX RT1060 e STM32U5 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 Featured FreerTOS IoT sulle piattaforme NXP i.MX RT1060, STM32U5 ESP32-C3o NXP 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 fornire WiFi le credenziali su un dispositivo utilizzando la libreria BLE. Amazon-FreeRTOS Fai riferimento al riferimento FreerTOS Featured IoT sulla piattaforma ESP32C3 per un esempio di provisioning tramite BLE. WiFi

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 l' WiFi astrazione, socket sicuri e così via. Sono supportati nel Amazon-FreeRTOS repository e si trovano nella cartella. /libraries/abstractions/ Queste API non sono necessarie quando si utilizzano le librerie FreerTOS LTS.

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

Third-party librerie

Quando le demo Amazon-FreeRTOS utilizzano librerie di terze parti, consigliamo di sottomodularle direttamente dai rispettivi 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.