连接失败排查
如果设备搜不到、连不上或容易断开，按下面顺序排查。先确认路径，再看权限和设备状态。
1. 先确认你走的是哪条连接方式
不同连接方式的失败原因不一样：
| 连接方式 | 优先检查 |
|---|---|
| BLE | 蓝牙权限、设备距离、设备是否正在被其他 App 占用 |
| SPP | Windows 是否已系统配对；macOS 设备是否可被发现 |
| 串口 | 端口是否选对、端口是否被串口工具占用 |
| Wi-Fi | IP 是否正确、是否在同一局域网 |
不确定时先看 连接方式选择。
2. 基础检查
- 设备尽量靠近手机/电脑，建议 1-2 米内。
- 确认设备已开机，并处于说明书要求的可配对、可被发现或工作模式。
- 关闭再打开系统蓝牙开关。
- 重启 HiBean。
- 重启设备。
3. 检查权限
iOS / iPadOS
进入系统 设置 → HiBean，确认 蓝牙 权限已开启。
Android
进入系统 设置 → 应用 → HiBean → 权限，确认 附近设备 权限已允许。部分旧 Android 版本还需要允许位置信息。
macOS / Windows
确认系统蓝牙已开启。如果使用 SPP 或串口，还要确认系统层面的配对、端口和权限状态。
4. Windows SPP：先系统配对
Windows 上 HiBean 的 SPP 列表通常来自系统已配对设备。设备即使可被发现，只要没有先在 Windows 系统里配对，HiBean 中也可能看不到。
5. macOS SPP：保持设备可被发现
macOS 上 HiBean 的 SPP 列表来自附近扫描。如果设备不处于可被发现/可配对状态，列表可能为空。
6. 避免设备被占用
同一时间不要让多个软件占用同一台设备。排查时先关闭：
- 其他烘焙软件
- 蓝牙调试工具
- 串口监视器
- 厂商原厂 App
7. 看到“未配置 / 蓝牙未配置”
这通常发生在跨平台使用时：设备对象已经从账号同步到当前平台，但当前平台还没有保存该设备的蓝牙标识。
8. 联系支持时提供这些信息
- 系统与版本：iOS / Android / macOS / Windows。
- 设备品牌和型号。
- 连接方式：BLE / SPP / 串口 / Wi-Fi。
- 现象：搜不到、配对失败、连接失败、断开、未配置等。
- 截图或错误提示。