PowerSource Cluster

Cluster ID: 0x002F  |  Endpoint: Typically on Endpoint 1 (functional endpoint)

PowerSource describes the device's power information, including power status, wired power parameters, battery level, and charging information. This Cluster is read-only — no Commands, only Attributes.

Attribute Overview

PowerSource attributes are organized into five groups. Click an attribute ID to jump to its detailed description.

Status Information (0x00 – 0x02)

Required base attributes for every PowerSource instance, describing the power source's current state and identity.

Status Enum Values

↑ Back to Attributes

Wired Power (0x03 – 0x0A)

Describes wired power source electrical parameters and status. These attributes are only meaningful when the power source type is wired.

↑ Back to Attributes

Battery Basics (0x0B – 0x13)

The most commonly used attribute group for battery-powered devices — Apps rely on these for displaying battery level and low-battery alerts.

BatChargeLevel Enum Values

BatReplaceability Enum Values

↑ Back to Attributes

Battery Specifications (0x14 – 0x18)

Describes specific battery model and technical specifications to guide users in selecting the correct replacement battery.

BatCommonDesignation Enum Values

BatApprovedChemistry Enum Values

↑ Back to Attributes

Charging Information (0x19 – 0x1F)

Describes battery charging status, charging parameters, and the mapping between power sources and Endpoints.

BatChargeState Enum Values

↑ Back to Attributes

Example Data

A typical battery-powered device's PowerSource Cluster read result:

{
  // --- Status Information ---
  "0x0": 1,                  // Status = Active (currently powering)
  "0x1": 0,                  // Order = 0 (highest priority)
  "0x2": "Battery",          // Description = "Battery"

  // --- Battery Basics ---
  "0xB": 3200,               // BatVoltage = 3200 mV
  "0xC": 180,                // BatPercentRemaining = 180 → actual 90%
  "0xD": 7776000,            // BatTimeRemaining = 7776000 seconds (approx. 90 days)
  "0xE": 0,                  // BatChargeLevel = OK
  "0xF": false,              // BatReplacementNeeded = false
  "0x10": 2,                 // BatReplaceability = UserReplaceable
  "0x11": true,              // BatPresent = true (battery installed)
  "0x13": "4x AA",           // BatReplacementDescription

  // --- Battery Specifications ---
  "0x14": 15,                // BatCommonDesignation = 15（AA）
  "0x18": 2800,              // BatCapacity = 2800 mAh

  // --- Charging Information ---
  "0x1A": 3                  // BatChargeState = IsNotCharging (non-rechargeable battery)
}