SONOFF OpenEdge-apparaten integreren met Home Assistant via MQTT

• OpenEdge-apparaat van SONOFF — 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 apparaatupdates, verzendt opdrachten en beheert het apparaat in Home Assistant.

OpenEdge-apparaten instellen met Home Assistant via MQTT

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

Wat je nodig hebt

Een MQTT-broker installeren en instellen

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 lange knippering, is de AP-hotspot klaar voor configuratie. 

Stap 2: Open de OpenEdge Web Console

Er zijn twee manieren om toegang te krijgen tot de Web Console.

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

• 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 Web Console wordt geopend. Wanneer je deze voor het eerst opent, maak je een inlogwachtwoord aan van minimaal 8 tekens.
  Log in om de OpenEdge Web Console te openen.

Via de webconsole kun je lokale functies beheren, waaronder in-/uitschakelen, 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, kun je rechtstreeks toegang krijgen 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 de browser in:

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

Stap 3: Verbind het apparaat met je wifinetwerk

Verbind het apparaat met een wifinetwerk 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 wifinetwerk waarmee je verbinding kunt maken vanaf Home Assistant en de MQTT-broker.
• Voer het wifiwachtwoord in.
• Klik op Opslaan.
• Wacht tot het apparaat verbinding heeft gemaakt.

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 worden gebruikt voor latere LAN-toegang tot de webconsole, zoals beschreven in Methode 2 hierboven.

Opmerking: time-out van de AP-hotspot

De MINI-1GSP verlaat de koppelingsmodus automatisch na ongeveer 10 minuten. Wanneer de koppelingsmodus eindigt, is de AP-hotspot voor de eerste configuratie niet langer beschikbaar.

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

1. Als het apparaat al met je lokale netwerk is verbonden, ga je verder met de configuratie via de hierboven beschreven LAN-toegangsmethode.
2. Als je de AP-hotspot opnieuw wilt gebruiken, houd je de apparaatknop 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 configuratie.

Tip: Als je de apparaatknop 10 seconden ingedrukt houdt, wordt het apparaat teruggezet naar de fabrieksinstellingen.

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 meestal 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 voor Home Assistant gebruiken.
• Als Mosquitto al is geconfigureerd met een gebruikersnaam en wachtwoord, voer dan dezelfde gebruikersnaam en hetzelfde wachtwoord in bij de MQTT-instellingen van de webconsole van het apparaat.

Stap 5: Controleer en bedien het apparaat in Home Assistant

• Sla de MQTT-instellingen op en verbind je desktopcomputer, tablet of mobiele apparaat opnieuw 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 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 functies zoals:
  • Relaisbediening
  • Stroomsterkte
  • 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 MINI-1GSP is het eerste SONOFF-product dat OpenEdge ondersteunt.
Er komen binnenkort meer apparaten met OpenEdge-ondersteuning, waaronder:

• MINI-1GP
• 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 — voor lokale gegevensverwerking en transparantere energiemonitoring.
• Andere slimme apparaten — verbinding met meer platforms en ecosystemen via de open integratiemogelijkheden van OpenEdge.

Bekijk voor de nieuwste ondersteunde apparaten en de functies die beschikbaar zijn na integratie met Home Assistant de [lijst met functieondersteuning voor Home Assistant voor SONOFF OpenEdge-apparaten].  

Conclusie

SONOFF OpenEdge maakt de 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 dat de cloud nodig is voor de integratie.