Smart Lock

Tuya door lock development solution provides a detailed introduction to development procedure and API list.

Tuya locks support the following connection solutions. Developers can choose one or more solutions to develop locks according to their business type:

• Connect with communication protocols (Bluetooth, Wi-Fi, Zigbee, and NB-IoT)
• Connect with Tuya IoT Development Platform
• Connect with App SDK (supporting Wi-Fi and Bluetooth at present)
• Connect with RN panel SDK
• Connect with IoT WeChat Mini Program

Create a lock product

This section describes how to create a smart lock product. For details, see Configure in Platform – Create Products.

1. Log in to Tuya IoT Console and click Create.

2. Choose a product from the lock categories:

   • Residential lock: You can choose from Wi-Fi, Bluetooth Low Energy (LE), Zigbee, and NB-IoT communication modes.

   • Residential lock PRO: You can choose from Wi-Fi and Zigbee communication modes. You can create two categories, including Wi-Fi international and Zigbee new public version.

   • Business lock: You can create a public version of the business lock that uses Zigbee communication mode.

   • Hotel lock: You can create a public version Zigbee hotel lock with a wiring harness of the cloud lock cylinder.

   • Safe: You can create a public version safe that uses Bluetooth LE and Wi-Fi communication mode.

     

3. In the Create new product prompt box, set the product name.

   For example, XXX (brand) + XXX (product) + XXX (module model).

4. Product model (optional): You can fill in the product model to distinguish different products.

   For example, XXX (TY-WF-MS-001).

5. Net pairing mode: You can choose a net pairing mode from Wi-Fi, Bluetooth LE, Zigbee, and NB-IoT according to your product requirements.

6. Power type: Wi-Fi is a low power mode, Bluetooth LE and Zigbee are standard power mode, and NB-IoT has PSM mode and DRX mode. At present, all locks are low power products, and their power is supplied by batteries. In case of standard power mode (5V 1A USB power supply), contact business development (BD) personnel of platform lock.

7. Click OK, and the product is created successfully.

   Now, you can enter the product development procedure. See product development procedure.

   

Connect with the communication protocol

Tuya locks support Wi-Fi, Bluetooth LE, Zigbee, and NB-IoT protocol connections.

Connect with Tuya IoT Development Platform

Based on Cloud Development – Solutions Introduction, this section describes the cloud development connection procedure of the lock category.

Prerequisites

To connect Tuya locks with the platform, the following prerequisites must be met:

• Prerequisite 1: Use a lock that supports Tuya solutions. The lock has once connected with Tuya communication protocols, such as Bluetooth, Wi-Fi, Zigbee, and NB-IoT. And the lock can be connected with the platform through a self-built cloud development.
• Prerequisite 2: Connect Tuya Smart Home function. Connect general cloud APIs such as network configuration, device management, and member management.
• Prerequisite 3: Connect Tuya lock cloud API function. Tuya lock cloud APIs consist of cloud API of lock function and standard command set of lock function. Lock alarm records, unlock records, and setting commands are implemented through a standard command set.

Connection solution

At present, Wi-Fi and Zigbee lock use the same set of open cloud development APIs. The APIs of the Bluetooth cloud development are not available at present. Contact Tuya lock BD for details.

App SDK connection

Based on App Development – SDK Development – App SDK Instruction, this section describes app SDK development connection procedure of the lock category.

Prerequisites

To connect Tuya locks with app SDK, the following prerequisites must be met:

• Prerequisite 1: Use a lock that supports Tuya solutions. The lock has once connected with Tuya communication protocols, such as Bluetooth, Wi-Fi, Zigbee, and NB-IoT. And the developer app can inherit the Tuya lock app SDK.
• Prerequisite 2: Tuya lock app SDK is encapsulated on the basis of Home SDK. Some lock functions that are not integrated into the app can be connected with the platform.

Connection solution

At present, the Wi-Fi residential lock and Bluetooth LE residential lock can be connected with app SDK. The iOS platform and Android platform are supported. Zigbee App SDK is not available at present. Contact Tuya BD for details.

Tuya lock app SDK is the second encapsulation based on Tuya App Home SDK. It mainly encapsulates the lock business.

Connect with panel SDK

Based on Panel Development – Panel SDK Development – Common SDK Development, this section describes the panel SDK development connection procedure of the lock category.