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

• OpenEdge-fähiges SONOFF-Gerät — stellt als MQTT-Client eine Verbindung zum Broker her, 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 — stellt über die MQTT-Integration eine Verbindung zum selben Broker her, empfängt Geräteaktualisierungen, sendet Befehle und verwaltet das Gerät in Home Assistant.

OpenEdge-Geräte über MQTT mit Home Assistant 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. 

Das benötigen Sie

MQTT-Broker installieren und einrichten

MQTT-Integration in Home Assistant hinzufügen

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 – für die erstmalige Einrichtung empfohlen

• Ö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. Beim ersten Zugriff legen Sie ein Anmeldepasswort mit mindestens 8 Zeichen fest.
  Melden Sie sich an, um die OpenEdge-Webkonsole aufzurufen.

In der 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.  
Für den MINI-1GSP öffnen Sie auf einem Gerät, das dasselbe LAN erreichen kann, einen Browser 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 von Home Assistant und dem 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 Ende des Kopplungsmodus ist der AP-Hotspot für die erstmalige Einrichtung 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, setzen Sie die 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. Verbinden Sie sich erneut mit SONOFF_1GSP_xxxx, öffnen Sie http://192.168.33.1 und setzen Sie die Einrichtung fort.

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

Schritt 4: MQTT aktivieren und die 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.

• Das Feld „Server“ sollte auf Ihren MQTT-Broker verweisen. Wenn der Mosquitto-Broker auf demselben Host wie Home Assistant ausgeführt wird, ist dies normalerweise die IP-Adresse des Home-Assistant-Hosts mit dem MQTT-Port 1883, zum Beispiel: 192.168.1.242:1883. 
• Wenn Sie den offiziellen Mosquitto-Broker von Home Assistant 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

• Speichern Sie die MQTT-Einstellungen und verbinden Sie Ihren Desktopcomputer, Ihr Tablet oder 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-Discovery 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. Im Beispiel des MINI-1GSP gehören dazu Funktionen wie:
  • Relaissteuerung
  • Stromstärke
  • Spannung
  • Leistung
  • Frequenz
  • Energiedaten

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

Von OpenEdge unterstützte Geräte

Der MINI-1GSP ist das erste SONOFF-Produkt mit OpenEdge-Unterstützung.
Weitere OpenEdge-fähige Geräte werden in Kürze verfügbar sein, darunter:

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

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

• Smarte Schalter – flexiblere lokale Steuerung und Integration über offene Schnittstellen.
• Produkte für das Energiemanagement – lokale Datenverarbeitung und eine transparentere Energieüberwachung.
• Weitere smarte 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 in Home Assistant verfügbaren Funktionen finden Sie in der [Home Assistant Feature Support List für SONOFF OpenEdge-Geräte].  

Fazit

SONOFF OpenEdge macht die Integration in Home Assistant einfacher, lokaler und flexibler. Über die integrierte Webkonsole und die standardisierte lokale OpenEdge-API über MQTT lassen sich unterstützte SONOFF-Geräte direkt über einen Browser konfigurieren und lokal in Home Assistant integrieren – für eine unkomplizierte Einrichtung, eine reaktionsschnelle lokale Steuerung und flexiblere Automatisierungen, ohne dass der Integrationspfad auf die Cloud angewiesen ist.