蓝牙配置协议

帧格式

数据八位一个字节。下面的数字表示一个字节char.

完整帧的格式 [header(3)][type(1)][ctrl(1)][seq(1)][len(1)][data(len)][crc(2)]

分片帧的格式 [header(3)][type(1)][ctrl(1)][seq(1)][len(1)][data_total(2)][data(len)][crc(2)]

帧固定头 [0xBC, 0x59, 0x51];

type

帧类型定义 (低2位表示类型，高6位表示子类型) 所以一个帧类型是

Main Type

类型名称	类型值	类型说明
控制帧	0x00	用于发送控制指令
数据帧	0x01	用于发送数据指令
应答帧	0x02	用于应答指令

Sub Type

控制帧的Sub Type

类型名称	类型值	类型说明	回复帧类型
设置 Wi‑Fi	0x05	用于设置WI-FI指令	应答帧 0x02
设置 MQTT	0x06	用于设置MQTT指令	应答帧 0x02
获取版本信息	0x07	用于获取设备版本信息指令	数据帧 0x03
重启设备	0x08	用于重启设备指令	应答帧 0x02
~~获取设备状态~~	~~0x09~~	~~用于获取设备状态指令~~
设置串口参数	0x0A	用于设置串口指令	应答帧 0x02
设置 BLE 前缀和透传运行态配置	0x0B	用于设置 BLE 名称前缀、品牌名和透传 UUID	应答帧 0x02
获取 BLE 前缀和透传运行态配置	0x0C	用于查询当前 BLE 名称前缀、品牌名和透传 UUID	数据帧 0x03
恢复默认 BLE 前缀和透传运行态配置	0x0D	用于恢复默认 BLE 名称前缀、品牌名和透传 UUID	应答帧 0x02
设置低功耗模式参数	0x0E	用于设置低功耗参数指令	应答帧 0x02
获取低功耗模式参数	0x0F	用于设置获取低功耗参数指令	数据帧 0x03
清除WI-FI与MQTT配置	0x10	用于清除WI-FI与MQTT配置指令	应答帧 0x02
获取WI-FI参数和状态	0x11	获取WI-FI状态	数据帧 0x03
获取MQTT参数和状态	0x12	用于清除WI-FI与MQTT配置指令	数据帧 0x03
获取UART参数	0x13	用于清除WI-FI与MQTT配置指令	数据帧 0x03
设置状态灯显示方案	0x14	用于设置 WiFi、BLE、MQTT 三个状态灯的显示方案	应答帧 0x02
获取状态灯显示方案	0x15	用于查询当前状态灯显示方案	数据帧 0x03
恢复默认状态灯显示方案	0x16	用于恢复默认状态灯显示方案	应答帧 0x02

数据帧的Sub Type

类型名称	类型值	类型说明
设备版本信息	0x10	版本信息
低功耗设置	0x13	低功耗设置的数据
WI-FI状态数据	0x14	WI-FI状态数据
MQTT状态数据	0x15	MQTT状态数据
UART设置数据	0x16	UART设置数据
BLE 前缀和透传运行态配置数据	0x17	BLE 名称前缀、品牌名和透传 UUID 数据
状态灯显示方案数据	0x18	当前状态灯显示方案数据

应答帧 Sub Type

与控制帧一致。

Payload 只带有一个值 0/1

分别表示失败 / 成功

ctrl

帧控制字段定义

是否还有数据分片	是否为 ACK 帧	数据方向	是否包含校验位	是否加密
0x10	0x08	0x04	0x02	0x01

0x01 是否加密 （0: 不加密；1: 加密）

0x02：是否包含校验位（CRC等）

0x04：数据方向（0: 手机->设备；1: 设备->手机）

0x08：是否为 ACK 帧 （废除）

0x10：是否还有后续数据分片（1 表示还有分片）

使用的时候进行或运算即可

seq

分片序号

len

当前帧传输数据的长度

data_total

分片的时候有效，当表示数据总的长度

data

传输的数据内容

crc

CRC16 校验校验为止从帧头开始一直到data。

Data格式（TLV）

TLV（Type-Length-Value）是一种高效的数据编码格式，通过“类型-长度-值”三元组实现灵活的数据传输，特别适合物联网、网络协议等场景。

‌核心结构‌
‌Type（类型）‌：固定长度字段（1字节），标识数据类型。
‌Length（长度）‌：动态变长编码（1字节），声明Value的字节数。
‌Value（值）‌：实际数据内容，长度由Length指定。

WIFI设置

0x01: SSID (str), //SSID
0x02: Password (str) //密码

MQTT设置：

0x00 is_ssl               //是否开启SSL （预留，默认为不开启）
0x01 server               //服务器地址
0x02 port                 //服务器端口号
0x03 username             //用户名
0x04 password             //密码
0x05 topic                //自定义topic
0x06 server_ca_pem        //证书（预留）
0x07 client_cert_pem      //证书（预留）
0x08 client_key_pem       //证书（预留）
0x09 mqtt_proto            //MQTT 协议版本 默认 311 ，值 311，31，5

NOTE

SSL 当前版本未实现。啥时候实现待定。主要没有合适的测试环境

串口设置命令

0x01 baud,                  //波特率
0x02 data_bits,             //数据位
0x03 stop_bits,             //停止位 
0x04 parity,                //奇偶校验
0x05 flow_control           //流量控制

BLE前缀和透传运行态配置

0x01: name_prefix (str) //BLE 名称前缀，长度 1..15，只允许可打印 ASCII，不能全为空格 0x02: brand_name (str) //透传品牌名，长度 1..15，只允许可打印 ASCII，不能全为空格 0x03: service_uuid (u16 BE) //透传服务 UUID 0x04: rx_uuid (u16 BE) //透传写特征 UUID（手机 -> 设备） 0x05: tx_uuid (u16 BE) //透传通知特征 UUID（设备 -> 手机）

NOTE

这组配置走现有配置协议主链路，不走独立透传 RX/TX 特征。配置协议仍固定使用 1234 / 1236 / 1237。设置成功或恢复默认成功后，设备会自动重启。

状态采集指令

// Wi‑Fi 相关字段

const int TLV_WIFI_STATE = 0x01; // u8
const int TLV_WIFI_SSID = 0x02; // str
const int TLV_WIFI_IP = 0x03; // str
const int TLV_TYPE_WIFI_DISCONNECT_REASON = 0x0E //u8


// MQTT 相关字段
const int TLV_MQTT_STATE = 0x04; // u8
const int TLV_MQTT_URI = 0x05; // str (server address or URI)
const int TLV_MQTT_SUB_TOPIC = 0x06; // str
const int TLV_MQTT_PUB_TOPIC = 0x07; // str

