jnxxx / homeassistant-connectedcars_io

Home Assistant integration for connectedcars.io (Min Volkswagen)
17 stars 2 forks source link
audi connectedcars home-assistant seat skoda volkswagen

Connectedcars.io (Min Volkswagen)

hacs_badge

The Connectedcars.io (Min Volkswagen) component is a Home Assistant custom component for showing car information for Danish Volkswagens equipped with the hardware to send data to the mobile app "Min Volkswagen". Min Skoda, Min Seat and Mit Audi all use the same backend and should work as well, although still not tested.

Installation


Manual Installation

  1. Copy connectedcars_io folder into your custom_components folder in your hass configuration directory.
  2. Restart Home Assistant.

Installation with HACS (Home Assistant Community Store)

  1. Ensure that HACS is installed.
  2. In HACS / Integrations / Kebab menu / Custom repositories, add the url the this repository.
  3. Search for and install the Connectedcars.io (Min Volkswagen) integration.
  4. Restart Home Assistant.

Configuration

It is configurable through config flow, meaning it will popup a dialog after adding the integration.

  1. Head to Configuration --> Integrations
  2. Add new and search for Connectedcars.io (Min Volkswagen)
  3. Enter credentials and namespace.

Currently known namespaces

Multiple cars

If you have multiple cars on the same account, they should all appear.
If you have multiple cars of different brands, add the integration multiple times each with the suitable namespace.
So far only tested with a single car

State and attributes

A device is created for each car. For each car the following sensors can be created, but only when data is present. Thus fuel based cars should have fuel level sensors, while EVs should have battery sensors.

The naming scheme is {brand} {model} <name>.
Sensor names:

All sensors may not be reported correctedly with all cars. Among others fuelPercentage is one of those.

Debugging

It is possible to debug log the raw response from the API. This is done by setting up logging like below in configuration.yaml in Home Assistant. It is also possible to set the log level through a service call in UI.

logger: 
  default: info
  logs: 
    custom_components.connectedcars_io: debug

Examples

Configuration
Config
Options

Device
Device

Dashboard
Dashboard

Location state
Location state