Product Guides

Jak zintegrować urządzenia SONOFF OpenEdge z Home Assistant za pomocą MQTT

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT


Wprowadzenie

SONOFF wprowadza OpenEdge — architekturę dla inteligentnych urządzeń nowej generacji, stawiającą na działanie lokalne i zaprojektowaną z myślą o zapewnieniu większej kontroli lokalnej, szerszej interoperacyjności oraz bardziej elastycznych sposobów łączenia urządzeń z różnymi platformami i ekosystemami.

Dzięki OpenEdge obsługiwane urządzenia SONOFF mogą komunikować się lokalnie za pośrednictwem otwartych interfejsów, takich jak HTTP, MQTT i WebSocket.

Dla użytkowników Home Assistant oznacza to większy wybór sposobu integracji urządzeń: możesz łączyć je lokalnie za pośrednictwem MQTT, gdy zależy Ci na lokalnym sterowaniu i elastycznej integracji z ekosystemem, a łączność z chmurą pozostaje dostępna, gdy lepiej odpowiada Twoim potrzebom.

W tym przewodniku dowiesz się, jak zintegrować urządzenia SONOFF z obsługą OpenEdge z Home Assistant za pośrednictwem MQTT, korzystając ze szczegółowej konfiguracji krok po kroku.



Jak działa integracja MQTT z Home Assistant

Przed rozpoczęciem konfiguracji MQTT warto zrozumieć, jak działa to połączenie.

Podstawowa architektura wygląda następująco:

Urządzenie SONOFF z obsługą OpenEdge → Broker MQTT → Home Assistant

Urządzenie SONOFF nie łączy się bezpośrednio z Home Assistant. Zamiast tego zarówno urządzenie, jak i Home Assistant łączą się z tym samym brokerem MQTT, który pełni funkcję centrum komunikacji między nimi.
  • Urządzenie SONOFF z obsługą OpenEdge — łączy się z brokerem jako klient MQTT, publikuje stany i dane urządzenia oraz odbiera polecenia sterujące.
  • Broker MQTT — odbiera i rozsyła wiadomości MQTT między połączonymi klientami. W konfiguracjach Home Assistant często wybieranym rozwiązaniem jest Mosquitto.
  • Home Assistant — łączy się z tym samym brokerem za pośrednictwem integracji MQTT, odbiera aktualizacje urządzenia, wysyła polecenia i zarządza urządzeniem w Home Assistant.
Urządzenia SONOFF z obsługą OpenEdge i MQTT natywnie obsługują funkcję MQTT Discovery. Po połączeniu urządzenia z brokerem publikuje ono wymagane informacje wykrywania, dzięki czemu Home Assistant może automatycznie utworzyć obsługiwane urządzenie i encje bez ręcznej konfiguracji tematów MQTT ani pisania kodu YAML.



Konfigurowanie urządzeń OpenEdge z Home Assistant za pomocą MQTT

Skonfigurujmy teraz integrację MQTT. W tym przewodniku jako przykład wykorzystano SONOFF MINI-1GSP, ale ten sam podstawowy proces można zastosować do innych zgodnych urządzeń OpenEdge z obsługą MQTT. 

Co będzie potrzebne

Przed rozpoczęciem upewnij się, że masz:
  • Urządzenie SONOFF z obsługą OpenEdge i MQTT.
  • Home Assistant jest zainstalowany i działa.
  • Broker MQTT jest zainstalowany i działa.
  • Integracja MQTT została dodana i połączona z brokerem w Home Assistant. 

Zainstaluj i skonfiguruj brokera MQTT

