Zigbee Home Automation (ZHA) w Home Assistant — Budowa i diagnostyka sieci Mesh

🔌 Zigbee 3.0 🏠 Home Assistant 📡 ZHA (Zigbee Home Automation) 📶 Topologia Mesh ⚡ SONOFF Dongle-E (EZSP) 🔋 Sensory Bateryjne & Routery

Protokół Zigbee 3.0 to jeden z fundamentów nowoczesnego, niezawodnego inteligentnego domu. W przeciwieństwie do urządzeń opartych na Wi-Fi, które obciążają domowy punkt dostępowy i zużywają relatywnie dużo energii, Zigbee działa w oparciu o standard IEEE 802.15.4 w paśmie 2.4 GHz, tworząc w pełni autonomiczną, samonaprawiającą się sieć kratową (Mesh Network).

W moim systemie opartym na Raspberry Pi i Home Assistant (pod adresem 192.168.88.10:8123) do zarządzania ekosystemem Zigbee wykorzystuję natywną integrację ZHA (Zigbee Home Automation). Pozwala ona na bezpośrednią komunikację z koordynatorem sprzętowym bez konieczności instalowania zewnętrznych brokerów MQTT czy dodatkowych warstw oprogramowania.

1. Miejsce Zigbee w ekosystemie Home Assistant

W panelu głównym integracji Home Assistant moduł Zigbee Home Automation współpracuje ramię w ramię z własnoręcznie zbudowaną siecią radiową MySensors (opartą na nRF24L01), monitoringiem falownika fotowoltaicznego Solarman, modułami ESP z oprogramowaniem Tasmota oraz multimediami.

Ekosystem integracji w Home Assistant z Zigbee Home Automation
Rys. 1: Ekosystem integracji Home Assistant — kafelek Zigbee Home Automation (12 urządzeń) obok sieci MySensors, falownika Solarman, Tasmota i telewizora Samsung Smart TV.

2. Koordynator sprzętowy: SONOFF Zigbee 3.0 USB Dongle Plus V2

Sercem sieci jest zaawansowany koordynator SONOFF Zigbee 3.0 USB Dongle Plus V2 (model Dongle-E), oparty na mikrokontrolerze Silicon Labs EFR32MG21 z protokołem EZSP (EmberZNet Serial Protocol). Koordynator ten charakteryzuje się zewnętrzną anteną dipolową o zysku +20 dBm oraz sprzętowym wsparciem dla kilkudziesięciu bezpośrednich połączeń radiowych.

⚡ Parametry techniczne koordynatora sprzętowego

  • Model: SONOFF Zigbee 3.0 USB Dongle Plus V2 (Dongle-E)
  • Układ radiowy SoC: Silicon Labs EFR32MG21 (ARM Cortex-M33, 80 MHz)
  • Stos protokołu: EZSP (EmberZNet Serial Protocol) v8 / v9
  • Moc nadawcza: do +20 dBm z zewnętrzną anteną dookólną
  • Podłączenie fizyczne: Przedłużacz USB 2.0 (1.5 m) — kluczowy element eliminujący zakłócenia elektromagnetyczne emitowane przez kontrolery USB 3.0 płyty Raspberry Pi
  • Liczba wystawionych encji diagnostycznych: 45 encji w Home Assistant (stan radia, jakość połączenia, liczniki pakietów)
Panel ZHA i Koordynator SONOFF Zigbee 3.0 Dongle Plus V2
Rys. 2: Panel ZHA — Koordynator SONOFF Dongle Plus V2 obsługujący 12 urządzeń i aż 110 encji pomiarowo-sterujących.

3. Struktura węzłów sieci: Routery vs Urządzenia końcowe

W sieci Zigbee obowiązuje ścisły podział na dwa główne typy urządzeń podrzędnych:

  • Routery (Mains Powered): Urządzenia zasilane na stałe z sieci 230V. Nigdy nie przechodzą w stan uśpienia. Oprócz własnej funkcji (np. włączanie światła) retransmitują pakiety radiowe innych węzłów, rozszerzając zasięg na cały dom i ogród. W mojej instalacji są to:
    • Telewizor — miniaturowy przekaźnik dopuszkowy SONOFF ZBMINI (01MINIZB)
    • HOBEIAN ROUTER-01(7018) — sprzętowy repeater sieci na układzie Bouffalo Lab BL702 zainstalowany w garażu
    • Salon & Daria — moduły sterujące HOBEIAN ZG-204Z
  • Urządzenia końcowe (End Devices / Sleepy Devices): Zasilane bateryjnie czujniki (baterie CR2032/CR2450 lub AAA). Przez 99% czasu ich radio jest wyłączone w głębokim uśpieniu, co pozwala na 1-2 lata pracy na jednej baterii. Wybudzają się błyskawicznie po wykryciu zdarzenia (np. ruch, zmiana temperatury o 0.5°C) i wysyłają krótki pakiet do najbliższego routera:
    • Wiatrołap, Korytarz, Schody, Garaż — czujniki ruchu PIR eWeLink MS01 (baterie: 96%, 93%, 88%, 100%)
    • Temperatura (Gabinet) — precyzyjny czujnik klimatu HOBEIAN ZG-227Z (100% baterii)
    • Xiaomi LYWSD03MMC-z — cyfrowy termometr pokojowy LCD ze zmodyfikowanym firmware Zigbee
