13.2.1. ISO15118_charger

This interface defines a ISO15118 charger.

13.2.1.1. Variables

require_auth_eim:null

An EIM authorization is required

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 accepted 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 happened. 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