【纯白嫖】STM32F103C8T6 接 ESP8266 上云实战:一根串口把数据送进阿里云

原创2026-11-15 17:45:031,370 阅读

【纯白嫖】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),全程不用敲一行代码:

  1. 拿工程:clone 仓库 git clone https://gitcode.com/open-source-toolkit/f68c2,解压 103_no_os_cmp.zip。✅ 看到 MDK-ARM/103_no_os.uvprojx 文件就算成功。
  2. 装 Keil MDK:任意较新版本即可,工程是标准 Keil 工程。✅ Keil 能正常打开、工程树里文件不报红。
  3. Build 编译:点工具栏的编译按钮。✅ 编译日志末尾是 0 Error,并生成 103_no_os.hex。
  4. 下载固件:SWD 下载器接上核心板的 SWD 口,选中刚生成的 hex,点 Download。✅ 下载器提示 Download / Verify Successful。
  5. 复位观察:按一下核心板复位键,打开电脑串口助手(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 驱动,把传感器怼上去,把演示用的自增数值换成实测温湿度,就是一份真的气象站数据了。
登录后查看全文
STM32F103c8t6ESP8266esp-01sMQTT固件HAL库连接阿里云