简介一套基于STM32与ESP8266-01S的物联网温湿度采集方案通过Wi-Fi接入阿里云平台并将数据实时显示在OLED屏上适合正在学习STM32外设驱动、AT指令接入云平台的中高级嵌入式开发者。资源包共253个文件压缩后7.01MB以C语言源码和头文件为主体包含大量标准外设库驱动如定时器、串口、I2C等同时带有Keil工程配置文件、编译生成的hex固件以及中间文件便于直接打开工程查看或烧录验证。目前已有244人学习下载可作为完整参考项目。使用者可获得硬件初始化、传感器读取、OLED显示、ESP8266透传与阿里云物联网平台对接的整套代码并借助工程内模块划分快速定位所需功能适合在已有开发板基础上进行二次开发或移植。1. STM32ESP8266-01S阿里云温湿OLED这套组合在解决什么问题STM32ESP8266-01S阿里云温湿度传感器OLED这个组合最常见的出没场景是两类人一类是刚学完串口和 GPIO想做点能联网的硬件作品的开发者另一类是公司临时要一个环境监测 Demo要求三天内把温湿度数据弄到云上看板上的工程师。这套方案的价值在于它把本地采集和云端上报之间的所有环节都走通了传感器负责采集OLED 负责本地显示ESP8266-01S 负责联网阿里云物联网平台负责数据存储和远程查看。它适合作为你从单片机裸机开发跨向物联网端云一体开发的第一个完整项目因为每个环节都有标准答案但也都有各自的陷阱。很多人以为最难的是传感器驱动真正做完才发现最耗时间的反而是 ESP8266-01S 的固件选择、阿里云 MQTT 的参数计算以及这三者之间的串口帧协议。这篇文章按我实际做过的顺序来讲先硬件选型和接线再打通网络链路接着配置阿里云最后把 STM32 代码串起来并单独整理一份踩坑清单。2. 硬件怎么选、怎么接六个元件一小时内焊好但线序别想当然2.1 主控与模块选型F103C8T6、ESP8266-01S、DHT11 与 OLED 的取舍主控我推荐 STM32F103C8T6也就是大家常说的蓝板。理由不是它性能多强而是它的资料密度极高、CubeMX 配置简单、串口资源够用而且 3.3V 逻辑电平与 ESP8266-01S 直接兼容不需要电平转换。如果你手上的是 5V 的 Arduino UNO那反而要加电平转换线路会复杂不少。ESP8266-01S 是这个标题里最容易翻车的硬件。它只有 1MB Flash比常见的 ESP-12F 少了整整一半而且只有 GPIO0 和 GPIO2 两个可用引脚。这意味着你没法在它上面跑完整的 MQTTTLS 客户端后面刷固件时会有很多限制。但正因为它便宜、引脚少、适合做纯透传才值得在这个项目里讲清楚怎么用。温湿度传感器选 DHT11 还是 DHT22取决于你对精度的要求。DHT11 精度是 ±2℃湿度 ±5%RH采样周期最低 1 秒一次DHT22 精度更高但贵三倍。对看个大概的 Demo 来说 DHT11 够了我下面的代码也按 DHT11 写。OLED 选 0.96 寸 I2C 接口的 SSD1306128×64 分辨率四根线就能驱动。I2C 版本比 SPI 版本少四根线省下的 GPIO 刚好拿去接 DHT11。2.2 接线表与供电设计3.3V/5V 混接的坑GPIO2 与 CH_PD 的上拉接线看起来简单但 ESP8266-01S 的供电和使能引脚有讲究。VCC 和 GND 不能直接从 STM32 的 3.3V 引脚取因为 01S 在 WiFi 发射瞬间电流能冲到 300mASTM32 板载稳压芯片扛不住这种瞬态压降表现就是模块随机重启、AT 响应时好时坏。我一般用独立的 AMS1117-3.3 稳压模块输入接 5V输出单独给 01S 供电。模块引脚接 STM32说明ESP8266-01SVCC独立 3.3V 电源不要接板载 3.3V 引脚ESP8266-01SGNDGND与 STM32 共地ESP8266-01SCH_PD3.3V串 10K 电阻使能脚必须拉高ESP8266-01SGPIO23.3V串 10K 电阻启动时必须是高电平ESP8266-01SRXDSTM32 PA9TX串口交叉连接ESP8266-01STXDSTM32 PA10RX串口交叉连接DHT11DATAPA0需外接 4.7K 上拉电阻OLEDSCLPB6I2C 时钟OLEDSDAPB7I2C 数据RXD 和 TXD 建议各串一个 1K 电阻再接到 STM32。01S 的 IO 不是 5V 容忍的虽然大多数情况下直接连也能工作但串个电阻能防止 STM32 的 5V 电平灌进去烧掉模块这是我踩过一次的教训。CH_PD 和 GPIO2 的上拉电阻不要省GPIO2 在模块启动瞬间必须是高电平否则模块会进入烧录模式表现就是上电后没有任何响应。2.3 先让 OLED 和 DHT11 在本地跑起来最小验证代码在联网之前先把本地采集和显示跑通。DHT11 是单总线协议STM32 用普通 GPIO 模拟时序就行。核心是读 40 位数据前 16 位是湿度后 16 位是温度最后 8 位是校验和。// DHT11 读取函数HAL库返回 0 成功-1 失败 uint8_t DHT11_Read(float *humidity, float *temperature) { uint8_t data[5] {0}; // 主机拉低 18ms 再释放触发传感器响应 HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_RESET); HAL_Delay(20); HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_SET); // 等待传感器拉低应答信号超时 40us 则退出 uint32_t timeout 40; while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_SET) { if (--timeout 0) return -1; } // 读取 40 位数据每位用高低电平宽度判断 0 或 1 for (int i 0; i 40; i) { while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_RESET); uint32_t width 0; while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_SET) { width; HAL_Delay(1); // 注意这里用延时累加判断位宽 if (width 70) break; // 超时保护 } if (width 40) data[i / 8] | (0x80 (i % 8)); } if ((data[0] data[1] data[2] data[3]) ! data[4]) return -1; *humidity data[0] data[1] / 10.0f; *temperature data[2] data[3] / 10.0f; return 0; }这段代码里HAL_Delay(1)在 while 循环中用来做粗略计时代码逻辑依赖循环次数判断 0 和 1 的位宽。实际工程中更严谨的做法是用定时器捕获模式测量脉冲宽度但对 DHT11 这种低速传感器上面的方式已经足够稳定。需要调整的是width 40这个阈值如果你把系统时钟从 72MHz 改成其他频率循环每次耗时不一样这个阈值要重新标定。OLED 这边用软件模拟 I2C 或硬件 I2C 都行。SSD1306 的初始化序列是固定套路开电源、关闭显示、设置时钟分频、设置 multiplex 比例、清屏、打开显示。初始化完成之后把 DHT11 读到的温度和湿度用sprintf格式化OLED_ShowString(0, 0, Temp: 25.1C)显示即可。3. 给 ESP8266-01S 刷一个能干活的固件透传程序的编译与烧录3.1 为什么不用 AT 指令直接上云01S 的 Flash 和 AT 固件不支持 MQTT/TLS最直觉的做法是给 01S 刷官方 AT 固件然后 STM32 通过串口发ATCWJAP连接 WiFi再用ATMQTTCONN连接阿里云。但这里有两个现实问题。第一01S 的 1MB Flash 装不下新版 AT 固件新版 AT 需要 2MB 起步你硬刷的结果是模块变砖。第二即使找到了老版本 AT 固件它里面也没有 MQTT 指令。那用 AT 指令建 TCP 连接让 STM32 自己封装 MQTT 报文行不行理论可行但 MQTT CONNECT 报文要算剩余长度、要拼接用户名密码对新手来说一个星期都调不通。所以更可靠的方案是用 Arduino IDE 给 01S 烧一个我们自己写的透传程序把 WiFi 连接和 MQTT 协议都封装在 ESP8266 侧STM32 只需要通过串口发送一段简单的 JSON 字符串ESP8266 收到后直接发布到阿里云。3.2 Arduino 里写 ESP8266-01S 透传程序编译、烧录、串口确认用 Arduino IDE 开发 ESP8266-01S 需要先安装 ESP8266 开发板支持包然后在开发板列表选择 Generic ESP8266 ModuleFlash Size 选 1MB波特率用 115200。下面是一个可用的透传程序#include ESP8266WiFi.h #include PubSubClient.h // 阿里云设备三元组 const char* ssid your_wifi_ssid; const char* password your_wifi_password; const char* mqtt_server productKey.iot-as-mqtt.cn-shanghai.aliyuncs.com; const char* clientId productKey.deviceName|securemode3,signmethodhmacsha1,timestamp789| const char* username deviceNameproductKey; const char* mqtt_password HMAC-SHA1签名结果; WiFiClient espClient; PubSubClient client(espClient); String lastPayload ; void callback(char* topic, byte* payload, unsigned int length) { // 收到下行消息时原样转发给 STM32帧头 0xAA 帧尾 0xBB Serial.write(0xAA); Serial.print(topic); Serial.write(0x7C); Serial.write(payload, length); Serial.write(0xBB); } void setup() { Serial.begin(115200); // 与 STM32 串口通信 WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) delay(500); client.setServer(mqtt_server, 1883); client.setCallback(callback); } void loop() { if (!client.connected()) { client.connect(clientId, username, mqtt_password); client.subscribe(/productKey/deviceName/user/get); } // 从 STM32 收到待上报数据按帧解析后发布 while (Serial.available()) { String payload Serial.readStringUntil(\n); client.publish(/productKey/deviceName/user/update, payload.c_str()); } client.loop(); }需要特别注意clientId的拼接格式。阿里云 MQTT 连接要求 clientId 是产品或设备信息加签名参数username 是deviceNameproductKeypassword 是三元组中 deviceSecret 参与的 HMAC-SHA1 签名结果。很多新手在这里栽跟头以为 password 直接填 deviceSecret结果一直报校验失败。正确做法是在阿里云控制台的设备详情页用官方工具生成签名把生成的连接参数填进代码里。这里用 1883 明文端口就是为了让 01S 的 1MB Flash 能跑得动。如果强制要求 TLS 加密PubSubClient 换成 WiFiClientSecure 后固件体积会涨到 900KB 以上01S 编译都编不过。对于 Demo 项目明文端口在隔离的局域网测试环境里是可接受的。3.3 透传帧协议设计STM32 和 ESP8266 之间怎么约定数据ESP8266 和 STM32 之间的串口协议不要设计得太复杂。上行数据STM32 → ESP8266用一行字符串以换行符结尾内容就是一个完整的 JSONESP8266 收到后原样发布到user/update这个 topic。下行数据ESP8266 → STM32用帧头 0xAA、帧尾 0xBB 包裹中间用 0x7C 分隔主题和消息体这样 STM32 在串口中断里判断帧头帧尾就能完整取出数据不会跟上行数据的 JSON 字符串混淆。这个协议有个隐含的好处STM32 不需要理解 MQTT 协议它只处理字符串和帧。以后想把平台从阿里云换成其他云只需要改 ESP8266 那侧的程序STM32 代码完全不用动。这就是分层设计在物联网小项目里的实战价值。4. 阿里云平台配置与 STM32 端数据链路打通4.1 创建产品、设备拿到三元组公共实例下的最小配置在阿里云物联网平台控制台开通公共实例后先创建产品产品名称随意节点类型选设备连网方式选 WiFi数据格式选阿里云 IoT 物模型因为物模型帮你自动生成标准 JSON 格式。创建完产品之后在产品详情里添加两个属性Temperaturefloat 类型和 Humidityfloat 类型读写类型选只读。然后添加设备设备名称建议用节点编号比如dev_01。添加完成后进入设备详情页能看到 ProductKey、DeviceName、DeviceSecret 三元组。这三组字符串是设备和云平台之间的唯一身份凭证后面 MQTT 连接参数的 clientId、username、password 全部由它们派生。千万别把 DeviceSecret 明文写在 ESP8266 代码里再传到 GitHub 上这是很多人在公开项目里泄露设备凭证的原因。物模型数据格式和 MQTT topic 的对应关系也需要理清。设备上报物模型属性发布消息到/productKey/deviceName/user/update消息体是一个 JSON参数里带上属性名和值{params:{Temperature:25.1,Humidity:60.5},version:1.0}4.2 STM32 端代码温湿度采集、JSON 封装、串口发送、OLED 刷新STM32 侧的逻辑很简单每两秒读一次 DHT11把温湿度拼成 JSON通过串口发给 ESP8266然后把同样的数据显示在 OLED 上。重点看 JSON 封装和串口发送的写法void Data_Report(void) { float temp 0, humi 0; // DHT11 读取失败则重试 2 次防止偶发错误导致稳定的数据中断 int ret DHT11_Read(humi, temp); if (ret ! 0) { DHT11_Read(humi, temp); } // 拼接物模型 JSON注意小数点位和转义字符 char payload[128]; snprintf(payload, sizeof(payload), {\params\:{\Temperature\:%.1f,\Humidity\:%.1f},\version\:\1.0\}\n, temp, humi); // 通过串口1发送给 ESP8266-01S HAL_UART_Transmit(huart1, (uint8_t*)payload, strlen(payload), 100); // OLED 双行显示温度一行湿度一行 char line1[20]; snprintf(line1, sizeof(line1), Temp:%.1fC, temp); OLED_ShowString(0, 0, line1); char line2[20]; snprintf(line2, sizeof(line2), Humi:%.1f%%, humi); OLED_ShowString(0, 3, line2); }snprintf的格式串里%.1f表示保留一位小数因为 DHT11 本身精度就不高显示多位小数是自欺欺人。JSON 末尾的\n是给 ESP8266 的readStringUntil(\n)做分隔的不要省略。HAL_UART_Transmit最后一个参数 100 是超时毫秒数如果串口被占用超过 100ms 就放弃发送避免阻塞主循环。在主循环里调用Data_Report()前我用了一个自定义的延时函数HAL_Delay(2000)。DHT11 的采样周期要求不低于 1 秒连续高频读取会导致传感器不响应或返回校验错误2 秒间隔是安全值。4.3 下行指令处理属性设置与 OLED 显示联动下行数据分两类一类是服务调用比如远程下发命令另一类是属性设置比如修改采样间隔。在透传模式下STM32 在串口中断中把帧还原成 topic 和 payload再根据 topic 后缀判断类型// 串口接收中断回调缓存帧数据解析出 topic 和 payload void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { // 每收到一个字节就进入这里用状态机判断帧边界 static uint8_t rx_state 0; if (rx_state 0 rx_byte 0xAA) rx_state 1; // 帧头 else if (rx_state 1) { /* 接收 topic直到遇到 0x7C */ } else if (rx_state 2) { /* 接收 payload直到遇到 0xBB */ } }帧尾是 0xBB收到完整帧后先检查 topic 里是否含property/set如果是就把 payload 里的 JSON 解析出来。比如阿里云下发一个采样间隔设置的属性payload 是{SamplingInterval:5}STM32 解析后更新全局变量sampling_interval 5主循环的HAL_Delay参数跟着变。注意 JSON 解析别自己去写字符串查找函数用现成的 cJSON 库几行代码就能把字段取出来。下行链路最容易忽略的是设备收到属性设置后要回响应。阿里云平台规定设备收到属性设置后必须发布响应消息到/productKey/deviceName/user/update/reply内容包含{code:200, ...}否则平台会显示设备没有响应。ESP8266 侧的callback函数在转发下行数据给 STM32 时同时也应该在 MQTT 层面回复 ACK或者由 STM32 回复一个 JSON 后让 ESP8266 发布到 reply topic。我习惯在 ESP8266 的callback里直接发布 ACK这样 STM32 那边少一条串口逻辑。5. 上电不工作、连不上云、数据是乱码5 条踩坑记录与排错方法5.1 现象ESP8266-01S 上电后发烫、不响应几秒后模块重启原因01S 工作在电压陷阱里。它的供电要求是 3.3V但在 WiFi 连接瞬间电流可达 300mA如果 VCC 接的是 STM32 板载 3.3V 引脚压降会让模块进入欠压重启的循环。解决给 01S 用独立的 AMS1117-3.3 稳压模块供电输入端接 5V输出端并一个 470uF 电解电容和 0.1uF 陶瓷电容。CH_PD 和 GPIO2 分别接 10K 电阻到 3.3V。检查模块是否正常工作的最快捷方式是把 01S 的 TXD 悬空上电后看它是否有启动日志输出如果有乱码但能输出说明供电正常只是波特率不对。5.2 现象程序烧录成功但 ESP8266 一直无法连接 WiFi原因ESP8266-01S 板载天线需要净空区域如果模块紧贴着金属外壳或大面积接地铜箔WiFi 信号会衰减到无法连接。还有一个容易被忽略的因素是01S 的 GPIO2 在启动时如果被外部电路拉到低电平模块也会不进入正常运行模式。解决把模块用杜邦线悬空远离 STM32 的晶振和电源模块。GPIO2 的上拉电阻必须接到 3.3V而不是接在 STM32 的 GPIO 输出上。另外检查 WiFi 密码是否有特殊字符ESP8266 的 AT 固件对部分特殊字符需要转义但我们的自定义透传固件直接从代码里读字符串很少遇到这个问题。5.3 现象MQTT 连接总是超时日志显示 TLS 握手失败原因01S 的 1MB Flash 跑不动完整的 TLS 客户端如果你在 PubSubClient 里引入了 WiFiClientSecure编译可能通过但运行时握手会频繁重置。阿里云公共实例的 1883 端口并不是所有地域都开放明文部分新地域强制走 TLS。解决一是在阿里云控制台确认实例支持明文 MQTT接入点地址选择不带ssl的版本二是在 Arduino 代码里明确使用WiFiClient而不是WiFiClientSecure三是如果必须上 TLS就别用 01S换 ESP-12F 或直接上 ESP32这个项目不值得在 1MB Flash 上死磕加密。5.4 现象DHT11 数据偶发出现 -1 或 255OLED 显示异常原因DHT11 的时序非常敏感如果在读取期间恰好遇到串口中断或 I2C 操作占用总线脉冲宽度测量就会错乱。另一个原因是读取间隔小于 1 秒DHT11 会直接不响应。解决把读取间隔固定在 2 秒以上。读取之前先用__disable_irq()关闭全局中断读完 40 位数据后再__enable_irq()恢复。这个方法简单粗暴但对于 DHT11 这种低速传感器完全够用比引入定时器捕获要省事。5.5 现象OLED 显示乱码或只有英文能显示中文全是方块原因SSD1306 是纯图形显示没有内置中文字库OLED_ShowString 函数只能显示 ASCII 字符集。如果你直接把中文传给显示函数要么编译报错要么显示乱码。解决方案很多最省事的是 OLED 上只显示英文和数字比如Temp:25.1C、Humi:60%这样对数据展示完全够用。如果你必须在屏幕上显示温度两个字就需要用取模软件把中文字符转成 16×16 字节数组然后用画点函数把数组画上去这部分工作量不大但很繁琐我不建议在这个项目里专门做中文字库。6. 让项目从能跑变成能用离线缓存补传与远程改采样间隔项目跑通之后你会发现它只解决了一个问题数据能看到。但离能用还差两个能力断网时数据不丢以及不用改代码就能调整采样频率。离线缓存补传的思路是STM32 内部 Flash 有 64KB可以用最后一页存数据。每 10 分钟一条记录一条记录 8 字节4 字节温度、4 字节湿度Flash 一页 1KB 可以存 128 条。判断标准是ESP8266 通过一个状态引脚告诉 STM32 自己是否在线。// 在线状态检测引脚ESP8266 GPIO0 配置为输出联机后拉高 uint8_t Is_ESP8266_Online(void) { return HAL_GPIO_ReadPin(STATUS_GPIO_PORT, STATUS_PIN); } // 主循环里每 10 分钟采样一次离线时写入 Flash 缓存 void Data_Sample_And_Cache(void) { float temp, humi; DHT11_Read(humi, temp); if (Is_ESP8266_Online()) { Data_Report(temp, humi); // 检查 Flash 里是否有积压数据逐条补传 Flash_Retransmit_All(); } else { Flash_Append_Record(temp, humi); } }这个方案里有个细节补传不能堵住实时数据。我一般是先补传积压数据再上报当前数据补传过程加一个 50ms 间隔防止一下子发太多导致 ESP8266 串口缓冲区溢出。远程修改采样间隔的实现依赖阿里云的属性设置通道。在物模型里添加一个SamplingInterval属性类型 int取值范围 1~60。STM32 侧接收下行帧后解析出这个字段更新全局变量int sampling_interval 10; // 默认 10 秒采样一次 void Parse_SamplingInterval(char* payload) { // 用 cJSON 解析 {SamplingInterval:30} cJSON* root cJSON_Parse(payload); cJSON* item cJSON_GetObjectItem(root, SamplingInterval); if (item ! NULL item-type cJSON_Number) { if (item-valueint 1 item-valueint 60) { sampling_interval item-valueint; } } cJSON_Delete(root); }解析成功之后要发响应给平台否则控制台会一直显示设备没有应答。响应 topic 是/productKey/deviceName/user/update/reply消息体是{code:200,data:{}}。这里把采样间隔的取值范围限制在 1~60 秒是有原因的DHT11 最快 1 秒采一次再快数据也没有意义上限 60 秒是防止有人误设成 0 导致设备死循环。最后说一个我的习惯代码里所有阿里云接入点、三元组、WiFi 密码都不要硬编码在源码里而是放在一个独立的config.h文件并且把该文件加入.gitignore。我见过太多人在公开的项目仓库里泄露了自己的设备凭证然后被陌生人连上设备乱发指令。如果你确实要分享代码把三元组替换成YOUR_PRODUCT_KEY这种占位符。这套系统从传感器到云端的完整链路你已经都跑通了后面无论是加更多传感器、换 Esp32还是接入本地数据库都是在现有骨架上的扩展。希望这篇文章能帮你省掉我当初调试那些坑时花掉的几个通宵。本文还有配套的精品资源点击获取
简介一套基于STM32与ESP8266-01S的物联网温湿度采集方案通过Wi-Fi接入阿里云平台并将数据实时显示在OLED屏上适合正在学习STM32外设驱动、AT指令接入云平台的中高级嵌入式开发者。资源包共253个文件压缩后7.01MB以C语言源码和头文件为主体包含大量标准外设库驱动如定时器、串口、I2C等同时带有Keil工程配置文件、编译生成的hex固件以及中间文件便于直接打开工程查看或烧录验证。目前已有244人学习下载可作为完整参考项目。使用者可获得硬件初始化、传感器读取、OLED显示、ESP8266透传与阿里云物联网平台对接的整套代码并借助工程内模块划分快速定位所需功能适合在已有开发板基础上进行二次开发或移植。1. STM32ESP8266-01S阿里云温湿OLED这套组合在解决什么问题STM32ESP8266-01S阿里云温湿度传感器OLED这个组合最常见的出没场景是两类人一类是刚学完串口和 GPIO想做点能联网的硬件作品的开发者另一类是公司临时要一个环境监测 Demo要求三天内把温湿度数据弄到云上看板上的工程师。这套方案的价值在于它把本地采集和云端上报之间的所有环节都走通了传感器负责采集OLED 负责本地显示ESP8266-01S 负责联网阿里云物联网平台负责数据存储和远程查看。它适合作为你从单片机裸机开发跨向物联网端云一体开发的第一个完整项目因为每个环节都有标准答案但也都有各自的陷阱。很多人以为最难的是传感器驱动真正做完才发现最耗时间的反而是 ESP8266-01S 的固件选择、阿里云 MQTT 的参数计算以及这三者之间的串口帧协议。这篇文章按我实际做过的顺序来讲先硬件选型和接线再打通网络链路接着配置阿里云最后把 STM32 代码串起来并单独整理一份踩坑清单。2. 硬件怎么选、怎么接六个元件一小时内焊好但线序别想当然2.1 主控与模块选型F103C8T6、ESP8266-01S、DHT11 与 OLED 的取舍主控我推荐 STM32F103C8T6也就是大家常说的蓝板。理由不是它性能多强而是它的资料密度极高、CubeMX 配置简单、串口资源够用而且 3.3V 逻辑电平与 ESP8266-01S 直接兼容不需要电平转换。如果你手上的是 5V 的 Arduino UNO那反而要加电平转换线路会复杂不少。ESP8266-01S 是这个标题里最容易翻车的硬件。它只有 1MB Flash比常见的 ESP-12F 少了整整一半而且只有 GPIO0 和 GPIO2 两个可用引脚。这意味着你没法在它上面跑完整的 MQTTTLS 客户端后面刷固件时会有很多限制。但正因为它便宜、引脚少、适合做纯透传才值得在这个项目里讲清楚怎么用。温湿度传感器选 DHT11 还是 DHT22取决于你对精度的要求。DHT11 精度是 ±2℃湿度 ±5%RH采样周期最低 1 秒一次DHT22 精度更高但贵三倍。对看个大概的 Demo 来说 DHT11 够了我下面的代码也按 DHT11 写。OLED 选 0.96 寸 I2C 接口的 SSD1306128×64 分辨率四根线就能驱动。I2C 版本比 SPI 版本少四根线省下的 GPIO 刚好拿去接 DHT11。2.2 接线表与供电设计3.3V/5V 混接的坑GPIO2 与 CH_PD 的上拉接线看起来简单但 ESP8266-01S 的供电和使能引脚有讲究。VCC 和 GND 不能直接从 STM32 的 3.3V 引脚取因为 01S 在 WiFi 发射瞬间电流能冲到 300mASTM32 板载稳压芯片扛不住这种瞬态压降表现就是模块随机重启、AT 响应时好时坏。我一般用独立的 AMS1117-3.3 稳压模块输入接 5V输出单独给 01S 供电。模块引脚接 STM32说明ESP8266-01SVCC独立 3.3V 电源不要接板载 3.3V 引脚ESP8266-01SGNDGND与 STM32 共地ESP8266-01SCH_PD3.3V串 10K 电阻使能脚必须拉高ESP8266-01SGPIO23.3V串 10K 电阻启动时必须是高电平ESP8266-01SRXDSTM32 PA9TX串口交叉连接ESP8266-01STXDSTM32 PA10RX串口交叉连接DHT11DATAPA0需外接 4.7K 上拉电阻OLEDSCLPB6I2C 时钟OLEDSDAPB7I2C 数据RXD 和 TXD 建议各串一个 1K 电阻再接到 STM32。01S 的 IO 不是 5V 容忍的虽然大多数情况下直接连也能工作但串个电阻能防止 STM32 的 5V 电平灌进去烧掉模块这是我踩过一次的教训。CH_PD 和 GPIO2 的上拉电阻不要省GPIO2 在模块启动瞬间必须是高电平否则模块会进入烧录模式表现就是上电后没有任何响应。2.3 先让 OLED 和 DHT11 在本地跑起来最小验证代码在联网之前先把本地采集和显示跑通。DHT11 是单总线协议STM32 用普通 GPIO 模拟时序就行。核心是读 40 位数据前 16 位是湿度后 16 位是温度最后 8 位是校验和。// DHT11 读取函数HAL库返回 0 成功-1 失败 uint8_t DHT11_Read(float *humidity, float *temperature) { uint8_t data[5] {0}; // 主机拉低 18ms 再释放触发传感器响应 HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_RESET); HAL_Delay(20); HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_SET); // 等待传感器拉低应答信号超时 40us 则退出 uint32_t timeout 40; while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_SET) { if (--timeout 0) return -1; } // 读取 40 位数据每位用高低电平宽度判断 0 或 1 for (int i 0; i 40; i) { while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_RESET); uint32_t width 0; while (HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN) GPIO_PIN_SET) { width; HAL_Delay(1); // 注意这里用延时累加判断位宽 if (width 70) break; // 超时保护 } if (width 40) data[i / 8] | (0x80 (i % 8)); } if ((data[0] data[1] data[2] data[3]) ! data[4]) return -1; *humidity data[0] data[1] / 10.0f; *temperature data[2] data[3] / 10.0f; return 0; }这段代码里HAL_Delay(1)在 while 循环中用来做粗略计时代码逻辑依赖循环次数判断 0 和 1 的位宽。实际工程中更严谨的做法是用定时器捕获模式测量脉冲宽度但对 DHT11 这种低速传感器上面的方式已经足够稳定。需要调整的是width 40这个阈值如果你把系统时钟从 72MHz 改成其他频率循环每次耗时不一样这个阈值要重新标定。OLED 这边用软件模拟 I2C 或硬件 I2C 都行。SSD1306 的初始化序列是固定套路开电源、关闭显示、设置时钟分频、设置 multiplex 比例、清屏、打开显示。初始化完成之后把 DHT11 读到的温度和湿度用sprintf格式化OLED_ShowString(0, 0, Temp: 25.1C)显示即可。3. 给 ESP8266-01S 刷一个能干活的固件透传程序的编译与烧录3.1 为什么不用 AT 指令直接上云01S 的 Flash 和 AT 固件不支持 MQTT/TLS最直觉的做法是给 01S 刷官方 AT 固件然后 STM32 通过串口发ATCWJAP连接 WiFi再用ATMQTTCONN连接阿里云。但这里有两个现实问题。第一01S 的 1MB Flash 装不下新版 AT 固件新版 AT 需要 2MB 起步你硬刷的结果是模块变砖。第二即使找到了老版本 AT 固件它里面也没有 MQTT 指令。那用 AT 指令建 TCP 连接让 STM32 自己封装 MQTT 报文行不行理论可行但 MQTT CONNECT 报文要算剩余长度、要拼接用户名密码对新手来说一个星期都调不通。所以更可靠的方案是用 Arduino IDE 给 01S 烧一个我们自己写的透传程序把 WiFi 连接和 MQTT 协议都封装在 ESP8266 侧STM32 只需要通过串口发送一段简单的 JSON 字符串ESP8266 收到后直接发布到阿里云。3.2 Arduino 里写 ESP8266-01S 透传程序编译、烧录、串口确认用 Arduino IDE 开发 ESP8266-01S 需要先安装 ESP8266 开发板支持包然后在开发板列表选择 Generic ESP8266 ModuleFlash Size 选 1MB波特率用 115200。下面是一个可用的透传程序#include ESP8266WiFi.h #include PubSubClient.h // 阿里云设备三元组 const char* ssid your_wifi_ssid; const char* password your_wifi_password; const char* mqtt_server productKey.iot-as-mqtt.cn-shanghai.aliyuncs.com; const char* clientId productKey.deviceName|securemode3,signmethodhmacsha1,timestamp789| const char* username deviceNameproductKey; const char* mqtt_password HMAC-SHA1签名结果; WiFiClient espClient; PubSubClient client(espClient); String lastPayload ; void callback(char* topic, byte* payload, unsigned int length) { // 收到下行消息时原样转发给 STM32帧头 0xAA 帧尾 0xBB Serial.write(0xAA); Serial.print(topic); Serial.write(0x7C); Serial.write(payload, length); Serial.write(0xBB); } void setup() { Serial.begin(115200); // 与 STM32 串口通信 WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) delay(500); client.setServer(mqtt_server, 1883); client.setCallback(callback); } void loop() { if (!client.connected()) { client.connect(clientId, username, mqtt_password); client.subscribe(/productKey/deviceName/user/get); } // 从 STM32 收到待上报数据按帧解析后发布 while (Serial.available()) { String payload Serial.readStringUntil(\n); client.publish(/productKey/deviceName/user/update, payload.c_str()); } client.loop(); }需要特别注意clientId的拼接格式。阿里云 MQTT 连接要求 clientId 是产品或设备信息加签名参数username 是deviceNameproductKeypassword 是三元组中 deviceSecret 参与的 HMAC-SHA1 签名结果。很多新手在这里栽跟头以为 password 直接填 deviceSecret结果一直报校验失败。正确做法是在阿里云控制台的设备详情页用官方工具生成签名把生成的连接参数填进代码里。这里用 1883 明文端口就是为了让 01S 的 1MB Flash 能跑得动。如果强制要求 TLS 加密PubSubClient 换成 WiFiClientSecure 后固件体积会涨到 900KB 以上01S 编译都编不过。对于 Demo 项目明文端口在隔离的局域网测试环境里是可接受的。3.3 透传帧协议设计STM32 和 ESP8266 之间怎么约定数据ESP8266 和 STM32 之间的串口协议不要设计得太复杂。上行数据STM32 → ESP8266用一行字符串以换行符结尾内容就是一个完整的 JSONESP8266 收到后原样发布到user/update这个 topic。下行数据ESP8266 → STM32用帧头 0xAA、帧尾 0xBB 包裹中间用 0x7C 分隔主题和消息体这样 STM32 在串口中断里判断帧头帧尾就能完整取出数据不会跟上行数据的 JSON 字符串混淆。这个协议有个隐含的好处STM32 不需要理解 MQTT 协议它只处理字符串和帧。以后想把平台从阿里云换成其他云只需要改 ESP8266 那侧的程序STM32 代码完全不用动。这就是分层设计在物联网小项目里的实战价值。4. 阿里云平台配置与 STM32 端数据链路打通4.1 创建产品、设备拿到三元组公共实例下的最小配置在阿里云物联网平台控制台开通公共实例后先创建产品产品名称随意节点类型选设备连网方式选 WiFi数据格式选阿里云 IoT 物模型因为物模型帮你自动生成标准 JSON 格式。创建完产品之后在产品详情里添加两个属性Temperaturefloat 类型和 Humidityfloat 类型读写类型选只读。然后添加设备设备名称建议用节点编号比如dev_01。添加完成后进入设备详情页能看到 ProductKey、DeviceName、DeviceSecret 三元组。这三组字符串是设备和云平台之间的唯一身份凭证后面 MQTT 连接参数的 clientId、username、password 全部由它们派生。千万别把 DeviceSecret 明文写在 ESP8266 代码里再传到 GitHub 上这是很多人在公开项目里泄露设备凭证的原因。物模型数据格式和 MQTT topic 的对应关系也需要理清。设备上报物模型属性发布消息到/productKey/deviceName/user/update消息体是一个 JSON参数里带上属性名和值{params:{Temperature:25.1,Humidity:60.5},version:1.0}4.2 STM32 端代码温湿度采集、JSON 封装、串口发送、OLED 刷新STM32 侧的逻辑很简单每两秒读一次 DHT11把温湿度拼成 JSON通过串口发给 ESP8266然后把同样的数据显示在 OLED 上。重点看 JSON 封装和串口发送的写法void Data_Report(void) { float temp 0, humi 0; // DHT11 读取失败则重试 2 次防止偶发错误导致稳定的数据中断 int ret DHT11_Read(humi, temp); if (ret ! 0) { DHT11_Read(humi, temp); } // 拼接物模型 JSON注意小数点位和转义字符 char payload[128]; snprintf(payload, sizeof(payload), {\params\:{\Temperature\:%.1f,\Humidity\:%.1f},\version\:\1.0\}\n, temp, humi); // 通过串口1发送给 ESP8266-01S HAL_UART_Transmit(huart1, (uint8_t*)payload, strlen(payload), 100); // OLED 双行显示温度一行湿度一行 char line1[20]; snprintf(line1, sizeof(line1), Temp:%.1fC, temp); OLED_ShowString(0, 0, line1); char line2[20]; snprintf(line2, sizeof(line2), Humi:%.1f%%, humi); OLED_ShowString(0, 3, line2); }snprintf的格式串里%.1f表示保留一位小数因为 DHT11 本身精度就不高显示多位小数是自欺欺人。JSON 末尾的\n是给 ESP8266 的readStringUntil(\n)做分隔的不要省略。HAL_UART_Transmit最后一个参数 100 是超时毫秒数如果串口被占用超过 100ms 就放弃发送避免阻塞主循环。在主循环里调用Data_Report()前我用了一个自定义的延时函数HAL_Delay(2000)。DHT11 的采样周期要求不低于 1 秒连续高频读取会导致传感器不响应或返回校验错误2 秒间隔是安全值。4.3 下行指令处理属性设置与 OLED 显示联动下行数据分两类一类是服务调用比如远程下发命令另一类是属性设置比如修改采样间隔。在透传模式下STM32 在串口中断中把帧还原成 topic 和 payload再根据 topic 后缀判断类型// 串口接收中断回调缓存帧数据解析出 topic 和 payload void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { // 每收到一个字节就进入这里用状态机判断帧边界 static uint8_t rx_state 0; if (rx_state 0 rx_byte 0xAA) rx_state 1; // 帧头 else if (rx_state 1) { /* 接收 topic直到遇到 0x7C */ } else if (rx_state 2) { /* 接收 payload直到遇到 0xBB */ } }帧尾是 0xBB收到完整帧后先检查 topic 里是否含property/set如果是就把 payload 里的 JSON 解析出来。比如阿里云下发一个采样间隔设置的属性payload 是{SamplingInterval:5}STM32 解析后更新全局变量sampling_interval 5主循环的HAL_Delay参数跟着变。注意 JSON 解析别自己去写字符串查找函数用现成的 cJSON 库几行代码就能把字段取出来。下行链路最容易忽略的是设备收到属性设置后要回响应。阿里云平台规定设备收到属性设置后必须发布响应消息到/productKey/deviceName/user/update/reply内容包含{code:200, ...}否则平台会显示设备没有响应。ESP8266 侧的callback函数在转发下行数据给 STM32 时同时也应该在 MQTT 层面回复 ACK或者由 STM32 回复一个 JSON 后让 ESP8266 发布到 reply topic。我习惯在 ESP8266 的callback里直接发布 ACK这样 STM32 那边少一条串口逻辑。5. 上电不工作、连不上云、数据是乱码5 条踩坑记录与排错方法5.1 现象ESP8266-01S 上电后发烫、不响应几秒后模块重启原因01S 工作在电压陷阱里。它的供电要求是 3.3V但在 WiFi 连接瞬间电流可达 300mA如果 VCC 接的是 STM32 板载 3.3V 引脚压降会让模块进入欠压重启的循环。解决给 01S 用独立的 AMS1117-3.3 稳压模块供电输入端接 5V输出端并一个 470uF 电解电容和 0.1uF 陶瓷电容。CH_PD 和 GPIO2 分别接 10K 电阻到 3.3V。检查模块是否正常工作的最快捷方式是把 01S 的 TXD 悬空上电后看它是否有启动日志输出如果有乱码但能输出说明供电正常只是波特率不对。5.2 现象程序烧录成功但 ESP8266 一直无法连接 WiFi原因ESP8266-01S 板载天线需要净空区域如果模块紧贴着金属外壳或大面积接地铜箔WiFi 信号会衰减到无法连接。还有一个容易被忽略的因素是01S 的 GPIO2 在启动时如果被外部电路拉到低电平模块也会不进入正常运行模式。解决把模块用杜邦线悬空远离 STM32 的晶振和电源模块。GPIO2 的上拉电阻必须接到 3.3V而不是接在 STM32 的 GPIO 输出上。另外检查 WiFi 密码是否有特殊字符ESP8266 的 AT 固件对部分特殊字符需要转义但我们的自定义透传固件直接从代码里读字符串很少遇到这个问题。5.3 现象MQTT 连接总是超时日志显示 TLS 握手失败原因01S 的 1MB Flash 跑不动完整的 TLS 客户端如果你在 PubSubClient 里引入了 WiFiClientSecure编译可能通过但运行时握手会频繁重置。阿里云公共实例的 1883 端口并不是所有地域都开放明文部分新地域强制走 TLS。解决一是在阿里云控制台确认实例支持明文 MQTT接入点地址选择不带ssl的版本二是在 Arduino 代码里明确使用WiFiClient而不是WiFiClientSecure三是如果必须上 TLS就别用 01S换 ESP-12F 或直接上 ESP32这个项目不值得在 1MB Flash 上死磕加密。5.4 现象DHT11 数据偶发出现 -1 或 255OLED 显示异常原因DHT11 的时序非常敏感如果在读取期间恰好遇到串口中断或 I2C 操作占用总线脉冲宽度测量就会错乱。另一个原因是读取间隔小于 1 秒DHT11 会直接不响应。解决把读取间隔固定在 2 秒以上。读取之前先用__disable_irq()关闭全局中断读完 40 位数据后再__enable_irq()恢复。这个方法简单粗暴但对于 DHT11 这种低速传感器完全够用比引入定时器捕获要省事。5.5 现象OLED 显示乱码或只有英文能显示中文全是方块原因SSD1306 是纯图形显示没有内置中文字库OLED_ShowString 函数只能显示 ASCII 字符集。如果你直接把中文传给显示函数要么编译报错要么显示乱码。解决方案很多最省事的是 OLED 上只显示英文和数字比如Temp:25.1C、Humi:60%这样对数据展示完全够用。如果你必须在屏幕上显示温度两个字就需要用取模软件把中文字符转成 16×16 字节数组然后用画点函数把数组画上去这部分工作量不大但很繁琐我不建议在这个项目里专门做中文字库。6. 让项目从能跑变成能用离线缓存补传与远程改采样间隔项目跑通之后你会发现它只解决了一个问题数据能看到。但离能用还差两个能力断网时数据不丢以及不用改代码就能调整采样频率。离线缓存补传的思路是STM32 内部 Flash 有 64KB可以用最后一页存数据。每 10 分钟一条记录一条记录 8 字节4 字节温度、4 字节湿度Flash 一页 1KB 可以存 128 条。判断标准是ESP8266 通过一个状态引脚告诉 STM32 自己是否在线。// 在线状态检测引脚ESP8266 GPIO0 配置为输出联机后拉高 uint8_t Is_ESP8266_Online(void) { return HAL_GPIO_ReadPin(STATUS_GPIO_PORT, STATUS_PIN); } // 主循环里每 10 分钟采样一次离线时写入 Flash 缓存 void Data_Sample_And_Cache(void) { float temp, humi; DHT11_Read(humi, temp); if (Is_ESP8266_Online()) { Data_Report(temp, humi); // 检查 Flash 里是否有积压数据逐条补传 Flash_Retransmit_All(); } else { Flash_Append_Record(temp, humi); } }这个方案里有个细节补传不能堵住实时数据。我一般是先补传积压数据再上报当前数据补传过程加一个 50ms 间隔防止一下子发太多导致 ESP8266 串口缓冲区溢出。远程修改采样间隔的实现依赖阿里云的属性设置通道。在物模型里添加一个SamplingInterval属性类型 int取值范围 1~60。STM32 侧接收下行帧后解析出这个字段更新全局变量int sampling_interval 10; // 默认 10 秒采样一次 void Parse_SamplingInterval(char* payload) { // 用 cJSON 解析 {SamplingInterval:30} cJSON* root cJSON_Parse(payload); cJSON* item cJSON_GetObjectItem(root, SamplingInterval); if (item ! NULL item-type cJSON_Number) { if (item-valueint 1 item-valueint 60) { sampling_interval item-valueint; } } cJSON_Delete(root); }解析成功之后要发响应给平台否则控制台会一直显示设备没有应答。响应 topic 是/productKey/deviceName/user/update/reply消息体是{code:200,data:{}}。这里把采样间隔的取值范围限制在 1~60 秒是有原因的DHT11 最快 1 秒采一次再快数据也没有意义上限 60 秒是防止有人误设成 0 导致设备死循环。最后说一个我的习惯代码里所有阿里云接入点、三元组、WiFi 密码都不要硬编码在源码里而是放在一个独立的config.h文件并且把该文件加入.gitignore。我见过太多人在公开的项目仓库里泄露了自己的设备凭证然后被陌生人连上设备乱发指令。如果你确实要分享代码把三元组替换成YOUR_PRODUCT_KEY这种占位符。这套系统从传感器到云端的完整链路你已经都跑通了后面无论是加更多传感器、换 Esp32还是接入本地数据库都是在现有骨架上的扩展。希望这篇文章能帮你省掉我当初调试那些坑时花掉的几个通宵。本文还有配套的精品资源点击获取
