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 Xilinx MicroZed Avnet Industrial IoT Kit
**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 Xilinx Avnet MicroZed Industrial IoT Kit. [Wenn Sie das Xilinx Avnet MicroZed Industrial IoT Kit nicht haben, besuchen Sie den AWS Partner Device Catalog, um eines von unserem Partner zu erwerben.](https://devices.amazonaws.com/detail/a3G0L00000AANtqUAH/MicroZed-IIoT-Bundle-with-Amazon-FreeRTOS)
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). In diesem Tutorial wird der Pfad zum FreeRTOS-Download-Verzeichnis als bezeichnet. `freertos`
## Ü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.
## Richten Sie die Hardware ein MicroZed
Das folgende Diagramm kann bei der Einrichtung der MicroZed Hardware hilfreich sein:
![\[AVNet Mikrocontrollerplatine mit Power-Good-LED, Benutzer-LED und Drucktaste, JTAG-Zugriff, 10/100/1000-Ethernet- und USB-Host, microSD-Steckplatz, USB-UART, Done-LED, Reset-Taste und hervorgehobenen Boot MODE-Jumpern.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/microzed.png)
**So richten Sie das Board ein MicroZed**
1. Connect Sie Ihren Computer mit dem USB-UART-Anschluss auf Ihrem MicroZed Board.
1. Connect Sie Ihren Computer mit dem JTAG Access-Port auf Ihrem MicroZed Board.
1. Connect einen Router oder einen mit dem Internet verbundenen Ethernet-Port mit dem Ethernet- und USB-Host-Anschluss auf Ihrem Board. MicroZed
## Einrichten Ihrer Entwicklungsumgebung
Um FreeRTOS-Konfigurationen für das MicroZed Kit einzurichten, müssen Sie das Xilinx Software Development Kit (XSDK) verwenden. XSDK wird auf Windows und Linux unterstützt.
### XSDK herunterladen und installieren
Um die Xilinx-Software zu installieren, benötigen Sie ein kostenloses Xilinx-Konto.
**So laden Sie das XDSK herunter:**
1. Gehen Sie zur Download-Seite für den [Software Development Kit Standalone Client](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-design-tools/2019-1.html). WebInstall
1. Wählen Sie die geeignete Option für Ihr Betriebssystem.
1. Sie werden auf eine Xilinx Anmeldeseite weitergeleitet.
**Wenn Sie ein Konto bei Xilinx haben, geben Sie Ihre Anmeldeinformationen ein und wählen Sie dann Anmelden.**
Wenn Sie kein Konto haben, wählen Sie **Create your account (Konto erstellen)**. Nachdem Sie sich registriert haben, erhalten Sie eine E-Mail mit einem Link zur Aktivierung Ihres Xilinx-Kontos.
1. Geben Sie auf der Seite **Name and Address Verification (Namens- und Adressverifizierung)** Ihre Informationen ein und wählen Sie dann **Next (Weiter)**. Der Download ist jetzt zum Start bereit.
1. Speichern Sie die `Xilinx_SDK_version_os`-Datei.
**So installieren Sie das XSDK:**
1. Öffnen Sie die `Xilinx_SDK_version_os` Datei.
1. Wählen Sie unter **Select Edition to Install (Zu installierende Edition auswählen)** die Option **Xilinx Software Development Kit (XSDK)** und anschließend **Next (Weiter)** aus.
1. Wählen Sie auf der folgenden Seite des Installationsassistenten unter **Installation Options (Installationsoptionen)** die Option **Install Cable Drivers (Kabeltreiber installieren)** und wählen Sie anschließend **Next (Weiter)** aus.
Wenn Ihr Computer die USB-UART-Verbindung nicht erkennt, installieren Sie die MicroZed 0x Bridge VCP-Treiber manuell. CP21 USB-to-UART Anweisungen finden Sie im [Silicon Labs CP21](https://www.xilinx.com/support/documentation/boards_and_kits/install/ug1033-cp210x-usb-uart-install.pdf) 0x-Installationshandbuch. USB-to-UART
Weitere Informationen zu XDSK finden Sie unter [Getting Started with the Xilinx SDK](https://www.xilinx.com/html_docs/xilinx2018_2/SDK_Doc/index.html) auf der Xilinx-Website.
## Ü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 an 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)**.
## Erstellen und starten Sie das FreeRTOS-Demoprojekt
### Öffnen Sie die FreeRTOS-Demo in der XSDK-IDE
1. Starten Sie die XSDK-IDE mit dem auf `freertos/projects/xilinx/microzed/xsdk` festgelegten Workspace-Verzeichnis.
1. Schließen Sie die Willkommenseite. Wählen Sie im Menü **Project (Projekt)** aus und deaktivieren Sie dann **Build Automatically (Automatisch erstellen)**.
1. Wählen Sie im Menü die Option **File (Datei)** und anschließend **Import** aus.
1. Erweitern Sie auf der Seite **Select (Auswählen)** die Option **General (Allgemein)**, wählen Sie **Existing Projects into Workspace (Vorhandene Projekte in WorkSpace)** aus und klicken Sie dann auf **Next (Weiter)**.
1. Wählen Sie auf der Seite **Projekte importieren** die **Option Stammverzeichnis auswählen** und geben Sie dann das Stammverzeichnis Ihres Demo-Projekts ein:. `freertos/projects/xilinx/microzed/xsdk/aws_demos` Um nach dem Verzeichnis zu suchen, wählen Sie **Browse (Durchsuchen)** aus.
Nachdem Sie ein Stammverzeichnis angegeben haben, werden die Projekte in diesem Verzeichnis auf der Seite **Import Projects (Projekte importieren)** angezeigt. Standardmäßig sind alle verfügbaren Projekte ausgewählt.
**Anmerkung**
Wenn Sie oben auf der Seite **Import Projects (Projekte importieren)** eine Warnung sehen ("Some projects cannot be imported because they already exist in the workspace. (Einige Projekte können nicht importiert werden, da sie bereits im Workspace vorhanden sind.)"), können Sie sie ignorieren.
1. Wenn alle Projekte ausgewählt sind, wählen Sie **Finish (Fertigstellen)**.
1. Wenn Sie die `MicroZed_hw_platform_0` Projekte `aws_bsp``fsbl`, und nicht im Projektbereich sehen, wiederholen Sie die vorherigen Schritte ab \$13, wobei das Stammverzeichnis jedoch auf`freertos/vendors/xilinx`, eingestellt ist, und importieren Sie `aws_bsp``fsbl`, und`MicroZed_hw_platform_0`.
1. Wählen Sie im Menü die Option **Window (Fenster)** und anschließend **Preferences (Einstellungen)** aus.
1. Erweitern Sie im Navigationsbereich die Option **Run/Debug (Ausführen/Debuggen)**, wählen Sie **String Substitution (Zeichenfolge ersetzen)** und anschließend **New (Neu)** aus.
1. Geben Sie in **New String Substitution Variable (Neue Zeichenfolgenersatzvariable)** für **Name** **AFR\$1ROOT** ein. Geben Sie für **Value (Wert)** den Stammpfad der `freertos/projects/xilinx/microzed/xsdk/aws_demos` ein. Wählen Sie **OK** und anschließend **OK** aus, um die Variable zu speichern, und schließen Sie **Preferences (Einstellungen)**.
### Erstellen Sie das FreeRTOS-Demoprojekt
1. Wählen Sie in der XSDK IDE aus dem Menü die Option **Project (Projekt)** und anschließend **Clean (Bereinigen)** aus.
1. Belassen Sie in **Clean (Bereinigen)** die Optionen bei ihren Standardwerten und wählen Sie dann **OK** aus. XSDK bereinigt und erstellt alle Projekte und generiert dann `.elf`-Dateien.
**Anmerkung**
Um alle Projekte zu erstellen, ohne sie zu bereinigen, wählen Sie **Project (Projekt)** und anschließend **Build All (Alle erstellen)** aus.
Um einzelne Projekte zu erstellen, wählen Sie das Projekt, das Sie erstellen möchten, **Project (Projekt)** und anschließend **Build Project (Projekt erstellen)** aus.
### Generieren Sie das Boot-Image für das FreeRTOS-Demo-Projekt
1. Klicken Sie mit der rechten Maustaste in der XSDK IDE auf **aws\$1demos** und wählen Sie dann **Create Boot Image (Start-Image erstellen)** aus.
1. Wählen Sie unter **Create Boot Image (Start-Image erstellen)** die Option **Create new BIF file (Neue BIF-Datei erstellen)** aus.
1. Wählen Sie neben **Output BIF file path (Ausgabe-BIF-Dateipfad)** die Option **Browse (Durchsuchen)** aus und anschließend in `/vendors/xilinx/microzed/aws_demos/aws_demos.bif` `aws_demos.bif` aus.
1. Wählen Sie **Hinzufügen** aus.
1. Wählen Sie unter **Add new boot image partition (Neue Start-Image-Partition hinzufügen)** neben **File path (Dateipfad)** die Option **Browse (Durchsuchen)** und anschließend `fsbl.elf` unter `vendors/xilinx/fsbl/Debug/fsbl.elf` aus.
1. Wählen Sie für den **Partition type (Partitionstyp)** die Option **bootloader** und anschließend **OK** aus.
1. Wählen Sie unter **Create Boot Image (Start-Image erstellen)** die Option **Create Image (Image erstellen)** aus. Wählen Sie unter **Override Files (Dateien überschreiben)** die Option **OK,** aus, um die vorhandene `aws_demos.bif` zu überschreiben und die Datei `BOOT.bin` unter `projects/xilinx/microzed/xsdk/aws_demos/BOOT.bin` zu generieren.
### JTAG-Debugging
1. Stellen Sie die Startmodus-Jumper Ihres MicroZed Boards auf den JTAG-Boot-Modus ein.
![\[Leiterplatten-Header-Anschlüsse und Jumper-Einstellungen.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/xilinx-jtag.png)
1. Stecken Sie die MicroSD-Karte in den MicroSD-Kartensteckplatz ein, der sich direkt unter dem USB-UART-Port befindet.
**Anmerkung**
Bevor Sie debuggen, sichern Sie unbedingt alle Inhalte, die Sie auf der MicroSD-Karte haben.
Ihre Platine sollte ähnlich wie folgt aussehen:
![\[FreeRTOS-Evaluierungsboard mit Konnektivitätsoptionen.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/xilinx-jtag-full-board.png)
1. Klicken Sie mit der rechten Maustaste in der XSDK IDE auf **aws\$1demos**, wählen Sie **Debug As (Debuggen als)** und anschließend **1 Launch on System Hardware (System Debugger) (1 Start auf Systemhardware (System-Debugger))** aus.
1. Wenn der Debugger am Haltepunkt in `main()` anhält, wählen Sie im Menü **Run (Ausführen)** und anschließend **Resume (Fortsetzen)** aus.
**Anmerkung**
Wenn Sie die Anwendung zum ersten Mal ausführen, wird ein neues Zertifikat-Schlüsselpaar in nicht flüchtigen Speicher importiert. Für nachfolgende Ausführungen können Sie `vDevModeKeyProvisioning()` in der Datei `main.c` auskommentieren, bevor Sie die Images und die Datei `BOOT.bin` neu erstellen. Dadurch wird verhindert, dass bei jeder Ausführung die Zertifikate und der Schlüssel zur Speicherung kopiert werden.
Sie können wählen, ob Sie Ihr MicroZed Board von einer microSD-Karte oder von QSPI Flash booten möchten, um das FreeRTOS-Demo-Projekt auszuführen. Anweisungen finden Sie unter [Generieren Sie das Boot-Image für das FreeRTOS-Demo-Projekt](#xilinx-build-boot-image) und [Führen Sie das FreeRTOS-Demo-Projekt aus](#xilinx-run).
### Führen Sie das FreeRTOS-Demo-Projekt aus
Um das FreeRTOS-Demo-Projekt auszuführen, können Sie Ihr MicroZed Board von einer microSD-Karte oder von QSPI-Flash booten.
Wenn Sie Ihr MicroZed Board für die Ausführung des FreeRTOS-Demo-Projekts einrichten, schauen Sie sich das Diagramm in an. [Richten Sie die Hardware ein MicroZed](#xilinx-setup-hardware) Vergewissern Sie sich, dass Sie Ihr MicroZed Board an Ihren Computer angeschlossen haben.
#### Booten Sie das FreeRTOS-Projekt von einer microSD-Karte
Formatieren Sie die microSD-Karte, die im Lieferumfang des Xilinx MicroZed Industrial IoT Kit enthalten ist.
1. Kopieren Sie die Datei `BOOT.bin` auf die MicroSD-Karte.
1. Stecken Sie die Karte in den MicroSD-Kartensteckplatz unter dem USB-UART-Port.
1. Stellen Sie die MicroZed Startmodus-Jumper auf den SD-Startmodus ein.
![\[SD-Karte mit drei Steckplätzen mit der Aufschrift JP1 JP2, JP3 und einem Halter für Knopfzellenbatterien.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/xilinx-sd.png)
1. Drücken Sie die RST-Taste, um das Gerät zurückzusetzen und die Anwendung zu starten. Sie können das USB-UART-Kabel auch vom USB-UART-Port trennen und das Kabel dann wieder einstecken.
#### Booten Sie das FreeRTOS-Demo-Projekt von QSPI Flash
1. Stellen Sie die Startmodus-Jumper Ihres MicroZed Boards auf den JTAG-Boot-Modus ein.
![\[Leiterplatten-Header-Anschlüsse und Jumper-Einstellungen.\]](http://docs.aws.amazon.com/de_de/freertos/latest/userguide/images/xilinx-jtag.png)
1. Vergewissern Sie sich, dass Ihr Computer mit den Zugriffsports USB-UART und JTAG verbunden ist. Die grüne Betriebsbereitschafts-LED sollte aufleuchten.
1. Wählen Sie in der XSDK IDE vom Menü **Xilinx** und anschließend **Program Flash (Flash programmieren)** aus.
1. In **Program Flash Memory (Flash-Speicher programmieren)** sollte die Hardwareplattform automatisch ausgefüllt werden. Wählen Sie **unter Verbindung** Ihren MicroZed Hardwareserver aus, um Ihre Platine mit Ihrem Host-Computer zu verbinden.
**Anmerkung**
Wenn Sie das Xilinx Smart Lync JTAG-Kabel verwenden, müssen Sie einen Hardwareserver in der XSDK IDE erstellen. Wählen Sie **New (Neu)** aus und definieren Sie anschließend Ihren Server.
1. Geben Sie unter **Image File (Image-Datei)** den Verzeichnispfad zu Ihrer `BOOT.bin`-Image-Datei ein. Wählen Sie **Browse (Durchsuchen)** aus, um stattdessen nach der Datei zu suchen.
1. Geben Sie unter **Offset** **0x0** ein.
1. Geben Sie unter **FSBL File (FSBL-Datei)** den Verzeichnispfad zu Ihrer `fsbl.elf`-Datei ein. Wählen Sie **Browse (Durchsuchen)** aus, um stattdessen nach der Datei zu suchen.
1. Wählen Sie **Programmieren** aus, um Ihre Platine zu programmieren.
1. Nachdem die QSPI-Programmierung abgeschlossen ist, entfernen Sie das USB-UART-Kabel, um die Platine auszuschalten.
1. Stellen Sie die Startmodus-Jumper Ihres MicroZed Boards auf den QSPI-Boot-Modus ein.
1. Stecken Sie die Karte in den MicroSD-Kartensteckplatz ein, der sich direkt unter dem USB-UART-Port befindet.
**Anmerkung**
Sichern Sie unbedingt alle Inhalte, die Sie auf der MicroSD-Karte haben.
1. Drücken Sie die RST-Taste, um das Gerät zurückzusetzen und die Anwendung zu starten. Sie können das USB-UART-Kabel auch vom USB-UART-Port trennen und das Kabel dann wieder einstecken.
## Fehlerbehebung
Wenn Sie Build-Fehler feststellen, die sich auf falsche Pfade beziehen, versuchen Sie, das Projekt zu bereinigen und neu zu erstellen, wie in [Erstellen Sie das FreeRTOS-Demoprojekt](#xilinx-freertos-build-project) beschrieben.
Wenn Sie Windows verwenden, stellen Sie sicher, dass Sie Schrägstriche (/) verwenden, wenn Sie die Zeichenkettenersetzungsvariablen in der Windows XSDK IDE festlegen.
Allgemeine Informationen zur Problembehandlung bei Getting Started with FreeRTOS finden Sie unter. [Fehlerbehebung – Erste Schritte](gsg-troubleshooting.md)