View a markdown version of this page

Erste Schritte mit dem Cypress-Kit CY8CKIT-064S0S2-4343W - FreeRTOS
Erste SchritteEntwicklungsumgebungHardware (Hardware)Baue und starteDebuggenOTA-Aktualisierungen

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 Cypress-Kit CY8CKIT-064S0S2-4343W

Wichtig

Diese Referenzintegration wird im Amazon-FreeRTOS Repository gehostet, das veraltet ist. 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, lesen Sie das. Amazon-FreeRTOS Leitfaden zur Migration zum Github-Repository

Dieses Tutorial enthält Anweisungen für den Einstieg in das Kit. CY8CKIT-064S0S2-4343W Wenn Sie noch keines haben, können Sie diesen Link verwenden, um ein Kit zu kaufen. Sie können diesen Link auch verwenden, um auf das Kit-Benutzerhandbuch zuzugreifen.

Erste Schritte

Bevor Sie beginnen, müssen Sie FreeRTOS konfigurieren AWS IoT , um Ihr Gerät mit der AWS Cloud zu verbinden. Detaillierte Anweisungen finden Sie unter Erste Schritte. Nachdem Sie die Voraussetzungen erfüllt haben, erhalten Sie ein FreeRTOS-Paket mit Anmeldeinformationen. AWS IoT Core

Anmerkung

In diesem Tutorial wird der Pfad zum FreeRTOS-Download-Verzeichnis, das im Abschnitt „Erste Schritte“ erstellt wurde, als bezeichnet. freertos

Einrichten der Entwicklungsumgebung

FreeRTOS funktioniert entweder mit einem CMake- oder Make-Build-Flow. Sie können es ModusToolbox für Ihren Make-Build-Flow verwenden. Sie können die im Lieferumfang enthaltene Eclipse-IDE ModusToolbox oder eine Partner-IDE wie IAR EW-Arm, Arm MDK oder Microsoft Visual Studio Code verwenden. Die Eclipse-IDE ist mit den Betriebssystemen Windows, MacOS und Linux kompatibel.

Bevor Sie beginnen, laden Sie die neueste ModusToolbox Software herunter und installieren Sie sie. Weitere Informationen finden Sie in der ModusToolbox Installationsanleitung.

Tools für ModusToolbox 2.1 oder älter werden aktualisiert

Wenn Sie die ModusToolbox 2.1 Eclipse IDE verwenden, um dieses Kit zu programmieren, müssen Sie OpenOCD und Firmware-loader Tools aktualisieren.

In den folgenden Schritten standardmäßig der ModusToolbox Pfad für:

  • Windows istC:\Users\user_name\ModusToolbox.

  • Linux ist user_home/ModusToolbox oder wo Sie die Archivdatei extrahieren möchten.

  • macOS befindet sich im Ordner „Programme“ auf dem Volume, das Sie im Assistenten auswählen.

OpenOCD wird aktualisiert

Dieses Kit benötigt Cypress OpenOCD 4.0.0 oder höher, um den Chip erfolgreich zu löschen und zu programmieren.

Um Cypress OpenOCD zu aktualisieren

  1. Gehen Sie zur Cypress OpenOCD-Release-Seite.

  2. Laden Sie die Archivdatei für Ihr Betriebssystem herunter (). Windows/Mac/Linux

  3. Löschen Sie die vorhandenen Dateien inModusToolbox/tools_2.x/openocd.

  4. Ersetzen Sie die Dateien ModusToolbox/tools_2.x/openocd durch den entpackten Inhalt des Archivs, das Sie in einem vorherigen Schritt heruntergeladen haben.

Aktualisierung Firmware-loader

Dieses Kit benötigt Cypress Firmware-loader 3.0.0 oder höher.

Um Cypress zu aktualisieren Firmware-loader

  1. Gehen Sie zur Firmware-loader Cypress-Release-Seite.

  2. Laden Sie die Archivdatei für Ihr Betriebssystem herunter (Windows/Mac/Linux).

  3. Löschen Sie die vorhandenen Dateien inModusToolbox/tools_2.x/fw-loader.

  4. Ersetzen Sie die Dateien ModusToolbox/tools_2.x/fw-loader durch den entpackten Inhalt des Archivs, das Sie in einem vorherigen Schritt heruntergeladen haben.

Alternativ können Sie CMake verwenden, um Projekt-Build-Dateien aus dem Quellcode der FreeRTOS-Anwendung zu generieren, das Projekt mit Ihrem bevorzugten Build-Tool zu erstellen und das Kit dann mit OpenOCD zu programmieren. Wenn Sie lieber ein GUI-Tool für die Programmierung mit dem CMake-Flow verwenden möchten, laden Sie Cypress Programmer von der Cypress Programming Solutions-Webseite herunter und installieren Sie es. https://www.cypress.com/products/psoc-programming-solutions Weitere Informationen finden Sie unter CMake mit FreeRTOS verwenden.

