低功耗 Cluster（LowPower）

Cluster ID: 0x0508  |  所在 Endpoint: 媒体端点（电视、机顶盒、流媒体棒等）

LowPower 是 Matter 中最简单的 Cluster 之一 —— 没有任何属性、没有事件、没有 Feature，只有唯一一个命令：Sleep。 它的职责非常单一：让媒体设备进入低功耗待机（Standby / Sleep）模式。

这个 Cluster 通常和 WakeOnLan Cluster（0x0503） 配合使用： LowPower 负责「让设备睡下去」，WakeOnLan 提供「把设备叫醒」所需的网络地址。 两者是媒体设备电源管理的一对搭档。

命令（Commands）

LowPower Cluster 只有 1 个命令，没有参数，也没有专用的返回数据。 这是 Matter 规范中最精简的命令定义之一。

Sleep —— 进入待机（0x00）

让媒体设备进入低功耗待机（Sleep / Standby）模式。 命令没有任何参数，执行成功后设备返回通用的 Status = SUCCESS 响应。

设备收到 Sleep 命令后的具体行为由厂商实现决定，但通常包括：

• 关闭屏幕和音频输出
• 暂停或停止正在播放的媒体内容
• 主处理器进入低功耗状态
• 网卡保持活跃，继续监听 WoL Magic Packet（如果支持 WakeOnLan）

调用示例：

// Sleep 命令请求（Command ID: 0x00）
{
  "invokeRequests": [{
    "commandPath": {
      "endpointId": 1,
      "clusterId": "0x0508",
      "commandId": "0x00"       // Sleep
    }
    // 无参数字段 —— Sleep 是零参数命令
  }]
}

// 响应：Status = SUCCESS（无返回数据）

↑ 返回命令列表

属性说明

LowPower Cluster 没有定义任何应用层属性。 这意味着你无法通过读取属性来判断设备当前是否处于待机状态 —— 设备一旦进入待机，通信都可能断开了，属性也就无从读取。

如果需要判断设备的在线/待机状态，通常有以下方式：

• 监测设备的 Matter 会话（Session）是否仍然活跃
• 通过 mDNS 广播观察设备是否仍可发现
• 尝试读取其他 Cluster 属性（如 BasicInformation），超时即认为设备已待机

关联 Cluster

LowPower 不是孤立存在的，它在媒体设备的电源管理中与另外两个 Cluster 紧密配合：

媒体设备的典型电源 Cluster 组合

一台智能电视通常同时实现以下三个 Cluster，分别覆盖电源管理的不同层面：

示例数据

读取一台电视的 LowPower Cluster 属性（几乎没有业务数据）：

{
  // LowPower Cluster（0x0508）没有应用层属性
  // 它是一个纯命令型 Cluster，只提供 Sleep 命令
  // 读取该 Cluster 只会返回全局属性（ClusterRevision、FeatureMap 等）

  "0xFFFD": 1,              // ClusterRevision = 1
  "0xFFFC": 0               // FeatureMap = 0（无 Feature）
}

常见场景