Erste Schritte mit dem Nuvoton NuMaker -IoT-M487

Wichtig

Diese Referenzintegration wird im Amazon-FreeRTOS-Repository gehostet, das veraltet ist. Wir empfehlen, dass Sie hier beginnen, wenn Sie ein neues Projekt erstellen. Wenn Sie bereits ein vorhandenes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-FreeRTOS-Repository basiert, finden Sie weitere Informationen unter. Leitfaden zur Migration des Amazon-FreerTOS Github-Repositorys

Dieses Tutorial enthält Anleitungen für die ersten Schritte mit dem Nuvoton NuMaker -IoT-M487 Development Board. Der Mikrocontroller der Serie umfasst integrierte RJ45-Ethernet- und Wi-Fi-Module. Wenn Sie das Nuvoton NuMaker -IoT-M487 nicht haben, besuchen Sie den AWS Partner-Gerätekatalog, um eines von unserem Partner zu kaufen.

Bevor Sie beginnen, müssen Sie Ihre FreeRTOS-Software konfigurieren AWS IoT , um Ihr Entwicklungsboard mit der AWS Cloud zu verbinden. Anweisungen finden Sie unter Erste Schritte. In diesem Tutorial wird der Pfad zum FreeRTOS-Download-Verzeichnis als bezeichnet. freertos

Übersicht

In diesem Tutorial führen Sie die folgenden Schritte aus:

1. Installieren von Software auf dem Host-Computer zum Entwickeln und Debuggen eingebetteter Anwendungen für Ihre Mikrocontroller-Platine.

2. Eine FreeRTOS-Demo-Anwendung zu einem Binär-Image querkompilieren.

3. Laden des binären Anwendungs-Image auf Ihre Platine und Ausführen der Anwendung.

Einrichten Ihrer Entwicklungsumgebung

Die Keil MDK Nuvoton Edition wurde für die Entwicklung und das Debugging von Anwendungen für Nuvoton M487-Platinen entwickelt. Die Keil MDK v5 Essential-, Plus- oder Pro-Version ist ebenfalls für die Nuvoton M487 (Cortex-M4 Core) MCU geeignet. Sie können die Keil MDK Nuvoton Edition mit einem Preisnachlass für die MCUs der Nuvoton Cortex-Serie M4 herunterladen. Das Keil MDK wird nur unter Windows unterstützt.

Um das Entwicklungstool für den NuMaker -IoT-M487 zu installieren

1. Laden Sie die Keil MDK Nuvoton Edition von der Keil MDK-Website herunter.

2. Installieren Sie das Keil MDK unter Verwendung Ihrer Lizenz auf Ihrem Hostcomputer. Das Keil MDK enthält die Keil µVision-IDE, eine C/C++-Kompilierungs-Toolchain und den µVision-Debugger.

   Wenn während der Installation Probleme auftreten, wenden Sie sich an Nuvoton, um Unterstützung zu erhalten.

3. Installieren Sie den NU-Link_Keil_Driver_v3.06.7215R (oder die neueste Version), der sich auf der Nuvoton Development Tool-Seite befindet.

Erstellen und starten Sie das FreeRTOS-Demoprojekt

Um das FreeRTOS-Demo-Projekt zu erstellen

1. Öffnen Sie die Keil µVision-IDE.

2. Wählen Sie im Menü File (Datei) die Option Open (Öffnen) aus. Stellen Sie sicher, dass im Dialogfeld Open file (Datei öffnen) die Dateitypauswahl auf Project Files (Projektdateien) festgelegt ist.

3. Wählen Sie entweder das zu erstellende Wi-Fi- oder Ethernet-Demo-Projekt aus.

   • Um das WLAN-Demoprojekt zu öffnen, wählen Sie das Zielprojekt „aws_demos.uvproj“ im Verzeichnis „freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos“ aus.

   • Um das Ethernet-Demo-Projekt zu öffnen, wählen Sie das Zielprojekt „aws_demos_eth.uvproj“ im Verzeichnis „freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth“ aus.

4. Um sicherzustellen, dass die Einstellungen zum Flashen der Platine korrekt sind, klicken Sie mit der rechten Maustaste auf das aws_demo-Projekt in der IDE und wählen Sie dann Options (Optionen). (Weitere Details finden Sie unter Fehlerbehebung.)