// 串口（UART）相关字段
const int TLV_UART_BAUD = 0x08; // u32 BE
const int TLV_UART_DATA_BITS = 0x09; // u8
const int TLV_UART_STOP_BITS = 0x0A; // u8 (encoded: 0,1,1.5,2 as 0..3)
const int TLV_UART_PARITY = 0x0B; // u8 (0 none,1 odd,2 even)
const int TLV_UART_FLOW = 0x0C; // u8 (0 none,1 hw,2 sw)

OTA_URL 设置命令（预留）

0x01: OTA URL (string). len==0 表示清除 OTA_URL。

低功耗设置命令

0x01: deep_sleep_enable (u8) 0/1
0x02: deep_sleep_wake_sec (u32 BE)
0x03: awake_keep_sec (u32 BE)

状态灯显示方案配置

0x01: scheme (u8)         //状态灯显示方案，取值 0x01 / 0x02 / 0x03

NOTE

设置命令 0x14 必须且只能携带 1 个 0x01 TLV。查询命令 0x15 和恢复默认命令 0x16 的 payload 必须为空。查询成功返回的数据帧 sub_type 固定为 0x18。设置成功或恢复默认成功后立即生效，不触发设备重启。

BLE前缀和透传运行态

默认值

name_prefix = BC
brand_name = JBD
service_uuid = 0xFF00
rx_uuid = 0xFF02
tx_uuid = 0xFF01

BLE 广播名称固定格式为：

<prefix>_<device_id>

例如：

BC_A1B2C3D4E5F6

请求约束

设置命令 0x0B 必须一次带齐 5 个 TLV，不支持部分更新。
查询命令 0x0C 的 payload 必须为空。
恢复默认命令 0x0D 的 payload 必须为空。
三个 UUID 必须互不相同，且不能落在保留区间 0x1234..0x1239。
任一 TLV 类型非法、重复、长度非法、结构溢出或值校验失败，整条命令返回 ACK failure。

编码说明

name_prefix 和 brand_name 为字符串 TLV，不带 \0 结束符。
service_uuid、rx_uuid、tx_uuid 按 u16 BE 编码。
例如：0xFF00 -> FF 00，0x1234 -> 12 34。

对透传功能的影响

本组配置只影响透传服务发现、透传收发，以及特征码页中的透传 UUID 识别。
配置协议主链路不变，仍固定走 1234 / 1236 / 1237。
查询返回数据帧的 sub_type 固定为 0x17。
设置成功或恢复默认成功后，设备返回 ACK success 并自动重启；随后 BLE 断链属于预期行为。
如果修改了 name_prefix，设备重启后 BLE 广播名会变化。
如果修改了 service_uuid / rx_uuid / tx_uuid，重连后透传功能需要使用新的 UUID。

TLV 示例

设置一组运行态配置时，payload 示例：

text

01 03 4A 42 44
02 03 4A 42 44
03 02 FF 00
04 02 FF 02
05 02 FF 01

含义如下：

01 03 4A 42 44 → name_prefix = "JBD"
02 03 4A 42 44 → brand_name = "JBD"
03 02 FF 00 → service_uuid = 0xFF00
04 02 FF 02 → rx_uuid = 0xFF02
05 02 FF 01 → tx_uuid = 0xFF01

状态灯显示方案配置

默认值

scheme = 0x01

也就是说：

老设备升级后如果没有写过该配置，会继续保持当前正相显示方案灯效行为。

方案值定义

scheme = 0x01
- 方案 1：正相显示方案(当前方案)
- BLE：广播亮，连接闪烁，其它灭
- WiFi：WIFI_STATE_GOT_IP 时亮，其它灭
- MQTT：MQTT_STATE_CONNECTED 时亮，其它灭
scheme = 0x02
- 方案 2：反相显示方案
- BLE：仅连接闪烁，广播灭，其它灭
- WiFi：只要不是 WIFI_STATE_GOT_IP 就亮
- MQTT：只要不是 MQTT_STATE_CONNECTED 就亮
scheme = 0x03
- 方案 3：全部关闭
- BLE / WiFi / MQTT 三个状态灯在所有状态下都灭

请求约束

设置命令 0x14 必须恰好包含 1 个 TLV，类型固定为 0x01，长度固定为 0x01。
查询命令 0x15 的 payload 必须为空。
恢复默认命令 0x16 的 payload 必须为空。
scheme 只允许 0x01 / 0x02 / 0x03。
任一 TLV 类型非法、长度非法、结构溢出或值校验失败，整条命令返回 ACK failure。

行为说明

配置值会保存到 NVS。
设置成功或恢复默认成功后立即生效，不触发设备重启，也不会主动断开 BLE 链接。
查询成功返回数据帧，sub_type 固定为 0x18，不是 ACK success。
如果 NVS 中没有合法值，设备会回退到默认方案 1 后再返回。

编码说明

scheme 按单字节 u8 编码。
设置请求 payload 固定格式为：

text

01 01 XX

其中：

第 1 个字节 01 是 TLV type。
第 2 个字节 01 是长度。
第 3 个字节 XX 是方案值。

