Zigbee 门锁

Zigbee门锁指通过Zigbee模组和Zigbee通讯协议实现联网控制的智能门锁。目前采用Zigbee通讯协议的门锁均为低功耗方案，模组平常处于休眠状态，但是和Zigbee网关保持一定的心跳。Zigbee门锁可以实现控制指令的下发和设备状态的上报。

目前Zigbee门锁支持MCU通用协议对接：涂鸦模组和开发者的门锁 MCU 通过串口通信的方式，MCU通过涂鸦模组上报设备状态，连接涂鸦 IoT。

Zigbee门锁对接方案

方案框图

方案说明

涂鸦提供烧录标准固件门锁的 Zigbee模组，并提供一整套涂鸦Zigbee门锁MCU通讯对接协议，该模组连接涂鸦 IoT &App 和门锁的MCU，开发者需要按照串口协议开发主控 MCU 程序。为快速开发，涂鸦还提供了mcu_sdk（开发者平台创建pid可获取），可快速实现串口协议的对接开发。

功能描述

Zigbee公版方案门锁支持以下功能的对接：

功能	说明
安全机制	防重放无线攻击，秘钥交换机制确保无线通信安全
开门记录	解锁方式+解锁id+时间。用户可以通过app查询近12个月的开门记录，不会丢失数据。支持组合开门
离线开门记录补传	重新联网后，模组会将在离线阶段发生的开门记录补传到云端
报警	低电报警、密码错误、指纹错误、房卡错误、防撬、高温等
时间同步	门锁时间与服务器保持一致，支持全球时区+冬夏令时切换
用户管理	通过app添加用户，与解锁id通过app手动关联
开门事件联动	通过app自动化配置可实现联动。1、使用门被打开dp点 2、使用“家人回家”条件
电量状态显示	电量值或电量状态
其他事件联动	可以根据不同的解锁id或者类型自定义联动
App远程开门（含密）	点击后输入门锁硬件上可用密码后开门
App远程开门（免密）	点击app上远程开门按钮，立即开门
动态密码	涂鸦 zigbee 模组集成了动态密码算法，厂家1小时实现该功能，支持动态密码复制
临时密码管理	支持临时密码的创建、删除、修改、冻结、解冻操作。可设置一次性密码与不限次数，临时密码支持复制
schedule	配合临时密码，实现日程化的临时密码失效
门铃呼叫	门铃呼叫后，app收到提醒，触发push
劫持报警	App标记后，特定方式开门即触发劫持报警
设备设置	对门铃的音量、按键音量、语言等进行设置
自动重试+密码同步	当网络不稳定导致门锁配置失败，会导致密码下发不及时，通过保障机制，提升到达率
临时密码短信通知	可以选择向用户发送临时密码的短信
门铃呼叫	硬件进行门铃呼叫请求后，app收到通知
离线临时密码	不依赖网络的离线临时密码，由模组和云端实现算法，MCU 调模组接口验证
门锁状态显示	App上可参看门锁的反锁、童锁等状态信息
自动落锁开关	可以开启自动反锁或关闭自动反锁功能
自动落锁等待时长	可以设置自动落锁的等待时长
通过app发起添加开门方式	通过app可以在门锁上开启添加物理的开门方式
全量开门方式上报	通过全量上报的方式，使得云端的开门方式与门锁硬件上存在的开门方式保持一致
语音下发与删除	通过zigbee网络，将app上采集的语音下发到门锁上
指纹下发与删除	通过zigbee网络将采集器采集到的指纹特征点发到门锁上
房卡下发与删除	通过zigbee网络将房卡信息下发到门锁上
全量开门方式上报	通过全量上报的方式，使得云端的开门方式与门锁硬件上存在的开门方式保持一致

产品创建

涂鸦Zigbee门锁目前支持创建以下品类：

Zigbee门锁品类	说明
Zigbee家庭门锁	老公版方案。适用于家庭入户锁方案对接
Zigbee家庭门锁RPO	最新公版方案，建议对接该方案。适用于家庭入户锁方案对接。
Zigbee公寓门锁	适用于长短租公寓场景对接
Zigbee酒店门锁	适用于酒店门锁场景对接

产品创建流程

Zigbee门锁产品创建总体流程：开发者平台注册-产品定义-面板选择-模组选择-硬件配置-拓展配置。

创建Zigbee家用门锁PRO：

创建Zigbee公寓门锁方案：

创建Zigbee酒店门锁-云锁芯方案：

产品DP功能定义

• Zigbee家庭门锁品类DP参考：Zigbee家庭门锁Dp解释说明

• Zigbee公寓门锁品类DP参考：Zigbee公寓门锁Dp解释说明

产品开发

模组选型

目前Zigbee门锁通用方案，支持选型的模组主要是TYZS5。模组选型介绍：TYZS5模组规格

模组	固件	版本	状态	说明
TYZS5	TYZS5 urat 串口唤醒	1.1.8	通用固件，已发布	该固件支持urat唤醒的mcu通用对接。
TYZS5	TYZS5 gpio唤醒	1.1.8	通用固件，支持白名单的方式添加	该固件支持gpio唤醒的mcu通用对接。
TYZS3			白名单状态，联系商务对接
TYZS7			白名单状态，联系商务对接

产品MCU开发说明

该文档主要介绍 MCU 开发说明、关键步骤以及关键DP（DP 交互流程、告警/开门记录、恢复出厂设置流程和示例）。

开发辅助文档：

Zigbee家庭门锁参考：Zigbee家庭门锁开发辅助文档

Zigbee公寓门锁参考：Zigbee公寓门锁开发辅助文档

MCU对接协议（产品数据通讯协议）

产品开发的公版通信协议和数据协议。开发者创建产品 ——> 选择模组 时可下载最新的通讯协议。

Zigbee门锁MCU通讯协议参考：Zigbee门锁MCU对接协议

三方语音能力

Zigbee门锁已支持第三方语音开门。

支持的Zigbee门锁品类：选择 安防传感——> 家庭门锁PRO ——> Zigbee门锁

三方语音能力	支持情况
Alexa语音开锁	支持: 语音开锁 unlock 语音关锁 lock 语音开关锁状态查询 query 开关锁Alexa语音反馈
Google Assistant 语音开锁	支持： 语音开锁 unlock 语音关锁lock 语音开关锁状态查询query 不支持： 开关锁Google语音反馈

调试测试

产品FAQ

该文档以问答方式罗列了研发、调试过程中的常见问题，以及问题排查解决方法。

Zigbee门锁对接常用FAQ：Zigbee门锁对接常用FAQ

产品基础测试用例

该文档提供基础测试用例，包含门锁的软件功能测试、硬件功能测试、射频测试等。

参考：涂鸦Zigbee门锁基础测试用例

生产测试

产品产测流程说明

参考平台通用产测说明

其他能力

云开发平台对接

Zigbee家庭门锁支持云开发平台对接：

• 云开发平台对接文档：Zigbee家庭门锁云开发平台对接API文档

• 标准指令集文档：Zigbee家庭门锁标准指令集