1. 硬件准备与连接做物联网项目第一步就是把硬件搭起来。我这里用的是STM32F103C8T6作为主控搭配ESP8266-01s WiFi模块和MQ系列气体传感器。这套组合性价比超高特别适合学生党和小型项目。先说说各个模块的作用STM32F103C8T6江湖人称蓝 pill性能稳定价格便宜自带多个串口特别适合做通信控制ESP8266-01sWiFi神器8块钱就能让设备联网支持AT指令和透传模式MQ传感器我用的是MQ-2能检测可燃气体做环境监测很实用接线时要注意几个关键点STM32的PA2接ESP8266的RXPA3接TX记得交叉连接给ESP8266单独供电3.3V要稳定电流最好能达到500mAMQ传感器的AO脚接STM32的PA7做ADC采集我刚开始接线时犯过一个低级错误把ESP8266的TX直接接STM32的TX结果数据死活传不过去。后来用逻辑分析仪抓包才发现问题。所以新手一定要记住TX接RXRX接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连接状态检测我的实现方式是发送ATCWJAP指令后等待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格式是否正确确认主题名称是$dpOneNet收不到数据检查产品ID和设备ID确认数据流名称匹配查看设备是否在线8. 项目优化建议基础功能实现后可以考虑以下优化低功耗设计使用STM32的睡眠模式动态调整采集频率优化WiFi连接策略数据缓存在网络中断时暂存数据恢复后批量上传添加本地存储安全增强定期更换鉴权信息添加数据加密实现固件远程升级扩展功能添加更多传感器实现设备联动开发手机APP这个项目我从零开始折腾了两周期间遇到各种奇怪问题。最崩溃的一次是ESP8266死活连不上网最后发现是路由器设置了MAC地址过滤。所以建议大家遇到问题时要有系统地排查先硬件后软件先简单后复杂。