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

• Appareil SONOFF compatible avec OpenEdge — se connecte au broker en tant que client MQTT, publie les états et les données de l’appareil, et reçoit les commandes de contrôle.
• Broker MQTT — reçoit et distribue les messages MQTT entre les clients connectés. Dans les installations Home Assistant, Mosquitto est un choix courant.
• Home Assistant — se connecte au même broker via l’intégration MQTT, reçoit les mises à jour de l’appareil, envoie des commandes et gère l’appareil dans Home Assistant.

Configurer les appareils OpenEdge avec Home Assistant via MQTT

Configurons maintenant l’intégration MQTT. Ce guide utilise le SONOFF MINI-1GSP comme exemple, mais le même processus de base peut être utilisé avec d’autres appareils OpenEdge compatibles prenant en charge MQTT. 

Ce dont vous aurez besoin

Installer et configurer un broker MQTT

Ajouter l’intégration MQTT dans Home Assistant

Étape 1 : Mettre l’appareil sous tension

Pour le MINI-1GSP, l’appareil passe automatiquement en mode d’appairage lors de sa première mise sous tension. Lorsque la LED clignote deux fois brièvement, suivies d’un clignotement long, son point d’accès est prêt pour la configuration. 

Étape 2 : Accéder à la console web OpenEdge

Il existe deux façons d’accéder à la console web.

Méthode 1 : Accès via le point d’accès — recommandé pour la première configuration

• Ouvrez les paramètres Wi-Fi sur votre ordinateur de bureau, votre tablette ou votre appareil mobile.
• Connectez-vous au point d’accès de l’appareil : SONOFF_1GSP_xxxx.

• Ouvrez un navigateur web et accédez à : http://192.168.33.1
• La page de connexion à la console Web s’ouvre. Lors de votre première connexion, créez un mot de passe d’au moins 8 caractères.
  Connectez-vous pour accéder à la console Web OpenEdge.

Depuis la console Web, vous pouvez gérer les fonctions locales, notamment la commande MARCHE/ARRÊT, l’historique de la consommation d’énergie, les programmateurs, l’appairage Matter, les paramètres réseau, la configuration du point d’accès Wi-Fi, les mises à jour OTA et la section À propos d’OpenEdge.

Dans Paramètres de connectivité, vous pouvez configurer la connectivité Cloud , le MQTT pour Home Assistant, les options TLS et les connexions WebSocket sortantes pour les plateformes tierces.  

Méthode 2 : accéder via le réseau local

Si l’appareil est déjà connecté à votre réseau local, vous pouvez accéder directement à la console Web sans vous connecter à son point d’accès Wi-Fi.  
Pour le MINI-1GSP, ouvrez un navigateur sur un appareil pouvant accéder au même réseau local, puis saisissez l’une des adresses suivantes dans votre navigateur :

• MINI-1GSP.local
• L’adresse IP locale de l’appareil.

Étape 3 : connecter l’appareil à votre réseau Wi-Fi

Connectez l’appareil à un réseau Wi-Fi pouvant atteindre à la fois Home Assistant et votre broker MQTT, afin qu’ils puissent communiquer sur le réseau local.

• Accédez à Paramètres réseau → Paramètres Wi-Fi.
• Sélectionnez le réseau Wi-Fi auquel vous pouvez accéder depuis Home Assistant et le broker MQTT.
• Saisissez le mot de passe Wi-Fi.
• Cliquez sur Enregistrer.
• Attendez que l’appareil se connecte.

Une fois l’appareil connecté à votre réseau local, votre routeur lui attribue généralement une adresse IP locale via DHCP. Cette adresse s’affiche dans les paramètres Wi-Fi et peut être utilisée ultérieurement pour accéder au réseau local à la console Web, comme décrit dans la Méthode 2 ci-dessus.

Remarque : délai d’expiration du point d’accès Wi-Fi

Le MINI-1GSP quitte automatiquement le mode d’appairage après environ 10 minutes. Lorsque le mode d’appairage prend fin, le point d’accès Wi-Fi utilisé pour la première configuration n’est plus disponible.

Si le point d’accès Wi-Fi disparaît avant la fin de la configuration :

