View a markdown version of this page

Amazon-FreeRTOS Leitfaden zur Migration zum Github-Repository - 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.

Amazon-FreeRTOS Leitfaden zur Migration zum Github-Repository

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 FreeRTOS-LTS GitHub 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 abstrakten APIs wie Secure Sockets und Wifi-APIs werden von der neuesten CoreMQTT-Bibliothek nicht benötigt. Weitere Informationen finden Sie unter Transportschnittstelle.

Anhang

Die folgende Tabelle enthält Empfehlungen für alle Demo-Projekte, Legacy-Bibliotheken und abstrakte APIs innerhalb des Amazon-FreeRTOS Repositorys.

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.

Kern MQTT-Agent

Demos und Bibliothek

Klonen oder laden Sie die MQTT-Agent Kernbibliothek direkt aus dem MQTT-AgentCore-Repository (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter. Die MQTT-Agent Kerndemos befinden sich im Core-Repository. MQTT-Agent-Demos Weitere Informationen finden Sie auf der MQTT-Agent Kernseite.

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 RT1060 und STM32U5 bieten auch CLI-Beispiele auf aktueller Hardware.

Protokollierung

macro

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 ausgeführt wird, 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 RT1060, STM32U5 oder bieten Beispiele für wichtige Bereitstellungen mithilfe einer CLI. ESP32-C3

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 Bereitstellung über BLE finden Sie in der FreeRTOS Featured IoT-Referenz auf der WiFi ESP32C3-Plattform.

Ältere abstrakte APIs

Code

Dies sind APIs, die entwickelt wurden, um eine abstrakte Schnittstelle für verschiedene Software-Stacks, Konnektivitätsmodule und MCU-Plattformen von Drittanbietern verschiedener Anbieter bereitzustellen. Beispielsweise 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 nicht erforderlich, wenn Sie die FreeRTOS LTS-Bibliotheken verwenden.

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

Third-party Bibliotheken

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

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.