Lista urządzeń w sieci Zigbee i stan baterii
Rys. 3: Lista urządzeń ZHA — widoczne strefy (Obszary), producenci, modele oraz aktualne stany naładowania baterii (88%–100%).

4. Wizualizacja topologii Mesh — Jak wędrują pakiety radiowe?

Jedną z największych zalet integracji ZHA w Home Assistant jest wbudowany, interaktywny moduł Wizualizacji Zigbee. Pozwala on na żywo obserwować architekturę połączeń radiowych, wykrywać słabe ogniwa i optymalizować rozmieszczenie routerów.

Graficzna mapa topologii sieci Zigbee Mesh w Home Assistant
Rys. 4: Wizualizacja sieci Mesh — niebieski kwadrat to Koordynator, turkusowe kółka to Routery sieciowe, szare kółka to sensory bateryjne (End Devices), a czerwone oznaczają węzły uśpione/offline.

W topologii kratowej sensory nie muszą komunikować się bezpośrednio z centralnym koordynatorem. Jeśli czujnik w garażu znajduje się za grubą ścianą nośną, wysyła swój sygnał do najbliższego routera (np. przekaźnika Sonoff ZBMINI lub wzmacniacza BL702), a ten przekazuje go dalej magistralą radiową aż do Home Assistant.

5. Diagnostyka łącza: LQI, RSSI i procedura rekonfiguracji

W przypadku czujników bateryjnych kluczowe znaczenie ma jakość środowiska radiowego. W karcie diagnostycznej Home Assistant dla każdego urządzenia możemy odczytać dwa fundamentalne parametry fizyczne:

ParametrMoja wartość (Garaż)Znaczenie inżynieryjneOcena jakości
LQI (Link Quality Indication)176 / 255Wskaźnik jakości transmisji cyfrowej i stopy błędów pakietów (BER). Wartości powyżej 120 oznaczają stabilne łącze bez gubienia pakietów.Doskonała
RSSI-56 dBmMoc odbieranego sygnału radiowego (Received Signal Strength Indicator). Zakres od -30 dBm (bardzo blisko) do -90 dBm (granica zasięgu).Bardzo silny sygnał
Diagnostyka łącza radiowego LQI, RSSI i rekonfiguracja
Rys. 5: Szczegółowa karta urządzenia „Garaż” — parametry LQI=176, RSSI=-56 dBm oraz okno procedury ponownej konfiguracji węzła bateryjnego.
!
Ważna uwaga inżynieryjna dotycząca urządzeń bateryjnych:
Podczas uruchamiania procedury „Rozpocznij ponowną konfigurację” w Home Assistant, czujnik bateryjny musi zostać fizycznie wybudzony (np. poprzez jednokrotne naciśnięcie mikroguzika parowania lub wywołanie detekcji ruchu). W przeciwnym razie radio czujnika pozostaje wyłączone w trybie oszczędzania energii i koordynator nie będzie w stanie zaktualizować tablicy routingu ani zapytać o atrybuty klastrów Zigbee.

6. Zarządzanie strefami i klastrami koordynatora

W widoku konfiguracji sprzętowej koordynatora EZSP każde urządzenie może być precyzyjnie przypisane do danego pokoju (Garaż, Korytarz, Salon, pokoje domowników). Dzięki temu automatyzacje Home Assistant mogą operować na całych strefach — np. wyłączenie wszystkich świateł w strefie Korytarz przy braku ruchu przez 3 minuty.

Zarządzanie strefami i encjami koordynatora EZSP
Rys. 6: Przypisanie encji koordynatora EZSP do stref domowych i zarządzanie poszczególnymi klastrami komunikacyjnymi.

7. Podsumowanie i wnioski z eksploatacji

Połączenie koordynatora SONOFF Dongle-E z natywną integracją ZHA w Home Assistant okazało się rozwiązaniem bezkonkurencyjnym pod kątem stabilności:

  • 0 awarii i brak rozłączeń: Dzięki zastosowaniu wzmacniacza BL702 w garażu i przekaźnika Sonoff ZBMINI cała sieć Mesh pokrywa 100% powierzchni domu i posesji.
  • Błyskawiczna reakcja: Czas od wykrycia ruchu przez czujnik eWeLink MS01 do zapalenia światła wynosi poniżej 150 milisekund (w pełni lokalnie, bez żadnej chmury).
  • Długa żywotność baterii: Po wielu miesiącach pracy wskaźniki baterii utrzymują się na poziomie 88%–100%.

Jeden komentarz

Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *