PowerSourceConfiguration Cluster

Cluster ID: 0x002E  |  Endpoint: Endpoint 0 (Root Node)

PowerSourceConfiguration is an extremely simple Cluster — only one attribute, no commands. Its sole purpose is to tell you: which Endpoints hold this device's power information and their priority order.

Attribute Overview

PowerSourceConfiguration has only one attribute, which is mandatory.

Sources (Power Endpoint List)

An ordered list where each element is an Endpoint number pointing to an endpoint hosting a PowerSource Cluster. The list order represents priority: the first element is the primary power source, followed by backup sources in order.

An empty list means the device hasn't reported any power information. Endpoint numbers in the list align with the Descriptor Cluster's PartsList.

↑ Back to Attributes

Commands

PowerSourceConfiguration has no commands. It is a purely read-only configuration Cluster; all information is obtained by reading the Sources attribute.

Example Data

Reading the PowerSourceConfiguration Cluster on Endpoint 0:

{
  // --- Attributes ---
  "0x0": [1, 2]    // Sources = [Endpoint 1, Endpoint 2]
                    // Priority: Endpoint 1 is primary, Endpoint 2 is backup
}

Scenario 1: Single Power Source Device (Battery Door Lock)

A battery-powered smart door lock with only one power source. PowerSourceConfiguration's Sources list contains only one Endpoint; the App goes directly to that Endpoint to read PowerSource for battery level.

// Scenario 1: Simple device with only one power source (e.g. battery door lock)
// Endpoint 0 — PowerSourceConfiguration
{
  "0x0": [1]       // Sources = [Endpoint 1]
                   // Only one power source; see details in Endpoint 1's PowerSource Cluster
}

// Endpoint 1 — PowerSource (read battery level here)
{
  "0x0": 1,        // Status = Active
  "0x1": 0,        // Order = 0 (only power source)
  "0x2": "Battery",
  "0xC": 180       // BatPercentRemaining = 180 → actual 90%
}

Scenario 2: Dual Power Source Device (UPS Gateway)

A gateway device supporting both mains and built-in battery power. PowerSourceConfiguration lists two Endpoints; the first is mains (primary), the second is battery (backup). During power outage, the device automatically switches to battery, and the App can display the current power status accordingly.

// Scenario 2: Dual power source device (e.g. UPS-powered gateway)
// Endpoint 0 — PowerSourceConfiguration
{
  "0x0": [1, 2]    // Sources = [Endpoint 1, Endpoint 2]
                   // Endpoint 1 has higher priority (primary), Endpoint 2 is backup
}

// Endpoint 1 — PowerSource (primary: mains)
{
  "0x0": 1,        // Status = Active (currently powering)
  "0x1": 0,        // Order = 0 (highest priority)
  "0x2": "Mains"   // Description = "Mains"
}

// Endpoint 2 — PowerSource (backup: built-in battery)
{
  "0x0": 0,        // Status = Unspecified (on standby)
  "0x1": 1,        // Order = 1 (secondary priority)
  "0x2": "Battery",
  "0xC": 200       // BatPercentRemaining = 200 → actual 100%
}