v0.133 - Tesla Developer Account erforderlich

Ab evcc v0.133 wird ein Tesla Developer Account benötigt. Die Nutzung bleibt weiterhin kostenfrei, erfordert jedoch einen zusätzlichen Einrichtungsschritt.

Update

8.2.2025: Weitere detaillierte Anleitungen für die Tesla Fleet API und myteslamate.com-Konfiguration.

Tesla Fleet API wird ab Februar kostenpflichtig

Vor einem Jahr haben wir die Tesla Fleet API in evcc integriert. Tesla war damit der erste Hersteller, der eine offizielle und vor allem offene API für die Kommunikation mit seinen Fahrzeugen bereitgestellt hat.

Tesla hatte bereits bei der Einführung angekündigt, dass diese Schnittstelle später kostenpflichtig werden würde. Die Preise sind nun bekannt und treten ab dem 1. Februar 2025 in Kraft. Die Abrechnung erfolgt nutzungsbasiert, wobei die Kosten je nach Art der Anfrage variieren.

Mit tesla.evcc.io haben wir bislang einen Dienst bereitgestellt, über den evcc-Nutzer Zugangstoken für die API-Nutzung generieren können. Die API-Kommunikation dieser Token würde uns ab Februar 2025 in Rechnung gestellt. Die Kosten pro Nutzer hängen von der Anzahl seiner Fahrzeuge, dem Ladeverhalten und der konkreten Konfiguration des Aktualisierungsintervalls ab. Bei den meisten Nutzern überschreiten diese Kosten unser "$2 im Monat"-Sponsoring-Modell und wären damit für uns auch nicht tragbar, wenn wir die Tesla-Integration sponsorpflichtig machen würden.

Kostenloser Freibetrag für Privatnutzer

Tesla bietet Privatnutzern ein monatliches API-Guthaben von 10 €, was für die meisten evcc-Nutzer ausreichen sollte.

Mit der Version 0.133 haben wir die API-Kommunikation zu Tesla so angepasst, dass du deinen eigenen Tesla Developer Account nutzen kannst. Token, die zuvor mit tesla.evcc.io generiert wurden, funktionieren nicht mehr. Wir haben überlegt unseren bisherigen Token-Generierung-Prozess so zu erweitern, dass du ihn mit deinem eigenen Tesla Developer Account nutzen kannst. Glücklicherweise hat myteslamate.com aber genau diese Funktion bereits implementiert. Dort kannst du dir mit deinem Developer Account passende Access- und Refresh-Token generieren.

Was ist zu tun?

Für Tesla-Fahrer

Hier ist eine Schritt-für-Schritt-Anleitung, um deinen Tesla Developer Account (1) und myteslamate.com (2) einzurichten. Wir empfehlen, diese Schritte parallel in zwei Browserfenstern auszuführen, da sie voneinander abhängig sind (siehe Sprunghinweise).

1. Erstelle eine Tesla Fleet API Application
   1. Melde dich mit deinen Tesla-Zugangsdaten im Tesla Developer Portal an
   2. Klicke auf Create New Application und folge den Anweisungen
   3. Anwendungsdetails: Wähle einen Namen, eine Beschreibung und einen Verwendungszweck nach Belieben (springe zu 2.1.)
   4. Kundendetails: Gib die drei URLs ein, die myteslamate.com dir bereitstellt
   5. API/Berechtigungen: Wähle diese Berechtigungen
      • Profilinformationen
      • Fahrzeugdaten
      • Fahrzeugstandort (für Fahrzeugerkennung, noch nicht implementiert)
      • Fahrzeugbefehle (für Wakeup)
      • Fahrzeugladungskontrolle (nur für TWC-Nutzer, siehe Anleitung unten)
   6. Rechnungsdetails: Kann übersprungen werden
   7. Du erhältst eine Client ID (Kunden-ID) und ein Client Secret (Kundengeheimnis) (springe zu 2.4.)
2. Erstelle einen myteslamate.com Account
   1. Gehe zu myteslamate.com
   2. Wähle die Option Fleet API & Telemetry
   3. Melde dich mit deinen Tesla-Zugangsdaten an
   4. Verwende deine persönlichen URLs (Origin, Redirect, Callback) um die Tesla-Anwendung zu registrieren (springe zu 1.4.)
   5. Gib deine Client ID und Client Secret ein
   6. In der "kostenlos und direkt" Sektion erhältst du deine Access- und Refresh-Token
   7. Kopiere beide Token in deine evcc-Konfiguration
   8. Klicke auf die Schaltfläche Tokens von MyTeslaMate löschen
      Dies ist wichtig und stellt sicher, dass evcc die einzige Anwendung ist, die diese Token verwendet. Die Verwendung mehrerer Anwendungen (einschließlich myteslamate.com) mit denselben Token führt zu Token-Aktualisierungsproblemen.

