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

Dimmer Switch

Last Updated on : 2022-06-06 14:56:30download

Zigbee basics

Category Device ID Profile ID
Dimmer switch 0x0104 0x0104
Color dimmer switch 0x0105 0x0104

Supported clusters

Input clusters (server) Output clusters (client)
Basic (0x0000) Identify (0x0003)
Power Configuration (0x0001) Groups (0x0004)
Identify (0x0003) Scenes (0x0005)
Groups (0x0004) On/Off (0x0006)
Touchlink Commissioning (0x1000) Level Control (0x0008)
Color Control (0x0300)
Touchlink Commissioning (0x1000)
OTA Upgrade (0x0019)

Supported attributes and commands

Attributes contain the basic information about a Zigbee device. A gateway can get this information through the Read Attributes and Write Attributes defined by Zigbee Cluster Library Specification.

Basic cluster

Attributes:

ID Name Data type (ID) Range Default
0x0000 ZCLVersion uint8 (0x20) 0x00 to 0xff 0x03, used for connection to Tuya-enabled Zigbee gateways.
0x0001 ApplicationVersion uint8 (0x20) 0x00 to 0xff For example, 0b 01 00 0001 indicates 1.0.1, that is, 0x41 represents version 1.0.1. This attribute is used for OTA updates. When an OTA update is initiated, the gateway reads the version number of the update and pushes it to the Zigbee device. After the Zigbee device is restarted after the update, the gateway reads the current version to check for the update result. The firmware can only be updated to a higher version. This attribute is used for connection to Tuya-enabled Zigbee gateways.
0x0002 StackVersion uint8 (0x20) 0x00 to 0xff 0x02
0x0003 HWVersion uint8 (0x20) 0x00 to 0xff 0x01
0x0004 ManufacturerName string (0x42) 0 to 32 bytes The value of this attribute is 16 bytes in length, consisting of 8-byte prefix and 8-byte PID. 0 to 7 bytes: _TZ3000_.
8 to 16 bytes: The PID, the unique identifier of the Zigbee product you create on the Tuya IoT Development Platform. This field determines the UI and feature display on the mobile app. You can use the default PID if you do not require a custom one. This attribute is used for connection to Tuya-enabled Zigbee gateways.
0x0005 ModelIdentifier string (0x42) 0 to 32 bytes TS1001, used for the gateway to identify the device type.
0x0007 PowerSource enum8 (0x30) 0x00 to 0xff 0x03
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands

ID Name Direction
0x00 Reset to Factory Defaults Client to server

Power configuration cluster

Attributes:

ID Name Data type (ID) Range Default
0x0000 MainsVoltage uint16 (0x21) 0x0000 to 0xffff 0x0000
0x0020 BatteryVoltage uint8 (0x20) 0x00 to 0xff 0x1e
0x0021 BatteryPercentageRemaining uint8 (0x20) 0x00 to 0xff 0xc8
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Identify cluster

Attributes (server)

ID Name Data type (ID) Range Default
0x0000 IdentifyTime uint16 (0x21) 0x0000 to 0xffff 0x0000
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Attributes (client)

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands (client)

ID Name Direction Description
0x00 Identify Client to server Send a command
0x00 Identify Query Response Server to client Receive a command

Commands (server)

ID Name Direction Description
0x00 Identify Client to server Receive a command
0x01 Identify Query Client to server Receive a command
0x00 Identify Query Response Server to client Send a command

Groups cluster

Attributes (server)

ID Name Data type (ID) Range Default
0x0000 NameSupport map8 (0x18) 0x00 to 0xff 0x00
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Attributes (client)

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands (client)

ID Name Direction Description
0x00 Add group response Server to client Receive a command
0x01 View group response Server to client Receive a command
0x02 Get group membership response Server to client Send a command
0x03 Remove group response Server to client Receive a command
0x00 Add group Client to server Send a command

Commands (server)

ID Name Direction Description
0x00 Add group Client to server Receive a command
0x01 View group Client to server Receive a command
0x02 Get group membership Client to server Receive a command
0x03 Remove group Client to server Receive a command
0x04 Remove all groups Client to server Receive a command
0x05 Add group if identifying Client to server Receive a command
0x00 Add group response Server to client Send a command
0x01 View group response Server to client Send a command
0x02 Get group membership response Server to client Send a command
0x03 Remove group response Server to client Send a command

Scenes cluster

Attributes:

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands

ID Name Direction Description
0x00 Recall Scene Client to server Send a command
0x01 Enhanced Add Scene Client to server Send a command
0x01 Enhanced Add Scene Response Client to server Receive a command

On/Off cluster

Attributes:

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands

ID Name Direction Description
0x00 Off Client to server Send a command
0x01 On Client to server Send a command

Level control cluster

Attributes:

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands (client)

ID Name Direction Description
0x00 Move to Level Client to server Send a command
0x01 Move Client to server Send a command
0x02 Step Client to server Send a command
0x03 Stop Client to server Send a command

Color control cluster

Attributes:

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands

ID Name Direction Description
0x00 Move to Hue Client to server Valid values range from 0x00 to 0xfe.
0x01 Move Hue Client to server /
0x02 Step Hue Client to server /
0x06 Move to Hue and Saturation Client to server /
0x0A Move to Color Temperature Client to server /
0x47 Stop Move Step Client to server /
0x4B Move Color Temperature Client to server /
0x4C Step Color Temperature Client to server /
0xE0 Change color temperature (Tuya-specific command) Client to server This attribute is two bytes. Valid values range from 0x0000 to 0x03E8.
0xE1 Change color (Tuya-specific command) Client to server 6 bytes in length.
  • Hue (H): two bytes in length. Valid values range from 0x0000 to 0x0168.
  • Saturation (S): two bytes in length. Valid values range from 0x0000 to 0x03E8.
  • Value (V): two bytes in length. Valid values range from 0x0000 to 0x03E8.
0xF0 Set mode (Tuya-specific command) Client to server Change the mode.
  • 0: White light
  • 1: Colored light
  • 2: Scene
  • 3: Music

Touchlink commissioning cluster

Attributes (server)

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Attributes (client)

ID Name Data type (ID) Range Default
0xFFFD ClusterRevision uint16 (0x21) 0x0000 to 0xffff 0x0001

Commands (server)

ID Name Direction Description
0x00 Scan request Client to server Receive a command
0x02 Device information request Client to server Receive a command
0x06 Identify request Client to server Receive a command
0x07 Reset to factory new request Client to server Receive a command
0x14 Network join end device request Client to server Receive a command
0x01 Scan response Server to client Send a command
0x03 Device information response Server to client Send a command
0x40 Endpoint information Server to client Send a command
0x41 Get group identifiers response Server to client Send a command
0x42 Get endpoint list response Server to client Send a command

Commands (client)

ID Name Direction Description
0x00 Scan request Client to server Send a command
0x02 Device information request Client to server Send a command
0x06 Identify request Client to server Send a command
0x07 Reset to factory new request Client to server Send a command
0x10 Network start request Client to server Send a command
0x12 Network join router request Client to server Send a command
0x14 Network join end device Client to server Send a command
0x01 Scan response Server to client Receive a command
0x03 Device information response Server to client Receive a command
0x11 Network start response Server to client Receive a command
0x13 Network join router response Server to client Receive a command
0x15 Network join end device response Server to client Receive a command
0x40 Endpoint information Server to client Receive a command
0x41 Get group identifiers response Server to client Receive a command
0x42 Get endpoint list response Server to client Receive a command