软件包介绍

ali-iotkit 是 RT-Thread 移植的用于连接阿里云 IoT 平台的软件包。基础 SDK 是阿里提供的 iotkit-embedded C-SDK。

物联网套件提供了如下的能力:

  • 嵌入式设备快速接入(设备端SDK)
  • 设备管理
  • 设备和数据信息安全
  • 桥接到阿里云其他产品, 对设备数据存储/计算
    阿里云物联网平台场景架构图

在物联网平台场景架构图中，左边物联网设备端 SDK 就是将嵌入式设备连接到阿里云的部分。

软件框架图

iotkit SDK 为了方便设备上云封装了丰富的连接协议，如 MQTT、CoAP、HTTP、TLS，并且对硬件平台进行了抽象，使其不受具体的硬件平台限制而更加灵活。在代码架构方面，iotkit SDK 分为三层，如下图所示：

iotkit SDK 软件框架图

  • 最底层称为硬件平台抽象层, 也简称HAL层（Hardware Abstract Layer）

抽象不同的嵌入式目标板上，操作系统对SDK的支撑函数，包括网络收发、 TLS/DTLS 通道建立和读写, 内存申请是否和互斥量加锁解锁等。

  • 中间层称为SDK内核实现层（IoT SDK Core Implements）

物联网平台 C-SDK 的核心实现部分, 它基于 HAL 层接口完成了 MQTT/CoAP 通道等的功能封装， 包括 MQTT 的连接建立、 报文收发、CoAP 的连接建立、报文收发、 OTA 的固件状态查询和 OTA 的固件下载等。

中间层的封装，使得用户无需关心内部实现逻辑，可以不经修改地应用。

  • 最上层称为SDK接口声明层（IoT SDK Interface Layer）

最上层是为应用提供 API 的，用户使用该层的 API 完成具体的业务逻辑。

软件包目录结构

ports 目录是 RT-Thread 移植 iotkit-embedded 软件包时所涉及到的移植文件，使用 scons 进行重新构建。

iotkit-embedded 软件包是阿里物联网平台 C-SDK 源码，包含连接阿里云所必须的软件包。

  1. ali-iotkit
  2. |   README.md                       // 软件包使用说明
  3. |   SConscript                      // RT-Thread 默认的构建脚本
  4. +---docs
  5. |   +---figures                     // 文档使用图片
  6. |   |   api.md                      // API 使用说明
  7. |   |   introduction.md             // 软件包详细介绍
  8. |   |   LICENSE                     // 许可证文件
  9. |   |   principle.md                // 实现原理
  10. |   |   README.md                   // 文档结构说明
  11. |   |   samples.md                  // 软件包示例
  12. |   |   user-guide.md               // 使用说明
  13. |   +---version.md                  // 版本说明
  14. +---ports                           // 移植文件
  15. |   +---rtthread                    // OS 相关移植文件
  16. |   +---ssl                         // MbedTLS 相关的移植文件
  17. +---samples
  18. |   +---mqtt                        // MQTT 通道接入阿里云的示例程序
  19. |   +---ota                         // 阿里云 OTA 功能演示例程
  20. +---iotkit-embedded                 // iotkit 源码

iotkit-embedded 软件包目录结构

iotkit-embedded 软件包是阿里物联网平台 C-SDK 源码，未经修改，包含里了连接阿里云 IoT 所必须的软件包。 RT-Thread 移植后，没有使用 iotkit-embedded 中默认的 Makefile 构建脚本，而是使用 scons 重新进行的构建。

iotkit-embedded 软件包目录结构如下所示：

  1. +-- LICENSE           : 软件许可证, Apache-2.0 版本软件许可证
  2. +-- make.settings     : 功能裁剪配置, 如 MQTT|CoAP, 或裁剪如 OTA|Shadow
  3. +-- README.md         : 快速开始导引
  4. +-- sample            : 例程目录, 演示通信模块和服务模块的使用
  5. |   +-- mqtt          :     演示如何使用通信模块 MQTT 的 API
  6. |   +-- coap          :     演示如何使用通信模块 CoAP 的 API
  7. |   +-- device-shadow :     演示如何使用服务模块 DeviceShadow 的 API
  8. |   +-- http          :     演示如何使用通信模块 HTTP 的 API
  9. |   +-- ota           :     演示如何使用服务模块 OTA 的 API
  10. +-- src
  11.     +-- sdk-impl      : SDK 的接口层, 提供总体的头文件, 和一些 API 的接口封装
  12.     +-- sdk-tests     : SDK 的单元测试
  13.     +-- mqtt          : 通信模块, 实现以 MQTT 协议接入
  14.     +-- coap          : 通信模块, 实现以 CoAP 协议接入
  15.     +-- http          : 通信模块, 实现以 HTTP 协议接入
  16.     +-- ota           : 服务模块, 实现基于 MQTT|CoAP+HTTP+TLS 的固件下载通道
  17.     +-- shadow        : 服务模块, 实现设备影子
  18.     +-- platform      : 硬件平台抽象层, 需要移植适配
  19.     +-- import        : 外部输入目录, 存放芯片/模组厂商提供的头文件/二进制库
  20.     +-- configs       : 硬件平台编译配置, 如交叉编译工具链设置, 功能模块裁剪等
  21.     +-- scripts       : 编译过程将要外部引用的脚本, 用户不必关注
  22.     +-- packages      : SDK 引用的外部软件模块, 用户不必关注
  23.     +-- log           : 基础模块, 实现运行日志
  24.     +-- system        : 基础模块, 保存全局信息, 如 TLS 根证书, 设备标识 ID 等
  25.     +-- tls           : 基础模块, 实现 TLS/DTLS, 来自裁剪过的开源软件 mbedtls
  26.     +-- utils         : 基础模块, 实现工具函数, 如 SHA1 摘要计算、NTP 对时等

功能特点

  • 不同网络接入

提供不同网络的设备接入方案，例如 2/3/4G、NB-IoT、LoRa 等，解决企业异构网络设备接入管理的痛点。

  • 不同协议接入

提供多种协议的设备 SDK，例如 MQTT、CoAP、HTTP 等，这样既能满足设备需要长连接保证实时性的需求，也能满足设备需要短连接降低功耗的需求。

  • 双向通信

提供设备与云端的上下行通道，能够稳定可靠的支撑设备上报与指令下发设备的场景。

  • 设备影子

提供设备影子缓存机制，将设备与应用解耦，解决在无线网络不稳定情况下的通信不可靠痛点。

  • 设备认证

提供一机一密的设备认证机制，降低设备被攻破的安全风险。

  • 安全传输

提供 TLS 标准的数据传输通道，保证数据的机密性和完整性。

原文: https://www.rt-thread.org/document/site/submodules/ali-iotkit/docs/introduction/