Einrichten Ihrer Hardware

Folgen Sie diesen Schritten, um die Hardware des Kits einzurichten.

  1. Stellen Sie Ihr Kit bereit

    Folgen Sie den Anweisungen im Bereitstellungshandbuch für CY8CKIT-064S0S2-4343W Kits, um Ihr Kit sicher bereitzustellen. AWS IoT

    Für dieses Kit ist CySecureTools 3.1.0 oder höher erforderlich.

  2. Richten Sie eine serielle Verbindung ein

    1. Verbinden Sie das Kit mit Ihrem Host-Computer.

    2. Der serielle USB-Anschluss für das Kit wird automatisch auf dem Host-Computer aufgelistet. Identifizieren Sie die Portnummer. In Windows können Sie ihn mithilfe des Geräte-Managers unter Anschlüsse (COM & LPT) identifizieren.

    3. Starten Sie ein serielles Terminal und öffnen Sie eine Verbindung mit den folgenden Einstellungen:

      • Baudrate: 115200

      • Daten: 8 Bit

      • Parität: Keine

      • Stop-Bits: 1

      • Flusssteuerung: Keine

Erstellen Sie das FreeRTOS-Demo-Projekt und führen Sie es aus

In diesem Abschnitt erstellen Sie die Demo und führen sie aus.

  1. Stellen Sie sicher, dass Sie die Schritte im Bereitstellungshandbuch für CY8CKIT-064S0S2-4343W Kit befolgen.

  2. Erstellen Sie die FreeRTOS-Demo.

    1. Öffnen Sie die Eclipse-IDE für ModusToolbox und wählen Sie einen Arbeitsbereich aus oder erstellen Sie einen.

    2. Wählen Sie im Menü Datei die Option Import aus.

      Erweitern Sie Allgemein, wählen Sie Existing Project Into Workspace und wählen Sie dann Weiter.

    3. Geben Sie im Feld Stammverzeichnis den Projektnamen ein freertos/projects/cypress/CY8CKIT-064S0S2-4343W/mtb/aws_demos und wählen Sie ihn dann ausaws_demos. Es sollte standardmäßig ausgewählt sein.

    4. Wähle Fertig stellen, um das Projekt in deinen Workspace zu importieren.

    5. Erstellen Sie die Anwendung, indem Sie einen der folgenden Schritte ausführen:

      • Wählen Sie im Quick Panel die Option AWS_DEMOS-Anwendung erstellen aus.

      • Wählen Sie „Projekt“ und dann „Alles erstellen“.

      Stellen Sie sicher, dass das Projekt ohne Fehler kompiliert wird.

  3. Überwachung von MQTT-Nachrichten in der Cloud

    Bevor Sie die Demo ausführen, können Sie den MQTT-Client in der AWS IoT Konsole einrichten, um die Nachrichten zu überwachen, die Ihr Gerät an die AWS Cloud sendet. Gehen Sie wie folgt vor, um das MQTT-Thema mit dem AWS IoT MQTT-Client zu abonnieren.

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

    2. Wählen Sie im Navigationsbereich Test und dann MQTT-Testclient aus, um den MQTT-Client zu öffnen.

    3. Geben Sie your-thing-name/example/topic als Abonnementthema ein und wählen Sie dann Thema abonnieren aus.

  4. Führen Sie das FreeRTOS-Demo-Projekt aus

    1. Wählen Sie das Projekt aws_demos im Arbeitsbereich aus.

    2. Wählen Sie im Quick Panel die Option aws_demos Program (KitProg3) aus. Dadurch wird das Board programmiert und die Demo-Anwendung beginnt zu laufen, nachdem die Programmierung abgeschlossen ist.

    3. Sie können den Status der laufenden Anwendung im seriellen Terminal einsehen. Die folgende Abbildung zeigt einen Teil der Terminalausgabe.

      Screenshot der Terminalausgabe nach dem Erstellen des aws_demo Projekts.

      Die MQTT-Demo veröffentlicht Nachrichten zu vier verschiedenen Themen (iotdemo/topic/n, wobei n=1 bis 4) und abonniert all diese Themen, um dieselben Nachrichten zurück zu erhalten. Wenn eine Nachricht eingeht, veröffentlicht die Demo eine Bestätigungsnachricht zum Thema. iotdemo/acknowledgements Die folgende Liste beschreibt die Debug-Meldungen, die in der Terminalausgabe erscheinen, mit Verweisen auf die Seriennummern der Nachrichten. In der Ausgabe werden zuerst die Treiberdetails für den WICED Host Driver (WHD) ohne Seriennummerierung gedruckt.

      1. 1 bis 4 — Das Gerät stellt eine Verbindung zum konfigurierten Access Point (AP) her und wird bereitgestellt, indem mithilfe des konfigurierten Endpunkts und der Zertifikate eine Verbindung zum AWS Server hergestellt wird.

      2. 5 bis 13 — Die CoreMQTT-Bibliothek wird initialisiert und das Gerät stellt eine MQTT-Verbindung her.

      3. 14 bis 17 — Das Gerät abonniert alle Themen, um die veröffentlichten Nachrichten zurück zu erhalten.

      4. 18 bis 30 — Das Gerät veröffentlicht zwei Nachrichten und wartet darauf, sie zurück zu erhalten. Wenn jede Nachricht empfangen wird, sendet das Gerät eine Bestätigungsnachricht.

      Derselbe Zyklus von Veröffentlichen, Empfangen und Bestätigen wird fortgesetzt, bis alle Nachrichten veröffentlicht sind. Zwei Nachrichten werden pro Zyklus veröffentlicht, bis die konfigurierte Anzahl der Zyklen abgeschlossen ist.

  5. CMake mit FreeRTOS verwenden

    Sie können CMake auch verwenden, um die Demo-Anwendung zu erstellen und auszuführen. Informationen zum Einrichten von CMake und einem nativen Build-System finden Sie unter. Voraussetzungen

    1. Verwenden Sie den folgenden Befehl, um Build-Dateien zu generieren. Geben Sie das Zielboard mit der -DBOARD Option an. 

      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir

      Wenn Sie Windows verwenden, müssen Sie das native Build-System mithilfe der -G Option angeben, da CMake standardmäßig Visual Studio verwendet.

      Beispiel
      cmake -DVENDOR=cypress -DBOARD=CY8CKIT_064S0S2_4343W -DCOMPILER=arm-gcc -S freertos -B build_dir -G Ninja

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

      Beispiel
       -DAFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin

    2. Verwenden Sie den folgenden Befehl, um das Projekt mit CMake zu erstellen.

      cmake --build build_dir

    3. Programmieren Sie abschließend die cm0.hex und cm4.hex Dateien, die unter mit Cypress Programmer generiert build_dir wurden.

