Zigbee2MQTT: kompletní průvodce nastavením

Zigbee2MQTT je nejflexibilnější způsob jak dostat Zigbee zařízení do Home Assistantu. Žádný proprietární hub, žádný cloud, plná kontrola nad každým zařízením. Tady je kompletní postup instalace a nastavení – od nuly po fungující síť.

Co potřebuješ

• Zigbee koordinátor – doporučuji Home Assistant SkyConnect (USB dongle, plug & play s HAOS) nebo Sonoff Zigbee 3.0 USB Dongle Plus (levnější alternativa)
• Home Assistant OS (HAOS) – Z2M funguje nejlépe jako addon
• Aspoň jedno Zigbee zařízení k otestování

Krok 1: Přidání Z2M repozitáře do HA

Z2M není v oficiálním obchodě addonů – musíš přidat komunitní repozitář.

Nastavení → Doplňky → Obchod doplňků → ⋮ (tři tečky vpravo nahoře) → Repozitáře

Přidej URL:

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Po přidání repozitáře se obnoví seznam a uvidíš addon Zigbee2MQTT. Klikni na něj a nainstaluj.

Krok 2: Nastavení sériového portu koordinátora

Před spuštěním musíš Z2M říct kde koordinátor je. Přejdi na Nastavení → Systém → Hardware → ⋮ → Všechna hardwarová zařízení a najdi svůj USB dongle – bude mít název obsahující výrobce (SkyConnect, Sonoff, ITEAD).

Pak v addonové konfiguraci Z2M nastav:

serial:
  port: /dev/serial/by-id/usb-Nabu_Casa_SkyConnect_v1.0_XXXXX-if00-port0
  # nebo pro Sonoff dongle:
  # port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_XXXXX-if00-port0

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://core-mosquitto   # pokud používáš Mosquitto addon v HA

Přesný název portu najdeš v sekci Hardware – vždy používej cestu /dev/serial/by-id/... místo /dev/ttyUSB0, protože ta se může po restartu změnit.

Krok 3: Spuštění a přístup do UI

Zapni addon a počkej na log hlášku Zigbee2MQTT started!. Z2M má vlastní webové rozhraní – otevři ho přes addon → Otevřít webové rozhraní nebo přímo na portu 8099.

Krok 4: Párování prvního zařízení

V Z2M UI klikni na Permit join (All) – síť se otevře na 250 sekund. Na Zigbee zařízení aktivuj párovací mód (většinou 3x stisknutí resetovacího tlačítka nebo dlouhé držení). Zařízení by se mělo objevit v záložce Devices.

Po spárování zařízení přejmenuj v Z2M UI – jméno se promítne do HA entity (například sensor.loznice_teplota). Pojmenování hned na začátku ušetří hodně přejmenovávání entit v HA.

Krok 5: Integrace Z2M s Home Assistantem

Z2M komunikuje s HA přes MQTT. Pokud máš Mosquitto addon, přidej MQTT integraci v HA:

Nastavení → Zařízení a služby → + Přidat integraci → MQTT

Broker: core-mosquitto, port: 1883. Po přidání se Z2M zařízení automaticky začnou objevovat v HA jako entity.

Krok 6: Doporučená nastavení Z2M

V Z2M UI → Settings → Edit configuration.yaml přidej:

homeassistant:
  enabled: true          # automatická discovery entit v HA

advanced:
  channel: 25            # Zigbee kanál - volte 15, 20 nebo 25 (nejméně rušení od WiFi)
  log_level: warning     # méně logů = přehlednější debug

frontend:
  enabled: true          # Z2M webové rozhraní
  port: 8099

Zigbee mesh – jak posílit síť

Každé Zigbee zařízení je buď router (napájeno ze sítě, přeposílá signál) nebo end device (bateriové, jen přijímá a vysílá). Žárovky, zásuvky a vypínače jsou routery. Senzory na baterie jsou end devices.

Záložka Map v Z2M UI zobrazuje síťovou mapu – uvidíš jak jsou zařízení propojená. Pokud má zařízení slabý signál (LQI pod 100), přidej mezi ně router (napájenou zásuvku nebo žárovku).

Časté problémy

• Zařízení se nepáruje – zkontroluj v logu Z2M jestli koordinátor „slyší“ zařízení. Přibliž zařízení ke koordinátoru při párování.
• Entity se nezobrazují v HA – ověř že MQTT integrace je přidaná a Mosquitto broker běží.
• Zařízení padá off/on – problém s mesh sítí, přidej router mezi koordinátor a zařízení.
• Port se mění po restartu – používej cestu /dev/serial/by-id/... ne /dev/ttyUSB0.