Tesla

← Fahrzeuge

Tesla bietet eine offizielle, aber kostenpflichtige Fahrzeug-API an. Für private Nutzung kannst du dir einen Tesla Developer Account auf developer.tesla.com erstellen und erhältst ein monatliches API-Guthaben von 10 €. Das ist für die gängigen evcc-Anwendungsfälle in der Regel ausreichend.

Die Anleitung von myteslamate.com erklärt den Prozess und generiert dir kostenfrei die für evcc benötigten Access- und Refresh-Token. Mit diesem Tokenpaar und deiner im Tesla Developer Account erstellten Client ID kann evcc direkt mit der Tesla API kommunizieren. Dein verbrauchtes Guthaben kannst du im Tesla Developer Dashboard einsehen.

Für die Nutzung des Tesla Wall Connectors benötigst du einen öffentlichen Command-Proxy-Server. myteslamate.com stellt diesen Dienst kostenpflichtig (nutzungsbasiert) zur Verfügung. Konfiguriere dafür bei myteslamate.com die Command-Berechtigungen und trage das Proxy-Token hier ein. Start-, Stopp- und Stromstärken-Kommandos werden über diesen Proxy an Tesla geschickt.

Weitere Informationen und Alternativen findest du unter docs.evcc.io/blog.

Parameter

Name	Beschreibung	Stufe
`clientId`	Client ID von developer.tesla.com.	optional
`accessToken`	Access token von myteslamate.com.	optional
`refreshToken`	Refresh token von myteslamate.com.	optional
`title`	Titel Wird in der Benutzeroberfläche angezeigt	optional
`capacity` [kWh]	Akkukapazität Beispiel: `50`	optional
`vin`	Fahrzeugidentifikationsnummer Wenn mehrere Fahrzeuge eines Herstellers vorhanden sind Beispiel: `W...`	optional
`icon`	Icon Wird in der Benutzeroberfläche angezeigt Standard: `car`	erweitert
`phases`	Maximale Phasenanzahl Die maximale Anzahl der Phasen welche genutzt werden können Beispiel: `3`	erweitert
`mode`	Standardlademodus Wird beim Anschließen eines Fahrzeugs verwendet. Möglich sind Off, Now, MinPV und PV, oder leer wenn keiner definiert werden soll	erweitert
`minCurrent` [A]	Minimale Stromstärke Definiert die minimale Stromstärke pro angeschlossener Phase die genutzt werden kann Beispiel: `6`	erweitert
`maxCurrent` [A]	Maximale Stromstärke Definiert die maximale Stromstärke pro angeschlossener Phase die genutzt werden kann Beispiel: `16`	erweitert
`maxPower` [W]	Ladeleistungs-Hinweis Definiert die maximale Ladeleistung des Fahrzeugs. Hilft, die Ladeplanung zu verbessern, wenn das Fahrzeug üblicherweise weniger Strom nutzt als angeboten oder höhere Ströme bei einphasigem Laden erlaubt als bei dreiphasigem. Der bereitgestellte Strom des Ladepunktes wird nicht beeinflusst. Beispiel: `10000`	erweitert
`identifiers`	Identifikation Kann meist erst später eingetragen werden, siehe: https://docs.evcc.io/docs/features/vehicle	erweitert
`priority`	Priorität Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von PV-Energie	erweitert
`commandProxy`	Command Proxy Bei Verwendung eines TWC3 (oder eines anderen 'dummen' Ladegeräts, das nicht steuerbar ist) kann evcc die Ladung direkt verwalten, indem es über einen Command Proxy mit dem Fahrzeug kommuniziert. Standardmäßig wird der myteslamate.com Proxy verwendet. Mit diesem Parameter kannst du die Basis-URL ändern. Siehe zum Beispiel TeslaBleHttpProxy für einen Proxy, der Kommandos über Bluetooth sendet. Standard: `https://api.myteslamate.com`	erweitert
`proxyToken`	Proxy Token Token für den Command Proxy von myteslamate.com (nutzungsbasiert). Stelle sicher, dass du den Virtual Key installiert hast und die Berechtigungen 'Ladung starten', 'Ladung stoppen' und 'Ladestrom setzen' erteilt hast.	erweitert
`cache`	Cache Zeitintervall für erneute Datenabfrage Standard: `15m` Beispiel: `5m`	erweitert

