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 Microchip Curiosity PIC32 MZ EF **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) **Anmerkung** In Absprache mit Microchip entfernen wir das Curiosity PIC32 MZEF (DM320104) aus dem Hauptzweig des FreeRTOS Reference Integration-Repositorys und werden es nicht mehr in neuen Releases anbieten. Microchip hat eine [offizielle Mitteilung](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) veröffentlicht, dass der PIC32 MZEF (DM320104) nicht mehr für neue Designs empfohlen wird. Auf die PIC32 MZEF-Projekte und den Quellcode kann weiterhin über die Tags der vorherigen Version zugegriffen werden. Microchip empfiehlt Kunden, das Curiosity [ PIC32MZ-EF-2.0-Entwicklungsboard](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board) () für neue Designs zu verwenden. DM320209 Die PIC32 MZv1 Plattform befindet sich immer noch in Version [202012.00](https://github.com/aws/amazon-freertos/tree/202012.00) des FreeRTOS Reference Integration-Repositorys. Die Plattform wird jedoch von [v202107.00](https://github.com/aws/amazon-freertos/tree/202107.00) der FreeRTOS Reference nicht mehr unterstützt. Dieses Tutorial enthält Anweisungen für die ersten Schritte mit dem Microchip Curiosity MZ EF. PIC32 [Wenn Sie das Microchip Curiosity PIC32 MZ EF-Paket nicht haben, besuchen Sie den AWS Partnergerätekatalog, um eines bei unserem Partner zu kaufen.](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle) Das Bundle enthält die folgenden Elemente: + [Curiosity PIC32 MZ EF Entwicklungsboard](https://www.microchip.com/Developmenttools/ProductDetails/DM320104) + [MikroElectronika USB-UART-Klickboard](https://www.mikroe.com/usb-uart-click) + [MikroElectronika WiFi 7 klicken Sie auf Board](https://www.mikroe.com/wifi-7-click) + [PIC32 LAN8720 PHY-Tochterboard](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3) Außerdem benötigen Sie die folgenden Elemente für das Debugging: + [MPLAB Snap In-Circuit Debugger](https://www.microchip.com/Developmenttools/ProductDetails/PG164100) + (Optional) [Kabelsatz mit PICkit 3 Programmierkabeln](https://www.microchip.com/TPROG001) Bevor Sie beginnen, müssen Sie FreeRTOS konfigurieren AWS IoT und herunterladen, um Ihr Gerät mit der AWS Cloud zu verbinden. Detaillierte Anweisungen finden Sie unter [Erste Schritte](freertos-prereqs.md). **Wichtig** In diesem Thema wird der Pfad zum FreeRTOS-Download-Verzeichnis als bezeichnet. `freertos` Leerzeichen im `freertos`-Pfad können Build-Fehler verursachen. Stellen Sie beim Klonen oder Kopieren des Repositorys sicher, dass der von Ihnen erstellte Pfad keine Leerzeichen enthält. Die maximale Länge eines Dateipfades bei Microsoft Windows ist 260 Zeichen. Lange FreeRTOS-Download-Verzeichnispfade können zu Build-Fehlern führen. Da der Quellcode symbolische Links enthalten kann, müssen Sie, wenn Sie Windows zum Extrahieren des Archivs verwenden, möglicherweise: [Entwicklermodus](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) aktivieren oder Verwenden Sie eine Konsole mit Administratorberechtigungen. Auf diese Weise kann Windows beim Extrahieren des Archivs ordnungsgemäß symbolische Links erstellen. Andernfalls werden symbolische Links als normale Dateien geschrieben, die die Pfade der symbolischen Links als Text enthalten oder leer sind. Weitere Informationen finden Sie im Blogeintrag [Symlinks in Windows 10\$1](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) . Wenn Sie Git unter Windows verwenden, müssen Sie den Entwicklermodus aktivieren oder Sie müssen: Setzen `core.symlinks` Sie ihn mit dem folgenden Befehl auf true: ``` git config --global core.symlinks true ``` Verwenden Sie immer dann eine Konsole mit Administratorrechten, wenn Sie einen Git-Befehl verwenden, der in das System schreibt (z. B.**git pull**,**git clone**, und**git submodule update --init --recursive**). ## -Übersicht Dieses Tutorial enthält Anweisungen für die folgenden ersten Schritte: 1. Verbinden Ihres Boards mit einem Host-Computer. 1. Installieren von Software auf dem Host-Computer zum Entwickeln und Debuggen eingebetteter Anwendungen für Ihr Mikrocontroller-Board. 1. Cross-Compilierung einer FreeRTOS-Demo-Anwendung zu einem Binär-Image. 1. Laden des binären Anwendungs-Image auf Ihr Board und Ausführen der Anwendung. 1. Interaktion mit der Anwendung, die auf Ihrem Board über eine serielle Verbindung ausgeführt wird, zu Überwachungs- und Debuggingzwecken. ## Richten Sie die Microchip Curiosity MZ EF-Hardware ein PIC32 1. Connect das MikroElectronika USB-UART-Click-Board mit dem MicroBus 1-Anschluss auf dem Microchip Curiosity PIC32 MZ EF. 1. Connect die PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity PIC32 MZ EF. 1. Connect das MikroElectronika USB UART Click Board über ein USB-A-auf-USB-Mini-B-Kabel mit Ihrem Computer. 1. Verwenden Sie eine der folgenden Optionen, um Ihr Board mit dem Internet zu verbinden: + Um **Wi-Fi** zu verwenden, verbinden Sie das MikroElectronika Wi-Fi 7-Klick-Board mit dem MicroBus 2-Anschluss auf dem Microchip Curiosity PIC32 MZ EF. Siehe [Konfiguration der FreeRTOS-Demos](freertos-prereqs.md#freertos-configure). + Um die Microchip Curiosity PIC32 MZ EF-Karte über **Ethernet** mit dem Internet zu verbinden, verbinden Sie die PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity MZ EF. PIC32 Connect ein Ende eines Ethernet-Kabels mit der LAN8720 PHY-Tochterplatine. Schließen Sie das andere Ende an Ihren Router oder an einen anderen Internet-Port an. Sie müssen auch das Präprozessor-Makro `PIC32_USE_ETHERNET` definieren. 1. Falls noch nicht geschehen, löten Sie den Winkelstecker an den ICSP-Header des Microchip Curiosity MZ EF. PIC32 1. Connect ein Ende des ICSP-Kabels des PICkit 3-Programmierkabel-Kits mit dem Microchip Curiosity PIC32 MZ EF. Wenn Sie nicht über das Kit mit PICkit 3 Programmierkabeln verfügen, können Sie stattdessen Drahtbrücken von M-F Dupont verwenden, um die Verbindung zu verkabeln. Hinweis: Der weiße Kreis zeigt die Position von Pin 1. 1. Schließen Sie das andere Ende des ICSP-Kabels (oder Jumper) an den MPLAB Snap Debugger an. Pin 1 des 8-Pin-SIL-Programmiersteckverbinders ist mit dem schwarzen Dreieck unten rechts auf dem Board markiert. Stellen Sie sicher, dass alle Kabel zu Pin 1 auf dem Microchip Curiosity PIC32 MZ EF, gekennzeichnet durch den weißen Kreis, mit Pin 1 am MPLAB Snap Debugger übereinstimmen. [Weitere Informationen zum MPLAB Snap Debugger finden Sie im Informationsblatt zum MPLAB Snap In-Circuit Debugger.](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf) ## Richten Sie die Microchip Curiosity PIC32 MZ EF-Hardware mithilfe von On Board (PKOB) ein PICkit Es wird empfohlen, das Setup-Verfahren im vorherigen Abschnitt zu befolgen. Sie können jedoch FreeRTOS-Demos mit grundlegendem Debugging mithilfe des integrierten PICkit On Board (PKOB) evaluieren und ausführen, indem Sie die folgenden Schritte ausführen. programmer/debugger 1. Connect das MikroElectronika USB-UART-Click-Board mit dem MicroBus 1-Anschluss auf dem Microchip Curiosity PIC32 MZ EF. 1. Führen Sie einen der folgenden Schritte aus, um Ihr Board mit dem Internet zu verbinden: + Um **Wi-Fi** zu verwenden, verbinden Sie das MikroElectronika Wi-Fi 7-Klick-Board mit dem MicroBus 2-Anschluss auf dem Microchip Curiosity PIC32 MZ EF. (Folgen Sie den Schritten unter „So konfigurieren Sie Ihr WLAN“ in [Konfiguration der FreeRTOS-Demos](freertos-prereqs.md#freertos-configure). + Um die Microchip Curiosity PIC32 MZ EF-Karte über **Ethernet** mit dem Internet zu verbinden, verbinden Sie die PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity MZ EF. PIC32 Connect ein Ende eines Ethernet-Kabels mit der LAN8720 PHY-Tochterplatine. Schließen Sie das andere Ende an Ihren Router oder an einen anderen Internet-Port an. Sie müssen auch das Präprozessor-Makro `PIC32_USE_ETHERNET` definieren. 1. Connect den USB-Micro-B-Anschluss mit der Bezeichnung „USB DEBUG“ auf der Microchip Curiosity PIC32 MZ EF-Karte über ein USB-Typ-A-auf-USB-Micro-B-Kabel mit Ihrem Computer. 1. Connect das MikroElectronika USB UART Click Board über ein USB-A-auf-USB-Mini-B-Kabel mit Ihrem Computer. ## Einrichten Ihrer Entwicklungsumgebung **Anmerkung** Das FreeRTOS-Projekt für dieses Gerät basiert auf MPLAB Harmony v2. Um das Projekt zu erstellen, müssen Sie Versionen der MPLAB-Tools verwenden, die mit Harmony v2 kompatibel sind, wie Version 2.10 des XC32 MPLAB-Compilers und Versionen 2.X.X des MPLAB Harmony Configurator (MHC). 1. Installieren Sie [Python Version 3.x](https://www.python.org/downloads/) oder höher. 1. Installieren Sie die MPLAB X-IDE: **Anmerkung** FreeRTOS AWS Reference Integrations v202007.00 wird derzeit nur auf Version 3.5 unterstützt. MPLabv5 Frühere Versionen von FreeRTOS AWS Reference Integrations werden auf Version 4.0 unterstützt. MPLabv5 **MPLabv53.5 Downloads** + [Integrierte Entwicklungsumgebung MPLAB X für Windows](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-windows-installer.exe) + [MPLAB X Integrierte Entwicklungsumgebung für macOS](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-osx-installer.dmg) + [Integrierte MPLAB X-Entwicklungsumgebung für Linux](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLABX-v5.35-linux-installer.tar) **Letzte MPLab Downloads (.40) MPLabv5** + [MPLAB-X-IDE (Integrierte Entwicklungsumgebung) für Windows](http://www.microchip.com/mplabx-ide-windows-installer) + [MPLAB-X-IDE (Integrierte Entwicklungsumgebung) für macOS](http://www.microchip.com/mplabx-ide-osx-installer) + [MPLAB-X-IDE (Integrierte Entwicklungsumgebung) für Linux](http://www.microchip.com/mplabx-ide-linux-installer) 1. Installieren Sie den MPLAB-Compiler XC32 : + [MPLAB /32\$1\$1 Compiler für Windows XC32](http://www.microchip.com/mplabxc32windows) + [MPLAB XC32 /32\$1\$1 Compiler für macOS](http://www.microchip.com/mplabxc32osx) + [MPLAB /32\$1\$1 Compiler für Linux XC32](http://www.microchip.com/mplabxc32linux) 1. Starten Sie einen UART-Terminal-Emulator und öffnen Sie eine Verbindung mit den folgenden Einstellungen: + Baudrate: 115200 + Daten: 8 Bit + Parität: Keine + Stop-Bits: 1 + Flusssteuerung: Keine ## Überwachung von MQTT-Nachrichten in der Cloud Bevor Sie das FreeRTOS-Demoprojekt ausführen, können Sie den MQTT-Client in der AWS IoT Konsole so einrichten, dass er die Nachrichten überwacht, 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)**. Wenn das Demo-Projekt erfolgreich auf Ihrem Gerät ausgeführt wird, sehen Sie „Hello World\$1“ mehrfach zu dem Thema gesendet, das Sie abonniert haben. ## Erstellen Sie das FreeRTOS-Demoprojekt und führen Sie es aus ### Öffnen Sie die FreeRTOS-Demo in der MPLAB-IDE 1. Öffnen Sie die MPLAB-IDE. Wenn Sie mehr als eine Version des Compilers installiert haben, müssen Sie den Compiler, den Sie verwenden möchten, innerhalb der IDE auswählen. 1. Wählen Sie im Menü **File (Datei)** die Option **Open project (Projekt öffnen)**. 1. Navigieren Sie zu `projects/microchip/curiosity_pic32mzef/mplab/aws_demos` und öffnen Sie es. 1. Klicken Sie auf **Open project (Projekt öffnen)**. **Anmerkung** Wenn Sie das Projekt zum ersten Mal öffnen, erhalten Sie möglicherweise eine Fehlermeldung über den Compiler. Navigieren Sie in der IDE zu **Tools**, **Options (Optionen)**, **Embedded** und wählen Sie dann den Compiler aus, den Sie für Ihr Projekt verwenden. Um Ethernet für die Verbindung zu verwenden, müssen Sie das Präprozessor-Makro definieren. `PIC32_USE_ETHERNET` **Um Ethernet für die Verbindung mit der MPLAB-IDE zu verwenden** 1. **Klicken Sie in der MPLAB-IDE mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften.** 1. **Wählen Sie im Dialogfeld **Projekteigenschaften *compiler-name*** **(Globale Optionen)** aus, um es zu erweitern, und wählen Sie *compiler-name* dann -gcc aus.** 1. **Wählen Sie für **Optionenkategorien** die Option **Vorverarbeitung und Meldungen aus, und** fügen Sie dann die `PIC32_USE_ETHERNET` Zeichenfolge zu Präprozessormakros hinzu.** ### Führen Sie das FreeRTOS-Demo-Projekt aus 1. Erstellen Sie Ihr Projekt neu. 1. Klicken Sie auf der Registerkarte **Projects (Projekte)** mit der rechten Maustaste auf den übergeordneten Ordner `aws_demos` und wählen Sie dann **Debug (Debuggen)** aus. 1. Wenn der Debugger am Haltepunkt in `main()` anhält, wählen Sie im Menü **Run (Ausführen)** die Funktion **Fortsetzen** aus. ### Erstellen Sie die FreeRTOS-Demo mit CMake Wenn Sie es vorziehen, keine IDE für die FreeRTOS-Entwicklung CMake zu verwenden, können Sie alternativ die Demo-Anwendungen oder Anwendungen, die Sie mit Code-Editoren und Debugging-Tools von Drittanbietern entwickelt haben, erstellen und ausführen. **Um die FreeRTOS-Demo zu erstellen mit CMake** 1. Erstellen Sie ein Verzeichnis, das die generierten Build-Dateien enthält, wie z. *build-directory* 1. Verwenden Sie den folgenden Befehl, um Build-Dateien aus dem Quellcode zu generieren. ``` cmake -DVENDOR=microchip -DBOARD=curiosity_pic32mzef -DCOMPILER=xc32 -DMCHP_HEXMATE_PATH=path/microchip/mplabx/version/mplab_platform/bin -DAFR_TOOLCHAIN_PATH=path/microchip/xc32/version/bin -S freertos -B build-folder ``` **Anmerkung** Sie müssen die richtigen Pfade zu den Hexmate- und Toolchain-Binärdateien angeben, z. B. die `C:\Program Files (x86)\Microchip\MPLABX\v5.35\mplab_platform\bin` Pfade und. `C:\Program Files\Microchip\xc32\v2.40\bin` 1. Ändern Sie die Verzeichnisse in das Build-Verzeichnis (*build-directory*) und starten Sie es dann von diesem Verzeichnis `make` aus. Weitere Informationen finden Sie unter [Verwendung CMake mit FreeRTOS](getting-started-cmake.md). Um Ethernet für die Verbindung zu verwenden, müssen Sie das Präprozessor-Makro `PIC32_USE_ETHERNET` definieren. ## Fehlerbehebung Informationen zur Problembehebung finden Sie unter [Fehlerbehebung – Erste Schritte](gsg-troubleshooting.md).