Matter Cluster 91 — Air Quality
Matter Cluster 91 (0x005B) Air Quality: attributes, commands, events, data types, shadow paths and bridge payload examples.
Matter Cluster 91 — Air Quality Cluster
Matter Cluster 91, also written as 0x005B, is the Air Quality Cluster.
This cluster provides an interface to air quality classification using distinct levels with human-readable labels.
Cluster Identity
| Field | Value |
|---|---|
| Cluster ID decimal | 91 |
| Cluster ID hex | 0x005B |
| Cluster name | Air Quality |
| Cluster revision (Matter 1.6.1) | 1 |
| Role | application |
| Scope | Endpoint |
| PICS code | AIRQUAL |
| Typical endpoint | 1 |
Revision history
| Revision | Change |
|---|---|
| 1 | Initial revision |
Shadow Path Format
Cluster 91 values in the device shadow use this format:
endpoint_id / 91 / attribute_id
Example:
{
"1/91/0": 1
}
| Part | Meaning |
|---|---|
1 | Endpoint ID |
91 | Air Quality cluster |
0 | AirQuality attribute |
Cluster 91 Features
The FeatureMap attribute (1/91/65532) is a bitmap. Each bit set means the device implements that feature and the attributes and commands that depend on it.
| Bit | Code | Feature | Conformance | Meaning |
|---|---|---|---|---|
| 0 | FAIR | Fair | O | Cluster supports the Fair air quality level |
| 1 | MOD | Moderate | O | Cluster supports the Moderate air quality level |
| 2 | VPOOR | VeryPoor | O | Cluster supports the Very poor air quality level |
| 3 | XPOOR | ExtremelyPoor | O | Cluster supports the Extremely poor air quality level |
Example: FeatureMap = 0 means no optional feature is enabled; 15 means every feature listed above is enabled.
Data Types
AirQualityEnum
The AirQualityEnum provides a representation of the quality of the analyzed air. It is up to the device manufacturer to determine the mapping between the measured values and their corresponding enumeration values.
| Value | Name | Conformance | Meaning |
|---|---|---|---|
| 0 | Unknown | M | The air quality is unknown. |
| 1 | Good | M | The air quality is good. |
| 2 | Fair | FAIR | The air quality is fair. |
| 3 | Moderate | MOD | The air quality is moderate. |
| 4 | Poor | M | The air quality is poor. |
| 5 | VeryPoor | VPOOR | The air quality is very poor. |
| 6 | ExtremelyPoor | XPOOR | The air quality is extremely poor. |
Cluster 91 Attributes
Cluster 91 defines 1 attribute 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 | AirQuality | AirQualityEnum | M | 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; 1 for a Matter 1.6.1 device. |
Attribute Details
Attribute 0 / 0x0000 — AirQuality
Path example:
1/91/0
Indicates a value from AirQualityEnum that is indicative of the currently measured air quality.
| Property | Value |
|---|---|
| Type | AirQualityEnum |
| Conformance | M |
| Access | R (read: view) |
| Constraint | desc |
Values (AirQualityEnum):
| Value | Name | Meaning |
|---|---|---|
| 0 | Unknown | The air quality is unknown. |
| 1 | Good | The air quality is good. |
| 2 | Fair | The air quality is fair. |
| 3 | Moderate | The air quality is moderate. |
| 4 | Poor | The air quality is poor. |
| 5 | VeryPoor | The air quality is very poor. |
| 6 | ExtremelyPoor | The air quality is extremely poor. |
Example:
{
"1/91/0": 1
}
Cluster 91 Commands
Cluster 91 defines no commands. It is read (and, for writable attributes, written) through attribute access only.
Cluster 91 Events
Cluster 91 defines no events.
SmartphoneKey Notes
- Cluster 91 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/91/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.