About

This is the official HomeAssistant integration for WiCAN by meatpi.

This integration is available via HACS, and not part of the default HomeAssistant integrations.

Documentation

This repository contains only documentation for the HomeAssistant integration of WiCAN.

The documentation for the devices (e.g. WiCAN OBD or WiCAN USB) can be found in the offical WiCAN Device Documentation. There you will also find configuration instructions for the device itself (e.g. Firmware Updates / Retrieving data for your specific car model)

Integration Status

It is very much in an Alpha stage at the moment, and under constant changes, hoping to get it in a Beta state soon where we could recommend starting to use it.

Installation

Manual Installation

1. Add the integration repository to HACS and install the WiCAN integration.
   • Follow the official guide to add a custom repository.
     • Repository URL: 'https://github.com/jay-oswald/ha-wican'
     • Type: 'Integration'
   • Follow the official guide to download a repository
2. Restart home assistant
3. Continue with Configuration steps below

Installation via My Home Assistant

1. Add the integration through this link:
2. Restart home assistant
3. Continue with Configuration steps below

Configuration

• In Home Assistant, go to 'Settings > Devices & Services > Integrations'.
• Click on 'Add Integration', search for WiCAN, and select it.
• Enter the mDNS/hostname (wican_xxxxxxxxxxxx.local) or IP-Address of WiCAN device to connect the WiCAN device. If you have multiple WiCAN devices repeat these steps for the other devices.
• After setup, use the WiCAN integration's Configure button to adjust the Post Interval (in seconds) that controls how often the device pushes data to Home Assistant. The default is 15 seconds.

Webhook URL behavior

• WiCAN devices use a single local HTTP webhook URL.
• WiCAN-PRO devices on firmware v4.49+ can receive multiple webhook URLs.
• When available, Home Assistant sends WiCAN-PRO devices a local HTTP webhook URL first and an external HTTPS webhook URL second, such as Nabu Casa or a reverse proxy.
• If no local HTTP Home Assistant URL is available, WiCAN-PRO v4.49+ can fall back to a single external HTTPS webhook URL.

Result: After completing installation and configuration, WiCAN will be connected to Home Assistant, and you will be able to monitor the available car parameters directly from the Home Assistant interface.

Troubleshooting

Not possible to add a device via IP-Address or mDNS/hostname

Potential root cause: The WiCAN device might not be accessible or the protocol is not set to "AutoPID".

To fix the issue:

1. Please make sure that the WiCAN device is accesssible from your web browser. If it is not available, ensure that it is not in sleep mode WiCAN Docs: Sleep Mode
2. Please make sure that the WiCAN device uses protocol "AutoPID" via the WiCAN device settings.

The device is added, but all entites show status "Unavailable"

Potential root cause: HomeAssistant has been restarted or the WiCAN integration reloaded while the WiCAN device was not available (e.g. car away, sleep mode).

To fix the issue, make sure, the WiCAN device is available (e.g. by turning on ignition of car) and then reload the integration.

Device entities are not properly updated anymore after changing the car configuration on the WiCAN device

Potential root cause: The WiCAN integration creates entities based on the car configuration in HomeAssistant. By changing the car configuration, some PIDs might get added and others removed.

To ensure, that all entities in HomeAssistant are up to date after changing the car configuration, you can either

• delete inidividual entities, that are not available in the new car configuration OR
• delete the WiCAN device in HomeAssistant and afterwards add it again with the new car configuration.

The Unit of measure of a device entity cannot be changed in HomeAssistant

Background: The WiCAN HomeAssistant integration creates entities based on the WiCAN car configuration.

To change the unit of measure of an entity in HomeAssistant, it needs to be updated in the WiCAN device itself:

• Open the WiCAN device in a web-browser (e.g. via link "VISIT" from the WiCAN device page in HomeAssistant)
• Go to tab "Automate", find the respective PID, update the "unit" and press "Submit changes". Further details about the car configuration are part of the official WiCAN device documentation: Automate
• After changing the unit on the WiCAN device, go to HomeAssistant and reload the WiCAN integration. This will automatically update the unit of measure for the respective entity.