/silabs-multipan-docker

A RPC docker server based on HomeAssistant's Silicon Labs multiprotocol addon

Primary LanguageShellApache License 2.0Apache-2.0

Silabs multiprotocol for HA docker installation

This container is a standalone version of the Silicon Labs multiprotocol addon for HAOS. without the HAOS stuff.

Credits

Based on the work by @nervousapps and m33ts4k0z

requirements

  1. working IPv6 in your LAN
  2. the name of your network interface (try ifconfig or ip a) to set BACKBONE_IF correctly
  3. the path of your Device like /dev/tty??? (/dev/serial/by-id/ will not work)
  4. Zigbee channel and Thread channel must be configured to the same
  5. Port 8081 and 8086 are not in use because the OTBR use is (the first one can't be changed)

getting started

⚠️ change DEVICE and BACKBONE_IF to your environment ⚠️

as docker run

docker run --name multipan \
            --detach \
            --privileged \
            --network host \
            --restart unless-stopped \
            --volume ~/multipan/:/data \
            --env DEVICE="/dev/ttyUSB0" \
            --env BACKBONE_IF="eth0" \
            b2un0/silabs-multipan-docker:latest

as docker compose

  1. download the docker-compose.yml or copy the service to your existing one
  2. change the config in environment if necessary
  3. run docker compose up -d

Setup OpenThread Border Router

open in your browser http://HOST:8086 and configure your OTBR

Home Assistant

add a new Device Integration "Open Thread Border Router" and use as Host http://HOST:8081 as Endpoint.

Setup Zigbee2MQTT

To use this with Zigbee2MQTT change the configuration.yaml file of Zigbee2MQTT to this configuration:

serial:
  port: tcp://host_ip:20108
  adapter: ezsp
  baudrate: 460800

Restart Zigbee2MQTT. It might take a couple of tries for Zigbee2MQTT to connect the first time but it will work without issues afterwards.

Matter

you also need the python-matter-server if you want to use Matter enabled devices with Home Assistant.

Firmware Update

  1. download the newer firmware from https://github.com/NabuCasa/silabs-firmware/tree/main/RCPMultiPAN/beta
  2. place them into your local directory ~/multipan/firmware/ (if your /data Volume mounted to ~/multipan/)
  3. change the environment variable FIRMWARE to the new Filename (without path)
  4. change the environment variable AUTOFLASH_FIRMWARE to 1
  5. redeploy your container