📡 ESP32-S3 双模远控终端 · 完整使用手册
版本： V1.0 | 适用对象： 设备使用者 / DIY 硬件玩家
一、产品简介
本设备是一款集 4G 模块 与 WiFi 双模控制、本地物理控制、历史记录存储（SD卡黑匣子） 于一体的物联网远程控制终端。
- 远程控制：用户可通过手机 MQTT 软件远程控制继电器开关。
- 物理应急：在无网络环境下，可通过外接实体按键手动操作。
- 状态反馈：设备自带 RGB 状态指示灯，实时反馈当前运行模式。
- 数据记录：内置 SD 卡槽，可记录每一次设备开关的状态与运行时间。
二、硬件接口与接线说明
请对照您的 ESP32-S3 开发板丝印，按下表连接杜邦线：
| 外接模块名称 | ESP32-S3 引脚 | 接线说明 / 注意事项 |
|---|
| 4G 模块 TX | GPIO 16 | 模块发数据给 ESP32（交叉接线） |
| 4G 模块 RX | GPIO 17 | ESP32 发数据给模块（交叉接线） |
| 继电器控制端 | GPIO 5 | 输出高电平触发继电器吸合 |
| 配网拨动开关 | GPIO 4 + GND | 开关一端接 4，另一端接 GND（闭合进入配网） |
| 手动控制按键 | GPIO 0 + GND | 按键一端接 0，另一端接 GND（按一下切换开关） |
| SD 卡 CS / MOSI / MISO / SCK | GPIO 10 / 11 / 13 / 12 | SPI 总线通信，3.3V 供电 |
⚠️ 关键防坑提醒：
1. 4G 模块必须独立 5V/2A 供电，切勿使用 ESP32 板载引脚给 4G 模块供电，否则会烧毁 ESP32！
2. 所有模块（ESP32、4G模块、SD卡）的 GND（地线）必须全部连在一起，否则无法通讯。
三、指示灯状态说明
设备内置了直观的板载 RGB 彩灯，无需连电脑即可了解当前状况：
红色常亮： 配网/调试模式。已开启 远控调试wifi 热点，正在等待手机连接。
绿色常亮： WiFi 正常模式。已成功连上配置好的家庭/商用 Wi-Fi。
蓝色常亮： 4G 模块正常模式。已成功连接 4G 网络并初始化 MQTT 服务器。
白色闪烁： 正在保存配置。在网页点击“保存并重启”后，系统正在写入内存并重启，闪烁 3-4 次后灯会熄灭。
四、首次使用与网络配置
⚠️ 非常注意：请务必严格按照此顺序操作！
- 准备阶段：设备处于 断电 状态。请将 GPIO 4 的配网拨动开关拨到 【闭合（短接）】 状态。
- 上电：给设备通电（插上 5V USB 电源），此时指示灯亮起 【红灯】。
- 手机连接：打开手机 WiFi 设置，搜索并连接名为
远控调试wifi 的 WiFi，密码为 12345678。
- 打开配置网页：打开手机自带浏览器，在地址栏输入
192.168.4.1。
- 填写参数：在网页中选择【4G模块】或【WiFi】，填入相应的服务器地址、订阅主题、WiFi 密码（如选 WiFi 模式），并勾选“开启记录状态到SD卡”。
- 保存并重启：点击网页底部的 【保存并重启】 按钮。
- 等待重启：此时您会看到指示灯开始 【闪白灯】。等待白灯闪烁结束，设备会自动重启。
- 观察状态：设备重启后，如果配置了 WiFi 会亮 【绿灯】，配置了 4G 会亮 【蓝灯】。
- 断开开关：看到绿灯或蓝灯亮起后，请将 GPIO 4 的拨动开关拨回【断开】状态。至此，配网正式完成！
五、日常使用与日志读取
- 远程控制（手机 APP）：在手机 MQTT 客户端中，向您配置的主题发送
ON 开启继电器，发送 OFF 关闭继电器。
- 物理控制（应急）：无需联网，直接按下 GPIO 0 的实体按键，继电器状态立刻翻转（开变关，关变开），并自动记录日志。
- 读取 SD 卡日志（U盘直读）：
- 设备保持 通电运行 状态。
- 用一根 可传输数据的 USB 线，将电脑插在 ESP32-S3 开发板的 右侧 Type-C 接口 上。
- 电脑会立刻弹出一个 U 盘，里面的
log.txt 记录了所有操作。
- 拔掉数据线，设备继续正常运行。
六、恢复出厂默认设置
如果您忘记了密码，或者设备网络异常，可以一键重置：
- 设备通电，手机连上
远控调试wifi。
- 浏览器打开
192.168.4.1 进入配置页。
- 点击底部的 【恢复出厂默认设置】 按钮。
- 设备将会清除所有保存的账号密码，重启后需按【第四项】的流程重新配网。
七、常见问题排查（Q&A）
- Q：通电后指示灯不亮，或一直是红灯连不上手机？
A：请检查 Type-C 供电线是否插紧，以及 GPIO 4 的开关是否处于【闭合】状态。如果没闭合，设备不会开启配网热点。
- Q：保存参数后，设备灯灭了，但再也亮不起来了怎么办？
A：请拔下电源线，确认 GPIO 4 的拨动开关已断开，重新插上电源。如果没反应，按下 ESP32 板上的 RST 复位键。
- Q：按了 GPIO 0 按键，继电器没反应？
A：检查 GPIO 0 接线是否牢固，按键是否发生物理损坏。按键操作不依赖网络，优先检查硬件接触。
八、售后服务与支持
- 质保：本产品提供 1 年免费质保（非人为物理损坏）。
- 定制：如需定制开发（增加传感器、修改网页界面等），请直接联系开发者。
- 联系：如遇无法解决的技术问题，请提供当前指示灯的状态（红/绿/蓝/闪白），以便技术人员快速定位问题。