ESP8266 Web配网+MQTT+STM32串口上云+免AT指令
本文详细讲解 ESP8266/ESP12F Web 配网、MQTT 通信、STM32/Arduino 串口透传一体化实现方案WiFi强制入户，连接自动打开网页配置，核心亮点是单片机免 ESP8266 AT 指令，串口直接上云，通过串口向 ESP8266 发送数据即可自动上传至 MQTT 服务器，固件开源可直接用于学习调试。
固件下载：
通过网盘分享的文件：mqtt_usart_wifi.ino.bin
链接: https://pan.baidu.com/s/1mZt5diatyYvnSZ-N1eF75w?pwd=e8we 提取码: e8we
免AT指令全网首发！数据直接上传MQTT、秒下发指令，无需复杂配置！下载固件即可使用
一、项目背景与开发初衷
在物联网设备开发过程中，配网和远程通信是两个核心痛点：传统的 AT 指令配网操作复杂，且多数方案在更换 WiFi 时会丢失 MQTT 配置；串口调试和 MQTT 远程控制无法兼顾；设备配置管理缺乏可视化界面。针对这些问题，我基于 ESP8266 / ESP12F 开发了一套集 Web 配网、串口调试、MQTT 远程控制于一体的智能设备管理系统，核心亮点是Web端支持只更改 WiFi 且保留 MQTT 配置、STM32串口与MQTT调试及控制一体，直接配网、直接发送数据使用，没有复杂指令，大幅提升设备运维效率。
二、功能亮点
1. 差异化核心特性
- WiFi/MQTT 配置分离：更换 WiFi 时自动保留 MQTT 服务器、主题等配置，无需重复设置、WiFi自动连接、断连重启。
- 多端控制体系：Web 可视化配置 + 串口命令调试 + MQTT 远程控制三重操作方式；Web端保存WiFi配置，串口可与STM32、Arduino等单片机连接，MQTT与云端、APP等实现远程控制
- 安全的配置管理：支持分维度重置（仅 WiFi / 仅 MQTT / 完全重置），操作前需确认，防止误操作
- 状态可视化：Web 页面展示设备、WiFi、MQTT 连接状态，信号强度等关键信息；串口和MQTT通信实时打印显示信息及help帮助
2. 完整功能清单
| 功能模块 | 具体能力 |
|---|---|
| Web 配网 | 扫描 WiFi 列表、手动输入 SSID、MQTT 配置（开发者模式）、设备状态展示、配置重置 |
| 串口通信 | 基础命令（help/status/test 等）、存储管理（eeprom/clear 等）、STM32 数据解析 |
| MQTT 通信 | 文本 / JSON 格式指令、状态上报、遗嘱消息、定时心跳、远程配置 WiFi |
| 存储管理 | EEPROM 分字段读写、配置备份、出厂设置恢复 |
三、核心功能演示
1.Web 配网及功能介绍
本人专注嵌入式方向，对 Web 开发涉猎不多，界面设计较为朴素，但功能完整，可直接使用。
WiFi连接配置：
连接 “ ESP8266设备配置 ” WiFi，自动打开页面（部分手机需要浏览器手动输入192.168.4.1），保存相关配置即可连接。
设备重置功能：
- 完全重置(清除所有配置)：清除WiFi和MQTT配置，恢复到出厂状态
- 仅重置WIFI配置：只清除WiFi配置，保留MQTT设置
- 仅重置MQTT配置：只清除MQTT配置，保留WiFi设置
2.串口通信及调试（可连接STM32 / Arduino等单片机）
该交互界面支持串口指令快速调试：向 ESP8266 发送 help 指令即可打印完整的命令帮助手册，发送对应指令后设备会自动返回执行结果。核心优势在于：单片机无需依赖 AT 指令，只需通过串口向 ESP8266 发送标准化格式数据（如 <DATA,TEMP:25.5,HUMI:60>），即可自动上传至已配置的 MQTT 服务器，大幅简化了嵌入式设备的网络通信开发流程。
3.MQTT通信体系
（1）MQTT 通信体系：文本 + JSON 双格式指令，适配不同场景
本系统的 MQTT 通信模块做了深度优化，既支持轻量化的文本指令，也兼容标准化的 JSON 指令，兼顾调试效率与工程化应用：
- 核心通信机制：
- 设备默认订阅主题
device/sensor_01，响应主题sensor_01/response，状态上报主题sensor_01/status，三主题分离设计，避免指令与状态消息混叠； - 接入时自动配置遗嘱消息（Will Message），设备离线时会向状态主题推送
offline状态，上线则推送online状态，保障服务端能实时感知设备在线状态； - 支持 60 秒定时心跳上报，包含设备 IP、WiFi 信号强度、剩余内存等核心状态，便于远程监控设备健康度。
- 设备默认订阅主题
- 双格式指令支持：
- 文本指令（快速调试）：直接发送
status（查状态）、test（发测试数据）、clear_wifi（清 WiFi 配置）等指令，设备自动返回执行结果； - JSON 指令（工程化调用）：支持结构化指令如 {"cmd":"reconfig_wifi"}，可远程修改 WiFi 配置，且保留 MQTT 原有配置不丢失；
- 单片机数据上传：无需封装 MQTT 协议，只需按
<DATA,TEMP:25.5,HUMI:60>格式通过串口发数据，ESP8266 会自动封装为 JSON 并上传至 MQTT 服务器。
- 文本指令（快速调试）：直接发送
- 高可用设计：
- MQTT 断开后自动重连（10 秒重试一次），重连成功后自动恢复订阅与状态上报；
- 配置持久化存储，即使设备重启，MQTT 服务器地址、端口、主题等配置也不会丢失，无需重新配置。
（2）连接机制（含遗嘱消息）
手机端APP也可通信，此界面为手机调试软件
四、部署与使用说明
1. 硬件要求
- ESP8266 开发板（ESP12F / ESP-01 等）
- USB 数据线
- 串口调试工具（可选）
2. 软件环境
- Arduino IDE（安装 ESP8266 开发板支持）
- 依赖库：ESP8266WiFi、ESP8266WebServer、PubSubClient、ArduinoJson
3. 使用流程
- 首次配置：
- 烧录代码后，设备启动 AP 模式
- 手机连接该 AP，访问 http://192.168.4.1
- 选择 WiFi 并输入密码
- 输入MQTT服务配置（开发者选项），完成配置
- 更换 WiFi：
- 串口发送
clearwifi命令（或 Web 页面重置 WiFi） - 设备自动进入 AP 模式，重新配置 WiFi 即可（MQTT 配置保留）
- 串口发送
- 远程控制：
- MQTT 发送文本指令：
status（查看状态）、test（测试数据） - MQTT 发送 JSON 指令：
{"cmd":"set_wifi","ssid":"新WiFi","password":"密码"}
- MQTT 发送文本指令：
4.常用命令，部分可自行探索:
五、项目总结与扩展方向
1. 项目价值
- 解决实际痛点：WiFi/MQTT 配置分离，解决频繁配网的问题
- 降低使用门槛：Web 可视化配置，非专业人员也能操作
- 提升调试效率：串口 + MQTT+Web 三重调试方式，适配不同场景
2. 扩展方向
- 增加 OTA 远程升级功能
- 支持多个 MQTT 主题订阅 / 发布
- 接入阿里云 / 腾讯云等物联网平台
- 增加配置加密存储，提升安全性
固件下载：
通过网盘分享的文件：mqtt_usart_wifi.ino.bin
链接: https://pan.baidu.com/s/1mZt5diatyYvnSZ-N1eF75w?pwd=e8we 提取码: e8we
这是我第一次完整开发并开源物联网设备配网系统，整个过程中踩了不少坑：从最初的配置丢失问题，到 MQTT 连接稳定性优化，再到 Web 界面的用户体验调整。核心的 "WiFi/MQTT 配置分离" 设计，是解决实际使用中频繁配网的关键。希望这篇文章能帮助到同样在做 ESP8266 物联网开发的小伙伴，也欢迎大家在评论区交流优化建议！
如果你觉得这篇文章有帮助，欢迎点赞、收藏、关注！后续会继续分享物联网开发的实战经验。
