亚马逊免费版 RTOS Github 存储库迁移指南 - 免费 RTOS
附录
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

亚马逊免费版 RTOS Github 存储库迁移指南

如果您有一个基于现已弃用的 amazon-freertos 存储库的现有免费RTOS项目，请按照以下步骤操作：

  1. 随时了解最新的公开可用安全修复程序。查看免费RTOSLTS库页面以获取更新，或订阅免费LTS GitHub 存储RTOS库以获取包含关键和安全错误修复的最新LTS补丁。您可以直接从各个 GitHub 存储库下载或克隆所需的最新免费RTOSLTS补丁。

  2. 考虑重构网络传输接口实现以优化您的硬件平台。最新的核心MQTT库不需要APIs诸如安全套接字和 Wifi APIs 之类的摘要。有关更多详细信息，请参阅传输接口。

附录

下表提供了对 Amazon-Fre RTOS e 存储库APIs中所有演示项目、旧版库和摘要的建议。

迁移的库和演示
名称 Type 建议

核心 HTTP

演示和库

直接从 Free G RTOS ithub 组织中的核心HTTP存储库（如果使用 git 则为子模块）克隆或下载核心库。HTTP核心HTTP演示位于主要的免费RTOS发行版中。有关更多详细信息，请参阅核心HTTP页面。

核心 MQTT

演示和库

直接从 Free G RTOS ithub 组织中的核心MQTT存储库（如果使用 git 则为子模块）克隆或下载核心库。MQTT核心MQTT演示位于主要的免费RTOS发行版中。有关更多详细信息，请参阅核心MQTT页面。

核心 MQTT-代理

演示和库

直接从 Free Github 组织中的核心 MQTT-Agent 存储库（如果使用 git 则为子模块）克隆或下载核心 MQTT-A gent 库RTOS。核心 MQTT-Agent 演示位于核心-Agent MQTT-Demos 存储库中。有关更多详细信息，请参阅核心 MQTT-Agent页面。

device_defender_for_aws

演示和库

De Amazon IoT vice Defender 库位于Amazon GitHub 组织中的存储库中。直接从 Amazon IoT Device Defender 存储库中克隆或下载该库（如果使用 git，则为子模块）。De Amazon IoT vice Defender 演示版位于主要免费RTOS发行版中。有关更多详细信息，请参阅 Amazon IoT Device Defender 页面。

device_shadow_for_aws

演示和库

Amazon IoT Device Shadow 库位于Amazon GitHub 组织中的存储库中。直接从 Amazon IoT Device Shadow 存储库中克隆或下载该库（如果使用 git，则为子模块）。De Amazon IoT vice Shadow 演示版位于主要的免费RTOS发行版中。有关更多详细信息，请参阅 Amazon IoT Device Shadow 页面。

jobs_for_aws

演示和库

Amazon IoT 作业库位于Amazon GitHub 组织中的存储库中。直接从 Amazon IoT Jobs 存储库中克隆或下载该库（如果使用 git，则为子模块）。 Amazon IoT Jobs 演示位于主要的免费RTOS发行版中。有关更多详细信息，请参考 Amazon IoT Jobs 页面。

OTA

演示和库

Amazon IoT Over-The-Air (OTA) Update 库位于其Amazon GitHub 组织中的存储库中。直接从Amazon IoT OTA存储库中克隆或下载它（如果使用 git 则为子模块）。 Amazon IoT OTA演示版在主要的免费RTOS发行版中。有关更多详细信息，请参阅Amazon IoT OTA页面。

CLI还有免费 RTOS _Plus_ CLI

演示和库

上面有一个CLI例子 WinSim。有关更多详细信息，请参阅 Free RTOS Plus 命令行界面页面。NXPi.MX RT1 060 STM32U5和平台上的特色免费RTOS物联网参考集成也提供了有关实际硬件的CLI示例。

日志记录

宏

有一些免费RTOS库使用的针对特定硬件平台的日志宏的实现。有关如何实现日志宏的信息，请参阅日志记录页面。有关在实际硬件上运行的示例，请参阅免费RTOS精选 IoT 参考文献。

greengrass_connectivity

演示

[迁移正在进行中] 此演示项目假设在连接到 Amazon IoT Greengrass 设备之前可以进行云连接。一个演示本地身份验证和发现能力的新项目正在开发中。预计新的演示项目将很快在 Free RTOS Github 组织中发布。
已弃用的库和演示
名称 Type 建议

BLE

演示和库

免费RTOSBLE库实现专有MQTT协议，支持通过手机等代理设备通过低功耗蓝牙 (BLE) 发布和订阅MQTT主题。这不再是强制性的。使用您自己的BLE堆栈或第三方选项（例如 Nim）BLE来最好地优化您的项目。

dev_mode_key_provisioning

演示

NXPi.MX RT1 060 或 ESP32-C3 平台上的特色免费RTOS物联网参考集成提供了使用关键配置的示例。STM32U5CLI

posix

抽象和演示

不建议使用。

wifi_provisioning

示例

此示例演示了如何使用 Amazon-Fre RTOS BLE e 库在设备上配置 WiFi 凭证。有关通过进行 WiFi 配置的示例，请参阅ESP32C3平台上的免费RTOS精选 IoT 参考BLE。

遗产摘要 APIs

代码

它们APIs旨在为来自不同供应商的各种第三方软件堆栈、连接模块MCU和平台提供抽象接口。例如，有 WiFi 抽象接口、安全套接字等。它们在 Amazon-Free RTOS 存储库中受支持，并且位于该文件夹中。/libraries/abstractions/使用免费RTOSLTS库时，APIs这些不是必需的。

上表中的库和演示不会获得安全补丁或错误修复。

第三方库

当 Amazon-Free 中的演示RTOS使用第三方库时，我们建议您直接从第三方存储库中对其进行子模块。

  • CMock: 直接从 C moc k 存储库中克隆它（如果你使用 git 则为子模块）。

  • jsmn：不推荐，也不再受支持。

  • lwip：直接从 lwip-tcpip 存储库中克隆（如果使用 git，则为子模块）。

  • lwip_osal：请参阅 i .MX RT1 060 上的免费RTOS精选参考集成，或者STM32U5了解如何在硬件平台/主板上实现 lwip_osal。

  • mbedtl s：直接从 m b ed-存储库中克隆它（如果你使用 git 则为子模块）。TLSmbedtls 配置和实用工具可重复使用；在这种情况下，请创建本地副本。

  • pkcs11：直接从核心PKCS11库或 11 存储库中克隆它（如果你使用 git 则为子模块）。OASIS PKCS

  • tinycbor：直接从 tinycbor 存储库中克隆（如果使用 git，则为子模块）。

  • tinycrypt：我们建议您使用MCU平台上的加密加速器（如果有）。如果您想继续使用 tinycrypt，请直接从 tinycrypt 存储库中克隆（如果使用 git，则为子模块）。

  • tracealyzer_recorder：直接从 Percepio 的 trace recorder 存储库中克隆（如果使用 git，则为子模块）。

  • unity：直接从 ThrowTheSwitch/Unit y 存储库中克隆它（如果你使用 git 则为子模块）。

  • win_pcap：win_pcap 已停止维护。我们建议您使用 libslirp、libpcap (posix) 或 npcap。

移植测试和集成测试

该/tests文件夹下验证免费RTOS库集成所需的所有测试都已迁移到 FreeRTOS-Libraries-Integration-Tests存储库中。它们可用于测试PAL实现和库集成。Device Te Amazon IoT ster (IDT) 免费为Amazon 设备认证计划使用相同的测试RTOS。