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 487 NuMaker-IoT-M **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 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](github-repo-migration.md) Dieses Tutorial enthält Anweisungen für die ersten Schritte mit dem Nuvoton 487-Entwicklungsboard. NuMaker-IoT-M Der Mikrocontroller der Serie umfasst integrierte RJ45 Ethernet- und Wi-Fi-Module. Wenn Sie den Nuvoton NuMaker-IoT-M 487 nicht haben, besuchen Sie den [Gerätekatalog für AWS Partner](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487), 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. 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. Eine FreeRTOS-Demo-Anwendung zu einem Binär-Image querkompilieren. 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 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 Nuvoton Cortex-M4-Serie herunterladen. MCUs Das Keil MDK wird nur unter Windows unterstützt. **Um das NuMaker-IoT-M Entwicklungstool für den 487 zu installieren** 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 enthält die Keil µVision-IDE, eine C/C\$1\$1-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 den **NU-Link\$1Keil\$1Driver\$1v3.06.7215R (oder** die neueste Version), der sich auf der Nuvoton Development Tool-Seite befindet.](https://www.nuvoton.com/tool-and-software/ide-and-compiler/) ## Erstellen Sie das FreeRTOS-Demoprojekt und führen Sie es aus **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 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. 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. 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. 1. Wählen Sie auf der Registerkarte **Debug (Debuggen)** neben **Nuvoton Nu-Link Debugger** die Option **Settings (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 mit dem MQTT-Client zu abonnieren AWS IoT** 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** aus, 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 Sie Ihr Numaker-IoT-M 487-Board mit Ihrem 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 (Debuggen)** die Option **Start/Stop Debug Session (Debug-Sitzung starten/stoppen)**. 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 ## Verwendung CMake mit FreeRTOS Sie können es auch verwenden CMake , 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 Build-System installiert haben. CMake Befolgen Sie die Anweisungen unter [Verwendung CMake mit FreeRTOS](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 AWS Cloud sendet. **Um das MQTT-Thema mit dem MQTT-Client zu abonnieren AWS IoT** 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** aus, 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\$1FOLDER*. 1. 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 ``` 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 (Nr. 4 von ISW1 on 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](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip) 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 on ICE) ausgeschaltet ist, wie in der ISW1 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 Sie das FreeRTOS-Demoprojekt und führen Sie es aus](#gsg-nuvoton-m487-build-run) 1. Wählen Sie im Menü **Debug (Debuggen)** die Option **Start/Stop Debug Session (Debug-Sitzung starten/stoppen)**. Das Fenster **Call Stack\$1 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. Klicken Sie mit der rechten Maustaste auf das `aws_demo`-Projekt in der IDE und wählen Sie dann **Options (Optionen)**aus. 1. 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. ![\[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 (Debuggen)** neben **Nuvoton Nu-Link Debugger** die Option **Settings (Einstellungen)**. ![\[Nu-Link Debugger-Einstellungsdialog mit Optionen für Treiberversion, ICE-Version, Gerätefamilie, Geräte-ID, Port, maximale Taktfrequenz, Chiptyp, Verbindungsmodus, Reset-Option und Stromsteuerspannungen.\]](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.