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 auf dem neuesten Stand des Stack-Sets. Prüfen Sie:FreeRTOS-LTS-BibliothekenSeite für Updates, oder abonnieren Sie dieFreer zu S-LTS GitHub Repository, um die neuesten LTS-Patches mit kritischen und sicherheitstechnischen Bugfixes zu erhalten. Sie können die neuesten erforderlichen FreeRTOS LTS-Patches direkt von der jeweiligen Person herunterladen oder klonen GitHub Repositorien.

2. Erwägen Sie, die Implementierung der Netzwerktransportschnittstelle umzugestalten, um Ihre Hardwareplattform zu optimieren. Die abstrakten APIs wiesichere SocketsundWifi-APIssind in der neuesten Version nicht erforderlichCoreMQTTBibliothek: SiehstTransport-Schnittstellefür weitere Informationen.

Anhang

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

Migrierte Bibliotheken und Demos
Name	Typ	Empfehlungen
Core-HTTP	Demos und Bibliothek	Klonen oder laden Sie die CoreHttp-Bibliothek direkt vonCoreHTTPRepository (Untermodul bei Verwendung von Git) imFreeRTOS Github-Organisation. Die CoreHTTP-Demos befinden sich in derprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imCoreHTTP-Seite.
CoreMQTT	Demos und Bibliothek	Klonen oder laden Sie die CoreMQTT-Bibliothek direkt vonCoreMQTTRepository (Untermodul bei Verwendung von Git) imFreeRTOS Github-Organisation. Die CoreMQTT-Demos befinden sich in derprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imCoreMQTT-Seite.
Kern-MQTT-Agent	Demos und Bibliothek	Klonen oder laden Sie die CoreMQTT-Agent-Bibliothek direkt von derKern-MQTT-AgentRepository (Untermodul bei Verwendung von Git) imFreeRTOS Github-Organisation. Die CoreMQTT-Agent-Demos befinden sich imCoreMQTT-Agent-DemosEndlager: Weitere Einzelheiten sehen Sie imCoreMQTT-Agent-Seite.
Device_Defender_für_AWS	Demos und Bibliothek	DieAWS IoTDie Device Defender-Bibliothek befindet sich in ihrem Repository imAWS GitHub Organisation. Klonen Sie es oder laden Sie es herunter (Untermodul, wenn Sie Git verwenden) direkt vonAWS IoTDevice DefenderEndlager: DasAWS IoTDie Demos von Device Defender befinden sich imprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imAWS IoTDevice Defender-Seite.
Geräteschadow_für_AWS	Demos und Bibliothek	DieAWS IoTDie Device Shadow-Bibliothek befindet sich in ihrem Repository imAWS GitHub Organisation. Klonen Sie es oder laden Sie es herunter (Untermodul, wenn Sie Git verwenden) direkt vonAWS IoTDevice Shadow) Endlager: DasAWS IoTDevice Shadow-Demos finden Sie imprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imAWS IoTDevice Shadow-Seite:.
Jobs für AWS	Demos und Bibliothek	DieAWS IoTDie Jobs-Bibliothek befindet sich in ihrem Repository imAWS GitHub Organisation. Klonen Sie es oder laden Sie es herunter (Untermodul, wenn Sie Git verwenden) direkt vonAWS IoTJobsEndlager: DasAWS IoTJob-Demos sind in derprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imAWS IoTSeite „Jobs“.
OTA	Demos und Bibliothek	DieAWS IoTDie Over-The-Air (OTA) Update-Bibliothek befindet sich in ihrem Repository imAWS GitHub Organisation. Klonen Sie es oder laden Sie es herunter (Untermodul, wenn Sie Git verwenden) direkt vonAWS IoTOTAEndlager: DasAWS IoTOTA-Demos sind in derprimäre FreeRTOS-Distribution. Weitere Einzelheiten sehen Sie imAWS IoTOTA-Seite.
CLI und FreeRTOS_Plus_CLI	Demos und Bibliothek	Im Folgenden sehen Sie ein CLI-Beispiel: WinSim. Beziehen Sie sich auf dieFreeRTOS Plus-BefehlszeilenschnittstelleSeite für weitere Details. Die vorgestellten FreeRTOS IoT-Referenzintegrationen auf derNXP i.MX RT1060undSTM32U5Plattformen, 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. Weitere Informationen finden Sie imSeite zur Protokollierungfür die Implementierung des Logging-Makros. Weitere Informationen finden Sie untereine der von FreeRTOS empfohlenen IoT-Referenzenfür ein Beispiel, das auf aktueller Hardware läuft.
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 hergestellt wurdeAWS IoTGreengrass-Gerät: Ein neues Projekt, das die Fähigkeit zur lokalen Authentifizierung und Erkennung demonstriert, befindet sich in der Entwicklung. Erwarten Sie, dass das neue Demo-Projekt in Kürze veröffentlicht wirdFreeRTOS Github-Organisation.

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 wieNimbleum Ihr Projekt bestmöglich zu optimieren.
dev_mode_key_provisioning	Demos	Die vorgestellten FreeRTOS IoT-Referenzintegrationen auf derNXP i.MX RT1060,STM32U5, oderESP32-C3Plattformen 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 die Bereitstellung erfolgt WiFi Anmeldeinformationen auf einem Gerät, das die Amazon-FreeRTOS BLE-Bibliothek verwendet. Weitere Informationen finden Sie in der FreeRTOS Featured IoT-Referenz auf derESP32C3-Plattformfür ein Beispiel für WiFi Bereitstellung über BLE.
Ä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. Zum Beispiel gibt es Schnittstellen für WiFi Abstraktion, sichere Sockets und so weiter. Sie werden im Amazon-FreeRTOS-Repository unterstützt und befinden sich im Ordner/libraries/abstractions/. Diese APIs sind nicht erforderlich bei der Verwendung vonFreeRTOS-LTS-Bibliotheken.

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.

