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 l’état 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 configurations 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 des 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 le voyant clignote deux fois brièvement, puis une fois longuement, 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 de votre ordinateur, tablette ou 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 de la console Web s’ouvrira. Lors de votre premier accès, créez un mot de passe de connexion 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 minuteries, 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 , MQTT pour Home Assistant, les options TLS et les connexions WebSocket sortantes vers des plateformes tierces.  

Méthode 2 : accès 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 : connectez 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 à la console Web via le réseau local, comme décrit dans la méthode 2 ci-dessus.

Remarque : 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 repasser en mode d’appairage.
3. Reconnectez-vous à SONOFF_1GSP_xxxx, ouvrez http://192.168.33.1, puis poursuivez la configuration.

Conseil : maintenez le bouton de l’appareil enfoncé pendant 10 secondes pour effectuer une réinitialisation d’usine.

Étape 4 : activez MQTT et configurez les paramètres

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

• Le champ Serveur doit pointer vers votre courtier MQTT. Si Mosquitto Broker 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 module officiel Mosquitto Broker 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 courtier 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 de découverte MQTT 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 ni de YAML.

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

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

Appareils compatibles avec OpenEdge

Le MINI-1GSP est le premier produit SONOFF à prendre en charge OpenEdge.
D’autres appareils compatibles avec OpenEdge arriveront bientôt, notamment :

• MINI-1GP
• MINI-1GS
• MINI-1GS10

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

• Interrupteurs connectés — contrôle local et intégration plus flexibles grâce à des interfaces ouvertes.
• Produits de gestion de l’énergie — traitement local des données et suivi de la consommation énergétique plus transparent.
• 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 prise en charge des fonctionnalités Home Assistant pour les appareils SONOFF OpenEdge].  

Conclusion

SONOFF OpenEdge rend l’intégration à Home Assistant plus simple, 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 le processus d’intégration.