【资源自取】STM32 + SIM900 跑通 MQTT:从 AT 指令到第一条消息的完整路径
【资源自取】STM32 + SIM900 跑通 MQTT:从 AT 指令到第一条消息的完整路径
如果你手上有 STM32 开发板,想让它真正"联网",SIM900 蜂窝模块是最省心的切入点。这篇文章带你完整走一遍:STM32 通过串口驱动 SIM900 模块,用 MQTT 协议在蜂窝网络上订阅、发布消息,一直到把文件传过去。读完你应该能自己搭出一套从设备到 Broker 的通信链路,而不只是看懂几个 AT 指令。
先搞懂这套方案在干什么
选 STM32 + 蜂窝模块 + MQTT 这个组合,本质是三个现实考量的结果。Wi-Fi 模块便宜,但设备必须待在路由器旁边,野外、车载、远端机柜这些场景直接出局;高端 5G 模组动辄上百块,而这类"发点数据、收点指令"的需求用不上它的性能。SIM900 这类插卡模块成本很低,全国有基站信号的地方就能工作,对新手也友好——它把复杂的网络协议栈封装在模块内部,MCU 只需要串口 + AT 指令。
数据流走的是这么一条链路:STM32 终端通过 UART 把数据喂给 SIM900 模块,模块拨号接入蜂窝网络,建立 TCP 连接到达 MQTT Broker,Broker 再按主题(Topic)把消息转发给订阅它的服务端或其他设备。反过来,Broker 下发的消息会原路透传回串口,被 STM32 读取处理。
MQTT 相比裸 TCP 的优势一句话概括:协议头最小 2 字节,天生适合弱网和窄带,且自带订阅/发布模型和 QoS 机制——你的设备不用关心"该发给谁",只管发到主题上,这是后面所有扩展能力的基础。
动手前的物料清单
- STM32F103 开发板(工程基于 STM32F10x 高密度芯片,启动文件为
startup_stm32f10x_hd,容量不够的 LD 型号要注意) - SIM900 蜂窝模块(出厂默认串口波特率一般是 9600,买前确认版本,SIM800 等兼容型号也能改参数后用)
- SIM 卡(必须开通数据流量,纯语音卡只能注册网络、拨号必失败)
- 5V/2A 以上独立电源(SIM900 发射瞬间电流峰值接近 2A,用 USB 口供电大概率会卡死在开机阶段,这是头号坑)
- 杜邦线若干(串口 TX/RX、VCC、GND,别用太长,串口线越短越稳)
- 串口调试助手(开发阶段肉眼验证 AT 指令回包,比单步调试省事十倍)
- Keil MDK 工程环境 + 调试器(JLink 或 ST-Link,工程文件是 Keil v5 的
.uvproj格式) - PC 端 MQTT 客户端(如 MQTTX,用来和开发板互相收发消息验证)
- 代码包:MQTT 工程压缩包,解压后是完整的 Keil 工程
CenterControlBoard_HLW8012_MQTT,含 STM32 标准库和全部业务代码
从零跑通——分步搭建
接线与硬件配置 🔌
工程里 User/main.c 已经把引脚分工定死了,你只需照着接:SIM900 走 UART4,TX 对应 PC10、RX 对应 PC11,波特率 9600;调试打印走 USART1 的 PA9/PA10,波特率 256000,接电脑串口助手后所有日志从这里出来。另外 PB9 是模块电源控制脚(软件开关机),PA12 读模块状态。接线时最容易犯的就是 TX/RX 对调,记住 STM32 的 TX 接模块的 RX。
导入工程并改参数
用 Keil 打开 .uvproj 直接编译即可,标准库和启动文件都在包里,不需要重新配工程。真正要改的是 Broker 地址、端口、client_id 和主题(Topic)这几个参数,它们集中在 User/transport/ 目录下。client_id 在同一个 Broker 下必须全局唯一,两台开发板共用一个 ID 会互相踢下线。
配置 SIM900 联网
联网逻辑封装在 User/sim900/sim900.c 和 sim900_tcp_control.c 里,核心就是几个经典 AT 指令按序发出,例如附着网络这一步:
sim900_write_string("AT+CGATT=1\r\n");
整体流程是:软件拉 PB9 给模块上电复位 → AT+CSMINS? 确认 SIM 卡识别 → AT+CSQ 查信号 → AT+CGATT=1 附着网络 → 建 TCP 连接到 Broker 地址端口 → 切入透传模式。sim900_check_wait 这个函数负责发指令后等待指定关键字回包、超时重试,这套"发指令-等回包"的写法值得抄进你自己的项目里。
订阅 / 发布第一条消息
MQTT 协议层用的是经典的开源实现(工程内 mqttconnectclient、mqttserializepublish 等一组文件),业务层做了很干净的拆分:User/transport/mqtt_topic_send.c 只管把消息序列化成 MQTT 包发出去,mqtt_data_receive_handle.c 只负责收包后回调业务。QoS1 的重复发布控制也在这里面做了——网络抖动丢包后自动重发,不需要你在业务代码里操心。用 PC 端 MQTT 客户端订阅同一个 Topic,点亮第一条消息就算跑通了。
扩展——传个文件试试
这套工程不止能发文本:mqtt_file.c 配合 flash_program.c 实现了把 Broker 下发的文件数据写入 STM32 内部 Flash。把文件按包切片走 MQTT 传输、接收端落盘,就是它最直接的玩法,后面"延伸方向"里会再提。
大概率会踩的坑 ⚠️
串口完全无回包 → 九成是供电不足或 TX/RX 反接 → 先换独立 5V/2A 电源试,再用万用表量模块供电电压,发射瞬间掉到 4.5V 以下就会复位;仍无回包就检查杜邦线方向。
信号正常但 AT+CGATT 一直超时 → SIM 卡没开数据流量或该卡被运营商限制 → 把卡插进手机确认能上流量网页,再换回模块;纯语音卡必须换。
TCP 能连上 Broker 但 MQTT 反复重连 → Broker 地址/端口填错,或账号鉴权不通过 → 先用 PC 端 MQTT 客户端连同一个地址验证通路,再回查工程里的 IP、端口、用户名密码;工程里连续失败 3 次会自动重启 SIM900,这是设计好的自愈逻辑,别误判为硬件坏了。
偶尔收到乱码或半截消息 → 9600 波特率下大 payload 容易被截断,或接收缓冲溢出 → 看 buffer_dealing_with_function.c 的缓冲处理,给业务层加长度校验和完整性检查,大消息务必分片。
不只能发文本——能延伸出什么
- 设备状态周期上报:工程已内置 cJSON,把传感器数据打成 JSON 定期 publish 即可
- 远程文件下发:基于
mqtt_file.c做配置/固件文件的远程更新 - 双向远程控制:服务端往指定 Topic 发布指令,设备订阅后执行动作
- 多设备组网监控:多块设备各用唯一
client_id,服务端按主题分设备处理报警
到这里,你手里已经有了一个能主动上报、能收指令、能传文件的联网设备——STM32 物联网通信这条路,从硬件到协议栈已经全部走通。想继续改参数或加功能,git clone https://gitcode.com/open-source-toolkit/95af2 把工程拉下来解压 MQTT.rar 即可开工。