• CMock: klone es (Submodul, wenn du Git benutzt) direkt vonCmockEndlager:

• jsmn: wird nicht empfohlen und wird nicht mehr unterstützt.

• lwip: klone es (Submodul, wenn du Git benutzt) direkt vonlwip-tcpipEndlager:

• lwip_osal: siehe die Featured Reference Integrations von FreeRTOS aufi.MX RT1060oderSTM32U5für die Implementierung von lwip_osal auf Ihrer Hardware-Plattform/Ihrem Board.

• mbedtls: klone es (Submodul, wenn du Git verwendest) direkt vonMbed-TLSEndlager: Die mbedtls-Konfiguration und die Hilfsprogramme können wiederverwendet werden. Erstellen Sie in diesem Fall eine lokale Kopie.

• Pkcs11: klone es (Submodul, wenn du Git benutzt) direkt von einem derCorePkCS11Bibliothek oderOASE: BILDER: 11Endlager:

• Tinycbor: klone es (Submodul, wenn du Git benutzt) direkt vontinycborEndlager:

• Tinycrypt: Wir empfehlen Ihnen, Kryptobeschleuniger von Ihrer MCU-Plattform zu verwenden, sofern verfügbar. Wenn Sie Tinycrypt weiterhin verwenden möchten, klonen Sie es (Submodul, wenn Sie Git verwenden) direkt vontinycryptEndlager:

• tracealyzer_recorder: klone es (Submodul, wenn du Git verwendest) direkt von PercepioTrace-RekorderEndlager:

• Einheit: klone es (Submodul, wenn du Git benutzt) direkt vonThrowTheSwitch/UnityEndlager:

• win_pcap: win_pcap wird nicht mehr verwaltet. Wir empfehlen, stattdessen libslirp, libpcap (posix) oder npcap zu verwenden.

Portierungstests und Integrationstests

Alle Tests im Rahmen der/testsOrdner, die zur Validierung der Integration von FreeRTOS-Bibliotheken erforderlich sind, wurden migriert in denFreeRTOS-Bibliotheken — IntegrationstestsEndlager: Diese können verwendet werden, um die PAL-Implementierung und die Bibliotheksintegration zu testen. Dieselben Tests werden verwendet vonAWS IoTGerätetester (IDT) fürAWSGerätequalifizierungsprogramm für FreeRTOS.