Matter Cluster 1029 — Relative Humidity Measurement
Matter Cluster 1029 (0x0405) Relative Humidity Measurement: attributes, commands, events, data types, shadow paths and bridge payload examples.
Matter Cluster 1029 — Relative Humidity Measurement Cluster
Matter Cluster 1029, also written as 0x0405, is the Relative Humidity Measurement Cluster.
This is a base cluster. The server cluster provides an interface to water content measurement functionality. The measurement is reportable and may be configured for reporting.
Cluster Identity
| Field | Value |
|---|---|
| Cluster ID decimal | 1029 |
| Cluster ID hex | 0x0405 |
| Cluster name | Relative Humidity Measurement |
| Cluster revision (Matter 1.6.1) | 5 |
| Role | application |
| Scope | Endpoint |
| PICS code | RH |
| Typical endpoint | 1 |
Revision history
| Revision | Change |
|---|---|
| 1 | Mandatory global ClusterRevision attribute added |
| 2 | CCB 2241 |
| 3 | New data model format and notation |
| 4 | Removed P quality |
| 5 | Added F quality to MinMeasuredValue, MaxMeasuredValue and Tolerance attributes |
Shadow Path Format
Cluster 1029 values in the device shadow use this format:
endpoint_id / 1029 / attribute_id
Example:
{
"1/1029/0": 1
}
| Part | Meaning |
|---|---|
1 | Endpoint ID |
1029 | Relative Humidity Measurement cluster |
0 | MeasuredValue attribute |
Cluster 1029 Attributes
Cluster 1029 defines 4 attributes plus the global attributes. Conformance: M mandatory, O optional, a feature code means "mandatory when that feature is present", square brackets mean "optional when …".
| ID | Hex | Attribute | Type | Conformance | Access | Qualities | Default |
|---|---|---|---|---|---|---|---|
| 0 | 0x0000 | MeasuredValue | uint16 | M | R (read: view) | nullable | — |
| 1 | 0x0001 | MinMeasuredValue | uint16 | M | R (read: view) | nullable | — |
| 2 | 0x0002 | MaxMeasuredValue | uint16 | M | R (read: view) | nullable | — |
| 3 | 0x0003 | Tolerance | uint16 | O | R (read: view) | — | — |
Global attributes
| ID | Hex | Attribute | Meaning |
|---|---|---|---|
| 65528 | 0xFFF8 | GeneratedCommandList | Response command IDs this server generates. |
| 65529 | 0xFFF9 | AcceptedCommandList | Command IDs this server accepts. |
| 65531 | 0xFFFB | AttributeList | Attribute IDs implemented. |
| 65532 | 0xFFFC | FeatureMap | Implemented optional features (see above). |
| 65533 | 0xFFFD | ClusterRevision | Cluster revision implemented; 5 for a Matter 1.6.1 device. |
Attribute Details
Attribute 0 / 0x0000 — MeasuredValue
Path example:
1/1029/0
MeasuredValue represents the water content in % as follows: MeasuredValue = 100 x water content Where 0% < = water content < = 100%, corresponding to a MeasuredValue in the range 0 to 10000. The maximum resolution this format allows is 0.01%. MinMeasuredValue and MaxMeasuredValue define the range of the sensor. The null value indicates that the measurement is unknown, otherwise the range is as described in Measured Value.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | MinMeasuredValue to MaxMeasuredValue |
Example:
{
"1/1029/0": 1
}
Attribute 1 / 0x0001 — MinMeasuredValue
Path example:
1/1029/1
The MinMeasuredValue attribute indicates the minimum value of MeasuredValue that can be measured. The null value means this attribute is not defined. See Measured Value for more details.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | max 9999 |
Example:
{
"1/1029/1": 1
}
Attribute 2 / 0x0002 — MaxMeasuredValue
Path example:
1/1029/2
The MaxMeasuredValue attribute indicates the maximum value of MeasuredValue that can be measured. The null value means this attribute is not defined. See Measured Value for more details.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | compute to 10000 |
Example:
{
"1/1029/2": 1
}
Attribute 3 / 0x0003 — Tolerance
Path example:
1/1029/3
See Measured Value.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | O |
| Access | R (read: view) |
| Constraint | max 2048 |
Example:
{
"1/1029/3": 1
}
Cluster 1029 Commands
Cluster 1029 defines no commands. It is read (and, for writable attributes, written) through attribute access only.
Cluster 1029 Events
Cluster 1029 defines no events.
SmartphoneKey Notes
- Humidity is reported in hundredths of a percent:
4520= 45.20 % RH. - Shadow paths follow
endpoint/1029/attribute; attribute values that the device reports as unreadable are written asn/a. - Attribute IDs, command IDs and enum values on this page come from the CSA Matter 1.6.1 data model; descriptions are condensed from the specification text.