f1f2c77af4
- 新增 docs/网关配置教程.md (基于 E104-BT12+tool 使用教程-V1.0.docx) - 更新 PRD.md: - 更新网关型号为 E104-BT12USP - 添加 danglo 组网工具配置步骤 - 添加协议帧格式详细说明 - 添加组网配置要点和订阅限制 - 移除不存在的 bleak-mesh 依赖 - 保存网关配置要点到记忆 (gateway_config.md)
161 lines
4.1 KiB
Markdown
161 lines
4.1 KiB
Markdown
# 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 (亿佰特电子科技有限公司)
|