docs: 更新网关配置文档

- 新增 docs/网关配置教程.md (基于 E104-BT12+tool 使用教程-V1.0.docx) - 更新 PRD.md: - 更新网关型号为 E104-BT12USP - 添加 danglo 组网工具配置步骤 - 添加协议帧格式详细说明 - 添加组网配置要点和订阅限制 - 移除不存在的 bleak-mesh 依赖 - 保存网关配置要点到记忆 (gateway_config.md)
2026-04-16 11:49:49 +08:00 · 2026-04-16 11:49:49 +08:00 · f1f2c77af4
commit f1f2c77af4
parent 9c71db2807
2 changed files with 198 additions and 4 deletions
--- a/PRD.md
+++ b/PRD.md
@ -79,12 +79,26 @@

 ### 2.3 硬件规格

-**SigMesh 网关 (E104-BT12NSP)**:
+**SigMesh 网关 (E104-BT12USP)**:
 - 芯片：Nordic nRF52840
 - 协议：Bluetooth 5.4 Mesh
- 接口：UART (USB 转 TTL)
+- 接口：USB 直连（内置 USB 转 UART）
 - 串口参数：115200, 8N1

+**网关配置工具**:
+- 软件：亿佰特 danglo 组网工具
+- 配网方式：PROV 配网
+- 组网管理：支持设备扫描、配网、分组
+- 设备控制：支持 ON/OFF、亮度、色温控制
+
+**重要配置说明**:
+1. 首次使用需通过 danglo 工具配置 USB dongle 参数
+2. 设备配网：SCAN 扫描 → 双击设备 → PROV 配网 → 绑定 APP Key
+3. 分组管理：通过 GROUP 设置将设备分配到组地址
+4. 手机 APP 默认订阅：0x1307 (SIG_MD_LIGHT_HSL_S)
+5. 天猫精灵默认订阅：0x10 (SIG_MD_G_ONOFF_S)
+6. 低功耗节点组传输：需将 Lightness Model 和 Vendor Model 分配到同一组
+
 ---

 ## 3. 需求范围
@ -110,8 +124,7 @@
 SigMesh Gateway 集成
 ├── 依赖：Home Assistant ≥ 2024.1.0
 ├── 依赖：HACS ≥ 1.34.0
