前言
8.1.1 物联网平台搭建
8.2.1 LinkDevelop平台使用
8.2.2 iotkit-embedded
前言
传统的物联网项目，需要嵌入式硬件、云平台。对于我们做嵌入式的来说，从零开始搭建一个物联网云平台几乎是不现实的。
这里涉及到许多前后端的知识。
通过阿里云物联网平台，我们可以在不懂前后端开发的基础上，半个小时候左右就可以搭建一个智慧农业的物联网云平台框架。
效果如下：
大数据面板：
设备管理：
设备地图分布：
支持视频监控：
多个组件图标功能：
8.1.1 物联网平台搭建
物联网平台搭建的话，我放在了bilibili这里：
/video/bv1DK4y1s7Pc
8.2.1 LinkDevelop平台使用
1.注册
打开LinkDevelop官网：/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下载地址：/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软件包去掉，否则编译报错。
软件包位于Chapter8\rt-thread\bsp\stm32\stm32f407-atk-explorer\packages\ali-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）打开Chapter8\rt-thread\bsp\stm32\stm32f407-atk-explorer\project.uvprojx工程文件，其中SDK包相关的代码文件包含在ali-iotkit文件夹下，如图8.21所示。
图8.21 项目工程
（2）编译并下载程序到开发板，先确保开发板能ping通阿里云服务器。输入ping 并发送回车，有看到如下打印信息则代表网络正常。
msh />ping 60 bytes from 42.120.219.14 icmp_seq=0 ttl=230 time=42 ms60 bytes from 42.120.219.14 icmp_seq=1 ttl=230 time=41 ms60 bytes from 42.120.219.14 icmp_seq=2 ttl=230 time=41 ms60 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.3mX9eDe8wt0FDt2hIRxfhost: a1wuxrr2xd4.iot-as--[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","\0
（7）在设备列表中单击“查看”按钮，如图8.24所示：
图8.24设备列表
（8）在弹出来的设备详情页中，单击“日志服务”按钮，再单击“上行消息分析”按钮，可以看到开发板总共发送了2条消息，其中时间较早的消息是开发板登录时发送的，最新的信息是刚才的ali_mqtt_test pub open命令所发送得到消息。
图8.25 设备详情
（9）单击对应消息的MessageID，可以查看消息的具体内容，如图8.26所示。
图8.26 消息内容
2.云端发布消息
（1）单击左上角的小三角形，选择 test，然后单击“产品”按钮，单击“sensor”对应的“查看”按钮，如图8.27所示。
图8.27 产品列表
（3）单击“功能定义”按钮，随后单击“自定义功能”按钮，最后单击“添加自定义功能”按钮，如图8.28所示。
图8.28 功能定义
（4）功能名称选择“测试001”，其他选型默认即可，单击“确认”，如图8.29所示。
图8.29 自定义功能
（5）单击右上角的“发布”按钮，发布新功能，如图8.30所示。
图8.30 发布功能
（6）再弹出来的界面中，把所有的“请确认”按钮后面的
都选上，单击“发布”按钮，如图8.31所示。
图8.31 确认发布
（7）回到刚才的设备详情页，单击“在线调试”按钮，单击“调试真实设备” 按钮，单击“属性调试”按钮，调试功能选择“测试001(Test001)”，方法选择“设置”，如图8.32所示。
图8.32 在线调试
修改调试信息的内容为{ "Test001": "1"}，如图8.33所示，单击“发送指令”按钮。
图8.33 发送指令
（8）可以看到开发板有如下打印信息：
'/sys/a1NegcqX690/AwpDLCcqeb7TSbNevNAr/thing/service/property/set' (Length: 64)_demo_message_arrive|203 :: Payload: '{"method":"thing.service.property.set","id":"1302514310","params":{"Test001":"1"},"version":"1.0.0"}' (Length: 100)_demo_message_arrive|207 :: ----
可以看到接收到LinkDevelop发送的{"Test001": "1"}消息，通信成功。
