13.2.1. ISO15118_charger

This interface defines a ISO15118 charger.

13.2.1.1. Variables

require_auth_eim:null
An EIM authorization is requiered
require_auth_pnc:object (authorization-ProvidedIdToken)
The EVCC provides the payment details for a PnC authorization by sending the signature certificate chain and eMAID.
There is an extended definition for this object here.
ac_close_contactor:null
The contactor should be closed
ac_open_contactor:null
The contactor should be opened
start_cable_check:null
The charger should now start a cable check
start_pre_charge:null
The charger should now start the pre charge phase
dc_open_contactor:null
The contactor should be opened
v2g_setup_finished:null
v2g_setup_finished from ISO15118-3. Trigger when EV sends a PowerDeliveryReq message with ChargeProgess equals Start or Stop
current_demand_started:null
The charging process has started and the EV wants to be charged
current_demand_finished:null
The charging process was finished
sae_bidi_mode_active:null
The SAE J2847 bidi mode is active
evcc_id:string
Specifies the EVs identification in a readable format. It contains the MAC address of the EVCC in uppercase
pattern:^[A-F0-9]{2}(:[A-F0-9]{2}){5}$
selected_payment_option:string (iso15118-PaymentOption)
This element is used for indicating the payment type
There is an extended definition for this object here.
requested_energy_transfer_mode:string (iso15118-EnergyTransferMode)
Selected energy transfer mode for charging that is requested by the EVCC.
There is an extended definition for this object here.
departure_time:string
Optional: [RFC3339 UTC] This element is used to indicate when the vehicle intends to finish the charging process
format:date-time
ac_eamount:number
[Wh] Amount of energy reflecting the EV’s estimate how much energy is needed to fulfill the user configured charging goal for the current charging session
ac_ev_max_voltage:number
[V] The RMS of the maximal nominal voltage the vehicle can accept, measured between one phase and neutral
ac_ev_max_current:number
[A] Maximum current supported by the EV per phase
ac_ev_min_current:number
[A] EVMinCurrent is used to indicate to the SECC that charging below this minimum is not energy/cost efficient for the EV
dc_ev_energy_capacity:number
Optional: [Wh] Energy capacity of the EV
dc_ev_energy_request:number
Optional: [Wh] Amount of energy the EV requests from the EVSE
dc_full_soc:number
Optional: [%] SOC at which the EV considers the battery to be fully charged
dc_bulk_soc:number
Optional: [%] SOC at which the EV considers a fast charge process to end
dc_ev_status:object (iso15118-DcEvStatus)
Current status of the EV
There is an extended definition for this object here.
dc_bulk_charging_complete:boolean
Optional: If set to TRUE, the EV indicates that bulk charge (approx. 80% SOC) is complete
dc_charging_complete:boolean
Optional: If set to TRUE, the EV indicates that full charge (100% SOC) is complete
dc_ev_target_voltage_current:object (iso15118-DcEvTargetValues)
Target voltage and current requested by the EV
There is an extended definition for this object here.
dc_ev_maximum_limits:object (iso15118-DcEvMaximumLimits)
Maximum Values (current, power and voltage) supported and allowed by the EV
There is an extended definition for this object here.
dc_ev_remaining_time:object (iso15118-DcEvRemainingTime)
Estimated or calculated time until bulk and full charge is complete
There is an extended definition for this object here.
dlink_terminate:null
Terminate the data link and become UNMATCHED.
dlink_error:null
Terminate the data link and restart the matching process.
dlink_pause:null
Request power saving mode, while staying MATCHED.
ev_app_protocol:object (iso15118-AppProtocols)
Debug_Lite - This request message provides a list of charging protocols supported by the EVCC
There is an extended definition for this object here.
v2g_messages:object (iso15118-V2gMessages)
Debug - This element contains all V2G elements and should be used for debug purposes only
There is an extended definition for this object here.
selected_protocol:string
Debug - Contains the selected protocol
display_parameters:object (iso15118-DisplayParameters)
Parameters that may be displayed on the EVSE (Soc, battery capacity)
There is an extended definition for this object here.
d20_dc_dynamic_charge_mode:object (iso15118-DcChargeDynamicModeValues)
The parameters the EVCC offers and sets for dynamic control mode
There is an extended definition for this object here.
dc_ev_present_voltage:number
Present Voltage measured from the EV
meter_info_requested:null
The EV requested meter infos from the EVSE

13.2.1.2. Commands

