Zigbee2Mqtt Container

Zigbee2MQTT

Requires:

zigbee dongle. https://www.zigbee2mqtt.io/guide/adapters/#recommended CC2652 usb dongle e.g. Sonoff Zigbee 3.0 (do not buy CC2531)

lsusb: Bus 003 Device 005: ..... Silicon Labs CP210x UART Bridge

docker-compose:

version: '3.8'

volumes:
  zigbee2mqtt_data:

services:
  zigbee2mqtt:
    container_name: zigbee2mqtt
    restart: unless-stopped
    image: koenkk/zigbee2mqtt
    volumes:
      - zigbee2mqtt_data:/app/data
      - /run/udev:/run/udev:ro
    ports:
      - 8081:8081
    environment:
      - TZ=America/Chicago
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0

First device:

Paired ikea tradfri switch with it. Took few mins (and dev appear/disappear), and then zigbee2mqtt showed the switch as paired.

Enable homeassistant boolean in zigbee2mqtt yaml, after which it zigbee2mqtt published info about switch in mqtt. That mqtt discovery message was picked up home assistant and appeared as a device in MQTT integration. The friendly name configured in zigbee2mqtt web frontend also appeared in home assistant.


Zigbee Architecture Notes:

image-20221130213858245

Coordinator Router End-Device
Network role Administrator Signal Repeater, Range Extender Leaf node
Primary Purpose Administration, Security, Bridge to TCP/IP network IoT Device IoT Device
Cardinality One per network Multiple Multiple
Communication Talks to multiple devices Talks to multiple devices To one router or coordinator
Power Source Powered Powered Battery Powered
Example Zigbee hub e.g. phillips hue bridge Bulb Wyze lock
Range 10-20 m

links

social