设备能源管理 Cluster（DeviceEnergyManagement）

Cluster ID: 0x0098  |  所在 Endpoint: 具有能源管理能力的设备端点

DeviceEnergyManagement（DEM）是 Matter 1.4 引入的能源管理核心 Cluster， 用于让能源管理系统（EMS）与各种能源消耗或产生设备协商功率调整、预测用电计划和优化能源使用。 它适用于电动车充电桩（EVSE）、热泵、储能电池、太阳能系统、洗碗机、洗衣机等各类 ESA（Energy Smart Appliance）设备。

命令（Commands）

DeviceEnergyManagement Cluster 共有 8 个命令，分别对应不同的 Feature 能力。 EMS（能源管理系统）通过这些命令调整设备的功率、启动时间、运行状态和用电预测。 点击下方表格中的命令 ID 可跳转到对应的详细说明。

PowerAdjustRequest -- 功率调整请求（0x00）

请求设备在指定时间段内调整到目标功率。EMS 用这个命令在电价高峰时段降低设备功率、 或在电价低谷时段提高功率来优化用电成本。执行成功后，ESAState 变为 PowerAdjustActive (3)。

↑ 返回命令列表

CancelPowerAdjustRequest -- 取消功率调整（0x01）

取消正在进行的功率调整，设备立即恢复到正常运行状态。无参数。 执行成功后，ESAState 从 PowerAdjustActive 恢复为 Online。

↑ 返回命令列表

StartTimeAdjustRequest -- 启动时间调整（0x02）

请求设备将预测（Forecast）中的启动时间调整到指定时刻。 用于在不改变总用电量的前提下，将设备的运行时段从高峰移到低谷。

↑ 返回命令列表

PauseRequest -- 暂停运行（0x03）

请求设备暂停当前运行。仅适用于支持暂停的设备（PAU Feature）。 执行成功后，ESAState 变为 Paused (4)。

↑ 返回命令列表

ResumeRequest -- 恢复运行（0x04）

请求设备恢复已暂停的运行。无参数。 执行成功后，ESAState 从 Paused 恢复为 Online。

↑ 返回命令列表

ModifyForecastRequest -- 修改预测（0x05）

修改设备当前 Forecast 中一个或多个 Slot 的功率和时间参数。 EMS 通过此命令直接调整设备的用电计划，比如降低某个时段的预期功率。

↑ 返回命令列表

RequestConstraintBasedForecast -- 基于约束请求预测（0x06）

向设备提供一组功率/能量约束条件，请求设备据此重新生成 Forecast。 与 ModifyForecastRequest 直接修改参数不同，这个命令告诉设备"你自己想办法满足这些约束"。

↑ 返回命令列表

CancelRequest -- 取消请求（0x07）

取消所有当前进行中的优化请求（StartTimeAdjust、Pause、ModifyForecast、ConstraintBasedForecast）， 设备恢复到原始的自主运行计划。无参数。 需要设备支持 STA、PAU、FA 或 CON 中的至少一个 Feature。

↑ 返回命令列表

属性详解

DeviceEnergyManagement Cluster 的属性按功能分为三组。点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

ESA 基本信息（0x0000-0x0002）

描述设备的类型、能源产生能力和当前状态。这三个属性是所有 DEM 设备的基础属性。

ESATypeEnum 枚举值

ESAStateEnum 枚举值

↑ 返回属性列表

功率与调整（0x0003-0x0005）

定义设备的功率范围和可调整能力。EMS 在发送 PowerAdjustRequest 之前需要先读取这些属性确认调整范围。

↑ 返回属性列表

预测与优化（0x0006-0x0007）

设备的用电预测计划和用户退出优化的状态。Forecast 是 DEM 最核心的数据结构。

OptOutStateEnum 枚举值

↑ 返回属性列表

Feature 位图

DeviceEnergyManagement Cluster 通过 FeatureMap（0xFFFC）声明设备支持的能源管理能力。不同 Feature 组合决定了可用的命令和属性：

示例数据

一个 EVSE（电动车充电桩）在线运行时的 DeviceEnergyManagement Cluster 读取结果：

{
  // --- ESA 基本信息 ---
  "0x0000": 0,              // ESAType = EVSE（电动车充电桩）
  "0x0001": false,          // ESACanGenerate = false（只消耗不产生能源）
  "0x0002": 1,              // ESAState = Online（在线运行中）

  // --- 功率范围 ---
  "0x0003": 0,              // AbsMinPower = 0 mW（可完全停止消耗）
  "0x0004": 7200000,        // AbsMaxPower = 7200000 mW（最大 7.2 kW）

  // --- 功率调整能力 ---
  "0x0005": {               // PowerAdjustmentCapability
    "powerAdjustCapability": [
      {
        "minPower": 1400000,       // 最低可调功率 1.4 kW
        "maxPower": 7200000,       // 最高可调功率 7.2 kW
        "minDuration": 60,         // 最短调整持续 60 秒
        "maxDuration": 28800       // 最长调整持续 8 小时
      }
    ],
    "cause": 0                     // NoRateChange（无费率变化触发）
  },

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

  // --- 退出状态 ---
  "0x0007": 0               // OptOutState = NoOptOut（未退出任何优化）
}

常见场景