Kompletny przewodnik po integracji urządzeń SONOFF z Home Assistant

Wprowadzenie

Home Assistant to popularna platforma open-source do inteligentnego domu. Działa na Raspberry Pi, komputerach, urządzeniach NAS itp., łącząc urządzenia różnych marek i protokołów w jedną platformę.
Dwa główne powody, by wybrać Home Assistant:

• Lokalna praca, suwerenność danych: Wszystkie dane pozostają na Twoim własnym serwerze — bez zależności od chmury. Urządzenia działają nawet przy braku internetu, a Twoje wzorce użytkowania i dane scen pozostają prywatne.
  
• Otwarty ekosystem, bogate wsparcie protokołów: Home Assistant obsługuje Zigbee, Wi-Fi, Matter, MQTT, Z-Wave i praktycznie każdy główny protokół inteligentnego domu — integrując urządzenia różnych marek w jednym interfejsie, aby tworzyć wspólne automatyzacje.

SONOFF oferuje szeroką gamę urządzeń: moduły do samodzielnego montażu, przełączniki ścienne, termostaty, zawory wodne, różne czujniki i inne. Aby udostępnić urządzenia SONOFF użytkownikom Home Assistant, SONOFF zapewnia wielościeżkowe integracje dla każdego protokołu i typu urządzenia.

Ten blog przeprowadzi Cię przez każdą metodę integracji i pomoże wybrać odpowiednią dla Twoich potrzeb.

1. Urządzenia Zigbee

Zigbee to niskomocowy protokół sieci mesh. Urządzenia SONOFF Zigbee obejmują różne czujniki (ruchu PIR, obecności człowieka, temperatury/wilgotności itp.), inteligentne przełączniki/gniazdka, przełączniki ścienne, termostaty i zawory wodne.

Istnieją trzy sposoby podłączenia urządzeń Zigbee do Home Assistant, obejmujące wszystko od „czystej lokalnej kontroli” po „synchronizację na dwóch platformach”.

1.1 Bezpośrednie połączenie Dongle

Jak to działa: Większość hostów Home Assistant nie ma wbudowanej funkcji radia Zigbee — potrzebny jest adapter Zigbee Dongle do wysyłania i odbierania sygnałów Zigbee. Seria SONOFF Dongle to flagowy produkt w tej dziedzinie.

Kompatybilne urządzenia: Prawie wszystkie urządzenia SONOFF Zigbee można podłączyć za pomocą Dongle.
Metoda integracji:

Po skonfigurowaniu Dongle w Home Assistant za pomocą integracji ZHA (Zigbee Home Automation) lub Zigbee2MQTT (Z2M), urządzenia SONOFF Zigbee są automatycznie wykrywane i dodawane jako encje w Home Assistant, gotowe do automatyzacji i scen.

• ZHA: Wbudowane w Home Assistant Core; prosta konfiguracja, odpowiednia dla większości użytkowników
  
• Zigbee2MQTT: Bogatsze funkcje, większa społeczność, obsługuje więcej typów urządzeń i opcji dostosowywania

*Jeśli nie jesteś pewien, który Dongle wybrać, sprawdź Przewodnik wyboru Dongle SONOFF:

https://sonoff.tech/blogs/news/sonoff-zigbee-thread-dongle-choosing-guide

*Szczegółowe kroki konfiguracji lub rozwiązywania problemów znajdziesz na dedykowanej stronie Dongle:

https://dongle.sonoff.tech/

⚠️ Ważne: Urządzenia Zigbee dodane przez Dongle pojawiają się tylko w Home Assistant — nie można nimi sterować z aplikacji eWeLink. Jeśli chcesz zarządzać urządzeniami zarówno z Home Assistant, jak i eWeLink, zobacz opcję Matter Bridge poniżej.

1.2 Synchronizacja Matter Bridge

Jak to działa: SONOFF ZBBridge-U (Zigbee Bridge Ultra) oraz NSPanel Pro to urządzenia z wbudowaną podwójną funkcjonalnością: brama Zigbee + Matter Bridge. Najpierw możesz dodać urządzenia Zigbee SONOFF do aplikacji eWeLink, a następnie zsynchronizować je z Home Assistant jako „lokalne urządzenia Matter” za pomocą protokołu Matter Bridge.

Dlaczego wybrać Matter Bridge?

• Sterowanie na dwóch platformach: Urządzeniami można zarządzać zarówno w aplikacji eWeLink (zdalne sterowanie, automatyzacja scen), jak i w Home Assistant
• Komunikacja lokalna: Po synchronizacji z Home Assistant urządzenia działają jako standardowe urządzenia Matter — komunikacja odbywa się całkowicie w sieci LAN, bez zależności od chmury
• Szerokie wsparcie urządzeń: Nie tylko urządzenia podrzędne Zigbee — synchronizuje także urządzenia Wi-Fi w sieci LAN oraz piloty scen eWeLink-Remote
  

Najlepsze dla:

• Użytkowników chcących sterować urządzeniami zarówno z poziomu Home Assistant, jak i eWeLink
• Użytkowników już znających ekosystem eWeLink, którzy nie chcą rezygnować z zdalnej kontroli przez aplikację

1.3 Synchronizacja MQTT

