So integrieren Sie SONOFF-OpenEdge-Geräte über MQTT in Home Assistant

Einführung

SONOFF führt OpenEdge ein, eine Local-First-Architektur für Smart-Geräte der nächsten Generation, die Ihnen mehr lokale Kontrolle, breitere Interoperabilität und flexiblere Möglichkeiten bieten soll, Ihre Geräte über verschiedene Plattformen und Ökosysteme hinweg zu verbinden.

Mit OpenEdge können unterstützte SONOFF-Geräte lokal über offene Schnittstellen wie HTTP, MQTT und WebSocket kommunizieren.

Für Home-Assistant-Nutzer bedeutet das mehr Auswahl bei der Integration ihrer Geräte: Sie können sie über MQTT lokal verbinden, wenn Sie lokale Steuerung und eine flexible Integration in verschiedene Ökosysteme bevorzugen, während die Cloud-Verbindung weiterhin verfügbar bleibt, wenn sie besser zu Ihren Anforderungen passt.

So funktioniert die MQTT-Integration mit Home Assistant

Bevor Sie MQTT konfigurieren, ist es hilfreich zu verstehen, wie die Verbindung funktioniert.

Die grundlegende Architektur sieht so aus:

OpenEdge-fähiges SONOFF-Gerät → MQTT-Broker → Home Assistant

Häufig gestellte Fragen zur MQTT-Integration mit Home Assistant

 

1. Wie verbindet MQTT SONOFF-Geräte mit Home Assistant?

SONOFF-Geräte verbinden sich nicht direkt mit Home Assistant. Stattdessen kommunizieren sie über einen MQTT-Broker mit Home Assistant.

┌───────────────┐
│ SONOFF-Gerät │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│ MQTT-Broker │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Gerät / Entität │
└─────────────────┘

Der Integrationsprozess lässt sich daher in vier Phasen unterteilen:

① SONOFF-Gerät → MQTT-Broker

• Stellen Sie sicher, dass das SONOFF-Gerät eine Verbindung zum MQTT-Broker herstellen kann.

② Home Assistant → MQTT-Broker

• Stellen Sie sicher, dass Home Assistant eine Verbindung zum MQTT-Broker herstellen kann.

③ MQTT Discovery

• Stellen Sie sicher, dass Home Assistant das SONOFF-Gerät über MQTT Discovery erkennen kann.

④ Entität

• Stellen Sie sicher, dass Home Assistant die Entitäten korrekt erstellt und das Gerät steuern sowie seinen Status auslesen kann.

Hinweis: Wenn bei einem SONOFF-Gerät „MQTT verbunden“ angezeigt wird, bedeutet das lediglich, dass das Gerät erfolgreich eine Verbindung zum MQTT-Broker hergestellt hat. Es bedeutet nicht, dass Home Assistant erfolgreich eine Verbindung hergestellt oder das Gerät erkannt hat.

 

2. Phase 1: SONOFF-Gerät mit dem MQTT-Broker verbinden

F1: Bedeutet „MQTT verbunden“, dass mein SONOFF-Gerät erfolgreich mit Home Assistant verbunden ist?

Nein. „MQTT verbunden“ bedeutet lediglich, dass das SONOFF-Gerät erfolgreich eine Verbindung zum MQTT-Broker hergestellt hat.

Das SONOFF-Gerät kann im Allgemeinen nicht feststellen, ob Home Assistant online ist, ob Home Assistant mit dem Broker verbunden ist oder ob das Gerät bereits erkannt wurde.

Der vollständige Kommunikationspfad lautet:

SONOFF-Gerät
     ↓
MQTT-Broker        ✓
     ↓
Home Assistant     ?
     ↓
MQTT-Erkennung     ?
     ↓
Entität             ?

Wenn das Gerät MQTT verbunden anzeigt, aber nicht in Home Assistant erscheint, fahren Sie mit den Phasen 2 und 3 fort.

F2: Was sollte ich überprüfen, wenn mein SONOFF-Gerät keine Verbindung zum MQTT-Broker herstellen kann?

Überprüfen Sie die folgenden Punkte der Reihe nach:

1. MQTT-Broker-Adresse

• Stellen Sie sicher, dass die auf dem SONOFF-Gerät konfigurierte Broker-Adresse korrekt ist.
  Zum Beispiel: 192.168.1.100

2. MQTT-Port

• Zu den gängigen MQTT-Ports gehören: 

