Charging Station Status and Limits

Description.

Request for the Charging Station Parameters

class:

NOTE If the stations support BPT, then both the BPT and non-BPT payloads must be provided. For example, if dc station, then the cs limits should include both dc and dc_bpt limits.

CsStatusAndLimitsRequest

Topic: josev/cs. Used by Josev to request the charging station hardware limits.
type	object
properties
id	type	string
	format	uuid
name	const	cs_status_and_limits
type	const	request
data	type	object

Example:

{
    "id": "79ac862e-d0a7-4eef-98b5-c827be3bd669",
    "name": "cs_status_and_limits",
    "type": "request",
    "data": {}
}

---

NOTE

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

---

CsStatusAndLimitsResponse

Topic: cs/josev. Used by CS to respond to a CsStatusAndLimitsRequest.
type	object
properties
id	type	string
	format	uuid
name	const	cs_status_and_limits
type	const	response
data	type	object
	properties
	evses	type	array
		items	anyOf	type	object
				properties
				evse_id	type	string
				status_code	enum	evse_not_ready, evse_ready, evse_shutdown, evse_utility_interrupt_event, evse_isolation_monitoring_active, evse_emergency_shutdown, evse_malfunction
				ac	type	object
					properties
					max_current	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					nominal_voltage	type	number
					rcd_error	type	boolean
					evse_max_discharge_power	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					evse_min_discharge_power	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					ac_bpt	type	object
						properties
						evse_max_discharge_power	type	object
							properties
							l1	type	number
							l2	type	number
							l3	type	number
						evse_min_discharge_power	type	object
							properties
							l1	type	number
							l2	type	number
							l3	type	number
				dc	type	object
					properties
					present_voltage	type	number
					present_current	type	number
					max_current	type	number
					min_current	type	number
					max_voltage	type	number
					min_voltage	type	number
					max_power	type	number
					current_reg_tolerance	type	number
					peak_current_ripple	type	number
					energy_to_be_delivered	type	number
					isolation_status	enum	invalid, valid, warning, fault, no_imd
					evse_power_ramp_limit	type	number
					dc_bpt	type	object
						properties
						evse_max_discharge_power	type	number
						evse_min_discharge_power	type	number
						evse_min_discharge_current	type	number
						evse_max_discharge_current	type	number

Example:

{
  "id": "79ac862e-d0a7-4eef-98b5-c827be3bd669",
  "name": "cs_status_and_limits",
  "type": "response",
  "data": {
    "evses": [
      {
        "evse_id": "DE*SEV*E123456789",
        # evse_not_ready
        # evse_ready
        # evse_shutdown
        # evse_utility_interrupt_event
        # evse_isolation_monitoring_active
        # evse_emergency_shutdown
        # evse_malfunction
        "status_code": "evse_ready",
        "ac": {
          "max_current": {
            "l1": 16, # A
            "l2": 16, # A
            "l3": 16 # A
          },
          "nominal_voltage": 230, # V
          "rcd_error": false
        }
      }
    ]
  }
}

{
  "id": "79ac862e-d0a7-4eef-98b5-c827be3bd669",
  "name": "cs_status_and_limits",
  "type": "response",
  "data": {
    "evses": [
      {
        "evse_id": "DE*SEV*E123456789",
        # evse_not_ready
        # evse_ready
        # evse_shutdown
        # evse_utility_interrupt_event
        # evse_isolation_monitoring_active
        # evse_emergency_shutdown
        # evse_malfunction
        "status_code": "evse_ready",
        "dc": {
          "present_voltage": 0, # V
          "present_current": 0, # A
          "max_current": 200, # A
          "min_current": 0.05, # A
          "max_voltage": 200, # V
          "min_voltage": 0, # V
          "max_power": 4000, # W
          "peak_current_ripple": 5, # A
          # optional fields
          "current_reg_tolerance": 10, # A
          "energy_to_be_delivered": 2000, # W
          "isolation_status": "valid", # invalid, valid, warning, fault, no_imd
        }
      }
    ]
  }
}