1. Si l’appareil est déjà connecté à votre réseau local, poursuivez la configuration via la méthode d’accès au réseau local décrite ci-dessus.
2. Si vous devez utiliser à nouveau le point d’accès Wi-Fi, maintenez le bouton de l’appareil enfoncé pendant 5 secondes pour réactiver le mode d’appairage.
3. Reconnectez-vous à SONOFF_1GSP_xxxx, ouvrez http://192.168.33.1, puis poursuivez la configuration.

Conseil : Maintenir le bouton de l’appareil enfoncé pendant 10 secondes effectue une réinitialisation d’usine.

Étape 4 : Activer MQTT et configurer les paramètres

• Accédez à Paramètres de connectivité → MQTT.
• Activer MQTT.
• Configurez les paramètres MQTT comme indiqué ci-dessous
• Lorsque les paramètres sont terminés, cliquez sur Enregistrer.

• Le champ Serveur doit pointer vers votre broker MQTT. Si le broker Mosquitto s’exécute sur le même hôte que Home Assistant, il s’agit généralement de l’adresse IP de l’hôte Home Assistant avec le port MQTT 1883, par exemple : 192.168.1.242:1883. 
• Si vous utilisez le broker Mosquitto officiel de Home Assistant et n’avez pas créé d’identifiants MQTT distincts (nom d’utilisateur et mot de passe), vous pouvez utiliser un nom d’utilisateur et un mot de passe Home Assistant existants.
• Si Mosquitto est déjà configuré avec un nom d’utilisateur et un mot de passe, saisissez les mêmes identifiants dans les paramètres MQTT de la console Web de l’appareil.

Étape 5 : Vérifier et contrôler l’appareil dans Home Assistant

• Après avoir enregistré les paramètres MQTT, reconnectez votre ordinateur, votre tablette ou votre appareil mobile au réseau local pouvant accéder à Home Assistant et au broker MQTT.
• Ouvrez Home Assistant, puis accédez à Paramètres → Appareils et services → MQTT  

L’appareil devrait déjà apparaître dans la liste des appareils MQTT. Les appareils SONOFF compatibles avec OpenEdge et prenant en charge MQTT publient nativement les informations MQTT Discovery de Home Assistant, ce qui permet à Home Assistant d’ajouter automatiquement l’appareil et de créer les entités prises en charge, sans configuration manuelle des rubriques MQTT ou du YAML.

• Ouvrez la page de l’appareil pour afficher les commandes et les entités disponibles. Pour l’appareil MINI-1GSP, elles comprennent notamment les fonctions suivantes :
  • Contrôle du relais
  • Courant
  • Tension
  • Puissance
  • Fréquence
  • Données énergétiques

Vous pourrez ensuite ajouter ces entités à votre tableau de bord Home Assistant ou les utiliser dans des automatisations et des scènes.

Appareils compatibles avec OpenEdge

Les produits SONOFF suivants prennent actuellement en charge OpenEdge :

• MINI-1GSP 
• MINI-1GP

D’autres appareils compatibles avec OpenEdge seront bientôt disponibles, notamment :

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

OpenEdge s’étendra également progressivement à d’autres catégories de produits SONOFF, notamment :

• Interrupteurs intelligents — offrant un contrôle local plus flexible et une intégration via des interfaces ouvertes.
• Produits de gestion de l’énergie — traitement local des données et suivi plus transparent de la consommation énergétique.
• Autres appareils connectés — connexion à davantage de plateformes et d’écosystèmes grâce aux capacités d’intégration ouvertes d’OpenEdge.

👉 Pour connaître les derniers appareils compatibles et les fonctionnalités disponibles après l’intégration à Home Assistant, consultez la liste de compatibilité des fonctionnalités Home Assistant pour les appareils SONOFF OpenEdge.  

Conclusion

SONOFF OpenEdge simplifie l’intégration à Home Assistant, en la rendant plus locale et plus flexible. Grâce à la console Web intégrée et à l’API locale standardisée d’OpenEdge via MQTT, les appareils SONOFF compatibles peuvent être configurés directement depuis un navigateur et intégrés localement à Home Assistant — pour une configuration simple, un contrôle local réactif et une automatisation plus flexible, sans dépendre du cloud pour l’intégration.