Matter Cluster 160 — Electrical Grid Conditions Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 160 values in the device shadow use this format:

endpoint_id / 160 / attribute_id

Example:

{
  "1/160/0": true
}

Cluster 160 Features

The FeatureMap attribute (1/160/65532) is a bitmap. Each bit set means the device implements that feature and the attributes and commands that depend on it.

Example: FeatureMap = 0 means no optional feature is enabled; 1 means every feature listed above is enabled.

Data Types

ThreeLevelEnum

This data type is derived from enum8 and is used for indicating three levels: Low, Medium, High.

ElectricalGridConditionsStruct (struct)

This represents the greenhouse gas carbon intensity over a given period.

Cluster 160 Attributes

Cluster 160 defines 3 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 …".

Global attributes

Attribute Details

Attribute 0 / 0x0000 — LocalGenerationAvailable

Path example:

1/160/0

This indicates if there is known to be local generation (for example Solar PV or Battery Storage) at the premises. If the presence of any local generation is unknown, or cannot be determined, the value is null.

Example:

{
  "1/160/0": true
}

Attribute 1 / 0x0001 — CurrentConditions

Path example:

1/160/1

This indicates the current electricity supply conditions. If the current conditions are unknown, or cannot be determined, the value is null.

Value is a ElectricalGridConditionsStruct struct (see Data Types).

Example:

{
  "1/160/1": {
    "periodStart": 1,
    "periodEnd": 1,
    "gridCarbonIntensity": 1,
    "gridCarbonLevel": 0
  }
}

Attribute 2 / 0x0002 — ForecastConditions

Path example:

1/160/2

This indicates the forecast of upcoming electricity supply conditions. If the forecast is unable to be determined, this list is empty. The list entries is in time order: - All entries except the last one has a non-null PeriodEnd. - For all entries except the first one, PeriodStart is greater than the previous entry's PeriodEnd.

Each entry is a ElectricalGridConditionsStruct (see Data Types).

Example:

{
  "1/160/2": []
}

Cluster 160 Commands

Cluster 160 defines no commands. It is read (and, for writable attributes, written) through attribute access only.

Cluster 160 Events

Event 0 — CurrentConditionsChanged

This event is generated when the value of the CurrentConditions attribute changes.

SmartphoneKey Notes

• Cluster 160 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/160/attribute; attribute values that the device reports as unreadable are written as n/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.