Zigbee 门锁 FAQ

产品开发相关

选择何种唤醒固件？有什么逻辑区别？

Zigbee 家用门锁有两种固件可选：UART 唤醒和 GPIO 唤醒。Zigbee 公寓门锁目前仅 UART 唤醒固件可选。

• UART 唤醒固件：模块通过串口发送唤醒指令的方式唤醒 MCU

• GPIO 唤醒固件：模块在发送串口数据之前，会通过 GPIO 口输出一个低电平信号唤醒 MCU（模块上的PWM1，默认设置为内部上拉状态，拉低10ms有效。串口通信结束后 100ms 模块再次进入休眠），模块仍会发唤醒指令，MCU 需做回复，为了让模块知晓 MCU 被唤醒。

App 相关

涂鸦关于 App 方面提供哪些服务？

OEM App ，App 上架服务，OEM App 更新服务，App 商城服务，Siri 接入服务，Widget 接入服务，Apple Watch 接入服务。

App 可以使用自己公司的风格及 logo 吗？

可以使用 OEM App 的方式：OEM App

网关相关

Zigbee 智能锁与网关的通信距离是多少？

室内无实体墙阻挡情况下，通信距离可达 20 米，推荐的稳定使用距离在 15 米内，如有较厚的实体墙体阻隔，距离可能会更近。

自研 Zigbee 门锁无法连接到自研的 Zigbee 网关上，是什么原因？

1. 尝试重启门锁和网关，是否能连上。
2. 确认信号是否正常，可以尝试把网关与门锁的距离拉近。
3. 确认固件版本：模块固件版本 1.0.7 以前的 Zigbee 门锁，存在此问题，需要重置网关来解决。
4. 若以上原因都排除，需查看信道，确保网关和设备在同一信道。

配网相关

Zigbee 门锁配不上网怎么办？

1. 确认门锁是否为 Zigbee 版本;
2. 确保操作步骤正确，按照说明书执行;
3. 如依然配不上，检查网关是否匹配。型号为 01 和 02n 可以和自研的 Zigbee 门锁匹配，网关固件版本要求是 1.1.9 之后。型号为 02 的网关无法与自研的 Zigbee 门锁匹配;
4. 如果以上问题都排查完成，仍然无法联网成功，请尝试将网关与门锁移得更近一些，确保无线通信正常（5 米以内，且无阻隔物）。

注：如使用的门锁是智家人品牌的，早期的产品上面的 Zigbee 模块可能是非自研而是瑞瀛的。

Zigbee 门锁的在线/离线是如何判断的？

Zigbee 门锁配网后，如果 Zigbee 的网络可靠，并且 Zigbee 网关到服务器的连接稳定，Zigbee 门锁会一直处于在线状态。在线状态下，如果 App（服务器）要发指令给门锁，正常在 5s 内门锁就会收到，如果网络状态不好会有一定的延迟（不超过 30s），如果超过 30s 无法发送到硬件则发送失败。当 Zigbee 网关突然离线（断电，断网）， Zigbee 门锁会立马跟着离线，如果网关恢复上线， Zigbee 门锁也会马上恢复联网。如果 Zigbee 门锁本身断开了与网络的连接（门锁断电，或者信号不好导致断网），App 上最长不超过 5 分钟门锁会显示离线，如果重新给门锁换上了电池，或进行了一次开门操作，如果网络可靠，门锁马上恢复联网。

临时密码相关问题

临时密码的原理是什么？

临时密码是指有时效限制的密码。通过 App 创建后，由服务器发送给门锁硬件，门锁会把密码和有效期存在设备上。一旦存了以后，除非收到删除或修改的指令。否则都按照创建的时效性执行——创建、删除、修改，都依赖网络。

Zigbee 门锁临时密码最多可添加多少组？

最多 30 组。

Zigbee 门锁的临时密码功能不能用？

若无临时密码功能：

1. 硬件本身不支持，硬件的版本太老当时还不支持临时密码功能，这批产品无法通过 OTA 进行升级。
2. 网关和设备之间不兼容，瑞瀛网关配上了自研的门锁，这种情况下门锁的功能会受限不能正常使用，自研 Zigbee 模块的门锁需要与自研的 Zigbee 网关配合使用。
3. 自研网关的固件版本太低，低于 1.1.9。如果是这种情况，请将网关进行 OTA。

若临时密码无法使用：

