Erste Schritte mit dem Windows-Gerätesimulator - FreeRTOS
Einrichten Ihrer EntwicklungsumgebungErstellen Sie das FreeRTOS-Demoprojekt und führen Sie es ausFehlerbehebung

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

Wichtig

Dies ist eine archivierte Version des FreeRTOS-Benutzerhandbuchs zur Verwendung mit der FreeRTOS-Version 202012.00. Die neueste Version dieses Dokuments finden Sie im FreeRTOS-Benutzerhandbuch.

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. 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 Windows-Instances ausgeführt werden.

Einrichten Ihrer Entwicklungsumgebung

  1. Installieren Sie die neueste Version von Win PCap.

  2. Installieren Sie Microsoft Visual Studio.

    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.

  3. Stellen Sie sicher, dass Sie über eine aktive kabelgebundene Ethernet-Verbindung verfügen.

  4. (Optional) Wenn Sie das CMake basierte Build-System verwenden möchten, um Ihre FreeRTOS-Projekte zu erstellen, installieren Sie die neueste Version von. CMake FreeRTOS benötigt CMake Version 3.13 oder höher.

Erstellen Sie das FreeRTOS-Demoprojekt und führen Sie es aus

Sie können Visual Studio verwenden oder CMake 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 (Datei/Lösung), navigieren Sie zur Datei projects/pc/windows/visual_studio/aws_demos/aws_demos.sln und wählen Sie dann Open (Öffnen).

  2. 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, die auf Ihrem Computer vorhanden ist (der Anfangswert in der Dropdown-Liste ist in Ordnung), und wählen Sie dann OK.

  3. 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. Beim ersten Durchlauf müssen Sie eine Netzwerkschnittstelle auswählen.

Aufbau und Ausführung des FreeRTOS-Demo-Projekts mit CMake

Wir empfehlen, dass Sie die CMake GUI anstelle des CMake Befehlszeilentools verwenden, um das Demo-Projekt für den Windows Simulator zu erstellen.

Öffnen Sie nach der Installation CMake die CMake GUI. Unter Windows finden Sie dies im Startmenü unter CMakeCMake (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.

  2. Konfigurieren Sie das CMake Projekt.

    Wählen Sie in der CMake GUI Eintrag hinzufügen und legen Sie im Fenster Cache-Eintrag hinzufügen die folgenden Werte fest:

    Name

    AFR_BOARD

    Typ

    STRING

    Wert

    pc.windows

    Beschreibung

    (Optional)

  3. Wählen Sie Konfigurieren aus. Wenn Sie CMake aufgefordert werden, das Build-Verzeichnis zu erstellen, wählen Sie Ja und wählen Sie dann unter Generator für dieses Projekt angeben einen Generator 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 Finish (Abschließen) aus.

  4. Generieren und öffnen Sie das CMake Projekt.

    Nachdem Sie das Projekt konfiguriert haben, zeigt die CMake GUI alle verfügbaren Optionen für das generierte Projekt an. Für die Zwecke dieses Tutorials können Sie die Optionen als Standardwerte beibehalten.

    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. Beim ersten Durchlauf müssen Sie eine Netzwerkschnittstelle auswählen.

Weitere Hinweise zur Verwendung CMake mit FreeRTOS finden Sie unter. Verwendung CMake mit FreeRTOS

Konfigurieren Ihrer Netzwerkschnittstelle

Beim ersten Durchlauf des Demoprojekts müssen Sie die zu verwendende Netzwerkschnittstelle auswählen. Das Programm listet Ihre Netzwerkschnittstellen auf. 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 obigen Beispiel ist die zu verwendende Zahl 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. WLAN wird nicht unterstützt. Weitere Informationen finden Sie im WinPcap FAQ-Eintrag Q-16: Welche Netzwerkadapter werden unterstützt von? WinPcap .

Überwachung von MQTT-Nachrichten in der Cloud

Sie können den MQTT-Client in der AWS IoT Konsole verwenden, um die Nachrichten zu überwachen, die Ihr Gerät an die AWS Cloud sendet.

Um das MQTT-Thema mit dem MQTT-Client zu abonnieren AWS IoT

  1. Melden Sie sich an der AWS IoT -Konsole an.

  2. Wählen Sie im Navigationsbereich die Option Test aus, 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).

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 Getting Started with FreeRTOS finden Sie unter. Fehlerbehebung – Erste Schritte