Product Guides

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

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT


Einführung

SONOFF führt OpenEdge ein, eine Local-First-Architektur für Smart-Home-Geräte der nächsten Generation, die Ihnen mehr lokale Kontrolle, umfassendere Interoperabilität und flexiblere Möglichkeiten bietet, Ihre Geräte plattform- und ökosystemübergreifend 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 dies 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-Konnektivität weiterhin verfügbar ist, wenn sie besser zu Ihren Anforderungen passt.

In dieser Anleitung erfahren Sie, wie Sie OpenEdge-fähige SONOFF-Geräte über MQTT Schritt für Schritt in Home Assistant integrieren.



So funktioniert die MQTT-Integration mit Home Assistant

Bevor Sie mit der Konfiguration von MQTT beginnen, ist es hilfreich, zu verstehen, wie die Verbindung funktioniert.

Die grundlegende Architektur sieht folgendermaßen aus:

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

Das SONOFF-Gerät verbindet sich nicht direkt mit Home Assistant. Stattdessen verbinden sich sowohl das Gerät als auch Home Assistant mit demselben MQTT-Broker, der als Nachrichtenknoten zwischen ihnen fungiert.
  • OpenEdge-fähiges SONOFF-Gerät — verbindet sich als MQTT-Client mit dem Broker, veröffentlicht Gerätezustände und -daten und empfängt Steuerbefehle.
  • MQTT-Broker — empfängt und verteilt MQTT-Nachrichten zwischen verbundenen Clients. In Home-Assistant-Setups ist Mosquitto eine gängige Wahl.
  • Home Assistant — verbindet sich über die MQTT-Integration mit demselben Broker, empfängt Geräteaktualisierungen, sendet Befehle und verwaltet das Gerät in Home Assistant.
OpenEdge-fähige SONOFF-Geräte mit MQTT unterstützen nativ die MQTT-Erkennung. Sobald das Gerät eine Verbindung zum Broker herstellt, veröffentlicht es die erforderlichen Erkennungsinformationen, sodass Home Assistant das unterstützte Gerät und die zugehörigen Entitäten automatisch erstellen kann, ohne MQTT-Themen manuell konfigurieren oder YAML schreiben zu müssen.



OpenEdge-Geräte mit Home Assistant über MQTT einrichten

Richten wir nun die MQTT-Integration ein. In diesem Leitfaden wird der SONOFF MINI-1GSP als Beispiel verwendet. Derselbe grundlegende Ablauf kann auch für andere kompatible OpenEdge-Geräte mit MQTT-Unterstützung verwendet werden. 

Was Sie benötigen

Stellen Sie vor Beginn sicher, dass Sie Folgendes haben:
  • Ein OpenEdge-fähiges SONOFF-Gerät mit MQTT-Unterstützung.
  • Home Assistant ist installiert und läuft.
  • Ein MQTT-Broker ist installiert und läuft.
  • Die MQTT-Integration wurde hinzugefügt und in Home Assistant mit dem Broker verbunden. 

MQTT-Broker installieren und einrichten

Wenn Sie noch keinen MQTT-Broker haben, ist die offizielle Mosquitto-MQTT-Broker-App eine gängige Option für Home Assistant.
So installieren Sie ihn in Home Assistant: 
  • Öffnen Sie Home Assistant.
  • Gehen Sie zu Einstellungen → Apps (früher Add-ons genannt) → App installieren.
  • Suchen Sie nach Mosquitto broker und klicken Sie auf INSTALLIEREN.
  • Starten Sie nach der Installation die Mosquitto-Broker-App.
  • Es wird empfohlen, Beim Start starten und Watchdog zu aktivieren, damit der Broker automatisch mit Home Assistant gestartet und bei einem unerwarteten Stopp neu gestartet werden kann.
  • Erstellen Sie bei Bedarf unter Einstellungen → Personen → Benutzer einen dedizierten Home-Assistant-Benutzer für MQTT-Geräte.

Weitere Informationen zur Auswahl und Konfiguration eines MQTT-Brokers finden Sie im offiziellen Leitfaden zum Einrichten eines Brokers von Home Assistant. 

