Gateway ConnectivityConnect Sub-Devices to GatewaysIntegration by Protocol DevelopmentZigbee ConnectivityCurtain Switch

Curtain Switch

Last Updated on : 2023-09-07 10:23:09download

Zigbee protocol version

Parameter	Value
Device ID	Profile ID
0x0202	0x0104

Endpoint

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

Supported clusters

Input clusters (server)	Output clusters (client)
Basic (0x0000)	OTA Upgrade (0x0019)
Groups (0x0004)	/
Scenes (0x0005)	/
On/Off (0x0006)	/
Window Covering (0x0102)	/

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: TZ3002. 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	SM130F
0x0007	PowerSource	enum8 (0x30)	0x00 to 0xff	`0x01`, used for connection to Tuya-enabled Zigbee gateways and representing mains-powered devices.
0xFFFD	ClusterRevision	uint16 (0x21)	0x0000 to 0xffff	0x0001

Commands

ID	Name	Direction	Description
0x00	Reset to Factory Defaults	Client to Server	/

On/Off cluster

Attributes

ID	Name	Data type (ID)	Range	Default
0x5000	Backlight switch (Tuya-specific attribute)	enum8 (0x30)	0: Off. 1: On.	0x00
0x8001	Indicator status (Tuya-specific attribute)	enum8 (0x30)	0: Indicates status. The indicator comes on when the switch is turned on. 1: Indicates position. The indicator comes on when the switch is turned off. 2: Indicator is off.	0

Window Covering cluster

Attributes

ID	Name	Data type (ID)	Range	Default
0x0008	Percentage	uint8 (0x20)	Valid values range from 0 to 100.	/
0xF000	Curtain switch	enum8 (0x30)	Value 0: Open 1: Stop 2: Close	/
0xF001	Accurate calibration (Tuya-specific attribute)	enum8 (0x30)	Value 0: Calibration started. 1: Calibration finished.	/
0xF002	Motor steering (Tuya-specific attribute)	enum8 (0x30)	Value 0: Default 1: Reverse	/
0xF003	Travel (Tuya-specific attribute)	uint16 (0x21)	30 to 9000	In units of 0.1 seconds.

Mapping between DPs and clusters

DPID	DP description	Standard command
1	Curtain switch 1	Yes
4	Curtain switch 2	Yes
2	Percentage 1	Yes
5	Percentage 2	Yes
3	Accurate calibration 1	No
6	Accurate calibration 2	No
8	Motor rotation direction 1	No
9	Motor rotation direction 2	No
10	Quick calibration 1	No
11	Quick calibration 2	No
7	Backlight on/off	No
14	Indicator state	No

DP1 and DP4 Curtain switch 1 and 2

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0102: Window Covering	0x00: Open 0x01: Close 0x02: Stop 0x03: Continue	/
Server to client	0x0102: Window Covering	0xF000 (Tuya-specific attribute)	Value 0: Open 1: Stop 2: Close

DP2 and DP5 Percentage control 1 and 2

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0102: Window Covering	0x05: Go to Lift Percentage	/
Server to client	0x0102: Window Covering	0x0008: Current Position Lift Percentage	Valid values range from 0 to 100.

DP3 and DP6 Accurate calibration 1 and 2

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0102: Window Covering	0xF001: Accurate calibration (Tuya-specific attribute)	/
Server to client	0x0102: Window Covering	0xF001: Accurate calibration (Tuya-specific attribute)	Value 0: Calibration started. 1: Calibration finished.

DP8 and DP9 Motor steering 1 and 2

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0102: Window Covering	0xF002: Motor steering (Tuya-specific attribute)	/
Server to client	0x0102: Window Covering	0xF002: Motor steering (Tuya-specific attribute)	Value 0: Default 1: Reverse

DP10 and DP11 Quick calibration 1 and 2

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0102: Window Covering	0xF003: Travel (Tuya-specific attribute)	/
Server to client	0x0102: Window Covering	0xF003: Travel (Tuya-specific attribute)	Valid values range from 30 to 9000, in units of 0.1 seconds.

DP7 Backlight switch

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0006: On/Off	0x5000 (Tuya-specific attribute)	0: Off. 1: On.
Server to client	0x0006: On/Off	0x5000 (Tuya-specific attribute)	0: Off. 1: On.

DP14 Indicator status

Direction	Cluster ID	Command/Attribute ID	Value
Client to server	0x0006: On/Off	0x8001 (Tuya-specific attribute)	Value 0: Indicates status. The indicator comes on when the switch is turned on. 1: Indicates position. The indicator comes on when the switch is turned off. 2: Off
Server to client	0x0006: On/Off	0x8001 (Tuya-specific attribute)	Value 0: Indicates status. The indicator comes on when the switch is turned on. 1: Indicates position. The indicator comes on when the switch is turned off. 2: Off
Server to client	0x0006: On/Off	0x8001 (Tuya-specific attribute)	0: Indicates status. The indicator comes on when the switch is turned on. 1: Indicates position. The indicator comes on when the switch is turned off. 2: Indicator is off.

Prev DocMulti-Gang Switch

Next DocWater Detector