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 Nuvoton NuMaker-IoT-M487 **Importante** Questa integrazione di riferimento è ospitata nel Amazon-FreeRTOS repository che è obsoleto. Ti consigliamo di [iniziare da qui](freertos-getting-started-modular.md) quando crei un nuovo progetto. Se hai già un progetto FreerTOS esistente basato sul repository ora obsoleto, Amazon-FreeRTOS consulta il. [Amazon-FreeRTOS Guida alla migrazione del repository Github](github-repo-migration.md) Questo tutorial fornisce istruzioni per iniziare con la scheda di sviluppo Nuvoton. NuMaker-IoT-M487 La serie è un microcontrollore e include Ethernet e moduli RJ45 integrati. Wi-Fi Se non disponi di Nuvoton NuMaker-IoT-M487, visita il [AWS Partner Device Catalog per acquistarne uno dal nostro partner](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487). Prima di iniziare, devi configurare AWS IoT il software FreerTOS per connettere la tua scheda di sviluppo al Cloud. AWS Per istruzioni, consulta [Fase iniziale](freertos-prereqs.md). In questo tutorial, il percorso della directory di download di FreerTOS è indicato come. `{{freertos}}` ## Panoramica di Questo tutorial descrive le seguenti procedure: 1. Installazione di software sul computer host per lo sviluppo e il debug di applicazioni integrate per la scheda a microcontroller. 1. Cross-compile un'applicazione demo FreerTOS su un'immagine binaria. 1. Caricamento dell'immagine binaria dell'applicazione sulla scheda in uso e successiva esecuzione dell'applicazione. ## Configurazione dell'ambiente di sviluppo Keil MDK Nuvoton Edition è progettato per lo sviluppo e il debug di applicazioni per schede Nuvoton M487. La versione Keil MDK v5 Essential, Plus o Pro dovrebbe funzionare anche con l'MCU Nuvoton M487 (core). Cortex-M4 Puoi scaricare l'edizione Keil MDK Nuvoton con uno sconto sul prezzo per gli MCU della serie Nuvoton. Cortex-M4 Keil MDK è supportato solo su Windows. **Per installare lo strumento di sviluppo per NuMaker-IoT-M487** 1. Scarica [ Keil MDK Nuvoton Edition](https://store.developer.arm.com/store/embedded-iot-software-tools/keil-mdk-nuvoton-edition?edition=1164) dal sito Web di Keil MDK. 1. Installare Keil MDK sulla macchina host utilizzando la licenza. Keil MDK include l'IDE Keil µVision, una toolchain di compilazione C/C \+\+ e il debugger µVision. Se si verificano problemi durante l'installazione, contattare [Nuvoton](https://www.nuvoton.com/contact-us) per ricevere assistenza. 1. [Installa **Nu-Link\_ Keil\_Driver\_V 3.06.7215r** (o versione più recente), che si trova nella pagina Nuvoton Development Tool.](https://www.nuvoton.com/tool-and-software/ide-and-compiler/) ## Crea ed esegui il progetto demo FreerTOS **Per creare il progetto demo FreerTOS** 1. Aprire l'IDE Keil µVision. 1. Nel menu **File** scegliere **Open (Apri)**. Nella finestra di dialogo **Open file (Apri file)**, verificare che il selettore del tipo di file sia impostato su **Project Files (File di progetto)**. 1. Scegli il progetto dimostrativo Wi-Fi o Ethernet da creare. + Per aprire il progetto Wi-Fi demo, scegli il progetto di destinazione `aws_demos.uvproj` nella `{{freertos}}\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos` directory. + Per aprire il progetto demo Ethernet, scegliere il progetto di destinazione `aws_demos_eth.uvproj` nella directory `{{freertos}}\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth`. 1. Per assicurarti che le impostazioni siano corrette per la flash della scheda, fai clic con il pulsante destro del mouse sul progetto `aws_demo` nell'IDE, quindi scegli **Options (Opzioni)**. Per ulteriori dettagli, consulta [Risoluzione dei problemi](#gsg-nuvoton-m487-troubleshoot). 1. Nella scheda **Utilità**, verificate che **l'opzione Use Target Driver for Flash Programming** sia selezionata e che **Nuvoton Nu-Link Debugger** sia impostato come driver di destinazione. 1. ****Nella scheda **Debug, accanto a Nuvoton Debugger**, scegliete Impostazioni. Nu-Link**** 1. Verificare che **chip Type (Tipo di chip)** sia impostato su **M480**. 1. Nel riquadro di navigazione del **Progetto** Keil µVision IDE, scegliere il progetto `aws_demos`. Dal menu **Project (Progetto)**, scegliere **Build All (Crea tutti)**. È possibile utilizzare il client MQTT nella AWS IoT console per monitorare i messaggi che il dispositivo invia al Cloud. AWS **Per sottoscrivere l'argomento MQTT con AWS IoT Client MQTT** 1. Accedi alla [console AWS IoT](https://console.aws.amazon.com/iotv2). 1. Nel riquadro di navigazione, scegliete **Test**, quindi scegliete **MQTT test client per aprire il client** MQTT. 1. In **Argomento sottoscrizione**, digitare **{{your-thing-name}}/example/topic**, quindi scegliere **Effettua sottoscrizione all'argomento**. **Per eseguire il progetto demo FreerTOS** 1. Connect la Numaker-IoT-M487 scheda alla macchina host (computer). 1. Ricreare il progetto. 1. Nel menu **Flash** dell'IDE Keil µVision, scegliere **Download (Scarica)**. 1. Nel menu **Debug**, scegli **Start/Stop Debug Session**. 1. Quando il debugger si arresta nel punto di interruzione in `main()`, apri il menu **Run (Esegui)**, quindi scegli **Run (F5) (Esegui (F5)**. Dovreste vedere i messaggi MQTT inviati dal dispositivo nel client MQTT della console. AWS IoT ## Usare CMake con FreerTOS Puoi anche usare CMake per creare ed eseguire le applicazioni demo FreerTOS o le applicazioni che hai sviluppato utilizzando editor di codice e strumenti di debug di terze parti. Assicurati di aver installato il sistema di compilazione CMake. Segui le istruzioni che trovi su [Usare CMake con FreerTOS](getting-started-cmake.md) e quindi segui i passaggi descritti in questa sezione. **Nota** Assicurati che il percorso alla posizione del compilatore (Keil) sia nella variabile di sistema Path (Percorso), ad esempio `C:\Keil_v5\ARM\ARMCC\bin`. Puoi anche utilizzare il client MQTT nella AWS IoT console per monitorare i messaggi che il tuo dispositivo invia al Cloud. AWS **Per sottoscrivere l'argomento MQTT con AWS IoT Client MQTT** 1. Accedi alla [console AWS IoT](https://console.aws.amazon.com/iotv2). 1. Nel riquadro di navigazione, scegliete **Test**, quindi scegliete **MQTT test client per aprire il client** MQTT. 1. In **Argomento sottoscrizione**, digitare **{{your-thing-name}}/example/topic**, quindi scegliere **Effettua sottoscrizione all'argomento**. **Per generare file di compilazione dai file di origine ed eseguire il progetto demo** 1. Sul computer host, aprire il prompt dei comandi e passare alla cartella {{freertos}}. 1. Creare una cartella per i file compilati generati. Faremo riferimento a questa cartella come a. {{BUILD\_FOLDER}} 1. Genera i file di build per la demo Wi-Fi o Ethernet. + Per Wi-Fi: Passa alla directory che contiene i file sorgente per il progetto demo FreerTOS. Quindi generare i file della build eseguendo il comando seguente. ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B {{BUILD_FOLDER}} -G Ninja ``` + Per Ethernet: Passa alla directory che contiene i file sorgente per il progetto demo FreerTOS. Quindi generare i file della build eseguendo il comando seguente. ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B {{BUILD_FOLDER}} -G Ninja ``` 1. Generare il file binario nella memoria flash sull'M487 eseguendo il comando seguente. ``` cmake --build {{BUILD_FOLDER}} ``` A questo punto, il file binario `aws_demos.bin` deve trovarsi nella cartella `{{BUILD_FOLDER}}/vendors/Nuvoton/boards/numaker_iot_m487_wifi`. 1. Per configurare la scheda per la modalità flash, assicurati che l'interruttore MSG (No.4 di ISW1 su ICE) sia acceso. Quando si collega la scheda, verrà assegnata una finestra (e un'unità). Consultare [Risoluzione dei problemi](#gsg-nuvoton-m487-troubleshoot). 1. Aprire un emulatore di terminale per visualizzare i messaggi tramite UART. Segui le istruzioni riportate in [Installazione di un emulatore di terminale](gsg-troubleshooting.md#uart-term). 1. Esegui il progetto demo copiando il file binario generato sul dispositivo. Se ti sei abbonato all'argomento MQTT con il client AWS IoT MQTT, dovresti vedere i messaggi MQTT inviati dal tuo dispositivo nella console. AWS IoT ## Risoluzione dei problemi + [Se Windows non è in grado di riconoscere il dispositivo`VCOM`, installa il driver della porta seriale di NuMaker Windows dal link Nu-Link USB Driver v1.6.](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip) + Se colleghi il dispositivo a Keil MDK (IDE) tramite Nu-Link, assicurati che lo switch MSG (No.4di ISW1 su ICE) sia disattivato, come mostrato. ![Scheda di circuito con slot per scheda SD, microcontrollore, pin, connettori di alimentazione e ripristino etichettati.](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/nuvoton-m487-gsg.png) In caso di problemi durante la configurazione dell'ambiente di sviluppo o la connessione alla scheda, contatta [Nuvoton](http://www.nuvoton.com/contact-us/). ### Eseguire il debug di progetti FreerTOS in Keil μVision **Per avviare una sessione di debug in Keil µVision** 1. Aprire Keil µVision. 1. Segui i passaggi per creare il progetto demo FreerTOS. [Crea ed esegui il progetto demo FreerTOS](#gsg-nuvoton-m487-build-run) 1. **Nel menu **Debug, scegli Start/Stop Debug** Session.** La finestra **Call Stack\+Locals (Stack chiamate)** viene visualizzata quando avvii una sessione di debug. µVision lampeggia la demo sulla scheda, esegue la demo e si arresta all'inizio della funzione `main()`. 1. Imposta i punti di interruzione nel codice origine del progetto ed esegui il codice. Il progetto deve essere simile al seguente: ![File di codice sorgente principale con inizializzazione dell'hardware, pianificazione delle attività, fornitura delle chiavi per un progetto di microcontrollore del dispositivo.](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/numaker-iot-m487-debug.png) ### Risoluzione dei problemi delle impostazioni di debug di μVision Se si verificano problemi durante il debug di un'applicazione, controllare che le impostazioni di debug siano impostate correttamente in Keil µVision. **Per verificare che le impostazioni di debug di µVision siano corrette** 1. Aprire Keil µVision. 1. Right-click **il `aws_demo` progetto nell'IDE, quindi scegli Opzioni.** 1. Nella scheda **Utilità**, verificate che **l'opzione Use Target Driver for Flash Programming** sia selezionata e che **Nuvoton Nu-Link Debugger** sia impostato come driver di destinazione. ![Finestra delle opzioni che mostra le impostazioni di configurazione per la programmazione flash, il debug e l'elaborazione dei file di output.](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/nulink-debugger-target.png) 1. **Nella scheda **Debug**, accanto a ** Nu-LinkNuvoton** Debugger, scegli Impostazioni.** ![Nu-Link Finestra di dialogo delle impostazioni del debugger con opzioni per la versione del driver, la versione ICE, la famiglia del dispositivo, l'ID del dispositivo, la porta, l'orologio massimo, il tipo di chip, la modalità di connessione, l'opzione di ripristino e le tensioni di controllo dell'alimentazione.](http://docs.aws.amazon.com/it_it/freertos/latest/userguide/images/nulink-driver-setup.png) 1. Verificare che **chip Type (Tipo di chip)** sia impostato su **M480**.