ESP8266 Web 配网结合 MQTT 与 STM32 串口透传方案

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 主题订阅 / 发布
• 接入阿里云 / 腾讯云等物联网平台
• 增加配置加密存储，提升安全性