Beispiel:

vehicles:
  - type: template
    template: tesla
    title: Tesla Model 3
    clientId: aaaaaa-11111-...     # von developer.tesla.com
    accessToken: ey1234567890...   # von myteslamate.com
    refreshToken: EU_1234567890... # von myteslamate.com

Auf myteslamate.com findest du auch eine detailliertere Erklärung und Anleitung.

Dein verbrauchtes Guthaben kannst du in der Übersicht im Tesla Developer Portal jederzeit nachverfolgen.

hinweis

Das evcc-Projekt steht in keiner Verbindung zu myteslamate.com. Wir sind mit jlestel, dem Entwickler von myteslamate.com, in Kontakt. Die kostenlose Nutzung des Services für evcc-Nutzer ist von ihm explizit erwünscht. Schau dir vor der Nutzung die Terms of Service und Privacy Policy an.

Für Tesla Wall Connector Nutzer

Wenn du einen Tesla Wall Connector verwendest, sind zusätzliche Schritte erforderlich, da die Ladekommandos eine signierte Kommunikation benötigen. myteslamate.com bietet für 12 € pro Jahr einen "Command Proxy" an, der diese Funktion bereitstellt.

Wir gehen davon aus, dass du die oben beschriebenen Schritte bereits abgeschlossen hast.

1. Logge dich ein weiteres Mal bei myteslamate.com ein nachdem du deine Token gelöscht hast (siehe 2.8.)
2. Kopiere das Proxy-Token aus der Sektion Tesla API über unseren Proxy
3. Füge das token in deine evcc-Konfiguration ein

vehicles:
  - type: template
    template: tesla
    title: Tesla Model 3
    clientId: aaaaaa-11111-...     # von developer.tesla.com
    accessToken: ey1234567890...   # von myteslamate.com
    refreshToken: EU_1234567890... # von myteslamate.com
    proxyToken: aaaaa-bbbbb-...    # von myteslamate.com

Mit dieser Konfiguration sendet evcc Steuerungsbefehle an den myteslamate.com Proxy, der sie mit deiner Tesla Anwendung signiert und an die eigentliche Tesla API weiterleitet.

warnung

Das Proxy-Token ist sehr mächtig. Es ist empfehlenswert die Berechtigungen bei myteslamate.com auf die nötigsten Funktionen zu beschränken. Für evcc sind nur die Funktionen Charge Start, Charge Stop und Set Charging Amps notwendig.

Nutzungsdaten

tesla.evcc.io wird eingestellt

tesla.evcc.io wird im Februar eingestellt. Alle damit generierten Token werden ihre Gültigkeit verlieren. Für die weitere Nutzung der Tesla-API ist ein Update auf evcc Version 0.133 erforderlich.

Weitere Alternativen

Die Tesla-API-Kommunikation in evcc ist nicht myteslamate.com-spezifisch. Du kannst dir die Token mit der entsprechenden Infrastruktur (öffentliche Callback-URL notwendig) auch selbst generieren und in die oben genannte evcc-Konfiguration eintragen.

Zudem bleibt die alternative Abfrage über Dienste wie TeslaLogger, TeslaMate, TeslaBleHttpProxy, Tessie oder Tronity weiterhin möglich.

Tesla Wall Connector-Nutzer können auch weiterhin TeslaBleHttpProxy als lokalen "Command Proxy" verwenden.

Fazit

Wir haben mehrere Alternativen für die Tesla-Anbindung diskutiert. Auch spezielle Services und Preisstufen für Tesla-Nutzer lagen auf dem Tisch. Wir glauben aber, dass unsere aktuelle Lösung aus Nutzersicht die Beste ist. Zum einen, weil sie für die meisten Privatnutzer keine zusätzlichen Kosten verursacht. Die Implementierung bleibt sponsorfrei. Die API-Kommunikation erfordert keine third-party-Dienste. Auch Nutzer größerer Fahrzeugflotten können evcc nutzen, wobei bei einer Überschreitung des monatlichen Freibetrags die API-Nutzungsgebühren direkt bei Tesla anfallen.

Viele Grüße
Das evcc Team
Michael, Andi & Uli