本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
FreeRTOS 库
FreeRTOS 库为 FreeRTOS 内核及其内部库提供其他功能。通过使用 FreeRTOS 库,您可以在嵌入式应用程序中实现联网和安全。FreeRTOS 库还允许您的应用程序与 Amazon IoT 服务进行交互。利用 FreeRTOS 所包含的库,可以:
-
使用 MQTT 和 Device Shadow 安全地将设备连接到 Amazon IoT 云。
-
发现并连接到 Amazon IoT Greengrass 核心。
-
管理 Wi-Fi 连接。
-
侦听和处理 FreeRTOS 空中下载更新。
libraries
目录包含 FreeRTOS 库的源代码。协助实施库功能的帮助程序函数。建议您不要更改这些帮助程序函数。
FreeRTOS 移植库
以下移植库包含在可从 FreeRTOS 控制台下载的 FreeRTOS 的配置中。这些库与平台相关。其内容因硬件平台而异。有关将这些库移植到设备的信息,请参阅《FreeRTOS 移植指南》。
FreeRTOS 移植库 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
库 | API 引用 | 描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
低功耗蓝牙 | 低功耗蓝牙 API 参考 | 利用 FreeRTOS 低功耗蓝牙库,您的微控制器可通过网关设备与 Amazon IoT MQTT 代理进行通信。有关更多信息,请参阅低功耗蓝牙库。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
无线更新 | Amazon IoT 空中下载更新 API 参考 |
FreeRTOS Amazon IoT 空中下载 (OTA) 更新库允许您在 FreeRTOS 设备上管理更新通知、下载更新以及对固件更新进行加密验证。 有关更多信息,请参阅Amazon IoT 空中下载 (OTA) 库。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FreeRTOS+POSIX | FreeRTOS+POSIX API 参考 |
您可以使用 FreeRTOS+POSIX 库将与 POSIX 兼容的应用程序移植到 FreeRTOS 生态系统。 有关更多信息,请参阅 FreeRTOS+POSIX |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
安全套接字 | 安全套接字 API 参考 | 有关更多信息,请参阅安全套接字库。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FreeRTOS+TCP | FreeRTOS+TCP API 参考 |
FreeRTOS+TCP 是一个适用于 FreeRTOS 的可扩展的、线程安全的开源 TCP/IP 堆栈。 有关更多信息,请参阅 FreeRTOS+TCP |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Wi-Fi | Wi-Fi API 参考 |
利用 FreeRTOS Wi-Fi 库,您可以与微控制器的低级别无线堆栈进行交互。 有关更多信息,请参阅 Wi-Fi 库。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
corePKCS11 |
corePKCS11 库是公有密钥加密标准 #11 的参考实施,可支持预配置和 TLS 客户端身份验证。 有关更多信息,请参阅 corePKCS11 库。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TLS |
有关更多信息,请参阅传输层安全。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
通用 I/O | 通用 I/O API 参考 |
有关更多信息,请参阅通用 I/O。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
蜂窝接口 | 蜂窝接口 API 参考 |
蜂窝接口库通过统一的 API 公开了一些流行的蜂窝调制解调器的功能。有关更多信息,请参阅 蜂窝接口库。 |
FreeRTOS 应用程序库
您可以选择在 FreeRTOS 配置中包含以下独立应用程序库,以便与云中的 Amazon IoT 服务进行交互。
注意
某些应用程序库与适用于嵌入式 C 的 Amazon IoT 设备开发工具包中的库具有相同 API。对于这些库,请参阅 Amazon IoT 设备开发工具包 C API 参考。有关适用于嵌入式 C 的 Amazon IoT 设备开发工具包的更多信息,请参阅Amazon IoT Device SDK for Embedded C。
FreeRTOS 应用程序库 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
库 | API 引用 | 描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon IoT Device Defender | Device Defender C 开发工具包 API 参考 |
FreeRTOS Amazon IoT Device Defender 库可将您的 FreeRTOS 设备连接到 Amazon IoT Device Defender。 有关更多信息,请参阅Amazon IoT Device Defender 库。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon IoT Greengrass | Greengrass API 参考 |
FreeRTOS Amazon IoT Greengrass 库可将您的 FreeRTOS 设备连接到 Amazon IoT Greengrass。 有关更多信息,请参阅Amazon IoT Greengrass Discovery 库。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MQTT |
coreMQTT 库为 FreeRTOS 设备提供了用于发布和订阅 MQTT 主题的客户端。MQTT 是设备用来与 Amazon IoT 进行交互的协议。 有关 coreMQTT 库版本 3.0.0 的更多信息,请参阅 coreMQTT 库。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
coreMQTT 代理 |
coreMQTT 代理库是一个高级 API,它可以增加 coreMQTT 库的线程安全性。它允许您创建专用 MQTT 代理任务,该任务在后台管理 MQTT 连接,不需要其他任务的任何干预。该库可以提供与 coreMQTT 的 API 等效的线程安全性,因此可以在多线程环境中使用。 有关 coreMQTT 库的更多信息,请参阅 coreMQTT 代理库。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon IoT Device Shadow | 设备影子 C 开发工具包 API 参考 |
利用 Amazon IoT Device Shadow 库,您的 FreeRTOS 设备可以与 Amazon IoT 设备影子进行交互。 有关更多信息,请参阅Amazon IoT Device Shadow 库。 |
配置 FreeRTOS 存储库
FreeRTOS 和适用于嵌入式 C 的 Amazon IoT 设备开发工具包的配置设置定义为 C 预处理程序常量。您可以使用全局配置文件设置配置设置,或者使用 gcc
中的 -D
等编译器选项。由于配置设置被定义为编译时常量,因此在更改配置设置时,必须重新构建库。
如果您希望使用全局配置文件来设置配置选项,请创建并保存名为 iot_config.h
的文件,然后将其放在包含路径中。在文件中,使用 #define
指令可配置 FreeRTOS 库、演示和测试。
有关受支持的全局配置选项的更多信息,请参阅全局配置文件参考。