Zum Hauptinhalt springen

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
note

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

  1. 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)
  1. Token Generierung: Ausführen von "./evcc token mercedes" oder "evcc token [name]", wenn name gesetzt ist.
  2. 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)
Sponsor-Token erforderlich

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)
Sponsor-Token erforderlich

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)