89 lines
5.3 KiB
YAML
89 lines
5.3 KiB
YAML
template: tesla
|
|
covers: ["tesla-command", "tesla-proxy"]
|
|
products:
|
|
- brand: Tesla
|
|
requirements:
|
|
evcc: ["skiptest"]
|
|
description:
|
|
de: |
|
|
Tesla bietet eine offizielle, aber kostenpflichtige Fahrzeug-API an.
|
|
Für private Nutzung kannst du dir einen Tesla Developer Account auf [developer.tesla.com](https://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](https://www.myteslamate.com/tesla-api-application-registration/) 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](https://app.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](https://docs.evcc.io/blog/2025/01/20/tesla-api-update).
|
|
en: |
|
|
Tesla offers an official, but paid vehicle API.
|
|
For private use, you can create a Tesla Developer Account at [developer.tesla.com](https://developer.tesla.com/) and receive a monthly API credit of $10.
|
|
This is usually sufficient for the common evcc use cases.
|
|
|
|
The [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) guide explains the process and generates a free Access and Refresh Token.
|
|
With this token pair and your Client ID created in the Tesla Developer Account, evcc can directly communicate with the Tesla API.
|
|
You can see your used credit in the Tesla Developer Dashboard.
|
|
|
|
To use a Tesla Wall Connector, you need a public Command Proxy Server.
|
|
[myteslamate.com](https://app.myteslamate.com/) provides such a service with per-use pricing.
|
|
Configure the Command permissions at myteslamate.com and enter the Proxy Token here.
|
|
Start, stopp and current commands are sent to Tesla via this proxy.
|
|
|
|
More information and alternatives can be found at [docs.evcc.io/blog](https://docs.evcc.io/en/blog/2025/01/20/tesla-api-update).
|
|
params:
|
|
- preset: vehicle-common
|
|
- preset: vehicle-online
|
|
- name: clientId
|
|
help:
|
|
en: from [developer.tesla.com](https://developer.tesla.com/dashboard).
|
|
de: von [developer.tesla.com](https://developer.tesla.com/dashboard).
|
|
- name: accessToken
|
|
help:
|
|
en: from [myteslamate.com](https://app.myteslamate.com/).
|
|
de: von [myteslamate.com](https://app.myteslamate.com/).
|
|
required: true
|
|
- name: refreshToken
|
|
help:
|
|
en: from [myteslamate.com](https://app.myteslamate.com/).
|
|
de: von [myteslamate.com](https://app.myteslamate.com/).
|
|
required: true
|
|
- name: vin
|
|
- name: control
|
|
description:
|
|
generic: Control
|
|
deprecated: true
|
|
- name: commandProxy
|
|
default: https://api.myteslamate.com
|
|
advanced: true
|
|
description:
|
|
generic: Command Proxy
|
|
help:
|
|
en: "When using a TWC3 (or other 'dumb' charger not capable of control), evcc can manage the charge directly by communicating with the vehicle through a Command Proxy. By default the [myteslamate.com](https://app.myteslamate.com/) proxy is used. With this parameter, you set the base URL of a custom Command Proxy. See for example [TeslaBleHttpProxy](https://github.com/wimaha/TeslaBleHttpProxy) for a proxy sending commands via bluetooth."
|
|
de: "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."
|
|
- name: proxyToken
|
|
advanced: true
|
|
description:
|
|
generic: Proxy Token
|
|
help:
|
|
en: Token for the [myteslamate.com](https://app.myteslamate.com/) command proxy (pay-per use). Ensure, that you've installed their Virtual Key and granted 'Charge Start', 'Charge Stop' and 'Set Charging Amps' permissions.
|
|
de: 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.
|
|
- name: cache
|
|
default: 15m
|
|
render: |
|
|
type: tesla
|
|
vin: {{ .vin }}
|
|
credentials:
|
|
id: {{ .clientId }}
|
|
tokens:
|
|
access: {{ .accessToken }}
|
|
refresh: {{ .refreshToken }}
|
|
commandProxy: {{ .commandProxy }}
|
|
proxyToken: {{ .proxyToken }}
|
|
{{ include "common" . }}
|
|
{{ include "features" (merge (dict "basefeatures" (list "coarsecurrent")) .) }}
|
|
cache: {{ .cache }}
|