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 Windows-Gerätesimulator
Dieses Tutorial enthält Anweisungen für die ersten Schritte mit dem FreeRTOS Windows Device Simulator.
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}}`
FreeRTOS wird als Zip-Datei veröffentlicht, die die FreeRTOS-Bibliotheken und Beispielanwendungen für die von Ihnen angegebene Plattform enthält. Um die Beispiele auf einem Windows-Computer auszuführen, laden Sie die Bibliotheken und portierten Beispiele für die Ausführung auf Windows herunter. Diese Dateien werden als FreeRTOS Simulator für Windows bezeichnet.
**Anmerkung**
Dieses Tutorial kann nicht erfolgreich auf Amazon EC2 EC2-Windows-Instances ausgeführt werden.
## Einrichten Ihrer Entwicklungsumgebung
1. Installieren Sie die neueste Version von [Npcap.](https://npcap.com/) Wählen Sie während der Installation WinPcap API-compatible den "Modus“.
1. Installieren Sie [Microsoft Visual Studio](https://www.visualstudio.com/downloads).
Visual Studio-Versionen 2017 und 2019 funktionieren. Alle Editionen dieser Visual Studio-Versionen werden unterstützt (Community, Professional oder Enterprise).
Installieren Sie zusätzlich zur IDE die Komponente **Desktop-Entwicklung mit C\+\+**.
Installieren Sie das neueste Windows 10 SDK. Sie können dies unter dem Abschnitt **Optional** der **Desktop-Entwicklung mit der Komponente C\+\+** auswählen.
1. Stellen Sie sicher, dass Sie über eine aktive kabelgebundene Ethernet-Verbindung verfügen.
1. [(Optional) Wenn Sie das CMake-based Build-System zum Erstellen Ihrer FreeRTOS-Projekte verwenden möchten, installieren Sie die neueste Version von CMake.](https://cmake.org/download/) FreeRTOS benötigt CMake Version 3.13 oder höher.
## Ü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 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 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\!“ mehrfach zu dem Thema gesendet, das Sie abonniert haben.
## Erstellen Sie das FreeRTOS-Demoprojekt und führen Sie es aus
Sie können Visual Studio oder CMake verwenden, um FreeRTOS-Projekte zu erstellen.
### Erstellen und Ausführen des FreeRTOS-Demoprojekts mit der Visual Studio IDE
1. Laden Sie das Projekt in Visual Studio.
Klicken Sie in Visual Studio im Menü **File (Datei)** auf die Option **Open (Öffnen)**. **Wählen Sie **File/Solution**, navigieren Sie zu der `projects/pc/windows/visual_studio/aws_demos/aws_demos.sln` Datei und wählen Sie dann Öffnen.**
1. Richten Sie das Demoprojekt neu aus.
Das bereitgestellte Demoprojekt hängt vom Windows-SDK ab, hat aber keine Windows-SDK-Version angegeben. Standardmäßig kann die IDE versuchen, die Demo mit einer SDK-Version zu erstellen, die nicht auf Ihrem Computer vorhanden ist. Um die Windows-SDK-Version einzustellen, klicken Sie mit der rechten Maustaste auf `aws_demos` und wählen Sie dann **Retarget project (Projekte neu ausrichten)**. Dadurch wird das Fenster **Review solution actions (Lösungsaktionen überprüfen)** geöffnet. Wählen Sie eine Windows SDK-Version aus, die auf Ihrem Computer vorhanden ist (der Anfangswert in der Dropdownliste ist in Ordnung), und wählen Sie dann **OK**.
1. Erstellen und Ausführen des Projekts.
Wählen Sie im Menü **Build (Erstellen)** die Option **Build Solution (Lösung erstellen)** aus und stellen Sie sicher, dass die Lösung ohne Fehler und Warnungen erstellt wird. Wählen Sie **Debug**, **Start debugging (Debugging starten)**, um das Projekt auszuführen. Bei der ersten Ausführung müssen Sie [eine Netzwerkschnittstelle auswählen](#win-network-interface).
### Das FreeRTOS-Demoprojekt mit CMake erstellen und ausführen
Wir empfehlen, dass Sie die CMake-GUI anstelle des CMake-Befehlszeilentools verwenden, um das Demo-Projekt für den Windows-Simulator zu erstellen.
Nachdem Sie CMake installiert haben, öffnen Sie die CMake-GUI. Unter Windows finden Sie diese im Startmenü unter **CMake**, **CMake (cmake-gui)**.
1. Legt das FreeRTOS-Quellcodeverzeichnis fest.
Stellen Sie in der GUI das FreeRTOS-Quellcodeverzeichnis (`{{freertos}}`) für **Wo ist der Quellcode** ein.
Stellen Sie ein**, wo `{{freertos}}/build` die Binärdateien erstellt werden sollen**.
1. Konfigurieren Sie das CMake-Projekt.
Wählen Sie in der CMake-Be **Add Entry (Eintrag hinzufügen)** aus, und legen Sie im Fenster **Add Cache Entry (Cache-Eintrag hinzufügen)** die folgenden Werte fest:
**Name**
AFR\_BOARD
**Typ**
STRING
**Wert**
pc.windows
**Description**
(Optional)
1. Wählen Sie **Konfigurieren** aus. Wenn CMake Sie auffordert, das Build-Verzeichnis zu erstellen, wählen Sie **Yes (Ja)**, und wählen Sie dann einen Generator unter **Specify the generator for this project (Bestimmen Sie den Generator für dieses Projekt)** aus. Wir empfehlen die Verwendung von Visual Studio als Generator, aber auch Ninja wird unterstützt. (Beachten Sie, dass bei der Verwendung von Visual Studio 2019 die Plattform auf Win32 anstatt auf ihre Standardeinstellung eingestellt sein sollte.) Lassen Sie die anderen Generatoroptionen unverändert und wählen Sie **Fertig stellen.**
1. Generieren und öffnen Sie das CMake-Projekt.
Nachdem Sie das Projekt konfiguriert haben, zeigt die CMake-GUI alle für das generierte Projekt verfügbaren Optionen an. Für die Zwecke dieses Tutorials können Sie die Optionen auf ihren Standardwerten belassen.
Wählen Sie **Generate (Generieren)**, um eine Visual Studio-Lösung zu erstellen, und wählen Sie dann **Open Project (Projekt öffnen)**, um das Projekt in Visual Studio zu öffnen.
Klicken Sie in Visual Studio mit der rechten Maustaste auf das `aws_demos` Projekt und wählen Sie **Als StartUp Projekt festlegen**. Dies ermöglicht es Ihnen, das Projekt zu erstellen und auszuführen. Bei der ersten Ausführung müssen Sie [eine Netzwerkschnittstelle auswählen](#win-network-interface).
Weitere Hinweise zur Verwendung von CMake mit FreeRTOS finden Sie unter. [CMake mit FreeRTOS verwenden](getting-started-cmake.md)
### Konfigurieren Ihrer Netzwerkschnittstelle
Beim ersten Durchlauf des Demoprojekts müssen Sie die zu verwendende Netzwerkschnittstelle auswählen. Das Programm zählt Ihre Netzwerkschnittstellen. Suchen Sie nach der Zahl für Ihre kabelgebundene Ethernet-Schnittstelle. Die Ausgabe sollte in etwa wie folgt aussehen:
```
0 0 [None] FreeRTOS_IPInit
1 0 [None] vTaskStartScheduler
1. rpcap://\Device\NPF_{AD01B877-A0C1-4F33-8256-EE1F4480B70D}
(Network adapter 'Intel(R) Ethernet Connection (4) I219-LM' on local host)
2. rpcap://\Device\NPF_{337F7AF9-2520-4667-8EFF-2B575A98B580}
(Network adapter 'Microsoft' on local host)
The interface that will be opened is set by "configNETWORK_INTERFACE_TO_USE", which
should be defined in FreeRTOSConfig.h
ERROR: configNETWORK_INTERFACE_TO_USE is set to 0, which is an invalid value.
Please set configNETWORK_INTERFACE_TO_USE to one of the interface numbers listed above,
then re-compile and re-start the application. Only Ethernet (as opposed to Wi-Fi)
interfaces are supported.
```
Nachdem Sie die Zahl für Ihre kabelgebundene Ethernet-Schnittstelle ermittelt haben, schließen Sie das Anwendungsfenster. Im vorherigen Beispiel lautet die zu verwendende Nummer`1`.
Öffnen Sie `FreeRTOSConfig.h` und legen Sie `configNETWORK_INTERFACE_TO_USE` auf die Zahl fest, die mit Ihrer fest implementierten Netzwerkschnittstelle übereinstimmt.
**Wichtig**
Es werden nur Ethernet-Schnittstellen unterstützt. Wi-Fi wird nicht unterstützt.
## Fehlerbehebung
### Fehlerbehebung bei häufigen Problemen unter Windows
Sie können auf den folgenden Fehler stoßen, wenn Sie versuchen, das Demoprojekt mit Visual Studio zu erstellen:
```
Error "The Windows SDK version X.Y was not found" when building the provided Visual Studio solution.
```
Das Projekt muss auf eine Windows SDK-Version ausgerichtet sein, die auf Ihrem Computer vorhanden ist.
Allgemeine Informationen zur Problembehandlung bei den ersten Schritten mit FreeRTOS finden Sie unter. [Fehlerbehebung – Erste Schritte](gsg-troubleshooting.md)