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](https://www.freertos.org/lts-libraries.html) per gli aggiornamenti o iscriviti al repository GitHub FreerTOS-LTS per ricevere [le](https://github.com/FreeRTOS/FreeRTOS-LTS) 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. [Aspetti astratti APIs come [socket sicuri](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) e [Wifi](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html) non APIs sono richiesti dalla più recente libreria CoreMQTT.](https://www.freertos.org/mqtt/index.html) Vedi [Transport Interface per](https://www.freertos.org/network-interface.html) 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](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) |
| Agente CoreMQTT | demo e libreria | [Clona o scarica la libreria CoreMQTT-Agent direttamente dal [repository CoreMQTT-Agent (sottomodulo se usi git) nell'organizzazione Github](https://github.com/FreeRTOS/coreMQTT-Agent) di FreerTOS.](https://github.com/FreeRTOS) Le demo di [CoreMQTT-Agent](https://github.com/FreeRTOS/coreMQTT-Agent-Demos) si trovano nel repository CoreMQTT-Agent-Demos. [Per maggiori dettagli, consultate la pagina CoreMQTT-Agent.](https://www.freertos.org/mqtt-agent/index.html) |
| device\$1defender\$1for\$1aws | 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\$1shadow\$1for\$1aws | 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\$1for\$1aws | 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 [principale di FreerTOS](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\$1plus\$1CLI | demo e libreria | È in esecuzione un esempio di 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 RT1 NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) i.MX [ STM32060 e](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) 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](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\$1connectivity | 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\$1mode\$1key\$1provisioning | demo | Le integrazioni di riferimento IoT di Featured FreerTOS [sulle piattaforme RT1 NXP](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c) i.MX [ STM32060](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c), U5 o -C3 forniscono esempi di provisioning [ ESP32cruciale](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md) utilizzando una CLI. |
| posix | astrazione e demo | Non consigliato per l'uso. |
| wifi\$1provisioning | 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](https://github.com/FreeRTOS/iot-reference-esp32c3) 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](https://www.freertos.org/lts-libraries.html). |
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 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\$1osal**[: fai riferimento alle FreerTOS Featured Reference Integrations su [i.MX RT1 060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) o STM32 U5 per sapere come implementare lwip\$1osal sulla tua piattaforma hardware/scheda.](https://github.com/FreeRTOS/iot-reference-stm32u5)
+ **[mbedtls: clonalo (sottomodulo se usi git) direttamente dal repository MBed-TLS.](https://github.com/Mbed-TLS/mbedtls)** 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\$1recorder: 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 /Unity. ThrowTheSwitch](https://github.com/ThrowTheSwitch/Unity)
+ win\$1pcap: **win\$1pcap** 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.