Comment intégrer les appareils SONOFF OpenEdge à Home Assistant via MQTT

Introduction

SONOFF présente OpenEdge, une architecture privilégiant le local pour les appareils intelligents de nouvelle génération, conçue pour vous offrir un meilleur contrôle local, une interopérabilité plus large et plus de flexibilité pour connecter vos appareils à différentes plateformes et différents écosystèmes.

Avec OpenEdge, les appareils SONOFF compatibles peuvent communiquer localement via des interfaces ouvertes, notamment HTTP, MQTT et WebSocket.

Pour les utilisateurs de Home Assistant, cela offre plus de choix pour intégrer leurs appareils : vous pouvez les connecter localement via MQTT si vous préférez un contrôle local et une intégration flexible à l’écosystème, tout en conservant la connectivité au cloud lorsqu’elle répond mieux à vos besoins.

Fonctionnement de l’intégration MQTT avec Home Assistant

Avant de configurer MQTT, il est utile de comprendre le fonctionnement de la connexion.

L’architecture de base est la suivante :

Appareil SONOFF compatible OpenEdge → Broker MQTT → Home Assistant

FAQ sur l’intégration MQTT avec Home Assistant

 

1. Comment MQTT connecte-t-il les appareils SONOFF à Home Assistant ?

Les appareils SONOFF ne se connectent pas directement à Home Assistant. Ils communiquent plutôt avec Home Assistant par l’intermédiaire d’un broker MQTT.

┌───────────────┐
│ Appareil SONOFF │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│  Broker MQTT  │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Appareil / Entité │
└─────────────────┘

Le processus d’intégration peut donc être divisé en quatre étapes :

① Appareil SONOFF → broker MQTT

• Vérifiez que l’appareil SONOFF peut se connecter au broker MQTT.

② Home Assistant → broker MQTT

• Vérifiez que Home Assistant peut se connecter au broker MQTT.

③ MQTT Discovery

• Vérifiez que Home Assistant peut détecter l’appareil SONOFF via MQTT Discovery.

④ Entité

• Vérifiez que Home Assistant crée correctement les entités, peut contrôler l’appareil et lire son état.

Remarque : Lorsqu’un appareil SONOFF affiche « MQTT Connected », cela signifie uniquement qu’il s’est connecté avec succès au broker MQTT. Cela ne signifie pas que Home Assistant s’est connecté avec succès ni qu’il a détecté l’appareil.

 

2. Étape 1 : connecter l’appareil SONOFF au broker MQTT

Q1 : « MQTT Connected » signifie-t-il que mon appareil SONOFF est correctement connecté à Home Assistant ?

Non. « MQTT Connected » signifie uniquement que l’appareil SONOFF s’est connecté avec succès au broker MQTT.

En général, l’appareil SONOFF ne peut pas déterminer si Home Assistant est en ligne, s’il est connecté au courtier ou si l’appareil a déjà été découvert.

Le parcours de communication complet est le suivant :

Appareil SONOFF
     ↓
Courtier MQTT        ✓
     ↓
Home Assistant     ?
     ↓
Découverte MQTT     ?
     ↓
Entité             ?

Si l’appareil indique MQTT Connected mais n’apparaît pas dans Home Assistant, passez aux étapes 2 et 3.

Q2 : Que dois-je vérifier si mon appareil SONOFF ne peut pas se connecter au courtier MQTT ?

Vérifiez les éléments suivants dans l’ordre :

1. Adresse du courtier MQTT

• Assurez-vous que l’adresse du courtier configurée sur l’appareil SONOFF est correcte.
  Par exemple : 192.168.1.100

2. Port MQTT

• Les ports MQTT courants comprennent : 

• Assurez-vous que le port configuré sur l’appareil SONOFF correspond au port sur lequel le courtier MQTT est réellement à l’écoute.

3. Nom d’utilisateur et mot de passe MQTT

