

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 STMicroelectronics STM32L4 Discovery Kit IoT Node
<a name="getting_started_st"></a>

**Wichtig**  <a name="deprecation-message"></a>
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)

In diesem Tutorial erhalten Sie Anweisungen für die ersten Schritte mit dem STMicroelectronics STM32L4 Discovery Kit IoT Node. [Falls Sie den STMicroelectronics STM32L4 Discovery Kit IoT Node noch nicht besitzen, besuchen Sie den AWS Partner Device Catalog, um einen von unserem Partner zu erwerben.](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)

Stellen Sie sicher, dass Sie die neueste Firmware installiert haben. Wi-Fi Informationen zum Herunterladen der neuesten Wi-Fi Firmware finden Sie unter [STM32L4 Discovery Kit IoT-Knoten, Low-Power-WLAN, Bluetooth Low Energy, NFC, SubGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi Wählen Sie unter **Binary Resources** die Option **Firmware-Update für das Inventek ISM Wi-Fi 43362-Modul aus (Anweisungen** finden Sie in der Readme-Datei).

Bevor Sie beginnen, müssen Sie Ihr FreeRTOS konfigurieren AWS IoT, herunterladen und Wi-Fi Ihr Gerät mit der AWS Cloud 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
<a name="w2aac31b9b7c25c46c13"></a>

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

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.

## Einrichten Ihrer Entwicklungsumgebung
<a name="st-setup-env"></a>

### Installieren der System-Workbench für STM32
<a name="install-system-workbench"></a>

1. Navigieren Sie zu [OpenSTM32.org](http://www.openstm32.org/HomePage).

1. Registrieren Sie sich auf der OpenSTM32-Webseite. Sie müssen sich anmelden, um das Workbench-System herunterladen zu können.

1. Navigieren Sie zum [Installationsprogramm für die System-Workbench für STM32](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32), um die System-Workbench herunterzuladen und zu installieren.

Falls während der Installation Probleme auftreten, finden Sie weitere Informationen zu den häufig gestellten Fragen unter auf der [System-Workbench-Website](http://www.openstm32.org/HomePage).

## Erstellen und starten Sie das FreeRTOS-Demoprojekt
<a name="st-build-and-run-example"></a>

### Importieren Sie die FreeRTOS-Demo in die STM32 System Workbench
<a name="st-freertos-import-project"></a><a name="st-import-project"></a>

1. Öffnen Sie die STM32-System-Workbench und geben Sie einen Namen für einen neuen WorkSpace ein.

1. Wählen Sie im Menü **Datei** die Option **Import** aus. Erweitern Sie **General (Allgemein)**, wählen Sie **Existing Projects into Workspace (Vorhandene Projekte in WorkSpace)** aus und klicken Sie dann auf **Weiter**.

1. Unter **Select search-directory (Stammverzeichnis auswählen)** geben Sie `projects/st/stm32l475_discovery/ac6/aws_demos` ein.

1. Das Projekt `aws_demos` sollte standardmäßig ausgewählt werden.

1. Wählen Sie **Beenden** aus, um das Projekt in die STM32-System-Workbench zu importieren.

1. Wählen Sie im Menü **Projekt** die Option **Build All (Alle erstellen)** aus. Vergewissern Sie sich, dass das Projekt fehlerfrei kompiliert wurde.

### Überwachung von MQTT-Nachrichten in der Cloud
<a name="w2aac31b9b7c25c46c17b5"></a>

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.

### Führen Sie das FreeRTOS-Demo-Projekt aus
<a name="st-run-example"></a>

1. Verwenden Sie ein USB-Kabel, um Ihr STMicroelectronics STM32L4-Discovery-Kit für IoT-Knoten mit Ihrem Computer zu verbinden. (Informationen zum richtigen USB-Anschluss finden Sie in der Dokumentation des Herstellers, die mit Ihrem Motherboard geliefert wurde.)

1. Klicken Sie im **Project Explorer** mit der rechten Maustaste`aws_demos`, wählen Sie **Debug As** und dann **Ac6 C/C STM32** \+\+ Application.

   Wenn beim ersten Starten einer Debug-Sitzung ein Debug-Fehler auftritt, führen Sie die folgenden Schritte aus:

   1. Wählen Sie in der STM32-System-Workbench unter **Run (Ausführen)** die Option **Debug Configurations (Debug-Konfigurationen)** aus.

   1. Wählen Sie **aws\_demos Debuggen** aus. (Möglicherweise müssen Sie **Ac6 STM32 Debugging** erweitern.)

   1. Wählen Sie die Registerkarte **Debugger** aus.

   1. Im **Configuration Script (Konfigurationsskript)** wählen Sie **Show Generator Options (Generator-Optionen anzeigen)** aus.

   1. Setzen Sie unter **Mode Setup (Moduseinstellung)** die Option **Reset Mode (Modus zurücksetzen)** auf **Software System Reset (Software-System zurückzusetzen)**. Wählen Sie erst **Apply (Anwenden)** und anschließend **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.

### CMake mit FreeRTOS verwenden
<a name="w2aac31b9b7c25c46c17b9"></a>

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.

Erstellen Sie zunächst einen Ordner, der die generierten Build-Dateien () enthält. {{build-folder}}

Verwenden Sie den folgenden Befehl, um Build-Dateien zu erstellen:

```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S {{freertos}} -B {{build-folder}}
```

Wenn `arm-none-eabi-gcc` nicht in Ihrem Shellpfad liegt, müssen Sie auch die CMake-Variable `AFR_TOOLCHAIN_PATH` festlegen. Beispiel:

```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```

Weitere Hinweise zur Verwendung von CMake mit FreeRTOS finden Sie unter. [CMake mit FreeRTOS verwenden](getting-started-cmake.md)

## Fehlerbehebung
<a name="st-troubleshooting"></a>

Wenn Sie in der UART-Ausgabe der Demo-Anwendung Folgendes sehen, müssen Sie die Firmware des Wi-Fi Moduls aktualisieren:

```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```

Informationen zum Herunterladen der neuesten Wi-Fi Firmware finden Sie unter [STM32L4 Discovery Kit IoT-Knoten, Low-Power-WLAN, Bluetooth Low Energy, NFC, SubGHz,](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip). Wi-Fi Wählen Sie unter **Binary Resources** den Download-Link für das Firmware-Update für das **Inventek** ISM 43362-Modul aus. Wi-Fi 

Allgemeine Informationen zur Problembehandlung bei Getting Started with FreeRTOS finden Sie unter. [Fehlerbehebung – Erste Schritte](gsg-troubleshooting.md)