WIFI 断网原因对照表

 const Map<int, String> m = <int, String>{
    1: 'UNSPECIFIED',
    2: 'AUTH_EXPIRE',
    3: 'AUTH_LEAVE',
    4: 'DISASSOC_DUE_TO_INACTIVITY',
    5: 'ASSOC_TOOMANY',
    6: 'CLASS2_FRAME_FROM_NONAUTH_STA',
    7: 'CLASS3_FRAME_FROM_NONASSOC_STA',
    8: 'ASSOC_LEAVE',
    9: 'ASSOC_NOT_AUTHED',
    10: 'DISASSOC_PWRCAP_BAD',
    11: 'DISASSOC_SUPCHAN_BAD',
    12: 'BSS_TRANSITION_DISASSOC',
    13: 'IE_INVALID',
    14: 'MIC_FAILURE',
    15: '4WAY_HANDSHAKE_TIMEOUT',
    16: 'GROUP_KEY_UPDATE_TIMEOUT',
    17: 'IE_IN_4WAY_DIFFERS',
    18: 'GROUP_CIPHER_INVALID',
    19: 'PAIRWISE_CIPHER_INVALID',
    20: 'AKMP_INVALID',
    21: 'UNSUPP_RSN_IE_VERSION',
    22: 'INVALID_RSN_IE_CAP',
    23: '802_1X_AUTH_FAILED',
    24: 'CIPHER_SUITE_REJECTED',
    25: 'TDLS_PEER_UNREACHABLE',
    26: 'TDLS_UNSPECIFIED',
    27: 'SSP_REQUESTED_DISASSOC',
    28: 'NO_SSP_ROAMING_AGREEMENT',
    29: 'BAD_CIPHER_OR_AKM',
    30: 'NOT_AUTHORIZED_THIS_LOCATION',
    31: 'SERVICE_CHANGE_PERCLUDES_TS',
    32: 'UNSPECIFIED_QOS',
    33: 'NOT_ENOUGH_BANDWIDTH',
    34: 'MISSING_ACKS',
    35: 'EXCEEDED_TXOP',
    36: 'STA_LEAVING',
    37: 'END_BA',
    38: 'UNKNOWN_BA',
    39: 'TIMEOUT',
    46: 'PEER_INITIATED',
    47: 'AP_INITIATED',
    48: 'INVALID_FT_ACTION_FRAME_COUNT',
    49: 'INVALID_PMKID',
    50: 'INVALID_MDE',
    51: 'INVALID_FTE',
    67: 'TRANSMISSION_LINK_ESTABLISH_FAILED',
    68: 'ALTERATIVE_CHANNEL_OCCUPIED',
    200: 'BEACON_TIMEOUT',
    201: 'NO_AP_FOUND',
    202: 'AUTH_FAIL',
    203: 'ASSOC_FAIL',
    204: 'HANDSHAKE_TIMEOUT',
    205: 'CONNECTION_FAIL',
    206: 'AP_TSF_RESET',
    207: 'ROAMING',
    208: 'ASSOC_COMEBACK_TIME_TOO_LONG',
    209: 'SA_QUERY_TIMEOUT',
    210: 'NO_AP_FOUND_W_COMPATIBLE_SECURITY',
    211: 'NO_AP_FOUND_IN_AUTHMODE_THRESHOLD',
    212: 'NO_AP_FOUND_IN_RSSI_THRESHOLD',
  };

长度限制

参数

参数	最大长度(char)
WI-FI SSID	32
WI-FI Password	64
MQTT 自定义topic	16
MQTT sub/pub 订阅和发布的主题	128

透传

透传为最大 1024 char.

分帧说明

由于蓝牙MTU设置为23，所以Data过长的时候是需要分帧的。解析前需要把分帧合并成单帧再进行解析

指令例子

WI-FI状态查询

发送：[0xBC, 0x59, 0x51, 0x44, 0x02, 0x00, 0x00, 0x1C, 0xC9]

接收：[0xBC, 0x59, 0x51, 0x51, 0x06, 0x00, 0x1E, 0x01, 0x01, 0x04, 0x0E, 0x01, 0x00, 0x02, 0x07, 0x37, 0x31, 0x32, 0x30, 0x31, 0x2D, 0x32, 0x03, 0x0D, 0x31, 0x39, 0x32, 0x2E, 0x31, 0x36, 0x38, 0x2E, 0x39, 0x2E, 0x31, 0x30, 0x38, 0x35, 0x1B]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x44, 0x02, 0x00, 0x00, 0x1C, 0xC9]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`44`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x11` → SubType=0x11（获取 WI-FI 参数和状态）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`1C C9`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x51, 0x06, 0x00, 0x1E, ... , 0x35, 0x1B]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`51`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x14` → SubType=0x14（WI-FI 状态数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`1E`	数据长度 0x1E = 30 字节
data	len	见下	TLV 数据
crc	2	`35 1B`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

响应 data 共 30 字节，按 TLV（Type-Length-Value）解析如下：

01 01 04

Type=0x01（TLV_WIFI_STATE）
Length=0x01
Value=0x04 → WIFI_STATE_GOT_IP（已联网并获取 IP）

0E 01 00

Type=0x0E（TLV_TYPE_WIFI_DISCONNECT_REASON）
Length=0x01
Value=0x00（示例值为 0；如断网可对照上面的断网原因表）

02 07 37 31 32 30 31 2D 32

Type=0x02（TLV_WIFI_SSID）
Length=0x07
Value=37 31 32 30 31 2D 32 → ASCII 字符串 71201-2

03 0D 31 39 32 2E 31 36 38 2E 39 2E 31 30 38

Type=0x03（TLV_WIFI_IP）
Length=0x0D
Value=31 39 32 2E 31 36 38 2E 39 2E 31 30 38 → ASCII 字符串 192.168.9.108

MQTT状态查询

发送（十六进制）：[0xBC, 0x59, 0x51, 0x48, 0x02, 0x00, 0x00, 0x53, 0xFB]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x55, 0x06, 0x00, 0x62, ... , 0x87, 0xD6]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x48, 0x02, 0x00, 0x00, 0x53, 0xFB]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`48`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x12` → SubType=0x12（获取 MQTT 参数和状态）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`53 FB`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧（完整十进制数组）：

text

[0xBC, 0x59, 0x51, 0x55, 0x06, 0x00, 0x62, 0x04, 0x01, 0x02, 0x05, 0x17, 0x6D, 0x71, 0x74, 0x74, 0x3A, 0x2F, 0x2F, 0x31, 0x30, 0x31, 0x2E, 0x34, 0x32, 0x2E, 0x34, 0x2E, 0x35, 0x31, 0x3A, 0x31, 0x38, 0x38, 0x33, 0x06, 0x21, 0x74, 0x72, 0x61, 0x6E, 0x73, 0x2F, 0x65, 0x73, 0x70, 0x2F, 0x63, 0x6C, 0x69, 0x65, 0x6E, 0x74, 0x2F, 0x73, 0x75, 0x62, 0x2F, 0x36, 0x43, 0x43, 0x38, 0x34, 0x30, 0x42, 0x42, 0x42, 0x38, 0x30, 0x45, 0x07, 0x21, 0x74, 0x72, 0x61, 0x6E, 0x73, 0x2F, 0x65, 0x73, 0x70, 0x2F, 0x63, 0x6C, 0x69, 0x65, 0x6E, 0x74, 0x2F, 0x70, 0x75, 0x62, 0x2F, 0x36, 0x43, 0x43, 0x38, 0x34, 0x30, 0x42, 0x42, 0x42, 0x38, 0x30, 0x45, 0x87, 0xD6]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`55`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x15` → SubType=0x15（MQTT 状态数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`62`	数据长度 0x62 = 98 字节
data	len	见下	TLV 数据
crc	2	`87 D6`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

响应 data 共 98 字节，按 TLV（Type-Length-Value）解析如下：

04 01 02

Type=0x04（TLV_MQTT_STATE）
Length=0x01
Value=0x02 → MQTT_STATE_CONNECTED（已连接）

05 17 6D 71 74 74 3A 2F 2F 31 30 31 2E 34 32 2E 34 2E 35 31 3A 31 38 38 33

Type=0x05（TLV_MQTT_URI）
Length=0x17（23 字节）
Value → ASCII 字符串 mqtt://101.42.4.51:1883

