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
132 devices in the survey implement this cluster
Presence Multi-Sensor FP310
Aqara
ABUS PREFIRA SMART (SX3050M)
ABUS
Halo Select
Kwikset
Floor Cleaning Robot
Ecovacs
TARUIE AC Remote
DUCTECH
6v4trk
Ecovacs
Grimsholm Smart Irrigation Valve
Grimsholm Products AB
Floor Cleaning Robot
Ecovacs
twunby
Ecovacs
Robotic Vacuum Cleaner
Roborock
Roborock Robotic Vacuum Cleaner
Roborock
Smart Blinds
Sunfree Motor