Jeśli nie masz jeszcze brokera MQTT, popularną opcją dla Home Assistant jest oficjalna aplikacja brokera MQTT Mosquitto.
Aby zainstalować go w Home Assistant: 
  • Otwórz Home Assistant.
  • Przejdź do Ustawienia → Aplikacje (wcześniej nazywane dodatkami) → Zainstaluj aplikację.
  • Wyszukaj broker Mosquitto i kliknij INSTALUJ.
  • Po zainstalowaniu uruchom aplikację brokera Mosquitto.
  • Zaleca się włączenie opcji Uruchamiaj przy starcie i Watchdog, aby broker uruchamiał się automatycznie wraz z Home Assistant i mógł zostać ponownie uruchomiony w razie nieoczekiwanego zatrzymania.
  • W razie potrzeby utwórz dedykowanego użytkownika Home Assistant dla urządzeń MQTT w sekcji Ustawienia → Osoby → Użytkownicy.

Więcej informacji o wyborze i konfiguracji brokera MQTT znajdziesz w oficjalnym przewodniku konfiguracji brokera Home Assistant. 

Dodaj integrację MQTT w Home Assistant

  1. W Home Assistant przejdź do Ustawienia → Urządzenia i usługi → Dodaj integrację.
  2. Wyszukaj MQTT i dokończ konfigurację.
  3. Przejdź do Ustawienia → Urządzenia i usługi → MQTT, aby potwierdzić, że integracja jest połączona z brokerem.

Krok 1: Włącz urządzenie

W przypadku MINI-1GSP urządzenie automatycznie przechodzi w tryb parowania przy pierwszym włączeniu. Gdy dioda LED miga dwa razy krótko, a następnie raz długo, hotspot AP jest gotowy do konfiguracji. 

Krok 2: Uzyskaj dostęp do konsoli internetowej OpenEdge

Istnieją dwa sposoby uzyskania dostępu do konsoli internetowej.

Metoda 1: Dostęp przez hotspot AP — zalecana przy pierwszej konfiguracji

  • Otwórz ustawienia Wi‑Fi na komputerze, tablecie lub urządzeniu mobilnym.
  • Połącz się z hotspotem urządzenia: SONOFF_1GSP_xxxx.

  • Otwórz przeglądarkę internetową i przejdź do: http://192.168.33.1
  • Otworzy się strona logowania do konsoli internetowej. Przy pierwszym dostępie utwórz hasło logowania o długości co najmniej 8 znaków.
    Zaloguj się, aby przejść do konsoli internetowej OpenEdge.

W konsoli internetowej możesz zarządzać funkcjami lokalnymi, w tym sterowaniem WŁ./WYŁ., historycznymi danymi dotyczącymi energii, timerami, parowaniem Matter, ustawieniami sieci, konfiguracją AP/Wi-Fi, aktualizacjami OTA i sekcją Informacje o OpenEdge.

W sekcji Ustawienia łączności możesz skonfigurować łączność z chmurą , MQTT dla Home Assistant, opcje TLS oraz wychodzące połączenia WebSocket z platformami innych firm.  

Metoda 2: Dostęp przez LAN

Jeśli urządzenie jest już połączone z siecią lokalną, możesz uzyskać bezpośredni dostęp do konsoli internetowej bez łączenia się z jego hotspotem AP.  
W przypadku MINI-1GSP otwórz przeglądarkę na urządzeniu, które może połączyć się z tą samą siecią LAN, i wpisz w niej jeden z poniższych adresów:

  • MINI-1GSP.local
  • Lokalny adres IP urządzenia.

Krok 3: Połącz urządzenie z siecią Wi-Fi

Połącz urządzenie z siecią Wi-Fi, która ma dostęp zarówno do Home Assistant, jak i brokera MQTT, aby mogły komunikować się za pośrednictwem sieci lokalnej.

  • Przejdź do Ustawienia sieci → Ustawienia Wi-Fi.
  • Wybierz sieć Wi-Fi, do której dostęp mają Home Assistant i broker MQTT.
  • Wprowadź hasło do Wi-Fi.
  • Kliknij Zapisz.
  • Poczekaj, aż urządzenie się połączy.

Po połączeniu urządzenia z siecią lokalną router zazwyczaj przydziela mu lokalny adres IP za pośrednictwem DHCP. Adres ten jest wyświetlany w ustawieniach Wi-Fi i może być używany później do dostępu przez LAN do konsoli internetowej, zgodnie z opisem w Metodzie 2 powyżej.

