Amazon-FreeRTOS Github 儲存庫遷移指南 - 免費RTOS
附錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon-FreeRTOS Github 儲存庫遷移指南

如果您有以現在已棄用之 amazon-freertos 儲存庫為基礎的現有免費RTOS專案，請遵循下列步驟：

  1. 隨時掌握最新、公開可用的安全修正。檢查免費RTOSLTS程式庫頁面以取得更新，或訂閱免費 RTOS- LTS GitHub 儲存庫，以接收具有重大和安全錯誤修正的最新LTS修補程式。您可以直接從個別 GitHub 儲存庫下載或複製所需的最新免費RTOSLTS修補程式。

  2. 請考慮重構網路傳輸介面實作，以最佳化您的硬體平台。最新的核心MQTT程式庫不需要安全通訊端和 Wifi APIs APIs等摘要。如需更多詳細資訊，請參閱傳輸介面。

附錄

下表提供 Amazon-FreeRTOS 儲存庫APIs內所有示範專案、舊版程式庫和摘要的建議。

遷移的程式庫和示範
名稱 Type 建議

核心HTTP

示範和程式庫

直接從 FreeRTOS Github 組織中的核心HTTP儲存庫 （如果使用 git，則使用子模組） 複製或下載核心HTTP程式庫。核心HTTP示範位於主要免費RTOS分發 中。如需詳細資訊，請參閱核心HTTP頁面 。

核心MQTT

示範和程式庫

直接從 FreeRTOS Github 組織中的核心MQTT儲存庫 （如果使用 git，則使用子模組） 複製或下載核心MQTT程式庫。核心MQTT示範位於主要免費RTOS分發 中。如需詳細資訊，請參閱核心MQTT頁面 。

核心 MQTT- 客服人員

示範和程式庫

直接從 FreeRTOS Github 組織中的核心 MQTT-Agent 儲存庫 （若使用 git，則為子模組） 複製或下載核心 MQTT-Agent 程式庫。核心MQTT客服人員示範位於核心MQTT客服人員示範儲存庫中。如需詳細資訊，請參閱核心MQTT客服人員頁面 。

device_defender_for_aws

示範和程式庫

AWS IoT Device Defender 程式庫位於AWS GitHub 組織 中的儲存庫中。直接從 AWS IoT Device Defender 儲存庫複製或下載它 （如果使用 git，則為子模組）。 AWS IoT Device Defender 示範位於主要免費RTOS分發 中。如需詳細資訊，請參閱 AWS IoT Device Defender 頁面 。

device_shadow_for_aws

示範和程式庫

AWS IoT 裝置影子程式庫位於AWS GitHub 組織的儲存庫中。直接從 AWS IoT Device Shadow ） 儲存庫複製或下載 （如果使用 git，則為子模組）。 AWS IoT Device Shadow 示範位於主要免費RTOS分發 中。如需詳細資訊，請參閱 AWS IoT Device Shadow 頁面 。

Job_for_aws

示範和程式庫

AWS IoT 任務程式庫位於組織 AWS GitHub 中的儲存庫中。直接從AWS IoT 任務儲存庫複製或下載 （如果使用 git，則為子模組）。 AWS IoT 任務示範位於主要免費RTOS分發 中。如需更多詳細資訊，請參閱 AWS IoT 任務 頁面。

OTA

示範和程式庫

AWS IoT Over-The-Air （OTA） 更新程式庫位於組織 AWS GitHub 中的儲存庫中。直接從AWS IoT OTA儲存庫複製或下載 （如果使用 git，則為子模組）。 AWS IoT OTA 示範位於主要免費RTOS分發 中。如需更多詳細資訊，請參閱 AWS IoT OTA第 頁。

CLI 和 免費 RTOS_Plus_CLI

示範和程式庫

有一個CLI範例在 上執行 WinSim。如需詳細資訊，請參閱 FreeRTOS Plus Command Line Interface 頁面。 i.MX RT1060 NXP 和 STM32U5平台上的精選免費RTOS IoT 參考整合也提供實際硬體CLI的範例。