06 21 ...

Type=0x06（TLV_MQTT_SUB_TOPIC）
Length=0x21（33 字节）
Value → ASCII 字符串 trans/esp/client/sub/6CC840BBB80E

07 21 ...

Type=0x07（TLV_MQTT_PUB_TOPIC）
Length=0x21（33 字节）
Value → ASCII 字符串 trans/esp/client/pub/6CC840BBB80E

UART参数查询

发送（十六进制）：[0xBC, 0x59, 0x51, 0x4C, 0x02, 0x00, 0x00, 0x99, 0x0A]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x59, 0x06, 0x00, 0x12, 0x08, 0x04, 0x00, 0x00, 0x25, 0x80, 0x09, 0x01, 0x08, 0x0A, 0x01, 0x01, 0x0B, 0x01, 0x00, 0x0C, 0x01, 0x00, 0x97, 0x56]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x4C, 0x02, 0x00, 0x00, 0x99, 0x0A]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`4C`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x13` → SubType=0x13（获取 UART 参数）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`99 0A`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x59, 0x06, 0x00, 0x12, ... , 0x97, 0x56]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`59`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x16` → SubType=0x16（UART 设置数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`12`	数据长度 0x12 = 18 字节
data	len	见下	TLV 数据
crc	2	`97 56`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

响应 data 共 18 字节，按 TLV（Type-Length-Value）解析如下：

08 04 00 00 25 80

Type=0x08（TLV_UART_BAUD）
Length=0x04
Value=00 00 25 80（u32 BE）→ 9600

09 01 08

Type=0x09（TLV_UART_DATA_BITS）
Length=0x01
Value=0x08 → 数据位 8

0A 01 01

Type=0x0A（TLV_UART_STOP_BITS）
Length=0x01
Value=0x01 → 停止位编码 1（对应 1 stop bit）

0B 01 00

Type=0x0B（TLV_UART_PARITY）
Length=0x01
Value=0x00 → parity none

0C 01 00

Type=0x0C（TLV_UART_FLOW）
Length=0x01
Value=0x00 → flow control none

版本信息查询

发送（十六进制）：[0xBC, 0x59, 0x51, 0x1C, 0x02, 0x00, 0x00, 0xEC, 0x31]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x41, 0x06, 0x00, 0x05, 0x31, 0x2E, 0x35, 0x2E, 0x31, 0xEA, 0x67]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x1C, 0x02, 0x00, 0x00, 0xEC, 0x31]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`1C`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x07` → SubType=0x07（获取版本信息）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`EC 31`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x41, 0x06, 0x00, 0x05, ... , 0xEA, 0x67]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`41`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x10` → SubType=0x10（设备版本信息）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`05`	数据长度 5 字节
data	len	`31 2E 35 2E 31`	ASCII 字符串 `1.5.1`
crc	2	`EA 67`	CRC16（从 header 到 data 末尾）

设置 Wi‑Fi（分帧示例）

提醒：分片帧需要先按 data_total 合并成完整 data，再按 TLV 解析。

发送三个分帧：

[0xBC, 0x59, 0x51, 0x14, 0x12, 0x00, 0x09, 0x00, 0x13, 0x01, 0x07, 0x37, 0x31, 0x32, 0x30, 0x31, 0x2D, 0x32, 0x7C, 0x40]
[0xBC, 0x59, 0x51, 0x14, 0x12, 0x00, 0x09, 0x00, 0x13, 0x02, 0x08, 0x31, 0x71, 0x32, 0x65, 0x33, 0x65, 0x34, 0x00, 0x4E]
[0xBC, 0x59, 0x51, 0x14, 0x02, 0x00, 0x01, 0x00, 0x13, 0x72, 0x0E, 0x18]

接收：[0xBC, 0x59, 0x51, 0x16, 0x06, 0x00, 0x01, 0x00, 0xB2, 0xCC]

分片请求帧字段解析（以第 1 帧为例）

