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](https://www.freertos.org/lts-libraries.html) per gli aggiornamenti o iscriviti al repository per ricevere [FreeRTOS-LTS](https://github.com/FreeRTOS/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
1. 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](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) e le [API Wifi non sono richieste dalla più recente libreria](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html) CoreMQTT.](https://www.freertos.org/mqtt/index.html) [Vedi Transport Interface per ulteriori dettagli.](https://www.freertos.org/network-interface.html)
## 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](https://github.com/FreeRTOS/coreHTTP) (sottomodulo se usi git) nell'organizzazione Github di FreerTOS.](https://github.com/FreeRTOS) Le demo CoreHTTP si trovano nella distribuzione [FreerTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator) primaria. [Per maggiori dettagli, consultate la pagina CoreHTTP.](https://www.freertos.org/http/index.html) |
| CoreMQTT | demo e libreria | [Clona o scarica la libreria CoreMQTT direttamente dal repository [CoreMQTT (sottomodulo se usi git) nell'](https://github.com/FreeRTOS/coreMQTT)organizzazione Github di FreerTOS.](https://github.com/FreeRTOS) [Le demo di CoreMQTT si trovano nella distribuzione FreerTOS primaria.](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreMQTT_Windows_Simulator) [Per maggiori dettagli, consultate la pagina CoreMQTT.](https://www.freertos.org/mqtt/index.html) |
| core MQTT-Agent | demo e libreria | [Clona o scarica la MQTT-Agent libreria principale direttamente dal MQTT-Agent repository [principale](https://github.com/FreeRTOS/coreMQTT-Agent) (sottomodulo se usi git) nell'organizzazione Github di FreerTOS.](https://github.com/FreeRTOS) [Le demo principali si trovano nel repository principaleMQTT-Agent . MQTT-Agent-Demos](https://github.com/FreeRTOS/coreMQTT-Agent-Demos) Per maggiori dettagli, consulta la pagina [principale MQTT-Agent ](https://www.freertos.org/mqtt-agent/index.html). |
| device\_defender\_for\_aws | demo e libreria | [La libreria AWS IoT Device Defender si trova nel suo archivio all'interno dell'organizzazione.AWS GitHub ](https://github.com/AWS) [Clonala o scaricala (sottomodulo se usi git) direttamente dal repository Device Defender.AWS IoT](https://github.com/aws/Device-Defender-for-AWS-IoT-embedded-sdk) Le demo di AWS IoT Device Defender si trovano nella distribuzione [FreerTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Defender_Windows_Simulator/Device_Defender_Demo) principale. [Per maggiori dettagli, consulta la pagina Device Defender AWS IoT .](https://www.freertos.org/iot-device-defender/index.html) |
| device\_shadow\_for\_aws | demo e libreria | La libreria AWS IoT Device Shadow si trova nel suo repository all'interno dell'[AWS GitHub organizzazione](https://github.com/AWS). Clonalo o scaricalo (sottomodulo se usi git) direttamente dal repository [AWS IoT Device (Shadow](https://github.com/aws/Device-Shadow-for-AWS-IoT-embedded-sdk)). Le demo di AWS IoT Device Shadow si trovano nella distribuzione [FreerTOS principale](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Shadow_Windows_Simulator). Per maggiori dettagli, consulta la [pagina AWS IoT Device Shadow](https://www.freertos.org/iot-device-shadow/index.html). |
| jobs\_for\_aws | demo e libreria | [La libreria AWS IoT Jobs si trova nel relativo archivio all'interno dell'AWS GitHub organizzazione.](https://github.com/AWS) [Clonala o scaricala (sottomodulo se usi git) direttamente dal repository Jobs.AWS IoT](https://github.com/aws/Jobs-for-AWS-IoT-embedded-sdk) Le demo AWS IoT di Jobs si trovano nella distribuzione [principale di FreerTOS](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Jobs_Windows_Simulator/Jobs_Demo). [Per maggiori dettagli, consulta la pagina Jobs.AWS IoT](https://www.freertos.org/iot-jobs/index.html) |
| OTA | demo e libreria | [La libreria AWS IoT Over-The-Air (OTA) Update si trova nel relativo archivio all'interno dell'AWS GitHub organizzazione.](https://github.com/AWS) [Clonala o scaricala (sottomodulo se usi git) direttamente dal repository OTA.AWS IoT](https://github.com/aws/ota-for-aws-iot-embedded-sdk) Le demo AWS IoT OTA si trovano nella distribuzione [FreerTOS principale](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Ota_Windows_Simulator). [Per maggiori dettagli, consulta la AWS IoT pagina OTA.](https://www.freertos.org/ota/index.html) |
| 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](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_CLI/FreeRTOS_Plus_Command_Line_Interface.html) per maggiori dettagli. Le integrazioni di riferimento Featured FreerTOS IoT [sulle piattaforme NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) i.MX [RT1060](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) 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](https://www.freertos.org/logging.html) per sapere come implementare la macro di registrazione. Fai riferimento a [uno dei riferimenti IoT presenti su FreerTOS](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/logging) 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](https://github.com/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](https://mynewt.apache.org/latest/network/) 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](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c), STM32U5 [ ESP32-C3](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md)o NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c) 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](https://github.com/FreeRTOS/iot-reference-esp32c3) 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](https://www.freertos.org/lts-libraries.html). |
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.
+ **Cmock**[: clonalo (sottomodulo se usi git) direttamente dal repository Cmock.](https://github.com/ThrowTheSwitch/CMock)
+ **jsmn**: non consigliato e non più supportato.
+ **lwip**[: clonalo (sottomodulo se usi git) direttamente dal repository lwip-tcpip.](https://github.com/lwip-tcpip/lwip)
+ **lwip\_osal**[: fai riferimento alle FreerTOS Featured Reference Integrations su [i.MX RT1060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) o STM32U5 per sapere come implementare lwip\_osal sul tuo hardware.](https://github.com/FreeRTOS/iot-reference-stm32u5) platform/board
+ **mbedtls: clonalo** (sottomodulo se usi [Mbed-TLS](https://github.com/Mbed-TLS/mbedtls)git) direttamente dal repository. La configurazione e le utilità di mbedtls possono essere riutilizzate; in questo caso creane una copia locale.
+ **pkcs11** [https://github.com/FreeRTOS/corePKCS11](https://github.com/FreeRTOS/corePKCS11)
+ **tinycbor: clonalo (sottomodulo se usi git) direttamente dal repository tinycbor**[.](https://github.com/intel/tinycbor)
+ **tinycrypt**: 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 dal repository tinycrypt.](https://github.com/intel/tinycrypt)
+ **tracealyzer\_recorder: clonalo (sottomodulo se usi git) direttamente dal repository del trace recorder** [di Percepio.](https://github.com/percepio/TraceRecorderSource)
+ **unity**: clonalo (sottomodulo se usi git) direttamente dal repository. [ThrowTheSwitch/Unity](https://github.com/ThrowTheSwitch/Unity)
+ **win\_pcap: win\_pcap** non viene più mantenuto. Si consiglia di utilizzare invece libslirp, libpcap (posix) o npcap.
**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](https://github.com/FreeRTOS/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](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afr-qualification.html) Program for FreerTOS.