MQTT-Integration in Home Assistant hinzufügen

  1. Gehen Sie in Home Assistant zu Einstellungen → Geräte & Dienste → Integration hinzufügen.
  2. Suchen Sie nach MQTT und schließen Sie die Einrichtung ab.
  3. Gehen Sie zu Einstellungen → Geräte & Dienste → MQTT, um zu bestätigen, dass die Integration mit Ihrem Broker verbunden ist.

Schritt 1: Gerät einschalten

Beim MINI-1GSP wechselt das Gerät beim ersten Einschalten automatisch in den Kopplungsmodus. Wenn die LED zweimal kurz und anschließend einmal lang blinkt, ist der AP-Hotspot für die Einrichtung bereit. 

Schritt 2: Auf die OpenEdge-Webkonsole zugreifen

Es gibt zwei Möglichkeiten, auf die Webkonsole zuzugreifen.

Methode 1: Zugriff über den AP-Hotspot – empfohlen für die Ersteinrichtung

  • Öffnen Sie die WLAN-Einstellungen auf Ihrem Desktopcomputer, Tablet oder Mobilgerät.
  • Verbinden Sie sich mit dem Geräte-Hotspot: SONOFF_1GSP_xxxx.

  • Öffnen Sie einen Webbrowser und rufen Sie folgende Adresse auf: http://192.168.33.1
  • Die Anmeldeseite der Webkonsole wird geöffnet. Wenn Sie erstmals darauf zugreifen, erstellen Sie ein Anmeldepasswort mit mindestens 8 Zeichen.
    Melden Sie sich an, um die OpenEdge-Webkonsole zu öffnen.

Über die Webkonsole können Sie lokale Funktionen verwalten, darunter die EIN/AUS-Steuerung, historische Energiedaten, Timer, Matter-Kopplung, Netzwerkeinstellungen, AP-/WLAN-Konfiguration, OTA-Updates und Informationen zu OpenEdge.

Unter Verbindungseinstellungen können Sie die Cloud-Verbindung, MQTT für Home Assistant, TLS-Optionen und ausgehende WebSocket-Verbindungen für Plattformen von Drittanbietern konfigurieren.  

Methode 2: Zugriff über LAN

Wenn das Gerät bereits mit Ihrem lokalen Netzwerk verbunden ist, können Sie direkt auf die Webkonsole zugreifen, ohne eine Verbindung zu seinem AP-Hotspot herzustellen.  
Öffnen Sie beim MINI-1GSP einen Browser auf einem Gerät, das auf dasselbe LAN zugreifen kann, und geben Sie eine der folgenden Adressen in den Browser ein:

  • MINI-1GSP.local
  • Die lokale IP-Adresse des Geräts.

Schritt 3: Verbinden Sie das Gerät mit Ihrem WLAN-Netzwerk

Verbinden Sie das Gerät mit einem WLAN-Netzwerk, das sowohl Home Assistant als auch Ihren MQTT-Broker erreichen kann, damit sie über das lokale Netzwerk kommunizieren können.

  • Gehen Sie zu Netzwerkeinstellungen → WLAN-Einstellungen.
  • Wählen Sie das WLAN-Netzwerk aus, auf das Sie über Home Assistant und den MQTT-Broker zugreifen können.
  • Geben Sie das WLAN-Passwort ein.
  • Klicken Sie auf Speichern.
  • Warten Sie, bis das Gerät eine Verbindung hergestellt hat.

Sobald das Gerät eine Verbindung zu Ihrem lokalen Netzwerk herstellt, weist Ihr Router ihm normalerweise eine lokale IP-Adresse über DHCP zu. Diese Adresse wird in den WLAN-Einstellungen angezeigt und kann für den späteren LAN-Zugriff auf die Webkonsole verwendet werden, wie in Methode 2 oben beschrieben.

Hinweis: Zeitüberschreitung des AP-Hotspots