• Stellen Sie sicher, dass der auf dem SONOFF-Gerät konfigurierte Port mit dem Port übereinstimmt, auf dem der MQTT-Broker tatsächlich lauscht.

3. MQTT-Benutzername und Passwort

Wenn die Authentifizierung auf dem Broker aktiviert ist, überprüfen Sie:

• Benutzername
• Passwort
• Ob das Konto deaktiviert ist
• Ob ACL-Berechtigungen das Konto einschränken

Wenn Benutzername oder Passwort falsch sind, kann das SONOFF-Gerät möglicherweise keine MQTT-Verbindung herstellen.

4. Netzwerkverbindung

• Stellen Sie sicher, dass das SONOFF-Gerät den MQTT-Broker erreichen kann. Zum Beispiel:

SONOFF-Gerät
192.168.1.50
     ↓
MQTT-Broker
192.168.1.100:1883

Wenn Sie Konfigurationsänderungen vornehmen, starten Sie Home Assistant neu oder laden Sie die MQTT-Integration erneut, bevor Sie die Verbindung nochmals überprüfen.

3. Phase 2: Home Assistant mit dem MQTT-Broker verbinden

F3: Mein SONOFF-Gerät zeigt „MQTT verbunden“ an, erscheint aber nicht in Home Assistant. Was sollte ich überprüfen?

Überprüfen Sie zunächst, ob Home Assistant selbst erfolgreich mit dem MQTT-Broker verbunden ist.

Das SONOFF-Gerät und Home Assistant sind unabhängige MQTT-Clients:

              MQTT-Broker
             /           \
            /             \
   SONOFF-Gerät           HA
        |                   |
    Verbunden           Verbunden?

Eine erfolgreiche Verbindung des SONOFF-Geräts bedeutet nicht, dass Home Assistant ebenfalls mit dem MQTT-Broker verbunden ist.

F4: Wie kann ich überprüfen, ob Home Assistant mit dem MQTT-Broker verbunden ist?

Gehen Sie in Home Assistant zu: Einstellungen → Geräte & Dienste → MQTT → Neu konfigurieren

Überprüfen Sie, ob die MQTT-Broker-Konfiguration korrekt ist, einschließlich:

• IP-Adresse des Brokers
• Benutzername
• Passwort

Die Weboberfläche von Home Assistant verwendet üblicherweise den Port 8123. Dieser unterscheidet sich vom MQTT-Port. Ein häufig verwendeter MQTT-Port ist 1883.

F5: Können das SONOFF OpenEdge-Gerät und Home Assistant unterschiedliche MQTT-Broker verwenden?

Normalerweise funktioniert die automatische Erkennung nicht richtig, wenn sie unterschiedliche MQTT-Broker verwenden. Zum Beispiel:

SONOFF-Gerät
     ↓
Broker A

Home Assistant
     ↓
Broker B

Da die beiden Systeme mit unterschiedlichen Brokern verbunden sind, kann Home Assistant die vom SONOFF-Gerät veröffentlichten MQTT-Nachrichten nicht empfangen.

Die übliche Einrichtung sieht so aus:

SONOFF-Gerät ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Phase 3: MQTT Discovery

F6: OpenEdge-Gerät und Home Assistant sind beide mit dem MQTT-Broker verbunden, aber das Gerät wird in Home Assistant weiterhin nicht angezeigt. Was soll ich tun?

Prüfen Sie jetzt MQTT Discovery.

Das Gerät muss Home Assistant über MQTT Discovery Geräte- und Entitätsinformationen bereitstellen.

• Gehen Sie in Home Assistant zu: Einstellungen → Geräte & Dienste → MQTT → Konfigurieren → MQTT-Optionen konfigurieren
• Prüfen Sie, ob Discovery aktivieren aktiviert ist.
• Prüfen Sie außerdem, ob das Discovery-Präfix auf den Standardwert gesetzt ist: homeassistant

Wenn Discovery deaktiviert war, führt das Aktivieren und Speichern der Einstellungen nicht dazu, dass Home Assistant bereits verbundene MQTT-Geräte sofort erneut scannt.

Bitte starten Sie Home Assistant neu oder klicken Sie in der MQTT-Integration auf „Neu laden“, damit Home Assistant das Discovery-Topic erneut abonnieren und die Geräte erkennen kann.

 

5. Probleme mit dem Discovery-Präfix

F8: Was ist das Discovery-Präfix?

