ElectricVehicleLoadEvent
A measurement of the electricity consumed or generated by an electric vehicle while connected to a charger.
Declaration
struct ElectricVehicleLoadEventMentioned in
Overview
Submit load events to track session-based energy consumption and enable the framework to provide insights about electricity usage and adherence to ElectricityGuidance. Load events focus on energy flow during active charging sessions. Load events include an indication of continuity, specifying the event’s beginning, active state, and end.
Include ElectricVehicleStatusEvent in your load events to explain why charging behavior occurs and provide rich activity logs in the Home app. When you adopt the EnergyKit LoadEvents Entitlement, the Home app displays your device’s energy usage with the device name and performance metrics you provide.
Submit electrical vehicle load events
Sample load events more frequently as charging conditions become more volatile. During stable charging — when power remains constant, with no user interventions — one sample every 15 minutes (at 0, 15, 30, and 45-minute marks) is sufficient. During volatile periods — when charging power fluctuates, a person pauses or resumes charging, or the vehicle adjusts its charge rate — submit additional events to capture the transitions.
Significant changes may include:
A person initiated an action
A pause in power consumption such as going idle
The power changed
Unplugged or idle vehicles between charging sessions don’t generate events. The device that requested ElectricityGuidance must submit the corresponding load events.
Separate charging and discharging sessions
If your vehicle supports vehicle-to-grid (V2G) or vehicle-to-home (V2H) capabilities, use separate sessions for charging and discharging. Separate charging and discharging into individual sessions, even if they occur simultaneously, to allow the system to distinguish between them in the data.