Guide complet d'intégration des appareils SONOFF avec Home Assistant

Introduction

Home Assistant est une plateforme domotique open source populaire. Elle fonctionne sur Raspberry Pi, ordinateurs, NAS, etc., unifiant les appareils de différentes marques et protocoles en une seule plateforme.
Deux raisons principales de choisir Home Assistant :

• Fonctionnement local, souveraineté des données : Toutes les données restent sur votre propre serveur — aucune dépendance au cloud. Les appareils continuent de fonctionner même en cas de coupure internet, et vos habitudes d’utilisation ainsi que les données de scène restent privées.
  
• Écosystème ouvert, support riche des protocoles : Home Assistant prend en charge Zigbee, Wi-Fi, Matter, MQTT, Z-Wave, et pratiquement tous les principaux protocoles domotiques — intégrant des appareils de différentes marques dans une seule interface pour créer des automatisations communes.

SONOFF propose une large gamme d’appareils : modules de rénovation DIY, interrupteurs muraux, thermostats, vannes d’eau, divers capteurs, et plus encore. Pour rendre les appareils SONOFF accessibles aux utilisateurs de Home Assistant, SONOFF offre plusieurs voies d’intégration pour chaque protocole et type d’appareil.

Ce blog vous guide à travers chaque méthode d’intégration et vous aide à choisir celle qui correspond à vos besoins.

1. Appareils Zigbee

Zigbee est un protocole de réseau maillé basse consommation. Les appareils Zigbee de SONOFF incluent divers capteurs (détecteur de mouvement PIR, présence humaine, température/humidité, etc.), interrupteurs/prises intelligents, interrupteurs muraux, thermostats et vannes d’eau.

Il existe trois façons de connecter des appareils Zigbee à Home Assistant, couvrant tout, du « contrôle local pur » à la « synchronisation double plateforme ».

1.1 Connexion directe du Dongle

Comment ça fonctionne : La plupart des hôtes Home Assistant n’ont pas de capacité radio Zigbee intégrée — un Dongle Zigbee (adaptateur) est nécessaire pour envoyer et recevoir les signaux Zigbee. La série SONOFF Dongle est un produit phare dans ce domaine.

Appareils compatibles : Presque tous les appareils SONOFF Zigbee peuvent être connectés via un Dongle.
Méthode d’intégration :

Après avoir configuré le Dongle dans Home Assistant via l’intégration ZHA (Zigbee Home Automation) ou Zigbee2MQTT (Z2M), les appareils SONOFF Zigbee sont automatiquement détectés et ajoutés en tant qu’entités dans Home Assistant, prêts pour les automatisations et les scènes.

• ZHA : Intégré dans Home Assistant Core ; configuration simple, adapté à la plupart des utilisateurs
  
• Zigbee2MQTT : Fonctionnalités plus riches, écosystème communautaire plus large, supporte plus de types d'appareils et d'options de personnalisation

*Si vous ne savez pas quel Dongle choisir, consultez le Guide de sélection des Dongles SONOFF :

https://sonoff.tech/blogs/news/sonoff-zigbee-thread-dongle-choosing-guide

*Pour des étapes détaillées d'installation ou de dépannage, visitez le site dédié au Dongle :

https://dongle.sonoff.tech/

⚠️ Important : Les appareils Zigbee ajoutés via Dongle apparaissent uniquement dans Home Assistant — ils ne peuvent pas être contrôlés depuis l'application eWeLink. Si vous devez gérer les appareils à la fois depuis Home Assistant et eWeLink, consultez l'option Matter Bridge ci-dessous.

1.2 Synchronisation Matter Bridge

Comment ça marche : Le ZBBridge-U (Passerelle Zigbee Ultra) et le NSPanel Pro de SONOFF sont des appareils avec une double fonctionnalité intégrée : passerelle Zigbee + Matter Bridge. Vous pouvez d'abord ajouter les appareils Zigbee SONOFF à l'application eWeLink, puis les synchroniser avec Home Assistant en tant qu’« appareils Matter locaux » via le protocole Matter Bridge.

Pourquoi choisir Matter Bridge ?

• Contrôle double plateforme : Les appareils sont gérables à la fois dans l'application eWeLink (contrôle à distance, automatisation de scènes) et dans Home Assistant
• Communication locale : Après synchronisation avec Home Assistant, les appareils fonctionnent comme des appareils Matter standard — la communication est entièrement basée sur le LAN, sans dépendance au cloud
• Large compatibilité d'appareils : Pas seulement les sous-appareils Zigbee — synchronise aussi les appareils Wi-Fi sur le LAN et les télécommandes de scène eWeLink-Remote
  

Idéal pour :

• Utilisateurs souhaitant contrôler les appareils à la fois depuis Home Assistant et eWeLink
• Utilisateurs déjà familiers avec l'écosystème eWeLink qui ne veulent pas renoncer au contrôle à distance via l'application

1.3 Synchronisation MQTT

