Leitfaden zur Migration des Amazon-FreerTOS Github-Repositorys - FreeRTOS

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.

Leitfaden zur Migration des Amazon-FreerTOS Github-Repositorys

Wenn Sie ein bestehendes FreeRTOS-Projekt haben, das auf dem inzwischen veralteten Amazon-Freertos-Repository basiert, gehen Sie wie folgt vor:

  1. Bleiben Sie über die neuesten, öffentlich verfügbaren Sicherheitsupdates auf dem Laufenden. Suchen Sie auf der Seite mit den FreeRTOS LTS-Bibliotheken nach Updates oder abonnieren Sie das GitHub FreeRTOS-LTS-Repository, um die neuesten LTS-Patches mit kritischen und sicherheitsrelevanten Bugfixes zu erhalten. Sie können die neuesten benötigten FreeRTOS LTS-Patches direkt aus den einzelnen Repositorys herunterladen oder klonen. GitHub

  2. Erwägen Sie, die Implementierung der Netzwerktransportschnittstelle umzugestalten, um Ihre Hardwareplattform zu optimieren. Die Zusammenfassung APIs wie Secure Sockets und WLAN APIs werden von der neuesten CoreMQTT-Bibliothek nicht benötigt. Weitere Informationen finden Sie unter Transport Interface.

Anhang

Die folgende Tabelle enthält Empfehlungen für alle Demo-Projekte, Legacy-Bibliotheken und Zusammenfassungen APIs im Amazon-FreeRTOS-Repository.

Migrierte Bibliotheken und Demos
Name Typ Empfehlungen

CoreHTTP

Demos und Bibliothek

