HomeAssistant Zigbee 동글 연결

Sonoff Dongle Max Zigbee(알리에서 구매)

 

Sonoff Dongle Max는 EFR32MG24 칩셋을 탑재한 최신 3-in-1(USB, PoE Ethernet, Wi-Fi) Zigbee 코디네이터입니다.

연결 방식은 크게 USB 직결 방식과 네트워크(Ethernet/Wi-Fi TCP) 연결 방식으로 나뉩니다. (Wi-Fi로 사용예정)

---

1. 사전 준비: Mosquitto MQTT 설치

Zigbee2MQTT를 작동하려면 MQTT 브로커가 필요합니다. 기존 docker-compose.yml 파일에 Mosquitto 서비스가 없다면 추가해 주어야 합니다.

---

2. Docker Compose 설정 (docker-compose.yml)

기존 ~/smarthome/docker-compose.yml 파일에 mosquitto와 zigbee2mqtt를 추가 구성합니다.

YAML

 

services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /home/hak/smarthome/ha_config:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host


  n8n:
    image: docker.n8n.io/n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - N8N_SECURE_COOKIE=false
      - NODE_ENV=production
      - GENERIC_TIMEZONE=Asia/Seoul
    volumes:
      - /home/hak/smarthome/n8n_data:/home/node/.n8n


  mosquitto:
    image: eclipse-mosquitto:latest
    container_name: mosquitto
    restart: unless-stopped
    ports:
      - "1883:1883"
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data
      - ./mosquitto/log:/mosquitto/log
      
      
  zigbee2mqtt:
    container_name: zigbee2mqtt
    image: koenkk/zigbee2mqtt:latest
    restart: unless-stopped
    volumes:
      - ./zigbee2mqtt-data:/app/data
      - /run/udev:/run/udev:ro
    ports:
      - "8080:8080"
    environment:
      - TZ=Asia/Seoul

---

3. Zigbee2MQTT 설정 (configuration.yaml)

컨테이너를 처음 실행하기 전, ./zigbee2mqtt-data/configuration.yaml 파일에 동글 연결 설정을 지정해야 합니다.

파일 위치: ~/smarthome/zigbee2mqtt-data/configuration.yaml

[방식 B] PoE / Ethernet / Wi-Fi (네트워크)로 사용하는 경우

Sonoff Dongle Max를 랜선에 꽂거나 Wi-Fi로 연결한 경우, 동글 웹 관리페이지에서 IP를 확인 후 TCP 방식으로 연결합니다.

(SK broadband 공유기에서 Sonoff Dongle에 고정 ip(192.168.45.3) 할당.

YAML

 

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://mosquitto:1883
serial:
  port: tcp://192.168.45.3:6638
  adapter: ember
  baudrate: 115200
  rtscts: false
advanced:
  log_level: info
  channel: 11
  enable_external_js: false
frontend:
  enabled: true
  port: 8080
homeassistant:
  enabled: true
onboarding: false

---

4. 컨테이너 실행 및 확인

1. 서비스들을 시작합니다:
2. Bash

    

   cd ~/smarthome
   docker compose up -d
   

3. Zigbee2MQTT 웹 UI 접속:
   • 브라우저에서 http://192.168.45.3:8080으로 접속하여 정상 구동되는지 확인합니다.
4. Home Assistant 연동:
   • Home Assistant 접속 (http://192.168.45.2:8123)
   • 설정 → 기기 및 서비스 →  통합 구성요소 추가
   • MQTT 검색 후 추가
   • 브로커 주소에 localhost 또는 서버 IP 입력 후 연동하면, Zigbee2MQTT에 등록하는 지그비 기기들이 자동으로 Home Assistant에 나타납니다.