⚡ 快速诊断

根据设备状态快速定位问题:

现象 可能原因 快速跳转
找不到配网热点 设备未进入配网模式 → 配网问题
无法连接WiFi 密码错误/信号弱 → 配网问题
设备显示离线 网络/MQTT问题 → 连接问题
控制指令无响应 设备离线/端口错误 → 控制问题
传感器无数据 传感器未连接/故障 → 控制问题
设备反复重启 电源/固件问题 → 系统问题

📱 配网问题

问题1:找不到配网热点

⚠️
症状

手机WiFi列表中找不到 AIOT_xxxxxx 热点

可能原因及解决方案:

原因 检查方法 解决方案
设备未进入配网模式 查看LCD显示 按住Boot键重启设备
手机WiFi未开启 检查手机设置 开启手机WiFi
WiFi列表未刷新 - 下拉刷新WiFi列表
设备WiFi模块故障 查看串口日志 重启设备/更换设备
💡
快速解决
  1. 断开设备电源
  2. 按住Boot按键不放
  3. 重新上电
  4. 松开Boot按键
  5. 等待5秒后刷新手机WiFi列表

问题2:连接热点后无法访问配网页面

⚠️
症状

手机已连接配网热点,但无法打开配网页面

解决步骤:

1
确认真正连接

检查手机WiFi设置,确认已连接到 AIOT_xxxxxx,不是家里的WiFi

2
关闭移动数据

关闭手机的移动数据(4G/5G),强制使用WiFi

3
手动输入地址

打开浏览器,手动输入:http://192.168.4.1

4
尝试其他浏览器

如果还是不行,尝试使用其他浏览器(Chrome/Safari/Firefox)

问题3:保存配置后无法连接WiFi

症状

配置保存成功,设备重启后LCD显示"WiFi Connect Failed"

常见原因(按频率排序):

原因 出现频率 解决方案
WiFi密码错误 ⭐⭐⭐⭐⭐ 90% 重新配网,仔细核对密码
WiFi信号太弱 ⭐⭐⭐ 5% 将设备靠近路由器
WiFi是5GHz ⭐⭐ 3% 使用2.4GHz WiFi
SSID输入错误 ⭐ 1% 确认SSID大小写、空格
路由器MAC过滤 ⭐ 1% 路由器添加设备MAC白名单
查看错误码
通过串口查看详细错误信息:
I (xxx) wifi: WiFi连接失败,错误码:2
  错误码2 = AUTH_EXPIRE(密码错误)

I (xxx) wifi: WiFi连接失败,错误码:201
  错误码201 = NO_AP_FOUND(找不到SSID或信号弱)

完整错误码列表:

→ 查看完整WiFi错误码说明

🌐 连接问题

问题1:设备显示离线

排查步骤:

1
检查LCD显示
LCD显示 说明 处理
WiFi: Disconnected WiFi断开 检查WiFi
WiFi: Connected WiFi正常 检查MQTT
MQTT: Disconnected MQTT断开 检查服务器
2
检查WiFi连接
  • 路由器是否正常工作?
  • 其他设备能否连接WiFi?
  • WiFi密码是否更改?
  • 设备是否离路由器太远?
3
检查服务器连接
  • 服务器是否在线?
  • 网络是否能访问服务器地址?
  • 防火墙是否阻止连接?
4
尝试重启设备

断电重启,观察能否自动重连

问题2:设备频繁断线

可能原因:

  • 🔋 电源不稳定:使用至少1A的电源适配器
  • 📡 WiFi信号弱:将设备靠近路由器或增加中继器
  • 🌐 网络不稳定:检查网络质量
  • 🔥 设备过热:确保良好散热
  • 🔌 线路干扰:远离强电磁干扰源

🎮 控制问题

问题1:发送指令无响应

检查清单:

检查项 如何检查 正常状态
设备在线 查看管理后台 🟢 在线
端口号正确 检查配置 端口号1-4
设备类型正确 LED/继电器/舵机 与实际硬件匹配
外设已连接 检查接线 连接牢固

问题2:传感器无数据

排查步骤:

1
检查传感器连接
  • VCC连接到3.3V或5V
  • GND连接正确
  • DATA引脚连接到正确的GPIO
  • 接线牢固,无松动
2
检查传感器电源

用万用表测量传感器VCC引脚电压,应为3.3V或5V

3
查看串口日志
正常日志:
I (xxx) DHT11: 温度: 25.0°C, 湿度: 60%

异常日志:
E (xxx) DHT11: 读取超时
→ 检查接线或更换传感器

问题3:舵机抖动或不转

可能原因:

现象 原因 解决方案
舵机抖动 电源不足 使用独立5V电源
舵机不转 信号线未连接 检查信号线连接
转动异常 角度超出范围 设置0-180度范围内
无反应 舵机损坏 更换舵机
⚠️
重要

舵机需要独立供电!不要从ESP32的3.3V引脚取电,会导致电流不足或设备重启。

⚙️ 系统问题

问题1:设备反复重启

可能原因:

  • 电源问题:电流不足,使用≥1A电源
  • 🔥 过热:改善散热条件
  • 💾 固件损坏:重新烧录固件
  • 🔌 短路:检查外设接线
  • 💥 看门狗超时:查看崩溃日志
查看崩溃日志
串口输出示例:
***ERROR*** A stack overflow...
→ 栈溢出,需要升级固件

Guru Meditation Error...
→ 严重错误,记录错误信息联系技术支持

问题2:LCD显示异常

排查方法:

现象 原因 解决方案
LCD无显示 背光/电源问题 检查连接,重启设备
显示乱码 初始化失败 重新烧录固件
显示闪烁 电源不稳定 更换电源
部分不显示 硬件故障 更换LCD模块

问题3:OTA升级失败

常见原因:

  • 网络不稳定,下载中断
  • 存储空间不足
  • 固件文件损坏
  • 升级过程中断电

解决方案:

  • ✅ 确保网络稳定
  • ✅ 确保设备有足够电量
  • ✅ 升级过程中不要断电
  • ✅ 如果失败,设备会自动回滚到旧版本
  • ✅ 多次失败可以尝试手动烧录

📋 WiFi错误码说明

通过串口查看WiFi连接错误码,快速定位问题:

错误码 含义 常见原因 解决方案
2 AUTH_EXPIRE 密码错误 重新配网,输入正确密码
15 4WAY_HANDSHAKE_TIMEOUT 握手超时(密码错误) 确认密码,检查加密方式
201 NO_AP_FOUND 找不到SSID 检查SSID、信号强度
202 AUTH_FAIL 认证失败 检查加密方式、密码
203 ASSOC_FAIL 关联失败 路由器拒绝连接,检查MAC过滤
204 HANDSHAKE_TIMEOUT 握手超时 信号太弱或路由器繁忙
💡
如何查看错误码

使用串口工具(如Arduino IDE串口监视器)连接设备,波特率115200,查看日志输出。

📞 获取帮助

问题仍未解决?

联系技术支持时,请提供以下信息:

  • 📱 设备型号和固件版本
  • 🔍 问题详细描述和复现步骤
  • 📊 LCD显示内容(拍照)
  • 💻 串口完整日志
  • 🌐 网络环境(路由器型号、WiFi加密方式)
  • 🔌 外设连接情况

技术支持渠道

💡 还有疑问?

查看常见问题解答,或许能找到答案

查看常见问题 →