Klonen oder laden Sie die CoreHTTP-Bibliothek direkt aus dem CoreHTTP-Repository (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter. Die CoreHTTP-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der CoreHTTP-Seite.

CoreMQTT

Demos und Bibliothek

Klonen oder laden Sie die CoreMQTT-Bibliothek direkt aus dem CoreMQTT-Repository (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter. Die CoreMQTT-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der CoreMQTT-Seite.

CoreMQTT-Agent

Demos und Bibliothek

Klonen oder laden Sie die CoreMQTT-Agent-Bibliothek direkt aus dem CoreMQTT-Agent-Repository (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter. Die CoreMQTT-Agent-Demos befinden sich im CoreMQTT-Agent-Demos-Repository. Weitere Informationen finden Sie auf der CoreMQTT-Agent-Seite.

device_defender_for_aws

Demos und Bibliothek

Die AWS IoT Device Defender-Bibliothek befindet sich in ihrem Repository in der AWS GitHub Organisation. Klonen oder laden Sie sie direkt aus dem AWS IoT Device Defender-Repository herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT Device Defender-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der AWS IoT Device Defender-Seite.

device_shadow_for_aws

Demos und Bibliothek

Die AWS IoT Device Shadow-Bibliothek befindet sich in ihrem Repository in der AWS GitHub Organisation. Klonen oder laden Sie es (Untermodul bei Verwendung von Git) direkt aus dem AWS IoT Device Shadow (Repository) herunter. Die AWS IoT Device Shadow-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der AWS IoT Device Shadow-Seite.

jobs_for_aws

Demos und Bibliothek

Die AWS IoT Jobs-Bibliothek befindet sich in ihrem Repository in der AWS GitHub Organisation. Klonen oder laden Sie sie direkt aus dem AWS IoT Jobs-Repository herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT Jobs-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der AWS IoT Jobs-Seite.

OTA

Demos und Bibliothek

Die AWS IoT Over-The-Air (OTA-) Update-Bibliothek befindet sich in ihrem Repository in der AWS GitHub Organisation. Klonen oder laden Sie sie direkt aus dem AWS IoT OTA-Repository herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT OTA-Demos befinden sich in der primären FreeRTOS-Distribution. Weitere Informationen finden Sie auf der AWS IoT OTA-Seite.

CLI und FreeRTOS_Plus_CLI

Demos und Bibliothek

Es läuft ein CLI-Beispiel auf WinSim. Weitere Informationen finden Sie auf der Seite FreeRTOS Plus Command Line Interface. Die Featured FreeRTOS IoT-Referenzintegrationen auf den Plattformen NXP i.MX RT1 060 und STM32U5 bieten auch CLI-Beispiele auf aktueller Hardware.

Protokollierung

Makro

Es gibt Implementierungen des Logging-Makros für bestimmte Hardwareplattformen, die von einigen FreeRTOS-Bibliotheken verwendet werden. Informationen zur Implementierung des Logging-Makros finden Sie auf der Logging-Seite. Ein Beispiel, das auf aktueller Hardware läuft, finden Sie in einer der von FreeRTOS empfohlenen IoT-Referenzen.

greengrass_connectivity

Demo

[Migration läuft] Bei diesem Demo-Projekt wurde davon ausgegangen, dass Cloud-Konnektivität verfügbar war, bevor eine Verbindung zu einem AWS IoT Greengrass-Gerät hergestellt wurde. Ein neues Projekt, das lokale Authentifizierungs- und Erkennungsfunktionen demonstriert, befindet sich in der Entwicklung. Erwarten Sie, dass das neue Demo-Projekt in Kürze in der FreeRTOS Github-Organisation veröffentlicht wird.

Veraltete Bibliotheken und Demos
Name Typ Empfehlungen

BLAU

Demos und Bibliotheken

Die FreeRTOS BLE-Bibliothek implementiert das proprietäre MQTT-Protokoll und unterstützt das Veröffentlichen und Abonnieren von MQTT-Themen über Bluetooth Low Energy (BLE) über ein Proxygerät wie ein Mobiltelefon. Dies ist nicht mehr vorgeschrieben. Verwenden Sie entweder Ihren eigenen BLE-Stack oder eine Drittanbieter-Option wie NiMBLE, um Ihr Projekt optimal zu optimieren.

dev_mode_key_provisioning

Demos

Die Featured FreeRTOS IoT-Referenzintegrationen auf den Plattformen NXP i.MX RT1 060, STM32U5 oder ESP32-C3 bieten Beispiele für wichtige Bereitstellungen mithilfe einer CLI.

Posix

Abstraktion und Demo

Nicht zur Verwendung empfohlen.

wifi_provisioning

Beispiel

In diesem Beispiel wurde gezeigt, wie WiFi Anmeldeinformationen auf einem Gerät mithilfe der Amazon-FreeRTOS BLE-Bibliothek bereitgestellt werden. Ein Beispiel für die WiFi Bereitstellung über BLE finden Sie in der FreeRTOS Featured IoT-Referenz auf der ESP32C3-Plattform.

Zusammenfassung der Vorgängerversionen APIs

Code

Diese wurden entwickelt APIs , um eine abstrakte Schnittstelle für verschiedene Software-Stacks, Konnektivitätsmodule und MCU-Plattformen von Drittanbietern verschiedener Anbieter bereitzustellen. Zum Beispiel gibt es Schnittstellen für WiFi Abstraktion, sichere Sockets usw. Sie werden im Amazon-FreeRTOS-Repository unterstützt und befinden sich im Ordner. /libraries/abstractions/ Diese APIs sind bei der Verwendung der FreeRTOS LTS-Bibliotheken nicht erforderlich.

Für die Bibliotheken und Demos in der obigen Tabelle werden keine Sicherheitspatches oder Bugfixes bereitgestellt.

Bibliotheken von Drittanbietern

Wenn Demos in Amazon-FreeRTOS Bibliotheken von Drittanbietern verwenden, empfehlen wir, diese direkt aus deren Repositorys von Drittanbietern zu submodulieren.

Portierungstests und Integrationstests

Alle Tests unter dem /tests Ordner, die zur Validierung der Integration von FreeRTOS-Bibliotheken erforderlich sind, wurden in das Repository migriert. FreeRTOS-Libraries-Integration-Tests Diese können verwendet werden, um die PAL-Implementierung und die Bibliotheksintegration zu testen. Dieselben Tests werden von AWS IoT Device Tester (IDT) für das AWS Gerätequalifizierungsprogramm für FreeRTOS verwendet.