Das Discovery-Präfix ist das Topic-Präfix, das von Home Assistant MQTT Discovery verwendet wird.

Home Assistant verwendet standardmäßig den folgenden Wert: homeassistant

F9: Wirkt sich eine Änderung des Home Assistant Discovery-Präfixes auf die OpenEdge-Geräteintegration aus?

Ja. Wenn das Gerät beispielsweise das Standardpräfix verwendet: homeassistant

Wenn das Home Assistant Discovery-Präfix jedoch auf Folgendes geändert wurde: myhome

Home Assistant lauscht auf Discovery-Topics unter: myhome/...

Der Kommunikationsweg sähe dann so aus:

Gerät
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
lauscht auf myhome/...

Da die beiden Präfixe nicht übereinstimmen, kann Home Assistant das Gerät nicht korrekt erkennen.

Empfehlung

• Das Home Assistant Discovery-Präfix auf Folgendes setzen: homeassistant
• Nicht ändern.
• Wenn das Präfix zuvor geändert wurde und dadurch das Gerät nicht mehr verfügbar war, werden durch das Zurücksetzen auf den Standardwert alte Entitäten nicht automatisch entfernt und das Gerät wird nicht neu erkannt.
• Starten Sie in diesem Fall Home Assistant neu oder laden Sie die MQTT-Integration neu. Wenn zuvor erkannte Entitäten weiterhin als „Nicht verfügbar“ angezeigt werden, müssen Sie möglicherweise die alten Entitäten löschen und das Gerät erneut erkennen lassen.

 

6. Besondere Probleme in Netzwerkumgebungen

F11: Warum funktioniert MQTT in meinem lokalen Netzwerk, aber nicht mehr, wenn ich zu einem externen Netzwerk wechsle?

Wenn der MQTT-Broker nur in Ihrem lokalen Heimnetzwerk bereitgestellt ist:

SONOFF-Gerät
     ↓
192.168.1.100:1883
     ↓
Lokales Heimnetzwerk

Sobald das Gerät dieses Netzwerk verlässt und sich in einem anderen LAN befindet:

SONOFF-Gerät
    x
192.168.1.100

Der Zugriff auf den Broker über die LAN-IP-Adresse ist nicht mehr möglich.

Für den Zugriff über verschiedene Netzwerke hinweg sollten Sie Folgendes beachten:

• MQTT-Broker mit öffentlicher IP-Adresse

Sicherheitshinweis: Es wird nicht empfohlen, einen unverschlüsselten MQTT-Port 1883 direkt dem öffentlichen Internet zugänglich zu machen.

 

7. Häufige Probleme in Docker-Umgebungen

F12: Home Assistant läuft in Docker. Warum kann keine Verbindung zum MQTT-Broker hergestellt werden, wenn ich localhost:1883 verwende?

Wenn Home Assistant und der MQTT-Broker in verschiedenen Docker-Containern laufen, verweist localhost normalerweise auf den Home-Assistant-Container und nicht auf den Container, in dem der MQTT-Broker läuft.

Zum Beispiel:

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

Wenn Sie daher in Home Assistant localhost:1883 eingeben, wird dadurch nicht unbedingt eine Verbindung zu Mosquitto hergestellt.

Empfohlene Konfiguration

Wenn Sie mit der Konfiguration von Docker-Netzwerken nicht vertraut sind, empfiehlt es sich, die lokale Netzwerk-IP-Adresse des Hosts einzugeben, auf dem der MQTT-Broker läuft. Zum Beispiel:

MQTT-Broker:
192.168.1.100

Port:
1883

Ersetzen Sie 192.168.1.100 durch die tatsächliche IP-Adresse des Hosts, auf dem der MQTT-Broker läuft.

Wenn Home Assistant und Mosquitto mit demselben Docker-Netzwerk verbunden sind, können Sie auch den Namen des Mosquitto-Containers verwenden, zum Beispiel: mosquitto:1883

Hinweis: Ein Containername wie mosquitto kann nur innerhalb des entsprechenden Docker-Netzwerks verwendet werden. SONOFF-Geräte sollten im Allgemeinen die IP-Adresse oder den Domainnamen des Hosts verwenden, auf dem der MQTT-Broker läuft, und nicht den Namen des Docker-Containers.

Nachdem Sie Änderungen vorgenommen haben, starten Sie den Home-Assistant-Container neu oder laden Sie die MQTT-Integration neu, um die neue Konfiguration anzuwenden.