13.2.21. evse_manager

This interface defines the evse manager. An evse manager represents the charging kernel of one physical connector.

13.2.21.1. Variables

session_event:object (evse_manager-SessionEvent)
Emits all events related to sessions
There is an extended definition for this object here.
limits:object (evse_manager-Limits)
Limits of this evse, published on change
There is an extended definition for this object here.
ev_info:object (evse_manager-EVInfo)
More details about the EV if available
There is an extended definition for this object here.
car_manufacturer:string (evse_manager-CarManufacturer)
Car manufacturer (if known)
There is an extended definition for this object here.
telemetry:object (evse_board_support-Telemetry)
Other telemetry
There is an extended definition for this object here.
powermeter:object (powermeter-Powermeter)
Measured dataset
There is an extended definition for this object here.
powermeter_public_key_ocmf:string
Powermeter public key
evse_id:string
EVSE ID including the connector number, e.g. DE*PNX*E123456*1
Hardware capability/limits
There is an extended definition for this object here.
iso15118_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.
enforced_limits:object (energy-EnforcedLimits)
Enforced limits for this node (coming from the EnergyManager)
There is an extended definition for this object here.
waiting_for_external_ready:boolean
Signals that the EVSE Manager is in principle ready to start charging, but delays sending its ready signal waiting for the external_ready_to_start_charging command.
ready:boolean
Signals that the EVSE Manager is ready to start charging
selected_protocol:string
Contains the selected protocol used for charging for informative purposes

13.2.21.2. Commands

get_evse:object
Call to get information about the EVSE including its connectors
Result:object (evse_manager-Evse)
Object that contains information of the EVSE including its connectors
There is an extended definition for this object here.
enable_disable:boolean
Enables or disables the evse. Turns off PWM with error F. Charging is only possible if an EVSE is enabled.
connector_id:integer <required>
Specifies the ID of the connector to enable. If 0, the whole EVSE should be enabled
cmd_source:object <required> (evse_manager-EnableDisableSource)
Source of the enable command
There is an extended definition for this object here.
Result:boolean
Returns true if evse is enabled after the command, false if it is disabled. This may not be the same value as the request, since there may be a higher priority request from another source that is actually deciding whether it is enabled or disabled.
authorize_response:void
Reports the result of an authorization request to the EvseManager. Contains the provided_token for which authorization was requested and the validation_result
provided_token:object <required> (authorization-ProvidedIdToken)
The token for which authorization was requested
There is an extended definition for this object here.
validation_result:object <required> (authorization-ValidationResult)
The validation result
There is an extended definition for this object here.
withdraw_authorization:void
Call to signals that EVSE is not further authorized to start a transaction (e.g. on a connection_timeout)
reserve:boolean
Call to signal that EVSE is reserved. This can be used to e.g. change the color of the HMI LEDs to indicate reservation.
reservation_id:integer <required>
The reservation id (should be added to the TransactionStarted event)
Result:boolean
Returns true if the EVSE accepted the reservation, else false.
cancel_reservation:void
Call to signal that EVSE is not reserved anymore
set_faulted:void
Sets the evse manager to faulted externally. It may also switch to faulted itself if it detects an internal error.
pause_charging:boolean
Call to signal EVSE to pause charging
Result:boolean
Returns true if successfully paused or was already in paused_by_evse mode
resume_charging:boolean
Call to signal EVSE to resume charging
Result:boolean
Returns true if resume was successful, false otherwise (e.g. resuming a car pause won’t work)
stop_transaction:boolean
Stops transaction and cancels charging externally, charging can only be resumed by replugging car. EVSE will also stop transaction automatically e.g. on disconnect, so this only needs to be called if the transaction should end before.
request:object <required> (evse_manager-StopTransactionRequest)
Request to stop the transaction.
There is an extended definition for this object here.
Result:boolean
Returns true if successful
force_unlock:boolean
Forces connector to unlock connector now. During normal operation, connector will be locked/unlocked in the correct sequence. Do not use this function except if explicitly requested by e.g. management cloud.
connector_id:integer <required>
Specifies the ID of the connector that should be unlocked
Result:boolean
Returns true if unlocking sequence was successfully executed
set_get_certificate_response:void
CertificateInstallationRes/CertificateUpdateRes - Set the new/updated Contract Certificate (including the certificate chain) and the corresponding encrypted private key. Should be forwared to EVCC. This is an async response to a previously published iso15118_certificate_request
certificate_response:object <required> (iso15118_charger-ResponseExiStreamStatus)
The response raw exi stream and the status from the CSMS system
There is an extended definition for this object here.
external_ready_to_start_charging:boolean
There are situations where another module needs to do some initialization after evse manager is in principle ready to start charging. This command can be used (optimally in combination with a configuration option) to delay charging ready until the external module is done with its initialization
Result:boolean
Returns true if the signal was used by the evse manager implementation