View a markdown version of this page

Erste Schritte mit dem Microchip Curiosity PIC32MZ EF - FreeRTOS
-ÜbersichtEinrichten der Microchip Curiosity PIC32MZ EF-HardwareEinrichten der Microchip Curiosity PIC32MZ EF-Hardware mit PICkit On Board (PKOB)Einrichten Ihrer EntwicklungsumgebungÜberwachung von MQTT-Nachrichten in der CloudErstellen und starten Sie das FreeRTOS-DemoprojektFehlerbehebung

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, 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

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 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) für neue Designs zu verwenden. Die PIC32mzV1-Plattform befindet sich immer noch in Version 202012.00 des FreeRTOS Reference Integration-Repositorys. Die Plattform wird jedoch von v202107.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

Das Bundle enthält die folgenden Elemente:

Außerdem benötigen Sie die folgenden Elemente für das Debugging:

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.

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 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! .

    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, undgit submodule update --init --recursive).

-Übersicht

Dieses Tutorial enthält Anweisungen für die folgenden ersten Schritte:

  1. Verbinden Ihres Boards mit einem Host-Computer.

  2. Installieren von Software auf dem Host-Computer zum Entwickeln und Debuggen eingebetteter Anwendungen für Ihr Mikrocontroller-Board.

  3. Cross-Compilierung einer FreeRTOS-Demo-Anwendung zu einem Binär-Image.

  4. Laden des binären Anwendungs-Image auf Ihr Board und Ausführen der Anwendung.

  5. 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.

  2. Verbinden Sie die PIC32 LAN8720 PHY-Tochterplatine mit dem J18-Header auf dem Microchip Curiosity PIC32MZ EF.

  3. Connect das MikroElectronika USB UART Click Board über ein USB-A-auf-USB-Mini-B-Kabel mit Ihrem Computer.

  4. Verwenden Sie eine der folgenden Optionen, um Ihr Board mit dem Internet zu verbinden:

    • Zur Verwendung Wi-Fiverbinden Sie das MikroElectronika Wi-Fi 7-Klick-Board mit dem MicroBus 2-Anschluss auf dem Microchip Curiosity PIC32MZ EF. Siehe Konfiguration der FreeRTOS-Demos.

    • 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

  5. Wenn nicht bereits geschehen, löten Sie den Winkelstecker an den ICSP-Header auf dem Microchip Curiosity PIC32MZ EF.

  6. 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.

  7. 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

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.

  2. Führen Sie einen der folgenden Schritte aus, um Ihr Board mit dem Internet zu verbinden:

    • Zur Verwendung Wi-Fiverbinden 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

    • 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.

  3. 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.

  4. 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 oder höher.

  2. 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
    Aktuelle MPLAB-Downloads () MPLabv5.40

  3. Installieren Sie den MPLAB XC32-Compiler:

  4. 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 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).

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.

  2. Wählen Sie im Menü File (Datei) die Option Open project (Projekt öffnen).

  3. Navigieren Sie zu projects/microchip/curiosity_pic32mzef/mplab/aws_demos und öffnen Sie es.

  4. 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.

  2. Wählen Sie im Dialogfeld Projekteigenschaften compiler-name (Globale Optionen) aus, um es zu erweitern, und wählen Sie compiler-name dann -gcc aus.

  3. 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.

  2. 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.

  3. 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

  2. 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

  3. Ä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.

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.