docs(DLD154Pro): 新增蓝牙小程序接口协议文档 (依据 dbn_ble_srv.c)

- §1 BLE 服务: 0xFFE0 服务, Char1(0xFFE1 RW 命令下发)/Char4(0xFFE4 Notify)
- §2 帧格式: Magic(8F/7F)+Header+Len+CMD+Data+XOR+SUM
- §3 分包: 14B 写死 (MTU=23 旧假设), Header=(amount<<4)|seq
- §4-5 命令: 0x10/0x1F/0x23/0x24/0x31/0x8A/0x92/0xC5 逐字段
- §6 主动上报 0xC0: type=5 线圈动态 (频率+360补偿, variation 3B有符号)
- §7 坑清单: sensitvity 1~4 (≠vd960Loop 0~3), 0xC5 超时疑bug, 0x8A 写表依赖重载
- devlog 置顶 2026-08-25 条目

docs/devlog.md

@@ -4,6 +4,38 @@
 
 ---
 
+## 2026-08-25 — 蓝牙小程序接口协议文档
+
+### 背景
+
+根据 `dbn_ble_srv.c`（+ peripheral.c/gattprofile.c/storage.h/cmcng.h）整理蓝牙小程序与芯片交互的完整接口协议，供小程序开发对接。
+
+### 文档要点
+
+| 章节 | 内容 |
+|------|------|
+| §1 BLE 服务 | 服务 0xFFE0；Char1(0xFFE1 RW 命令下发)、Char4(0xFFE4 Notify 响应/上报)；MTU 协商 + notify ≤ MTU−3 |
+| §2 帧格式 | Magic(8F/7F)+Header+Len+CMD+Data+XOR+SUM；校验从 Header 起 |
+| §3 分包 | 发送按 14B 写死分包（MTU=23 旧假设）；Header=(amount<<4)\|seq |
+| §4-5 命令 | 0x10/0x1F/0x23/0x24/0x31/0x8A/0x92/0xC5 逐字段 |
+| §6 主动上报 | 0xC0 线圈动态（type=5，含频率+360 补偿、variation 3B 有符号） |
+| §7 坑清单 | sensitvity 1~4（≠vd960Loop 0~3）、0xC5 超时疑 bug、0x8A 写表依赖 para_store_init、notify 超限静默丢弃 |
+
+### 关键发现（源码事实）
+
+1. **sensitvity 协议层 1~4**，内部 `g_freq_sens = sensitvity − 1`（0~3 索引灵敏度表 {108,54,28,14}），0x24 回读 +1——**与 vd960Loop 的 0~3 不同**
+2. **0xC5 超时疑似 bug**：`timeout_counter = timeout_min × 60 × 100`，若意图 ms 应为 ×1000（现场验证）
+3. 0x8A 写灵敏度表不直接更新 RAM，依赖 `para_store_init()` 重读
+4. 0x1F/0x92 复位/出厂类命令无响应帧
+
+### 涉及文件
+
+| 文件 | 内容 |
+|------|------|
+| `docs/ble-protocol.md` | 新增（依据 dbn_ble_srv.c 整理，固件 V3.03） |
+
+---
+
 ## 2026-07-31 — 发布 V3.03
 
 ### 变更摘要