ESP8266 Web配网+MQTT+STM32串口上云+免AT指令

优质文章学习记录

07 Apr 2026 — 8 min read

本文详细讲解 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":"密码"}

4.常用命令，部分可自行探索:

五、项目总结与扩展方向

1. 项目价值

解决实际痛点：WiFi/MQTT 配置分离，解决频繁配网的问题
降低使用门槛：Web 可视化配置，非专业人员也能操作
提升调试效率：串口 + MQTT+Web 三重调试方式，适配不同场景

2. 扩展方向

增加 OTA 远程升级功能
支持多个 MQTT 主题订阅 / 发布
接入阿里云 / 腾讯云等物联网平台
增加配置加密存储，提升安全性