Fahrzeuge
Um die Ladung auf einen bestimmten Ladestand (SoC) zu begrenzen, und die meisten Wallboxen diesen nicht kennen, kann evcc direkt mit dem Fahrzeug über den Fahrzeughersteller kommunizieren.
In der Konfigurationsdatei gibt es hierzu den folgenden Bereich:
vehicles:
- name: ev
type: ...
Auf dieser Seite findest du die Konfigurationen für alle von evcc unterstützten Fahrzeuge.
Nachdem du das Code-Beispiel für dein Fahrzeug angepasst und in die evcc.yaml
übernommen hast, kannst du die Verbindung mit dem Befehl evcc vehicle
testen. Dabei werden alle konfigurierten Fahrzeuge getestet. Mit dem Befehl evcc vehicle --name my_ev
kann man mittels des vergebenen Namens selektiv testen.
$ ./evcc vehicle
SoC: 57%
Charge status: B
Charged: 4.7kWh
Capacity: 77kWh
Range: 280km
Odometer: 4131km
Die Qualität und Verfügbarkeit der Fahrzeugschnittstellen variiert von Hersteller zu Hersteller. Solltest du anhaltende Probleme mit dem aktualisieren deiner Fahrzeugdaten haben melde dich bitte in den GitHub Discussions.
Aiways
vehicles:
- name: my_car
type: template
template: aiways
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind
capacity: 50 # Akkukapazität in kWh (optional)
Audi
vehicles:
- name: my_car
type: template
template: audi
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WAUZZZ... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
BMW
vehicles:
- name: my_car
type: template
template: bmw
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WBMW... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Citroën
vehicles:
- name: my_car
type: template
template: citroen
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Dacia
vehicles:
- name: my_car
type: template
template: dacia
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
DS
vehicles:
- name: my_car
type: template
template: ds
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Fiat
vehicles:
- name: my_car
type: template
template: fiat
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: ZFAE... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
pin: # optional
Ford
vehicles:
- name: my_car
type: template
template: ford
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WF0FXX... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Hyundai Bluelink
vehicles:
- name: my_car
type: template
template: hyundai
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
language: en # 'de' für Deutsch und 'en' für Englisch (optional)
Jaguar
vehicles:
- name: my_car
type: template
template: jaguar-landrover
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Jeep
vehicles:
- name: my_car
type: template
template: fiat
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: ZFAE... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
pin: # optional
Kia Bluelink
vehicles:
- name: my_car
type: template
template: kia
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
language: en # 'de' für Deutsch und 'en' für Englisch (optional)
Land Rover
vehicles:
- name: my_car
type: template
template: jaguar-landrover
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Mercedes-Benz
Die Konfiguration der Mercedes-Benz Integration nur im yaml Modus möglich. Ablauf:
- Hinzufügen der Konfiguration in die evcc.yaml (ohne Token)
vehicles:
- name: my_car
type: mercedes
account: # Mercedes Me Nutzer-Id (email)
region: # MB me Region (EMEA, APAC, NORAM)
vin: W... # Erforderlich, wenn mehr als ein Fahrzeug im Account registriert
capacity: 50 # Akkukapazität in kWh (optional)
- Token Generierung: Ausführen von "./evcc token mercedes" oder "evcc token [name]", wenn name gesetzt ist.
- Einfügen der Tokens in die evcc.yaml
vehicles:
- name: my_car
type: mercedes
account: # Mercedes Me Nutzer-Id (email)
region: # MB me Region (EMEA, APAC, NORAM)
vin: W... # , wenn mehr als ein Fahrzeug im Account registriert
capacity: 50 # Akkukapazität 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: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind
capacity: 50 # Akkukapazität in kWh (optional)
Mini
vehicles:
- name: my_car
type: template
template: mini
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WBMW... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Nissan
Leaf
vehicles:
- name: my_car
type: template
template: nissan
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Leaf (pre 2019)
vehicles:
- name: my_car
type: template
template: carwings
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Opel
vehicles:
- name: my_car
type: template
template: opel
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WP0... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Peugeot
vehicles:
- name: my_car
type: template
template: peugeot
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Polestar
vehicles:
- name: my_car
type: template
template: polestar
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: LPSVS... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Porsche
vehicles:
- name: my_car
type: template
template: porsche
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Renault
vehicles:
- name: my_car
type: template
template: renault
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WREN... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Seat
CupraConnect Gen3 (Ateca, Leon, Formentor)
vehicles:
- name: my_car
type: template
template: seat
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
CupraConnect Gen4 (Born)
vehicles:
- name: my_car
type: template
template: cupra
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Skoda
Andere
vehicles:
- name: my_car
type: template
template: skoda
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Enyaq
vehicles:
- name: my_car
type: template
template: enyaq
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
timeout: 10s # optional
Smart
vehicles:
- name: my_car
type: template
template: smart-hello
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
EQ
vehicles:
- name: my_car
type: template
template: smart
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Tesla
Benötigt access
und refresh
Tokens. Diese können über tesla.evcc.io erstellt werden.
Die Steuerung von Fahrzeugen im Zusammenspiel mit einem Tesla Wall Connector erfolgt über einen evcc Proxy-Server und benötigt ein Sponsor Token. Der virtuelle evcc Schlüssel muss auf dem Fahrzeug installiert sein.
Siehe tesla.evcc.io.
vehicles:
- name: my_car
type: template
template: tesla
title: # Wird in der Benutzeroberfläche angezeigt (optional)
accessToken: # Siehe https://docs.evcc.io/docs/devices/vehicles#tesla
refreshToken: # Siehe https://docs.evcc.io/docs/devices/vehicles#tesla
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Weitere Informationen zum 💚 evcc Sponsorship gibt es hier.
Volkswagen We Connect ID
e-Golf, e-Up, ID Familie
vehicles:
- name: my_car
type: template
template: vw
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: WVWZZZ... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
timeout: 10s # optional
Volvo
aktuell
vehicles:
- name: my_car
type: template
template: volvo-connected
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
vccapikey: # Volvo developer portal VCC API Key, siehe https://github.com/evcc-io/evcc/discussions/3677#discussioncomment-4106300
veraltet
vehicles:
- name: my_car
type: template
template: volvo
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Generische Unterstützung
manuell
vehicles:
- name: my_car
type: custom
title: Mein Auto # 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
# ...
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
# ...
evNotify
vehicles:
- name: my_car
type: template
template: evnotify
title: # Wird in der Benutzeroberfläche angezeigt (optional)
akey:
token:
capacity: 50 # Akkukapazität in kWh (optional)
ISO15118
Nur unterstützt wenn das Fahrzeug den Ladestand (Soc) an die verbundene Wallbox übermitteln kann.
vehicles:
- name: my_car
type: template
template: iso15118
title: # Wird in der Benutzeroberfläche angezeigt (optional)
capacity: 50 # Akkukapazität in kWh (optional)
mazda2mqtt
Voraussetzung ist ein konfigurierter MQTT Broker und eine mazda2mqtt Installation https://github.com/C64Axel/mazda2mqtt.
vehicles:
- name: my_car
type: template
template: mazda2mqtt
title: # Wird in der Benutzeroberfläche angezeigt (optional)
vin: W... # Erforderlich
capacity: 50 # Akkukapazität in kWh (optional)
timeout: 720h # optional
mg2mqtt
Voraussetzung ist ein konfigurierter MQTT Broker und ein SAIC/MQTT Gateway (https://github.com/SAIC-iSmart-API/saic-python-mqtt-gateway oder https://github.com/SAIC-iSmart-API/saic-java-client)
vehicles:
- name: my_car
type: template
template: mg2mqtt
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind
capacity: 50 # Akkukapazität in kWh (optional)
timeout: 1h # optional
Offline
vehicles:
- name: my_car
type: template
template: offline
title: # Wird in der Benutzeroberfläche angezeigt (optional)
capacity: 50 # Akkukapazität in kWh (optional)
Open Vehicle Monitoring System
Unterstützung für alle Fahrzeuge via ODB2 Adapter im Fahrzeug. Mehr Infos bei Open Vehicle Monitoring System.
vehicles:
- name: my_car
type: template
template: ovms
title: # Wird in der Benutzeroberfläche angezeigt (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
vehicleid:
capacity: 12 # Akkukapazität 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: # Wird in der Benutzeroberfläche angezeigt (optional)
url: http://192.0.2.2
vin: W... # Erforderlich
capacity: 50 # Akkukapazität in kWh (optional)
TeslaMate
Open Source Tesla Datenlogger https://github.com/adriankumpf/teslamate. Voraussetzung ist konfigurierter MQTT Broker.
vehicles:
- name: my_car
type: template
template: teslamate
title: # Wird in der Benutzeroberfläche angezeigt (optional)
id: 1 # optional
capacity: 50 # Akkukapazität in kWh (optional)
Tronity
vehicles:
- name: my_car
type: template
template: tronity
title: # Wird in der Benutzeroberfläche angezeigt (optional)
clientid: # Einrichtung unter https://app.tronity.tech
clientsecret: # Einrichtung unter https://app.tronity.tech
vin: W... # Erforderlich, wenn mehrere Fahrzeuge des Herstellers vorhanden sind (optional)
capacity: 10 # Akkukapazität in kWh (optional)
Weitere Informationen zum 💚 evcc Sponsorship gibt es hier.
Scooter
NIU E-Scooter
vehicles:
- name: my_car
type: template
template: niu-e-scooter
title: # Wird in der Benutzeroberfläche angezeigt (optional)
icon: scooter # Icon in der Benutzeroberfläche (optional)
user: # Benutzerkonto (bspw. E-Mail Adresse, User Id, etc.)
password: # Passwort des Benutzerkontos (bei führenden Nullen bitte in einfache Hochkommata setzen)
serial:
capacity: 4 # Akkukapazität in kWh (optional)