{
  "id": "79ac862e-d0a7-4eef-98b5-c827be3bd669",
  "name": "cs_status_and_limits",
  "type": "response",
  "data": {
    "evses": [
      {
        "evse_id": "DE*SEV*E123456789",
        # evse_not_ready
        # evse_ready
        # evse_shutdown
        # evse_utility_interrupt_event
        # evse_isolation_monitoring_active
        # evse_emergency_shutdown
        # evse_malfunction
        "status_code": "evse_ready",
        "ac": {
          "max_current": {
            "l1": 16, # A
            "l2": 16, # A
            "l3": 16 # A
          },
          "nominal_voltage": 230, # V
          "rcd_error": false,
          "ac_bpt": {
            "evse_min_discharge_power": {"l1": 16, "l2": 16, "l3": 16}, # BPT only
            "evse_max_discharge_power": {"l1": 16, "l2": 16, "l3": 16}, # BPT only
          }
        }
      }
    ]
  }
}

{
    "id": "f29c5023-9766-401f-b7eb-dbb9c596e4f5",
    "name": "cs_status_and_limits",
    "type": "response",
    "data":
    {
        "evses":
        [
            {
                "evse_id": "GB*SEV*E123456789",
                "status_code": "evse_ready",
                "dc":
                {
                    "present_voltage": 0,
                    "present_current": 0,
                    "max_current": 2000,
                    "min_current": 0.05,
                    "max_voltage": 200,
                    "min_voltage": 0,
                    "max_power": 4001,
                    "peak_current_ripple": 5,
                    "current_reg_tolerance": 10,
                    "isolation_status": "valid",
                    "evse_power_ramp_limit": 2000,
                    "dc_bpt" : {
                      "evse_max_discharge_power": 100, # BPT only
                      "evse_min_discharge_power": 0, # BPT only
                      "evse_max_discharge_current": 100, # BPT only
                      "evse_min_discharge_current": 0 # BPT only
                    }
                }
            }
        ]
    }
}

---

CsStatusAndLimitsUpdate

Topic: cs/josev. Used by the CS to update Josev on a change of limits.
type	object
properties
id	type	string
	format	uuid
name	const	cs_status_and_limits
type	const	update
data	type	object
	properties
	evses	type	array
		items	anyOf	type	object
				properties
				evse_id	type	string
				status_code	enum	evse_not_ready, evse_ready, evse_shutdown, evse_utility_interrupt_event, evse_isolation_monitoring_active, evse_emergency_shutdown, evse_malfunction
				ac	type	object
					properties
					max_current	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					nominal_voltage	type	number
					rcd_error	type	boolean
					evse_max_discharge_power	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					evse_min_discharge_power	type	object
						properties
						l1	type	number
						l2	type	number
						l3	type	number
					ac_bpt	type	object
						properties
						evse_max_discharge_power	type	object
							properties
							l1	type	number
							l2	type	number
							l3	type	number
						evse_min_discharge_power	type	object
							properties
							l1	type	number
							l2	type	number
							l3	type	number
				dc	type	object
					properties
					present_voltage	type	number
					present_current	type	number
					max_current	type	number
					min_current	type	number
					max_voltage	type	number
					min_voltage	type	number
					max_power	type	number
					current_reg_tolerance	type	number
					peak_current_ripple	type	number
					energy_to_be_delivered	type	number
					isolation_status	enum	invalid, valid, warning, fault, no_imd
					evse_power_ramp_limit	type	number
					dc_bpt	type	object
						properties
						evse_max_discharge_power	type	number
						evse_min_discharge_power	type	number
						evse_min_discharge_current	type	number
						evse_max_discharge_current	type	number

Example:

{
  "id": "f29c5023-9766-401f-b7eb-dbb9c596e4f5",
  "name": "cs_status_and_limits",
  "type": "update",
  "data": {
    "evses": [
      {
        "id": "DE*SEV*E123456789",
        "ac": {
          "max_current": {
            "l1": 10,
            "l2": 10,
            "l3": 10
          }
        },
        "dc": {
          "max_current": 200,
          "min_current": 0.05
        }
      }
    ]
  }
}