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

Audi​

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

BMW​

Requires hcaptcha token. This must be generated once at https://bimmer-connected.readthedocs.io/en/latest/captcha/rest_of_world.html. The token is only valid for a short time. Please copy it into the configuration and start evcc as soon as possible after generation.

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

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)
    capacity: 50 # Battery capacity in kWh (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)

Dacia​

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

Fiat​

vehicles:
  - name: my_car
    type: template
    template: fiat
    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)
    title: # Will be displayed in the user interface (optional)
    capacity: 50 # Battery capacity in kWh (optional)
    pin: # Required for evcc to refresh the SoC while charging. (optional)

Ford​

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

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
    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)
    title: # Will be displayed in the user interface (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
    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)
    title: # Will be displayed in the user interface (optional)
    capacity: 50 # Battery capacity in kWh (optional)
    pin: # Required for evcc to refresh the SoC while charging. (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
    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)
    title: # Will be displayed in the user interface (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)
    capacity: 50 # Battery capacity in kWh (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)

MG​

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

Mini​

Requires hcaptcha token. This must be generated once at https://bimmer-connected.readthedocs.io/en/latest/captcha/rest_of_world.html. The token is only valid for a short time. Please copy it into the configuration and start evcc as soon as possible after generation.

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

Nissan​

Ariya​

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

Leaf​

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

Leaf (pre 2019)​

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

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)
    capacity: 50 # Battery capacity in kWh (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)

Polestar​

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

Renault​

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

Seat​

CupraConnect Gen3 (Ateca, Leon, Formentor, Tarraco)​

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

CupraConnect Gen4 (Born)​

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

Skoda​

Enyaq​

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

Others​

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

Smart​

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

EQ​

vehicles:
  - name: my_car
    type: template
    template: smart
    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)
    title: # Will be displayed in the user interface (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)
    capacity: 50 # Battery capacity in kWh (optional)
    accessToken:
    refreshToken:
    vin: W... # Required if you own multiple vehicles of the same brand (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
    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)
    title: # Will be displayed in the user interface (optional)
    capacity: 50 # Battery capacity in kWh (optional)
    timeout: 10s # optional

Volvo​

latest​

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

Zero Motorcycles​

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

ioBroker.bmw​

ioBroker BMW Adapter. Requires ioBroker.bmw and ioBroker.simple-api

vehicles:
  - name: my_car
    type: template
    template: ioBroker.bmw
    title: # Will be displayed in the user interface (optional)
    capacity: 50 # Battery capacity in kWh (optional)
    vin: WBMW... # Required if you own multiple vehicles of the same brand (optional)
    uri: # HTTP(S) address

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
    user: # User account (e.g. email address, user id, etc.)
    vin: W... # Required if you own multiple vehicles of the same brand
    title: # Will be displayed in the user interface (optional)
    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)
    capacity: 50 # Battery capacity in kWh (optional)
    vin: W... # Required if you own multiple vehicles of the same brand

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)
    capacity: 50 # Battery capacity in kWh (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:

PSA Car Controller​

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

vehicles:
  - name: my_car
    type: template
    template: flobz
    url: http://192.0.2.2
    vin: W... # Required if you own multiple vehicles of the same brand
    title: # Will be displayed in the user interface (optional)
    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)
    capacity: 50 # Battery capacity in kWh (optional)
    id: 1 # optional
    url: http://192.0.2.2
    port: 5000 # Port (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)
    capacity: 50 # Battery capacity in kWh (optional)
    id: 1 # 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)
    capacity: 50 # Battery capacity in kWh (optional)
    vin: W... # Required if you own multiple vehicles of the same brand
    token:

Tronity​

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