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](https://www.freertos.org/lts-libraries.html) nach Updates oder abonnieren Sie das [ GitHub FreeRTOS-LTS-Repository, um die neuesten LTS-Patches](https://github.com/FreeRTOS/FreeRTOS-LTS) 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
1. Erwägen Sie, die Implementierung der Netzwerktransportschnittstelle umzugestalten, um Ihre Hardwareplattform zu optimieren. Die Zusammenfassung APIs wie [Secure Sockets](https://docs.aws.amazon.com/freertos/latest/userguide/secure-sockets.html) und [WLAN APIs](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-wifi.html) werden von der neuesten [CoreMQTT-Bibliothek](https://www.freertos.org/mqtt/index.html) nicht benötigt. Weitere Informationen finden Sie unter [Transport Interface](https://www.freertos.org/network-interface.html).
## 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](https://github.com/FreeRTOS/coreHTTP) (Untermodul bei Verwendung von Git) in der [FreeRTOS](https://github.com/FreeRTOS) Github-Organisation herunter. Die CoreHTTP-Demos befinden sich in der [primären FreeRTOS-Distribution](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreHTTP_Windows_Simulator). [Weitere Informationen finden Sie auf der CoreHTTP-Seite.](https://www.freertos.org/http/index.html) |
| CoreMQTT | Demos und Bibliothek | [Klonen oder laden Sie die CoreMQTT-Bibliothek direkt aus dem [CoreMQTT-Repository](https://github.com/FreeRTOS/coreMQTT) (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter.](https://github.com/FreeRTOS) Die CoreMQTT-Demos befinden sich in der [primären](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/coreMQTT_Windows_Simulator) FreeRTOS-Distribution. [Weitere Informationen finden Sie auf der CoreMQTT-Seite.](https://www.freertos.org/mqtt/index.html) |
| CoreMQTT-Agent | Demos und Bibliothek | [Klonen oder laden Sie die CoreMQTT-Agent-Bibliothek direkt aus dem [CoreMQTT-Agent-Repository](https://github.com/FreeRTOS/coreMQTT-Agent) (Untermodul bei Verwendung von Git) in der FreeRTOS Github-Organisation herunter.](https://github.com/FreeRTOS) Die [CoreMQTT-Agent-Demos](https://github.com/FreeRTOS/coreMQTT-Agent-Demos) befinden sich im CoreMQTT-Agent-Demos-Repository. Weitere Informationen finden Sie auf der CoreMQTT-Agent-Seite[.](https://www.freertos.org/mqtt-agent/index.html) |
| device\$1defender\$1for\$1aws | Demos und Bibliothek | Die AWS IoT Device Defender-Bibliothek befindet sich in ihrem Repository in der [AWS GitHub Organisation](https://github.com/AWS). Klonen oder laden Sie sie direkt aus dem [AWS IoT Device Defender-Repository](https://github.com/aws/Device-Defender-for-AWS-IoT-embedded-sdk) herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT Device Defender-Demos befinden sich in der [primären FreeRTOS-Distribution](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Defender_Windows_Simulator/Device_Defender_Demo). Weitere Informationen finden Sie auf der [AWS IoT Device](https://www.freertos.org/iot-device-defender/index.html) Defender-Seite. |
| device\$1shadow\$1for\$1aws | Demos und Bibliothek | Die AWS IoT Device Shadow-Bibliothek befindet sich in ihrem Repository in der [AWS GitHub Organisation](https://github.com/AWS). Klonen oder laden Sie es (Untermodul bei Verwendung von Git) direkt aus dem [AWS IoT Device Shadow](https://github.com/aws/Device-Shadow-for-AWS-IoT-embedded-sdk) (Repository) herunter. Die AWS IoT Device Shadow-Demos befinden sich in der [primären FreeRTOS-Distribution](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Device_Shadow_Windows_Simulator). Weitere Informationen finden Sie auf der [AWS IoT Device Shadow-Seite](https://www.freertos.org/iot-device-shadow/index.html). |
| jobs\$1for\$1aws | Demos und Bibliothek | Die AWS IoT Jobs-Bibliothek befindet sich in ihrem Repository in der [AWS GitHub Organisation](https://github.com/AWS). Klonen oder laden Sie sie direkt aus dem [AWS IoT Jobs-Repository](https://github.com/aws/Jobs-for-AWS-IoT-embedded-sdk) herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT Jobs-Demos befinden sich in der [primären FreeRTOS-Distribution](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Jobs_Windows_Simulator/Jobs_Demo). [Weitere Informationen finden Sie auf der AWS IoT Jobs-Seite.](https://www.freertos.org/iot-jobs/index.html) |
| OTA | Demos und Bibliothek | Die AWS IoT Over-The-Air (OTA-) Update-Bibliothek befindet sich in ihrem Repository in der [AWS GitHub Organisation](https://github.com/AWS). Klonen oder laden Sie sie direkt aus dem [AWS IoT OTA-Repository](https://github.com/aws/ota-for-aws-iot-embedded-sdk) herunter (Untermodul, wenn Sie Git verwenden). Die AWS IoT OTA-Demos befinden sich in der [primären FreeRTOS-Distribution](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS-Plus/Demo/AWS/Ota_Windows_Simulator). [Weitere Informationen finden Sie auf der AWS IoT OTA-Seite.](https://www.freertos.org/ota/index.html) |
| CLI und FreeRTOS\$1Plus\$1CLI | Demos und Bibliothek | Es läuft ein CLI-Beispiel auf WinSim. Weitere Informationen finden Sie auf der Seite [FreeRTOS Plus Command Line Interface](https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_CLI/FreeRTOS_Plus_Command_Line_Interface.html). Die Featured FreeRTOS IoT-Referenzintegrationen auf den Plattformen [NXP i.MX RT1 060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/cli) und [ STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/tree/main/Common/cli) 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](https://www.freertos.org/logging.html). [Ein Beispiel, das auf aktueller Hardware läuft, finden Sie in einer der von FreeRTOS empfohlenen IoT-Referenzen](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/tree/main/examples/common/logging). |
| greengrass\$1connectivity | 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](https://github.com/FreeRTOS) 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](https://mynewt.apache.org/latest/network/), um Ihr Projekt optimal zu optimieren. |
| dev\$1mode\$1key\$1provisioning | Demos | Die Featured FreeRTOS IoT-Referenzintegrationen auf den Plattformen [NXP i.MX RT1 060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060/blob/main/examples/common/cli/cli.c), [ STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5/blob/main/Common/cli/cli_pki.c) oder [ ESP32-C3](https://github.com/FreeRTOS/iot-reference-esp32c3/blob/main/GettingStartedGuide.md) bieten Beispiele für wichtige Bereitstellungen mithilfe einer CLI. |
| Posix | Abstraktion und Demo | Nicht zur Verwendung empfohlen. |
| wifi\$1provisioning | 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](https://github.com/FreeRTOS/iot-reference-esp32c3). |
| 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](https://www.freertos.org/lts-libraries.html) 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.
+ **CMock**[: klone es (Submodul, wenn du Git verwendest) direkt aus dem Cmock-Repository.](https://github.com/ThrowTheSwitch/CMock)
+ **jsmn**: nicht empfohlen und nicht mehr unterstützt.
+ **lwip**[: klone es (Submodul, wenn du Git benutzt) direkt aus dem lwip-tcpip-Repository.](https://github.com/lwip-tcpip/lwip)
+ **lwip\$1osal: Informationen zur Implementierung von lwip\$1osal** auf Ihrer Hardwareplattform/Ihrem Board finden Sie in den FreeRTOS Featured Reference Integrations auf [i.MX RT1 060](https://github.com/FreeRTOS/iot-reference-nxp-rt1060) oder [STM32U5](https://github.com/FreeRTOS/iot-reference-stm32u5).
+ **mbedtls: klone es (Submodul, wenn du Git verwendest**[) direkt aus dem Mbed-TLS-Repository.](https://github.com/Mbed-TLS/mbedtls) Die mbedtls-Konfiguration und die Hilfsprogramme können wiederverwendet werden. Erstellen Sie in diesem Fall eine lokale Kopie.
+ **pkcs11**[: klonen Sie es (Submodul, wenn Sie Git verwenden) direkt aus der [PKCS11Kernbibliothek](https://github.com/FreeRTOS/corePKCS11) oder dem OASIS PKCS 11-Repository.](https://github.com/oasis-tcs/pkcs11)
+ **tinycbor**[: klone es (Submodul, wenn du Git verwendest) direkt aus dem Tinycbor-Repository.](https://github.com/intel/tinycbor)
+ **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 aus dem Tinycrypt-Repository.](https://github.com/intel/tinycrypt)
+ **tracealyzer\$1recorder**[: Klonen Sie es (Submodul, wenn Sie Git verwenden) direkt aus dem Trace-Recorder-Repository von Percepio.](https://github.com/percepio/TraceRecorderSource)
+ **Unity**[: klone es (Submodul, wenn du Git verwendest) direkt aus dem /Unity-Repository. ThrowTheSwitch](https://github.com/ThrowTheSwitch/Unity)
+ **win\$1pcap: win\$1pcap** wird nicht mehr verwaltet. Wir empfehlen, stattdessen libslirp, libpcap (posix) oder npcap zu verwenden.
**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](https://github.com/FreeRTOS/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](https://docs.aws.amazon.com/freertos/latest/qualificationguide/afr-qualification.html) verwendet.