Set the charging mode of one of the connectors of a charging station

Description

Sets the charging mode of one of the connectors of a charging station. A Smappee charging station can have up to 2 connectors depending on the type of station.

When facing a charging station with two connectors (i.e. you are looking at the LED light) the right connector has position 1, the left has position 2. A charging station with one connector only has position 1.

Setting the mode to PAUSED will disable the connector for charging. Active sessions will be stopped, i.e. the connected vehicle will not charge anymore. The session will be terminated when the cable is disconnected.

Setting the mode to NORMAL also supports setting the charging speed of the connector. The speed can be specified as

  • a percentage of the max current setting of the connector. In that case only values in range 0..100 are accepted. Any other value will produce an HTTP 400 error

  • an absolute value in ampere. In that case only values in range 0..connector.maxCurrent are accepted. Any other value will produce an HTTP 400 error.

 

Setting the charging speed and SMART mode is only supported for AC charging stations. For DC charging stations (EV Base Ultra), only the NORMAL mode (without limit) and PAUSED mode are supported.

Resource URL

https://app1pub.smappee.net/dev/v3/chargingstations/[SERIALNUMBER]/connectors/[position]/mode

HTTP method

PUT

HTTP header

Authorization: Bearer [ACCESS_TOKEN]

 [ACCESS_TOKEN] being the access token received from the Get token or Refresh token authentication calls.

HTTP body

The body allows you to choose the charging mode. When “NORMAL“ is chosen, optionally a current limit can be set as percentage or ampere. The body should be sent in JSON format as per one of the examples below:

{ "mode": "NORMAL", "limit": { "unit": "PERCENTAGE", "value": 75 } }

 

{ "mode": "NORMAL", "limit": { "unit": "AMPERE", "value": 10 } }

 

{ "mode": "SMART" }

 

 

Versioning

Version 1 (v1)

This call does not exist in this version

Version 2 (v2)

This call does not exist in this version

Version 3 (v3)

This call was introduced in this version

Content