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
155 devices in the survey implement this cluster
eufy Smart Lock E31
Anker Innovations Technology
Magic Cube A001
Chengdu Energy Magic Cube
eufy Robotic Vacuum
Anker Innovations Technology
Heiman smart CO sensor
HEIMAN
Robotic Vacuum Cleaner
Roborock
Smart Blinds
Sunfree Motor
Roborock Robotic Vacuum Cleaner
Roborock
Aqara Smart Lock J200 Set
Aqara
Eve MotionBlinds
Eve Systems
AIO Presence Sensor LWR02
GL Technologies
arre Contact Sensor
arre Home LLC
SwitchBot Lock Vision
SwitchBot
Zemismart Smart Curtain
Zemismart Technology Limited
Screen
HelloDaylight
Presence Multi-Sensor FP310
Aqara
Robotic Vacuum Cleaner
Roborock
TARUIE AC Remote
DUCTECH
Robotic Vacuum Cleaner
Roborock
Floor Cleaning Robot
ECOVACS
SmartWings Window Covering
SmartWings
Robotic Vacuum Cleaner
Roborock
Aqara Smart Lock U600
Aqara
THP23-ZB-X
Matter
eufy FamiLock S3
Anker Innovations Technology