Capability Map

Last Updated on : 2025-03-24 01:54:29download

TuyaOS PLC Development Framework provides service-based capabilities in the form of APIs. This allows you to focus on application innovation without caring about the underlying logic.

Device build

Capability	Description
List of data points (DPs)	Build the device’s function DPs based on the DPs created on the platform.
Device information	The device version number.

Network management

Capability	Description
Pairing	To start generic pairing, users can reset a device (for N times), or perform a specified action that makes the device ready for pairing.
Local reset	Restore a device to the status prior to pairing. Users can also choose whether to clear data, for example, respecting groups, scenes, and device status.
Network leave requested by the gateway	Restore a device to the status prior to pairing after the gateway sends a leave command to remove the device from the network.
Auto recovery	This capability can prevent a device from leaving a network by unintended operations. When a device gets ready for the pairing mode after local reset, if pairing timeout or device restart occurs, the device can automatically restore to the previous networking status. All data such as groups and scenes will be retained after restoration.

Data transfer

Capability	Description
Report DP data	PLC devices proactively report DP status to a gateway to sync device status.
Read DP data	PLC devices request DP status values from the gateway to get some services, such as time.
Write DP data	PLC devices and the gateway can change the value of a DP by writing its state.
Execute DP data	PLC devices and the gateway perform controls. For example, control the groups and scenes.

Device relationship

Capability	Description
Local group	Group control allows users to control multiple devices in a group with just one command, instead of sending this command respectively to each device. This feature minimizes the number of over-the-air packets. Devices in the same group can keep their behaviors synced with each other. Multiple PLC sub-devices can be added to the same group. Each PLC sub-device can be added to multiple groups.
Local scene	Each scene is a combination of states supported by a device. This group of states is stored as a snapshot on the device and assigned a scene ID for indexing. Then, users can send a command to the device anytime to invoke the scene and restore the specified status. This can minimize the number of control commands. For example, add a scene to a light, including details such as on/off, brightness, and color temperature. When this scene is invoked, the pre-defined states related to on/off, brightness, color temperature, and more are restored on the light.
Binding and unbinding	Enable direct control between PLC devices. This process makes both devices bound with each other. Thus, one of the devices can directly send a command to the other, even when the gateway is powered off.

OTA update

Capability	Description
Single OTA update	In this OTA update mode, each OTA package contains the full firmware. The size of the OTA firmware is 335 KB, and the whole update process takes about 3 minutes.
Bulk OTA updates	For a group with multiple identical devices, updating these devices via OTA one by one can be time-consuming. To fix this problem, bulk OTA updates are recommended. In this mode, the identical devices in a group are updated in bulk to shorten the whole update process. A larger number of group devices to be updated in bulk results in a more efficient update process.

Support and help

If you have any problems with TuyaOS development, you can post your questions in the Tuya Developer Forum.

Prev DocPLC Sub-Device Development Framework

Next DocDevice Build