Matter Cluster 145 — Electrical Energy Measurement Cluster

Cluster Identity

Revision history

Shadow Path Format

Cluster 145 values in the device shadow use this format:

endpoint_id / 145 / attribute_id

Example:

{
  "1/145/0": {
    "measurementType": 1,
    "measured": true,
    "minMeasuredValue": 1,
    "maxMeasuredValue": 1
  }
}

Cluster 145 Features

The FeatureMap attribute (1/145/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; 63 means every feature listed above is enabled.

Data Types

MeasurementTypeEnum

CumulativeEnergyResetStruct (struct)

This struct represents the times at which cumulative measurements were last zero, either due to initialization of the device, or an internal reset of the cumulative value.

EnergyMeasurementStruct (struct)

This struct indicates the amount of energy measured during a given measurement period. A server which does not have the ability to determine the time in UTC, or has not yet done so, must use the system time fields to specify the measurement period and observation times.

MeasurementAccuracyRangeStruct (struct)

MeasurementAccuracyStruct (struct)

Cluster 145 Attributes

Cluster 145 defines 6 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 — Accuracy

Path example:

1/145/0

Indicates the accuracy of energy measurement by this server. The value of the MeasurementType field on this MeasurementAccuracyStruct is ElectricalEnergy.

Value is a MeasurementAccuracyStruct struct (see Data Types).

Example:

{
  "1/145/0": {
    "measurementType": 1,
    "measured": true,
    "minMeasuredValue": 1,
    "maxMeasuredValue": 1
  }
}

Attribute 1 / 0x0001 — CumulativeEnergyImported

Path example:

1/145/1

Indicates the most recent measurement of cumulative energy imported by the server over the lifetime of the device, and the timestamp of when the measurement was recorded. The reporting interval of this attribute is manufacturer dependent. The server may choose to omit publication of deltas considered not meaningful. The server must NOT mark this attribute ready for report if the last time this was done was more recently than 1 second ago.

Value is a EnergyMeasurementStruct struct (see Data Types).

Example:

{
  "1/145/1": {
    "energy": 1,
    "startTimestamp": 0,
    "endTimestamp": 0,
    "startSystime": 0
  }
}

Attribute 2 / 0x0002 — CumulativeEnergyExported

Path example:

1/145/2

Indicates the most recent measurement of cumulative energy exported by the server over the lifetime of the device, and the timestamp of when the measurement was recorded. The reporting interval of this attribute is manufacturer dependent. The server may choose to omit publication of deltas considered not meaningful. The server must NOT mark this attribute ready for report if the last time this was done was more recently than 1 second ago.

Value is a EnergyMeasurementStruct struct (see Data Types).

Example:

{
  "1/145/2": {
    "energy": 1,
    "startTimestamp": 0,
    "endTimestamp": 0,
    "startSystime": 0
  }
}

Attribute 3 / 0x0003 — PeriodicEnergyImported

Path example:

1/145/3

Indicates the most recent measurement of energy imported by the server and the period during which it was measured. The reporting interval of this attribute is manufacturer dependent. The server may choose to omit publication of deltas considered not meaningful. The server must NOT mark this attribute ready for report if the last time this was done was more recently than 1 second ago.

Value is a EnergyMeasurementStruct struct (see Data Types).

Example:

{
  "1/145/3": {
    "energy": 1,
    "startTimestamp": 0,
    "endTimestamp": 0,
    "startSystime": 0
  }
}

Attribute 4 / 0x0004 — PeriodicEnergyExported

Path example:

1/145/4

Indicates the most recent measurement of energy exported by the server and the period during which it was measured. The reporting interval of this attribute is manufacturer dependent. The server may choose to omit publication of deltas considered not meaningful. The server must NOT mark this attribute ready for report if the last time this was done was more recently than 1 second ago.

Value is a EnergyMeasurementStruct struct (see Data Types).

Example:

{
  "1/145/4": {
    "energy": 1,
    "startTimestamp": 0,
    "endTimestamp": 0,
    "startSystime": 0
  }
}

Attribute 5 / 0x0005 — CumulativeEnergyReset

Path example:

1/145/5

Indicates when cumulative measurements were most recently zero.

Value is a CumulativeEnergyResetStruct struct (see Data Types).

Example:

{
  "1/145/5": {
    "importedResetTimestamp": 0,
    "exportedResetTimestamp": 0,
    "importedResetSystime": 0,
    "exportedResetSystime": 0
  }
}

Cluster 145 Commands

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

Cluster 145 Events

Event 0 — CumulativeEnergyMeasured

This event is generated when the server takes a snapshot of the cumulative energy imported by the server, exported from the server, or both, but not more frequently than the rate mentioned in the description above of the related attribute.

Event 1 — PeriodicEnergyMeasured

This event is generated when the server reaches the end of a reporting period for imported energy, exported energy, or both.

SmartphoneKey Notes

• Cluster 145 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/145/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.