Ga naar inhoud
slim laden

Tesla

Deze pagina toont de nightly-versie. Schakel over naar de releaseversie.

Tesla offers an official, but paid vehicle API. For private use, you can create a Tesla Developer Account at developer.tesla.com and receive a monthly API credit of $10. This is usually sufficient for the common evcc use cases.

The myteslamate.com 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 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.

Parameters

NaamOmschrijvingWaardeNiveau
clientIdClient IDoptioneel
accessTokenAccess tokenoptioneel
refreshTokenRefresh tokenoptioneel
titleTitle

Will be displayed in the user interface

optioneel
capacity [kWh]Battery capacity
Voorbeeld: 50
optioneel
vinVehicle Identification Number

If you own multiple vehicles from the same manufacturer

Voorbeeld: W...
optioneel
iconIcon

Will be displayed in the user interface

Standaard: car
geavanceerd
phasesMaximum number of phases

Used to determine the minimum solar surplus and plan duration.

geavanceerd
minCurrent [A]Minimum current

The minimum current per connected phase that can be used

Voorbeeld: 6
geavanceerd
maxCurrent [A]Maximum current

The maximum current per connected phase that can be used

Voorbeeld: 16
geavanceerd
maxPower [W]Maximum charging power hint

Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. The offered current of the loadpoint is not affected.

Voorbeeld: 10000
geavanceerd
identifiersRFID identification

Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. Learn more.

geavanceerd
priorityPriority

Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).

geavanceerd
climaterdisabledDisable climater detection

Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request.

geavanceerd
autodetectdisabledExclude from auto detection

Ignore the vehicle for auto detection of connected vehicles

geavanceerd
wakeupdisabledDisable wake-up calls

Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups.

geavanceerd
commandProxyCommand Proxy

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 proxy is used. With this parameter, you set the base URL of a custom Command Proxy. See for example TeslaBleHttpProxy for a proxy sending commands via bluetooth.

Standaard: https://api.myteslamate.com
geavanceerd
proxyTokenProxy Token

Token for the 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.

geavanceerd
cacheCache

Time interval for data refresh

Standaard: 15m
Voorbeeld: 5m
geavanceerd
Configuratievoorbeeld voor evcc.yaml

Als u niet via de gebruikersinterface wilt configureren, kunt u ook dit YAML-blok gebruiken.

vehicles:
- name: my_car
type: template
template: tesla
clientId: # Client ID, from [developer.tesla.com](https://developer.tesla.com/dashboard).
accessToken: # Access token, from [myteslamate.com](https://app.myteslamate.com/).
refreshToken: # Refresh token, from [myteslamate.com](https://app.myteslamate.com/).
title: # Title, Will be displayed in the user interface (optional)
capacity: 50 # Battery capacity (kWh), optional
vin: W... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer (optional)
icon: car # Icon, Will be displayed in the user interface [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: # Maximum number of phases, Used to determine the minimum solar surplus and plan duration. [1, 2, 3] (optional)
minCurrent: 6 # Minimum current (A), The minimum current per connected phase that can be used (optional)
maxCurrent: 16 # Maximum current (A), The maximum current per connected phase that can be used (optional)
maxPower: 10000 # Maximum charging power hint (W), Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. _The offered current of the loadpoint is not affected._ (optional)
identifiers: # RFID identification, Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](https://docs.evcc.io/en/docs/features/vehicle) (optional)
priority: # Priority, Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority). (optional)
climaterdisabled: # Disable climater detection, Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request. (optional)
autodetectdisabled: # Exclude from auto detection, Ignore the vehicle for auto detection of connected vehicles (optional)
wakeupdisabled: # Disable wake-up calls, Do not send wake-up calls to the vehicle or charger, useful for vehicles that refuse to charge after repeated wake-ups. (optional)
commandProxy: https://api.myteslamate.com # Command Proxy, 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. (optional)
proxyToken: # Proxy Token, 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. (optional)
cache: 15m # Cache, Time interval for data refresh (optional)