The Power Source cluster (0x002F) is a Matter cluster that Reports power source status including battery level, charging state, and power characteristics.. It defines 32 attributes and is mandatory for 2 device types.
Power Source 0x002F
Reports power source status including battery level, charging state, and power characteristics.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 32
Features 4
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
Status
max 0x03
|
PowerSourceStatusEnum | |
| 0x0001 | Order | int8u | |
| 0x0002 | Description | char_string | |
| 0x0003 |
WiredAssessedInputVoltage
nullable
|
int32u | Optional |
| 0x0004 |
WiredAssessedInputFrequency
nullable
|
int16u | Optional |
| 0x0005 |
WiredCurrentType
max 0x01
|
WiredCurrentTypeEnum | Optional |
| 0x0006 |
WiredAssessedCurrent
nullable
|
int32u | Optional |
| 0x0007 | WiredNominalVoltage | int32u | Optional |
| 0x0008 | WiredMaximumCurrent | int32u | Optional |
| 0x0009 | WiredPresent | boolean | Optional |
| 0x000A | ActiveWiredFaults | array | Optional |
| 0x000B |
BatVoltage
nullable
|
int32u | Optional |
| 0x000C |
BatPercentRemaining
max 0xC8 · nullable
|
int8u | Optional |
| 0x000D |
BatTimeRemaining
nullable
|
int32u | Optional |
| 0x000E |
BatChargeLevel
max 0x02
|
BatChargeLevelEnum | Optional |
| 0x000F | BatReplacementNeeded | boolean | Optional |
| 0x0010 |
BatReplaceability
max 0x03
|
BatReplaceabilityEnum | Optional |
| 0x0011 | BatPresent | boolean | Optional |
| 0x0012 | ActiveBatFaults | array | Optional |
| 0x0013 | BatReplacementDescription | char_string | Optional |
| 0x0014 |
BatCommonDesignation
max 0x0050
|
BatCommonDesignationEnum | Optional |
| 0x0015 | BatANSIDesignation | char_string | Optional |
| 0x0016 | BatIECDesignation | char_string | Optional |
| 0x0017 |
BatApprovedChemistry
max 0x0020
|
BatApprovedChemistryEnum | Optional |
| 0x0018 | BatCapacity | int32u | Optional |
| 0x0019 | BatQuantity | int8u | Optional |
| 0x001A |
BatChargeState
max 0x03
|
BatChargeStateEnum | Optional |
| 0x001B |
BatTimeToFullCharge
nullable
|
int32u | Optional |
| 0x001C | BatFunctionalWhileCharging | boolean | Optional |
| 0x001D |
BatChargingCurrent
nullable
|
int32u | Optional |
| 0x001E | ActiveBatChargeFaults | array | Optional |
| 0x001F | EndpointList | array |
Wired
(WIRED)
bit 0
A wired power source
Battery
(BAT)
bit 1
A battery power source
Rechargeable
(RECHG)
bit 2
A rechargeable battery power source
Replaceable
(REPLC)
bit 3
A replaceable battery power source
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
120 devices in the survey implement this cluster
Multi-State Sensor P100
Aqara
SmartWave Window Covering
SmartWave
Roborock Robotic Vacuum Cleaner
Roborock
Door/Window Contact II [+M]
BOSCH
Push-button battery-powered
Albrecht Jung GmbH & Co. KG
Nuki Smart Lock
Nuki
Zemismart Smart Curtain
Zemismart Technology Limited
Spotless Cleaning Robot
BOSCH
Tedee GO2
Tedee
Eve MotionBlinds
Eve Systems
Robotic Vacuum Cleaner
Roborock
Yale Linus Smart Lock L2 Lite
ASSA Abloy AB
SwitchBot Lock Vision
SwitchBot
Heiman smart CO sensor
HEIMAN
Yale Linus L2
ASSA Abloy AB
Smart Switch MT1
ThirdReality
eufy FamiLock S3
Anker Innovations Technology
Robotic Vacuum Cleaner
Roborock
GW60-Matter
MIUC
arre Contact Sensor
arre Home LLC
Aqara Smart Lock J200 Set
Aqara
eufy Smart Lock E31
Anker Innovations Technology
Aura Reach
ASSA ABLOY Americas Residential
Smart Light
Tuya