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_CableCheck:null

The charger should now start a cable check

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

currentDemand_Started:null

The charging process has started and the EV wants to be charged

currentDemand_Finished:null

The charging process was finished

sae_bidi_mode_active:null

The SAE J2847 bidi mode is active

EVCCIDD: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}$

SelectedPaymentOption:string (iso15118_charger-PaymentOption)

This element is used for indicating the payment type

There is an extended definition for this object here.

RequestedEnergyTransferMode: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.

DepartureTime: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_EVMaxVoltage:number

[V] The RMS of the maximal nominal voltage the vehicle can accept, measured between one phase and neutral

AC_EVMaxCurrent:number

[A] Maximum current supported by the EV per phase

AC_EVMinCurrent:number

[A] EVMinCurrent is used to indicate to the SECC that charging below this minimum is not energy/cost efficient for the EV

DC_EVEnergyCapacity:number

Optional: [Wh] Energy capacity of the EV

DC_EVEnergyRequest:number

Optional: [Wh] Amount of energy the EV requests from the EVSE

DC_FullSOC:number

Optional: [%] SOC at which the EV considers the battery to be fully charged

DC_BulkSOC:number

Optional: [%] SOC at which the EV considers a fast charge process to end

DC_EVStatus:object (iso15118_charger-DC_EVStatusType)

Current status of the EV

There is an extended definition for this object here.

DC_BulkChargingComplete:boolean

Optional: If set to TRUE, the EV indicates that bulk charge (approx. 80% SOC) is complete

DC_ChargingComplete:boolean

Optional: If set to TRUE, the EV indicates that full charge (100% SOC) is complete

DC_EVTargetVoltageCurrent:object (iso15118_charger-DC_EVTargetValues)

Target voltage and current requested by the EV

There is an extended definition for this object here.

DC_EVMaximumLimits:object (iso15118_charger-DC_EVMaximumLimits)

Maximum Values (current, power and voltage) supported and allowed by the EV

There is an extended definition for this object here.

DC_EVRemainingTime:object (iso15118_charger-DC_EVRemainingTime)

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-Request_Exi_Stream_Schema)

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_AppProtocol:array

Debug_Lite - This request message provides a list of charging protocols supported by the EVCC

array_item:object

This message element is used by the EVCC for transmitting the list of supported protocols

properties:

ProtocolNamespace:string <required>

This message element is used by the EVCC to uniquely identify the Namespace URI of a specific protocol supported by the EVCC

VersionNumberMajor:integer <required>

This message element is used by the EVCC to indicate the major version number of the protocol

VersionNumberMinor:integer <required>

This message element is used by the EVCC to indicate the minor version number of the protocol

SchemaID:integer <required>

This message element is used by the EVCC to indicate the SchemaID assigned by the EVCC to the protocol

Priority:integer <required>

This message element is used by the EVCC for indicating the protocol priority of a specific protocol allowing the SECC to select a protocol based on priorities

V2G_Messages:object (iso15118_charger-V2G_Messages)

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

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:string (iso15118_charger-EnergyTransferMode)

The different energy modes supported by the SECC

There is an extended definition for this object here.

sae_j2847_mode:string <required> (iso15118_charger-SAE_J2847_Bidi_Mode)

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-Response_Exi_Stream_Status)

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-DC_EVSEMaximumLimits)

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-DC_EVSEMinimumLimits)

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-DC_EVSEPresentVoltage_Current)

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