Skip to main content

Vehicles

To limit vehicle charging to a given State of Charge (SoC), which most Chargers do not have the capability to read, evcc can directly communicate with the Vehicle, usually via its manufacturer.

The configuration is formatted as follows:

vehicles:
- name: ev
type: ...

All of the Vehicles listed on this page are supported by evcc. Once you have adapted the code samples to suit your Vehicle(s) in evcc.yaml, you can test the connection using the evcc vehicle command, which returns the current status of all connected vehicles. If you just want to test one meter at a time, use evcc vehicle --name my_swanky_ev.

$ ./evcc vehicle

SoC: 57%
Charge status: B
Charged: 4.7kWh
Capacity: 77kWh
Range: 280km
Odometer: 4131km
note

The availability and general quality of Vehicle data can vary greatly by manufacturer. If you have persistent issues updating your Vehicle data, please open a GitHub discussion.

Aiways​

vehicles:
- name: my_car
type: template
template: aiways
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand
capacity: 50 # Battery capacity in kWh (optional)

Audi​

vehicles:
- name: my_car
type: template
template: audi
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WAUZZZ... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

BMW​

vehicles:
- name: my_car
type: template
template: bmw
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WBMW... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

CitroΓ«n​

Requires access and refresh tokens. These can be generated with command evcc token [name].

vehicles:
- name: my_car
type: template
template: citroen
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#citroen
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#citroen
vin: V... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Dacia​

vehicles:
- name: my_car
type: template
template: dacia
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

DS​

Requires access and refresh tokens. These can be generated with command evcc token [name].

vehicles:
- name: my_car
type: template
template: ds
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#ds
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#ds
vin: V... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Fiat​

vehicles:
- name: my_car
type: template
template: fiat
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: ZFAE... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
pin: # optional

Ford​

vehicles:
- name: my_car
type: template
template: ford
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WF0FXX... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
domain: com # optional

Some models (e.g. Kona) switch internally to 2 phases at low charging currents (< 8A). In cases where the wallbox also measures the phase currents, this leads to undesirable fluctuations in the charging power. The remedy here is to set the minimum charging current to 8A.

vehicles:
- name: my_car
type: template
template: hyundai
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
language: en # 'en' for English and 'de' for German (optional)

Jaguar​

vehicles:
- name: my_car
type: template
template: jaguar-landrover
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Jeep​

vehicles:
- name: my_car
type: template
template: fiat
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: ZFAE... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
pin: # optional

Some models (e.g. Niro EV) switch internally to 2 phases at low charging currents (< 8A). In cases where the wallbox also measures the phase currents, this leads to undesirable fluctuations in the charging power. The remedy here is to set the minimum charging current to 8A.

vehicles:
- name: my_car
type: template
template: kia
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
language: en # 'en' for English and 'de' for German (optional)

Land Rover​

vehicles:
- name: my_car
type: template
template: jaguar-landrover
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Mercedes-Benz​

Requires access and refresh tokens. These can be generated with command evcc token [name].

vehicles:
- name: my_car
type: template
template: mercedes
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
region: EMEA
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#mercedes
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#mercedes
vin: V... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

MG​

vehicles:
- name: my_car
type: template
template: mg
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand
capacity: 50 # Battery capacity in kWh (optional)

Mini​

vehicles:
- name: my_car
type: template
template: mini
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WBMW... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Nissan​

Ariya​

vehicles:
- name: my_car
type: template
template: nissan-ariya
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Leaf​

vehicles:
- name: my_car
type: template
template: nissan
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Leaf (pre 2019)​

vehicles:
- name: my_car
type: template
template: carwings
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Opel​

Requires access and refresh tokens. These can be generated with command evcc token [name].

vehicles:
- name: my_car
type: template
template: opel
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#opel
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#opel
vin: V... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Peugeot​

Requires access and refresh tokens. These can be generated with command evcc token [name].

vehicles:
- name: my_car
type: template
template: peugeot
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#peugeot
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#peugeot
vin: V... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Polestar​

vehicles:
- name: my_car
type: template
template: polestar
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: LPSVS... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Porsche​

vehicles:
- name: my_car
type: template
template: porsche
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Renault​

vehicles:
- name: my_car
type: template
template: renault
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WREN... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Seat​

CupraConnect Gen3 (Ateca, Leon, Formentor)​

vehicles:
- name: my_car
type: template
template: seat
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

CupraConnect Gen4 (Born)​

vehicles:
- name: my_car
type: template
template: cupra
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Skoda​

Enyaq​

vehicles:
- name: my_car
type: template
template: enyaq
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
timeout: 10s # optional

Others​

vehicles:
- name: my_car
type: template
template: skoda
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Smart​

vehicles:
- name: my_car
type: template
template: smart-hello
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

EQ​

vehicles:
- name: my_car
type: template
template: smart
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Tesla​

