# vehicles > Fahrzeuge in der evcc.yaml anlegen: Batteriekapazität, Phasen, RFID- oder Fahrzeugkennungen zur automatischen Erkennung und das angezeigte Symbol. Ein Fahrzeug repräsentiert ein spezifisches elektrisches Fahrzeug (EV) mit seiner Batterie. Wenn ein Fahrzeug konfiguriert und einem [Ladepunkt](/de/reference/configuration/loadpoints#vehicle) zugewiesen ist, kann in der Benutzeroberfläche u.a. der Ladestatus, der Ladezustand (Soc) und die verbleibende Ladezeit angezeigt werden sowie weitere Daten automatisch vom Fahrzeug abgerufen und verarbeitet werden. Ebenfalls ist es damit möglich die Ladung auf einen bestimmten Ladestand (Soc) zu begrenzen. Da die meisten Wallboxen diesen nicht kennen können (er wird bislang nur in ganz bestimmten Kombinationen der Wallbox übermittelt), kann evcc mit dieser Konfiguration direkt mit dem Fahrzeug über die Online-Schnittstelle (API) des Fahrzeugherstellers kommunizieren. Die `vehicles` Konfiguration ist eine Liste von verschiedenen Fahrzeugen. **Beispiel**: ```yaml vehicles: - name: Zoe type: ... ... ``` Konfigurationen für bekannte Fahrzeuge sind unter [Geräte - Fahrzeuge](/de/vehicles) zu finden. Im folgenden werden nun alle möglichen Parameter erklärt. *** ## Erforderliche Parameter ### `name` Eine Kurzbezeichnung des hier konfigurierten Fahrzeugs. Der Wert wird in der Referenzierung des Fahrzeugs in der Konfiguration des [Ladepunktes](/de/reference/configuration/loadpoints#vehicle) verwendet. **Beispiel**: ```yaml name: zoe ``` *** ### `title` Eine Beschreibung des Fahrzeugs welche auf der Benutzeroberfläche angezeigt wird. **Beispiel**: ```yaml title: Zoe ``` *** ### `type` Dies ist der evcc Schnittstellen-Typ, mit Hilfe dessen mit dem Fahrzeug kommuniziert werden kann. Bekannte Fahrzeuge können über den Typ `template` eingebunden werden. Den passenden (Template) Typ für bekannte Fahrzeuge und Hinweise für die manuelle Konfiguration `custom` findet man unter [Geräte - Fahrzeuge](/de/vehicles). *** ## Optionale Parameter ### `capacity` Die nutzbare Kapazität der Batterie des Fahrzeugs in kWh. Wird verwendet um den Energiebedarf bei Ladeplanung zu berechnen. **Beispiel**: ```yaml capacity: 50 # kWh ``` *** ### `phases` Die Anzahl der technisch *maximal* von diesem Fahrzeug (ggf. inkl. Ladekabel) verwendeten Phasen. Der interne Standardwert ist 3. Mögliche Werte sind 1, 2 oder 3. Manche Fahrzeuge, v.a. Plugin-Hybride, nutzen nicht die maximal möglichen 3 Phasen zur Ladung. Während `evcc` die tatsächlich genutzten Phasen bei Beginn eines Ladevorgangs- sofern ein Ladezähler eingebaut ist- ermitteln kann, steht die Information vor einem Ladevorgang nicht zur Verfügung. Durch Konfiguration des Parameters `phases` am Fahrzeug kann `evcc` im Smart-Modus den Ladevorgang bereits bei geringerer verfügbarer Leistung beginnen. **Beispiel**: ```yaml phases: 2 ``` *** ### `cache` Die Vorhaltezeit und Unterdrückungsdauer von externen Anfragen an die Fahrzeugdatenschnittstelle (API). > **Hinweis** > > Der Wert muss mit angehängter Zeiteinheit (siehe Beispiel) angegeben werden. > > `m` steht dabei für Minuten. > **Achtung** > > Es wird **NICHT** empfohlen, die Standardeinstellungen zu ändern, denn dies könnte dazu führen, dass der Fahrzeughersteller aktiv verhindert, das Laden mittels evcc zu steuern. **AUF EIGENES RISIKO.** Um aktuelle Zustandsdaten vom Fahrzeug zu ermitteln (z. B. Ladezustand Soc der Traktionsbatterie) werden regelmäßig die Daten der zugehörigen Datenschnittstelle beim Hersteller online abgefragt. Damit die Server des Fahrzeugherstellers jedoch nicht ständig mit Anfragen überhäuft werden (das kann zur Sperrung des Accounts führen) ist ein Zwischenspeicher (Cache) implementiert der diese Anfragen innerhalb von abfängt und mit den zuletzt abgerufenen Daten bis zu dem hier angegebebenen maximalen Alter beantwortet. Da die meisten Fahrzeuge die Daten ohnehin nur während eines laufenden Ladevorgangs in sehr großen Abständen (10 bis 30 Minuten sind üblich) aktualisieren bringen viel häufigere Anfragen keinen Mehrwert. **Standardwert:** `15m` **Beispiel**: ```yaml cache: 5m ``` *** ### `identifiers` Eine Liste mit einer oder mehreren Kennungen um das Fahrzeug zu identifizieren. Soll das Fahrzeug zum Beispiel an unterschiedlichen Wallboxen identifiziert werden können, müssen unter Umständen mehrere Kennungen verwendet werden. Die Erkennung kann dabei über folgende Mechanismen erfolgen: #### RFID Wenn die Wallbox über eine RFID Schnittstelle verfügt, kann eine RFID-Karte einem Fahrzeug zugewiesen werden um es so zu identifizieren. Hierbei wird die `RFID Token ID` benötigt. **Beispiel**: ```yaml identifiers: - 12345ABC # RFID token ID ``` Hinweis: Kann der Identifier als Zahl interpretiert werden, muss er in Anführungszeichen verpackt werden **Beispiel**: ```yaml identifiers: - "012345" - "12345e2" - "0x1234" ``` #### Fahrzeugkennung Wenn die Wallbox es unterstützt, kann vom Fahrzeug eine Fahrzeugkennung übermittelt werden. Dies kann entweder die MAC Adresse des On-Board-Ladegerätes sein, oder eine Kennung eines fest installierten Plug & Charge Zertifikats (ist ein anderes Zertifikat als für DC Laden!). **Beispiel**: ```yaml identifiers: - 01:23:45:67:89:0A # MAC address ``` Manche Fahrzeuge erzeugen jeden Tag eine neue MAC Adresse. Für diesen Fall kann man Wildcards verwenden, falls die vorhandenen Fahrzeuge sich beim nicht ändernden Teil der MAC Adresse unterscheiden. ```yaml identifiers: - 01:23:45:* ``` *** ### `features: ["coarsecurrent"]` Markiert dass ein Fahrzeug nicht mit stufenloser Ladestrombegrenzung geregelt werden kann. Diese Einstellung sollte für folgende Kombination genutzt werden: * Fahrzeug kann nur in ganzen Ampere-Schritten regeln * Wallbox kann feiner aufgelöste Ladestromvorgaben (z. B. 1 mA) verarbeiten. In dieser Kombination kann es vorkommen, dass bei Änderungen von wenigen mA der Phasenstrom für die Regelung unerwartet um 1A verändert wird. Die Regelung fängt dann ggf. an zu schwingen. Dieses Feature beschränkt auch die Regelung auf grobe 1A-Stufen. Es kann NICHT in Verbindung mit einem Fahrzeug-Template genutzt werden. Zur Verwendung muss das Fahrzeug als nativer Typ konfiguriert sein. **Beispiel**: ```yaml features: ["coarsecurrent"] ``` *** ### `icon` Die Fahrzeuge können im UI mit verschiedenen Icon angezeigt werden. Zur Verfügung stehen: * car * bike * scooter * moped * motorcycle * van * bus * tractor * generic * heater * cooler * waterheater **Beispiel**: ```yaml icon: heater ``` ***