The Energy EVSE cluster (0x0099) is a Matter cluster that Controls Electric Vehicle Supply Equipment (EVSE) for EV charging, including charging state, power limits, and session management.. It defines 8 commands and 23 attributes and is mandatory for 1 device type.
Energy EVSE 0x0099
Controls Electric Vehicle Supply Equipment (EVSE) for EV charging, including charging state, power limits, and session management.
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 23
Commands 8
Features 5
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 |
State
0x00..0x06 · nullable
|
StateEnum | |
| 0x0001 |
SupplyState
0x00..0x05
|
SupplyStateEnum | |
| 0x0002 |
FaultState
0x00..0xFF
|
FaultStateEnum | |
| 0x0003 |
ChargingEnabledUntil
default 0 · nullable
|
epoch_s | |
| 0x0004 |
DischargingEnabledUntil
default 0 · nullable
|
epoch_s | Optional |
| 0x0005 |
CircuitCapacity
min 0 · default 0
|
amperage_ma | |
| 0x0006 |
MinimumChargeCurrent
min 0 · default 6000
|
amperage_ma | |
| 0x0007 |
MaximumChargeCurrent
min 0 · default 0
|
amperage_ma | |
| 0x0008 |
MaximumDischargeCurrent
min 0 · default 0
|
amperage_ma | Optional |
| 0x0009 |
default 0
UserMaximumChargeCurrent
|
amperage_ma | Writable Optional write: manage |
| 0x000A |
default 600
RandomizationDelayWindow
|
elapsed_s | Writable Optional write: manage |
| 0x0023 |
NextChargeStartTime
nullable
|
epoch_s | Optional |
| 0x0024 |
NextChargeTargetTime
nullable
|
epoch_s | Optional |
| 0x0025 |
NextChargeRequiredEnergy
min 0 · nullable
|
energy_mwh | Optional |
| 0x0026 |
NextChargeTargetSoC
nullable
|
percent | Optional |
| 0x0027 |
0..0xFFFE · nullable
ApproximateEVEfficiency
|
int16u | Writable Optional write: manage |
| 0x0030 |
StateOfCharge
nullable
|
percent | Optional |
| 0x0031 |
BatteryCapacity
min 0 · nullable
|
energy_mwh | Optional |
| 0x0032 |
VehicleID
nullable
|
char_string | Optional |
| 0x0040 |
SessionID
nullable
|
int32u | |
| 0x0041 |
SessionDuration
nullable
|
elapsed_s | |
| 0x0042 |
SessionEnergyCharged
min 0 · nullable
|
energy_mwh | |
| 0x0043 |
SessionEnergyDischarged
min 0 · nullable
|
energy_mwh | Optional |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
GetTargetsResponse
Optional Provisional
The GetTargetsResponse is sent in response to the GetTargets Command.
|
server→client |
ChargingTargetSchedules: ChargingTargetScheduleStruct |
| 0x01 |
Disable
Provisional
Allows a client to disable the EVSE from charging and discharging.
|
client→server | None |
| 0x02 |
EnableCharging
This command allows a client to enable the EVSE to charge an EV, and to provide or update the maximum and minimum charge current.
|
client→server |
ChargingEnabledUntil: epoch_s, MinimumChargeCurrent: amperage_ma, MaximumChargeCurrent: amperage_ma |
| 0x03 |
EnableDischarging
Optional Provisional
Upon receipt, this SHALL allow a client to enable the discharge of an EV, and to provide or update the maximum discharge current.
|
client→server |
DischargingEnabledUntil: epoch_s, MaximumDischargeCurrent: amperage_ma |
| 0x04 |
StartDiagnostics
Optional Allows a client to put the EVSE into a self-diagnostics mode.
|
client→server | None |
| 0x05 |
SetTargets
Optional Provisional
Allows a client to set the user specified charging targets.
|
client→server |
ChargingTargetSchedules: ChargingTargetScheduleStruct |
| 0x06 |
GetTargets
Optional Provisional
Allows a client to retrieve the current set of charging targets.
|
client→server | None |
| 0x07 |
ClearTargets
Optional Provisional
Allows a client to clear all stored charging targets.
|
client→server | None |
ChargingPreferences
(PREF)
bit 0
EVSE supports storing user charging preferences
SoCReporting
(SOC)
bit 1
EVSE supports reporting of vehicle State of Charge (SoC)
PlugAndCharge
(PNC)
bit 2
EVSE supports PLC to support Plug and Charge
RFID
(RFID)
bit 3
EVSE is fitted with an RFID reader
V2X
(V2X)
bit 4
EVSE supports bi-directional charging / discharging
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
0 devices in the survey implement this cluster
No devices in the survey implement this cluster yet.