中文页 | English
说明：
Ali IoTKit 软件包已经同步更新到 c-sdk-v3.0.1-269691d1b45b15fb9045a8eb178efa54b262aca1c-sdk.git 版本。本软件包中的文档教程未能及时更新，深表歉意，最新文档请移步阿里 官方 Wikis 和阿里 官方文档。
ali-iotkit 是 RT-Thread 移植的用于连接阿里云 IoT 平台的软件包。基础 SDK 是阿里提供的 iotkit-embedded C-SDK。
ali-iotkit 为了方便设备上云封装了丰富的连接协议，如 MQTT、CoAP、HTTP、TLS，并且对硬件平台进行了抽象，使其不受具体的硬件平台限制而更加灵活。
相对传统的云端接入 SDK，ali-iotkit 具有如下优势：
- 快速接入能力
- 嵌入式设备调优
- 多编译器支持（Gcc、IAR、MDK）
- 多连接协议支持（HTTP、MQTT、CoAP）
- 跨硬件、跨 OS 平台支持
- 设备固件 OTA 升级
- TLS/DTLS 安全连接
- 高可移植的应用端程序
- 高可复用的功能组件
| 名称 | 说明 |
|---|---|
| docs | 文档目录 |
| iotkit-embedded | 阿里 iotkit 原文件目录 |
| ports | 移植文件目录 |
| samples | 示例文件目录 |
在统计 iotkit 软件包的资源占用的时候，使用的是 MQTT + TLS 例程，仅统计了软件包本身占用的 RAM 和 ROM 大小，未统计 LibC 及外部依赖的文件所占用的资源大小（如 TLS），以及未统计 sample 例程本身占用的资源大小。
- 测试平台： iMXRT1052
- 测试 IDE： MDK5
- 优化级别： o2
资源占用如下所示：
RO(CODE + RO) : 32886 bytes（32.11K）
RW(RW + ZI) : 2421 bytes（ 2.36K）
ROM(CODE + RO + RW) : 32962 bytes（32.18K）
测试运行 mqtt+tls 例程动态内存使用: 47502 bytes（45.94K）
ali-iotkit 软件包延用阿里 iotkit-embedded 软件包许可协议，请见 iotkit-embedded/LICENSE 文件。
- 使用
menuconfig使能 iotkit 软件包并填写设备信息
RT-Thread online packages --->
IoT - internet of things --->
IoT Cloud --->
[*] Ali-iotkit: Ali Cloud SDK for IoT platform --->
Select Aliyun platform (LinkDevelop Platform) --->
(a1dSQSGZ77X) Config Product Key
(RGB-LED-DEV-1) Config Device Name
(Ghuiyd9nmGowdZzjPqFtxhm3WUHEbIlI) Config Device Secret
-*- Enable MQTT
[*] Enable MQTT sample
[*] Enable MQTT direct connect
[*] Enable SSL
[ ] Enable COAP
[*] Enable OTA
Select OTA channel (Use MQTT OTA channel) --->
version (latest) --->- 增加
mbedTLS帧大小（OTA 的时候至少需要 8K 大小）
RT-Thread online packages --->
security packages --->
-*- mbedtls:An open source, portable, easy to use, readable and flexible SSL library --->
(8192) Maxium fragment length in bytes- 使用
pkgs --update命令下载软件包
在 MSH 中使用命令执行预置的示例程序
- MQTT Sample 单次发布订阅
该示例程序演示了如何使用 MQTT 发布、订阅 Topic，MSH 命令如下所示：
msh />ali_mqtt_test
ali_mqtt_test|502 :: iotkit-embedded sdk version: V2.10
[inf] iotx_device_info_init(40): device_info created successfully!
[dbg] iotx_device_info_set(50): start to set device info!
[dbg] iotx_device_info_set(64): device_info set successfully!
...
mqtt_client|324 :: out of sample!- MQTT Sample 监听订阅消息
该示例程序演示了如何使用 MQTT 发布、订阅 Topic，并一直监听订阅 Topic 的消息，MSH 命令如下所示：
msh />ali_mqtt_test loop
ali_mqtt_test|502 :: iotkit-embedded sdk version: V2.10
[dbg] iotx_device_info_init(32): device_info already created, return!
[dbg] iotx_device_info_set(50): start to set device info!
[dbg] iotx_device_info_set(64): device_info set successfully!
...
[dbg] iotx_mc_cycle(1269): SUBACK
event_handle|111 :: subscribe success, packet-id=0
[dbg] iotx_mc_cycle(1269): SUBACK
event_handle|111 :: subscribe success, packet-id=0- OTA Sample
该示例程序演示了如何使用阿里云 OTA 服务，使用 ali_ota_test 命令启动例程，这个时候，设备首先会上报当前版本号到阿里云，然后等待云端下发 OTA 升级命令。
msh />ali_ota_test
ali_ota_main|325 :: iotkit-embedded sdk version: V2.10
[dbg] iotx_device_info_init(32): device_info already created, return!
[dbg] iotx_device_info_set(50): start to set device info!
[dbg] iotx_device_info_set(64): device_info set successfully!
...
mqtt_client|232 :: wait ota upgrade command....
[dbg] iotx_mc_cycle(1260): PUBACK
event_handle|117 :: publish success, packet-id=2
[dbg] iotx_mc_cycle(1269): SUBACK
event_handle|093 :: subscribe success, packet-id=1
mqtt_client|232 :: wait ota upgrade command....
mqtt_client|232 :: wait ota upgrade command....
mqtt_client|232 :: wait ota upgrade command....- 使用前请在
menuconfig里配置自己的设备信息（PRODUCT_KEY、DEVICE_NAME 和 DEVICE_SECRET） - 开启 OTA 功能必须使能加密连接（因为 OTA 升级必须使用 HTTPS 下载固件）
- MbedTLS 返回 0x7200 错误
通常是由于 MbedTLS 帧长度过小，请增加 MbedTLS 帧长度，参考第二章节。
- 维护： Murphy
- 主页： https://github.com/RT-Thread-packages/ali-iotkit