【纯白嫖】STM32F103C8T6 接 ESP8266 上云实战:一根串口把数据送进阿里云
【纯白嫖】STM32F103C8T6 接 ESP8266 上云实战:一根串口把数据送进阿里云
给 IoT 新手:一块 STM32F103C8T6 核心板、一片 ESP8266(ESP-01S)模块,靠一根串口用 MQTT 协议把数据送进阿里云,跟着本文走一遍就能自己跑通。
硬件清单与接线:ESP8266 与 STM32 串口接线对照
先把料凑齐,清单很短:
| 物料 | 说明 |
|---|---|
| STM32F103C8T6 核心板 | 主控,芯片带 HAL 库(意法半导体的硬件抽象层库,帮你屏蔽寄存器细节) |
| ESP-01S 模块 | ESP8266 最小封装,自带 Wi-Fi,固件里用 AT 指令集驱动 |
| USB 转 TTL 模块(CH340/CP2102 均可) | 电脑看串口日志用 |
| SWD 下载器(如 ST-Link) | 烧录固件用 |
| 3.3V 电源 | 给 ESP-01S 供电 |
| DHT11 温湿度传感器(可选) | 工程里已带驱动,想发真实数据才需要 |
ESP-01S 和 STM32 之间只走一路串口(USART2),线要交叉:
| STM32F103C8T6 | ESP-01S | 说明 |
|---|---|---|
| PA2(USART2_TX) | RXD | 发指令给 ESP |
| PA3(USART2_RX) | TXD | 收 ESP 的回复 |
| GND | GND | 必须共地 |
| 3.3V 电源 | 3V3 | ESP 只认 3.3V 逻辑 |
⚠️ 供电别偷懒:ESP-01S 工作时电流波动大,直接取 USB 5V 会烧模块,从 USB 转 TTL 的 TX 引脚借电也不稳(电平是 5V,还带不进去纹波)。用独立的 3.3V 电源最省心。
另外板上还留了 USART1(PA9/PA10,115200),那是留给电脑调试用的日志口,接上 USB 转 TTL 就能看到运行日志,不用动它。
阿里云 MQTT 参数怎么填:五个关键值逐个对号
设备能不能连上阿里云 IoT 平台,就看这五个参数。打开工程后你会在 103_no_os_cmp/NET/inc/ali_yun.h 里找到它们集中定义的地方(这类用户代码在 README 里归到 User/ 目录,本工程放在 NET/ 下),挨个替换成你自己的:
| 参数 | 从哪拿 | 格式长这样 |
|---|---|---|
| MQTT 服务器地址 | 阿里云物联网控制台 → 设备详情 → MQTT 接入点 | iot-xxxxxxxx.mqtt.iothub.aliyuncs.com |
| 端口 | 固定值,明文 MQTT 用 1883 | 1883 |
| ClientID | 用 ProductKey + DeviceName 按平台规则拼,带 securemode、signmethod、timestamp 字段 | ix25oHiHCSl.stm32|securemode=2\,signmethod=hmacsha256\,timestamp=...| |
| 用户名 | DeviceName 和 ProductKey 组合(双向鉴权格式) | stm32&ix25oHiHCSl |
| 密码 | 用 ProductSecret 做 HMAC-SHA256 算出,别手敲 | 64 位十六进制字符串 |
除了这五个,还要改一处 Wi-Fi 配置:在 103_no_os_cmp/NET/src/esp8266.c 顶部的 WIFI_NAME、WIFI_PASS,填你自己路由器的名字和密码,不然后面连 Wi-Fi 这步会一直卡住。
数据格式这块你不用操心:固件里用 cJSON(轻量级 C 语言 JSON 打包/拆解库)自动把温湿度装进 {"params":{...},"version":"1.0.0"} 这种标准格式再发布。
从编译到烧录:STM32F103C8T6 固件五步出活
工程是 Keil 项目(解压后 MDK-ARM/103_no_os.uvprojx),全程不用敲一行代码:
- 拿工程:clone 仓库
git clone https://gitcode.com/open-source-toolkit/f68c2,解压103_no_os_cmp.zip。✅ 看到MDK-ARM/103_no_os.uvprojx文件就算成功。 - 装 Keil MDK:任意较新版本即可,工程是标准 Keil 工程。✅ Keil 能正常打开、工程树里文件不报红。
- Build 编译:点工具栏的编译按钮。✅ 编译日志末尾是
0 Error,并生成103_no_os.hex。 - 下载固件:SWD 下载器接上核心板的 SWD 口,选中刚生成的 hex,点 Download。✅ 下载器提示 Download / Verify Successful。
- 复位观察:按一下核心板复位键,打开电脑串口助手(115200,8N1)看 USART1 日志。✅ 能看到连 Wi-Fi、连 MQTT 的过程打印,没有乱码刷屏。
数据到底上云没有:两种验证姿势
姿势一:阿里云物联网控制台(最直观)
登录控制台进入设备管理页,先看你的设备在线状态是否变绿。然后打开设备的"日志"或数据流转页面:每隔几秒应能看到一条上报,内容是 {"params":{"temperature":xx,"Humidity":xx},"version":"1.0.0"}。看到这条 JSON,链路就通了。
姿势二:MQTT 订阅工具(最硬核)
在电脑上跑一个 MQTT 客户端工具,订阅设备的数据上报主题 /sys/{ProductKey}/{DeviceName}/thing/event/property/post(把花括号换成你自己的值)。订阅后每几秒能收到一条 JSON 报文,说明设备端发布、云端转发、你这边订阅整条路都没问题——还能顺便试反向下发:往 /sys/{ProductKey}/{DeviceName}/thing/service/property/set 主题发一条 JSON,看串口日志里打印的"接收数据成功,开始解析"。
新手最常踩的几个坑
- 串口全乱码 → 波特率对不上。工程里两路串口都是 115200,串口助手设成别的值就全是鬼画符。
- 启动后卡住,连 Wi-Fi 都连不上 →
WIFI_NAME/WIFI_PASS还是示例里的值,AT+CWJAP 一直在等一个永远不来的 OK。改成自己路由器的即可。 - AT 有回复、MQTT 连接反复失败 → ClientID、用户名、密码三者要成套,密码是用 ProductSecret 算出来的,手敲错一位或 timestamp 过期都会被拒绝。
- AT 指令完全没响应,连 "OK" 都没有 → 先查供电:5V 直接怼上去或供电不足,模块会不停重启,什么都收不到。
- 设备"在线"但控制台看不到数据 → 检查发布主题是不是
/sys/.../thing/event/property/post这个标准格式,写错主题云端不认。
跑通之后还能玩什么
- 定时器周期上报:demo 里是靠循环计数满 1000 次发一次,改成 SysTick 或硬件定时器可以精确到"每 N 秒必发"。
- 断线重连:AT 指令超时(代码里返回 1)时,把连 Wi-Fi、连 MQTT 的初始化流程再走一遍,加个重试计数,野外掉网也不怕。
- 接真实传感器:
HARDWARE/目录里已经带好了 DHT11 驱动,把传感器怼上去,把演示用的自增数值换成实测温湿度,就是一份真的气象站数据了。