- 新增 docs/网关配置教程.md (基于 E104-BT12+tool 使用教程-V1.0.docx) - 更新 PRD.md: - 更新网关型号为 E104-BT12USP - 添加 danglo 组网工具配置步骤 - 添加协议帧格式详细说明 - 添加组网配置要点和订阅限制 - 移除不存在的 bleak-mesh 依赖 - 保存网关配置要点到记忆 (gateway_config.md)
4.1 KiB
4.1 KiB
E104-BT12USP 网关配置教程
一、准备工作
硬件准备
- 上位机(运行配置软件的 PC)
- E104-BT12USP 串口模块(USB 接口)
软件准备
- 亿佰特官方配置软件(danglo 组网工具)
二、使用 danglo 组网
2.1 连接设备
- 插入 E104-BT12USP 模块到 USB
- 打开上位机配置软件
- 选择 UART 模式
- 选择对应的串口号(E104-BT12USP)
- 点击 Connect 连接
2.2 扫描设备
- 模块上电后,在上位机选择 SCAN
- 双击需要组网的设备地址进行配网
2.3 配网(PROV)
- 选择 PROV 选项卡
- 设置参数(仅 USB dongle 首次使用需要)
- 点击 PROV 开始配网
2.4 绑定 APP Key
配网完成后,绑定 APP Key
2.5 控制设备
- 点击 Mesh 进入新页面
- 点击 ON/OFF 控制灯的开关
- 需要连接多个设备时,重复上述组网操作
三、发布订阅设置(分组)
3.1 分组概念
发布和订阅即将多个模块分配到一个虚拟地址下(分组)。同一组内的设备可以互相通信。
3.2 实现分组步骤
- 双击节点地址(如 001)获取节点地址
- 在 GROUP 栏勾选需要分配的组
- 将设备的灯控 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 | (预留) |
九、调试建议
- 首次配网: 确保 USB dongle 参数正确设置
- 组地址: 使用 0xC000 以上的地址作为组地址
- Model ID: 注意不同设备类型的 Model ID
- 低功耗设备: 需要特别处理组地址订阅
文档版本: V1.0 参考原文档: E104-BT12+tool 使用教程-V1.0.docx (亿佰特电子科技有限公司)