第 1 帧：[0xBC, 0x59, 0x51, 0x14, 0x12, 0x00, 0x09, 0x00, 0x13, ... , 0x7C, 0x40]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`14`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x05` → SubType=0x05（设置 Wi‑Fi）
ctrl	1	`12`	`0x10` 表示还有后续分片 + `0x02` 表示包含 CRC
seq	1	`00`	分片序号（本示例中均为 0；实现若使用递增序号，应按 seq 排序再合并）
len	1	`09`	当前分片 data 长度（不含 `data_total` 与 crc）
data_total	2	`00 13`	完整 data 总长度 0x0013 = 19 字节
data	len	见下	分片数据
crc	2	`7C 40`	CRC16（从 header 到本分片 data 末尾）

合帧（把 3 个分片的 data 拼接）

三个分片的 data(len) 依次为：

分片 1：01 07 37 31 32 30 31 2D 32
分片 2：02 08 31 71 32 65 33 65 34
分片 3：72

合并后的完整 data（19 字节）为：

01 07 37 31 32 30 31 2D 32 02 08 31 71 32 65 33 65 34 72

合并后 data（TLV）解析

按“WIFI设置”TLV 约定：0x01=SSID、0x02=Password。

01 07 37 31 32 30 31 2D 32

Type=0x01（SSID）
Length=0x07
Value → ASCII：71201-2

02 08 31 71 32 65 33 65 34 72

Type=0x02（Password）
Length=0x08
Value → ASCII：1q2e3e4r

响应帧（ACK）解析

理论上：

接收：[0xBC, 0x59, 0x51, 0x16, 0x06, 0x00, 0x01, 0x00, 0xB2, 0xCC]

type=0x16 → type & 0x03 = 2（应答帧），type >> 2 = 0x05（对应设置 Wi‑Fi 的 ACK）
len=0x01，payload=0x00
- 按文档约定：0=失败，1=成功 → 本次设置结果为失败实际上已经重启。没有回复帧。后期补上吧。

设置 MQTT（分帧示例）

说明：与“设置 Wi‑Fi（分帧示例）”一致，先按 data_total 合并完整 data，再按 MQTT 的 TLV 定义解析。

发送分帧（仅十六进制）：

[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x00, 0x01, 0x00, 0x01, 0x0B, 0x31, 0x30, 0x31, 0x2E, 0x6A, 0xDC]
[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x34, 0x32, 0x2E, 0x34, 0x2E, 0x35, 0x31, 0x02, 0x02, 0xDF, 0x61]
[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x07, 0x5B, 0x03, 0x0D, 0x65, 0x73, 0x70, 0x5F, 0x6D, 0x4A, 0xA1]
[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x71, 0x74, 0x74, 0x5F, 0x75, 0x73, 0x65, 0x72, 0x04, 0x5E, 0x55]
[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x11, 0x65, 0x73, 0x70, 0x5F, 0x6D, 0x71, 0x74, 0x74, 0x89, 0x2D]
[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, 0x5F, 0x70, 0x61, 0x73, 0x73, 0x77, 0x6F, 0x72, 0x64, 0x59, 0x97]
[0xBC, 0x59, 0x51, 0x18, 0x02, 0x00, 0x09, 0x00, 0x3F, 0x05, 0x03, 0x65, 0x73, 0x70, 0x09, 0x02, 0x01, 0x37, 0x25, 0x3B]

接收（ACK）：[0xBC, 0x59, 0x51, 0x1A, 0x06, 0x00, 0x01, 0x00, 0x39, 0xE7]

分片请求帧字段解析（以第 1 帧为例）

第 1 帧：[0xBC, 0x59, 0x51, 0x18, 0x12, 0x00, 0x09, 0x00, 0x3F, ...]

type=0x18 → 控制帧，type >> 2 = 0x06（设置 MQTT）
ctrl=0x12 → 有后续分片（0x10）+ 含 CRC（0x02）
len=0x09
data_total=0x003F → 完整 data 总长度 63 字节

合帧（把 7 个分片的 data 拼接）

合并后的完整 data（63 字节）为：

00 01 00 01 0B 31 30 31 2E 34 32 2E 34 2E 35 31 02 02 07 5B 03 0D 65 73 70 5F 6D 71 74 74 5F 75 73 65 72 04 11 65 73 70 5F 6D 71 74 74 5F 70 61 73 73 77 6F 72 64 05 03 65 73 70 09 02 01 37

合并后 data（TLV）解析

按“MQTT设置”TLV 约定：

0x00 is_ssl
0x01 server
0x02 port
0x03 username
0x04 password
0x05 topic
0x09 mqtt_proto

00 01 00

Type=0x00（is_ssl）
Length=0x01
Value=0x00 → 关闭 SSL

01 0B 31 30 31 2E 34 32 2E 34 2E 35 31

Type=0x01（server）
Length=0x0B
Value → ASCII：101.42.4.51

02 02 07 5B

Type=0x02（port）
Length=0x02
Value=07 5B（u16 BE）→ 1883

03 0D 65 73 70 5F 6D 71 74 74 5F 75 73 65 72

Type=0x03（username）
Length=0x0D
Value → ASCII：esp_mqtt_user

04 11 65 73 70 5F 6D 71 74 74 5F 70 61 73 73 77 6F 72 64

Type=0x04（password）
Length=0x11
Value → ASCII：esp_mqtt_password

05 03 65 73 70

Type=0x05（topic）
Length=0x03
Value → ASCII：esp

09 02 01 37

Type=0x09（mqtt_proto）
Length=0x02
Value=01 37（u16 BE）→ 311（即 MQTT 3.1.1）

响应帧（ACK）解析

接收：[0xBC, 0x59, 0x51, 0x1A, 0x06, 0x00, 0x01, 0x00, 0x39, 0xE7]

type=0x1A → type & 0x03 = 2（应答帧），type >> 2 = 0x06（对应设置 MQTT 的 ACK）
len=0x01，payload=0x00
- 按文档约定：0=失败，1=成功 → 本次设置结果为失败

设置 UART（分帧示例）

发送分帧（仅十六进制）：

[0xBC, 0x59, 0x51, 0x28, 0x12, 0x00, 0x09, 0x00, 0x12, 0x01, 0x04, 0x00, 0x00, 0x25, 0x80, 0x02, 0x01, 0x08, 0x44, 0xC4]
[0xBC, 0x59, 0x51, 0x28, 0x02, 0x00, 0x09, 0x00, 0x12, 0x03, 0x01, 0x01, 0x04, 0x01, 0x00, 0x05, 0x01, 0x00, 0xEA, 0x38]

接收（ACK）：[0xBC, 0x59, 0x51, 0x2A, 0x06, 0x00, 0x01, 0x00, 0x35, 0x09]

分片请求帧字段解析（以第 1 帧为例）

第 1 帧：[0xBC, 0x59, 0x51, 0x28, 0x12, 0x00, 0x09, 0x00, 0x12, ...]

type=0x28 → 控制帧，type >> 2 = 0x0A（设置串口参数）
ctrl=0x12 → 有后续分片（0x10）+ 含 CRC（0x02）
len=0x09
data_total=0x0012 → 完整 data 总长度 18 字节

合帧（把 2 个分片的 data 拼接）

两个分片的 data(len) 依次为：

分片 1：01 04 00 00 25 80 02 01 08
分片 2：03 01 01 04 01 00 05 01 00

合并后的完整 data（18 字节）为：

01 04 00 00 25 80 02 01 08 03 01 01 04 01 00 05 01 00

合并后 data（TLV）解析

按“串口设置命令”TLV 约定：

0x01 baud
0x02 data_bits
0x03 stop_bits
0x04 parity
0x05 flow_control

01 04 00 00 25 80

Type=0x01（baud）
Length=0x04
Value=00 00 25 80（u32 BE）→ 9600

02 01 08

Type=0x02（data_bits）
Length=0x01
Value=0x08 → 8

03 01 01

Type=0x03（stop_bits）
Length=0x01
Value=0x01 → 1 stop bit

04 01 00

Type=0x04（parity）
Length=0x01
Value=0x00 → none

05 01 00

Type=0x05（flow_control）
Length=0x01
Value=0x00 → none

响应帧（ACK）解析

接收：[0xBC, 0x59, 0x51, 0x2A, 0x06, 0x00, 0x01, 0x00, 0x35, 0x09]

type=0x2A → type & 0x03 = 2（应答帧），type >> 2 = 0x0A（对应设置串口参数的 ACK）
len=0x01，payload=0x00
- 按文档约定：0=失败，1=成功 → 本次设置结果为失败

设置 BLE前缀和透传运行态配置（分帧示例）

说明：本示例设置 name_prefix=JBD、brand_name=JBD、service_uuid=0xFF00、rx_uuid=0xFF02、tx_uuid=0xFF01。完整 payload 长度为 22 字节，需要分 3 帧发送。

发送分帧（十六进制）：

[0xBC, 0x59, 0x51, 0x2C, 0x12, 0x00, 0x09, 0x00, 0x16, 0x01, 0x03, 0x4A, 0x42, 0x44, 0x02, 0x03, 0x4A, 0x42, 0xF6, 0xFC]
[0xBC, 0x59, 0x51, 0x2C, 0x12, 0x00, 0x09, 0x00, 0x16, 0x44, 0x03, 0x02, 0xFF, 0x00, 0x04, 0x02, 0xFF, 0x02, 0x04, 0xBC]
[0xBC, 0x59, 0x51, 0x2C, 0x02, 0x00, 0x04, 0x00, 0x16, 0x05, 0x02, 0xFF, 0x01, 0x42, 0x1D]

接收（ACK）：[0xBC, 0x59, 0x51, 0x2E, 0x06, 0x00, 0x01, 0x01, 0xAC, 0x2E]

分片请求帧字段解析（以第 1 帧为例）

第 1 帧：[0xBC, 0x59, 0x51, 0x2C, 0x12, 0x00, 0x09, 0x00, 0x16, ...]

type=0x2C → 控制帧，type >> 2 = 0x0B（设置 BLE 前缀和透传运行态配置）
ctrl=0x12 → 有后续分片（0x10）+ 含 CRC（0x02）
len=0x09
data_total=0x0016 → 完整 data 总长度 22 字节

合帧（把 3 个分片的 data 拼接）

三个分片的 data(len) 依次为：

分片 1：01 03 4A 42 44 02 03 4A 42
分片 2：44 03 02 FF 00 04 02 FF 02
分片 3：05 02 FF 01

合并后的完整 data（22 字节）为：

01 03 4A 42 44 02 03 4A 42 44 03 02 FF 00 04 02 FF 02 05 02 FF 01

合并后 data（TLV）解析

01 03 4A 42 44

Type=0x01（name_prefix）
Length=0x03
Value → ASCII：JBD

02 03 4A 42 44

Type=0x02（brand_name）
Length=0x03
Value → ASCII：JBD

03 02 FF 00

Type=0x03（service_uuid）
Length=0x02
Value=FF 00（u16 BE）→ 0xFF00

04 02 FF 02

Type=0x04（rx_uuid）
Length=0x02
Value=FF 02（u16 BE）→ 0xFF02

05 02 FF 01

Type=0x05（tx_uuid）
Length=0x02
Value=FF 01（u16 BE）→ 0xFF01

响应帧（ACK）解析

接收：[0xBC, 0x59, 0x51, 0x2E, 0x06, 0x00, 0x01, 0x01, 0xAC, 0x2E]

type=0x2E → type & 0x03 = 2（应答帧），type >> 2 = 0x0B（对应设置 BLE 前缀和透传运行态配置的 ACK）
len=0x01，payload=0x01
- 按文档约定：0=失败，1=成功 → 本次设置结果为成功

说明：设置成功后设备会自动重启，随后 BLE 断链属于预期行为。

查询 BLE前缀和透传运行态配置

发送（十六进制）：[0xBC, 0x59, 0x51, 0x30, 0x02, 0x00, 0x00, 0x94, 0x4D]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x5D, 0x06, 0x00, 0x15, 0x01, 0x02, 0x42, 0x43, 0x02, 0x03, 0x4A, 0x42, 0x44, 0x03, 0x02, 0xFF, 0x00, 0x04, 0x02, 0xFF, 0x02, 0x05, 0x02, 0xFF, 0x01, 0xD4, 0xB6]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x30, 0x02, 0x00, 0x00, 0x94, 0x4D]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`30`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x0C` → SubType=0x0C（获取 BLE 前缀和透传运行态配置）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`94 4D`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x5D, 0x06, 0x00, 0x15, ... , 0xD4, 0xB6]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`5D`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x17` → SubType=0x17（BLE 前缀和透传运行态配置数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`15`	数据长度 0x15 = 21 字节
data	len	见下	TLV 数据
crc	2	`D4 B6`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

本例返回的是默认运行态配置，响应 data 共 21 字节：

01 02 42 43

Type=0x01（name_prefix）
Length=0x02
Value → ASCII：BC

02 03 4A 42 44

Type=0x02（brand_name）
Length=0x03
Value → ASCII：JBD

03 02 FF 00

Type=0x03（service_uuid）
Length=0x02
Value=FF 00（u16 BE）→ 0xFF00

04 02 FF 02

Type=0x04（rx_uuid）
Length=0x02
Value=FF 02（u16 BE）→ 0xFF02

05 02 FF 01

Type=0x05（tx_uuid）
Length=0x02
Value=FF 01（u16 BE）→ 0xFF01

恢复默认 BLE前缀和透传运行态配置

发送（十六进制）：[0xBC, 0x59, 0x51, 0x34, 0x02, 0x00, 0x00, 0x5E, 0xBC]

接收（ACK）：[0xBC, 0x59, 0x51, 0x36, 0x06, 0x00, 0x01, 0x01, 0xAA, 0x59]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x34, 0x02, 0x00, 0x00, 0x5E, 0xBC]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`34`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x0D` → SubType=0x0D（恢复默认 BLE 前缀和透传运行态配置）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`5E BC`	CRC16（从 header 到 data 末尾）