Uwaga: limit czasu hotspotu AP

MINI-1GSP automatycznie opuszcza tryb parowania po około 10 minutach. Po zakończeniu trybu parowania hotspot AP używany podczas pierwszej konfiguracji nie jest już dostępny.

Jeśli hotspot AP zniknie przed zakończeniem konfiguracji:

  1. Jeśli urządzenie jest już połączone z siecią lokalną, kontynuuj konfigurację za pomocą opisanej powyżej metody dostępu przez LAN.
  2. Jeśli ponownie chcesz użyć hotspotu AP, naciśnij i przytrzymaj przycisk urządzenia przez 5 sekund, aby ponownie przejść do trybu parowania.
  3. Połącz się ponownie z SONOFF_1GSP_xxxx, otwórz http://192.168.33.1 i kontynuuj konfigurację.

Wskazówka: Naciśnięcie i przytrzymanie przycisku urządzenia przez 10 sekund przywraca ustawienia fabryczne.

Krok 4: Włącz MQTT i skonfiguruj parametry

  • Przejdź do Ustawienia łączności → MQTT.
  • Włącz MQTT.
  • Skonfiguruj parametry MQTT zgodnie z poniższym przykładem
  • Po zakończeniu konfiguracji kliknij Zapisz.

Przykład konfiguracji MQTT w konsoli internetowej urządzenia:

Ustawienie

Co wprowadzić

Serwer

Adres i port brokera MQTT, np. 192.168.1.242:1883

Nazwa użytkownika

Nazwa użytkownika brokera MQTT

Hasło

Hasło brokera MQTT

Typ połączenia

Wybierz opcję TLS odpowiadającą konfiguracji brokera

Powiadomienia o stanie RPC przez MQTT

Włącz lub wyłącz w zależności od potrzeb

Wskazówki:
  • Pole Serwer powinno wskazywać Twój broker MQTT. Jeśli broker Mosquitto działa na tym samym hoście co Home Assistant, jest to zazwyczaj adres IP hosta Home Assistant z portem MQTT 1883, na przykład: 192.168.1.242:1883. 
  • Jeśli korzystasz z oficjalnego brokera Mosquitto Home Assistant i nie utworzono osobnych danych uwierzytelniających MQTT (nazwy użytkownika i hasła), możesz użyć istniejącej nazwy użytkownika i hasła Home Assistant.
  • Jeśli Mosquitto jest już skonfigurowane z nazwą użytkownika i hasłem, wprowadź tę samą nazwę użytkownika i hasło w ustawieniach MQTT konsoli internetowej urządzenia.

Krok 5: Weryfikacja urządzenia i sterowanie nim w Home Assistant

  • Po zapisaniu ustawień MQTT ponownie połącz komputer, tablet lub urządzenie mobilne z siecią lokalną, która ma dostęp do Home Assistant i brokera MQTT.
  • Otwórz Home Assistant i przejdź do Ustawienia → Urządzenia i usługi → MQTT  

Urządzenie powinno już pojawić się na liście urządzeń MQTT. Urządzenia SONOFF obsługujące OpenEdge i MQTT natywnie publikują informacje MQTT Discovery dla Home Assistant, dzięki czemu Home Assistant może automatycznie dodać urządzenie i utworzyć obsługiwane przez nie encje bez ręcznej konfiguracji tematów MQTT ani YAML.

  • Otwórz stronę urządzenia, aby wyświetlić dostępne elementy sterujące i encje. W przypadku MINI-1GSP obejmują one między innymi takie funkcje jak:
    • Sterowanie przekaźnikiem
    • Natężenie prądu
    • Napięcie
    • Moc
    • Częstotliwość
    • Dane dotyczące energii

Następnie możesz dodać te encje do pulpitu Home Assistant lub używać ich w automatyzacjach i scenach.


 

Urządzenia obsługujące OpenEdge

Następujące produkty SONOFF obecnie obsługują OpenEdge:

Wkrótce pojawią się kolejne urządzenia obsługujące OpenEdge, w tym:

  • MINI-1GS
  • MINI-1GS10
  • ……

OpenEdge będzie również stopniowo obejmować kolejne kategorie produktów SONOFF, w tym:

  • Inteligentne przełączniki — zapewniające bardziej elastyczne sterowanie lokalne i integrację za pośrednictwem otwartych interfejsów.
  • Produkty do zarządzania energią — zapewnianie lokalnego przetwarzania danych i bardziej przejrzystego monitorowania energii.
  • Inne inteligentne urządzenia — łączenie z większą liczbą platform i ekosystemów dzięki otwartym możliwościom integracji OpenEdge.

👉 Aby sprawdzić najnowszą listę obsługiwanych urządzeń i funkcje dostępne po integracji z Home Assistant, zobacz Listę obsługiwanych funkcji Home Assistant dla urządzeń SONOFF OpenEdge.  



Podsumowanie

SONOFF OpenEdge upraszcza integrację z Home Assistant, zapewniając większą lokalność i elastyczność. Dzięki wbudowanej Konsoli internetowej oraz ustandaryzowanemu lokalnemu interfejsowi API OpenEdge przez MQTT obsługiwane urządzenia SONOFF można konfigurować bezpośrednio w przeglądarce i integrować lokalnie z Home Assistant — zapewniając prostą konfigurację, szybką lokalną kontrolę i bardziej elastyczną automatykę bez korzystania z chmury w ramach ścieżki integracji.


 

 

Najczęściej zadawane pytania

P: Czy OpenEdge wymaga chmury?

Niekoniecznie. OpenEdge opiera się na architekturze lokalnej, umożliwiającej konfigurowanie, sterowanie i integrowanie obsługiwanych urządzeń za pośrednictwem lokalnej Konsoli internetowej oraz ustandaryzowanego lokalnego interfejsu API w sieci lokalnej.

Łączność z chmurą nie jest wymagana do korzystania z tych lokalnych funkcji, ale pozostaje dostępna jako opcjonalne rozszerzenie funkcji i usług, które korzystają z dostępu do chmury.

 

P: Czy urządzenia SONOFF OpenEdge mogą współpracować z Home Assistant, gdy internet jest niedostępny?

Tak. W przypadku opisanej w tym przewodniku konfiguracji Home Assistant MQTT urządzenie SONOFF, broker MQTT i Home Assistant muszą pozostać osiągalne w sieci lokalnej.

Dopóki sieć LAN i broker MQTT pozostają dostępne, urządzenie może nadal komunikować się lokalnie z Home Assistant bez aktywnego połączenia z internetem.

 

P: Czy do skonfigurowania MQTT z Home Assistant potrzebuję aplikacji eWeLink lub konta eWeLink?

Nie. W przypadku opisanej w tym przewodniku lokalnej integracji MQTT możesz uzyskać bezpośredni dostęp do Konsoli internetowej OpenEdge z poziomu przeglądarki, bez korzystania z aplikacji eWeLink ani konta eWeLink.

Podczas wstępnej konfiguracji możesz uzyskać dostęp do Konsoli internetowej za pośrednictwem punktu dostępowego AP urządzenia. Po dołączeniu urządzenia do sieci lokalnej możesz również uzyskać do niej dostęp przez sieć LAN, używając lokalnej nazwy hosta lub adresu IP.

Z poziomu Konsoli internetowej możesz bezpośrednio skonfigurować sieć urządzenia i połączenie MQTT. Łączność z chmurą eWeLink pozostaje dostępna oddzielnie, jeśli zdecydujesz się z niej korzystać.



Czytaj dalej

home assistant zigbee dongle
SONOFF OpenEdge Devices: Home Assistant Feature Support

Zostaw komentarz

Wszystkie komentarze są moderowane przed opublikowaniem.

Ta strona jest chroniona przez hCaptcha i obowiązują na niej Polityka prywatności i Warunki korzystania z usługi serwisu hCaptcha.