Dimmer Switch

Zigbee basics

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

Endpoint

Endpoint	Description
1	The endpoint used by the current dimmer switch.

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	Format: XXX…XXX. 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