遥控模块
遥控模块用于管理门锁的蓝牙遥控器，包括遥控器的注册、修改、删除和确认操作。
概述
遥控模块通过通用扩展指令(0x3030)实现，使用不同的子指令码区分具体操作。
遥控器注册流程：
- APP 发送注册开始指令
- 用户按下遥控器配对按钮
- 门锁识别遥控器并推送确认消息
- APP 可随时取消注册
注意
遥控器不能注册为管理员角色。
通用扩展指令
所有遥控操作使用父指令 0x3030，通过子指令码区分具体功能。数据包格式参考 数据包格式。
注册遥控开始
启动遥控器注册流程，支持限时、循环、胁迫等高级设置。
子指令码
26
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| CardNo | 整型 | 2 | 遥控序号（可任意设置，以返回为准） |
| UseCountLimit | 整型 | 2 | 使用次数限制0xFFFF: 不限次数 |
| Operate | 整型 | 1 | 操作类型0: 注册1: 修改2: 删除3: 删除全部 |
| IsAdmin | 整型 | 1 | 是否管理员（遥控不能注册管理员） |
| IsForce | 整型 | 1 | 是否胁迫 |
| Token | 整型 | 4 | 动态口令 |
| IsRound | 整型 | 1 | 是否循环使用 |
| WeekRound | 整型 | 1 | 循环周期 Bit0-6 置位分别代表周日至周六 |
| StartDate | 整型 | 4 | 生效日期（UNIX 时间） |
| EndDate | 整型 | 4 | 失效日期（UNIX 时间） |
| StartTime | 整型 | 4 | 每日生效时间（UNIX 时间） |
| EndTime | 整型 | 4 | 每日失效时间（UNIX 时间） |
| AuthCodeLen | 整型 | 1 | 鉴权码长度 |
| AuthCode | 字符串 | 变长 | 鉴权码 |
鉴权码计算
鉴权码计算方法参考 加密与签名 文档。
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| Token | 整型 | 4 | 动态口令 |
| Status | 整型 | 1 | 状态码0: 成功 |
| No | 整型 | 2 | 门锁上的序号 |
注册遥控取消
取消正在进行的遥控器注册流程。
子指令码
28
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
响应参数
无
注册遥控确认
门锁在遥控器注册完成后主动推送此消息给 APP。
子指令码
27
请求参数
无（由门锁主动推送）
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| Status | 整型 | 1 | 注册状态 |
| No | 整型 | 2 | 门锁上的序号 |
状态码说明
| 值 | 说明 |
|---|---|
0x00 | 成功 |
0xFF | 注册取消 |
0xFE | 管理员已满 |
0xFD | 用户已满 |
0xFC | 遥控已满 |
0xFB | 遥控已存在 |