事件记录
事件记录模块用于查询门锁的操作记录，包括开锁记录、添加/删除用户记录、报警记录等。
概述
事件记录模块通过通用扩展指令(0x3030)实现。
主要功能：
- 按时间查询：查询指定时间之后的事件记录
- 事件类型：支持多种事件类型（开锁、添加用户、报警等）
- 批量读取：支持一次读取多条记录
通用扩展指令
所有事件记录操作使用父指令 0x3030，通过子指令码区分具体功能。数据包格式参考 数据包格式。
时间条件查询事件记录
查询指定时间之后的事件记录。
子指令码
41
请求参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| KeyID | 字符串 | 40 | 钥匙 ID |
| UserID | 字符串 | 20 | 用户 ID |
| LogsCount | 整型 | 2 | 读取数量 |
| Time | 整型 | 4 | 开始时间（UNIX 时间） |
| TimeStamp | 整型 | 4 | 当前时间戳（UTC） |
响应参数
| 字段名称 | 类型 | 长度 | 说明 |
|---|---|---|---|
| LogsCount | 整型 | 2 | 实际返回数量 |
| Type | 整型 | 1 | 事件类型 |
| UserNo | 整型 | 2 | 用户编号0xFFFF: 离线密码开锁 |
| Time | 整型 | 4 | 事件时间（UNIX 时间） |
| Password | 字符串 | 10 | 开门密码 非密码开门为 0离线密码使用 16 进制编码 |
| ... | 混合 | 17×N | 如果 LogsCount > 1，重复 Type 到 Password 字段 |
离线密码格式
离线密码使用 16 进制编码，例如密码 45787823321 编码为 0x45, 0x78, 0x78, 0x23, 0x32, 0x1F，其中 F 代表结束符。
事件类型定义
开锁事件
| 常量值 | 常量名 | 事件名称 |
|---|---|---|
| 1 | FINGERPRINT_UNLOCK | 指纹解锁 |
| 2 | PWD_UNLOCK | 密码解锁 |
| 3 | IC_UNLOCK | IC卡解锁 |
| 4 | APP_UNLOCK | 蓝牙APP解锁 |
| 5 | COMBINATION_UNLOCK | 组合解锁 |
| 16 | FACE_UNLOCK | 人脸开锁 |
| 19 | PALM_VEIN_UNLOCK | 掌静脉解锁 |
| 22 | REMOTE_CONTROL_UNLOCK | 遥控开锁 |
| 26 | BACK_DOOR_KEY_UNLOCK | 门内按键开锁 |
| 27 | BACK_DOOR_HANDLE_UNLOCK | 门内把手开锁 |
| 36 | REMOTE_KEY_UNLOCK | 远程开锁 |
| 43 | HOTEL_IC_UNLOCK | 酒店IC卡开锁 |
| 44 | DOOR_CLOSED | 关门事件 |
| 45 | LOCKED | 反锁事件 |
| 46 | OFFLINE_PWD_UNLOCK | 离线密码开门 |
添加/删除事件
| 常量值 | 常量名 | 事件名称 |
|---|---|---|
| 6 | ADD_FINGERPRINT | 添加指纹 |
| 7 | ADD_PWD | 添加密码 |
| 8 | ADD_IC | 添加IC卡 |
| 9 | DELETE_FINGERPRINT | 删除指纹 |
| 10 | DELETE_PWD | 删除密码 |
| 11 | DELETE_IC | 删除IC卡 |
| 17 | ADD_FACE | 添加人脸 |
| 18 | DELETE_FACE | 删除人脸 |
| 20 | PALM_VEIN | 添加掌静脉 |
| 21 | DELETE_PALM_VEIN | 删除掌静脉 |
| 23 | ADD_REMOTE_CONTROL | 添加遥控 |
| 24 | DELETE_REMOTE_CONTROL | 删除遥控 |
重置事件
| 常量值 | 常量名 | 事件名称 |
|---|---|---|
| 14 | DELETE_ALL_USER | 删除所有用户 |
| 25 | CLEAR_CODE_CLEAR_PWD | 清空密码 |
| 30 | DELETE_ALL_FINGERPRINT | 重置指纹 |
| 31 | DELETE_ALL_PWD | 重置密码 |
| 32 | RESET_IC | 重置卡片 |
| 33 | RESET_FACE | 重置人脸 |
| 34 | RESET_PALM_VEIN | 重置掌静脉 |
| 35 | RESET_REMOTE_CONTROL | 重置遥控 |
| 37 | GROUP_DELETE_FINGERPRINT | 分组删除指纹 |
| 38 | GROUP_DELETE_PWD | 分组删除密码 |
| 39 | GROUP_DELETE_IC | 分组删除卡片 |
| 40 | GROUP_DELETE_FACE | 分组删除人脸 |
| 41 | GROUP_DELETE_PALM_VEIN | 分组删除掌静脉 |
| 42 | GROUP_DELETE_REMOTE_CONTROL | 分组删除遥控 |
| 47 | UNBIND_DEVICE | 解绑设备 |
报警事件
| 常量值 | 常量名 | 事件名称 |
|---|---|---|
| 12 | ERROR | 错误冻结/多次尝试告警 |
| 13 | TAMPER | 防撬防拆事件 |
| 15 | LOW_POWER | 电池电量低 |
| 28 | STAY_ALARM | 逗留/徘徊报警 |
| 128 | FORCE_FINGERPRINT_UNLOCK | 胁迫指纹开锁 |
| 129 | FORCE_PWD_UNLOCK | 胁迫密码开锁 |
| 130 | FORCE_IC_UNLOCK | 胁迫IC卡开锁 |
| 131 | FORCE_FACE_UNLOCK | 胁迫人脸开锁 |
| 132 | FORCE_PALM_VEIN_UNLOCK | 胁迫掌静脉开锁 |
| 133 | FORCE_REMOTE_CONTROL_UNLOCK | 胁迫遥控开锁 |
| 134 | DOOR_NOT_CLOSED | 门未关好 |
| 156 | OBSTRUCTION | 遮挡报警 |
其他事件
| 常量值 | 常量名 | 事件名称 |
|---|---|---|
| 0 | UNKNOWN | 未知事件 |
| 29 | PASSAGE_MODE | 常开模式 |
| 135 | TIME_SYNC | 时间同步 |
| 159 | DOORBELL | 门铃 |
| 160 | DEVICE_FACTORY_RESET | 锁端恢复出厂设置（WiFi锁专用，设备删除数据前上传） |