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:
    refreshToken:
    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:
    refreshToken:
    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-connect
    title: # Will be displayed in the user interface (optional)
    clientid: # Setup at https://developer.ford.com
    clientsecret: # Setup at https://developer.ford.com
    accessToken:
    refreshToken:
    vin: WF0FXX... # Required if you own multiple vehicles of the same brand (optional)
    capacity: 10 # Battery capacity in kWh (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)

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)

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:
    refreshToken:
    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
    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:
    refreshToken:
    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:
    refreshToken:
    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)

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​

Tesla 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:
    refreshToken:
    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)

Zero Motorcycles​

vehicles:
  - name: my_car
    type: template
    template: zero
    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 # battery 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
      # ...
    odometer: # optional odometer (km)
      source: # plugin type
      # ...
    climater: # optional climate status (true/false)
      source: # plugin type
      # ...
    wakeup: # optional vehicle wake up command
      source: # plugin type
      # ...
    maxcurrent: # set charger max current (A)
      source: # plugin type
      # ...
    limitsoc: # optional in-vehicle limit soc, read-only (%)
      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 provide the state of charge (Soc) to the connected charger. Using ISO15118 with some VW group vehicles, e.g. Porsche Taycan, requires additional configuration in the vehicle. This requires an active location-based charging profile with the lowest minimum charge (25%) and direct charging disabled. Otherwise the vehicle cannot be put into sleep mode.

vehicles:
  - name: my_car
    type: template
    template: iso15118
    title: # Will be displayed in the user interface (optional)
    capacity: 50 # Battery capacity in kWh (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

mz2mqtt​

myMazda to MQTT. Required MQTT broker configuration and a mz2mqtt installation https://github.com/C64Axel/mz2mqtt.

vehicles:
  - name: my_car
    type: template
    template: mz2mqtt
    title: # Will be displayed in the user interface (optional)
    vin: W... # Required
    capacity: 50 # Battery capacity in kWh (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)

Tessie​

Connect your Tesla using the Tessie API. This will never wake up the car, polling can be set to "always" and interval "1M". If the vehicle is awake, the data is usually less than 15 seconds old. If the vehicle is asleep, the data is from the time the vehicle went to sleep. Get your token at https://dash.tessie.com/settings/api

vehicles:
  - name: my_car
    type: template
    template: tessie
    title: # Will be displayed in the user interface (optional)
    vin: W... # Required if you own multiple vehicles of the same brand
    token:
    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.

volvo2mqtt​

Requires MQTT broker configuration and a volvo2mqtt installation https://github.com/Dielee/volvo2mqtt

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

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)