English
English
简体中文
Contact Us
Register
Log In
layoutIndex

Zigbee Lock

Last Updated on : 2022-03-02 02:05:37download

Zigbee locks refer to the door locks that are connected and controlled by Zigbee modules and Zigbee communication protocols. Currently, the Zigbee locks use the low power scheme. The module is usually in hibernation status, but it keeps a certain heartbeat with Zigbee gateway. The Zigbee door lock can transmit the control commands and report device status.

Zigbee locks support MCU common protocol connection. The Tuya modules and the MCU of your locks communicate through serial port. The MCU reports the device status and connects to Tuya IoT platform through Tuya modules.

Zigbee lock connection solution

The diagram of MCU connection solution is as follows.

Zigbee Lock

Description

Tuya provides Zigbee modules for standard firmware burning purpose of lock, and provides a set of MCU communication protocols. The module connects the Tuya IoT platform, app, and MCU of lock. You need to develop MCU program according to serial port protocols. For rapid development, Tuya also provides MCU SDK, which can be downloaded when you create products on Tuya IoT console, to quickly complete the integration development of serial port protocols.

Features

The public version of Zigbee lock solution supports the development of the following features.

Feature Description
Security The secret key exchange guarantees the wireless communication security and prevent against wireless replay attacks.
Unlocking logs The method, ID, and time of an unlocking method are recorded. Users can view them for the last 12 months on the app without data loss. Users can require more than one method for an unlocking operation.
Re-transmit the local unlocking logs in case of connection failure When the connection resumes, the module transmits the unlocking operation log that is only stored locally to the cloud.
Alert The alert of low battery, incorrect password, incorrect fingerprint, incorrect card, prying, and high temperature are supported.
Time synchronization Time of the lock is consistent with the cloud, and users can switch among global time zones and use daylight saving time if needed.
Member management Users can add members and unlocking method ID, and manually associate them on apps.
Unlocking operation linkage The unlocking operations can be automatically linked in scenes on apps. For example, you can add a rule to describe DP of the unlocking operation, and set the condition as “welcome home”.
Battery status display The value and status of battery can be displayed.
Other scene linkages The scene linkage can be established according to the ID or type of the unlocking operation.
Remote control on the app with password Once the feature is enabled on the app, the door can be unlocked with valid password.
Remote control on the app without password Once the feature is enabled on the app, the door is immediately unlocked.
Dynamic password The dynamic password algorithm is integrated into Tuya Zigbee modules, and you can implement it in your product within one hour at the earliest. Also, the algorithm can be fast added on apps.
Temporary password management Users can create, modify, freeze, unfreeze, and delete the temporary password. The number of temporary passwords is unlimited. The temporary password can be copied.
Schedule Users can use the schedule and temporary password at the same time to invalidate the temporary password regularly.
Remote door knocking The app receives the doorbell call requests that are sent by locks, and notifies the users.
Hijack alarm If an unlocking method is marked on the app, the hijacking alarm is triggered when the door is opened by that method.
Lock setup Users can customize the doorbell volume, key volume, and language of the lock.
Automatically resend the password in case of network failure When the network is unstable and the lock configuration fails, the password cannot be sent timely. After automatically re-sent, the password can reach the lock in most cases.
SMS notification of the temporary password Users can send short messages with temporary passwords to the one who needs it.
Remote door knocking The app receives the doorbell call requests that are sent by locks.
Local temporary password The local temporary password is independent of network connection, the password is calculated by modules and the cloud, and the MCU verifies that by calling module interfaces.
Lock status display Users can view the lock status such as locked out, child lock, and others.
Automatic latch Users can enable or disable the automatic latch function.
Waiting time of automatic latch Users can set the waiting time of automatic latch function.
Add unlocking methods on the app Users can add physical unlocking methods if the feature is enabled on the app.
Unlocking log upload After the unlocking logs are uploaded, they become consistent among the cloud, the app, and the lock.
Voice control and deletion Through the Zigbee network, the voice control request is sent to the lock by the app.
Fingerprint recognition and deletion Through the Zigbee network, the collector sends the detected fingerprint to the lock.
Door card granting and withdrawal Through the Zigbee network, the information of the active door card is sent to the lock by the app.

Category of Zigbee lock

The Tuya Zigbee lock integration supports the following categories.

Category Description
Residential lock The former public version solution. It is applicable to residential door lock integration.
Residential lock PRO The latest and recommended public version solution. It is applicable to residential door lock integration.
Business lock (apartment) Applicable to the long term and short term apartment rental.
Hotel lock Applicable to the deployment and development of hotel locks.

Creating Zigbee locks

The overall process to create a Zigbee lock is as follows, for detailed instruction, see Create Products:

  1. Register on the Tuya IoT console
  2. Add functions
  3. App panel design
  4. Select a module
  5. Configure hardware
  6. Cloud configuration

The following figure is shown after you choose the Security & Sensors category on the Tuya IoT console.

Zigbee Lock

  • The following figure is shown after you choose the Residential Lock PRO under the Security & Sensors category.

    Zigbee Lock

  • The following figure is shown after you choose the Business Lock under the Security & Sensors category.

    Zigbee Lock

  • The following figure is shown after you choose the Hotel Lock under the Security & Sensors category.

    Zigbee Lock

DP and functions

Product development

Selecting module type

The TYZS5 series module is mostly used and recommended for the Zigbee lock. For more information, see TYZS5 module.

Module Firmware Version Status Description
TYZS5 The MCU must be waked up by the URAT before the firmware upgrading. 1.1.8 The general firmware has been published. The firmware supports UART wake-up for MCU development.
TYZS5 The MCU must be waked up by the GPIO before the firmware upgrading. 1.1.8 The general firmware is only available to whitelisting accounts. The firmware supports GPIO wake-up for MCU development.
TYZS3 N/A N/A The general firmware is only available to whitelisting accounts. Please contact Tuya account manager if needed. N/A
TYZS7 N/A N/A The general firmware is only available to whitelisting accounts. Please contact Tuya account manager if needed. N/A

MCU development description

The following topics introduce development description, key steps, and key data points (including interaction process, alert/unlock record, process to restore factory defaults, and examples).

MCU connection protocol (product data communication protocol)

Public version communication protocol and data protocol during product development. You can download the latest communication protocol when creating a product and selecting a module.

For MCU communication protocol of Zigbee locks, see MCU connection protocol of Zigbee locks.

Third-party voice recognition

Part of the Zigbee locks can be controlled by third-party voice assistants.

To enable that, you can choose Security & Sensors > Residential Lock PRO, and then select Zigbee in the Net Pairing Mode when creating a lock on the Tuya IoT console.

Third-party voice recognition Description
Amazon Alexa The supported commands are as follows.
Unlock (by voice)
Lock (by voice)
Query (by voice to confirm the locking status)
Feedback about the unlocking and locking commands.
Google Assistant The supported commands are as follows.
Unlock (by voice)
Lock (by voice)
Query (by voice to confirm the locking status)
However, the feedback about the unlocking and locking commands are not supported.

Debugging and test

FAQ

This topic lists the frequently-asked questions during R&D and debugging, and provides troubleshooting suggestions. For more information about Zigbee lock connection, see FAQ about Bluetooth Low Energy (LE) Lock Connection.

Basic test case

This topic provides test cases, including software functional test, hardware functional test, and radio frequency test of lock. For more information, see Basic Test Case of Tuya Zigbee Lock.

Production test

Production test process

See general production test description provided by Tuya.

Other development solutions

Connect with Cloud Development platform

Tuya Zigbee lock can be controlled and managed through Cloud Development platform.

For more information, see Cloud Development platform API reference for residential lock and Cloud Development platform command set reference for residential lock.

Change log

Version Description Date Remark
1.0.0 The first release. 20200601 N/A
1.1.0 Added the overview section and connection description. 20200803 N/A