5. Stellen Sie sicher, dass auf der Registerkarte Utilities (Dienstprogramme) die Option Use Target Driver for Flash Programming (Zieltreiber für Flash-Programmierung verwenden) ausgewählt ist, und dass Nuvoton Nu-Link Debugger als Zieltreiber festgelegt ist.

6. Wählen Sie auf der Registerkarte Debug (Debuggen) neben Nuvoton Nu-Link Debugger die Option Settings (Einstellungen).

7. Stellen Sie sicher, dass der Chip Type (Chiptyp) auf M480 festgelegt ist.

8. Wählen Sie im Navigationsbereich Project (Projekt) der Keil µVision IDE das Projekt aws_demos aus. Wählen Sie im Menü Project (Projekt) die Option Build Target (Ziel erstellen).

Sie können den MQTT-Client in der AWS IoT Konsole verwenden, um die Nachrichten zu überwachen, die Ihr Gerät an die Cloud sendet. AWS

Um das MQTT-Thema mit dem MQTT-Client zu abonnieren AWS IoT

1. Melden Sie sich an der AWS IoT -Konsole an.

2. Wählen Sie im Navigationsbereich Test und dann MQTT-Testclient, um den MQTT-Client zu öffnen.

3. Geben Sie im Feld Subscription topic (Abonnementthema) die Option your-thing-name/example/topic ein und wählen Sie dann Subscribe to topic (Thema abonnieren).

Um das FreeRTOS-Demo-Projekt auszuführen

1. Verbinden Sie Ihre Numaker-IoT-M487-Platine mit Ihrem Hostcomputer (Computer).

2. Erstellen Sie das Projekt neu.

3. Wählen Sie in der Keil µVision-IDE im Menü Flash die Option Download (Herunterladen).

4. Wählen Sie im Menü Debug (Debuggen) die Option Start/Stop Debug Session (Debug-Sitzung starten/stoppen).

5. Wenn der Debugger am Haltepunkt in main() stoppt, öffnen Sie das Menü Run (Ausführen) und wählen Sie dann Run (F5) (Ausführen (F5)).

   Sie sollten die von Ihrem Gerät gesendeten MQTT-Nachrichten im MQTT-Client in der Konsole sehen. AWS IoT

CMake mit FreeRTOS verwenden

Sie können CMake auch verwenden, um die FreeRTOS-Demoanwendungen oder Anwendungen, die Sie mit Code-Editoren und Debugging-Tools von Drittanbietern entwickelt haben, zu erstellen und auszuführen.

Stellen Sie sicher, dass Sie das CMake-Build-System installiert haben. Befolgen Sie die Anweisungen unter CMake mit FreeRTOS verwenden und führen Sie anschließend die Schritte in diesem Thema aus.

Anmerkung

Stellen Sie sicher, dass sich der Pfad zum Speicherort des Compilers (Keil) in Ihrer Path-Systemvariablen befindet, z. B. C:\Keil_v5\ARM\ARMCC\bin.

Sie können auch den MQTT-Client in der AWS IoT Konsole verwenden, um die Nachrichten zu überwachen, die Ihr Gerät an die Cloud sendet. AWS

Um das MQTT-Thema mit dem MQTT-Client zu abonnieren AWS IoT

1. Melden Sie sich an der AWS IoT -Konsole an.

2. Wählen Sie im Navigationsbereich Test und dann MQTT-Testclient, um den MQTT-Client zu öffnen.

3. Geben Sie im Feld Subscription topic (Abonnementthema) die Option your-thing-name/example/topic ein und wählen Sie dann Subscribe to topic (Thema abonnieren).

So generieren Sie Build-Dateien aus Quelldateien und führen das Demoprojekt aus

1. Öffnen Sie auf Ihrem Host-Computer die Befehlszeile und navigieren Sie zum Freertos-Ordner.

2. Erstellen Sie einen Ordner, der die generierten Build-Dateien enthält. Wir werden diesen Ordner als BUILD_FOLDER bezeichnen.

