Zigbee 门锁

更新时间:2024-06-20 08:45:16下载pdf

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

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

Zigbee门锁对接方案

方案框图

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公寓门锁方案:

Zigbee 门锁

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

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家庭门锁支持云开发平台对接: