小程序-蓝牙命令指南V2
本指南整理小程序接入 MZ83 蓝牙命令的完整流程。协议内容按主题拆分到左侧分页，建议先看本页，再按接入阶段阅读。
接入凭据
本指南涉及的云端接口只需要开放平台 API Key，通过 Authorization: Bearer <your_api_key> 传递；不再使用 V1 的 mk_key。
阅读路径
| 页面 | 适合什么时候看 |
|---|---|
| 连接准备 | 第一次接入，确认 Service、特征和设备标识 |
| 握手、状态与设备码 | 建立连接、获取云端设备码，判断设备当前是否允许操作 |
| 设备绑定关系 | 使用开放平台接口完成绑定、解绑和换绑 |
| 业务命令 | 查找音量、亮度、配网、雷达等命令的请求和响应 |
| 业务流程 | 实现附近设备发现和 Wi-Fi 配网流程 |
接入主线
- 连接 BLUFI Service
0xFFFF。 - 订阅通知特征
0xFF02。 - 发送
AT+BLE_READY，等待AT+BLE_READY_ACK，同时接收BLE_MODE和NETSTATE。 - 在当前 BLE 连接上发送
AT+GETID，校验设备返回的公开device_id。 - 根据
BLE_MODE和NETSTATE判断进入配网、绑定/换绑或鉴权控制分支：BIND_PENDING已联网时绑定，未联网时先配网；BOUND_OFFLINE先配网；AUTH_REQUIRED已联网时先AT+APP_AUTH。 - 携带新的
request_id发送业务 JSON。 - 先处理 ACK，再等待最终状态或事件。
具体分支和状态变化见业务流程；绑定、解绑和换绑的云端接口见设备绑定关系。
载荷格式
所有文本命令和业务 JSON 都通过 BLUFI Custom Data 发送。小程序需要使用 BLUFI 客户端完成组帧、分包和写入，不能直接向 GATT 特征写入裸字符串。
常用命令速查
| 场景 | 命令 | 响应重点 |
|---|---|---|
| 获取公开设备身份 | AT+GETID | AT+ID=<device_id>；不要求先 APP_AUTH，也不受绑定状态限制 |
| 设置音量 | set_volume | command_ack、state.volume |
| 设置亮度 | set_brightness | command_ack、state.brightness |
| 配置 Wi-Fi | set_wifi | connecting、connected 或失败 |
| 开始发现 | peer_radar_start | started、peer_found、peer_discovery_done |
| 停止发现 | peer_radar_stop | stopping 或 already_stopped |
| 重启设备 | reboot | rebooting，随后断开 |