Charging Station Parameters

Description.

Request for the Charging Station Parameters

CsParametersRequest

Topic: josev/cs. Used by josev to request the charging station parameters.

type

object

properties

  • id

type

string

format

uuid

  • name

const

cs_parameters

  • type

const

request

  • data

type

object

default

Example:

{
    "id": "bd674cba-8377-4930-ba15-6a8d6e5134f2",
    "name": "cs_parameters",
    "type": "request",
    "data": {}
}

Josev shall ask once for the cs_status_and_limits every time it boots or the process restarts.


CsParametersResponse

Topic: cs/josev. Used by CS to provide charging station parameters to Josev.

type

object

properties

  • id

type

string

format

uuid

  • name

const

cs_parameters

  • type

const

response

  • data

type

object

properties

  • sw_version

type

string

examples

v1.0.1

  • hw_version

The hw_version schema

type

string

examples

v2.0.0

  • number_of_evses

type

integer

  • parameters

type

array

items

anyOf

type

object

properties

  • evse_id

type

string

examples

DE*SEV*E123456789

  • supports_eim

type

boolean

  • network_interface

type

string

  • connectors

type

array

items

anyOf

type

object

properties

  • id

type

integer

  • services

type

object

properties

  • ac

type

object

properties

  • connector_type

#/definitions/connector_type

  • control_mode

type

string

enum

scheduled, dynamic

  • nominal_voltage

type

integer

  • dc

type

object

properties

  • connector_type

#/definitions/connector_type

  • control_mode

type

string

enum

scheduled, dynamic

  • dc_bpt

type

object

properties

  • connector_type

#/definitions/connector_type

  • control_mode

type

string

enum

scheduled, dynamic

  • bpt_channel

type

string

enum

unified, separated

  • generator_mode

type

string

enum

grid_following, grid_forming

  • grid_island_detection_mode

type

string

enum

active, passive

  • ac_bpt

type

object

properties

  • connector_type

#/definitions/connector_type

  • nominal_voltage

type

integer

  • control_mode

type

string

enum

scheduled, dynamic

  • bpt_channel

type

string

enum

unified, separated

  • generator_mode

type

string

enum

grid_following, grid_forming

  • grid_island_detection_mode

type

string

enum

active, passive

definitions

  • connector_type

type

string

enum

AC_single_phase_core, AC_three_phase_core, DC_core, DC_extended, DC_combo_core, DC_unique

Example:

{
    "id": "bd674cba-8377-4930-ba15-6a8d6e5134f2",
    "name": "cs_parameters",
    "type": "response",
    "data": {
        "sw_version": "v1.0.1",
        "hw_version": "v2.0.0",
        "number_of_evses": 2,
        "parameters": [{
                "evse_id": "DE*SEV*E123456789",
                "connectors": [{
                        "id": 1,
                        "services": {
                            "ac": {
                                "connector_type": "AC_three_phase_core",
                                "nominal_voltage": 230,
                                "control_mode": "scheduled"
                            },
                            "ac_bpt": {
                                "connector_type": "AC_three_phase_core",
                                "control_mode": "dynamic",
                                "nominal_voltage": 230
                            },
                        }
                    },
                    {
                        "id": 2,
                        "services": {
                            "ac": {
                                "connector_type": "AC_single_phase_core",
                                "nominal_voltage": 230,
                                "control_mode": "scheduled"
                            },
                            "ac_bpt": {
                                "connector_type": "AC_single_phase_core",
                                "control_mode": "dynamic",
                                "bpt_channel": "unified",
                                "generator_mode": "grid_following",
                                "grid_island_detection_mode": "active"
                            }
                        }
                    }
                ],
                "supports_eim": true,
                "network_interface": "eth1"
            },
            {
                "evse_id": "DE*SEV*E123456790",
                "connectors": [
                {
                    "id": 1,
                    "services": {
                        "dc": {
                            "connector_type": "DC_extended"
                        },
                        "dc_bpt": {
                            "connector_type": "DC_extended",
                            "control_mode": "scheduled",
                            "bpt_channel": "separated",
                            "generator_mode": "grid_forming"
                            "grid_island_detection_mode": "passive"
                        }
                    }
                },
                {
                    "id": 2,
                    "services": {
                        "dc": {
                            "connector_type": "DC_core"
                        },
                        "dc_bpt": {
                            "connector_type": "DC_core",
                            "control_mode": "dynamic",
                            "bpt_channel": "separated",
                            "generator_mode": "grid_forming"
                            "grid_island_detection_mode": "passive"
                        }
                    }
                }
                ],
                "supports_eim": false,
                "network_interface": "eth2"
            }
        ]
    }
}

INFO.

Possible values for connector type are:

  • AC_single_phase_core

  • AC_three_phase_core

  • DC_core # Charging using the core pins of a IEC 62196-2 Type 1 or Type 2 connector

  • DC_extended # Charging using the extended and dedicated pins of a IEC 62196-3 CCS Type 1 or Type 2 connector

  • DC_combo_core # Charging using the core pins of a IEC 62196-3 CCS Type 1 or Type 2 connector.

    This only works between a CCS Socket (EV side) and a Type 1/2 plug (EVSE side), because the CCS Type 1/2 plug does not have core pins for power transfer.

  • DC_unique # Charging using a custom/dedicated DC coupler

Possible values for the optional control mode type are (only relevant for ISO 15118-20):

  • scheduled # The EV computes and decices to follow a power profile schedule

  • dynamic # The EVSE defines a one-off setpoint/target over time,

    which can be updated with a high frequency

Possible values for the optional bpt channel type are (only relevant for ISO 15118-20):

  • unified # The EVSE does BPT (Bidirectional Power Transfer) using the same wires as for charging

  • separated # The EVSE does BPT using dedicated wires for it

Possible values for generator mode type are:

  • grid_following

  • grid_forming

Possible values for the optional grid islanding detection mode type are (only relevant for ISO 15118-20):

  • active

  • passive