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
Smart Button
HAOJAI
On-wall button controllers - 4 buttons MATTER
ELKO EP s.r.o
Eve MotionBlinds
Eve Systems
Bold Elite
Bold Security Technology BV
Roborock Robotic Vacuum Cleaner
Roborock
Floor Cleaning Robot
ECOVACS
SN8102 WiFi Module
Hangzhou Sciener Smart Technology Co., Ltd.
eufy Smart Lock C34
Anker Innovations Technology
THP23-ZB-X
Tuya
Roborock Robotic Vacuum Cleaner
Roborock
TNKMSE251
tink GmbH
Halo Select
ASSA ABLOY Americas Residential
Floor Cleaning Robot
ECOVACS
Sense by MACO | Window T&T
Mayer & Co Beschläge GmbH
SmartWings Window Covering
SmartWings
eufy Robotic Vacuum
Anker Innovations Technology
Grimsholm Smart Irrigation Valve
Grimsholm Products AB
Floor Cleaning Robot
ECOVACS
twunby
ECOVACS
Robotic Vacuum Cleaner
Roborock
Robotic Vacuum Cleaner
Roborock
Screen
HelloDaylight
Roborock Robotic Vacuum Cleaner
Roborock
Smart Blinds
Sunfree Motor