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
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
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.)
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)
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
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.)
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)
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)
Hyundai Bluelink
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
Kia Bluelink
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
The configuration of the Mercedes-Benz integration is only possible in yaml mode. Procedure:
- add the configuration to evcc.yaml (without token)
vehicles:
- name: my_car
type: mercedes
account: # Mercedes Me user-Id (email)
region: # MB me region (EMEA, APAC, NORAM)
vin: W... # Required, if more then one car is registered in this account
capacity: 50 # capacity in kWh (optional)
- Token generation: execute "./evcc token mercedes" or "evcc token [name]", when name is defined
- insert the tokens into evcc.yaml
vehicles:
- name: my_car
type: mercedes
account: # Mercedes Me user-id (email)
region: # MB me region (EMEA, APAC, NORAM)
vin: W... # Required, if more then one car is registered in this account
capacity: 50 # capacity in kWh (optional)
tokens:
access: token...
refresh: token...
vehicles:
- name: my_car
type: template
template: mercedes
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
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
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.)
password: # Password of the user account (use single quotes in case of leading zeros)
vin: WP0... # Required if you own multiple vehicles of the same brand (optional)
capacity: 50 # Battery capacity in kWh (optional)
Peugeot
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.)
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)
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)
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)
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)