密码模块

密码模块用于管理门锁的开锁密码，包括管理员密码和普通开锁密码的设置、修改、删除和读取操作。

概述

密码模块通过通用扩展指令(0x3030)实现，使用不同的子指令码区分具体操作。

主要功能：

• 管理员密码：修改管理员密码
• 开锁密码：设置、修改、删除开锁密码
• 批量操作：清空所有开锁密码
• 密码查询：读取已设置的管理员密码

通用扩展指令

所有密码操作使用父指令 0x3030，通过子指令码区分具体功能。数据包格式参考 数据包格式。

修改管理员密码

子指令码

2

请求参数

字段名称	类型	长度	说明
KeyID	字符串	40	钥匙 ID
UserID	字符串	20	用户 ID
PwdNo	整型	2	密码序号
Pwd	字符串	20	新管理员密码
UseCountLimit	整型	2	使用次数限制 0xFFFF: 不限次数
Token	整型	4	动态口令
StartTime	整型	4	密码生效时间（UNIX 时间）
EndTime	整型	4	密码过期时间（UNIX 时间） 与用户钥匙过期时间一致，过期自动清除
AuthCodeLen	整型	1	鉴权码长度
AuthCode	字符串	变长	鉴权码

鉴权码计算

鉴权码计算方法参考 加密与签名 文档。

响应参数

字段名称	类型	长度	说明
Token	整型	4	动态口令
No	整型	2	门锁上的序号

设置开锁密码

用于注册、修改或删除开锁密码。

子指令码

3

请求参数

字段名称	类型	长度	说明
KeyID	字符串	40	钥匙 ID
UserID	字符串	20	用户 ID
PwdNo	整型	2	密码序号（可任意设置，以返回为准）
Operate	整型	1	操作类型 0: 注册 1: 修改 2: 删除自定义密码 3: 删除离线密码
IsAdmin	整型	1	是否管理员密码
Pwd	字符串	20	开锁密码
UseCountLimit	整型	2	使用次数限制 0xFFFF: 不限次数
Token	整型	4	动态口令
StartTime	整型	4	密码生效时间（UNIX 时间）
EndTime	整型	4	密码过期时间（UNIX 时间） 与用户钥匙过期时间一致，过期自动清除
AuthCodeLen	整型	1	鉴权码长度
AuthCode	字符串	变长	鉴权码

响应参数

字段名称	类型	长度	说明
Token	整型	4	动态口令
No	整型	2	门锁上的序号
Status	整型	1	注册状态

状态码说明

值	说明
0x00	成功
0xFF	注册取消
0xFE	管理员已满
0xFD	用户已满
0xFC	密码已满
0xFB	密码已存在

清空开锁密码

清空所有开锁密码，同时重置自定义密码和离线密码。

子指令码

19

请求参数

字段名称	类型	长度	说明
KeyID	字符串	40	钥匙 ID
UserID	字符串	20	用户 ID
Token	整型	4	动态口令
AuthCodeLen	整型	1	鉴权码长度
AuthCode	字符串	变长	鉴权码

危险操作

清空密码会删除所有已设置的开锁密码，包括自定义密码和离线密码，请谨慎操作。

响应参数

字段名称	类型	长度	说明
Token	整型	4	动态口令
EncrpyKey	整型	8	离线密码算法 KEY

读取管理员密码

读取已设置的管理员密码列表。

子指令码

74

请求参数

字段名称	类型	长度	说明
KeyID	字符串	40	钥匙 ID
UserID	字符串	20	用户 ID
Role	整型	1	用户角色 0: 普通用户 1: 管理员 0xFF: 超级管理员
PwdNum	整型	1	读取数量
PwdNo	整型	1	开始序号

响应参数

字段名称	类型	长度	说明
PwdCount	整型	1	读取数量
PwdNo	整型	1	密码序号
Pwd	字符串	10	密码
UseCountLimit	整型	1	保留字段
UserNo	整型	1	用户编号
...	混合	13×N	如果 PwdNum > 1，重复 PwdNo 到 UserNo 字段