前言

8.1.1 物联网平台搭建

8.2.1 LinkDevelop平台使用

8.2.2 iotkit-embedded

前言

传统的物联网项目，需要嵌入式硬件、云平台。对于我们做嵌入式的来说，从零开始搭建一个物联网云平台几乎是不现实的。

这里涉及到许多前后端的知识。

通过阿里云物联网平台，我们可以在不懂前后端开发的基础上，半个小时候左右就可以搭建一个智慧农业的物联网云平台框架。

效果如下：

大数据面板：

设备管理：

设备地图分布：

支持视频监控：

多个组件图标功能：

8.1.1 物联网平台搭建

物联网平台搭建的话，我放在了bilibili这里：

8.2.1 LinkDevelop平台使用

1.注册

打开LinkDevelop官网：https://iot.aliyun.com/products/linkdevelop。单击“立即使用”按钮，如图8.3所示。

图8.3 LinkDevelop官网

2.新建项目

单击左侧的“项目管理”按钮，随后再单击“新建项目”按钮，进入新建项目界面，如图8.4所示。

图8.4 项目管理界面

随后在弹出来的新建项目界面上，单击“新建空白项目”按钮，如图8.5所示。

图8.5 新建项目界面

弹出新建空白项目界面后，在“项目名称”中输入test，在“描述”中输入这是一个测试项目，单击“确认”按钮，如图8.6所示。

图8.6 新建空白项目界面

3.创建产品

单击左侧的“产品”按钮，在弹出的界面中，单击“创建产品”按钮，如图8.7所示。

图8.7 产品界面

在“产品名称”中输入“sensor”，如图8.8所示。

图8.8 创建产品

单击“请选择标准品类”下拉框，弹出“选择品类”选择框，阿里云物联网平台预置了许多产品类型，读者可以根据自己的需求选择对应，本书选择“地磁检测器”，如图8.9所示。

图8.9 选择产品种类

其他选项按默认值即可，单击“保存”按钮，如图8.10所示。

图8.10 创建产品

4.创建设备

页面左上角有个三角形下拉框，可以选择项目，选择我们刚才创建的test项目，再单击“设备”按钮，最后单击“新增设备”按钮，如图8.11所示。

图8.11 设备界面

在“产品”选择下拉框中，选择我们刚才创建的产品sensor，单击“提交”按钮，如图8.12所示。

图8.12 新增设备

在弹出的新界面中，单击“下载激活凭证”按钮，下载sheet.xlsx文件，如图8.13所示。保存sheet.xlsx文件，里面的内容后续会用到

。

图8.13 下载激活凭证

8.2.2 iotkit-embedded

iotkit-embedded是阿里云物联网平台提供的一套C语言编写的SDK包。通过该SDK包，我们可以使我们的嵌入式设备接入到阿里云物联网平台。

SDK使用MQTT/HTTP连接物联网平台，因此要求设备支持TCP/IP协议栈；对于Zigbee、ZWave之类的不支持TCP/IP协议栈的设备，需要通过网关接入物联网平台，这种情况下网关需要集成SDK。

iotkit-embedded下载地址：https://github.com/aliyun/iotkit-embedded 。

SDK提供了API供设备厂商调用，用于实现与阿里云IoT平台通信以及一些其他的辅助功能，例如WiFi配网、本地控制等。

另外，C语言版本的SDK被设计为可以在不同的操作系统上运行，例如Linux、FreeRTOS、Windows，因此SDK需要OS或者硬件支持的操作被定义为一些HAL函数，在使用SDK开发产品时需要将这些HAL函数进行实现。

产品的业务逻辑、SDK、HAL的关系如图8.15所示。

图8.15 SDK 框架

表8.1列出了SDK包的相关功能：

8.2.3 ali-iotkit

1.简介

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

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

图8.16 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 完成具体的业务逻辑。

2.配置

RT-Thread已经为我们集成了ali-iotkit软件，通过简单的menuconfig配置即可使用。配置项位于：RT-Thread online packages→ IoT – internet of things→ IoT Cloud，如图8.17所示。

图8.17 Ali-iotkit配置项

按空格键选中“Ali-iotkit”后，再按回车键进入详细配置项。

（1）version选择v2.0.3。

（2）Config Product Key (NEW)填写我们之前下载的激活凭证sheet.xlsx文件中的Productkey项的内容。