1. 确认临时密码是否配置成功（查看密码列表中的密码状态）。
2. 确认密码的生效时间，是否在生效中。
3. 请检查 Zigbee 网络是否正常，开门记录能否正常上报，远程开门指令是否下发正常，动态密码开门是否可用。如此类功能无法全部正常工作，请对门锁进行重新配网操作。
4. 如配置正常，依然不能正常使用，提供虚拟 ID，联系技术支持。

Zigbee 门锁临时密码一直在创建中，怎么办？

该问题可能由无线信号不稳定引起，或是已创建完成，页面未刷新。

1. 在密码列表页面，下拉刷新界面。
2. 如果尝试多次下拉后，密码依然显示为“创建中”，可以通过将网关的电源拔掉，等待 10 秒钟，之后重新插上，然后过1分钟内看密码是否被下发成功。

临时密码中涂鸦序号、服务端序号和门锁厂商编号分别什么作用？

1. 涂鸦序号：涂鸦平台存储的临时密码的编号，用于平台存储数据逻辑。
2. 服务端序号：用于记录该临时密码编号的内容数据变更次数（包括起止时间、密码名称等非密码数据的变更）。
3. 门锁厂商编号：门锁存储的临时密码编号，临时密码开门记录的编号显示使用该值。

为什么在移除 ZigBee 后，重新配网后，再添加临时密码 App 会提示“正在初始化信息，请耐心等待，如长时间未成功，请重新配网”？

App 上解绑并清除数据之后再次配网，App 会下发一个 DP39 “清除临时密码”的指令，此时若 MCU 没有回复，将会提示初始化中。同时要求MCU 在本地恢复出厂设置之后再次配网，需要主动上报 DP39"清除临时密码“，以便本地和 App 端的临时密码保持一致，具体细节，请看 DP 解释说明。

为什么创建完临时密码，App 上一直显示创建中？

MCU 未回复或回复错误，具体格式请参考 DP 解释说明。

动态密码相关

动态密码的原理是什么？

动态密码是不依赖网络实现的临时性密码，该方案依靠算法实现。App（第三方接口）向涂鸦的服务器请某个门锁当前的动态密码，当门锁收到某个疑似为动态密码的密码时，将该密码提交给涂鸦的模块，同时把当前的时间、管理员密码，一并给到模块。模块收到当前时间、管理员密码，结合模块自己保存的初始秘钥进行运算，将运算后得到的密码与用户输入的密码进行比对。如果比对通过，模块告诉 MCU 开门，比对失败，拒绝开门。

动态密码和普通密码怎么区分？

动态密码通常是 8 位密码，普通密码常用 6 位密码。

为什么有的时间段前后生成的两个动态密码都能有效开门？

云端和模块会在每个 xx:x0、xx:x5 这种分钟时刻生成动态密码，而xx:x0生成的动态密码有效时间为 xx:x0~xx:x9，而 xx:x5 生成的动态密码有效时间为 xx:x5~xx:（x+1）4，所以两个动态密码在 xx:x5~xx:x9 都有效，导致都能开锁。

远程开门相关

Zigbee 门锁，为什么没有远程开门功能？

1.硬件本身不支持，硬件的版本太老当时还不支持远程开门功能，这批产品无法通过 OTA 进行升级。
2. 网关和设备之间不兼容，瑞瀛网关配上了自研的门锁，这种情况下门锁的功能会受限不能正常使用，自研 Zigbee 模块的门锁需要与自研的 Zigbee 网关配合使用。
3. 自研网关的固件版本太低，低于 1.1.9。如果是这种情况，请将网关进行 OTA。

新免密远程开门的逻辑是怎样的？

DP48、DP49 配合使用的，App 设置栏下把远程开门设置为免密时，就会下发 DP48 指令，并且附带密钥，门锁需要回复，然后 App 操作远程开门时，就会下发 DP49（类似之前的 DP40），门锁判断 DP49 中附带的密钥和 DP48 中附带的密钥是否相同，校验成功则开门，并且回复 DP49，然后就是回复DP22、DP38、DP41三个 DP。

注意：新免密开门中 DP22 的上报一定要用记录型上报。

告警推送相关

智能门锁 App 上的“劫持报警”功能如何使用？

该功能的操作方式如下：

1. 门锁上已有一个使用中的指纹或者密码，编号为X。
2. 打开门锁的 App 界面，在成员管理中心，将该 X 编号归属到某个用户名下，然后将该编号X，标记为劫持报警。
3. 在门锁上使用该 X 解锁方式，开一次门。
4. 在 App 上的报警–劫持报警记录中查看对应的事件。

