Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # 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](freertos-getting-started-modular.md), wenn Sie ein neues Projekt erstellen. Wenn Sie bereits ein bestehendes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-FreeRTOS Repository basiert, finden Sie weitere Informationen unter. [Amazon-FreeRTOS Leitfaden zur Migration zum Github-Repository](github-repo-migration.md) Dieses Tutorial enthält Anweisungen für die ersten Schritte mit dem Nuvoton Development Board. NuMaker-IoT-M487 Der Mikrocontroller der Serie umfasst integriertes RJ45-Ethernet und Module. Wi-Fi Wenn Sie den Nuvoton nicht haben NuMaker-IoT-M487, besuchen Sie den [Gerätekatalog für AWS Partner](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487), um eines von unserem Partner zu erwerben. Bevor Sie beginnen, müssen Sie Ihre FreeRTOS-Software konfigurieren AWS IoT , um Ihr Entwicklungsboard mit der AWS Cloud zu verbinden. Detaillierte Anweisungen finden Sie unter [Erste Schritte](freertos-prereqs.md). 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. 1. Cross-compile eine FreeRTOS-Demo-Anwendung für ein Binär-Image. 1. 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 sollte auch für die Nuvoton M487 (Core) -MCU funktionieren. Cortex-M4 Sie können die Keil MDK Nuvoton Edition mit einem Preisnachlass für die MCUs der Nuvoton-Serie herunterladen. Cortex-M4 Das Keil MDK wird nur unter Windows unterstützt. **Um das Entwicklungstool für das zu installieren NuMaker-IoT-M487** 1. Laden Sie die [Keil MDK Nuvoton Edition](https://store.developer.arm.com/store/embedded-iot-software-tools/keil-mdk-nuvoton-edition?edition=1164) von der Keil MDK-Website herunter. 1. Installieren Sie das Keil MDK unter Verwendung Ihrer Lizenz auf Ihrem Hostcomputer. Das Keil MDK umfasst 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](https://www.nuvoton.com/contact-us), um Unterstützung zu erhalten. 1. [Installieren Sie **Nu-Link\_ Keil\_Driver\_V 3.06.7215r** (oder die neueste Version), die sich auf der Nuvoton Development Tool-Seite befindet.](https://www.nuvoton.com/tool-and-software/ide-and-compiler/) ## Erstellen und starten Sie das FreeRTOS-Demoprojekt **Um das FreeRTOS-Demo-Projekt zu erstellen** 1. Öffnen Sie die Keil µVision-IDE. 1. 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. 1. Wählen Sie entweder das Wi-Fi oder das Ethernet-Demoprojekt aus, das Sie erstellen möchten. + Um das Wi-Fi Demo-Projekt zu öffnen, wählen Sie das Zielprojekt `aws_demos.uvproj` im `{{freertos}}\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos` Verzeichnis 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. 1. 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](#gsg-nuvoton-m487-troubleshoot).) 1. Vergewissern Sie sich, dass auf der Registerkarte **Dienstprogramme** die Option **Zieltreiber für Flash-Programmierung verwenden** ausgewählt ist und dass **Nuvoton Nu-Link Debugger** als Zieltreiber festgelegt ist. 1. **Wählen Sie auf der Registerkarte **Debug** neben ** Nu-LinkNuvoton** Debugger die Option Einstellungen.** 1. Stellen Sie sicher, dass der **Chip Type (Chiptyp)** auf **M480** festgelegt ist. 1. 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 zu abonnieren mit AWS IoT MQTT-Client** 1. Melden Sie sich bei der [AWS IoT -Konsole](https://console.aws.amazon.com/iotv2) an. 1. Wählen Sie im Navigationsbereich **Test** und dann **MQTT-Testclient, um den MQTT-Client** zu öffnen. 1. 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. Connect dein Numaker-IoT-M487 Board mit deinem Host-Computer (Computer). 1. Erstellen Sie das Projekt neu. 1. Wählen Sie in der Keil µVision-IDE im Menü **Flash** die Option **Download (Herunterladen)**. 1. Wählen Sie im Menü **Debug** die Option **Start/Stop Debug** Session. 1. 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](getting-started-cmake.md) 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 zu abonnieren mit AWS IoT MQTT-Client** 1. Melden Sie sich bei der [AWS IoT -Konsole](https://console.aws.amazon.com/iotv2) an. 1. Wählen Sie im Navigationsbereich **Test** und dann **MQTT-Testclient, um den MQTT-Client** zu öffnen. 1. 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 Eingabeaufforderung und navigieren Sie zu dem {{freertos}} Ordner. 1. Erstellen Sie einen Ordner, der die generierten Build-Dateien enthält. Wir werden diesen Ordner als den bezeichnen{{BUILD\_FOLDER}}. 1. Generieren Sie die Build-Dateien entweder für die Wi-Fi oder die Ethernet-Demo. + Für Wi-Fi: 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 ``` 1. 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. 1. Um die Platine für den Flash-Modus zu konfigurieren, stellen Sie sicher, dass der MSG-Schalter (No.4 von ISW1 auf ICE) eingeschaltet ist. Wenn Sie die Platine anschließen, wird ein Fenster (und Laufwerk) zugewiesen. (Siehe [Fehlerbehebung](#gsg-nuvoton-m487-troubleshoot)). 1. Öffnen Sie einen Terminal-Emulator, um die Nachrichten über UART anzuzeigen. Folgen Sie den Anweisungen unter [Installieren eines Terminal-Emulators](gsg-troubleshooting.md#uart-term). 1. Führen Sie das Demoprojekt aus, indem Sie die generierte Binärdatei auf das Gerät kopieren. Wenn Sie das MQTT-Thema mit dem MQTT-Client abonniert haben, sollten Sie die AWS IoT von Ihrem Gerät gesendeten MQTT-Nachrichten in der Konsole sehen. AWS IoT ## Fehlerbehebung + [Wenn Ihr Windows das Gerät nicht erkennt`VCOM`, installieren Sie den NuMaker Windows-Treiber für die serielle Schnittstelle über den Link Nu-Link USB Driver v1.6.](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip) + Wenn Sie Ihr Gerät über das Keil MDK (IDE) an das Keil MDK (IDE) anschließen Nu-Link, stellen Sie sicher, dass der MSG-Schalter (No.4von ISW1 auf ICE) ausgeschaltet ist, wie in der Abbildung gezeigt. ![Leiterplatte mit beschriftetem SD-Kartensteckplatz, Mikrocontroller, Anschlüssen, Strom- und Reset-Anschlüssen.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/nuvoton-m487-gsg.png) Wenn beim Einrichten Ihrer Entwicklungsumgebung oder beim Herstellen einer Verbindung mit Ihrer Platine Probleme auftreten, wenden Sie sich an [Nuvoton](http://www.nuvoton.com/contact-us/). ### Debuggen von FreeRTOS-Projekten in Keil μVision **So starten Sie eine Debug-Sitzung in Keil µVision** 1. Öffnen Sie Keil µVision. 1. Folgen Sie den Schritten, um das FreeRTOS-Demo-Projekt einzubauen. [Erstellen und starten Sie das FreeRTOS-Demoprojekt](#gsg-nuvoton-m487-build-run) 1. **Wählen Start/Stop Sie im Menü **Debug** die Option Debug Session aus.** 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. 1. Legen Sie Haltepunkte im Quellcode Ihres Projekts fest und führen Sie dann den Code aus. Das Projekt sollte wie folgt aussehen: ![Hauptquellcodedatei mit Hardwareinitialisierung, Aufgabenplanung und Schlüsselbereitstellung für ein Geräte-Mikrocontroller-Projekt.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/numaker-iot-m487-debug.png) ### 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. 1. Right-click **das `aws_demo` Projekt in der IDE und wählen Sie dann Optionen.** 1. Vergewissern Sie sich, dass auf der Registerkarte **Dienstprogramme** die Option **Zieltreiber für Flash-Programmierung verwenden** ausgewählt ist und dass **Nuvoton Nu-Link Debugger** als Zieltreiber festgelegt ist. ![Optionsfenster mit Konfigurationseinstellungen für Flash-Programmierung, Debugging und Verarbeitung von Ausgabedateien.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/nulink-debugger-target.png) 1. **Wählen Sie auf der Registerkarte **Debug** neben **Nuvoton Nu-Link Debugger** die Option Einstellungen.** ![Nu-Link Dialog mit Debugger-Einstellungen mit Optionen für Treiberversion, ICE-Version, Gerätefamilie, Geräte-ID, Port, maximale Taktfrequenz, Chiptyp, Verbindungsmodus, Reset-Option und Stromregelspannungen.](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/nulink-driver-setup.png) 1. Stellen Sie sicher, dass der **Chip Type (Chiptyp)** auf **M480** festgelegt ist.