Teska access and refresh tokens are required. These can be generated through tesla.evcc.io. Controlling vehicles in conjunction with a Tesla Wall Connector is done via an evcc proxy server and requires a sponsor token. The evcc virtual key must be installed on the vehicle. See tesla.evcc.io.

vehicles:
- name: my_car
type: template
template: tesla
title: # Will be displayed in the user interface (optional)
accessToken: # See https://docs.evcc.io/en/docs/devices/vehicles#tesla
refreshToken: # See https://docs.evcc.io/en/docs/devices/vehicles#tesla
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
Sponsor Token Required

More information on πŸ’š evcc Sponsorship can be found here.

Volkswagen We Connect ID​

e-Golf, e-Up, ID family

vehicles:
- name: my_car
type: template
template: vw
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WVWZZZ... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
timeout: 10s # optional

Volvo​

latest​

vehicles:
- name: my_car
type: template
template: volvo-connected
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
vccapikey: # Volvo developer portal VCC API Key, see https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300

legacy​

vehicles:
- name: my_car
type: template
template: volvo
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)

Generic support​

Custom​

vehicles:
- name: my_car
type: custom
title: My Car # display name for UI
capacity: 50 # byttery capacity (kWh)
soc: # battery soc (%)
source: # plugin type
# ...
status: # optional charge status (A..F)
source: # plugin type
# ...
range: # optional electric range (km)
source: # plugin type
# ...

evNotify​

vehicles:
- name: my_car
type: template
template: evnotify
title: # Will be displayed in the user interface (optional)
akey:
token:
capacity: 50 # Battery capacity in kWh (optional)

ISO15118​

Only supported if the vehicle can provided the state of charge (Soc) to the connected wallbox.

vehicles:
- name: my_car
type: template
template: iso15118
title: # Will be displayed in the user interface (optional)
capacity: 50 # Battery capacity in kWh (optional)

mazda2mqtt​

Required MQTT broker configuration and a mazda2mqtt installation https://github.com/C64Axel/mazda2mqtt.

vehicles:
- name: my_car
type: template
template: mazda2mqtt
title: # Will be displayed in the user interface (optional)
vin: W... # Required
capacity: 50 # Battery capacity in kWh (optional)
timeout: 720h # optional

mg2mqtt​

Required MQTT broker configuration and a SAIC/MQTT Gateway (https://github.com/SAIC-iSmart-API/saic-python-mqtt-gateway or https://github.com/SAIC-iSmart-API/saic-java-client)

vehicles:
- name: my_car
type: template
template: mg2mqtt
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
vin: W... # Required if you own multiple vehicles of the same brand
capacity: 50 # Battery capacity in kWh (optional)
timeout: 1h # optional

Offline​

vehicles:
- name: my_car
type: template
template: offline
title: # Will be displayed in the user interface (optional)
capacity: 50 # Battery capacity in kWh (optional)

Open Vehicle Monitoring System​

Support for all vehicles via ODB2 adapter in the vehicle. More info at Open Vehicle Monitoring System.

vehicles:
- name: my_car
type: template
template: ovms
title: # Will be displayed in the user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
vehicleid:
capacity: 12 # Battery capacity in kWh (optional)

PSA Car Controller​

Remote Control of PSA car https://github.com/flobz/psa_car_controller

vehicles:
- name: my_car
type: template
template: flobz
title: # Will be displayed in the user interface (optional)
url: http://192.0.2.2
vin: W... # Required
capacity: 50 # Battery capacity in kWh (optional)

TeslaLogger​

Open source Tesla data logger https://github.com/bassmaster187/TeslaLogger

vehicles:
- name: my_car
type: template
template: teslalogger
title: # Will be displayed in the user interface (optional)
id: 1 # optional
url: http://192.0.2.2
port: 5000 # Port (optional)
capacity: 50 # Battery capacity in kWh (optional)

TeslaMate​

Open source Tesla data logger https://github.com/adriankumpf/teslamate. MQTT broker required.

vehicles:
- name: my_car
type: template
template: teslamate
title: # Will be displayed in the user interface (optional)
id: 1 # optional
capacity: 50 # Battery capacity in kWh (optional)

Tronity​

vehicles:
- name: my_car
type: template
template: tronity
title: # Will be displayed in the user interface (optional)
clientid: # Setup at https://app.tronity.tech
clientsecret: # Setup at https://app.tronity.tech
vin: W... # Required if you own multiple vehicles of the same brand (optional)
capacity: 10 # Battery capacity in kWh (optional)
Sponsor Token Required

More information on πŸ’š evcc Sponsorship can be found here.

Scooter​

NIU E-Scooter​

vehicles:
- name: my_car
type: template
template: niu-e-scooter
title: # Will be displayed in the user interface (optional)
icon: scooter # Icon as shown in user interface (optional)
user: # User account (e.g. email address, user id, etc.)
password: # Password of the user account (use single quotes in case of leading zeros)
serial:
capacity: 4 # Battery capacity in kWh (optional)