App 面板里的告警和 App 退出后在手机通知栏收到的告警推送有什么不同？

App 面板里的告警是通过 DP 直接上报的，MCU 必须自行上报才能显示。而 App 退出后在手机通知栏收到的告警是需要客户自行在开发者平台云端配置里面进行告警设置，然后通知涂鸦项目经理进行审核，审核通过才能进行推送，同时客户需要打开相关的消息推送权限（该告警推送是由涂鸦云进行场景联动规则的匹配完成，即匹配客户 MCU 上报的 DP 是否满足联动）。

开门记录相关

为什么开门记录不显示？

1. 有可能 MCU 上报序列号重复导致数据被网关过滤掉了，所以 MCU 上报序列号需每次+1。
2. 需要和涂鸦项目经理确认是否开通后台统计功能。

电量显示相关

Zigbee 配网成功后，电量为什么一直显示 0？

1. 确认电池是全新的。
2. 重新上电，App 再次获取电量。
3. 开一次门，会重新上报电量数据。 
   出现该现象，较大可能是门锁本地在获取电池电压的时候没有获取成功，这种现象一般不会影响使用。

恢复出厂设置相关

App 恢复出厂设置，Zigbee 门锁重新入网，为什么临时密码一段时间内还能开门？

需要等 40~60 秒的时间才能下发到门锁端，门锁接收数据后清空临时密码，所以在此时间之前仍然可以使用临时密码开门。

OTA 相关

Zigbee 门锁进行 OTA 有哪些注意事项？

Zigbee 模块的 OTA 需要在涂鸦后台进行配置。配置完成后，需要先对白名单内的样机进行测试，测试通过后才能将该次的固件进行发布用于批量 OTA。在进行 OTA 操作时，用户可以通过 App 对门锁的 Zigbee 模块进行 OTA 操作，OTA 完成后需要注意对门锁硬件进行重新配网操作。正确的步骤是：

1. OTA 完成后，在 App 上对设备进行恢复出厂设置。
2. 对门锁进行重新配网。
3. 配网完成后验证功能是否都正常，如有问题，请重新配网。

注意：Zigbee 模块从 1.0.x 升级到 1.1.1 需要重新配网。  1.1.1 往后 再 OTA 到更高版本，不需要重新配网。需要重新配网的原因是 Zigbee 模块的基线做了升级。

说明：Zigbee 1.0.7 版本的固件，无法进行 OTA。

场景联动相关

Zigbee 门锁怎么设置，场景联动。推荐客户怎么使用。如果要判断，如谁回家了，触发不同的回家场景怎么操作？

1. 可以使用与 Wi-Fi 门锁相同的方式。
2. 使用“门被打开”功能。按照与 Wi-Fi 门锁相同的步骤在，涂鸦智能 App - 智能 - 自动化 - 添加（右上角“+”） - 添加条件 - 设备 - 选中要操作的设备的名称，在“选择功能”界面，选择“门被打开”这个功能点，然后配置执行动作。该功能点的含义是，只要门从外侧发生了一次解锁动作，就满足条件。
3. 使用“家人回家”功能。涂鸦智能App - 智能 - 自动化 - 添加（右上角“+”）-自动化 - 添加条件 - 家人回家（注意，只有当你的家庭下具备 Zigbee 门锁的时候，才会出现该选项），选中要操作的设备的名称，选择要作为判断条件的用户的名称（如用户列表为空，请到该 Zigbee 门锁的成员管理界面下去添加成员）。

在线离线相关

Zigbee 门锁，在 App 上为什么经常会出现离线的情况？

1. 检查门锁与网关的距离，建议距离为直线15米以内（无墙体阻隔）。
2. 检查网关所连接网络是否稳定。
3. 在门锁上进行多次指纹或者密码开门，是否每一次开门记录都能顺利的出现在 App，如果记录有时候能上来，有时候不能上来，大概率是网络环境较差，距离较远等原因导致的信号差。如果记录每次都能上来，请尝试下一项。
4. 使用 App 的远程开门是否能成功，通过 App 添加临时密码，是否成功，如果成功率低，基本判断还是网络本身不稳定导致的。如果实在排除不了原因，请看下一项。
5. 提供设备虚拟 ID/device ID 联系涂鸦技术支持工程师寻求支持，查看网关的 log，看设备现场的网络信号情况。