Device Relationship

Zigbee specifications define certain special features to make Zigbee devices easy to use, for example, groups, scenes, and finding & binding. TuyaOS comes with simplified interfaces to support these features. For more information, see the specific framework development guide.

Group

TuyaOS supports Zigbee standard groups. Multiple Zigbee sub-devices can be added to the same group. Each Zigbee sub-device can be added to multiple groups.

Group control allows users to control multiple devices in a group with just one command, instead of sending this command respectively to each device through unicast communication. This feature minimizes the number of over-the-air packets. Devices in the same group can receive the command nearly at the same time and thus keep their status synced with each other.

TuyaOS provides Zigbee standard interfaces for sending group commands and callbacks to invoke when these commands are received. For example, adding or deleting groups can be implemented in this way. Therefore, your development can be accelerated by Zigbee groups.

The maximum number of groups supported by TuyaOS can vary, depending on different chip platforms. For more information, see the documentation on the respective development framework.

Scene

TuyaOS supports Zigbee standard scenes. Each scene is a combination of states or attribute values supported by a device. This group of values 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 that restore multiple states of a device.

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.

TuyaOS provides Zigbee standard callbacks to invoke when scene commands are received. For example, adding, invoking, or deleting scenes can be implemented in this way.

After the command of saving a scene is received, TuyaOS allows users to save the selected states or attribute values to non-volatile memory (NVM). When users send a command to invoke the scene in the future, these values can be restored easily.

Finding & binding

The finding & binding feature enables direct control between Zigbee devices, without the need for command conversion by additional devices such as gateways. In finding & binding mode, the device that sends a control command is known as the initiator and the device that receives the control command is known as the target device. The initiator starts the finding & binding process, and the target device enables finding & binding. Through simple interaction, the initiator discovers and saves the network address of the target device. This allows the initiator to send commands to control the target device through this network address.

TuyaOS provides the interfaces for sending and receiving commands in finding & binding mode.

• The initiator provides the capabilities to start finding & binding and receive the success or failure callback.
• The receiver provides the capabilities to enable or disable Find&Bind. The receiver can be discovered when this mode is enabled. Otherwise, if it is disabled, the receiver cannot be discovered.