响应帧（ACK）解析

响应帧：[0xBC, 0x59, 0x51, 0x36, 0x06, 0x00, 0x01, 0x01, 0xAA, 0x59]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`36`	`type & 0x03 = 2` → 应答帧；`type >> 2 = 0x0D` → SubType=0x0D（恢复默认 BLE 前缀和透传运行态配置的 ACK）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`01`	数据长度 1 字节
payload	1	`01`	结果 0=失败，1=成功（本例为 1，成功）
crc	2	`AA 59`	CRC16（从 header 到 data 末尾）

说明：恢复默认成功后设备会自动重启；重启后默认值为 BC / JBD / FF00 / FF02 / FF01。

重启设备

发送（十六进制）：[0xBC, 0x59, 0x51, 0x20, 0x02, 0x00, 0x00, 0x8F, 0xEA]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x20, 0x02, 0x00, 0x00, 0x8F, 0xEA]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`20`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x08` → SubType=0x08（重启设备）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`8F EA`	CRC16（从 header 到 data 末尾）

响应帧（ACK）解析（理论）

说明：重启指令可能会在设备重启前来不及返回 ACK；以下为按协议约定的 ACK 帧格式。

理论 ACK：[0xBC, 0x59, 0x51, 0x22, 0x06, 0x00, 0x01, <result>, <crc1>, <crc2>]

type=0x22 → type & 0x03 = 2（应答帧），type >> 2 = 0x08（对应重启设备的 ACK）
len=0x01，payload=<result>
- <result>=0x00：失败
- <result>=0x01：成功

设置 Low Power（分帧示例）

发送分帧（十六进制）：

[0xBC, 0x59, 0x51, 0x38, 0x12, 0x00, 0x09, 0x00, 0x0F, 0x01, 0x01, 0x01, 0x02, 0x04, 0x00, 0x00, 0x17, 0x70, 0x2A, 0x8B]
[0xBC, 0x59, 0x51, 0x38, 0x02, 0x00, 0x06, 0x00, 0x0F, 0x03, 0x04, 0x00, 0x01, 0x5F, 0x90, 0xDE, 0x99]

接收（ACK）：[0xBC, 0x59, 0x51, 0x3A, 0x06, 0x00, 0x01, 0x00, 0x31, 0x53]

分片请求帧字段解析（以第 1 帧为例）

第 1 帧：[0xBC, 0x59, 0x51, 0x38, 0x12, 0x00, 0x09, 0x00, 0x0F, ...]

type=0x38 → 控制帧，type >> 2 = 0x0E（设置低功耗模式参数）
ctrl=0x12 → 有后续分片（0x10）+ 含 CRC（0x02）
len=0x09
data_total=0x000F → 完整 data 总长度 15 字节

合帧（把 2 个分片的 data 拼接）

两个分片的 data(len) 依次为：

分片 1：01 01 01 02 04 00 00 17 70
分片 2：03 04 00 01 5F 90

合并后的完整 data（15 字节）为：

01 01 01 02 04 00 00 17 70 03 04 00 01 5F 90

合并后 data（TLV）解析

按“低功耗设置命令”TLV 约定：

0x01 deep_sleep_enable (u8)
0x02 deep_sleep_wake_sec (u32 BE)
0x03 awake_keep_sec (u32 BE)

01 01 01

deep_sleep_enable=1

02 04 00 00 17 70

deep_sleep_wake_sec=0x00001770 → 6000 秒（约 100 分钟）

03 04 00 01 5F 90

awake_keep_sec=0x00015F90 → 90000 秒（25 小时）

响应帧（ACK）解析

接收：[0xBC, 0x59, 0x51, 0x3A, 0x06, 0x00, 0x01, 0x00, 0x31, 0x53]

type=0x3A → type & 0x03 = 2（应答帧），type >> 2 = 0x0E（对应设置低功耗模式参数的 ACK）
len=0x01，payload=0x00
- 按文档约定：0=失败，1=成功 → 本次设置结果为失败

查询 Low Power（获取低功耗模式参数）

发送（十六进制）：[0xBC, 0x59, 0x51, 0x3C, 0x02, 0x00, 0x00, 0xDB, 0x7F]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x4D, 0x06, 0x00, 0x0F, 0x01, 0x01, 0x01, 0x02, 0x04, 0x00, 0x00, 0x17, 0x70, 0x03, 0x04, 0x00, 0x01, 0x5F, 0x90, 0x8D, 0x5A]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x3C, 0x02, 0x00, 0x00, 0xDB, 0x7F]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`3C`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x0F` → SubType=0x0F（获取低功耗模式参数）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`DB 7F`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x4D, 0x06, 0x00, 0x0F, ... , 0x8D, 0x5A]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`4D`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x13` → SubType=0x13（低功耗设置数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`0F`	数据长度 0x0F = 15 字节
data	len	见下	TLV 数据
crc	2	`8D 5A`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

响应 data 共 15 字节，按“低功耗设置命令”TLV 约定解析如下：

01 01 01

deep_sleep_enable=1

02 04 00 00 17 70

deep_sleep_wake_sec=0x00001770 → 6000 秒（约 100 分钟）

03 04 00 01 5F 90

awake_keep_sec=0x00015F90 → 90000 秒（25 小时）

清除网络配置（清除WI-FI与MQTT配置）

发送（十六进制）：[0xBC, 0x59, 0x51, 0x40, 0x02, 0x00, 0x00, 0xD6, 0x38]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x42, 0x06, 0x00, 0x01, 0x00, 0x2E, 0xF8]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x40, 0x02, 0x00, 0x00, 0xD6, 0x38]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`40`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x10` → SubType=0x10（清除WI-FI与MQTT配置）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`D6 38`	CRC16（从 header 到 data 末尾）

