The Device Energy Management cluster (0x0098) is a Matter cluster that Reports Energy Smart Appliance state and allows energy management systems to control device energy consumption (forecasts, constraints, opt-outs).. It defines 10 commands and 9 attributes and is mandatory for 1 device type.
Device Energy Management 0x0098
Reports Energy Smart Appliance state and allows energy management systems to control device energy consumption (forecasts, constraints, opt-outs).
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 9
Commands 10
Features 8
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 | ESAType | ESATypeEnum | |
| 0x0001 | ESACanGenerate | boolean | |
| 0x0002 |
ESAState
max 0x04
|
ESAStateEnum | |
| 0x0003 |
AbsMinPower
0xC000000000000000..0x3FFFFFFFFFFFFFFF
|
power_mw | |
| 0x0004 |
AbsMaxPower
0xC000000000000000..0x3FFFFFFFFFFFFFFF
|
power_mw | |
| 0x0005 |
PowerAdjustmentCapability
nullable
|
PowerAdjustCapabilityStruct | Optional |
| 0x0006 |
Forecast
nullable
|
ForecastStruct | Optional |
| 0x0007 |
OptOutState
max 0x03
|
OptOutStateEnum | Optional |
| 0x0008 |
PowerRangeAdjustment
nullable
|
PowerRangeAdjustStruct | Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
PowerAdjustRequest
Optional Provisional
Allows a client to request an adjustment in the power consumption of an ESA for a specified duration.
|
client→server |
Power: power_mw, Duration: elapsed_s, Cause: AdjustmentCauseEnum |
| 0x01 |
CancelPowerAdjustRequest
Optional Provisional
Allows a client to cancel an ongoing PowerAdjustmentRequest operation.
|
client→server | None |
| 0x02 |
StartTimeAdjustRequest
Optional Provisional
Allows a client to adjust the start time of a Forecast sequence that has not yet started operation (i.e. where the current Forecast StartTime is in the future).
|
client→server |
RequestedStartTime: epoch_s, Cause: AdjustmentCauseEnum |
| 0x03 |
PauseRequest
Optional Provisional
Allows a client to temporarily pause an operation and reduce the ESAs energy demand.
|
client→server |
Duration: elapsed_s, Cause: AdjustmentCauseEnum |
| 0x04 |
ResumeRequest
Optional Provisional
Allows a client to cancel the PauseRequest command and enable earlier resumption of operation.
|
client→server | None |
| 0x05 |
ModifyForecastRequest
Optional Provisional
Allows a client to modify a Forecast within the limits allowed by the ESA.
|
client→server |
ForecastID: int32u, SlotAdjustments: SlotAdjustmentStruct, Cause: AdjustmentCauseEnum |
| 0x06 |
RequestConstraintBasedForecast
Optional Provisional
Allows a client to ask the ESA to recompute its Forecast based on power and time constraints.
|
client→server |
Constraints: ConstraintsStruct, Cause: AdjustmentCauseEnum |
| 0x07 |
CancelRequest
Optional Allows a client to request cancellation of a previous adjustment request in a StartTimeAdjustRequest, ModifyForecastRequest or RequestConstraintBasedForecast command.
|
client→server | None |
| 0x08 |
PowerRangeAdjustRequest
Optional Allows a client to request an adjustment in the range of powers that an ESA can operate within for a specified duration.
|
client→server |
MinPower: power_mw, MaxPower: power_mw, Duration: elapsed_s, Cause: AdjustmentCauseEnum |
| 0x09 |
CancelPowerRangeAdjustRequest
Optional Allows a client to cancel an ongoing PowerRangeAdjustmentRequest operation.
|
client→server | None |
PowerAdjustment
(PA)
bit 0
Allows an EMS to make a temporary power adjustment (within the limits offered by the ESA).
PowerForecastReporting
(PFR)
bit 1
Allows an ESA to advertise its indicative future power consumption vs time.
StateForecastReporting
(SFR)
bit 2
Allows an ESA to advertise its indicative future state vs time.
StartTimeAdjustment
(STA)
bit 3
Allows an EMS to delay an ESA's planned operation.
Pausable
(PAU)
bit 4
Allows an EMS to pause an ESA's planned operation.
ForecastAdjustment
(FA)
bit 5
Allows an EMS to adjust an ESA's planned operation.
ConstraintBasedAdjustment
(CON)
bit 6
Allows an EMS to request constraints to an ESA's planned operation.
PowerRangeAdjustment
(PRA)
bit 7
Allows an EMS to make a temporary power range adjustment (within the limits offered by the ESA).
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
1 device in the survey implement this cluster