Andere Demos ausführen

Die folgenden Demoanwendungen wurden getestet und für die Verwendung mit der aktuellen Version verifiziert. Sie finden diese Demos im freertos/demos Verzeichnis. Informationen zur Ausführung dieser Demos finden Sie unter. FreeRTOS RTOS-Demos

  • Demo über Bluetooth Low Energy

  • Over-the-Air Aktualisiert-Demo

  • Demo zum Secure Sockets Echo Client

  • AWS IoT Device Shadow-Demo

Debuggen

Die KitProg 3 auf dem Kit unterstützen das Debuggen über das SWD-Protokoll.

  • Um die FreeRTOS-Anwendung zu debuggen, wählen Sie das Projekt aws_demos im Arbeitsbereich aus und wählen Sie dann aws_demos Debug (3) aus dem Quick Panel aus. KitProg

OTA-Aktualisierungen

PSoC-64-MCUs haben alle erforderlichen FreeRTOS-Qualifikationstests bestanden. Die optionale Over-the-Air (OTA) -Funktion, die in der PSoC 64 Standard Secure-Firmware-Bibliothek implementiert ist, muss jedoch noch evaluiert werden. AWS Die implementierte OTA-Funktion besteht derzeit alle OTA-Qualifizierungstests mit Ausnahme von aws_ota_test_case_rollback_if_unable_to_connect_after_update.py. https://github.com/aws/amazon-freertos/blob/202012.00/tools/ota_e2e_tests/aws_ota_test/aws_ota_test_case_rollback_if_unable_to_connect_after_update.py

Wenn ein erfolgreich validiertes OTA-Image mithilfe der PSoC64 Standard Secure — AWS MCU auf ein Gerät angewendet wird und das Gerät nicht mit dem Gerät kommunizieren kann AWS IoT Core, kann das Gerät nicht automatisch zum zweifelsfrei funktionierenden Originalbild zurückkehren. Dies kann dazu führen, dass das Gerät für weitere Updates nicht erreichbar ist. AWS IoT Core Diese Funktion wird noch vom Cypress-Team entwickelt.

Weitere Informationen finden Sie unter OTA-Updates mit AWS und dem CY8CKIT-064S0S2-4343W Kit. Wenn Sie weitere Fragen haben oder technischen Support benötigen, wenden Sie sich an die Cypress Developer Community.