menu

📌 Jak urządzenia SONOFF Zigbee współpracują z asystentem domowym

Wstęp

Urządzenia SONOFF Zigbee to doskonały wybór do budowy stabilnej i responsywnej lokalnej sieci inteligentnego domu. Z Home Assistant jako centrum automatyki i koordynatorem Zigbee, takim jak SONOFF Zigbee 3.0 USB Dongle Plus (ZBDongle-E lub ZBDongle-P), możesz sterować urządzeniami SONOFF Zigbee, takimi jak inteligentny przełącznik ścienny ZBM5, bez polegania na chmurze.

W tym przewodniku dowiesz się, jak zintegrować urządzenia SONOFF Zigbee z Home Assistant, korzystając z dwóch metod:

  • ZHA (automatyka domowa Zigbee)
  • Z2M (Zigbee2MQTT)

Oba modele oferują doskonałą kontrolę lokalną, obsługę automatyzacji i kompatybilność z linią produktów SONOFF Zigbee.

Przygotowanie

Zanim zaczniesz, upewnij się, że masz następujące rzeczy:

Przewodnik po konfiguracji

Istnieją dwa sposoby użycia SONOFF Zigbee 3.0 USB Dongle Plus w celu dodania urządzeń Zigbee do Home Assistant: ZHA lub Zigbee2MQTT.

Tutaj przedstawię

Jeśli używasz ZBDongle-E, wykonaj następujące czynności: Dodaj ZBDongle-E do HA

Jeśli używasz ZBDongle-P, wykonaj następujące czynności: Dodaj ZBDongle-P do HA

Po dodaniu SONOFF Zigbee 3.0 USB Dongle Plus do Home Assistant możemy dodać urządzenia Zigbee do HA w celu sterowania.

przez ZHA

Krok 1: Zainstaluj i skonfiguruj ZHA w Home Assistant

  • Przejdź do Home Assistant i przejdź do Ustawienia Urządzenia i usługi.
  • Kliknij „Dodaj integrację” i wyszukaj Zigbee Home Automation (ZHA) .
  • Po zakończeniu powinieneś zobaczyć, że ZHA zostało pomyślnie skonfigurowane w Home Assistant.

Krok 2: Dodaj SONOFF ZBM5 do Home Assistant

  1. W Home Assistant przejdź do Ustawienia > Urządzenia i usługi > ZHA > urządzenia .

  1. Umieścić ten Aby przejść w tryb parowania SONOFF ZBM5, należy nacisnąć i przytrzymać przycisk fizyczny przez 5 sekund , aż dioda LED zacznie migać.
  2. Kliknij „Dodaj urządzenie” i poczekaj, aż ZHA wykryje ZBM5.

  1. Po znalezieniu urządzenia możesz je w razie potrzeby nazwać i przypisać do pomieszczenia.

za pośrednictwem Z2M

Krok 1: Zainstaluj dodatki

Aby połączyć się z HA za pomocą dodatku Zigbee2MQTT, należy zainstalować następujące dwa dodatki:

  1. Broker Mosquitto (broker MQTT)
  2. Zigbee2MQTT

Zainstaluj brokera Mosquitto

Przejdź do Ustawienia → Dodatki → Sklep z dodatkami i zainstaluj dodatek brokera Mosquitto , a następnie go uruchom.

Zainstaluj Zigbee2MQTT

  1. Dodaj repozytorium

Wróć do sklepu z dodatkami, kliknij „ ” → „ Repozytoria ”, wypełnij

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

i kliknij Dodaj Zamknij lub kliknij przycisk Dodaj repozytorium poniżej, kliknij Dodaj Zamknij

Link instalacyjny

Zainstaluj Zigbee2MQTT

Wróć do listy sklepów , znajdź Zigbee2MQTT i kontynuuj instalację.

Krok 2: Skonfiguruj Zigbee2MQTT