日誌

巨集

某些免費RTOS程式庫使用的特定硬體平台，有記錄巨集的實作。如需如何實作日誌記錄巨集，請參閱日誌記錄頁面。如需在實際硬體上執行的範例，請參閱其中一個免費RTOS特色 IoT 參考。

greengrass_connectivity

示範

【遷移進行中】 此示範專案假設雲端連線在連線至 AWS IoT Greengrass 裝置之前可用。展示本機身分驗證和探索功能的新專案正在開發中。預計新的示範專案即將發佈於 FreeRTOS Github 組織 中。
已棄用程式庫和示範
名稱 Type 建議

BLE

示範和程式庫

免費RTOSBLE程式庫會實作專屬MQTT通訊協定，並支援透過行動電話等代理裝置透過 Bluetooth Low Energy （BLE） 發佈和訂閱MQTT主題。這不再是強制性的。使用您自己的BLE堆疊或第三方選項，例如 NimBLE，以最佳化您的專案。

dev_mode_key_provisioning

示範

i.MX RT1060、 或 -C3 NXP 平台上的精選免費RTOS IoT 參考整合提供使用 的關鍵佈建範例CLI。 STM32U5 ESP32-C3

posix

抽象和示範

不建議使用。

wifi_provisioning

example

此範例示範如何使用 Amazon-FreeRTOS BLE程式庫在裝置上佈建 WiFi 憑證。如需透過 WiFi 佈建的範例，請參閱 ESP32C3 平台上的免費RTOS精選 IoT 參考BLE。

舊版摘要 APIs

code

這些是為各種第三方軟體堆疊、連線模組和MCU平台提供抽象介面所建立APIs的。例如，有 WiFi 抽象、安全通訊端等介面。Amazon-FreeRTOS 儲存庫支援這些儲存庫，且位於 資料夾 中/libraries/abstractions/。使用免費RTOSLTS程式庫 時APIs不需要這些項目。

上表中的程式庫和示範將不會取得安全修補程式或錯誤修正。

第三方程式庫

當 Amazon-FreeRTOS 中的示範使用第三方程式庫時，建議您直接從第三方儲存庫對它們進行子模組。

  • CMock：直接從 Cmock 儲存庫複製它 （如果您使用 git，則為子模組）。

  • jsmn：不建議，不再支援。

  • lwip：直接從 lwip-tcpip 儲存庫複製它 （如果您使用 git，則為子模組）。

  • lwip_osal：請參閱 i.MX RT1060 上的免費RTOS精選參考整合，或STM32U5了解如何在硬體平台/板上實作 lwip_osal。

  • mbedtls：直接從 Mbed-TLS 儲存庫複製它 （如果您使用 git，則為子模組）。mbedtls 組態和公用程式可以重複使用；在此情況下製作本機複本。

  • pkcs11：直接從核心PKCS11程式庫或 OASIS11 PKCS 個儲存庫複製它 （如果您使用 git，則為子模組）。

  • tinycbor：直接從tinycbor 儲存庫複製它 （如果您使用 git，則為子模組）。

  • 微型加密：如果可用，建議您從 MCU 平台使用加密加速器。如果您想要繼續使用微型加密，請直接從微型加密儲存庫複製它 （如果您使用 git，則複製子模組）。

  • tracealyzer_recorder：直接從 Percepio 的追蹤記錄器儲存庫複製它 （如果您使用 git，則為子模組）。

  • unity：直接從 ThrowTheSwitch/Unity 儲存庫複製它 （如果您使用 git，則為子模組）。

  • win_pcap ：不再維護 win_pcap。我們建議您改用 libslirp、libpcap （posix） 或 npcap。

移植測試和整合測試

用於驗證免費RTOS程式庫整合所需的/tests資料夾下的所有測試都會遷移至 FreeRTOS-Libraries-Integration-Tests儲存庫。這些可用於測試PAL實作和程式庫整合。 AWS IoT 裝置測試儀 （IDT） 會將相同的測試用於 AWS Device Qualification Program for Free RTOS。