TWS 耳机 BLE GATT 服务表 (Finalized)¶

芯片: 杰理 AC7002 | 蓝牙版本: BT 5.3 | 配对方式: Just Works 文档版本: v1.0 | 最后更新: 2026-05-17 | 来源: docs/ble-protocol.md

1. 服务概览¶

注意: APP 端只需要发现 0xFEE0 和 0xFEE4 两个自定义服务即可。

2. 设备信息服务 (0xFEE0)¶

2.1 特征值总表¶

2.2 特征值 0xFEE1: 设备状态¶

Read 响应 (12 bytes):

Notify 格式 (4 bytes) — 状态变化时自动推送:

2.3 特征值 0xFEE2: 控制指令¶

请求格式 (3 bytes):

指令定义表:

Write 响应 (1 byte):

2.4 特征值 0xFEE3: 事件通知¶

格式 (2 bytes):

事件定义:

3. OTA 升级服务 (0xFEE4)¶

3.1 特征值总表¶

3.2 特征值 0xFEE5: OTA 控制¶

请求格式 (4 bytes):

操作码:

Write 响应 (1 byte): 0x00=ACK, 0x01~0x04=NACK (格式/容量/CRC/忙)

3.3 特征值 0xFEE6: OTA 数据通道¶

• MTU 建议 ≥ 512 bytes
• 默认块大小 128 bytes, 可通过 OTA_SET_BLOCK_SIZE 调整
• Write Without Response, 连续写入无需等待

3.4 特征值 0xFEE7: OTA 状态¶

格式 (4 bytes):

状态类型:

错误码: 0x0001=存储写入失败, 0x0002=Flash擦除失败, 0x0003=CRC校验失败, 0x0004=固件大小不匹配, 0x0005=固件签名无效, 0x0006=超时, 0x0007=蓝牙断开

4. 广播数据格式 (扫描阶段)¶

Manufacturer Data (6 bytes):

5. APP 端常量定义 (建议)¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

// Service UUIDs
const String SERVICE_DEVICE_INFO  = '0000fee0-0000-1000-8000-00805f9b34fb';
const String SERVICE_OTA          = '0000fee4-0000-1000-8000-00805f9b34fb';

// Characteristic UUIDs (Device Info Service)
const String CHAR_DEVICE_STATUS   = '0000fee1-0000-1000-8000-00805f9b34fb';
const String CHAR_CONTROL_CMD     = '0000fee2-0000-1000-8000-00805f9b34fb';
const String CHAR_EVENT_NOTIFY    = '0000fee3-0000-1000-8000-00805f9b34fb';

// Characteristic UUIDs (OTA Service)
const String CHAR_OTA_CONTROL     = '0000fee5-0000-1000-8000-00805f9b34fb';
const String CHAR_OTA_DATA        = '0000fee6-0000-1000-8000-00805f9b34fb';
const String CHAR_OTA_STATUS      = '0000fee7-0000-1000-8000-00805f9b34fb';

注意: 所有自定义 UUID 使用 16-bit 短 UUID (0xFEE0~0xFEE7), 在 BLE 协议中需要补齐为标准 128-bit UUID: 0000XXXX-0000-1000-8000-00805F9B34FB.

文档结束 — 对应 ble-protocol.md v1.0, 确认所有服务/特征值定义一致。