SONOFF OpenEdge-apparaten integreren met Home Assistant via MQTT

• OpenEdge-compatibel SONOFF-apparaat — maakt als MQTT-client verbinding met de broker, publiceert apparaatstatussen en -gegevens en ontvangt besturingsopdrachten.
• MQTT-broker — ontvangt en verspreidt MQTT-berichten tussen verbonden clients. In Home Assistant-configuraties is Mosquitto een veelgebruikte keuze.
• Home Assistant — maakt via de MQTT-integratie verbinding met dezelfde broker, ontvangt updates van het apparaat, verstuurt opdrachten en beheert het apparaat in Home Assistant.

OpenEdge-apparaten instellen met Home Assistant via MQTT

Laten we nu de MQTT-integratie configureren. In deze handleiding gebruiken we de SONOFF MINI-1GSP als voorbeeld. Dezelfde basisworkflow kan worden gebruikt voor andere compatibele OpenEdge-apparaten met MQTT-ondersteuning. 

Wat je nodig hebt

Een MQTT-broker installeren en configureren

Voeg de MQTT-integratie toe in Home Assistant

Stap 1: Schakel het apparaat in

Bij de MINI-1GSP schakelt het apparaat bij de eerste keer inschakelen automatisch over naar de koppelingsmodus. Wanneer de led twee keer kort knippert, gevolgd door één keer lang, is de AP-hotspot gereed voor de configuratie. 

Stap 2: Toegang tot de OpenEdge-webconsole

Er zijn twee manieren om toegang te krijgen tot de webconsole.

Methode 1: Toegang via AP-hotspot — aanbevolen voor de eerste configuratie

• Open de wifi-instellingen op je desktopcomputer, tablet of mobiele apparaat.
• Maak verbinding met de hotspot van het apparaat: SONOFF_1GSP_xxxx.

• Open een webbrowser en ga naar: http://192.168.33.1
• De inlogpagina van de webconsole wordt geopend. Wanneer je deze voor het eerst opent, maak je een inlogwachtwoord aan van minimaal 8 tekens.
  Log in om de OpenEdge-webconsole te openen.

Via de webconsole kun je lokale functies beheren, waaronder AAN/UIT-bediening, historische energiegegevens, timers, Matter-koppeling, netwerkinstellingen, AP-/wifi-configuratie, OTA-updates en Over OpenEdge.

Onder Verbindingsinstellingen kun je cloud-connectiviteit, MQTT voor Home Assistant, TLS-opties en uitgaande WebSocket-verbindingen voor platforms van derden configureren.  

Methode 2: toegang via LAN

Als het apparaat al met je lokale netwerk is verbonden, heb je rechtstreeks toegang tot de webconsole zonder verbinding te maken met de AP-hotspot.  
Open voor de MINI-1GSP een browser op een apparaat dat toegang heeft tot hetzelfde LAN en voer een van de volgende adressen in je browser in:

• MINI-1GSP.local
• Het lokale IP-adres van het apparaat.

Stap 3: verbind het apparaat met je wifi-netwerk

Verbind het apparaat met een wifi-netwerk dat zowel Home Assistant als je MQTT-broker kan bereiken, zodat ze via het lokale netwerk kunnen communiceren.

• Ga naar Netwerkinstellingen → Wifi-instellingen.
• Selecteer het wifi-netwerk waartoe je toegang hebt vanuit Home Assistant en de MQTT-broker.
• Voer het wifi-wachtwoord in.
• Klik op Opslaan.
• Wacht tot het apparaat verbinding maakt.

Zodra het apparaat verbinding maakt met je lokale netwerk, wijst je router het doorgaans een lokaal IP-adres via DHCP toe. Dit adres wordt weergegeven in de wifi-instellingen en kan later worden gebruikt voor LAN-toegang tot de webconsole, zoals beschreven in methode 2 hierboven.

Opmerking: time-out van AP-hotspot

De MINI-1GSP verlaat de koppelingsmodus automatisch na ongeveer 10 minuten. Wanneer de koppelingsmodus eindigt, is de AP-hotspot die voor de eerste installatie wordt gebruikt niet meer beschikbaar.

Als de AP-hotspot verdwijnt voordat je de installatie hebt voltooid:

1. Als het apparaat al met je lokale netwerk is verbonden, ga je verder met de installatie via de hierboven beschreven LAN-toegangsmethode.
2. Als je de AP-hotspot opnieuw moet gebruiken, houd je de knop op het apparaat 5 seconden ingedrukt om opnieuw naar de koppelingsmodus te gaan.
3. Maak opnieuw verbinding met SONOFF_1GSP_xxxx, open http://192.168.33.1 en ga verder met de installatie.

Tip: Als je de apparaatknop 10 seconden ingedrukt houdt, wordt de fabrieksinstellingen hersteld.

Stap 4: MQTT inschakelen en de parameters configureren

• Ga naar Verbindingsinstellingen → MQTT.
• Inschakelen MQTT.
• Configureer de MQTT-parameters zoals hieronder weergegeven
• Klik op Opslaan wanneer de instellingen zijn voltooid.

• Het veld Server moet verwijzen naar je MQTT-broker. Als Mosquitto Broker op dezelfde host als Home Assistant draait, is dit doorgaans het IP-adres van de Home Assistant-host met MQTT-poort 1883, bijvoorbeeld: 192.168.1.242:1883. 
• Als je de officiële Mosquitto Broker van Home Assistant gebruikt en geen afzonderlijke MQTT-inloggegevens (gebruikersnaam en wachtwoord) hebt aangemaakt, kun je een bestaande gebruikersnaam en wachtwoord van Home Assistant gebruiken.
• Als Mosquitto al is geconfigureerd met een gebruikersnaam en wachtwoord, voer je dezelfde gebruikersnaam en hetzelfde wachtwoord in bij de MQTT-instellingen van de Web Console van het apparaat.

Stap 5: Het apparaat in Home Assistant verifiëren en bedienen

• Maak na het opslaan van de MQTT-instellingen opnieuw verbinding met je desktopcomputer, tablet of mobiele apparaat met het lokale netwerk dat toegang heeft tot Home Assistant en de MQTT-broker.
• Open Home Assistant en ga naar Instellingen → Apparaten en diensten → MQTT  

Het apparaat zou al in de MQTT-apparatenlijst moeten verschijnen. SONOFF-apparaten met OpenEdge-ondersteuning en MQTT-ondersteuning publiceren standaard Home Assistant MQTT Discovery-informatie, zodat Home Assistant het apparaat automatisch kan toevoegen en de ondersteunde entiteiten kan aanmaken, zonder handmatige configuratie van MQTT-topics of YAML.

• Open de apparaatpagina om de beschikbare bedieningselementen en entiteiten te bekijken. Voor het voorbeeld met de MINI-1GSP gaat het onder andere om de volgende functies:
  • Relaisbediening
  • Stroom
  • Spanning
  • Vermogen
  • Frequentie
  • Energiegegevens

Je kunt deze entiteiten vervolgens aan je Home Assistant-dashboard toevoegen of ze gebruiken in automatiseringen en scènes.

Apparaten met OpenEdge-ondersteuning

De volgende SONOFF-producten ondersteunen momenteel OpenEdge:

• MINI-1GSP 
• MINI-1GP

Binnenkort verschijnen er meer apparaten met OpenEdge-ondersteuning, waaronder:

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

OpenEdge wordt geleidelijk uitgebreid naar meer SONOFF-productcategorieën, waaronder:

• Slimme schakelaars — voor flexibelere lokale bediening en integratie via open interfaces.
• Producten voor energiebeheer — lokale gegevensverwerking en transparantere energiemonitoring.
• Andere slimme apparaten — verbinding met meer platforms en ecosystemen via de open integratiemogelijkheden van OpenEdge.

👉 Bekijk de Lijst met functieondersteuning voor SONOFF OpenEdge-apparaten in Home Assistant. voor de nieuwste ondersteunde apparaten en de functies die beschikbaar zijn na integratie met Home Assistant.  

Conclusie

SONOFF OpenEdge maakt integratie met Home Assistant eenvoudiger, lokaler en flexibeler. Via de ingebouwde webconsole en de gestandaardiseerde lokale API van OpenEdge via MQTT kunnen ondersteunde SONOFF-apparaten rechtstreeks vanuit een browser worden geconfigureerd en lokaal met Home Assistant worden geïntegreerd — voor een eenvoudige installatie, snelle lokale bediening en flexibelere automatisering zonder afhankelijk te zijn van de cloud voor de integratie.