Der MINI-1GSP beendet den Kopplungsmodus nach etwa 10 Minuten automatisch. Nach Beendigung des Kopplungsmodus ist der für die Ersteinrichtung verwendete AP-Hotspot nicht mehr verfügbar.

Wenn der AP-Hotspot verschwindet, bevor Sie die Einrichtung abgeschlossen haben:

  1. Wenn das Gerät bereits mit Ihrem lokalen Netzwerk verbunden ist, fahren Sie mit der Einrichtung über die oben beschriebene LAN-Zugriffsmethode fort.
  2. Wenn Sie den AP-Hotspot erneut verwenden müssen, halten Sie die Gerätetaste 5 Sekunden lang gedrückt, um wieder in den Kopplungsmodus zu wechseln.
  3. Stellen Sie die Verbindung zu SONOFF_1GSP_xxxx wieder her, öffnen Sie http://192.168.33.1 und fahren Sie mit der Einrichtung fort.

Tipp: Wenn Sie die Gerätetaste 10 Sekunden gedrückt halten, wird ein Zurücksetzen auf die Werkseinstellungen durchgeführt.

Schritt 4: MQTT aktivieren und Parameter konfigurieren

  • Gehen Sie zu Verbindungseinstellungen → MQTT.
  • Aktivieren MQTT.
  • Konfigurieren Sie die MQTT-Parameter wie unten gezeigt.
  • Wenn die Einstellungen vollständig sind, klicken Sie auf Speichern.

Beispiel für die MQTT-Konfiguration der Webkonsole des Geräts:

Einstellung

Einzugebender Wert

Server

Adresse und Port des MQTT-Brokers, z. B. 192.168.1.242:1883

Benutzername

Benutzername des MQTT-Brokers

Passwort

Passwort des MQTT-Brokers

Verbindungstyp

Wählen Sie die TLS-Option, die zu Ihrem Broker passt

RPC-Statusbenachrichtigungen über MQTT

Je nach Bedarf aktivieren oder deaktivieren

Tipps:
  • Das Feld „Server“ sollte auf Ihren MQTT-Broker verweisen. Wenn der Mosquitto-Broker auf demselben Host wie Home Assistant ausgeführt wird, handelt es sich dabei normalerweise um die IP-Adresse des Home-Assistant-Hosts mit MQTT-Port 1883, zum Beispiel: 192.168.1.242:1883. 
  • Wenn Sie den offiziellen Home-Assistant-Mosquitto-Broker verwenden und keine separaten MQTT-Zugangsdaten (Benutzername und Passwort) erstellt haben, können Sie einen vorhandenen Home-Assistant-Benutzernamen und ein vorhandenes Passwort verwenden.
  • Wenn Mosquitto bereits mit einem Benutzernamen und Passwort konfiguriert ist, geben Sie denselben Benutzernamen und dasselbe Passwort in den MQTT-Einstellungen der Webkonsole des Geräts ein.

Schritt 5: Gerät in Home Assistant überprüfen und steuern

  • Nachdem Sie die MQTT-Einstellungen gespeichert haben, verbinden Sie Ihren Desktopcomputer, Ihr Tablet oder Ihr Mobilgerät erneut mit dem lokalen Netzwerk, das auf Home Assistant und den MQTT-Broker zugreifen kann.
  • Öffnen Sie Home Assistant und gehen Sie zu Einstellungen → Geräte & Dienste → MQTT  

Das Gerät sollte bereits in der MQTT-Geräteliste angezeigt werden. OpenEdge-fähige SONOFF-Geräte mit MQTT-Unterstützung veröffentlichen nativ Informationen zur MQTT-Erkennung von Home Assistant, sodass Home Assistant das Gerät automatisch hinzufügen und die unterstützten Entitäten erstellen kann – ohne manuelle Konfiguration von MQTT-Topics oder YAML.

  • Öffnen Sie die Geräteseite, um die verfügbaren Steuerungen und Entitäten anzuzeigen. Beim MINI-1GSP umfassen diese beispielsweise folgende Funktionen:
    • Relaissteuerung
    • Strom
    • Spannung
    • Leistung
    • Frequenz
    • Energiedaten

