掌静脉模块
掌静脉模块用于管理门锁的掌静脉识别功能，包括掌静脉的录入、修改、删除和确认操作。
概述
掌静脉模块通过通用扩展指令(0x3030)实现，使用不同的子指令码区分具体操作。
掌静脉注册流程：
- APP 发送注册开始指令
- 用户在门锁传感器前进行掌静脉采集
- 注册完成后门锁推送确认消息
- APP 可随时取消注册
通用扩展指令
所有掌静脉操作使用父指令 0x3030，通过子指令码区分具体功能。数据包格式参考 数据包格式。
注册掌静脉开始
启动掌静脉注册流程，支持限时、循环、胁迫等高级设置。
子指令码
42
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| 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 | 门锁上的序号 |
注册掌静脉确认
门锁在掌静脉注册完成后主动推送此消息给 APP。
子指令码
43
请求参数
无（由门锁主动推送）
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| Status | 整型 | 1 | 注册状态 |
| No | 整型 | 2 | 门锁上的序号 |
状态码说明
| 值 | 说明 |
|---|---|
0x00 | 成功 |
0xFF | 注册取消 |
0xFE | 管理员已满 |
0xFD | 用户已满 |
0xFC | 掌静脉已满 |
0xFB | 掌静脉已存在 |
注册掌静脉取消
取消正在进行的掌静脉注册流程。
子指令码
44
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
响应参数
无