3. Generieren Sie die Build-Dateien für das Wi-Fi- oder Ethernet-Demo.

   • Für WLAN:

     Navigieren Sie zu dem Verzeichnis, das die Quelldateien für das FreeRTOS-Demoprojekt enthält. Generieren Sie dann die Build-Dateien, indem Sie den folgenden Befehl ausführen.

     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja 

   • Für Ethernet:

     Navigieren Sie zu dem Verzeichnis, das die Quelldateien für das FreeRTOS-Demoprojekt enthält. Generieren Sie dann die Build-Dateien, indem Sie den folgenden Befehl ausführen.

     cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja 

4. Generieren Sie die Binärdatei, die auf den M487 geflasht werden soll, indem Sie den folgenden Befehl ausführen.

   cmake --build BUILD_FOLDER 

   An diesem Punkt sollte sich die Binärdatei aws_demos.bin im Ordner BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi befinden.

5. Um die Platine für den Flash-Modus zu konfigurieren, stellen Sie sicher, dass der MSG-Schalter (Nr. 4 von ISW1 auf ICE) auf EIN eingestellt ist. Wenn Sie die Platine anschließen, wird ein Fenster (und Laufwerk) zugewiesen. (Siehe Fehlerbehebung).

6. Öffnen Sie einen Terminal-Emulator, um die Nachrichten über UART anzuzeigen. Folgen Sie den Anweisungen unter Installieren eines Terminal-Emulators.

7. Führen Sie das Demoprojekt aus, indem Sie die generierte Binärdatei auf das Gerät kopieren.

   Wenn Sie das MQTT-Thema mit dem AWS IoT MQTT-Client abonniert haben, sollten Sie in der Konsole die von Ihrem Gerät gesendeten MQTT-Nachrichten sehen. AWS IoT

Fehlerbehebung

• Wenn Ihr Windows das Gerät nicht erkenntVCOM, installieren Sie den NuMaker Windows-Treiber für die serielle Schnittstelle über den Link Nu-Link USB Driver v1.6.

• Wenn Sie Ihr Gerät über Nu-Link mit dem Keil MDK (IDE) verbinden, stellen Sie sicher, dass der MSG-Schalter (Nr. 4 von ISW1 auf ICE) auf AUS eingestellt ist, wie gezeigt.

  

Wenn beim Einrichten Ihrer Entwicklungsumgebung oder beim Herstellen einer Verbindung mit Ihrer Platine Probleme auftreten, wenden Sie sich an Nuvoton.

Debuggen von FreeRTOS-Projekten in Keil μVision

So starten Sie eine Debug-Sitzung in Keil µVision

1. Öffnen Sie Keil µVision.

2. Folgen Sie den Schritten, um das FreeRTOS-Demo-Projekt einzubauen. Erstellen und starten Sie das FreeRTOS-Demoprojekt

3. Wählen Sie im Menü Debug (Debuggen) die Option Start/Stop Debug Session (Debug-Sitzung starten/stoppen).

   Das Fenster Call Stack+ Locals (Aufruf-Stack und Lokale) wird angezeigt, wenn Sie eine Debug-Sitzung starten. µVision flasht die Demo auf die Platine, führt die Demo aus und stoppt am Anfang der main()-Funktion.

4. Legen Sie Haltepunkte im Quellcode Ihres Projekts fest und führen Sie dann den Code aus. Das Projekt sollte wie folgt aussehen:

   

Fehlerbehebung für Debug-Einstellungen von µVision

Wenn beim Debuggen einer Anwendung Probleme auftreten, überprüfen Sie, ob Ihre Debug-Einstellungen in Keil µVision korrekt sind.

So überprüfen Sie, ob die Debug-Einstellungen von µVision korrekt sind

1. Öffnen Sie Keil µVision.

2. Klicken Sie mit der rechten Maustaste auf das aws_demo-Projekt in der IDE und wählen Sie dann Options (Optionen)aus.

3. Stellen Sie sicher, dass auf der Registerkarte Utilities (Dienstprogramme) die Option Use Target Driver for Flash Programming (Zieltreiber für Flash-Programmierung verwenden) ausgewählt ist, und dass Nuvoton Nu-Link Debugger als Zieltreiber festgelegt ist.

   

4. Wählen Sie auf der Registerkarte Debug (Debuggen) neben Nuvoton Nu-Link Debugger die Option Settings (Einstellungen).

   

5. Stellen Sie sicher, dass der Chip Type (Chiptyp) auf M480 festgelegt ist.