扫码添加设备却一直搜不到

现象

YBox App 打开配网页面扫码，扫完后要么提示"不识别二维码"，要么一直转圈搜不到设备。

排查顺序（按概率从高到低）

第一嫌疑：装错了客户端

这是概率最高的原因——同一生态里还有 UBox 客户端，两款 App 界面接近、图标都用蓝色调。YBox 扫 UBox 的二维码、或反过来，永远过不了。

确认方法：看包装盒或机身贴纸——印 YBox 就用 YBox，印 UBox 就用 UBox。错了卸载重装，设备端长按 reset 键重置重来。参考 YBox 与 UBox 两个客户端的区别。

第二嫌疑：配网路径选错了

"连接智能设备"三条路径（WiFi / 中继 / 4G），选错了路径 App 就按错误的协议去找设备：

• 4G 设备选了 WiFi 路径 → App 一直在扫二维码等 WiFi 凭据 → 4G 设备永远不会"被扫码"
• WiFi 设备选了 4G 路径 → App 一直在等蓝牙发现 → WiFi 设备不开蓝牙

对照设备类型重新选路径：太阳能 WiFi 款、可视门铃、全景款走 WiFi 路径；中继套装走中继路径；4G 款走 4G 路径。

第三嫌疑：设备不在配网状态

蓝灯状态是判断设备就绪与否的核心：

蓝灯不闪或不亮 → 长按设备 reset 键 3-5 秒强制进入配网模式。

第四嫌疑：WiFi 密码错或信号太弱

WiFi 款扫码成功后需要手机输入 WiFi 密码推给设备——密码错了设备连不上，App 也检测不到。此外设备离路由器太远、信号格数 1 格以下也会导致握手失败。

重置重来

以上都排查完还不行，直接重置：

1. 设备端长按 reset 键 3-5 秒，听到语音提示"系统已重置"后松手
2. 手机端杀掉 YBox App 重新打开
3. 确认手机连的是 2.4G WiFi（WiFi 款）或蓝牙已开（4G 款）
4. 重新走配网流程

重置后成功率接近 100%——绝大多数配网问题都是中间某个步骤走偏了，重置后回到干净状态重新走就能过。