Konfigurationsbeispiel für evcc.yaml

Falls du die Konfiguration nicht über die Oberfläche vornehmen möchtest, kannst du alternativ diesen YAML-Block verwenden.

vehicles:
    - name: my_car
      type: template
      template: tesla
      clientId: # Client ID, von [developer.tesla.com](https://developer.tesla.com/dashboard).
      accessToken: # Access token, von [myteslamate.com](https://app.myteslamate.com/).
      refreshToken: # Refresh token, von [myteslamate.com](https://app.myteslamate.com/).
      title: # Titel, Wird in der Benutzeroberfläche angezeigt (optional)
      capacity: 50 # Akkukapazität (kWh), optional
      vin: W... # Fahrzeugidentifikationsnummer, Wenn mehrere Fahrzeuge eines Herstellers vorhanden sind (optional)
      icon: car # Icon, Wird in der Benutzeroberfläche angezeigt [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
      phases: 3 # Maximale Phasenanzahl, Die maximale Anzahl der Phasen welche genutzt werden können (optional)
      mode: # Standardlademodus, Wird beim Anschließen eines Fahrzeugs verwendet. Möglich sind Off, Now, MinPV und PV, oder leer wenn keiner definiert werden soll (optional)
      minCurrent: 6 # Minimale Stromstärke (A), Definiert die minimale Stromstärke pro angeschlossener Phase die genutzt werden kann (optional)
      maxCurrent: 16 # Maximale Stromstärke (A), Definiert die maximale Stromstärke pro angeschlossener Phase die genutzt werden kann (optional)
      maxPower: 10000 # Ladeleistungs-Hinweis (W), Definiert die maximale Ladeleistung des Fahrzeugs. Hilft, die Ladeplanung zu verbessern, wenn das Fahrzeug üblicherweise weniger Strom nutzt als angeboten oder höhere Ströme bei einphasigem Laden erlaubt als bei dreiphasigem. _Der bereitgestellte Strom des Ladepunktes wird nicht beeinflusst._ (optional)
      identifiers: # Identifikation, Kann meist erst später eingetragen werden, siehe: https://docs.evcc.io/docs/features/vehicle (optional)
      priority: # Priorität, Priorität des Ladepunktes oder Fahrzeugs in Relation zu anderen Ladepunkten oder Fahrzeugen für die Zuweisung von PV-Energie (optional)
      commandProxy: https://api.myteslamate.com # Command Proxy, Bei Verwendung eines TWC3 (oder eines anderen 'dummen' Ladegeräts, das nicht steuerbar ist) kann evcc die Ladung direkt verwalten, indem es über einen Command Proxy mit dem Fahrzeug kommuniziert. Standardmäßig wird der [myteslamate.com](https://app.myteslamate.com/) Proxy verwendet. Mit diesem Parameter kannst du die Basis-URL ändern. Siehe zum Beispiel [TeslaBleHttpProxy](https://github.com/wimaha/TeslaBleHttpProxy) für einen Proxy, der Kommandos über Bluetooth sendet. (optional)
      proxyToken: # Proxy Token, Token für den Command Proxy von [myteslamate.com](https://app.myteslamate.com/) (nutzungsbasiert). Stelle sicher, dass du den Virtual Key installiert hast und die Berechtigungen 'Ladung starten', 'Ladung stoppen' und 'Ladestrom setzen' erteilt hast. (optional)
      cache: 15m # Cache, Zeitintervall für erneute Datenabfrage (optional)