Skip to content

Arduino wrapper support for Matter Electrical Power Measurement Cluster (0x0090) and Electrical Energy Measurement Cluster (0x0091) #11758

@dsilletti

Description

@dsilletti

Related area

Matter

Hardware specification

This feature request does not depend on specific hardware.

Is your feature request related to a problem?

Currently, the Matter.h Arduino wrapper exposes endpoint classes for lights, sensors, thermostat, fans, etc., but does not provide a wrapper for the Matter Electrical Power Measurement (EPM) cluster (0x0090) and Electrical Energy Measurement Cluster (0x0091)

Developers working with devices with power monitoring need direct access to this cluster to expose standard attributes (RMSVoltage, RMSCurrent, ActivePower, PowerFactor, etc.) to Matter controllers.

Describe the solution you'd like

Please add Arduino wrapper support for the Electrical Power Measurement cluster, similar to how MatterOnOffLight, MatterTemperatureSensor, etc. are provided.

Example API proposal:

// Cluster 0x0090 — Electrical Power Measurement
MatterElectricalPowerMeasurement PowerMeter;

// Cluster 0x0091 — Electrical Energy Measurement
MatterElectricalEnergyMeasurement EnergyMeter;

// Initialize with default values
PowerMeter.begin();
EnergyMeter.begin();

// Update attributes — Cluster 0x0090
PowerMeter.setRMSVoltage(int32_t mV);        // e.g. 230000 mV
PowerMeter.setRMSCurrent(int32_t mA);        // e.g. 500 mA
PowerMeter.setActivePower(int32_t W);        // e.g. 115 W
PowerMeter.setPowerFactor(int16_t pf_x1000); // PF ×1000 (e.g. 0.953 → 953)

// Update attributes — Cluster 0x0091
EnergyMeter.setActiveEnergyWh(int64_t Wh);        // e.g. 12500 Wh
EnergyMeter.setReactiveEnergyVarh(int64_t Varh);  // optional
EnergyMeter.setApparentEnergyVAh(int64_t VAh);    // optional

Describe alternatives you've considered

No response

Additional context

No response

I have checked existing list of Feature requests and the Contribution Guide

  • I confirm I have checked existing list of Feature requests and Contribution Guide.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions