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 PIC32MZ EF
**Wichtig**
Diese Referenzintegration wird im Repository gehostet, das veraltet ist. Amazon-FreeRTOS 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)
**Anmerkung**
In Absprache mit Microchip entfernen wir den Curiosity PIC32MZEF (DM320104) aus dem Hauptzweig des FreeRTOS Reference Integration-Repositorys und werden ihn nicht mehr in neuen Releases anbieten. Microchip hat eine [offizielle Mitteilung](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104) veröffentlicht, dass der PIC32MZEF (DM320104) nicht mehr für neue Designs empfohlen wird. Auf die PIC32MZEF-Projekte und den Quellcode kann weiterhin über die Tags der vorherigen Version zugegriffen werden. Microchip empfiehlt Kunden, das Curiosity [ PIC32MZ-EF-2.0 Development Board (DM320209](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board)) für neue Designs zu verwenden. Die PIC32mzV1-Plattform befindet sich immer noch in Version [202012.00 des FreeRTOS Reference](https://github.com/aws/amazon-freertos/tree/202012.00) 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.
In diesem Tutorial erhalten Sie Anweisungen für die ersten Schritte mit Microchip Curiosity PIC32MZ EF. [Wenn Sie das Microchip Curiosity PIC32MZ EF-Paket nicht haben, besuchen Sie den Partnergerätekatalog, um eines bei unserem Partner zu erwerben. AWS](https://devices.amazonaws.com/detail/a3G0L00000AANscUAH/Curiosity-PIC32MZ-EF-Amazon-FreeRTOS-Bundle)
Das Bundle enthält die folgenden Elemente:
+ [Entwicklungsplatine Curiosity PIC32MZ EF](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 PHY LAN8720-Tochterplatine](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ac320004-3)
Außerdem benötigen Sie die folgenden Elemente für das Debugging:
+ [MPLAB Snap-Debugger In-Circuit ](https://www.microchip.com/Developmenttools/ProductDetails/PG164100)
+ (Optional) [PICkit 3-Programmierkabelkit](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\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/) .
Wenn Sie Git unter Windows verwenden, müssen Sie den Entwicklermodus aktivieren oder:
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.
## Einrichten der Microchip Curiosity PIC32MZ EF-Hardware
1. Connect Sie das MikroElectronika USB-UART-Click-Board mit dem MicroBus 1-Anschluss auf dem Microchip Curiosity PIC32MZ EF.
1. Verbinden Sie die PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity PIC32MZ 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:
+ Zur Verwendung **Wi-Fi**verbinden Sie das MikroElectronika Wi-Fi 7-Klick-Board mit dem MicroBus 2-Anschluss auf dem Microchip Curiosity PIC32MZ EF. Siehe [Konfiguration der FreeRTOS-Demos](freertos-prereqs.md#freertos-configure).
+ Um das Microchip Curiosity PIC32MZ EF-Board über **Ethernet** mit dem Internet zu verbinden, verbinden Sie das PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity PIC32MZ EF. Schließen Sie ein Ende eines Ethernet-Kabels an der LAN8720-PHY-Tochterplatine an. Schließen Sie das andere Ende an Ihren Router oder an einen anderen Internet-Port an. Sie müssen auch das Präprozessor-Makro definieren. `PIC32_USE_ETHERNET`
1. Wenn nicht bereits geschehen, löten Sie den Winkelstecker an den ICSP-Header auf dem Microchip Curiosity PIC32MZ EF.
1. Schließen Sie ein Ende des ICSP-Kabel aus dem PICkit 3-Programmierkabelkit am Microchip Curiosity PIC32MZ EF an.
Wenn Sie das PickIt 3 Programming Cable Kit nicht haben, können Sie stattdessen M-F Dupont-Drahtbrücken 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.
Vergewissern Sie sich, dass Kabel zu Pin 1 auf Microchip Curiosity PIC32MZ EF, die mit dem weißen Kreis markiert sind, zu Pin 1 auf dem MPLAB Snap Debugger passen.
[Weitere Informationen zum MPLAB Snap Debugger finden Sie im MPLAB Snap Debugger Informationsblatt. In-Circuit ](http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB%20Snap%20In-Circuit%20Debugger%20IS%20DS50002787A.pdf)
## Einrichten der Microchip Curiosity PIC32MZ EF-Hardware mit PICkit On Board (PKOB)
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 Sie das MikroElectronika USB-UART-Click-Board mit dem MicroBus 1-Anschluss auf dem Microchip Curiosity PIC32MZ EF.
1. Führen Sie einen der folgenden Schritte aus, um Ihr Board mit dem Internet zu verbinden:
+ Zur Verwendung **Wi-Fi**verbinden Sie das MikroElectronika Wi-Fi 7-Klick-Board mit dem MicroBus 2-Anschluss auf dem Microchip Curiosity PIC32MZ EF. (Folgen Sie den Schritten „So konfigurieren Sie Ihr“ in. Wi-Fi [Konfiguration der FreeRTOS-Demos](freertos-prereqs.md#freertos-configure)
+ Um das Microchip Curiosity PIC32MZ EF-Board über **Ethernet** mit dem Internet zu verbinden, verbinden Sie das PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity PIC32MZ EF. Schließen Sie ein Ende eines Ethernet-Kabels an der LAN8720-PHY-Tochterplatine an. 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. Verbinden Sie den USB-Micro-B-Anschluss mit dem Namen „USB DEBUG“ auf dem Microchip Curiosity PIC32MZ EF Board mit einem 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 MPLAB XC32 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 unterstützt. MPLabv5.35 Frühere Versionen von FreeRTOS AWS Reference Integrations werden auf unterstützt. MPLabv5.40
**MPLabv5.35 lädt herunter**
+ [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)
**Aktuelle MPLAB-Downloads () MPLabv5.40**
+ [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 XC32-Compiler:
+ [MPLAB \+\+ Compiler XC32/32 für Windows](http://www.microchip.com/mplabxc32windows)
+ [MPLAB XC32/32 \+\+ Compiler für macOS](http://www.microchip.com/mplabxc32osx)
+ [MPLAB \+\+ Compiler für Linux XC32/32](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 zu abonnieren mit dem 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)**.
Wenn das Demo-Projekt erfolgreich auf Ihrem Gerät ausgeführt wird, sehen Sie „Hello World\!“ mehrfach zu dem Thema gesendet, das Sie abonniert haben.
## Erstellen und starten Sie das FreeRTOS-Demoprojekt
### Ö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 zu verwenden, können Sie alternativ CMake verwenden, um die Demo-Anwendungen oder Anwendungen, die Sie mit Code-Editoren und Debugging-Tools von Drittanbietern entwickelt haben, zu erstellen und auszuführen.
**Um die FreeRTOS-Demo mit CMake zu erstellen**
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 [CMake mit FreeRTOS verwenden](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).