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ę nowej generacji inteligentnych urządzeń, stawiającą na lokalne działanie 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, w tym HTTP, MQTT i WebSocket.

Dla użytkowników Home Assistant oznacza to większy wybór sposobu integracji urządzeń: możesz połą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

Zanim rozpoczniesz konfigurowanie 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 komunikatów 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 wybierany jest Mosquitto.
  • Home Assistant — łączy się z tym samym brokerem za pośrednictwem integracji MQTT, odbiera aktualizacje urządzeń, 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 o wykrywaniu, 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.




Konfiguracja urządzeń OpenEdge z Home Assistant za pośrednictwem MQTT

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

Co będzie potrzebne

Zanim zaczniesz, upewnij się, że masz:
  • Urządzenie SONOFF z obsługą OpenEdge i MQTT.
  • Zainstalowano i uruchomiono Home Assistant.
  • Zainstalowano i uruchomiono brokera MQTT.
  • 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, popularnym rozwiązaniem dla Home Assistant jest oficjalna aplikacja brokera Mosquitto MQTT.
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 ZAINSTALUJ.
  • 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 osobnego użytkownika Home Assistant dla urządzeń MQTT w sekcji Ustawienia → Osoby → Użytkownicy.

Więcej informacji na temat wyboru 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 uruchomieniu. Gdy dioda LED mignie dwa razy krótko, a następnie raz długo, jego hotspot AP jest gotowy do konfiguracji. 

Krok 2: Uzyskiwanie dostępu do konsoli internetowej OpenEdge

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

Metoda 1: Dostęp przez hotspot AP — zalecane 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 składające się z co najmniej 8 znaków.
    Zaloguj się, aby wejść do konsoli internetowej OpenEdge.

W konsoli internetowej możesz zarządzać funkcjami lokalnymi, w tym sterowaniem WŁ./WYŁ., historycznymi danymi dotyczącymi energii, zegarami, parowaniem Matter, ustawieniami sieci, konfiguracją AP/Wi-Fi, aktualizacjami OTA oraz 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 ma dostęp do tej samej 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 się komunikować przez sieć lokalną.

  • Przejdź do Ustawienia sieci → Ustawienia Wi-Fi.
  • Wybierz sieć Wi-Fi, do której masz dostęp z Home Assistant i brokera MQTT.
  • Wprowadź hasło Wi-Fi.
  • Kliknij Zapisz.
  • Poczekaj, aż urządzenie nawiąże połączenie.

Po połączeniu urządzenia z siecią lokalną router zazwyczaj przydzieli mu lokalny adres IP przez DHCP. Adres ten jest wyświetlany w ustawieniach Wi-Fi i można go użyć do późniejszego dostępu do konsoli internetowej przez LAN, zgodnie z opisem w powyższej Metodzie 2.

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 do pierwszej konfiguracji przestaje być dostępny.

Jeśli hotspot AP zniknie przed ukoń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 włączyć tryb 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ą Twojemu brokerowi

Powiadomienia o stanie RPC przez MQTT

Włączaj lub wyłączaj w razie potrzeby


Wskazówki:
  • Pole Serwer powinno wskazywać na brokera MQTT. Jeśli broker Mosquitto działa na tym samym hoście co Home Assistant, zazwyczaj jest to adres IP hosta Home Assistant z portem MQTT 1883, na przykład: 192.168.1.242:1883. 
  • Jeśli korzystasz z oficjalnego brokera Mosquitto w Home Assistant i nie utworzono osobnych danych logowania 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: Sprawdź urządzenie i steruj nim w Home Assistant

  • Po zapisaniu ustawień MQTT połącz ponownie 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 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 modelu MINI-1GSP są to między innymi następujące funkcje:
    • Sterowanie przekaźnikiem
    • Natężenie prądu
    • Napięcie
    • Moc
    • Częstotliwość
    • Dane energetyczne

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

MINI-1GSP to pierwszy produkt SONOFF obsługujący OpenEdge.
Wkrótce pojawią się kolejne urządzenia obsługujące OpenEdge, w tym:

  • MINI-1GP
  • MINI-1GS
  • MINI-1GS10

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

  • Inteligentne przełączniki — bardziej elastyczne lokalne sterowanie i integracja za pośrednictwem otwartych interfejsów.
  • Produkty do zarządzania energią — lokalne przetwarzanie danych i bardziej przejrzyste monitorowanie energii.
  • Inne inteligentne urządzenia — łączenie z większą liczbą platform i ekosystemów dzięki otwartym możliwościom integracyjnym OpenEdge.

Aby sprawdzić najnowsze obsługiwane urządzenia i funkcje dostępne po integracji z Home Assistant, zobacz [Listę obsługiwanych funkcji Home Assistant dla urządzeń SONOFF OpenEdge].  



Podsumowanie

SONOFF OpenEdge ułatwia integrację z Home Assistant, zapewniając większą lokalność i elastyczność. Dzięki wbudowanej konsoli internetowej oraz ustandaryzowanemu lokalnemu interfejsowi API OpenEdge opartemu na 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ą automatyzację bez polegania na chmurze w ramach integracji.



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.