Volvo

← Vehicles

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. Example: https://evcc.example.org/providerauth/callback		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 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

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: https://evcc.example.org/providerauth/callback # 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: 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)