公寓锁-DP解释说明

前言

该文档为Zigbee公寓门锁模组协议DP解释说明文档，包含具体实现逻辑。 Zigbee公寓门锁DP解释说明腾讯文档：Zigbee公寓门锁DP解释说明

1 超级用户密码管理

1.1 超级用户密码管理 Dp1

raw类型数据结构: raw类型: 操作类型+成员类型+密码编号+密码长度+密码内容 a)下发：操作类型+成员类型+密码编号+密码长度+密码内容

d)修改/复位：修改+成员类型+密码编号+密码长度+密码内容 e)冻结/解冻：冻结+成员类型+密码编号

设备上报： f) 修改/复位+成员类型+密码编号+密码长度+密码内容+状态 g) 冻结/解冻+成员类型+密码编号+状态

mcu端逻辑： 1. 层级：公寓锁用户层级分为三层：管理员、管家、普通租客。 2.密码编号： 管理员、管家各有且仅有1位，成员类型01位管理员，02为管家；普通租客有N位，建议N>=100。（卡数+密码数+指纹数 >= 100，且任意单一开门方式数 <= 0.8N ，N为存储总数） 3. 各层级操作权限：上一级可新增、删除、冻结、解冻、复位下一级，本级别可修改密码. 4. 密码位数：超级用户密码为8位，管理员为66668888，管家12345678

1. 逻辑：mcu端接收该dp后，解析dp，判断成员类型，解析编号，对 某编号的密码做相关操作。操作结果封装返回。

2. 操作成功才返回密码内容，否则不返回

2 房客密码

2.1 创建房客密码Dp2

raw类型数据结构: raw类型，仅下发，接口上报 涂鸦序号+服务端序号+门锁厂家编号+起始时间+ 终止时间+是否为一次性+密码。 a) 涂鸦序号：Data[0]，Data[1] b) 服务端序号：Data[2] Data [3] c) 门锁厂家编号：Data[4] Data [5]，创建时该值为0x0 0x0 d)起始时间：Data[6]-Data[9]：标准时间戳 e)终止时间：Data[10]-Data[13]：标准时间戳 f) 是否为一次性：Data[14]，1表示为一次性密码，0表示不是一次性密码 g )密码：Data[15]- Data[20] ASCII码对应6位密码

mcu端逻辑： 1. 逻辑：mcu端接收该dp后，解析dp，默认厂商编号为密码编号，解析时间和密码内容，在数据库中创建新密码。如果密码重复或已满，则返回相应状态值。 2. 服务端下发密码编号，涂鸦编号从999开始，递减到1。厂商则使用厂家编号来存储密码。开门记录上报厂家编号。 3. 新创建的密码涂鸦编号从999递减，默认厂商编号为0。

2.2 删除房客密码Dp3

raw类型数据结构: 上报：涂鸦序号+服务端序号+门锁厂家编号涂鸦序号：Data[0] , Data [1]服务端序号：Data[2] , Data [3]门锁厂家编号：Data[4] , Data [5]

下发：涂鸦序号+服务端序号+门锁厂家编号+返回状态 涂鸦序号：Data[0] , Data [1] 服务端序号：Data[2] , Data [3] 门锁厂家编号：Data[4] , Data [5] 返回状态：Data[6]

mcu端逻辑： 逻辑：mcu端收到该dp后，解析dp，默认厂商编号为密码编号，根据编号取出密码并删除。如果密码不存在，则上报该dp，删除失败；否则，删除成功。 厂商根据门锁厂家编号删除对应的密码。

2.4 修改房客密码Dp4

raw类型数据结构: 格式和创建临时密码相同 mcu端逻辑： 逻辑：mcu端接收该dp后，解析dp，默认厂商编号为密码编号，解析时间和密码内容，根据> 编号取出对应的密码内容，覆盖原来的时间和密码内容。如果密码重复，则返回相应状态值。

2.5 冻结/冻结房客密码Dp5/Dp6

mcu端逻辑： mcu端收到该dp后，解析dp，默认厂商编号为密码编号，根据编号取出密码并冻>结，设置密码状态为冻结不可用。如果密码不存在，则上报该dp，冻结失败；否则，冻结成功。

2.6 清空房客密码Dp6

mcu端逻辑： 当app对门锁进行恢复出厂设置时，云端下发指令给门锁，门锁清除本地的临时密码。

如果门锁本地进行恢复出厂设置，清除了本地的临时密码，需要上报该dp点云端，确保云端的临时密码记录和本地保持一致。 如果本地恢复出厂设置时，上报该7失败，需要在下次重新配网后上报7

2.7 离线密码基本时间下发DP7

模块主动上报：入网、重入网、重新上电、定时（暂无定时） 由模块端主动上报，云端再下发 由模块端实现，mcu不用实现该逻辑

3. 1 密码解锁记录上报

mcu端逻辑： 房客密码/管理员密码解锁逻辑：mcu端根据密码值判断密码编号，该密码开门成功，则上报该dp，带密码编号。该密码编号为门锁厂家编号。

动态密码解锁逻辑 1. 动态密码为8位，mcu端逻辑判断该8位密码不为管理员或管家密码，则上报该密码到模块端，模块将密码校验信息（y or n）返回给设备，设备如果开门成功，则上报该dp到模块。 2. 动态密码算法使用的算法与时间有关。

离线密码解锁逻辑 离线密码为10位，mcu端收到该10位密码后，上报模块端，模块判断密码是否为离线密码，模块将密码校验信息（y or n）返回给设备，设备开门后，上报该dp到模块端。离线密码的元数据长度都是16字节。

离线清空码上报逻辑： 1. 离线清空码为10位，mcu端收到该10位清空码后，上报模块端，模块判断密码是否为离线密码清空码； 2. 模块将密码校验信息（y or n）返回给设备，设备输出语音播报 “操作成功”； 3. 上报该dp到模块端 4. 离线密码的元数据长度都是16字节。

3.2 卡/指纹解锁记录上报

未知权限开门: 1. 未知权限开门定义：如果无密码输入，但是锁舌或门磁传感感应到门被打开。 2. 未知权限开门类型： a.无传感钥匙开门, b.无传感有门磁的本地内开门 c.非法开门(mcu能感知到无密码输入的锁芯撬动外开门，mcu上报)

4.1 告警

mcu端逻辑：

1. 试错5次，含5次，mcu上报告警
2. 超时未关门（10s），mcu上报告警
3. 电量耗尽，最后电量小于某个值时，即将关机时，上报该告警dp

mcu端上报参数：

0x00:指纹试错 0x01:密码试错 0x02:门卡试错 0x03:人脸试错 0x04:假锁 0x05:高温报警 0x06:超时未关门 0x07:锁舌未弹出 0x08:防撬报警 0x09:钥匙插入 0x0A:低电报警 0x0B:电量耗尽报警 0x0C:震动报警

5.1 本地密码变更上报

mcu端逻辑：

1. 每次设备配网成功后，必须上报该dp，上报修改管理员、修改管家操作，把管理员和管家的默认密码上报。下游通讯链路已经加密。
2. 该功能由锁mcu端决定，门锁本地功能可选。
3. 新增租客，默认的授权时间为N天，N约定时间为7天。本地新增租客后必须上报到服务端，上报的密码编号为门锁厂家编号。服务端会保存门锁厂家编号。

5.2 本地密码变更上报

mcu端逻辑：

1. 门锁本地端恢复出厂设置后，必须上报该dp。如果上报失败，下次恢复出厂设置后需要首先上报该dp。服务端会根据该dp清空全部开门方式（包括密码、卡和指纹、开门记录和操作记录，并且恢复门锁的默认管理员密码和管家密码）
2. 服务端恢复出厂设置后，首先清空全部开门方式和记录，并且会在下次配网后下发该恢复出厂设置dp。门锁端收到后，本地清空全部房客开门方式，并且恢复管家和管理员到出厂值。

6.1 门锁状态上报

内门反锁状态上报DP： 本DP上报使用记录型指令,以上报开门时间。电子反锁状态，管理员可开门。

6.2 门锁设置

门锁语言设置： 0=简体中文、 1=英文、 2=日文、 3=德文、 4=西班牙语、 5=拉丁语、 6=法语、 7=俄语、 8=意大利语、 9=繁体中文、 10=韩语 设置失败不返回，设置成功返回对应的值 门锁音量设置： 0x00：静音 0x01：音量低low 0x02：音量中normal 0x03：音量高 设置失败不返回，设置成功返回对应的值

6.3 获取门锁状态

mcu端逻辑： 枚举型，仅下发。1=获取电量， 2=获取内门（电子）反锁状态，3=获取门磁状态，4=获取方舌状态，0=获取全部状态。服务端下发枚举值对应的数据，设备端上报对应dp，如下发1=获取电量，设备端上报dp26 剩余电量，下发2设备上报dp28，下发3设备上报dp27，下发4设备上报dp29，下发0设备上报dp26、dp27、dp28、dp29

6.3 门锁其他状态&设置

长时间未出门-门锁逻辑： 该dp功能由服务端实现。 要勾选实现该dp，mcu端必须先实现以下两个dp： 1. 实现 dp21，门从内侧打开上报 2. 实现 dp35，门被打开 服务端设置未出门阈值为72小时

7.1 远程卡/身份证开门相关

远程下发卡/身份证到门锁端：由SaaS端下发8-16位的卡/身份证加密数据（M1卡）到设备端 涉及dp点：远程创建/删除/修改/冻结/解冻 卡

涉及dp点：远程冻结/解冻 卡

7.2 身份证解锁上报

身份证解锁上报：身份证解锁和卡解锁上报分别为单独的dp点 单条离线密码清空上报：该dp为模块端未实现

8.1 指纹下发

远程下发指纹到门锁端：由SaaS端下发指纹加密数据包到设备端。 具体指纹下发数据是分包协议实现，参考zigbee门锁mcu对接协议章节

涉及dp点：远程下发/删除/修改/冻结/解冻 指纹

涉及dp点：远程冻结/解冻 指纹