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 introduttiva al kit Cypress CY8 CKIT-064S0S2-4343W **Importante** Questa integrazione di riferimento è ospitata nel repository Amazon-FreeRTOS che è obsoleto. Ti consigliamo di [iniziare da qui quando crei un nuovo progetto](freertos-getting-started-modular.md). Se hai già un progetto FreeRTOS esistente basato sull'ormai obsoleto repository Amazon-FreerTOS, consulta il. [Guida alla migrazione del repository Github di Amazon-FreeRTOS](github-repo-migration.md) [Questo tutorial fornisce istruzioni per iniziare con il kit CKIT-064S0S2-4343W. CY8](https://www.cypress.com/CY8CKIT-064S0S2-4343W) Se non ne hai già uno, puoi utilizzare quel link per acquistare un kit. Puoi anche utilizzare quel link per accedere alla guida per l'utente del kit. ## Nozioni di base Prima di iniziare, devi configurare AWS IoT FreerTOS per connettere il tuo dispositivo al Cloud. AWS Per istruzioni, consulta [Fase iniziale](freertos-prereqs.md). Dopo aver completato i prerequisiti, avrai un pacchetto FreerTOS con le credenziali. AWS IoT Core **Nota** In questo tutorial, viene indicato il percorso della directory di download di FreerTOS creata nella sezione «Primi passi». `{{freertos}}` ## Configurazione dell'ambiente di sviluppo FreerTOS funziona con CMake un flusso di build o Make. Puoi usarlo ModusToolbox per il tuo flusso di compilazione Make. È possibile utilizzare l'IDE Eclipse fornito con ModusToolbox o un IDE partner come IAR EW-Arm, Arm MDK o Microsoft Visual Studio Code. L'IDE Eclipse è compatibile con i sistemi operativi Windows, macOS e Linux. [Prima di iniziare, scarica e installa il software più recenteModusToolbox .](https://www.cypress.com/products/modustoolbox-software-environment) Per ulteriori informazioni, consulta la [Guida all'ModusToolbox installazione](https://www.cypress.com/ModusToolboxInstallGuide). ### Strumenti di aggiornamento per la ModusToolbox versione 2.1 o precedente Se utilizzi l'IDE ModusToolbox 2.1 Eclipse per programmare questo kit, dovrai aggiornare gli strumenti OpenOCD e Firmware-Loader. Nei passaggi seguenti, per impostazione predefinita, il percorso per: `{{ModusToolbox}}` + Windows è`C:\Users\{{user_name}}\ModusToolbox`. + Linux è `{{user_home}}/ModusToolbox` o dove scegli di estrarre il file di archivio. + macOS si trova nella cartella Applicazioni del volume selezionato nella procedura guidata. #### Aggiornamento di OpenOCD Questo kit richiede Cypress OpenOCD 4.0.0 o successivo per cancellare e programmare correttamente il chip. **Per aggiornare Cypress OpenOCD** 1. Vai alla pagina di rilascio di [Cypress OpenOCD](https://github.com/Infineon/openocd/releases). 1. Scarica il file di archivio per il tuo sistema operativo (). Windows/Mac/Linux 1. Elimina i file esistenti in`{{ModusToolbox}}/tools_2.x/openocd`. 1. Sostituisci i file `{{ModusToolbox}}/tools_2.x/openocd` con il contenuto estratto dell'archivio scaricato in un passaggio precedente. #### Aggiornamento del firmware-Loader Questo kit richiede Cypress Firmware-Loader 3.0.0 o versione successiva. **Per aggiornare Cypress Firmware-Loader** 1. [Vai alla pagina di rilascio di Cypress Firmware-Loader.](https://github.com/cypresssemiconductorco/Firmware-loader/releases) 1. Scarica il file di archivio per il tuo sistema operativo (). Windows/Mac/Linux 1. Elimina i file esistenti in`{{ModusToolbox}}/tools_2.x/fw-loader`. 1. Sostituisci i file `{{ModusToolbox}}/tools_2.x/fw-loader` con il contenuto estratto dell'archivio scaricato in un passaggio precedente. In alternativa, puoi usarlo CMake per generare file di build del progetto dal codice sorgente dell'applicazione FreerTOS, creare il progetto usando il tuo strumento di compilazione preferito e quindi programmare il kit usando OpenOCD. [Se preferisci utilizzare uno strumento GUI per la programmazione con il CMake flusso, scarica e installa Cypress Programmer dalla pagina web di Cypress Programming Solutions.](https://www.cypress.com/products/psoc-programming-solutions) Per ulteriori informazioni, consulta [Utilizzo CMake con FreerTOS](getting-started-cmake.md). ## Configurazione dell'hardware Segui questi passaggi per configurare l'hardware del kit. 1. **Fornisci il kit** Segui le istruzioni della [Guida alla fornitura del kit CY8 CKIT-064S0S2-4343W per](https://community.cypress.com/docs/DOC-20043) fornire il kit in modo sicuro. AWS IoT Questo kit richiede la versione 3.1.0 o successiva. CySecureTools 1. **Configura una connessione seriale** 1. Connect il kit al computer host. 1. La porta seriale USB del kit viene automaticamente enumerata sul computer host. Identifica il numero di porta. In Windows, è possibile identificarlo utilizzando il **Device Manager** in **Porte** (COM e LPT). 1. Avviare un terminale seriale e aprire una connessione con le impostazioni seguenti: + Velocità in baud: 115200 + Dati: 8 bit + Parità: nessuna + Bit di stop: 1 + Controllo di flusso: nessuno ## Crea ed esegui il progetto FreerTOS Demo In questa sezione crei ed esegui la demo. 1. Assicurati di seguire i passaggi indicati nella [Guida al provisioning per il kit CY8 CKIT-064S0S2-4343W](https://community.cypress.com/docs/DOC-20043). 1. **Crea la demo di FreerTOS.** 1. Apri l'IDE di Eclipse ModusToolbox e scegli, o crea, uno spazio di lavoro. 1. Dal menu **File** scegliere **Import (Importa)**. **Espandi **Generale**, scegli **Progetto esistente in area di lavoro**, quindi scegli Avanti.** 1. In **Root Directory**, immettete `{{freertos}}/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demos` e selezionate il nome `aws_demos` del progetto. Dovrebbe essere selezionato per impostazione predefinita. 1. Scegliete **Fine** per importare il progetto nel vostro spazio di lavoro. 1. Create l'applicazione effettuando una delle seguenti operazioni: + Dal **pannello rapido**, seleziona **Crea applicazione aws\_demos**. + **Scegli **Project e scegli Build All**.** Assicurati che il progetto venga compilato senza errori. 1. **Monitoraggio dei messaggi MQTT nel cloud** Prima di eseguire la demo, puoi configurare il client MQTT nella AWS IoT console per monitorare i messaggi che il tuo dispositivo invia al AWS Cloud. Per iscriverti all'argomento MQTT con il client AWS IoT MQTT, segui questi passaggi. 1. Accedi alla [console AWS IoT](https://console.aws.amazon.com//iotv2/). 1. Nel pannello di navigazione, scegli **Test**, quindi scegli **MQTT test client per aprire il client** MQTT. 1. Per l'**argomento Abbonamento**, immettete**{{your-thing-name}}/example/topic**, quindi scegliete **Sottoscrivi all'**argomento. 1. **Esegui il progetto demo FreerTOS** 1. Seleziona il progetto `aws_demos` nell'area di lavoro. 1. Dal **pannello rapido**, seleziona **aws\_demos** Program (3). KitProg Questo programma la scheda e l'applicazione demo inizia a funzionare al termine della programmazione. 1. È possibile visualizzare lo stato dell'applicazione in esecuzione nel terminale seriale. La figura seguente mostra una parte dell'uscita del terminale. ![Schermata dell'output del terminale dopo la creazione del aws_demo progetto.](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/gsg-psoc64-terminal-output.png) La demo MQTT pubblica messaggi su quattro argomenti diversi (`iotdemo/topic/{{n}}`dove da n=1 a 4) e sottoscrive tutti questi argomenti per ricevere gli stessi messaggi. Quando viene ricevuto un messaggio, la demo pubblica un messaggio di conferma sull'argomento. `iotdemo/acknowledgements` L'elenco seguente descrive i messaggi di debug che appaiono nell'output del terminale, con riferimenti ai numeri di serie dei messaggi. Nell'output, i dettagli del driver WICED Host Driver (WHD) vengono stampati per primi senza numerazione seriale. 1. Da 1 a 4: il dispositivo si connette all'Access Point (AP) configurato e viene fornito connettendosi al AWS server utilizzando l'endpoint e i certificati configurati. 1. Da 5 a 13: la libreria CoreMQTT viene inizializzata e il dispositivo stabilisce una connessione MQTT. 1. Da 14 a 17 — Il dispositivo si iscrive a tutti gli argomenti per ricevere di nuovo i messaggi pubblicati. 1. Da 18 a 30: il dispositivo pubblica due messaggi e attende di riceverli. Quando ogni messaggio viene ricevuto, il dispositivo invia un messaggio di conferma. Lo stesso ciclo di pubblicazione, ricezione e conferma continua fino alla pubblicazione di tutti i messaggi. Vengono pubblicati due messaggi per ciclo fino al completamento del numero di cicli configurati. 1. **Utilizzo CMake con FreerTOS** Puoi anche usarlo CMake per creare ed eseguire l'applicazione demo. Per configurare CMake e creare un sistema di compilazione nativo, vedi[Prerequisiti](getting-started-cmake.md#building-cmake-prereqs). 1. Utilizzate il seguente comando per generare file di build. Specificate la scheda di destinazione con l'`-DBOARD`opzione. ``` cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S {{freertos}} -B {{build_dir}} ``` Se utilizzi Windows, devi specificare il sistema di compilazione nativo utilizzando l'`-G`opzione perché CMake utilizza Visual Studio per impostazione predefinita. **Example** ``` cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S {{freertos}} -B {{build_dir}} -G Ninja ``` Se non `arm-none-eabi-gcc` è nel percorso della shell, devi anche impostare la `AFR_TOOLCHAIN_PATH` CMake variabile. **Example** ``` -DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin ``` 1. Usa il seguente comando per creare il progetto usando CMake. ``` cmake --build {{build_dir}} ``` 1. Infine, programma i `cm4.hex` file `cm0.hex` and generati `{{build_dir}}` da Cypress Programmer. ### Esecuzione di altre demo Le seguenti applicazioni demo sono state testate e verificate per funzionare con la versione corrente. Puoi trovare queste demo nella `{{freertos}}/demos` directory. Per informazioni su come eseguire queste demo, consulta. [Demo FreerTOS](freertos-next-steps.md) + Dimostrazione Bluetooth Low Energy + Over-the-Air Demo di aggiornamenti + Demo del client Secure Sockets Echo + AWS IoT Demo di Device Shadow ## Debug I KitProg 3 del kit supportano il debug tramite il protocollo SWD. + **Per eseguire il debug dell'applicazione FreerTOS, seleziona **il progetto aws\_demos nell'area di lavoro, quindi **seleziona** aws\_demos Debug** (3) dal Pannello rapido. KitProg** ## Aggiornamenti OTA PSoI C 64 MCUs hanno superato tutti i test di qualificazione FreerTOS richiesti. Tuttavia, la funzionalità opzionale over-the-air (OTA) implementata nella libreria AWS firmware PSo C 64 Standard Secure è ancora in attesa di valutazione. [La funzionalità OTA così come implementata attualmente supera tutti i test di qualificazione OTA ad eccezione di aws\_ota\_test\_case\_rollback\_if\_unable\_to\_connect\_after\_update.py.](https://github.com/aws/amazon-freertos/blob/202012.00/tools/ota_e2e_tests/aws_ota_test/aws_ota_test_case_rollback_if_unable_to_connect_after_update.py) Quando un'immagine OTA convalidata con successo viene applicata a un dispositivo che utilizza l' AWS MCU PSo C64 Standard Secure con cui il dispositivo non è in grado di comunicare AWS IoT Core, il dispositivo non può tornare automaticamente all'immagine originale valida nota. Ciò potrebbe rendere il dispositivo irraggiungibile per ulteriori aggiornamenti. AWS IoT Core Questa funzionalità è ancora in fase di sviluppo da parte del team di Cypress. Per ulteriori informazioni, vedere [OTA Updates with AWS and the CY8 CKIT-064S0S2-4343W](https://community.cypress.com/docs/DOC-20063) Kit. [Se hai ulteriori domande o hai bisogno di supporto tecnico, contatta la Cypress Developer Community.](https://community.cypress.com)