Skip to content

Latest commit

 

History

History
152 lines (107 loc) · 5.56 KB

volvo.markdown

File metadata and controls

152 lines (107 loc) · 5.56 KB
title description ha_release ha_iot_class ha_codeowners ha_domain ha_integration_type ha_config_flow ha_category ha_platforms ha_quality_scale related
Volvo
Instructions on setting up Volvo within Home Assistant.
2025.6
Cloud Polling
@thomasddn
volvo
integration
true
Sensor
sensor
silver
url title
Volvo developers portal

The Volvo {% term integration %} is used to integrate your Volvo vehicle.

Supported vehicles

  • All car models starting from model year 2015 (although some might have fewer features available).
  • Cars located in Europe, Middle East, Africa, US, Canada, and Latin America regions. Or view the full list of countries.

Prerequisites

  1. Head over to Volvo's developer portal.
  2. Make an account.
  3. Go to the API applications page.
  4. Create an API application and give it a meaningful name.

It's recommended to add an API application per vehicle you want to add. There is a maximum on the number of requests that can be made per API key per day.

{% include integrations/config_flow.md %}

{% configuration_basic %} API key: description: "Enter the API key obtained in the prerequisites steps." VIN: description: "If you have more than one car under this account, then you can select the Vehicle Identification Number of the vehicle you wish to add." {% endconfiguration_basic %}

Configuration options

You have the following configuration options if your model has a combustion engine:

{% configuration_basic %} Fuel consumption unit: description: You can specify in which unit (L/100 km, mpg (UK), or mpg (US)) the fuel consumption should be displayed. {% endconfiguration_basic %}

Supported functionality

The Volvo integration provides the following entities.

All engine types

Sensors

  • Car connection: Connectivity of the car
  • Distance to service: Remaining distance until the next service maintenance
  • Engine time to service: Remaining engine-hours until the next service maintenance
  • Odometer: Odometer
  • TA Avg. speed: Average speed on the automatic trip meter
  • TA Distance: Total distance on the automatic trip meter
  • Time to service: Remaining time until the next service maintenance
  • TM Avg. speed: Average speed on the manual trip meter
  • TM Distance: Total distance on the manual trip meter

Battery-only and plug-in hybrid

Sensors

  • Avg. energy consumption since charge: Average energy consumption since the last charge of the battery
  • Battery capacity: Total capacity of the battery
  • Battery charge level: Current state of charge of the battery
  • Distance to empty battery: Electric range

Sensors for specific models

Go to Volvo's developer portal to view the list of supported models.

  • Charging connection status: Charging connection status
  • Charging limit: Charging limit configured in the car
  • Charging status: Indication if the car is charging or not
  • Est. charging time: Estimated charging time to reach the target battery charge level
  • TA Avg. energy consumption: Average energy consumption on the automatic trip meter
  • Target battery charge level: Target battery charge level configured in the car
  • TM Avg. energy consumption: Average energy consumption on the manual trip meter

Fuel-only and plug-in hybrid

  • Distance to empty tank: Fuel range
  • Fuel amount: Remaining fuel
  • TA Avg. fuel consumption: Average fuel consumption on the manual automatic meter
  • TM Avg. fuel consumption: Average fuel consumption on the manual trip meter

Examples

Estimated charging finish time

The Volvo API only provides an estimated charging time (in minutes). To calculate the finish time, you can create a Template sensor helper with the template below.

{% raw %}

{% set charging_time = states('sensor.volvo_YOUR_MODEL_estimated_charging_time') | int(0) %}
{% if charging_time > 0 -%}
  {% set new_time = now() + timedelta(minutes=charging_time) %}
  {{ new_time }}
{%- else -%}
  {{ this.state }}
{%- endif %}

{% endraw %}

Set the Device class to Timestamp and optionally choose your vehicle for Device.

Data updates

The Volvo integration fetches data from the API every 135 seconds by default. If you decide to define a custom polling interval, beware that there is a maximum of 10.000 requests per day. Every poll operation accounts for about a dozen calls (depends on model).

Known limitations

The official Volvo app has access to a more feature-rich API. As a result, this integration cannot provide live updates, display tyre pressure values, start air purifying, schedule climatization, show climatization status, and so on.

Troubleshooting

Recharge API

Symptoms

The Volvo {% term integration %} does not show recharge entities, or they are unavailable. This happens because sometimes the Volvo recharge API does not respond properly.

Resolution

The integration will automatically re-enable the recharge entities once the API becomes available again.

Removing the integration

This integration follows standard integration removal.

{% include integrations/remove_device_service.md %}

After deleting the integration, go to the app of the manufacturer and remove the Home Assistant integration from there as well.