🆘 帮助中心
故障排查、常见问题、使用技巧 - 一站式帮助文档
⚡ 快速诊断
📱 配网问题
问题1:找不到配网热点
症状
手机WiFi列表中找不到 AIOT_xxxxxx 热点
可能原因及解决方案:
| 原因 | 检查方法 | 解决方案 |
|---|---|---|
| 设备未进入配网模式 | 查看LCD显示 | 按住Boot键重启设备 |
| 手机WiFi未开启 | 检查手机设置 | 开启手机WiFi |
| WiFi列表未刷新 | - | 下拉刷新WiFi列表 |
| 设备WiFi模块故障 | 查看串口日志 | 重启设备/更换设备 |
快速解决
- 断开设备电源
- 按住Boot按键不放
- 重新上电
- 松开Boot按键
- 等待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加密方式)
- 🔌 外设连接情况
技术支持渠道
- 📧 邮箱: support@aiot.example.com
- 💬 在线客服: 工作日 9:00-18:00
- 🐛 问题反馈: GitHub Issues
- 📖 文档反馈: 文档改进建议
💡 还有疑问?
查看常见问题解答,或许能找到答案