【珍藏整理】STM32 + ESP8266 一次跑通MQTT上云:从接线到首条消息的完整路径

原创2026-11-14 10:09:55366 阅读

【珍藏整理】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 目录下的工程即可。

固件里只改这两个文件

改→填→存,一共两处,别的地方都不用动:

  1. 打开 NET/src/esp8266.c,把顶部的 WIFI_NAME、WIFI_PASS 改成你路由器的 Wi-Fi 名和密码。
  2. 打开 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 参数,换设备后务必按阿里云文档重新生成,不然握手会被拒。

从零到数据上云

按这个顺序走,每一步都有明确预期:

  1. 编译:Keil 里 Build,0 Error 就算过。
  2. 烧录:SWD 烧进 F103,板子复位。
  3. 上电:esp-01s 的 TXD 灯快闪说明它在忙 AT 指令;串口助手(115200)能看到 ready、OK 这类回显。
  4. 观察串口:连上 Wi-Fi 后打印 success,接着出现 cJSON 组好的 json 串和 开始发送数据,这就是 MQTT PUB 指令。
  5. 控制台确认:打开阿里云 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 把收发和传感器采样分到不同任务里跑。下一步可以试试把真实传感器数据推上云,跑一整天看控制台曲线。

登录后查看全文
STM32F103c8t6ESP8266esp-01sMQTT固件HAL库连接阿里云