响应帧（ACK）解析

响应帧：[0xBC, 0x59, 0x51, 0x42, 0x06, 0x00, 0x01, 0x00, 0x2E, 0xF8]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`42`	`type & 0x03 = 2` → 应答帧；`type >> 2 = 0x10` → SubType=0x10（清除WI-FI与MQTT配置的 ACK）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`01`	数据长度 1 字节
payload	1	`00`	结果 0=失败，1=成功（本例为 0，失败）
crc	2	`2E F8`	CRC16（从 header 到 data 末尾）

说明：本例返回 0，表示清除失败。实际使用时 0x01 表示成功。

设置状态灯显示方案（方案 2）

发送（十六进制）：[0xBC, 0x59, 0x51, 0x50, 0x02, 0x00, 0x03, 0x01, 0x01, 0x02, 0xD3, 0xEC]

接收（ACK）：[0xBC, 0x59, 0x51, 0x52, 0x06, 0x00, 0x01, 0x01, 0x3A, 0x83]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x50, 0x02, 0x00, 0x03, 0x01, 0x01, 0x02, 0xD3, 0xEC]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`50`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x14` → SubType=0x14（设置状态灯显示方案）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`03`	数据长度 3 字节
data	3	`01 01 02`	TLV：将状态灯方案设置为方案 2
crc	2	`D3 EC`	CRC16（从 header 到 data 末尾）

请求 data（TLV）解析

01 01 02

Type=0x01（scheme）
Length=0x01
Value=0x02 → 方案 2（反相显示方案）

响应帧（ACK）解析

接收：[0xBC, 0x59, 0x51, 0x52, 0x06, 0x00, 0x01, 0x01, 0x3A, 0x83]

type=0x52 → type & 0x03 = 2（应答帧），type >> 2 = 0x14（对应设置状态灯显示方案的 ACK）
len=0x01，payload=0x01
- 按文档约定：0=失败，1=成功 → 本次设置结果为成功

说明：设置成功后设备立即生效，不会重启，也不会主动断开 BLE 链接。

查询状态灯显示方案

发送（十六进制）：[0xBC, 0x59, 0x51, 0x54, 0x02, 0x00, 0x00, 0x07, 0x6E]

接收（十六进制）：[0xBC, 0x59, 0x51, 0x61, 0x06, 0x00, 0x03, 0x01, 0x01, 0x03, 0x24, 0x80]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x54, 0x02, 0x00, 0x00, 0x07, 0x6E]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`54`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x15` → SubType=0x15（获取状态灯显示方案）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`07 6E`	CRC16（从 header 到 data 末尾）

响应帧字段解析

响应帧：[0xBC, 0x59, 0x51, 0x61, 0x06, 0x00, 0x03, 0x01, 0x01, 0x03, 0x24, 0x80]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`61`	`type & 0x03 = 1` → 数据帧；`type >> 2 = 0x18` → SubType=0x18（状态灯显示方案数据）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`03`	数据长度 3 字节
data	3	`01 01 03`	TLV：当前状态灯方案
crc	2	`24 80`	CRC16（从 header 到 data 末尾）

