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. 完整功能清单

三、核心功能演示

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 指令，兼顾调试效率与工程化应用：

1. 核心通信机制：
   • 设备默认订阅主题 device/sensor_01，响应主题 sensor_01/response，状态上报主题 sensor_01/status，三主题分离设计，避免指令与状态消息混叠；
   • 接入时自动配置遗嘱消息（Will Message），设备离线时会向状态主题推送 offline 状态，上线则推送 online 状态，保障服务端能实时感知设备在线状态；
   • 支持 60 秒定时心跳上报，包含设备 IP、WiFi 信号强度、剩余内存等核心状态，便于远程监控设备健康度。
2. 双格式指令支持：
   • 文本指令（快速调试）：直接发送 status（查状态）、test（发测试数据）、clear_wifi（清 WiFi 配置）等指令，设备自动返回执行结果；
   • JSON 指令（工程化调用）：支持结构化指令如 {"cmd":"reconfig_wifi"}，可远程修改 WiFi 配置，且保留 MQTT 原有配置不丢失；
   • 单片机数据上传：无需封装 MQTT 协议，只需按 <DATA,TEMP:25.5,HUMI:60> 格式通过串口发数据，ESP8266 会自动封装为 JSON 并上传至 MQTT 服务器。
3. 高可用设计：
   • MQTT 断开后自动重连（10 秒重试一次），重连成功后自动恢复订阅与状态上报；
   • 配置持久化存储，即使设备重启，MQTT 服务器地址、端口、主题等配置也不会丢失，无需重新配置。

（2）连接机制（含遗嘱消息）

手机端APP也可通信，此界面为手机调试软件

四、部署与使用说明

1. 硬件要求

• ESP8266 开发板（ESP12F / ESP-01 等）
• USB 数据线
• 串口调试工具（可选）

2. 软件环境

• Arduino IDE（安装 ESP8266 开发板支持）
• 依赖库：ESP8266WiFi、ESP8266WebServer、PubSubClient、ArduinoJson

3. 使用流程

1. 首次配置：
   • 烧录代码后，设备启动 AP 模式
   • 手机连接该 AP，访问 http://192.168.4.1
   • 选择 WiFi 并输入密码
   • 输入MQTT服务配置（开发者选项），完成配置
2. 更换 WiFi：
   • 串口发送 clearwifi 命令（或 Web 页面重置 WiFi）
   • 设备自动进入 AP 模式，重新配置 WiFi 即可（MQTT 配置保留）
3. 远程控制：
   • MQTT 发送文本指令：status（查看状态）、test（测试数据）
   • MQTT 发送 JSON 指令：{"cmd":"set_wifi","ssid":"新WiFi","password":"密码"}

     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 物联网开发的小伙伴，也欢迎大家在评论区交流优化建议！

如果你觉得这篇文章有帮助，欢迎点赞、收藏、关注！后续会继续分享物联网开发的实战经验。