SONOFF OpenEdge-apparaten integreren met Home Assistant via MQTT

Inleiding

SONOFF introduceert OpenEdge, een architectuur waarbij de lokale verbinding vooropstaat, ontworpen voor slimme apparaten van de volgende generatie. Deze biedt je meer lokale controle, bredere interoperabiliteit en meer flexibele manieren om je apparaten met verschillende platforms en ecosystemen te verbinden.

Met OpenEdge kunnen ondersteunde apparaten van SONOFF lokaal communiceren via open interfaces, waaronder HTTP, MQTT en WebSocket.

Voor gebruikers van Home Assistant betekent dit meer keuze in de manier waarop je je apparaten integreert: je kunt ze lokaal via MQTT verbinden wanneer je de voorkeur geeft aan lokale bediening en flexibele integratie met ecosystemen, terwijl cloudverbinding beschikbaar blijft wanneer die beter bij je behoeften past.

Zo werkt de MQTT-integratie met Home Assistant

Voordat je MQTT gaat configureren, is het handig om te begrijpen hoe de verbinding werkt.

De basisarchitectuur ziet er als volgt uit:

OpenEdge-apparaat van SONOFF → MQTT-broker → Home Assistant

Veelgestelde vragen over MQTT-integratie met Home Assistant

 

1. Hoe verbindt MQTT SONOFF-apparaten met Home Assistant?

SONOFF-apparaten maken niet rechtstreeks verbinding met Home Assistant. In plaats daarvan communiceren ze met Home Assistant via een MQTT-broker.

┌───────────────┐
│ SONOFF-apparaat │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│  MQTT-broker  │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Apparaat / Entiteit │
└─────────────────┘

Het integratieproces kan daarom in vier fasen worden verdeeld:

① SONOFF-apparaat → MQTT-broker

• Controleer of het SONOFF-apparaat verbinding kan maken met de MQTT-broker.

② Home Assistant → MQTT-broker

• Controleer of Home Assistant verbinding kan maken met de MQTT-broker.

③ MQTT Discovery

• Controleer of Home Assistant het SONOFF-apparaat kan vinden via MQTT Discovery.

④ Entiteit

• Controleer of Home Assistant de entiteiten correct aanmaakt en het apparaat kan bedienen en de status ervan kan uitlezen.

Opmerking: Als een SONOFF-apparaat ‘MQTT Connected’ weergeeft, betekent dit alleen dat het apparaat succesvol verbinding heeft gemaakt met de MQTT-broker. Het betekent niet dat Home Assistant succesvol verbinding heeft gemaakt of het apparaat heeft gevonden.

 

2. Fase 1: Het SONOFF-apparaat verbinden met de MQTT-broker

Q1: Betekent ‘MQTT Connected’ dat mijn SONOFF-apparaat succesvol verbinding heeft gemaakt met Home Assistant?

Nee. ‘MQTT Connected’ betekent alleen dat het SONOFF-apparaat succesvol verbinding heeft gemaakt met de MQTT-broker.

Het SONOFF-apparaat kan doorgaans niet vaststellen of Home Assistant online is, of Home Assistant verbinding heeft met de broker, of het apparaat al is gedetecteerd.

Het volledige communicatiepad is:

SONOFF-apparaat
     ↓
MQTT-broker        ✓
     ↓
Home Assistant     ?
     ↓
MQTT-detectie     ?
     ↓
Entiteit             ?

Als op het apparaat MQTT Connected wordt weergegeven, maar het niet verschijnt in Home Assistant, ga dan verder met fase 2 en 3.

V2: Wat moet ik controleren als mijn SONOFF-apparaat geen verbinding kan maken met de MQTT-broker?

Controleer de volgende punten in deze volgorde:

1. MQTT-brokeradres

• Controleer of het brokeradres dat is ingesteld op het SONOFF-apparaat correct is.
  Bijvoorbeeld: 192.168.1.100

2. MQTT-poort

• Veelgebruikte MQTT-poorten zijn onder andere: 

• Controleer of de poort die is ingesteld op het SONOFF-apparaat overeenkomt met de poort waarop de MQTT-broker daadwerkelijk luistert.

