View a markdown version of this page

Guida introduttiva al Nuvoton NuMaker-IoT-M487 - FreeRTOS
Panoramica diConfigurazione dell'ambiente di sviluppoCrea ed esegui il progetto demo FreerTOSUsare CMake con FreerTOSRisoluzione dei problemi

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

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.

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

  2. Cross-compile un'applicazione demo FreerTOS su un'immagine binaria.

  3. 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 dal sito Web di Keil MDK.

  2. 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 per ricevere assistenza.

  3. Installa Nu-Link_ Keil_Driver_V 3.06.7215r (o versione più recente), che si trova nella pagina Nuvoton Development Tool.

Crea ed esegui il progetto demo FreerTOS

Per creare il progetto demo FreerTOS

  1. Aprire l'IDE Keil µVision.

  2. 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).

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

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

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

  6. Nella scheda Debug, accanto a Nuvoton Debugger, scegliete Impostazioni. Nu-Link

  7. Verificare che chip Type (Tipo di chip) sia impostato su M480.

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

  2. Nel riquadro di navigazione, scegliete Test, quindi scegliete MQTT test client per aprire il client MQTT.

  3. 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).

  2. Ricreare il progetto.

  3. Nel menu Flash dell'IDE Keil µVision, scegliere Download (Scarica).

  4. Nel menu Debug, scegli Start/Stop Debug Session.

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

  2. Nel riquadro di navigazione, scegliete Test, quindi scegliete MQTT test client per aprire il client MQTT.

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

  2. Creare una cartella per i file compilati generati. Faremo riferimento a questa cartella come a. BUILD_FOLDER

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

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

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

  6. Aprire un emulatore di terminale per visualizzare i messaggi tramite UART. Segui le istruzioni riportate in Installazione di un emulatore di terminale.

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

In caso di problemi durante la configurazione dell'ambiente di sviluppo o la connessione alla scheda, contatta Nuvoton.

Eseguire il debug di progetti FreerTOS in Keil μVision

Per avviare una sessione di debug in Keil µVision

  1. Aprire Keil µVision.

  2. Segui i passaggi per creare il progetto demo FreerTOS. Crea ed esegui il progetto demo FreerTOS

  3. 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().

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

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.

  2. Right-click il aws_demo progetto nell'IDE, quindi scegli Opzioni.

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

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

  5. Verificare che chip Type (Tipo di chip) sia impostato su M480.