Volvo

← Vehicles

This page shows the nightly version. Switch to the release version.

To use with evcc, you need a Volvo account and a Volvo Connected Car API Key.

1. To do this, create a new application on the Account page and save the primary VCC API key.
2. Now publish your application and select the Scope permissions Connected Vehicle API: conve:vehicle-relation, conve:odometer-status, Energy API: energy:state:read.
3. You must enter the URL of your evcc instance as the redirect URL, e.g. https://evcc.example.org/providerauth/callback.
4. When adding the vehicle via the UI, an error message is displayed.
5. Open a new tab and go to the evcc configuration page. A button for logging in will appear in the top right menu.
6. Log in with your Volvo account and allow access to the data. If the authorization is successful, the vehicle can be added.

NOTE: Volvo enforces re-login every 7 days. Use "hamburger" menu logout/login.

Parameters

Name	Description	Value	Level
vccapikey	VCC API Key from Volvo Developer App.		optional
clientId	Client ID from Volvo Developer App.		optional
clientSecret	Client Secret from Volvo Developer App.		optional
redirectUri	Redirect URI Redirect URI of your evcc instance. Must match the redirect URI set in your Volvo Developer App.		optional
vin	Vehicle Identification Number If you own multiple vehicles from the same manufacturer Example: WF0FXX...		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 Used to determine the minimum solar surplus and plan duration.	123	advanced
mode	Default charging mode Applied when a vehicle is connected. Leave empty to keep the current mode.		advanced
minCurrent [A]	Minimum current The minimum current per connected phase that can be used Example: 6		advanced
maxCurrent [A]	Maximum current The maximum current 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	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.		advanced
priority	Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).		advanced
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.		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: volvo-connected
      vccapikey: # VCC API Key, from [Volvo Developer App](https://developer.volvocars.com/).
      clientId: # Client ID, from [Volvo Developer App](https://developer.volvocars.com/).
      clientSecret: # Client Secret, from [Volvo Developer App](https://developer.volvocars.com/).
      redirectUri: # Redirect URI, Redirect URI of your evcc instance. Must match the redirect URI set in your Volvo Developer App.
      vin: WF0FXX... # Vehicle Identification Number, If you own multiple vehicles from the same manufacturer
      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: # Maximum number of phases, Used to determine the minimum solar surplus and plan duration. [1, 2, 3] (optional)
      mode: # Default charging mode, Applied when a vehicle is connected. Leave empty to keep the current mode. (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)