-├── 依赖：pyserial-asyncio ≥ 0.6
-└── 依赖：bleak-mesh ≥ 0.2.0
+└── 依赖：pyserial-asyncio-fast ≥ 0.6
 ```

 ---
@ -159,6 +172,27 @@ Mesh 消息:
 | mac | string | 12 字符 | MAC 地址 |
 | element_count | int | 1-2 字符 | 元素数量 |

+**协议帧格式 (基于亿佰特文档)**:
+
+```
+通用帧结构：
+[Cmd 头] [固定字段] [目标地址] [操作码] [元素地址] [组地址/参数] [ModelID] [校验/结束]
+
+命令头：e8 ff (所有命令以此开头)
+```
+
+**常见操作码**:
+| 操作码 | 功能 |
+|--------|------|
+| 80 1b | 加入组/设置 |
+| 80 1d | 删除组 |
+
+**组网配置要点**:
+- 组地址：使用 0xC000 以上的地址作为组地址
+- 手机 APP 默认订阅：0x1307 (SIG_MD_LIGHT_HSL_S)
+- 天猫精灵默认订阅：0x0010 (SIG_MD_G_ONOFF_S)
+- 低功耗节点：需将 Lightness Model 和 Vendor Model 分配到同一组才能接收组地址传输
+
 ### 4.3 支持的 Opcode 列表

 | Opcode | 名称 | 模型 ID | 数据长度 | 解析状态 |
--- a/docs/网关配置教程.md
+++ b/docs/网关配置教程.md
@ -0,0 +1,160 @@
+# E104-BT12USP 网关配置教程
+
+## 一、准备工作
+
+### 硬件准备
+- 上位机（运行配置软件的 PC）
+- E104-BT12USP 串口模块（USB 接口）
+
+### 软件准备
+- 亿佰特官方配置软件（danglo 组网工具）
+
+## 二、使用 danglo 组网
+
+### 2.1 连接设备
+1. 插入 E104-BT12USP 模块到 USB
+2. 打开上位机配置软件
+3. 选择 **UART** 模式
+4. 选择对应的串口号（E104-BT12USP）
+5. 点击 **Connect** 连接
+
+### 2.2 扫描设备
+1. 模块上电后，在上位机选择 **SCAN**
+2. 双击需要组网的设备地址进行配网
+
+### 2.3 配网（PROV）
+1. 选择 **PROV** 选项卡
+2. 设置参数（仅 USB dongle 首次使用需要）
+3. 点击 PROV 开始配网
+
+### 2.4 绑定 APP Key
+配网完成后，绑定 APP Key
+
+### 2.5 控制设备
+1. 点击 **Mesh** 进入新页面
+2. 点击 **ON/OFF** 控制灯的开关
+3. 需要连接多个设备时，重复上述组网操作
+
+## 三、发布订阅设置（分组）
+
+### 3.1 分组概念
+发布和订阅即将多个模块分配到一个虚拟地址下（分组）。同一组内的设备可以互相通信。
+
+### 3.2 实现分组步骤
+1. 双击节点地址（如 001）获取节点地址
+2. 在 **GROUP** 栏勾选需要分配的组
+3. 将设备的灯控 Model 分配到组中
+
+> **注意**: 以上方法仅将灯控 Model 分组，其余 Model 需要参考分组章节另行配置
+
+## 四、SIG 分组
+
+### 4.1 SIG OP 代码
+- SIG OP: `80 1B`
+
+### 4.2 加入组
+**指令实例**:
+```
+e8 ff 00 00 00 00 02 01 08 00 80 1b 08 00 00 c0 00 10
+```
+
+**协议解析**:
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| Cmd 头 | e8 ff | 命令头 |
+| 固定 | 00 00 | 固定字段 |
+| 固定 | 00 00 | 固定字段 |
+| 未知 | 02 01 | 未知字段 |
+| 目标地址 | 08 00 | 目标设备地址 |
+| SIG OP | 80 1b | SIG 操作码 |
+| 元素地址 | 08 00 | 元素地址 |
+| 组地址 | 00 c0 | 组地址（0xC000） |
+| ModleID | 00 10 | Model ID |
+
+### 4.3 删除组
+**指令实例**:
+```
+e8 ff 00 00 00 00 02 01 08 00 80 1d 08 00 00 10
+```
+
+**协议解析**:
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| Cmd 头 | e8 ff | 命令头 |
+| 固定 | 00 00 | 固定字段 |
+| 固定 | 00 00 | 固定字段 |
+| 未知 | 02 01 | 未知字段 |
+| 目标地址 | 08 00 | 目标设备地址 |
+| SIG OP | 80 1d | SIG 操作码（删除） |
+| 目标地址 | 08 00 | 目标地址 |
+| ModleID | 00 10 | Model ID |
+
+## 五、VENDOR 分组
+
+### 5.1 加入组
+**指令实例**:
+```
+e8 ff 00 00 00 00 02 01 02 00 80 1b 02 00 01 c0 11 02 00 00
+```
+
+**协议解析**:
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| Cmd 头 | e8 ff | 命令头 |
+| 固定字段 | 00 00 | 固定字段 |
+| 固定 | 00 00 | 固定字段 |
+| 固定 | 02 01 | 固定字段 |
+| 目标地址 | 02 00 | 目标设备地址 |
+| Sig op | 80 1b | SIG 操作码 |
+| 元素地址 | 02 00 | 元素地址 |
+| 组地址 | 01 c0 | 组地址 |
+| ModleID | 11 02 | Model ID |
+| 固定 | 00 00 | 固定字段 |
+
+## 六、重要注意事项
+
+### 6.1 APP 订阅限制
+- **手机 APP 默认只能订阅**: `0X1307` (SIG_MD_LIGHT_HSL_S)
+- **天猫精灵只订阅**: `0010` (SIG_MD_G_ONOFF_S)
+
+### 6.2 低功耗节点组传输
+低功耗节点的组传输需要将 **Lightness Model** 和 **Vendor Model** 分配到同一个组下面才能接收组地址传输。
+
+## 七、串口通信参数
+
+| 参数 | 值 |
+|------|-----|
+| 波特率 | 115200 |
+| 数据位 | 8 |
+| 停止位 | 1 |
+| 校验位 | None |
+| 流控制 | None |
+
+## 八、协议帧格式
+
+### 8.1 通用帧结构
+```
+[e8 ff] [固定字段] [目标地址] [操作码] [元素地址] [组地址/参数] [ModelID] [校验/结束]
+```
+
+### 8.2 命令头
+- 所有命令以 `e8 ff` 开头
+
+### 8.3 常见操作码
+| 操作码 | 功能 |
+|--------|------|
+| 80 1b | 加入组/设置 |
+| 80 1d | 删除组 |
+| 80 1c | (预留) |
+
+## 九、调试建议
+
+1. **首次配网**: 确保 USB dongle 参数正确设置
+2. **组地址**: 使用 0xC000 以上的地址作为组地址
+3. **Model ID**: 注意不同设备类型的 Model ID
+4. **低功耗设备**: 需要特别处理组地址订阅
+
+---
+
+**文档版本**: V1.0
+**参考原文档**: E104-BT12+tool 使用教程-V1.0.docx (亿佰特电子科技有限公司)