OneNET分享完结篇 | 让你的设备连接上OneNET平台_onenet ota例程

大家好，我是程序员小哈。

今天把OneNET相关内容的分享做一个收尾，这一个系列的分享，正好也是对应之前的一个网友问答：STM32→ESP8266→OneNET ，对应整个技术路线涉及知识点的概括，希望我的分享，可以带给你些许帮助。

实现目标

要想实现最终目标，我们需要解决如下几个问题：

• 一个支持MQTT协议的工程
• STM32与ESP8266之间一般选择串口通信，所以要实现ESP8266串口数据的收发
• 传感器数据的上传，串口数据的方向为 STM32–>ESP8266 ，对应ESP8266串口数据的接收
• 手机或其他终端对设备属性的设置，串口数据的方向为 ESP8266–>STM32 ，对应ESP8266串口数据的发送
• 示例工程中，ESP8266的UART0还会输出一些调试信息，为了解析消息方便，将打印输出的调试信息重定向至UART1
• ESP8266对接收到的数据，上报至服务器
• ESP8266接收到的云端数据，解析后，通过串口发送出去

准备工作

ESP8266 NONOS SDK 代码中，在example文件夹下有很多的Demo，
因为我们之前使用 MQTT.fx 软件，成功连接上了OneNET平台，使用的就是MQTT协议，所以我们选择一个基于MQTT协议的例程为基础，即选用esp_mqtt_proj 例程进行移植，在其基础上对代码进行修改。

我们只需要测试MQTT相关的例程，所以将esp_mqtt_proj 例程从 examples 文件夹下拷贝到 ESP8266_NONOS_SDK-3.0.4 根目录下面，同时删除 examples 、 driver_lib 、third_party 文件夹。删除之后，工程结构如下图所示：

修改esp_mqtt_proj 例程中的配置文件：\ESP8266_NONOS_SDK-3.0.4\esp_mqtt_proj\include\mqtt_config.h 。

上面代码中：

MQTT_HOST：MQTT服务器地址，类型为一个字符串，可以为IP地址或者一个MQTT服务器的域名，根据之前网文分享，此域名我们使用：studio-mqtt.heclouds.com

MQTT_PORT：MQTT服务器端口，一般为1883

MQTT_CLIENT_ID：设备名称，类型为一个字符串，此实例为：XiaoHaLED

MQTT_USER：产品ID，类型为一个字符串，此实例为：hg8zt6E3LP

MQTT_PASS：鉴权信息，类型为一个字符串，计算方法参见文末参考阅读四，此实例为：
version=2018-10-31&res=products%2Fhg8zt6E3LP%2Fdevices%2FXiaoHaLED&et=1640594308&method=md5&sign=yBG2008b6SMfxiW6q6KmnA%3D%3D

STA_SSID：WI-FI热点名称，即让模块登录的SSID

注意：要连接2.4G的无线网络，否则无法连接网络！！！

STA_PASS：WI-FI密码，即登录的SSID对应的密码

上面这些信息在我们之前分享的网文：

与OneNET服务器连接初体验 里都可以查到对应信息。

将上面信息填写至 esp_mqtt_proj 工程中对应位置如下：

注意：
根据注释，①位置的 CFG_HOLDER 变量每次修改之后要改变一下，+1或-1都可以，否则将不会修改系统配置，即只有在【持有人标识和之前不同】的情况下，才会更新系统参数（修改系统参数时，一定要记得修改持有人标识的值）。

根据 CFG_HOLDER 持有人标识，如果更新，则将 WiFi SSID、WiFi 密码、MQTT域名、端口号、MQTT用户名和密码等参数写入到 sysCfg 结构体变量中，并将结构体内容写入到 Flash。

根据注释，①位置的 CFG_HOLDER 变量每次修改之后要改变一下，+1或-1都可以，否则将不会修改系统配置，如果 CFG_HOLDER 变量值发生变化，那么新固件会将 WiFi SSID、WiFi 密码、MQTT域名、端口号、MQTT用户名和密码等参数写入到 sysCfg 结构体变量中，并将结构体内容写入到 Flash。

因为②中的 MQTT_PASS 内容较长，所以需要手动修改一下对应数组的长度：

上图③位置，使用协议版本，要跟我们之前使用MQTT.fx软件设置的版本一致。

因为OneNET平台不支持遗嘱消息(Will Message)，所以需要注释掉下面语句：

上面函数的作用是设置遗嘱参数，如果云端没有对应的遗嘱主题，则MQTT连接会被拒绝。

固件下载

编译固件，编译后的固件使用 ESP8266 DOWNLOAD TOOL 软件更新固件：

注意：烧录固件之前，最好执行一下ERASE操作。

固件下载完毕，重启模块，串口输出如下：

查看OneNET后台，可以看到设备成功上线了：

订阅属性

我们要实现对设备的远程控制，那么就要让设备订阅一个属性设置的主题，即 $sys/{pid}/{device-name}/thing/property/set

其中， {pid} 由产品ID替换，我们创建的产品ID为：hg8zt6E3LP。
{device-name} 设备名称为：XiaoHaLED 。

所以此实例属性设置的主题具体为：$sys/hg8zt6E3LP/XiaoHaLED/thing/property/set

连接上MQTT服务器的回调函数为 mqttConnectedCb ,我们在此函数中订阅上述消息：

具体实现代码为：

void mqttConnectedCb(uint32_t *args)
{
    MQTT_Client* client = (MQTT_Client*)args;
    INFO("MQTT: Connected\r\n");

    MQTT_Subscribe(client, "$sys/hg8zt6E3LP/XiaoHaLED/thing/property/set", 0);

    /*MQTT_Subscribe(client, "/mqtt/topic/0", 0);
    MQTT_Subscribe(client, "/mqtt/topic/1", 1);
    MQTT_Subscribe(client, "/mqtt/topic/2", 2);

    MQTT_Publish(client, "/mqtt/topic/0", "hello0", 6, 0, 0);
    MQTT_Publish(client, "/mqtt/topic/1", "hello1", 6, 1, 0);
    MQTT_Publish(client, "/mqtt/topic/2", "hello2", 6, 2, 0);*/
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

我们在控制台中的 运维监控–>设备调试–>应用模拟器 中改变目标设备XiaoHaLED【LED】 的开关状态，模块的串口打印输出如下：

上面的打印信息是在接收消息的函数中打印输出的，具体函数为：

//TODO：接收的消息
void mqttDataCb(uint32_t *args, const char* topic, uint32_t topic_len, const char *data, uint32_t data_len)
{
    char *topicBuf = (char*)os_zalloc(topic_len+1),
            *dataBuf = (char*)os_zalloc(data_len+1);

    MQTT_Client* client = (MQTT_Client*)args;

    os_memcpy(topicBuf, topic, topic_len);
    topicBuf[topic_len] = 0;

    os_memcpy(dataBuf, data, data_len);
    dataBuf[data_len] = 0;

    INFO("Receive topic: %s, data: %s \r\n", topicBuf, dataBuf);

    //转发串口数据
    uart0_tx_buffer(topicBuf,strlen(topicBuf));
    uart0_tx_buffer("\r\n",strlen("\r\n"));
    uart0_tx_buffer(dataBuf,strlen(dataBuf));

    os_free(topicBuf);
    os_free(dataBuf);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

如果直接使用ESP8266控制外设，那么只需要在上面函数中对 dataBuf 进行数据解析即可，根据不同结果，控制ESP8266的GPIO进行不同动作即可。

如果ESP8266只是用于联网，负责中转消息，控制外设的任务由STM32或其他单片机来实现，那么只需要将数据转发出去即可。

前一种方法省了一个外部主控，后一种方法通用性好一点，外部总控可以根据自己擅长的自由选择。

修改代码

拷贝文件

拷贝原SDK中driver_lib文件夹至esp_mqtt_proj文件夹中，并重命名为driver，保留uart.c和Makefile两个文件，其他文件删除即可。

拷贝 driver_lib\include\driver\ 文件夹下的 uart.h 和 uart_register.h 文件至 esp_mqtt_proj\include\driver\ 文件夹下，替换原有的 uart.h 和 uart_register.h 文件。

注意：因为新加了一个文件夹 driver ，所以要修改 esp_mqtt_proj 目录下的 Makefile 文件，修改的项为：SUBDIRS 和 COMPONENTS_eagle.app.v6 两项，具体添加如下所示：

SUBDIRS=    \
       user    \
       mqtt   \
       modules  \
       driver

COMPONENTS_eagle.app.v6 = \
       user/libuser.a  \
       mqtt/libmqtt.a  \
       modules/libmodules.a \
       driver/libdriver.a

1
2
3
4
5
6
7
8
9
10
11
12

重定向调试信息输出

ESP8266有两个串口，之前我们分享过相关网文（参见文末参考阅读一），通常情况下，我们使用UART0和外设通讯，而使用UART1作为日志打印端口。

而现在所有的打印信息都是通过UART0打印输出的，所以我们要将打印输出的串口修改为UART1。

屏蔽调试信息后，只在UART0输出有用属性设置信息，具体展示效果如下：

由此我们可以看出，串口助手可以收到服务器端发送的属性设置主题的内容，对此接收消息的内容进行解析，即可完成远端对设备的开关设置。

同样使用一个单片机或者STM32来替代这个串口助手，用来接收串口数据并对其进行解析，那么对设备的控制，就可以移植到单片机或者STM32端来实现了。

发布消息 上报属性

设备端除了接收远程控制指令以外，一般还要把自己的设备属性进行上报，其他终端如果也订阅了此主题，那么在设备对属性上报的同时，其他终端也能同步收到此主题消息。

将接收到的串口数据发布至OneNET服务器，修改的代码位置如下：。

通过上面我们知道，如果设备的属性要上报给服务器，那么设备属性上报的主题为：$sys/{pid}/{device-name}/thing/property/post
替换产品ID和设备名称之后为：$sys/hg8zt6E3LP/XiaoHaLED/thing/property/post

发送的主题内容为：

{"id":"123","version":"1.0","params":{"Runtime":{"value":1200}}}
1

利用串口助手发送上面数据包，实现设备属性上报，具体操作如下：

也可以同时改变多个参数：

{"id":"123","version":"1.0","params":{"Runtime":{"value":1000},"PowerSwitch":{"value":true}}}
1

利用串口助手发送上面数据包，也可以同时上报多个属性，实现设备多属性上报，具体操作如下：

资料获取

文中涉及最终测试Demo获取，请在公众号后台回复关键字：OneNET工程源码。

总结

历时近一个月，写了五篇原创，今天终于把这个网友问答解决了。

通过这几篇网文的分享，我感觉整个解决方案的路线已经走通了，剩下的你只要用STM32代替串口助手，用一个串口发送串口数据至ESP8266模块，即可完成属性的上报。解析这个STM32串口接收到的数据，进而就能够实现设备属性的设置。

文末有整个问题涉及的相关网文，自己先看一遍网文，大概了解一下解决思路，然后自己试着做一下，遇到困难了翻看一下对应网文，如果还有问题，可以文末加小哈哥微信，我拉你进群里咱们细聊。

好了，今天的分享就到这里，暂时对OneNET的分享也告一段落，如果小哈哥的分享对你有所帮助，还请点赞支持一下哈[爱心]。

小贴士

小哈哥公众号新出版块，以后每个网文后面一个小tip，希望对你有所帮助。

内容涉及但不限于STM32、单片机、鸿蒙、Qt、小程序，感兴趣的可以持续关注哈，以后的网文，篇篇文末都有的！~

Q： 推荐一个JSON字符串压缩和格式校验的工具。

A： 在线JSON校验格式化工具：https://www.bejson.com/

发送的测试数据包为：

{"id":"123","version":"1.0","params":{"Runtime":{"value":1234},"PowerSwitch":{"value":false}}}

参考阅读

一、保姆级教程，虚拟机中重复验证了三遍，包你顺利接入阿里云物联网平台

二、从0到1 | ESP8266 官方SDK开发快速入门

三、代码太多不要怕，分享一个阅读代码的神器

四、与OneNET服务器连接初体验

五、大白话聊物联网通信过程，看不懂算我输！~