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_charger-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_charger-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_charger-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_charger-DcEvTargetValues)

Target voltage and current requested by the EV

There is an extended definition for this object here.

dc_ev_maximum_limits:object (iso15118_charger-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_charger-DcEvRemainingTime)

Estimated or calculated time until bulk and full charge is complete

There is an extended definition for this object here.

certificate_request:object (iso15118_charger-RequestExiStreamSchema)

The vehicle requests the SECC to deliver the certificate that belong to the currently valid contract of the vehicle. Response will be reported async via set_Get_Certificate_Response

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_charger-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_charger-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_charger-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_charger-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_charger-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.

supported_energy_transfer_modes:array <required>

Available energy transfer modes supported by the EVSE

array_item:object (iso15118_charger-SupportedEnergyMode)

The different energy modes supported by the SECC

There is an extended definition for this object here.

sae_j2847_mode:string <required> (iso15118_charger-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_charger-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_charger-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

certificate_response:void

This message is an async response to a previously published certificate_request. The new/updated Contract Certificate (including the certificate chain) and the corresponding encrypted private key are sent via the SECC to the EVCC.

exi_stream_status:object <required> (iso15118_charger-ResponseExiStreamStatus)

The response raw EXI stream and the status from the CSMS

There is an extended definition for this object here.

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

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_charger-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_charger-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_charger-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_charger-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_charger-EvseError)

The EVSE error enum

There is an extended definition for this object here.

reset_error:void

Reset all errors