DeviceEnergyManagement Cluster

Cluster ID: 0x0098  |  Endpoint: Device endpoint with energy management capabilities

DeviceEnergyManagement (DEM) is a core energy management Cluster introduced in Matter 1.4, enabling Energy Management Systems (EMS) to negotiate power adjustments, forecast energy usage plans, and optimize energy consumption with various energy-consuming or generating devices. It applies to EV chargers (EVSE), heat pumps, battery storage, solar systems, dishwashers, washing machines, and other ESA (Energy Smart Appliance) devices.

Commands

DeviceEnergyManagement Cluster has 8 commands, each corresponding to different Feature capabilities. The EMS (Energy Management System) uses these commands to adjust the device's power, start time, operating state, and energy forecast. Click a command ID in the table below to jump to its detailed description.

PowerAdjustRequest -- Power Adjustment Request (0x00)

Requests the device to adjust to a target power level for a specified duration. The EMS uses this command to reduce device power during peak pricing periods or increase power during off-peak periods to optimize energy costs. Upon success, ESAState changes to PowerAdjustActive (3).

↑ Back to Commands

CancelPowerAdjustRequest -- Cancel Power Adjustment (0x01)

Cancels an ongoing power adjustment; the device immediately returns to normal operating state. No parameters. On success, ESAState changes from PowerAdjustActive back to Online.

↑ Back to Commands

StartTimeAdjustRequest -- Start Time Adjustment (0x02)

Requests the device to shift the start time in its Forecast to a specified time. Used to move the device's operating period from peak to off-peak without changing total energy consumption.

↑ Back to Commands

PauseRequest -- Pause Operation (0x03)

Requests the device to pause its current operation. Only applicable to devices supporting pause (PAU Feature). On success, ESAState changes to Paused (4).

↑ Back to Commands

ResumeRequest -- Resume Operation (0x04)

Requests the device to resume paused operation. No parameters. On success, ESAState changes from Paused back to Online.

↑ Back to Commands

ModifyForecastRequest -- Modify Forecast (0x05)

Modifies the power and time parameters of one or more Slots in the device's current Forecast. The EMS uses this command to directly adjust the device's energy plan, such as reducing the expected power for a certain period.

↑ Back to Commands

RequestConstraintBasedForecast -- Constraint-Based Forecast Request (0x06)

Provides the device with a set of power/energy constraints and requests it to regenerate its Forecast accordingly. Unlike ModifyForecastRequest which directly modifies parameters, this command tells the device "figure out how to meet these constraints yourself".

↑ Back to Commands

CancelRequest -- Cancel Request (0x07)

Cancels all currently ongoing optimization requests (StartTimeAdjust, Pause, ModifyForecast, ConstraintBasedForecast); the device returns to its original autonomous operation plan. No parameters. Requires the device to support at least one of the STA, PAU, FA, or CON Features.

↑ Back to Commands

Attributes

DeviceEnergyManagement Cluster attributes are organized into three functional groups. Click an attribute ID in the summary table to jump to its detailed description.

ESA Basic Information (0x0000-0x0002)

Describes the device's type, energy generation capability, and current state. These three attributes are foundational for all DEM devices.

ESATypeEnum Enum Values

ESAStateEnum Enum Values

↑ Back to Attributes

Power & Adjustment (0x0003-0x0005)

Defines the device's power range and adjustment capabilities. The EMS must read these attributes to confirm the adjustment range before sending a PowerAdjustRequest.

↑ Back to Attributes

Forecast & Optimization (0x0006-0x0007)

The device's energy forecast plan and user opt-out state. Forecast is the most critical data structure in DEM.

OptOutStateEnum Enum Values

↑ Back to Attributes

Feature Bitmap

The DeviceEnergyManagement Cluster declares the device's supported energy management capabilities via FeatureMap (0xFFFC). Different Feature combinations determine the available commands and attributes:

Example Data

Read result of the DeviceEnergyManagement Cluster for an online EVSE (EV charger):

{
  // --- ESA Basic Info ---
  "0x0000": 0,              // ESAType = EVSE (EV charger)
  "0x0001": false,          // ESACanGenerate = false (consumes only, does not generate)
  "0x0002": 1,              // ESAState = Online (running)

  // --- Power Range ---
  "0x0003": 0,              // AbsMinPower = 0 mW (can completely stop consuming)
  "0x0004": 7200000,        // AbsMaxPower = 7200000 mW (max 7.2 kW)

  // --- Power Adjustment Capability ---
  "0x0005": {               // PowerAdjustmentCapability
    "powerAdjustCapability": [
      {
        "minPower": 1400000,       // Min adjustable power 1.4 kW
        "maxPower": 7200000,       // Max adjustable power 7.2 kW
        "minDuration": 60,         // Min adjustment duration 60 seconds
        "maxDuration": 28800       // Max adjustment duration 8 hours
      }
    ],
    "cause": 0                     // NoRateChange (no rate change trigger)
  },

  // --- Forecast ---
  "0x0006": {               // Forecast
    "forecastID": 1,
    "activeSlotNumber": 0,
    "startTime": 1700000000,
    "endTime": 1700028800,
    "slots": [
      {
        "minDuration": 3600,
        "maxDuration": 7200,
        "defaultDuration": 5400,
        "nominalPower": 7200000,
        "minPower": 1400000,
        "maxPower": 7200000
      }
    ]
  },

  // --- Opt-Out State ---
  "0x0007": 0               // OptOutState = NoOptOut (not opted out of any optimization)
}

Common Scenarios