公寓锁-DP解释说明

更新时间:2022-03-02 02:05:49下载pdf

前言

该文档为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. 操作成功才返回密码内容,否则不返回

公寓锁-DP解释说明

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。 公寓锁-DP解释说明

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,删除失败;否则,删除成功。 厂商根据门锁厂家编号删除对应的密码。 公寓锁-DP解释说明

2.4 修改房客密码Dp4

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

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

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

公寓锁-DP解释说明

2.6 清空房客密码Dp6

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

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

公寓锁-DP解释说明

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

模块主动上报:入网、重入网、重新上电、定时(暂无定时) 由模块端主动上报,云端再下发 由模块端实现,mcu不用实现该逻辑

公寓锁-DP解释说明

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字节。 公寓锁-DP解释说明

3.2 卡/指纹解锁记录上报

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

公寓锁-DP解释说明

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:震动报警

公寓锁-DP解释说明

5.1 本地密码变更上报

mcu端逻辑:

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

公寓锁-DP解释说明

5.2 本地密码变更上报

mcu端逻辑:

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

公寓锁-DP解释说明

6.1 门锁状态上报

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

公寓锁-DP解释说明

6.2 门锁设置

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

公寓锁-DP解释说明

6.3 获取门锁状态

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

公寓锁-DP解释说明

6.3 门锁其他状态&设置

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

公寓锁-DP解释说明

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

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

公寓锁-DP解释说明

涉及dp点:远程冻结/解冻 卡 公寓锁-DP解释说明

7.2 身份证解锁上报

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

公寓锁-DP解释说明

8.1 指纹下发

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

涉及dp点:远程下发/删除/修改/冻结/解冻 指纹 公寓锁-DP解释说明

涉及dp点:远程冻结/解冻 指纹 公寓锁-DP解释说明