响应 data（TLV）解析

01 01 03

Type=0x01（scheme）
Length=0x01
Value=0x03 → 当前状态灯方案为方案 3（全部关闭）

说明：查询成功返回数据帧 0x18，不是 ACK 帧。

恢复默认状态灯显示方案

发送（十六进制）：[0xBC, 0x59, 0x51, 0x58, 0x02, 0x00, 0x00, 0x48, 0x5C]

接收（ACK）：[0xBC, 0x59, 0x51, 0x5A, 0x06, 0x00, 0x01, 0x01, 0x38, 0xAE]

请求帧字段解析

请求帧：[0xBC, 0x59, 0x51, 0x58, 0x02, 0x00, 0x00, 0x48, 0x5C]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`58`	`type & 0x03 = 0` → 控制帧；`type >> 2 = 0x16` → SubType=0x16（恢复默认状态灯显示方案）
ctrl	1	`02`	包含 CRC（`0x02`）
seq	1	`00`	序号（示例为 0）
len	1	`00`	数据长度为 0（本指令无 payload）
crc	2	`48 5C`	CRC16（从 header 到 data 末尾）

响应帧（ACK）解析

响应帧：[0xBC, 0x59, 0x51, 0x5A, 0x06, 0x00, 0x01, 0x01, 0x38, 0xAE]

字段	字节	值	说明
header	3	`BC 59 51`	固定帧头
type	1	`5A`	`type & 0x03 = 2` → 应答帧；`type >> 2 = 0x16` → SubType=0x16（恢复默认状态灯显示方案的 ACK）
ctrl	1	`06`	`0x04` 设备→手机 + `0x02` 包含 CRC
seq	1	`00`	序号（示例为 0）
len	1	`01`	数据长度 1 字节
payload	1	`01`	结果 0=失败，1=成功（本例为 1，成功）
crc	2	`38 AE`	CRC16（从 header 到 data 末尾）

说明：恢复默认成功后立即回退到方案 1，不会重启设备。

例子

提供了Flutter 的例子,代码风格人人有别。不喜勿喷。

gitee地址：https://gitee.com/buddycoder/u2mdemo

蓝牙配置协议 ​

帧格式 ​

header ​

type ​

Main Type ​

Sub Type ​

控制帧的Sub Type ​

数据帧的Sub Type ​

应答帧 Sub Type ​

ctrl ​

seq ​

len ​

data_total ​

data ​

crc ​

Data格式 （TLV） ​

WIFI设置 ​

MQTT设置： ​

串口设置命令 ​

BLE前缀和透传运行态配置 ​

状态采集指令 ​

OTA_URL 设置命令 （预留） ​

低功耗设置命令 ​

状态灯显示方案配置 ​

BLE前缀和透传运行态 ​

默认值 ​

请求约束 ​

编码说明 ​

对透传功能的影响 ​

TLV 示例 ​

状态灯显示方案配置 ​

默认值 ​

方案值定义 ​

请求约束 ​

行为说明 ​

编码说明 ​

WIFI 断网原因对照表 ​

长度限制 ​

参数 ​

透传 ​

分帧说明 ​

指令例子 ​

WI-FI状态查询 ​

请求帧字段解析 ​

响应帧字段解析 ​

响应 data（TLV）解析 ​

MQTT状态查询 ​

请求帧字段解析 ​

响应帧字段解析 ​

响应 data（TLV）解析 ​

UART参数查询 ​

请求帧字段解析 ​

响应帧字段解析 ​

响应 data（TLV）解析 ​

版本信息查询 ​

请求帧字段解析 ​

响应帧字段解析 ​

设置 Wi‑Fi（分帧示例） ​

分片请求帧字段解析（以第 1 帧为例） ​

合帧（把 3 个分片的 data 拼接） ​

合并后 data（TLV）解析 ​

响应帧（ACK）解析 ​

设置 MQTT（分帧示例） ​

分片请求帧字段解析（以第 1 帧为例） ​

合帧（把 7 个分片的 data 拼接） ​

合并后 data（TLV）解析 ​

响应帧（ACK）解析 ​

设置 UART（分帧示例） ​

分片请求帧字段解析（以第 1 帧为例） ​

合帧（把 2 个分片的 data 拼接） ​

合并后 data（TLV）解析 ​

响应帧（ACK）解析 ​

设置 BLE前缀和透传运行态配置（分帧示例） ​

分片请求帧字段解析（以第 1 帧为例） ​

合帧（把 3 个分片的 data 拼接） ​

合并后 data（TLV）解析 ​

响应帧（ACK）解析 ​

查询 BLE前缀和透传运行态配置 ​

请求帧字段解析 ​

响应帧字段解析 ​

蓝牙配置协议

帧格式

header

type

Main Type

Sub Type

控制帧的Sub Type

数据帧的Sub Type

应答帧 Sub Type

ctrl

seq

len

data_total

data

crc

Data格式（TLV）

WIFI设置

MQTT设置：

串口设置命令

BLE前缀和透传运行态配置

状态采集指令

OTA_URL 设置命令（预留）

低功耗设置命令

状态灯显示方案配置

BLE前缀和透传运行态

默认值

请求约束

编码说明

对透传功能的影响

TLV 示例

状态灯显示方案配置

默认值

方案值定义

请求约束

行为说明

编码说明

WIFI 断网原因对照表

长度限制

参数

透传

分帧说明

指令例子

WI-FI状态查询

请求帧字段解析

响应帧字段解析

响应 data（TLV）解析

MQTT状态查询

请求帧字段解析

响应帧字段解析

响应 data（TLV）解析

UART参数查询

请求帧字段解析

响应帧字段解析

响应 data（TLV）解析

版本信息查询

请求帧字段解析

响应帧字段解析

设置 Wi‑Fi（分帧示例）

分片请求帧字段解析（以第 1 帧为例）

合帧（把 3 个分片的 data 拼接）

合并后 data（TLV）解析

响应帧（ACK）解析

设置 MQTT（分帧示例）

分片请求帧字段解析（以第 1 帧为例）

合帧（把 7 个分片的 data 拼接）

合并后 data（TLV）解析

响应帧（ACK）解析

设置 UART（分帧示例）

分片请求帧字段解析（以第 1 帧为例）

合帧（把 2 个分片的 data 拼接）

合并后 data（TLV）解析

响应帧（ACK）解析

设置 BLE前缀和透传运行态配置（分帧示例）

分片请求帧字段解析（以第 1 帧为例）

合帧（把 3 个分片的 data 拼接）

合并后 data（TLV）解析

响应帧（ACK）解析

查询 BLE前缀和透传运行态配置

请求帧字段解析

响应帧字段解析