Otwórz dodatek Zigbee2MQTT → Strona konfiguracji .
Musisz skonfigurować typ adaptera urządzenia i ścieżkę portu szeregowego w sekcji serial.

Następujący format:

 adapter: Adapter Type
port: ZBDongle Serial Port Path

Przykładowa konfiguracja:

W przypadku ZBDongle-E (SONOFF Zigbee 3.0 USB Dongle Plus V2):

 adapter: ember
port: /dev/ttyUSB0

W przypadku ZBDongle-P (SONOFF Zigbee 3.0 USB Dongle Plus):

 adapter: zstack
port: /dev/ttyUSB0

⚠️ Ścieżka portu szeregowego może się różnić w zależności od systemu hosta. W systemie Linux ścieżkę portu szeregowego można znaleźć, uruchamiając:

 ls -l /dev/serial/by-id

Przykładowy wynik:

 coolkit@coolkit-All-Series:~$ ls -l /dev/serial/by-id
total  0
lrwxrwxrwx 1 root root 13 3月 31 18:09 usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_76536147c914ef11950378b8bf9df066-if00-port0 -> ../../ttyUSB0

Ścieżka portu szeregowego w tym przypadku wygląda następująco:

 /dev/ttyUSB0

Po zakończeniu konfiguracji uruchom dodatek Zigbee2MQTT . Odczekaj około dwóch minut, a następnie kliknij przycisk , aby przejść do konsoli internetowej, aby dodać i zarządzać urządzeniami Zigbee.

Rozwiązywanie problemów

Urządzenie nie zostało znalezione?

Sprawdź, czy ZBDongle został wykryty w /dev/ttyUSB*

Uruchom ponownie Home Assistant po włożeniu klucza sprzętowego

Odsuń klucz sprzętowy od portów USB 3.0 lub użyj przedłużacza USB

Przekroczono limit czasu parowania?

Upewnij się, że ZBM5 jest w trybie parowania (migająca dioda LED)

Wyłącz i włącz przełącznik, a następnie spróbuj ponownie

Z2M się nie uruchamia?

Sprawdź dokładnie typ adaptera Zigbee i port w pliku configuration.yaml

Często zadawane pytania

P: Czy mogę używać ZBM5 bez dostępu do Internetu?
Tak. Zarówno ZHA, jak i Z2M to integracje lokalne , po konfiguracji nie jest wymagana żadna chmura.

P: Czy mogę aktualizować oprogramowanie układowe ZBM5 za pomocą Home Assistant?
Tak, możesz aktualizować oprogramowanie sprzętowe urządzenia za pomocą Home Assistant.

P: Jaka jest różnica pomiędzy ZHA i Zigbee2MQTT?
ZHA jest bardziej przyjazny dla użytkownika i zintegrowany z HA. Z2M oferuje większą kontrolę, logi i obsługę urządzeń. Oba są kompatybilne z SONOFF.

P: Czy w przypadku integracji urządzeń za pośrednictwem ZHA i Z2M w Home Assistant dostępne są te same funkcje?

O: Nie, nie są dokładnie takie same. Chociaż zarówno ZHA, jak i Z2M umożliwiają sterowanie i monitorowanie urządzeń Zigbee w Home Assistant, występują różnice w obsłudze urządzeń, elastyczności konfiguracji i dostępności funkcji. Dostępne funkcje mogą się różnić w zależności od konkretnego urządzenia i metody integracji.

P: Czy mogę łączyć ZHA i Z2M w tym samym Home Assistant?
Nie. Można używać tylko jednej integracji Zigbee na jeden klucz sprzętowy/instancję, chyba że używasz oddzielnych koordynatorów i kanałów Zigbee.

Poprzedni
📌 Jak urządzenia SONOFF współpracują z Google Home (integracja z chmurą)
Następny
📌 Przewodnik po konfiguracji urządzeń SmartThings i SONOFF Matter
Ostatnie modyfikacje: 2025-08-19