ESP32-C3入门教程 应用 篇（实例一、通过MQTT协议连接 ONENET 平台）
ESP32-C3学到现在，我们已经掌握了从基本外设到网络服务端的相关知识，
这篇文章就是做一个简单的应用，使用开发板连接ONENET云平台，
使用MQTT协议，上报温湿度和光照数据，平台下发命令控制全彩灯颜色切换。
目录
- 前言
- 一、整体框架设计
-
- 1.1 配网添加（Smart_config ）
- 1.2 周期上报数据（Timer）
- 1.3 光照度采集（ADC）
- 1.4 温湿度采集（I2C）
- 1.5 按键（GPIO）
- 二、ONENET平台设置
-
- 2.1 添加产品 和设备
- 2.2 为设备添加数据流
- 2.3 云平台协议参数说明
-
- 2.3.1 ONENET MQTT服务器地址
- 2.3.2 clientld、username、password
- 2.3.3 password 获取方法
- 2.4 订阅Topic
- 2.5 发送数据至云平台
- 2.6 云平台下发命令
- 三、整体调整测试
-
- 3.1 结合平台的基本调整
- 3.2 .url 和 .host
- 3.3 周期上报效果
- 3.4 下行命令处理（RMT应用）
- 附录（源码）
前言
接下来的 ESP32-C3 功能测试都是基于自己设计的开发板：
自己画一块ESP32-C3 的开发板（第一次使用立创EDA）（PCB到手）
开发环境是乐鑫官方的 ESP-IDF， 基于VScode插件搭建好的：
ESP32-C3 VScode开发环境搭建（基于乐鑫官方ESP-IDF——Windows和Ubuntu双环境）
本文作为一个具体的应用实现，把前面博文所学的知识做了个结合，具体实现的功能如下:
1. 光照度采集
ESP32-C3入门教程 基础篇（一、ADC采样）
2. 温湿度采集
ESP32-C3入门教程 基础篇（四、I2C总线 — 与SHT21温湿度传感器通讯）
3.按键操作
ESP32-C3入门教程 基础篇（二、GPIO中断、按键驱动测试）
4.全彩RGB LED控制
ESP32-C3入门教程 基础篇（五、RMT应用 — SK6812全彩RGB LED灯驱动测试）
5.周期上报数据
ESP32-C3入门教程 基础篇（六、TIMG 硬件定时器 与 软件定时器）
6.WiFi配网
ESP32-C3入门教程 网络 篇（一、 Wi-Fi 使用入门 — 初始化及STA、AP模式）
ESP32-C3入门教程 网络 篇（二、 Wi-Fi 配网 — Smart_config方式 和 BlueIF方式）
7.MQTT连接云平台
ESP32-C3入门教程 网络 篇（三、 MQTT 协议基础介绍及测试）
我们还没有讲解 ESP-IDF 的工程结构，本文虽然是综合应用实例，目的在于实现一个完成的小项目实例，对于工程代码文件结构，规范性没有处理，示例是以简单的形式呈现，特此申明！ 勿杠！
当初计划是使用阿里云，但是我想到自己的手机阿里云还是新用户，新用户会有采购优惠，不能浪费了= =， 所以为了优惠这里抛弃了阿里云，采用OneNet。
一、整体框架设计
首先明白，本实例的核心部分就是 MQTT 的通信，所以整体的框架是基于 MQTT 的Demo 进行修改，
在以此为基本框架的基础上增加我们需要的组件，功能，函数。
1.1 配网添加（Smart_config ）
删除 MQTT Demo中关于配网的操作，使用 Smart_config 配网方式，直接拷贝 Smart_config Demo中的函数：
Smart_Config的初始化函数，回调函数，任务函数都直接复制Smart_config Demo中的即可，但是得注意 其中的任务smartconfig_example_task 配网结束后需要删除，节约空间，如下图：
1.2 周期上报数据（Timer）
周期上报数据使用硬件定时器方式，使能一个 自动重装载的定时器，在定时器中断函数中改变状态位，提醒需要上报数据，需要的代码比定时器 demo 中的简单，只需要需要的功能，如下：
1.3 光照度采集（ADC）
光照度采集使用的事ADC采样，只需要简单的在 主函数中使能了ADC，直接采用单次采样的方式，加上一下数据处理，结合上面的定时器，就能实现一个周期上报功能：
测试效果：
1.4 温湿度采集（I2C）
温湿度的采集，还是根据 ESP32-C3入门教程 基础篇（四、I2C总线 — 与SHT21温湿度传感器通讯）中的内容，添加对应的 sht21.c 和 sht21.h 文件，然后在周期任务处调用测试：
测试效果：
1.5 按键（GPIO）
按键操作目的在于，当产品需要配网的时候，手动删除以前的配网信息，按键的操作在
ESP32-C3入门教程 基础篇（二、GPIO中断、按键驱动测试） 有过说明，同时在 ESP32-C3入门教程 网络 篇（二、 Wi-Fi 配网 — Smart_config方式 和 BlueIF方式）也有过说明，这里主要的用法和Wi-Fi配网教学篇中的一样，按键会主动删除曾经有过的配网信息，导致产品重新进入配网：
测试效果：
重启以后重新配网能够回归正常。
完成程序的框架设计搭建，接下来就要进场云平台的产品创建。
二、ONENET平台设置
在 OneNET平台，进入控制台，找到对应的MQTT 物联网套件：
2.1 添加产品 和设备
产品添加成功，此时可以点击如下图片立即添加设备：
如果当时没有立即添加，可以在产品概况的（左边栏目），设备列表里面找到关于设备的相关信息，进行添加设备：
添加完成后，可以看到设备离线，然后一些基本信息：
2.2 为设备添加数据流
找到设备
2.3 云平台协议参数说明
前面完成了云平台的设置，我们可以通过PC客户端先对云平台进行一个测试，在这之前，需要先了解一下ONENET MQTT协议规范的基本介绍，通过如下网站可以查找到所有需要的ONENET MQTT介绍：
OneNET MQTT 协议规范文档说明
2.3.1 ONENET MQTT服务器地址
mqtts.heclouds.com 1883
OneNET MQTT 服务器地址
2.3.2 clientld、username、password
更加详细的介绍如下图：
2.3.3 password 获取方法
连接除了clientld、username，还需要password 。 ONENET的 password 需要使用费 token 算法 获取：
ONENET token 算法说明
ONENET token工具下载
1、products/产品ID/devices/设备名称
2、时间戳
通过这个的工具获取： 在线 时间戳转换工具
填入工具之中：
3、key
4、生成密码
通过 MQTT.fx 配置连接云平台，按照如下配置进行设置：
配置完成以后，点击connect，在ONENET上可以看到设备在线状态：
2.4 订阅Topic
ONENET平台 与设备 Topic 的约定，不能随意的定义自己的Topic，有对应的规定:
有如下一些Topic：
比如，我们订阅一个上报结果，类似如图所示：
2.5 发送数据至云平台
我们上面完成了数据上报结果订阅，那么有关于任何数据点上报的结果，我们都能收到消息，我们使用工具来尝试一下给平台发送数据：
在 MQTT.fx 中，数据格式使用 Json 格式发送：
点击发布，我们可以通过订阅的消息看到消息已经发送，在云平台也能看到数据上报成功：
2.6 云平台下发命令
接收平台下发的命令，就是订阅设备所有命令相关消息：
在云平台点击下发命令，如下图，然后写入cmd，在MQTT.fx 中我们订阅过消息，所以能够收到命令：
测试完成，到时候我们将会使用这个命令来控制板子上的RGB灯。
三、整体调整测试
3.1 结合平台的基本调整
在前面其实有提到过 topic 的说明，设备发布消息到非法topic ，平台会断开设备连接：
所以在整体修改的过程中需要注意，不要有其他的无用的测试Topic 。
在前面修改完成的整体程序框架中，根据平台的测试结果，修改一些必要的地方：
一些基本的定义：
MQTT配置部分代码：
周期上报的逻辑：
3.2 .url 和 .host
在此期间测试有一个问题：
实际上这里有个概念没有搞清楚：
此处的内容可参考博文：网址（url），域名，ip地址，dns，hosts之间的关系
3.3 周期上报效果
最终测试结果，周期上报板子上传感器数值，在云平台可以看到周期上报的结果：
3.4 下行命令处理（RMT应用）
下行命令处理，我们这里是基于订阅了云平台的 CMD 命令，但是对于这个下行的命令，目前看到也并没有一个标准的格式指定。这里目的是为了演示，所以我们怎么简单怎么来。
我们自己把下行需要处理的命令格式定位： mycmd：XXXXX。
比如：mycmd：ledred mycmd：ledblue。
这样，我们通过接受到的消息经常简单的数据处理以后，做出对应的动作。
（具体的执行可参考源码）
测试结果， 切换成蓝灯：
测试结果，切换成红灯：
附录（源码）
这里上一下app_main.c文件源码，其实只要看过我的教学博文，下面这个文件的代码都是有分析说明的，包括本文上面也对每个部分的功能有单独说明。整个应用工程的代码，我上传到了资源：
本博文工程源码
app_main.c：
/* MQTT (over TCP) Example
This example code is in the Public Domain (or CC0 licensed, at your option.)
Unless required by applicable law or agreed to in writing, this
software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.
*/
#include