Matter Cluster 1024 — Illuminance Measurement
Matter Cluster 1024 (0x0400) Illuminance Measurement: attributes, commands, events, data types, shadow paths and bridge payload examples.
Matter Cluster 1024 — Illuminance Measurement Cluster
Matter Cluster 1024, also written as 0x0400, is the Illuminance Measurement Cluster.
The Illuminance Measurement cluster provides an interface to illuminance measurement functionality, including configuration and provision of notifications of illuminance measurements.
Cluster Identity
| Field | Value |
|---|---|
| Cluster ID decimal | 1024 |
| Cluster ID hex | 0x0400 |
| Cluster name | Illuminance Measurement |
| Cluster revision (Matter 1.6.1) | 5 |
| Role | application |
| Scope | Endpoint |
| PICS code | ILL |
| Typical endpoint | 1 |
Revision history
| Revision | Change |
|---|---|
| 1 | Mandatory global ClusterRevision attribute added; CCB 2048 2049 2050 |
| 2 | CCB 2167 |
| 3 | New data model format and notation |
| 4 | Removed P quality |
| 5 | Added F quality to MinMeasuredValue, MaxMeasuredValue, Tolerance and LightSensorType attributes |
Shadow Path Format
Cluster 1024 values in the device shadow use this format:
endpoint_id / 1024 / attribute_id
Example:
{
"1/1024/0": 1
}
| Part | Meaning |
|---|---|
1 | Endpoint ID |
1024 | Illuminance Measurement cluster |
0 | MeasuredValue attribute |
Data Types
LightSensorTypeEnum
| Value | Name | Conformance | Meaning |
|---|---|---|---|
| 0 | Photodiode | M | Indicates photodiode sensor type |
| 1 | CMOS | M | Indicates CMOS sensor type |
Cluster 1024 Attributes
Cluster 1024 defines 5 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) | — | — |
| 4 | 0x0004 | LightSensorType | LightSensorTypeEnum | O | R (read: view) | nullable | null |
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/1024/0
Indicates the illuminance in Lux (symbol lx) as follows: - MeasuredValue = 10,000 x log10(illuminance) + 1, where 1 lx $<=$ illuminance $<=$ 3.576 Mlx, corresponding to a MeasuredValue in the range 1 to 0xFFFE. The MeasuredValue attribute can take the following values: - 0 indicates a value of illuminance that is too low to be measured, - MinMeasuredValue $<=$ MeasuredValue $<=$ MaxMeasuredValue under normal circumstances, - null indicates that the illuminance measurement is invalid. The MeasuredValue attribute is updated continuously as new measurements are made.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | MinMeasuredValue to MaxMeasuredValue; allowed: 0 |
Example:
{
"1/1024/0": 1
}
Attribute 1 / 0x0001 — MinMeasuredValue
Path example:
1/1024/1
Indicates the minimum value of MeasuredValue that can be measured. A value of null indicates that this attribute is not defined. See Measured Value for more details.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | 1 to 65533 |
Example:
{
"1/1024/1": 1
}
Attribute 2 / 0x0002 — MaxMeasuredValue
Path example:
1/1024/2
Indicates the maximum value of MeasuredValue that can be measured. A value of null indicates that this attribute is not defined. See Measured Value for more details.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | M |
| Access | R (read: view) |
| Qualities | nullable |
| Constraint | min compute |
Example:
{
"1/1024/2": 1
}
Attribute 3 / 0x0003 — Tolerance
Path example:
1/1024/3
See Measured Value.
| Property | Value |
|---|---|
| Type | uint16 |
| Conformance | O |
| Access | R (read: view) |
| Constraint | max 2048 |
Example:
{
"1/1024/3": 1
}
Attribute 4 / 0x0004 — LightSensorType
Path example:
1/1024/4
Indicates the electronic type of the light sensor. This attribute is set to one of the non-reserved values listed in LightSensorTypeEnum or null in case the sensor type is unknown.
| Property | Value |
|---|---|
| Type | LightSensorTypeEnum |
| Conformance | O |
| Access | R (read: view) |
| Qualities | nullable |
| Default | null |
Values (LightSensorTypeEnum):
| Value | Name | Meaning |
|---|---|---|
| 0 | Photodiode | Indicates photodiode sensor type |
| 1 | CMOS | Indicates CMOS sensor type |
Example:
{
"1/1024/4": 0
}
Cluster 1024 Commands
Cluster 1024 defines no commands. It is read (and, for writable attributes, written) through attribute access only.
Cluster 1024 Events
Cluster 1024 defines no events.
SmartphoneKey Notes
- Cluster 1024 is not currently exposed by SmartphoneKey devices. This page documents the Matter 1.6.1 specification so that future devices can be interpreted without changes to the backend.
- Shadow paths follow
endpoint/1024/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.