Anschließend können Sie diese Entitäten zu Ihrem Home-Assistant-Dashboard hinzufügen oder in Automatisierungen und Szenen verwenden.


 

OpenEdge-unterstützte Geräte

Die folgenden SONOFF-Produkte unterstützen derzeit OpenEdge:

Weitere OpenEdge-fähige Geräte werden bald verfügbar sein, darunter:

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

OpenEdge wird schrittweise auch auf weitere SONOFF-Produktkategorien ausgeweitet, darunter:

  • Intelligente Schalter – ermöglichen eine flexiblere lokale Steuerung und Integration über offene Schnittstellen.
  • Produkte für das Energiemanagement – lokale Datenverarbeitung und transparentere Energieüberwachung.
  • Andere Smart-Home-Geräte – Verbindung mit weiteren Plattformen und Ökosystemen durch die offenen Integrationsmöglichkeiten von OpenEdge.

👉 Eine Übersicht der aktuell unterstützten Geräte und der nach der Integration mit Home Assistant verfügbaren Funktionen finden Sie in der Liste der von Home Assistant unterstützten Funktionen für SONOFF-OpenEdge-Geräte.  



Fazit

SONOFF OpenEdge vereinfacht die Integration mit Home Assistant und macht sie lokaler und flexibler. Über die integrierte Webkonsole und die standardisierte lokale API von OpenEdge über MQTT können unterstützte SONOFF-Geräte direkt über einen Browser konfiguriert und lokal in Home Assistant integriert werden – für eine unkomplizierte Einrichtung, reaktionsschnelle lokale Steuerung und flexiblere Automatisierungen, ohne für den Integrationspfad auf die Cloud angewiesen zu sein.


 

 

Häufig gestellte Fragen

F: Benötigt OpenEdge die Cloud?

Nicht unbedingt. OpenEdge basiert auf einer Local-First-Architektur, über die unterstützte Geräte über die lokale Webkonsole und die standardisierte lokale API im lokalen Netzwerk konfiguriert, gesteuert und integriert werden können.

Für diese lokalen Funktionen ist keine Cloud-Konnektivität erforderlich. Sie bleibt jedoch als optionale Ergänzung für Funktionen und Dienste verfügbar, die von Cloud-Zugriff profitieren.

 

F: Können SONOFF-OpenEdge-Geräte mit Home Assistant funktionieren, wenn das Internet nicht verfügbar ist?

Ja. Für die in diesem Leitfaden beschriebene Home-Assistant-MQTT-Einrichtung müssen das SONOFF-Gerät, der MQTT-Broker und Home Assistant über das lokale Netzwerk erreichbar bleiben.

Solange das LAN und der MQTT-Broker verfügbar bleiben, kann das Gerät weiterhin lokal ohne aktive Internetverbindung mit Home Assistant kommunizieren.

 

F: Benötige ich die eWeLink-App oder ein eWeLink-Konto, um MQTT mit Home Assistant einzurichten?

Nein. Für die in diesem Leitfaden beschriebene lokale MQTT-Integration können Sie direkt über einen Browser auf die OpenEdge-Webkonsole zugreifen, ohne die eWeLink-App oder ein eWeLink-Konto zu verwenden.

Für die Ersteinrichtung können Sie über den AP-Hotspot des Geräts auf die Webkonsole zugreifen. Sobald das Gerät Ihrem lokalen Netzwerk beigetreten ist, können Sie auch über das LAN mithilfe seines lokalen Hostnamens oder seiner IP-Adresse darauf zugreifen.

Über die Webkonsole können Sie das Gerätenetzwerk und die MQTT-Verbindung direkt konfigurieren. Die eWeLink-Cloud-Konnektivität bleibt separat verfügbar, wenn Sie sie verwenden möchten.



Weiterlesen

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

Hinterlasse einen Kommentar

Alle Kommentare werden vor der Veröffentlichung geprüft.

Diese Website ist durch hCaptcha geschützt und es gelten die allgemeinen Geschäftsbedingungen und Datenschutzbestimmungen von hCaptcha.