Preface series of articles >>>
[Tuya IoT footprint] Tuya cloud platform interface list-universal infrared remote control
1. The overall introduction of smart door locks:
Smart door locks are different from traditional mechanical locks, and are more intelligent and convenient locks in terms of user safety, identification and management. Smart door locks use non-mechanical keys as user identification IDs, such as fingerprint locks, iris recognition, etc., and can even open the door remotely directly through a mobile phone App or applet.
This article introduces the related processes and APIs for the development of smart door locks using the cloud development platform. Smart door lock cloud development and docking types are mainly for customers' self-built servers to realize door lock related services, including but not limited to WeChat applets, Web systems, and H5 applications.
Two, docking process
Before docking lock the vertical category business, you need to register as a graffiti cloud development platform for developers, please refer to related graffiti cloud development platform - Quick Start .
The connection process of Tuya Smart Door Lock Cloud Development is shown in the following figure:
Three, applicable categories
Four, interface log
Tuya can provide the interface call log query within the last 7 days based on the current time. The developer can provide the interface request parameters and submit them in the form of work orders on the developer platform. Tuya staff will process them as soon as possible. Respond within two hours. For urgent questions, you can find the project manager to speed up the process through offline channels.
Five, password creation process
-
Wi-Fi door lock processing process:
- Zigbee door lock processing flow:
Zigbee door lock normal business process
- The caller calls the API to create a password
- Tuya cloud platform sends a password to the gateway
- The gateway sends a password to the door lock
- Door lock response password status: configuration successful
- The gateway reports the password status: successful configuration
- Tuya cloud platform storage update password status: configuration successful
- The caller polls the password status until the password status is updated to: configuration success/configuration failure, the polling timeout is 25s
Zigbee door lock abnormal business process
- The caller calls the API to obtain door lock information
- The caller calls the API to create a password (encrypted with the door lock localkey)
- Tuya cloud platform sends a password to the gateway
- The gateway sends a password to the door lock
- Door lock not responding state
- The gateway retries to issue the password, and the retry ends 3 times
- Password status reported by the gateway: configuration failed
- Tuya cloud platform storage update password status: configuration failed
- The caller polls the password status until the password status is updated to: configuration success/configuration failure, and the polling timeout period is 25s.
VI. Password encryption process
Seven, door lock API
- Obtain the temporary key for password encryption
- Create a temporary password
- Create an unnamed temporary password
- Sync password
- Get temporary password information/list
- Modify/freeze/unfreeze/delete/temporary password
- Get dynamic password
- Get offline temporary password
- Query door opening record
- Device member management
- Add/modify/delete device members
- Query device member information
- Query member information list based on device ID
-
Assign door lock password to device member
8. Door lock unlock method API - Get a list of unlocking methods that the door lock member has not/bound
- Enter/delete door lock unlock method
- Cancel input unlock method
- Set the unlocking method to hold and unlock
- Door lock general ability issuance control
- Push the input result of door lock unlock method