Si l’authentification est activée sur le courtier, vérifiez :

• Nom d’utilisateur
• Mot de passe
• Si le compte est désactivé
• Si des autorisations ACL limitent le compte

Si le nom d’utilisateur ou le mot de passe est incorrect, l’appareil SONOFF risque de ne pas pouvoir établir de connexion MQTT.

4. Connexion réseau

• Assurez-vous que l’appareil SONOFF peut accéder au courtier MQTT. Par exemple :

Appareil SONOFF
192.168.1.50
     ↓
Courtier MQTT
192.168.1.100:1883

Si vous modifiez la configuration, redémarrez Home Assistant ou rechargez l’intégration MQTT avant de vérifier à nouveau.

3. Étape 2 : Connecter Home Assistant au courtier MQTT

Q3 : Mon appareil SONOFF indique « MQTT Connected », mais il n’apparaît pas dans Home Assistant. Que dois-je vérifier ?

Tout d’abord, vérifiez si Home Assistant lui-même s’est bien connecté au courtier MQTT.

L’appareil SONOFF et Home Assistant sont des clients MQTT indépendants :

              Courtier MQTT
             /           \
            /             \
   Appareil SONOFF           HA
        |                   |
    Connecté           Connecté ?

Une connexion réussie de l’appareil SONOFF ne signifie pas que Home Assistant est également connecté au courtier MQTT.

Q4 : Comment vérifier si Home Assistant est connecté au courtier MQTT ?

Dans Home Assistant, accédez à : Paramètres → Appareils et services → MQTT → Reconfigurer

Vérifiez que la configuration du courtier MQTT est correcte, notamment :

• Adresse IP du courtier
• Nom d’utilisateur
• Mot de passe

L’interface Web de Home Assistant utilise généralement le port 8123. Il est différent du port MQTT. Le port MQTT couramment utilisé est 1883.

Q5 : Le SONOFF OpenEdge et Home Assistant peuvent-ils utiliser des courtiers MQTT différents ?

En général, la découverte automatique ne fonctionne pas correctement s’ils utilisent des courtiers MQTT différents. Par exemple :

Appareil SONOFF
     ↓
Courtier A

Home Assistant
     ↓
Courtier B

Comme les deux systèmes sont connectés à des brokers différents, Home Assistant ne peut pas recevoir les messages MQTT publiés par l’appareil SONOFF.

La configuration normale est la suivante :

Appareil SONOFF ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Étape 3 : MQTT Discovery

Q6 : L’appareil OpenEdge et Home Assistant sont tous deux connectés au broker MQTT, mais l’appareil n’apparaît toujours pas dans Home Assistant. Que dois-je faire ?

À ce stade, vérifiez MQTT Discovery.

L’appareil doit transmettre ses informations d’appareil et d’entité à Home Assistant via MQTT Discovery.

• Dans Home Assistant, accédez à : Paramètres → Appareils et services → MQTT → Configurer → Configurer les options MQTT
• Vérifiez que l’option Activer la découverte est activée.
• Vérifiez également que le préfixe de découverte est défini sur la valeur par défaut : homeassistant

Si la découverte était désactivée, il ne suffira pas de l’activer et d’enregistrer les paramètres pour que Home Assistant relance immédiatement la recherche des appareils MQTT déjà connectés.

Veuillez redémarrer Home Assistant ou cliquer sur « Recharger » dans l’intégration MQTT afin que Home Assistant puisse se réabonner au sujet de découverte et identifier les appareils.

 

5. Problèmes liés au préfixe de découverte

Q8 : Qu’est-ce que le préfixe de découverte ?

Le préfixe de découverte est le préfixe de sujet utilisé par MQTT Discovery de Home Assistant.

Home Assistant utilise la valeur suivante par défaut : homeassistant

Q9 : La modification du préfixe de découverte Home Assistant affectera-t-elle l’intégration des appareils OpenEdge ?

