【珍藏整理】STM32 + ESP8266 一次跑通MQTT上云:从接线到首条消息的完整路径
【珍藏整理】STM32 + ESP8266 一次跑通MQTT上云:从接线到首条消息的完整路径
这份笔记基于仓库里的 103_no_os_cmp 工程(STM32F103C8T6 + ESP8266 esp-01s 的 MQTT 固件),用 HAL 库走 AT 指令把温湿度数据推到阿里云 IoT 平台。跟着做,从接线到控制台看到首条消息,大概一个下午的事。
技术选型一览
| 环节 | 选择 | 为什么选它 |
|---|---|---|
| 主控 | STM32F103C8T6 | 便宜、HAL 库成熟,外设够用 |
| 联网 | ESP8266 esp-01s | AT 指令即可发 MQTT,不用写 Wi-Fi 协议栈 |
| 协议 | MQTT over TCP 1883 | 云接入标准,阿里云 IoT 平台原生支持 |
| 云平台 | 阿里云 IoT | 免费额度够开发测试,控制台可直接看消息 |
| 数据处理 | cJSON | 组包、解包各几行代码,嵌入式常用 |
🔌 接线与硬件准备
STM32 用 USART2 和 esp-01s 通信,核心就四件事:
- TX/RX 交叉:STM32 的 PA2(USART2_TX)接 esp-01s 的 RX,PA3(USART2_RX)接 esp-01s 的 TX,接反了 AT 指令必失败。
- 电平:两边都是 3.3V,直连即可,不需要电平转换。
- 供电:esp-01s 发射瞬间电流能到 500mA 以上,VCC 上并一颗 100uF 电容,USB 口带不动就换独立 5V 电源。
- 调试口:USART1(PA9/PA10)留给 USB 转 TTL 看打印,DHT11 温湿度传感器接 PA6。
工程源码在 103_no_os_cmp.zip 里,也可以 git clone https://gitcode.com/open-source-toolkit/f68c2 后解压,Keil 打开 MDK-ARM 目录下的工程即可。
固件里只改这两个文件
改→填→存,一共两处,别的地方都不用动:
- 打开
NET/src/esp8266.c,把顶部的WIFI_NAME、WIFI_PASS改成你路由器的 Wi-Fi 名和密码。 - 打开
NET/inc/ali_yun.h,填你在阿里云 IoT 平台创建产品设备后拿到的凭证:
#define ALI_USERNAME "设备名&产品Key"
#define ALI_PASSWD "由设备Secret算出的MQTT密码"
#define ALI_MQTT_HOSTURL "iot-xxxx.mqtt.iothub.aliyuncs.com"
ALI_PORT 是 1883,ALI_TOPIC_SET / ALI_TOPIC_POST 对应设备的上下行 topic,保持平台生成的原样。注意示例里 ClientID 带 securemode 参数,换设备后务必按阿里云文档重新生成,不然握手会被拒。
从零到数据上云
按这个顺序走,每一步都有明确预期:
- 编译:Keil 里 Build,0 Error 就算过。
- 烧录:SWD 烧进 F103,板子复位。
- 上电:esp-01s 的 TXD 灯快闪说明它在忙 AT 指令;串口助手(115200)能看到
ready、OK这类回显。 - 观察串口:连上 Wi-Fi 后打印
success,接着出现 cJSON 组好的 json 串和开始发送数据,这就是 MQTT PUB 指令。 - 控制台确认:打开阿里云 IoT 平台的物模型数据页面,看到 temperature / Humidity 数值刷新——对了,走通了。
⚠️ 容易踩的坑
- 串口乱码或 AT 无应答:波特率不匹配。STM32 侧 USART1/USART2 都是 115200,esp-01s 固件默认也是,改过任意一侧就三处一起改。
- 卡在 AT+CWJAP 或 MQTTCONN 处死等:ESP8266 关联 Wi-Fi 要几秒,示例代码用
while(SendCmd(...))死循环等 OK,超时 2 秒后不会往下走,只会原地转圈。先确认 Wi-Fi 名密码,再考虑给连接加失败重试。 - MQTTCONN 被平台拒绝:用户名、ClientID、密码三者必须和平台设备一一对应,secret 换过而密码没重算是最常见原因。
- cJSON 解析出 null 就飞:云端下发的消息不是标准格式时
cJSON_Parse返回 NULL,接收路径里已有判空和连续 3 次清缓存的保护,自己加业务时别把判空删掉。 - 板子频繁重启、AT 时好时坏:多半是 3.3V 供电掉压,esp-01s 射频一工作电压就垮。加电容或单独供电解决。
往哪扩展
工程里 DHT11 驱动(HARDWARE/src/dht11.c)已经就位,把 Ali_Yun_Send() 里的演示自增数据换成 DHT11() 读回的真实温湿度,就是完整的一条物联网链路。
第二个方向是断线重连:监测 AT+MQTTPUB 是否持续 OK,连续失败就 AT+RST 重启 esp-01s 走一遍初始化,比完整状态机简单得多,适合先上生产验证。
再往后,可以考虑把 esp-01s 换成更低功耗的 4G Cat.1 模组,或者上 FreeRTOS 把收发和传感器采样分到不同任务里跑。下一步可以试试把真实传感器数据推上云,跑一整天看控制台曲线。
登录后查看全文