home-assistant.io/source/_components/volvooncall.markdown

title, description, logo, ha_category, ha_release, ha_iot_class, redirect_from

title	description	logo	ha_category	ha_release	ha_iot_class	redirect_from
Volvo On Call	Instructions for how to integrate Volvo On Call into Home Assistant.	volvo.png	Car	0.39	Cloud Polling	/components/binary_sensor.volvooncall/ /components/lock.volvooncall/ /components/sensor.volvooncall/ /components/switch.volvooncall/ /components/device_tracker.volvooncall/

The volvooncall integration offers integration with the Volvo On Call cloud service and offers presence detection as well as sensors such as odometer and fuel level.

Configuration

To use Volvo On Call in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
volvooncall:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD

Users registered with Volvo in North America or China will need to specify a region:

# North America
volvooncall:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  region: na

or

# China
volvooncall:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  region: cn

{% configuration %} username: description: The username associated with your Volvo On Call account. required: true type: string password: description: The password for your given Volvo On Call account. required: true type: string region: description: The region where the Volvo is registered. Needs to be set for users in North America or China. required: false type: string service_url: description: The service URL to use for Volvo On Call. Normally not necessary to specify. required: false type: string mutable: description: If set to true, include components that can make changes to the vehicle (unlock, start engine, start heater etc). required: false default: true type: boolean name: description: "Make it possible to provide a name for the vehicles. Note: Use all lower case letters when inputing your VIN number." required: false type: string resources: description: A list of resources to display (defaults to all available). required: false type: list scandinavian_miles: description: If set to true, Scandinavian miles ("mil") are used for distances and fuel range. required: false type: boolean default: false {% endconfiguration %}

Available Resources

The list of currently available resources:

• position
• lock
• heater
• odometer
• trip_meter1
• trip_meter2
• fuel_amount
• fuel_amount_level
• average_fuel_consumption
• distance_to_empty
• washer_fluid_level
• brake_fluid
• service_warning_status
• bulb_failures
• battery_range
• battery_level
• time_to_fully_charged
• battery_charge_status
• engine_start
• last_trip
• is_engine_running
• doors.hood_open
• doors.front_left_door_open
• doors.front_right_door_open
• doors.rear_left_door_open
• doors.rear_right_door_open
• windows.front_left_window_open
• windows.front_right_window_open
• windows.rear_left_window_open
• windows.rear_right_window_open
• tyre_pressure.front_left_tyre_pressure
• tyre_pressure.front_right_tyre_pressure
• tyre_pressure.rear_left_tyre_pressure
• tyre_pressure.rear_right_tyre_pressure
• any_door_open
• any_window_open

Advanced Examples

A more advanced example for setting the vehicle name and selecting what resources to display:

# Example configuration.yaml entry
volvooncall:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  name:
    YOUR_VIN_NUMBER: 'NEW_NAME'
  resources:
    - odometer
    - lock
    - heater