Najlepsze dla: Użytkowników zaznajomionych z integracją MQTT w Home Assistant, którzy potrzebują zachować funkcje i ustawienia urządzeń wykraczające poza standard Matter.
Protokół Matter definiuje ustandaryzowany zestaw funkcji urządzeń (np. włącz/wyłącz), ale niektóre urządzenia SONOFF mają rozszerzone funkcje specyficzne dla producenta. Funkcje te mogą być zachowane w trybie bezpośredniego połączenia MQTT, podczas gdy w trybie synchronizacji Matter Bridge mogą być uproszczone.

Uwaga: Integracja MQTT wymaga pewnej wiedzy konfiguracyjnej oraz NSPanel Pro lub ZBBridge-U.

*Szczegółowe kroki konfiguracji znajdziesz w:

https://sonoff.tech/blogs/news/how-to-sync-zigbee-sub-devices-to-home-assistant-via-mqtt

2. Urządzenia Wi-Fi

Urządzenia SONOFF Wi-Fi obejmują różne moduły retrofitowe, przełączniki ścienne, gniazdka i inne — rozmieszczone w całym domu, kontrolujące oświetlenie w różnych pomieszczeniach. W zależności od tego, czy urządzenie obsługuje protokół Matter, istnieją różne sposoby dodania ich do Home Assistant.

2.1 Urządzenia z certyfikatem Matter — bezpośrednie dodanie

Najlepsze dla: Urządzeń z certyfikatem Matter (sprawdź stronę produktu lub opakowanie pod kątem znaku Matter).

Matter to protokół interoperacyjności inteligentnego domu nowej generacji, rozwijany przez CSA (Connectivity Standards Alliance). Urządzenia z certyfikatem Matter mają przewagę „standaryzacji”: możliwości urządzenia są definiowane przez sam protokół, więc dodanie ich do dowolnej platformy zgodnej z Matter (Home Assistant, Apple Home, Google Home itp.) nie wymaga dodatkowych sterowników ani wtyczek.

Kroki konfiguracji:

1. Upewnij się, że integracja Matter jest zainstalowana w Home Assistant (dodaj ją przez „Ustawienia → Urządzenia i usługi”)

2. Otwórz aplikację eWeLink z przypisanym urządzeniem i potwierdź, że urządzenie jest online

3. W Home Assistant wyszukaj i dodaj urządzenie Matter, a następnie zeskanuj kod QR za pomocą aplikacji eWeLink, aby zakończyć parowanie

Po dodaniu urządzenie pojawia się w Home Assistant jako standardowe urządzenie Matter — wszystkie standardowe funkcje (stan przełącznika, regulacja jasności itp.) działają od razu.

*Oficjalna dokumentacja Matter dla Home Assistant: 

https://www.home-assistant.io/integrations/matter

2.2 Urządzenia bez Matter — synchronizacja przez Matter Bridge lub dodatek eWeLink

Najlepsze dla: Starszych modeli bez wsparcia oprogramowania Matter, gdzie nadal chcesz widzieć i kontrolować urządzenia z poziomu Home Assistant.

Te urządzenia można synchronizować z Home Assistant za pomocą Matter Bridge lub eWeLink Smart Home Add-on. Funkcjonalność Matter Bridge została opisana powyżej. Dodatek eWeLink Smart Home działa poprzez pobranie dodatku w Home Assistant i zalogowanie się na konto eWeLink — zsynchronizowane urządzenia pojawiają się jako karty encji w Home Assistant, obsługując podstawowe operacje, takie jak przełączanie włączników.

Szczegóły dodatku znajdziesz w:

https://github.com/iHost-Open-Source-Project/hassio-ihost-addon

3. Urządzenia eWeLink-Remote

eWeLink-Remote to lokalne rozwiązanie pilota scen SONOFF zaprojektowane dla aplikacji eWeLink. Typowe urządzenia to:

• R5: pilot wieloscenowy, obsługuje jednoczesne powiązanie wielu urządzeń lub scen
• S-mate2: przełącznik DIY, zaprojektowany do współpracy z zewnętrznymi przełącznikami

Teraz urządzenia eWeLink-Remote obsługują integrację z Home Assistant przez Matter Bridge — możesz używać ich jako lokalnych pilotów scen w Home Assistant.

Jak to działa: Użyj funkcji Matter Bridge na ZBBridge-U lub NSPanel Pro, aby zsynchronizować urządzenia eWeLink-Remote z Home Assistant, a następnie skonfiguruj lokalne automatyzacje wyzwalane przez pilota.

 

Nie ma jednego „właściwego rozwiązania” na połączenie urządzeń SONOFF z Home Assistant — zależy to od Twoich nawyków i priorytetów:

Jeśli zależy Ci na czystej, lokalnej, stabilnej i maksymalnej kontroli, najlepszym wyborem jest bezpośrednie połączenie Dongle;

Jeśli chcesz synergii między platformami Home Assistant i eWeLink, Matter Bridge zapewnia bardziej zrównoważone doświadczenie;

Dla użytkowników z pewnymi umiejętnościami DIY, którzy chcą zachować więcej rozszerzonych funkcji urządzeń, MQTT oferuje większą swobodę;

W międzyczasie, wraz z rozwojem ekosystemu Matter, coraz więcej urządzeń Wi-Fi może osiągnąć doświadczenie integracji „prosto po wyjęciu z pudełka” dzięki standaryzacji.

SONOFF będzie nadal wspierać ekosystem społeczności open-source, oferując Ci wygodniejsze i bardziej komfortowe inteligentne życie.