Skip to content

WebThingsIO/zigbee-adapter

Repository files navigation

Zigbee Adapter

Zigbee device adapter for WebThings Gateway.

Compatibility

This adapter is compatible with the following USB dongles:

  • Digi XStick2 (XU-Z11)

  • RaspBee module plugged into a Raspberry Pi

    • RaspBee module needs to be connected with UART PL011, not the mini UART, and be accesssible on /dev/ttyAMA0.
    • In /boot/config.txt add dtoverlay=pi3-miniuart-bt in section [all]
    • In /boot/cmdline.txt remove console=tty1 to disable console on tty1
    • The allowAMASerial flag must be enabled via Settings -> Add-ons -> Zigbee -> Configure.
    • Notes on the UART config: UART Configuration - Raspberry Pi Documentation
  • ConBee Zigbee USB stick

  • ConBee II Zigbee USB stick

  • TI CC253x-based dongles

    • These must be flashed with the firmware in the firmware directory of this repository, following these instructions, or using Raspberry Pi
    • Last time ITEAD sells them preprogrammed with some ZNP firmware - probably working with this plugin.

Additionally, the adapter can talk to one or more Zigbee2MQTT instances over MQTT. The supported dongles are listed here. To see if your devices are supported, look here.

To use it, just add another Zigbee2MQTT entry in the config of the adapter and update the host field with the hostname or IP of your MQTT broker.

If you don't have an existing Zigbee2MQTT installation, you can follow this guide to set one up.