Index
Is this page helpful?
YesNoZigbee Connection Standard for Water Detector
Last Updated on : 2022-06-16 07:17:37download
Zigbee basics
| Parameter | Value |
|---|---|
| Profile ID | 0x0104 |
| Device ID | 0x0402 |
| Endpoint | Description |
|---|---|
| 1 | A unique endpoint associated with a Zigbee device. |
Supported clusters
| Input cluster (server) | Output cluster (client) |
|---|---|
| Basic (0x0000) | OTA upgrade (0x0019) |
| Power configuration (0x0001) | / |
| IAS zone (0x0500) | / |
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 value |
|---|---|---|---|---|
| 0x0000 | ZCLVersion | uint8 (0x20) | 0x00 to 0xff | 0x03 |
| 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. |
| 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, mxfe4y4e by default. 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. |
| 0x0005 | ModelIdentifier | string (0x42) | 0 to 32 bytes | TS0207, 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 |
Power configuration
Attributes
| ID | Name | Data type (ID) | Range | Default value |
|---|---|---|---|---|
| 0x0000 | MainsVoltage | uint16 (0x21) | 0x0000 to 0xffff | 0x03 |
| 0x0020 | BatteryVoltage | uint8 (0x20) | 24 to 30 (2.4V to 3.0V) | 30 |
| 0x0021 | BatteryPercentageRemaining | uint8 (0x20) | 0 to 200 (0% to 100%) | 200 |
| 0xfffd | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
IAS zone
Attributes
| ID | Name | Data type (ID) | Range | Default value |
|---|---|---|---|---|
| 0x0000 | ZoneState | enum8 (0x30) | All | 0 |
| 0x0001 | ZoneType | enum16 (0x31) | All | 0x002a |
| 0x0002 | ZoneStatus | map16 (0x19) | All | 0X00 (Status alarm bit alarm1, set to 1 to report an alarm) |
| 0x0010 | IAS_CIE_Address | EUI64 (0xF0) | - | - |
| 0x0011 | ZoneID | uint8 (0x20) | 0x00 - 0xff | 0xff |
| 0xfffd | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
Commands
| ID | Name | Direction | Description |
|---|---|---|---|
| 0x00 | Zone Status Change Notification | Server to client | The Zigbee device reports alarms to the gateway. |
| 0x01 | Zone Enroll Request | Server to client | The Zigbee device requests the Zone ID from the gateway. |
| 0x00 | Zone Enroll Response | Client to server | The gateway returns the Zone ID to the Zigbee device. |
Commands
| ID | Name | Direction | Description |
|---|---|---|---|
| 0x00 | Zone Status Change Notification | Server to client | The Zigbee device reports alarms to the gateway. |
| 0x01 | Zone Enroll Request | Server to client | The Zigbee device requests the Zone ID from the gateway. |
| 0x00 | Zone Enroll Response | Client to server | The gateway returns the Zone ID to the Zigbee device. |
OTA upgrade
Attributes
| ID | Name | Data type (ID) | Range | Default value |
|---|---|---|---|---|
| 0x0000 | UpgradeServerID | EUI64 (0xF0) | / | 0xffffffffffffffff |
| 0x0001 | FileOffset | uint32 (0x23) | / | 0x00000000 |
| 0x0002 | CurrentFileVersion | uint32 (0x23) | / | 0x00000040 |
| 0x0006 | ImageUpgradeStatus | enum8 (0x30) | / | 0x00 |
| 0x0007 | Manufacturer ID | uint16 (0x21) | / | 0x1002 |
| 0x0008 | Image Type ID | uint16 (0x21) | / | 0x1602 |
| 0x0009 | MinimumBlockPeriod | uint16 (0x21) | / | 0x0000 |
| 0xfffd | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
Commands
| ID | Name | Direction | Description |
|---|---|---|---|
| 0x00 | Image Notify | Server to client | / |
| 0x01 | Query Next Image Request | Client to server | / |
| 0x02 | Query Next Image Response | Server to client | / |
| 0x03 | Image Block Request | Client to server | / |
| 0x05 | Image Block Response | Server to client | / |
| 0x06 | Upgrade End Request | Client to server | / |
| 0x07 | Upgrade End Response | Server to client | / |
Mapping between DPs and clusters
| DP ID | DP description | Standard command |
|---|---|---|
| 1 | Water detector status | Yes |
| 4 | Battery level | Yes |
| 5 | Tamper alarm | Yes |
DP1 water detector status
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Report | 0x0500 | 0x0002 (ZoneStatus) | Bit0 (alarm1).
|
DP4 Battery level
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Report | 0x0001 | 0x0020 (BatteryVoltage) | 24 to 30 (2.4V to 3.0V) |
| Report | 0x0001 | 0x0021 (BatteryPercentageRemaining) | 0 to 200 (0% to 100%) |
If the reported value of BatteryVoltage is 30, it indicates 3.0V voltage. If the reported value of BatteryPercentageRemaining is 180, it indicates a battery level of 90%.
DP5 Tamper alarm
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Report | 0x0500 | 0x0002 (ZoneStatus) | Bit2 (tamper).
|
The sensor reports the alarm status when the sensor detects tampering and reports no alarm when the alarm is canceled.
Default heartbeat (4 hours, report battery level)
For more information, see DP4 Battery level.
Is this page helpful?
YesNoIs this page helpful?
YesNoMarketing Cooperation
Business Cooperation
Customer Service
Media Inquiry
© 2022 Tuya Inc.