电源 Cluster（PowerSource）

Cluster ID: 0x002F  | 所在 Endpoint: 通常在 Endpoint 1（功能端点）

PowerSource 描述设备的电源信息，包括电源状态、有线供电参数、电池电量与充电信息。 这个 Cluster 是只读的 —— 没有 Command，只有 Attribute。

属性总览

PowerSource 的属性按功能分为五组。点击属性 ID 可跳转到对应的详细说明。

状态信息（0x00 – 0x02）

每个 PowerSource 实例必须具备的基础属性，描述电源的当前状态和身份。

Status 枚举值

↑ 返回属性列表

有线供电（0x03 – 0x0A）

描述有线电源的电气参数和状态。这组属性仅在电源类型为有线时才有意义。

↑ 返回属性列表

电池基础（0x0B – 0x13）

电池供电设备最常用的属性组 —— App 展示电池电量和低电提醒都依赖这些属性。

BatChargeLevel 枚举值

BatReplaceability 枚举值

↑ 返回属性列表

电池规格（0x14 – 0x18）

描述电池的具体型号和技术规格，用于指导用户选择正确的替换电池。

BatCommonDesignation 枚举值

BatApprovedChemistry 枚举值

↑ 返回属性列表

充电信息（0x19 – 0x1F）

描述电池的充电状态和充电参数，以及电源与 Endpoint 的映射关系。

BatChargeState 枚举值

↑ 返回属性列表

示例数据

一个典型电池供电设备的 PowerSource Cluster 读取结果：

{
  // --- 状态信息 ---
  "0x0": 1,                  // Status = Active（正在供电）
  "0x1": 0,                  // Order = 0（最高优先级）
  "0x2": "Battery",          // Description = "Battery"

  // --- 电池基础 ---
  "0xB": 3200,               // BatVoltage = 3200 mV
  "0xC": 180,                // BatPercentRemaining = 180 → 实际 90%
  "0xD": 7776000,            // BatTimeRemaining = 7776000 秒（约 90 天）
  "0xE": 0,                  // BatChargeLevel = OK
  "0xF": false,              // BatReplacementNeeded = false
  "0x10": 2,                 // BatReplaceability = UserReplaceable
  "0x11": true,              // BatPresent = true（电池已安装）
  "0x13": "4x AA",           // BatReplacementDescription

  // --- 电池规格 ---
  "0x14": 15,                // BatCommonDesignation = 15（AA）
  "0x18": 2800,              // BatCapacity = 2800 mAh

  // --- 充电信息 ---
  "0x1A": 3                  // BatChargeState = IsNotCharging（干电池不充电）
}