Oui. Par exemple, si l’appareil utilise le préfixe par défaut : homeassistant

Cependant, si le préfixe de découverte Home Assistant a été modifié pour devenir : myhome

Home Assistant écoutera les sujets de découverte sous : myhome/...

Le chemin de communication serait alors le suivant :

Appareil
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
écoute myhome/...

Comme les deux préfixes ne correspondent pas, Home Assistant ne peut pas découvrir correctement l’appareil.

Recommandation

• Conservez le préfixe de découverte Home Assistant défini sur : homeassistant
• Ne le modifiez pas.
• Si le préfixe a été modifié auparavant et que cela a rendu l’appareil indisponible, le rétablir à sa valeur par défaut ne supprimera pas automatiquement les anciennes entités ni ne permettra de redécouvrir l’appareil.
• Dans ce cas, redémarrez Home Assistant ou rechargez l’intégration MQTT. Si les entités découvertes précédemment apparaissent toujours comme « Indisponibles », vous devrez peut-être supprimer les anciennes entités et redécouvrir l’appareil.

 

6. Problèmes liés aux environnements réseau particuliers

Q11 : Pourquoi MQTT fonctionne-t-il sur mon réseau local, mais cesse-t-il de fonctionner lorsque je passe à un réseau externe ?

Si le broker MQTT est déployé uniquement sur votre réseau local domestique :

Appareil SONOFF
     ↓
192.168.1.100:1883
     ↓
Réseau local domestique

Une fois l’appareil connecté à un autre réseau local, il quitte ce réseau :

Appareil SONOFF
    x
192.168.1.100

Il ne peut alors plus accéder au broker par l’adresse IP du réseau local.

Pour l’accès entre différents réseaux, envisagez :

• Broker MQTT avec adresse IP publique

Remarque de sécurité : Il est déconseillé d’exposer directement sur Internet un port MQTT non chiffré, comme 1883.

 

7. Problèmes fréquents dans les environnements Docker

Q12 : Home Assistant s’exécute dans Docker. Pourquoi ne peut-il pas se connecter au broker MQTT lorsque j’utilise localhost:1883 ?

Si Home Assistant et le broker MQTT s’exécutent dans des conteneurs Docker différents, localhost désigne généralement le conteneur Home Assistant, et non celui dans lequel s’exécute le broker MQTT.

Par exemple :

┌─────────────────────┐
│ Hôte Docker         │
│                     │
│ ┌───────────────┐   │
│ │ Home Assistant│   │
│ │ localhost     │   │
│ └───────────────┘   │
│                     │
│ ┌───────────────┐   │
│ │ Mosquitto     │   │
│ │ Port 1883     │   │
│ └───────────────┘   │
│                     │
└─────────────────────┘

Par conséquent, saisir localhost:1883 dans Home Assistant ne permet pas nécessairement de se connecter à Mosquitto.

Configuration recommandée

Si vous ne connaissez pas bien la configuration réseau de Docker, il est recommandé de saisir l’adresse IP du réseau local de l’hôte exécutant le broker MQTT. Par exemple :

Broker MQTT :
192.168.1.100

Port :
1883

Remplacez 192.168.1.100 par l’adresse IP réelle de l’hôte exécutant le broker MQTT.

Si Home Assistant et Mosquitto sont connectés au même réseau Docker, vous pouvez également utiliser le nom du conteneur Mosquitto, par exemple : mosquitto:1883

Remarque : Un nom de conteneur tel que mosquitto ne peut être utilisé qu’au sein du réseau Docker correspondant. En règle générale, les appareils SONOFF doivent utiliser l’adresse IP ou le nom de domaine de l’hôte exécutant le broker MQTT, plutôt que le nom du conteneur Docker.

Après avoir apporté des modifications, redémarrez le conteneur Home Assistant ou rechargez l’intégration MQTT pour appliquer la nouvelle configuration.