setup:void
At startup all necessary info should be sent to the module once.
evse_id:object <required> (iso15118-EVSEID)
Set an ID that uniquely identifies the EVSE and the power outlet the vehicle is connected to
There is an extended definition for this object here.
sae_j2847_mode:string <required> (iso15118-SaeJ2847BidiMode)
Charger is supporting SAE J2847 V2G/V2H version
There is an extended definition for this object here.
debug_mode:boolean <required>
Enable/Disable debug mode
set_charging_parameters:void
At startup, set the the charging parameters at least once. May be updated later on. If a charging session is currently active, some updated values may only be used for the next charging session.
physical_values:object <required> (iso15118-SetupPhysicalValues)
Set up initial physical values for a AC or DC charging session
There is an extended definition for this object here.
session_setup:void
At each session start this info should be sent to the module.
payment_options:array <required>
Providing a list of payment options to the EVCC
array_item:string (iso15118-PaymentOption)
These are the payment options a SECC offers to the EVCC
There is an extended definition for this object here.

supported_certificate_service:boolean <required>
The charger supports the certificate installation/update service and has a connection to an SA for this purpose
central_contract_validation_allowed:boolean <required>
Indicates if the vehicle contract may be forwarded to and validated by a CSMS in case local validation was not successful
authorization_response:void
This message is an async response to a previously published require_auth_eim or require_auth_pnc. The SECC informs the EVCC whether the authorization is accecpted or not.
authorization_status:string <required> (authorization-AuthorizationStatus)
Authorization status of the ID Token
There is an extended definition for this object here.
certificate_status:string <required> (authorization-CertificateStatus)
Certificate status information
There is an extended definition for this object here.
ac_contactor_closed:void
This message is an async response to a previously published ac_close_contactor or ac_open_contactor.
status:boolean <required>
Set to true when contactor is closed, false when contactor is open
dlink_ready:void
Signals dlink_ready from SLAC layer according to ISO15118-3
value:boolean <required>
Set to true when link becomes ready, false when the link is terminated
cable_check_finished:void
Cable check is finished, voltage is under 20V and insulation resistor on the cable is alright
status:boolean <required>
Set to true when cable check is okay
receipt_is_required:void
This element is used by the SECC to indicate that the EVCC is required to send a MeteringReceiptReq message for the purpose of signing the meter info record.
receipt_required:boolean <required>
Set to true when receipt is required, set to false when not
stop_charging:void
Stops the charging process
stop:boolean <required>
Set to true when to stop, set to false when to continue
pause_charging:void
Pause the charging process (only in ISO15118-20)
pause:boolean <required>
Set to true when to pause, set to false when to continue
no_energy_pause_charging:void
Right now there is no power available for the charging process. According to IEC61851-23:2023 CC3.5.3 the charger can pause the session before or after the cable check and pre charge stage.
mode:string <required> (iso15118-NoEnergyPauseMode)
Set to different no energy pause modes. For PauseAfterPrecharge the charger should pause but has power for cable check and pre charge. For PauseBeforeCableCheck the charger should pause before cable check. For AllowEvToIgnorePause charger should ignore, that the ev will go to CurrentDemand instead of pausing the session, this is against IEC61851-23:2023.
There is an extended definition for this object here.
update_energy_transfer_modes:void
Update the supported energy transfer modes. Call at least once during start up. Typically for ISO15118-2 and basic charging we expect unidirectional charging modes. For ISO15118-20 the user can set what type of modes the hardware supports, may that be bidirectional, unidirectional, wireless, etc charging.
supported_energy_transfer_modes:array <required>
Available energy transfer modes supported by the EVSE
array_item:object (iso15118-EnergyTransferMode)
The different energy modes supported by the SECC
There is an extended definition for this object here.

update_ac_max_current:void
Update the maximum allowed line current restriction per phase. Call at least once during start up.
max_current:number <required>
Max current in A
update_dc_maximum_limits:void
Update the maximum limits. Call at least once during start up.
maximum_limits:object <required> (iso15118-DcEvseMaximumLimits)
Maximum values (current, power and voltage) the EVSE can deliver
There is an extended definition for this object here.
update_dc_minimum_limits:void
Update the minimum limits. Call at least once during start up.
minimum_limits:object <required> (iso15118-DcEvseMinimumLimits)
Minimum values (current and voltage) the EVSE can deliver
There is an extended definition for this object here.
update_isolation_status:void
Update the isolation condition
isolation_status:string <required> (iso15118-IsolationStatus)
Result of the isolation monitoring
There is an extended definition for this object here.
update_dc_present_values:void
Update the present values from the DC powersupply
present_voltage_current:object <required> (iso15118-DcEvsePresentVoltageCurrent)
Present voltage and current
There is an extended definition for this object here.
update_meter_info:void
Update meter info
powermeter:object <required> (powermeter-Powermeter)
Includes the meterInfo record containing the latest meter reading and other meter relevant data
There is an extended definition for this object here.
send_error:void
An error has happend. Send this error to inform the EV.
error:string <required> (iso15118-EvseError)
The EVSE error enum
There is an extended definition for this object here.
reset_error:void
Reset all errors