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

Curtain Switch

Last Updated on : 2022-06-06 15:06:10download

Zigbee protocol version

Parameter Value
Device ID Profile ID
0x0202 0x0104

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 switch No
14 Indicator status 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.