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

Wprowadzenie

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

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

Dla użytkowników Home Assistant oznacza to większy wybór sposobów integracji urządzeń: możesz łączyć je lokalnie przez 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.

Jak działa integracja MQTT z Home Assistant

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

Podstawowa architektura wygląda następująco:

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

Często zadawane pytania dotyczące integracji MQTT z Home Assistant

 

1. W jaki sposób MQTT łączy urządzenia SONOFF z Home Assistant?

Urządzenia SONOFF nie łączą się bezpośrednio z Home Assistant. Zamiast tego komunikują się z Home Assistant za pośrednictwem brokera MQTT.

┌───────────────┐
│ Urządzenie SONOFF │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│  Broker MQTT  │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Urządzenie / encja │
└─────────────────┘

Proces integracji można zatem podzielić na cztery etapy:

① Urządzenie SONOFF → broker MQTT

• Upewnij się, że urządzenie SONOFF może połączyć się z brokerem MQTT.

② Home Assistant → broker MQTT

• Upewnij się, że Home Assistant może połączyć się z brokerem MQTT.

③ MQTT Discovery

• Upewnij się, że Home Assistant może wykryć urządzenie SONOFF za pomocą MQTT Discovery.

④ Encja

• Upewnij się, że Home Assistant prawidłowo tworzy encje, może sterować urządzeniem i odczytywać jego stan.

Uwaga: Gdy urządzenie SONOFF wyświetla komunikat „MQTT Connected”, oznacza to tylko, że pomyślnie połączyło się z brokerem MQTT. Nie oznacza to, że Home Assistant pomyślnie się połączył lub wykrył urządzenie.

 

2. Etap 1: łączenie urządzenia SONOFF z brokerem MQTT

P1: Czy „MQTT Connected” oznacza, że moje urządzenie SONOFF pomyślnie połączyło się z Home Assistant?

Nie. „MQTT Connected” oznacza tylko, że urządzenie SONOFF pomyślnie połączyło się z brokerem MQTT.

Urządzenie SONOFF zazwyczaj nie może ustalić, czy Home Assistant jest online, czy Home Assistant jest połączony z brokerem ani czy urządzenie zostało już wykryte.

Pełna ścieżka komunikacji wygląda następująco:

Urządzenie SONOFF
     ↓
Broker MQTT        ✓
     ↓
Home Assistant     ?
     ↓
Automatyczne wykrywanie MQTT     ?
     ↓
Encja             ?

Jeśli urządzenie pokazuje Połączono z MQTT , ale nie pojawia się w Home Assistant, przejdź do etapów 2 i 3.

P2: Co należy sprawdzić, jeśli urządzenie SONOFF nie może połączyć się z brokerem MQTT?

Sprawdź kolejno następujące elementy:

1. Adres brokera MQTT

• Upewnij się, że adres brokera skonfigurowany w urządzeniu SONOFF jest prawidłowy.
  Na przykład: 192.168.1.100

2. Port MQTT

• Popularne porty MQTT to: 

• Upewnij się, że port skonfigurowany w urządzeniu SONOFF jest taki sam jak port, na którym nasłuchuje broker MQTT.

3. Nazwa użytkownika i hasło MQTT

Jeśli na brokerze włączono uwierzytelnianie, sprawdź:

• Nazwa użytkownika
• Hasło
• Czy konto jest wyłączone
• Czy uprawnienia ACL ograniczają konto

Jeśli nazwa użytkownika lub hasło są nieprawidłowe, urządzenie SONOFF może nie być w stanie nawiązać połączenia MQTT.

4. Połączenie sieciowe

• Upewnij się, że urządzenie SONOFF ma dostęp do brokera MQTT. Na przykład:

Urządzenie SONOFF
192.168.1.50
     ↓
Broker MQTT
192.168.1.100:1883

Po wprowadzeniu zmian w konfiguracji uruchom ponownie Home Assistant lub wczytaj ponownie integrację MQTT, a następnie sprawdź ponownie.

3. Etap 2: Łączenie Home Assistant z brokerem MQTT

P3: Moje urządzenie SONOFF pokazuje „Połączono z MQTT”, ale nie pojawia się w Home Assistant. Co należy sprawdzić?

Najpierw sprawdź, czy sam Home Assistant pomyślnie połączył się z brokerem MQTT.

Urządzenie SONOFF i Home Assistant to niezależne klienty MQTT:

              Broker MQTT
             /           \
            /             \
   Urządzenie SONOFF           HA
        |                   |
    Połączono           Połączono?

Pomyślne połączenie urządzenia SONOFF nie oznacza, że Home Assistant również jest połączony z brokerem MQTT.

P4: Jak sprawdzić, czy Home Assistant jest połączony z brokerem MQTT?

W Home Assistant przejdź do: Ustawienia → Urządzenia i usługi → MQTT → Skonfiguruj ponownie

Sprawdź, czy konfiguracja brokera MQTT jest prawidłowa, w tym:

• Adres IP brokera
• Nazwa użytkownika
• Hasło

Interfejs internetowy Home Assistant zwykle korzysta z portu 8123. Różni się on od portu MQTT. Często używany port MQTT to 1883.

P5: Czy urządzenie SONOFF OpenEdge i Home Assistant mogą korzystać z różnych brokerów MQTT?

Zazwyczaj automatyczne wykrywanie nie działa poprawnie, jeśli używają różnych brokerów MQTT. Na przykład:

Urządzenie SONOFF
     ↓
Broker A

Home Assistant
     ↓
Broker B

Ponieważ oba systemy są połączone z różnymi brokerami, Home Assistant nie może odbierać komunikatów MQTT publikowanych przez urządzenie SONOFF.

