跳转到正文

V1 蓝牙配网协议 ​

配网控制帧 ​

通过 BLUFI 标准协议帧收发,用于下发 WiFi 凭据和控制连接。

方向帧类型subtype说明
手机 → 设备数据帧STA_SSID (0x02)下发 WiFi 名称(≤31 字节)
手机 → 设备数据帧STA_PASSWD (0x03)下发 WiFi 密码(≤63 字节)
手机 → 设备控制帧CONN_TO_AP (0x03)请求设备连接已下发的 WiFi(原地连接,不重启)
手机 → 设备控制帧GET_WIFI_LIST (0x09)请求扫描并返回附近 WiFi 列表
手机 → 设备控制帧DISCONN_FROM_AP (0x04)断开 WiFi 连接
设备 → 手机数据帧WIFI_LIST (0x11)返回 WiFi 扫描结果(每条:长度 + RSSI + SSID)
设备 → 手机数据帧ERROR_INFO (0x12)错误信息(如 SSID/密码超长)

注意

帧格式(type/fc/seq/data_len/checksum)及分片规则见“代码实现”中的 BLUFI 帧构造与写入示例。

一轮授权是什么 ​

设备收到 AT+GETID 或联网成功后执行的“一轮授权”:设备向云端鉴权接口发起一次请求,获取最新的 device_id 和 binding_status(绑定状态)。若授权成功,设备通过 AT+ID=<device_id> 回复手机;若授权失败(网络异常),静默不回复,等 60s 后自动重试。

文档中心 · docs.jimitu.top