3. MQTT-gebruikersnaam en -wachtwoord

Als verificatie is ingeschakeld op de broker, controleer dan:

• Gebruikersnaam
• Wachtwoord
• Of het account is uitgeschakeld
• Of ACL-machtigingen het account beperken

Als de gebruikersnaam of het wachtwoord onjuist is, kan het SONOFF-apparaat mogelijk geen MQTT-verbinding tot stand brengen.

4. Netwerkverbinding

• Controleer of het SONOFF-apparaat de MQTT-broker kan bereiken. Bijvoorbeeld:

SONOFF-apparaat
192.168.1.50
     ↓
MQTT-broker
192.168.1.100:1883

Als je configuratiewijzigingen aanbrengt, start Home Assistant dan opnieuw op of laad de MQTT-integratie opnieuw voordat je het nog eens controleert.

3. Fase 2: Home Assistant verbinden met de MQTT-broker

V3: Mijn SONOFF-apparaat geeft 'MQTT Connected' weer, maar verschijnt niet in Home Assistant. Wat moet ik controleren?

Controleer eerst of Home Assistant zelf verbinding heeft gemaakt met de MQTT-broker.

Het SONOFF-apparaat en Home Assistant zijn onafhankelijke MQTT-clients:

              MQTT-broker
             /           \
            /             \
   SONOFF-apparaat           HA
        |                   |
    Verbonden           Verbonden?

Een geslaagde verbinding vanaf het SONOFF-apparaat betekent niet dat Home Assistant ook verbonden is met de MQTT-broker.

V4: Hoe kan ik controleren of Home Assistant verbonden is met de MQTT-broker?

Ga in Home Assistant naar: Instellingen → Apparaten en diensten → MQTT → Opnieuw configureren

Controleer of de configuratie van de MQTT-broker correct is, inclusief:

• IP-adres van de broker
• Gebruikersnaam
• Wachtwoord

De webinterface van Home Assistant gebruikt doorgaans poort 8123. Dit is niet de MQTT-poort. Een veelgebruikte MQTT-poort is 1883.

V5: Kunnen het SONOFF OpenEdge-apparaat en Home Assistant verschillende MQTT-brokers gebruiken?

Automatische detectie werkt normaal gesproken niet goed als ze verschillende MQTT-brokers gebruiken. Bijvoorbeeld:

SONOFF-apparaat
     ↓
Broker A

Home Assistant
     ↓
Broker B

Omdat de twee systemen met verschillende brokers zijn verbonden, kan Home Assistant de MQTT-berichten die door het SONOFF-apparaat worden gepubliceerd niet ontvangen.

De gebruikelijke configuratie is:

SONOFF-apparaat ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Fase 3: MQTT Discovery

V6: OpenEdge-apparaat en Home Assistant zijn allebei verbonden met de MQTT-broker, maar het apparaat verschijnt nog steeds niet in Home Assistant. Wat moet ik doen?

Controleer nu MQTT Discovery.

Het apparaat moet via MQTT Discovery apparaats- en entiteitsinformatie aan Home Assistant verstrekken.

• Ga in Home Assistant naar: Instellingen → Apparaten & services → MQTT → Configureren → MQTT-opties configureren
• Controleer of Discovery inschakelen is ingeschakeld.
• Controleer ook of het Discovery-voorvoegsel is ingesteld op de standaardwaarde: homeassistant

Als Discovery was uitgeschakeld, zorgt alleen het inschakelen ervan en het opslaan van de instellingen er niet meteen voor dat Home Assistant de al verbonden MQTT-apparaten opnieuw scant.

Start Home Assistant opnieuw op of klik op ‘Opnieuw laden’ bij de MQTT-integratie, zodat Home Assistant zich opnieuw op het Discovery-topic kan abonneren en de apparaten kan herkennen.

 

5. Problemen met het Discovery-voorvoegsel

V8: Wat is het Discovery-voorvoegsel?

Het Discovery-voorvoegsel is het topicvoorvoegsel dat door Home Assistant MQTT Discovery wordt gebruikt.

Home Assistant gebruikt standaard de volgende waarde: homeassistant

V9: Heeft het wijzigen van het Home Assistant Discovery-voorvoegsel invloed op de integratie van OpenEdge-apparaten?