（3）Config Device Name (NEW)填写sheet.xlsx文件中的DeviceName项的内容。

（4）Config Device Secret (NEW)填写sheet.xlsx文件中的DeviceName项的内容。

其他配置项如图8.18所示。

图8.18 Ali-iotkit详细配置

阿里 TLS 认证过程中数据包较大，这里需要增加 TLS 帧大小，OTA 的时候至少需要 8K 大小，修改menuconfig配置项：RT-Thread online packages→security packages →mbedtls: An portable and flexible SSL/TLS library，把Maxium fragment length in bytes的数值改成8192，如图8.19所示。

图8.19 mbedtls配置

退出menuconfig，输入pkgs –update更新下载ali-iotkit软件包，下载软件包后，输入scons –target=mdk5重新生成工程文件。

需要注意的是，ali-iotkit自带mqtt相关功能，如果之前代码配置选择了Paho MQTT，需要把Paho MQTT软件包去掉，否则编译报错。

软件包位于Chapter8rt-threadbspstm32stm32f407-atk-explorerpackagesali-iotkit-v2.0.3软件包目录如图8.20所示。

图8.20 ali-iotkit软件包目录

其中各文件说明如下：

docs：软件包说明文档。

iotkit-embedded：阿里云物联网平台提供的SDK包。

ports：RT-Thread相关移植文件。

samples：RT-Thread提供的一个简单测试程序。

8.2.4 实验

1.上传消息到云端

（1）打开Chapter8rt-threadbspstm32stm32f407-atk-explorer project.uvprojx工程文件，其中SDK包相关的代码文件包含在ali-iotkit文件夹下，如图8.21所示。

图8.21 项目工程

（2）编译并下载程序到开发板，先确保开发板能ping通阿里云服务器。输入ping iot.aliyun.com并发送回车，有看到如下打印信息则代表网络正常。

msh />ping iot.aliyun.com

60 bytes from 42.120.219.14 icmp_seq=0 ttl=230 time=42 ms

60 bytes from 42.120.219.14 icmp_seq=1 ttl=230 time=41 ms

60 bytes from 42.120.219.14 icmp_seq=2 ttl=230 time=41 ms

60 bytes from 42.120.219.14 icmp_seq=3 ttl=230 time=41 ms

（3）打开LinkDevelop的设备管理界面，可以看到之前创建的设备的状态是“未激活”，如图8.22所示。

图8.22 设备列表

（4）打开串口工具，发送ali_mqtt_test start命令给开发板，可以看到开发板有如下打印信息：

msh />ali_mqtt_test start

[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!

[dbg] guider_print_dev_guider_info(271): ....................................................

[dbg] guider_print_dev_guider_info(272):           ProductKey : a1wUxrR2Xd4

[dbg] guider_print_dev_guider_info(273):           DeviceName : 3mX9eDe8wt0FDt2hIRxf

[dbg] guider_print_dev_guider_info(274):             DeviceID : a1wUxrR2Xd4.3mX9eDe8wt0FDt2hIRxf

host: a1wuxrr2xd4.iot-as-mqtt.cn-shanghai.aliyuncs.com

[inf] iotx_mc_init(1703): MQTT init success!

[inf] _ssl_client_init(175): Loading the CA root certificate ...

 [inf] iotx_mc_connect(2035): mqtt connect success!

[dbg] iotx_mc_report_mid(2259): MID Report: started in MQTT

[dbg] iotx_mc_report_mid(2276): MID Report: json data = '{"id":"a1wUxrR2Xd4_3mX9eDe8wt0FDt2hIRxf_mid","params":{"_sys_device_mid":"example.demo.module-id","_sys_device_pid":"example.demo.partner-id"}}'

（5）有看到[inf] iotx_mc_connect(2035): mqtt connect success!则表示成功连接上LinkDevelop。重新查看LinkDevelop的设备管理界面，可以看到之前创建的设备的状态是“在线”，说明设备和LinkDevelop通信正常，如图8.23所示。

图8.23 设备列表

（6）输入ali_mqtt_test pub open并发送回车，开发板将会推送数据到云端，串口打印信息显示code值为200，则表示推送数据成功。

_demo_message_arrive|203 :: Payload: ‘{“code”:200,”data”:{“LightSwitch”:”tsl parse: params not exist”,”RGBColor”:”tsl parse: params not exist”},”id”:”1″,”