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:
- Asystent domowy zainstalowany i uruchomiony
- A Koordynator Zigbee (np, SONOFF Zigbee 3.0 USB Dongle Plus-P / -E )
- Urządzenie SONOFF Zigbee: SONOFF ZBM5
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
- W Home Assistant przejdź do Ustawienia > Urządzenia i usługi > ZHA > urządzenia .
- 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ć.
- Kliknij „Dodaj urządzenie” i poczekaj, aż ZHA wykryje ZBM5.
- 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:
- Broker Mosquitto (broker MQTT)
- Zigbee2MQTT
Zainstaluj brokera Mosquitto
Przejdź do Ustawienia → Dodatki → Sklep z dodatkami i zainstaluj dodatek brokera Mosquitto , a następnie go uruchom.
Zainstaluj Zigbee2MQTT
- 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
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.