Ja. Als het apparaat bijvoorbeeld het standaardvoorvoegsel gebruikt: homeassistant

Als het Home Assistant Discovery-voorvoegsel echter is gewijzigd in: myhome

Home Assistant luistert naar Discovery-topics onder: myhome/...

Het communicatiepad ziet er dan als volgt uit:

Apparaat
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
luistert naar myhome/...

Omdat de twee voorvoegsels niet overeenkomen, kan Home Assistant het apparaat niet correct ontdekken.

Aanbeveling

• Laat het Home Assistant Discovery-voorvoegsel ingesteld op: homeassistant
• Wijzig het niet.
• Als het voorvoegsel eerder is gewijzigd en het apparaat daardoor niet meer beschikbaar is, worden oude entiteiten niet automatisch verwijderd en wordt het apparaat niet opnieuw ontdekt als u het voorvoegsel terugzet op de standaardwaarde.
• Start in dat geval Home Assistant opnieuw op of laad de MQTT-integratie opnieuw. Als eerder gevonden entiteiten nog steeds de status ‘Niet beschikbaar’ hebben, moet je mogelijk de oude entiteiten verwijderen en het apparaat opnieuw laten ontdekken.

 

6. Problemen met speciale netwerkomgevingen

Q11: Waarom werkt MQTT op mijn lokale netwerk, maar niet meer wanneer ik overschakel naar een extern netwerk?

Als de MQTT-broker alleen op je lokale thuisnetwerk is geïnstalleerd:

SONOFF-apparaat
     ↓
192.168.1.100:1883
     ↓
Lokaal thuisnetwerk

Zodra het apparaat dat netwerk verlaat en verbinding maakt met een ander LAN:

SONOFF-apparaat
    x
192.168.1.100

De broker is niet meer bereikbaar via het LAN-IP-adres.

Overweeg voor toegang via verschillende netwerken het volgende:

• MQTT-broker met openbaar IP-adres

Veiligheidsopmerking: Het wordt afgeraden om een niet-versleutelde MQTT-poort 1883 rechtstreeks bloot te stellen aan het openbare internet.

 

7. Veelvoorkomende problemen in Docker-omgevingen

Q12: Home Assistant draait in Docker. Waarom kan het geen verbinding maken met de MQTT-broker wanneer ik localhost:1883 gebruik?

Als Home Assistant en de MQTT-broker in verschillende Docker-containers draaien, verwijst localhost meestal naar de Home Assistant-container en niet naar de container waarop de MQTT-broker draait.

Bijvoorbeeld:

┌─────────────────────┐
│ Docker-host         │
│                     │
│ ┌───────────────┐   │
│ │ Home Assistant│   │
│ │ localhost     │   │
│ └───────────────┘   │
│                     │
│ ┌───────────────┐   │
│ │ Mosquitto     │   │
│ │ Poort 1883     │   │
│ └───────────────┘   │
│                     │
└─────────────────────┘

Daarom maakt het invoeren van localhost:1883 in Home Assistant niet per se verbinding met Mosquitto.

Aanbevolen configuratie

Als je niet bekend bent met de configuratie van Docker-netwerken, raden we aan het lokale netwerk-IP-adres in te voeren van de host waarop de MQTT-broker draait. Bijvoorbeeld:

MQTT-broker:
192.168.1.100

Poort:
1883

Vervang 192.168.1.100 door het daadwerkelijke IP-adres van de host waarop de MQTT-broker draait.

Als Home Assistant en Mosquitto met hetzelfde Docker-netwerk zijn verbonden, kun je ook de naam van de Mosquitto-container gebruiken, bijvoorbeeld: mosquitto:1883

Opmerking: Een containernaam zoals mosquitto kan alleen binnen het bijbehorende Docker-netwerk worden gebruikt. SONOFF-apparaten moeten doorgaans het IP-adres of de domeinnaam gebruiken van de host waarop de MQTT-broker draait, in plaats van de naam van de Docker-container.

Voer na het aanbrengen van wijzigingen de Home Assistant-container opnieuw op of laad de MQTT-integratie opnieuw om de nieuwe configuratie toe te passen.