homeassistant-connectedcars_io
homeassistant-connectedcars_io copied to clipboard
Home Assistant integration for connectedcars.io (Min Volkswagen)
Connectedcars.io (Min Volkswagen)
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
- Copy
connectedcars_io
folder into your custom_components folder in your hass configuration directory. - Restart Home Assistant.
Installation with HACS (Home Assistant Community Store)
- Ensure that HACS is installed.
- In HACS / Integrations / Kebab menu / Custom repositories, add the url the this repository.
- Search for and install the
Connectedcars.io (Min Volkswagen)
integration. - Restart Home Assistant.
Configuration
It is configurable through config flow, meaning it will popup a dialog after adding the integration.
- Head to Configuration --> Integrations
- Add new and search for
Connectedcars.io (Min Volkswagen)
- Enter credentials and namespace.
Currently known namespaces
- minvolkswagen (default)
- minskoda
- minseat
- mitaudi
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:
- BatteryVoltage (12V battery)
- EVHVBattTemp (EV)
- EVchargePercentage (EV)
- fuelLevel
- fuelPercentage
- GeoLocation
- Health (severity threshold configurable)
- Attribute: Leads array may help to explain the cause
- Ignition
- Lamp +name (one sensor per each reported lamp, disabled by default)
- NextServicePredicted (disabled by default)
- odometer
- outdoorTemperature
- Speed
- Fuel economy (disabled by default)
- Mileage latest year (disabled by default)
- Mileage latest month (disabled by default)
- Mileage since refuel (disabled by default)
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
Device
Dashboard
Location state