Typowa konfiguracja wygląda następująco:

Urządzenie SONOFF ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Etap 3: MQTT Discovery

P6: Urządzenie OpenEdge i Home Assistant są połączone z brokerem MQTT, ale urządzenie nadal nie pojawia się w Home Assistant. Co mam zrobić?

Na tym etapie sprawdź MQTT Discovery.

Urządzenie musi przekazywać Home Assistant informacje o urządzeniu i encjach za pośrednictwem MQTT Discovery.

• W Home Assistant przejdź do: Ustawienia → Urządzenia i usługi → MQTT → Konfiguruj → Konfiguruj opcje MQTT
• Sprawdź, czy włączono wykrywanie.
• Sprawdź też, czy prefiks wykrywania ma wartość domyślną: homeassistant

Jeśli wykrywanie było wyłączone, samo jego włączenie i zapisanie ustawień nie spowoduje natychmiastowego ponownego skanowania przez Home Assistant urządzeń MQTT, które są już połączone.

Uruchom ponownie Home Assistant lub kliknij „Przeładuj” w integracji MQTT, aby Home Assistant ponownie zasubskrybował temat wykrywania i rozpoznał urządzenia.

 

5. Problemy z prefiksem wykrywania

P8: Czym jest prefiks wykrywania?

Prefiks wykrywania to prefiks tematu używany przez funkcję MQTT Discovery w Home Assistant.

Home Assistant domyślnie używa następującej wartości: homeassistant

P9: Czy zmiana prefiksu wykrywania Home Assistant wpłynie na integrację urządzeń OpenEdge?

Tak. Na przykład, jeśli urządzenie używa domyślnego prefiksu: homeassistant

Jeśli jednak prefiks wykrywania Home Assistant został zmieniony na: myhome

Home Assistant będzie nasłuchiwać tematów wykrywania pod adresem: myhome/...

Ścieżka komunikacji wyglądałaby wtedy następująco:

Urządzenie
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
nasłuchuje na myhome/...

Ponieważ prefiksy się nie zgadzają, Home Assistant nie może prawidłowo wykryć urządzenia.

Zalecenie

• Ustaw prefiks wykrywania Home Assistant na: homeassistant
• Nie zmieniaj go.
• Jeśli prefiks został wcześniej zmieniony, a urządzenie stało się przez to niedostępne, przywrócenie wartości domyślnej nie usunie automatycznie starych encji ani nie spowoduje ponownego wykrycia urządzenia.
• W takim przypadku uruchom ponownie Home Assistant lub przeładuj integrację MQTT. Jeśli wcześniej wykryte encje nadal mają status „Niedostępna”, może być konieczne usunięcie starych encji i ponowne wykrycie urządzenia.

 

6. Problemy występujące w szczególnych środowiskach sieciowych

P11: Dlaczego MQTT działa w mojej sieci lokalnej, ale przestaje działać po przełączeniu się na sieć zewnętrzną?

Jeśli broker MQTT działa wyłącznie w lokalnej sieci domowej:

Urządzenie SONOFF
     ↓
192.168.1.100:1883
     ↓
Lokalna sieć domowa

Gdy urządzenie opuści tę sieć i połączy się z inną siecią LAN:

Urządzenie SONOFF
    x
192.168.1.100

Nie można już uzyskać dostępu do brokera za pomocą lokalnego adresu IP sieci LAN.

W przypadku dostępu z innej sieci rozważ:

• Broker MQTT z publicznym adresem IP

Uwaga dotycząca bezpieczeństwa: Nie zaleca się udostępniania niezabezpieczonego portu MQTT 1883 bezpośrednio w publicznym Internecie.

 

7. Częste problemy w środowiskach Docker

P12: Home Assistant działa w Dockerze. Dlaczego nie może połączyć się z brokerem MQTT, gdy używam localhost:1883?

Jeśli Home Assistant i broker MQTT działają w różnych kontenerach Docker, localhost zwykle odnosi się do kontenera Home Assistant, a nie do kontenera, w którym działa broker MQTT.

Na przykład:

┌─────────────────────┐
│ Host Docker         │
│                     │
│ ┌───────────────┐   │
│ │ Home Assistant│   │
│ │ localhost     │   │
│ └───────────────┘   │
│                     │
│ ┌───────────────┐   │
│ │ Mosquitto     │   │
│ │ Port 1883     │   │
│ └───────────────┘   │
│                     │
└─────────────────────┘

Dlatego wpisanie localhost:1883 w Home Assistant nie musi oznaczać połączenia z Mosquitto.

Zalecana konfiguracja

Jeśli nie znasz konfiguracji sieci Docker, zalecamy wpisanie lokalnego adresu IP hosta, na którym działa broker MQTT. Na przykład:

Broker MQTT:
192.168.1.100

Port:
1883

Zastąp 192.168.1.100 rzeczywistym adresem IP hosta, na którym działa broker MQTT.

Jeśli Home Assistant i Mosquitto są podłączone do tej samej sieci Docker, możesz też użyć nazwy kontenera Mosquitto, na przykład: mosquitto:1883

Uwaga: Nazwy kontenerów, takie jak mosquitto, można używać tylko w obrębie odpowiedniej sieci Docker. Urządzenia SONOFF powinny zazwyczaj używać adresu IP lub nazwy domenowej hosta, na którym działa broker MQTT, zamiast nazwy kontenera Docker.

Po wprowadzeniu zmian uruchom ponownie kontener Home Assistant lub przeładuj integrację MQTT, aby zastosować nową konfigurację.