TeslaFi

← Vehicles

Connect your Tesla using the TeslaFi API. TeslaFi is a Tesla data logging service that provides HTTP API access to vehicle data. Get your API key from your TeslaFi account settings.

Parameters

Name	Description	Value	Level
apikey	API Key		optional
title	Title Will be displayed in the user interface		optional
capacity [kWh]	Battery capacity Example: 50		optional
icon	Icon Will be displayed in the user interface Default: car	carbikebusmopedmotorcyclerocketscootertaxitractorrickshawshuttlevanairpurifierbatterybulbclimatecoffeemakercomputecookingcoolerdesktopdevicedishwasherdryerfloorlampgenericheaterheatexchangeheatpumpkettlelaundrylaundry2machinemetermicrowavepumpsmartconsumertoolwaterheater	advanced
phases	Maximum number of phases The maximum number of phases which can be used Example: 3		advanced
mode	Default charging mode Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set		advanced
minCurrent [A]	Minimum amperage The minimum amperage per connected phase that can be used Example: 6		advanced
maxCurrent [A]	Maximum amperage The maximum amperage per connected phase that can be used Example: 16		advanced
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. Example: 10000		advanced
identifiers	Identification Mostly this can be added later, see: https://docs.evcc.io/en/docs/features/vehicle		advanced
priority	Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating pv energy		advanced
vin	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: W...		advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

vehicles:
    - name: my_car
      type: template
      template: teslafi
      apikey: # API Key
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 50 # Battery capacity (kWh), 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: 3 # Maximum number of phases, The maximum number of phases which can be used (optional)
      mode: # Default charging mode, Used when a vehicle is connected. Possible values are Off, Now, MinPV and PV, or empty if none should be set (optional)
      minCurrent: 6 # Minimum amperage (A), The minimum amperage per connected phase that can be used (optional)
      maxCurrent: 16 # Maximum amperage (A), The maximum amperage 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: # Identification, Mostly this can be added later, see: 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 pv energy (optional)
      vin: W... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer (optional)