menu

🔎 Jak dodać urządzenia Zigbee za pomocą Home Assistant, korzystając z integracji ZHA

Wstęp

SONOFF ZBDongle-P i ZBDongle-E to bramki USB Zigbee zaprojektowane z myślą o włączeniu urządzeń Zigbee do ekosystemu inteligentnego domu. Niezależnie od tego, czy korzystasz z Home Assistant, iHost, czy Homebridge, te klucze sprzętowe umożliwiają bezproblemową integrację SONOFF z urządzeniami Zigbee innych firm.

W tym przewodniku dowiesz się, jak skonfigurować ZBDongle z Home Assistant przy użyciu integracji ZHA , dodawać urządzenia Zigbee i wydajnie zarządzać siecią Zigbee mesh.

Czego będziesz potrzebować?

  • 1x SONOFF ZBDongle-P lub ZBDongle-E

  • Zainstalowano Home Assistant ( iHost , Home Assistant Green, Raspberry Pi itp.)

  • Port USB dostępny dla klucza sprzętowego

  • Urządzenia Zigbee (np. inteligentna wtyczka SONOFF, czujnik drzwi )

1. Włóż ZBDongle do portu USB

Zacznij od podłączenia SONOFF ZBDongle do portu USB urządzenia Home Assistant. W tym poradniku korzystamy z iHost, ale kroki są takie same dla innych konfiguracji, takich jak Home Assistant Green czy Raspberry Pi.

2. Wykryj klucz sprzętowy

Po podłączeniu klucza sprzętowego i włączeniu systemu:

  • Przejdź do Ustawień > Urządzenia i usługi

  • Nowa integracja o nazwie ZHA powinna pojawić się automatycznie.

📝 Uwaga: Jeśli się nie pojawi, kliknij „Dodaj integrację” i ręcznie wyszukaj ZHA .

3. Rozpocznij konfigurację

Kliknij integrację ZHA , a następnie:

  • Wybierz „Utwórz sieć”


  • Poczekaj kilka sekund, aż Home Assistant zakończy instalację

  • Teraz możesz zacząć dodawać urządzenia Zigbee do swojej sieci

Po zainstalowaniu ZBDongle i uruchomieniu ZHA nadszedł czas na dodanie kilku urządzeń Zigbee.

W tym przykładzie dodamy:

  • 1x SONOFF Zigbee Smart Plug (działa jako wzmacniacz)

  • 1x czujnik drzwi SONOFF SNZB-04P (urządzenie końcowe)

1. Wejdź w tryb parowania

Przejdź do Ustawienia > Urządzenia i usługi > Integracja ZHA > Dodaj urządzenie . Home Assistant nasłuchuje teraz urządzeń w trybie parowania.



2. Sparuj każde urządzenie

  • Smart Plug : Naciśnij i przytrzymaj przycisk przez około 5 sekund, aż urządzenie przejdzie w tryb parowania. Powinno pojawić się w Home Assistant za kilka sekund.

  • Czujnik drzwi : Powtórz ten sam proces (zazwyczaj przytrzymując przycisk resetowania/parowania).

Możesz zmieniać nazwy urządzeń, przypisywać je do pomieszczeń i od razu zacząć z nich korzystać.

📘 Aby dowiedzieć się więcej o rolach i zachowaniu urządzeń Zigbee, zapoznaj się z modułem Protokołów inteligentnego domu w SONOFF Academy.

Kontrola i sprawdzanie stanu urządzenia

Po dodaniu urządzeń Zigbee można monitorować i kontrolować je na dwa sposoby :

1. Z zakładki Urządzenia

  • Przejdź do Ustawień > Urządzenia i usługi > Urządzenia

  • Użyj filtra, aby wyświetlić tylko urządzenia ZHA


2. Ze strony integracji ZHA

  • Otwórz Ustawienia > Urządzenia i usługi > ZHA

  • Wyświetl wszystkie urządzenia sparowane za pomocą ZBDongle

  • Kliknij dowolne urządzenie, aby sprawdzić jego stan , zmienić jego nazwę lub sterować nim (np. WŁĄCZYĆ/WYŁĄCZYĆ inteligentną wtyczkę).

Zarządzanie siecią Zigbee

ZBDongle staje się koordynatorem Twojej sieci Zigbee, zarządzając połączeniami i komunikacją między wszystkimi urządzeniami w strukturze kratowej.

Funkcje dostępne w integracji ZHA

  • Zmień kanał Zigbee
    Niektóre kanały Zigbee mogą zakłócać Wi-Fi. Aby uzyskać optymalną wydajność, wybierz kanał, który się nie nakłada. Możesz to zmienić w ustawieniach koordynatora .



    Wybierz zakładkę „Sieć”, aby zobaczyć i zmienić kanał Zigbee, jeśli chcesz.



  • Wyświetl mapę sieci Zigbee
    Kliknij menu z trzema kropkami (⋮) na stronie ZHA i wybierz „Wyświetl sieć” .
    Zobaczysz wizualną reprezentację swojej sieci , pokazującą:

    • Koordynator

    • Routery (np. inteligentne wtyczki, które powtarzają sygnał)

    • Urządzenia końcowe (np. czujniki drzwi)

    • Wskaźnik jakości łącza (LQI) dla każdego połączenia — im wyższy wskaźnik LQI, tym silniejszy sygnał.




      Tutaj możemy zobaczyć sieć Zigbee i połączenia między różnymi urządzeniami.

📚 Aby dowiedzieć się więcej na temat architektury Zigbee i zachowania sieci, zapoznaj się z modułem Protokołów inteligentnego domu w SONOFF Academy.

Wniosek

SONOFF ZBDongle-P i ZBDongle-E to potężne narzędzia do budowy elastycznej, skalowalnej i stabilnej sieci Zigbee w Home Assistant. Dzięki integracji ZHA możesz łatwo:

  • Dodawaj i kontroluj urządzenia Zigbee

  • Monitoruj siłę sygnału i optymalizuj rozmieszczenie

  • Przeglądaj i zarządzaj strukturą swojej sieci

  • Unikaj zakłóceń w wyborze niestandardowego kanału

Niezależnie od tego, czy dopiero zaczynasz, czy rozbudowujesz istniejącą instalację, ten klucz sprzętowy ułatwia integrację urządzeń SONOFF i urządzeń Zigbee innych firm z ekosystemem inteligentnego domu.

Poprzedni
🔎 Jak zintegrować SONOFF R5/S-Mate z Home Assistant?
Następny
🔎 Jak zaktualizować oprogramowanie układowe Zigbee w ZHA i Z2M
Ostatnie modyfikacje: 2025-08-19