Temperature and Humidity Sensor
Last Updated on : 2023-09-07 10:23:06download
Zigbee basics
| Parameter | Value |
|---|---|
| Profile ID | 0x0104 |
| Device ID | 0x0302 |
Endpoint
| Endpoint | Description |
|---|---|
| 1 | The endpoint used by the current temperature and humidity sensor. |
Supported clusters
| Input clusters (server) | Output clusters (client) |
|---|---|
| Basic (0x0000) | OTA Upgrade (0x0019) |
| Power Configuration (0x0001) | / |
| Temperature Measurement (0x0402) | / |
| Relative Humidity Measurement (0x0405) | / |
Supported attributes and commands
Basic cluster
Attributes
| ID | Name | Data type (ID) | Range | Default |
|---|---|---|---|---|
| 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 | 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 experience and functions of the app. If no specific PID is required, the default one can be used. |
| 0x0005 | ModelIdentifier | string (0x42) | 0 to 32 bytes | TY0201 |
| 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 |
|---|---|---|---|---|
| 0x0020 | Battery Voltage | uint8 (0x20) | 0x00 to 0xff | 0x00 |
| 0x0021 | Battery Percentage Remaining | uint8 (0x20) | 0x00 to 0xff | 0x00 |
| 0xFFFD | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
Temperature Measurement cluster
Attributes
| ID | Name | Data type (ID) | Range | Default |
|---|---|---|---|---|
| 0x0000 | Measured value | int16 (0x29) | / | 0x00 |
| 0xFFFD | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
Relative Humidity Measurement cluster
Attributes
| ID | Name | Data type (ID) | Range | Default |
|---|---|---|---|---|
| 0x0000 | Measured value | uint16 (0x21) | / | 0x00 |
| 0xFFFD | ClusterRevision | uint16 (0x21) | 0x0000 to 0xffff | 0x0001 |
Over The Air Upgrade cluster
Attributes
| ID | Name | Data type (ID) | Range | Default |
|---|---|---|---|---|
| 0x0000 | UpgradeServerID | EUI64 (0xF0) | / | 0xfffffffffffffffff |
| 0x0001 | FileOffset | uint32 (0x23) | / | 0x00000000 |
| 0x0002 | CurrentFileVersion | uint32 (0x23) | / | 0x00000000 |
| 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 |
|---|---|---|
| 0x00 | Image Notify | Server to Client |
| 0x01 | Query Next Image Request | Client to Server |
| 0x03 | Image Block Request | Client to Server |
| 0x06 | Upgrade End Request | Client to Server |
Mapping between DPs and clusters
| DPID | DP description | Standard command |
|---|---|---|
| 1 | Temperature | Yes |
| 2 | Humidity | Yes |
| 4 | Battery level | Yes |
DP1 Temperature
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Server to client | 0x0402 | 0x0000: Measured value | Value range: 0x954d to 0x7fff |
DP4 Humidity
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Server to client | 0x0405 | 0x0000: Measured value | Valid values: 0 to 0x2710. |
DP5 Battery level
| Direction | Cluster ID | Attribute ID | Value |
|---|---|---|---|
| Server to client | 0x0001 | 0x0020 (BatteryVoltage) | 0x00 to 0xff |
| Server to client | 0x0001 | 0x0021 (BatteryPercentageRemaining) | 0x00 to 0xff |
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%.
Default heartbeat (4 hours, report battery level)
For more information, see DP5 Battery level.
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedbackMarketing Cooperation
Business Cooperation
Customer Service
Media Inquiry
© 2024 Tuya Inc.