STM32+ESP8266 MQTT实战：从传感器到OneNet物联网平台的数据上云之旅
1. 硬件准备与连接
做物联网项目第一步就是把硬件搭起来。我这里用的是STM32F103C8T6作为主控，搭配ESP8266-01s WiFi模块和MQ系列气体传感器。这套组合性价比超高，特别适合学生党和小型项目。
先说说各个模块的作用：
- STM32F103C8T6：江湖人称"蓝 pill"，性能稳定价格便宜，自带多个串口特别适合做通信控制
- ESP8266-01s：WiFi神器，8块钱就能让设备联网，支持AT指令和透传模式
- MQ传感器：我用的是MQ-2，能检测可燃气体，做环境监测很实用
接线时要注意几个关键点：
- STM32的PA2接ESP8266的RX，PA3接TX（记得交叉连接）
- 给ESP8266单独供电，3.3V要稳定，电流最好能达到500mA
- MQ传感器的AO脚接STM32的PA7，做ADC采集
我刚开始接线时犯过一个低级错误：把ESP8266的TX直接接STM32的TX，结果数据死活传不过去。后来用逻辑分析仪抓包才发现问题。所以新手一定要记住：TX接RX，RX接TX，这个口诀能省去很多调试时间。
2. 开发环境搭建
工欲善其事必先利其器。我用的是Keil MDK开发环境，配合ST-Link下载器。这里分享几个实用技巧：
串口调试：建议同时开两个串口助手
- 一个监控STM32和PC的通信（USART1）
- 另一个监控STM32和ESP8266的通信（USART2）
库函数选择：
// 关键初始化代码 USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART2, &USART_InitStructure);- 调试技巧：
- 在USART2的中断服务函数里加打印，实时查看ESP8266返回的数据
- 使用
__FILE__和__LINE__宏定位问题代码位置 - 对于不稳定的WiFi连接，可以添加重试机制
3. ESP8266的MQTT配置
ESP8266要连接OneNet，需要完成以下几个步骤：
3.1 WiFi连接配置
在wifi.h文件中修改你的WiFi信息：
#define SSID "your_wifi_ssid" // 改成你的WiFi名称 #define PASS "your_wifi_password" // 改成你的WiFi密码建议添加WiFi连接状态检测，我的实现方式是：
- 发送AT+CWJAP指令后，等待5秒
- 检查返回是否为"WIFI CONNECTED"
- 如果失败，自动重试最多3次
3.2 MQTT参数设置
OneNet需要三个关键信息：
- 产品ID
- 设备ID
- 鉴权信息
这些在mqtt.h中配置：
#define PRODUCTID "123456" // 从OneNet控制台获取 #define DEVICEID "654321" #define AUTHENTICATION "abcd1234"特别注意：OneNet的MQTT主题比较特殊，发布数据要用"$dp"主题：
#define Data_TOPIC_NAME "$dp" // 数据发布主题4. 数据采集与上传逻辑
传感器数据的采集和上传是项目的核心。我采用定时器中断的方式实现：
4.1 定时器配置
// 10秒采集一次传感器数据 TIM2_Init(10000, 7200); // 30秒发送一次心跳包 TIM3_Init(30000, 7200);4.2 数据打包格式
OneNet要求特定的JSON格式：
{ "MQ":"123", "TM":"25", "HM":"50" }对应的代码实现：
sprintf(temp,"{\"MQ\":\"%d\",\"TM\":\"%d\",\"HM\":\"%d\"}", (ADC_Val/100), temperature, humidity);4.3 心跳包机制
MQTT连接需要保持活跃，我的做法是：
- 正常状态下每30秒发送一次PING
- 如果检测到连接异常，改为每2秒快速重试
- 连接恢复后切回30秒间隔
5. OneNet平台配置
很多新手卡在OneNet的配置上，这里详细说明：
5.1 创建产品
- 登录OneNet控制台
- 选择"多协议接入"-"MQTT"
- 填写产品信息时注意：
- 联网方式选WiFi
- 协议类型选MQTT
- 其他信息按实际填写
5.2 添加设备
创建产品后，需要添加具体设备：
- 记录自动生成的设备ID和鉴权信息
- 这些信息要填入STM32代码中
- 建议开启自动注册，方便调试
5.3 数据流管理
数据流相当于数据库的表，配置要点：
- 名称要和代码中的JSON字段对应
- 可以添加多个数据流（温度、湿度等）
- 单位要设置正确，方便后续展示
6. 数据可视化配置
OneNet的可视化功能很强大：
- 创建应用：在"应用管理"中新建
- 添加控件：拖拽需要的图表组件
- 绑定数据流：选择对应的数据流
- 样式调整：可以修改颜色、大小等
我常用的几个组件：
- 数字显示：实时展示当前值
- 曲线图：显示历史趋势
- 仪表盘：直观显示数值范围
- 开关控件：远程控制设备
7. 常见问题排查
在实际项目中遇到过不少坑，这里分享几个典型问题的解决方法：
ESP8266连接不稳定
- 检查电源是否充足
- 尝试降低波特率到9600
- 添加AT指令延时
MQTT频繁断开
- 确认心跳间隔设置合理
- 检查WiFi信号强度
- 验证设备鉴权信息是否正确
数据上传失败
- 用串口监控原始数据
- 检查JSON格式是否正确
- 确认主题名称是
$dp
OneNet收不到数据
- 检查产品ID和设备ID
- 确认数据流名称匹配
- 查看设备是否在线
8. 项目优化建议
基础功能实现后，可以考虑以下优化：
低功耗设计
- 使用STM32的睡眠模式
- 动态调整采集频率
- 优化WiFi连接策略
数据缓存
- 在网络中断时暂存数据
- 恢复后批量上传
- 添加本地存储
安全增强
- 定期更换鉴权信息
- 添加数据加密
- 实现固件远程升级
扩展功能
- 添加更多传感器
- 实现设备联动
- 开发手机APP
这个项目我从零开始折腾了两周，期间遇到各种奇怪问题。最崩溃的一次是ESP8266死活连不上网，最后发现是路由器设置了MAC地址过滤。所以建议大家遇到问题时，要有系统地排查：先硬件后软件，先简单后复杂。