CarConnectivity Plugin for Homekit

CarConnectivity is a python API to connect to various car services. If you want to automatically integrate the data collected from your vehicle into Apple Home this plugin will help you.

Install using PIP

If you want to use the CarConnectivity Plugin for Homekit, the easiest way is to obtain it from PyPI. Just install it using:

pip3 install carconnectivity-plugin-homekit

after you installed CarConnectivity

Configuration

In your carconnectivity.json configuration add a section for the homekit plugin like this. A documentation of all possible config options can be found here.

{
    "carConnectivity": {
        "connectors": [
            ...
        ]
        "plugins": [
            {
                "type": "homekit",
                "config": {}
            }
        ]
    }
}

Adding to ios

After CarConnectivity is started the first time with the Homekit plugin enabled it will display a QR-Code and the pin-code in the console. Use the QR code or the pin to add the bridge to the Home app. Afterwards all accessories your car offers are added to the Home app.

A note to Docker users

CarConnectivity with Homekit will need Host or Macvlan Mode for the container. This is necessary as the bridge mode will not forward multicast which is necessary for Homekit to work. Host mode is not working on macOS. The reson is that the network is still virtualized. If you do not like to share the host network with CarConnectivity you can use macvlan mode. In macvlan mode CarConnectivity will appear as a seperate computer in the network.

Example Docker Compose configuration

The following configuration uses host mode network

services:
  carconnectivity:
    image: "tillsteinbach/carconnectivity-mqtt:latest"
    restart: unless-stopped
    environment:
      - TZ=Europe/Berlin
      - LANG=de_DE
      - LC_ALL=de_DE
      - ADDITIONAL_INSTALLS=--pre carconnectivity-connector-skoda carconnectivity-plugin-homekit
    network_mode: host
    volumes:
      - /home/myuser/docker-compose/smarthome/carconnectivity/carconnectivity.json:/carconnectivity.json
      - carconnectivity_data:/root/.carconnectivity
volumes:
  carconnectivity_data:

Updates

If you want to update, the easiest way is:

pip3 install carconnectivity-plugin-homekit --upgrade