Idéal pour : Les utilisateurs familiers avec l'intégration MQTT de Home Assistant qui ont besoin de préserver les capacités et les réglages des appareils au-delà de ce que définit la norme Matter.
Le protocole Matter définit un ensemble standardisé de capacités des appareils (par exemple, marche/arrêt), mais certains appareils SONOFF disposent de fonctionnalités étendues spécifiques au fabricant. Ces fonctionnalités peuvent être conservées en mode de connexion directe MQTT, tandis qu'elles peuvent être simplifiées en mode de synchronisation Matter Bridge.

Note : L'intégration MQTT nécessite certaines connaissances en configuration ainsi que NSPanel Pro ou ZBBridge-U.

*Pour des étapes de configuration détaillées, voir :

https://sonoff.tech/blogs/news/how-to-sync-zigbee-sub-devices-to-home-assistant-via-mqtt

2. Appareils Wi-Fi

Les appareils Wi-Fi SONOFF incluent divers modules de rénovation, interrupteurs muraux, prises, et plus encore — répartis dans toute la maison, contrôlant les lumières dans différentes pièces. Selon que l'appareil prend en charge le protocole Matter ou non, il existe différentes façons de les ajouter à Home Assistant.

2.1 Appareils certifiés Matter — Ajout direct

Idéal pour : Les appareils avec un badge de certification Matter (vérifiez la page produit ou l'emballage pour le badge Matter).

Matter est le protocole d'interopérabilité domotique de nouvelle génération piloté par la CSA (Connectivity Standards Alliance). Les appareils certifiés Matter ont un avantage de « standardisation » : les capacités des appareils sont définies par le protocole lui-même, donc les ajouter à n'importe quelle plateforme compatible Matter (Home Assistant, Apple Home, Google Home, etc.) ne nécessite aucun pilote ou plugin supplémentaire.

Étapes de configuration :

1. Assurez-vous que l'intégration Matter est installée dans Home Assistant (ajoutez-la via « Paramètres → Appareils & Services »)

2. Ouvrez l'application eWeLink avec votre appareil lié et confirmez que l'appareil est en ligne

3. Dans Home Assistant, recherchez et ajoutez un appareil Matter, puis scannez le code QR avec l'application eWeLink comme demandé pour finaliser l'appairage

Une fois ajouté, l'appareil apparaît dans Home Assistant comme un appareil Matter standard — toutes les fonctionnalités standard (état de l'interrupteur, contrôle de la luminosité, etc.) fonctionnent immédiatement.

*Documentation officielle Matter de Home Assistant : 

https://www.home-assistant.io/integrations/matter

2.2 Appareils non-Matter — Synchronisation via Matter Bridge ou module eWeLink

Idéal pour : Les modèles plus anciens sans prise en charge du firmware Matter, où vous souhaitez toujours voir et contrôler les appareils depuis Home Assistant.

Ces appareils peuvent être synchronisés avec Home Assistant via Matter Bridge ou le module complémentaire eWeLink Smart Home. La fonctionnalité Matter Bridge est décrite ci-dessus. Le module complémentaire eWeLink Smart Home fonctionne en téléchargeant le module dans Home Assistant et en vous connectant à votre compte eWeLink — les appareils synchronisés apparaissent sous forme de cartes d'entité dans Home Assistant, prenant en charge des opérations de base comme l'activation des interrupteurs.

Pour les détails sur l'Add-on, voir :

https://github.com/iHost-Open-Source-Project/hassio-ihost-addon

3. Appareils eWeLink-Remote

eWeLink-Remote est la solution de télécommande de scène locale de SONOFF conçue pour l'application eWeLink. Les appareils typiques incluent :

• R5 : télécommande multi-scène, prend en charge la liaison de plusieurs appareils ou scènes simultanément
• S-mate2 : interrupteur DIY, conçu pour fonctionner avec des interrupteurs externes

Désormais, les appareils eWeLink-Remote prennent en charge l'intégration avec Home Assistant via Matter Bridge — vous pouvez les utiliser comme télécommandes de scène locales dans Home Assistant.

Comment ça fonctionne : utilisez la fonction Matter Bridge sur ZBBridge-U ou NSPanel Pro pour synchroniser les appareils eWeLink-Remote avec Home Assistant, puis configurez des automatisations locales déclenchées par la télécommande.

 

Il n'existe pas de "bonne réponse" unique pour connecter les appareils SONOFF à Home Assistant — cela dépend de vos habitudes d'utilisation et de vos priorités :

Si vous recherchez un contrôle local pur, stable et ultime, la connexion directe par Dongle est le meilleur choix ;

Si vous souhaitez une synergie entre les deux plateformes Home Assistant et eWeLink, Matter Bridge offre une expérience plus équilibrée ;

Pour les utilisateurs ayant des compétences en bricolage qui souhaitent conserver davantage de fonctionnalités étendues des appareils, MQTT offre une plus grande liberté ;

Par ailleurs, à mesure que l'écosystème Matter mûrit, de plus en plus d'appareils Wi-Fi peuvent bénéficier d'une expérience d'intégration "prête à l'emploi" grâce à la normalisation.

SONOFF continuera à soutenir l'écosystème de la communauté open-source, vous offrant une vie intelligente plus pratique et confortable.