Module complémentaire Home Assistant : guide complet des principaux ajouts et intégrations

Informatec Digital » Ressources » Module complémentaire Home Assistant : guide complet des principaux ajouts et intégrations

Si vous vous intéressez à la domotique, vous finirez forcément par entendre parler de Home Assistant et de son vaste écosystème de plugins, d'extensions et d'intégrations . Le problème, c'est que lorsque vous recherchez quelque chose d'aussi précis que « plugin Home Assistant », vous vous retrouvez face à une multitude d'informations : extensions, intégrations, HACS, Matter, Zigbee, Z-Wave… et au final, vous ne savez plus par où commencer.

Ce guide vous apportera toutes les réponses. Nous verrons ce qu'est un plugin Home Assistant, les différents types disponibles et ceux qui sont essentiels pour configurer une maison connectée stable, sécurisée et facile à gérer. Nous passerons également en revue les concepts clés de Zigbee, Z-Wave, MQTT et Matter, ainsi que les bonnes pratiques pour éviter que votre réseau ne devienne un véritable cauchemar à chaque mise à jour ou ajout d'un nouvel appareil.

Que signifie réellement le terme « plug-in » dans Home Assistant ?

Lorsque nous parlons de « plugins » dans Home Assistant, nous faisons en réalité référence à plusieurs éléments : les modules complémentaires, les intégrations et les extensions communautaires (HACS) . Il est essentiel de comprendre la différence pour éviter les problèmes lors de l’installation ou des mises à jour.

D'une part, il y a les modules complémentaires : de petites applications ou services qui s'exécutent au sein de Home Assistant OS ou de Home Assistant Supervised. Il ne s'agit pas de simples configurations ; ce sont des services complets (serveurs MQTT, éditeurs de code, proxys, VPN, etc.) que Supervisor gère comme des conteneurs, avec leur propre configuration et leurs propres journaux.

Ensuite, il y a les intégrations . Celles-ci permettent à Home Assistant de communiquer directement avec vos appareils ou services : Zigbee, Z-Wave, Philips Hue, caméras, services cloud, etc. Elles sont gérées depuis la section Intégrations de l’interface et constituent la méthode « officielle » pour connecter des éléments au système.

Enfin, il y a HACS (Home Assistant Community Store) , qui fonctionne comme une boutique communautaire pour les plugins : cartes Lovelace, intégrations non officielles, thèmes et outils qui ne sont pas inclus de série mais qui étendent considérablement vos possibilités.

Détail important : les modules complémentaires sont uniquement disponibles dans Home Assistant OS et Home Assistant Supervised , car ce sont les versions qui intègrent Supervisor. Si vous utilisez Home Assistant Container ou Core installé directement sur Linux, vous pouvez utiliser les intégrations, mais vous devrez configurer vous-même les modules complémentaires en tant que services distincts.

Modules complémentaires essentiels pour que Home Assistant fonctionne correctement

Il existe des dizaines d'options, mais certaines sont quasiment indispensables au bon fonctionnement d'une maison connectée moderne . Elles ne sont peut-être pas les plus tape-à-l'œil, mais sans elles, tout s'écroule comme un château de cartes.

Z-Wave JS (anciennement Zwavejs2mqtt)

Si vous utilisez des appareils Z-Wave, l'extension Z-Wave JS est essentielle au système. Elle assure la liaison entre votre réseau Z-Wave et Home Assistant , gère la clé USB (comme l'Aeotec Z-Stick 7 Plus) et permet d'afficher les capteurs, les lumières, les prises, les serrures et autres appareils comme des entités dans Home Assistant.

Dans de nombreux foyers, la plupart des systèmes domotiques essentiels (éclairage, interrupteurs, détecteurs de mouvement, ouvre-portes de garage, voire certains systèmes d'alarme ) reposent sur des dizaines d'appareils Z-Wave . Sans ce module complémentaire, ces appareils seraient tout simplement incompatibles avec Home Assistant.

Zigbee : Zigbee2MQTT et ZHA

Dans l'univers Zigbee, deux solutions principales s'offrent à vous : Zigbee2MQTT, un module complémentaire, ou ZHA (Zigbee Home Automation), une intégration native . Toutes deux transforment votre coordinateur USB Zigbee en hub d'un réseau maillé de capteurs, prises, éclairages et télécommandes.

ZHA, quant à lui, est l' intégration officielle de Zigbee dans Home Assistant . Il utilise la bibliothèque zigpy pour communiquer avec différents types de coordinateurs (Silicon Labs, Texas Instruments, ConBee/RaspBee, ZiGate, XBee, etc.) et configure le réseau directement depuis l'interface de HA, sans nécessiter de service intermédiaire.

Dans les deux cas, ce qu'ils recherchent est la même : mettre en place un réseau Zigbee stable avec un coordinateur, plusieurs routeurs et de nombreux terminaux , en tirant parti du réseau maillé pour avoir une portée et une capacité suffisantes.

Zigbee en détail avec ZHA : les concepts à comprendre

L'intégration ZHA est devenue l'une des méthodes les plus fiables et simples pour intégrer Zigbee à Home Assistant . Elle permet de remplacer les hubs propriétaires classiques (Hue, Aqara, etc.) et de centraliser tous les dispositifs dans un seul système local.

Principes de base de Zigbee

Avant de vous attaquer aux problèmes de configuration et d'appairage des appareils, il est utile de comprendre le fonctionnement de Zigbee. Le réseau se compose de trois types d'éléments : le coordinateur, les routeurs et les dispositifs finaux.

• Coordinateur ZigbeeIl s'agit de l'adaptateur principal (généralement un périphérique USB branché sur le même ordinateur que celui où Home Assistant est installé). Chaque réseau Zigbee ne peut en avoir qu'un seul.
• Routeurs Zigbee: appareils alimentés par le réseau électrique (prises, ampoules, ventilateurs…) qui répètent le signal et permettent d’étendre la portée et le nombre de nœuds.
• Dispositifs terminauxIls sont généralement alimentés par batterie (détecteurs de mouvement, capteurs de température, télécommandes, etc.) et sont connectés au coordinateur ou à un routeur à proximité.

Le principe de Zigbee est qu'il forme un réseau maillé : les routeurs se transmettent des messages, ce qui permet de couvrir des zones de la maison éloignées du coordinateur sans avoir besoin d'augmenter la puissance d'émission.

Sélection du coordinateur et compatibilité

ZHA est compatible avec de nombreux coordinateurs, à condition qu'ils utilisent la bibliothèque Zigpy . Les coordinateurs recommandés s'appuient sur les puces Silicon Labs EmberZNet (EZSP) ou Texas Instruments (Z-Stack), et il prend également en charge ConBee/RaspBee de Dresden Elektronik.

Davantage de matériel est compatible (ZiGate, XBee, anciens modèles Silabs ou TI), mais la documentation précise que tous les adaptateurs n'offrent pas le même niveau de stabilité et de support . Pour une installation de grande envergure, il est préférable d'opter pour un coordinateur moderne et éprouvé.

Canaux Zigbee et coexistence avec le Wi-Fi

Le protocole Zigbee 2,4 GHz utilise 16 canaux, du 11 au 26. Le problème réside dans sa coexistence avec le Wi-Fi : les deux réseaux peuvent facilement se chevaucher. Il est généralement recommandé d'utiliser les canaux 15, 20 ou 25, qui permettent généralement de limiter les interférences avec les canaux Wi-Fi domestiques classiques.

Depuis la page du réseau ZHA, vous pouvez modifier le canal Zigbee . Une option « Intelligente » analyse les canaux disponibles et sélectionne celui qui semble le plus approprié, en privilégiant les canaux 15, 20 et 25. Cette modification est à effectuer une seule fois : les appareils peuvent mettre jusqu’à une heure pour se reconnecter. Il est donc préférable de procéder à cette opération lorsque le réseau est peu sollicité.

Gestion et migration du réseau Zigbee

ZHA ne se limite pas à l'appairage d'appareils. Il inclut des informations réseau détaillées (canal, identifiant PAN, adresse IEEE du coordinateur, type de radio, port série, débit en bauds, etc.) et, surtout, un système de sauvegarde et de migration du coordinateur très performant.

Lorsque vous créez une copie depuis ZHA, vous pouvez migrer l'intégralité de votre réseau vers un autre adaptateur (par exemple, d'une clé USB ancienne vers une plus récente) sans avoir à réappairer tous les périphériques. Le processus peut même cloner l'adresse IEEE du coordinateur afin que les nœuds continuent de reconnaître le réseau comme identique.

Comment appairer, organiser et maintenir un réseau Zigbee stable

Détecter votre coordinateur pour ZHA est une chose, mais assurer le bon fonctionnement du réseau en est une autre. La réussite repose en grande partie sur le positionnement des appareils, le choix des routeurs et la prévention des interférences.

Associez les appareils à ZHA

Pour ajouter un nouvel appareil avec ZHA, il suffit d'aller dans Paramètres > Zigbee > Ajouter un appareil , d'ouvrir le réseau pour autoriser les nouveaux ajouts et de mettre l'appareil en mode de couplage ou d'effectuer une réinitialisation d'usine (conformément aux instructions du fabricant).

Il est recommandé d'appairer les appareils directement à leur emplacement définitif , et non à proximité du coordinateur, puis de les déplacer. Si vous les appairez juste à côté du coordinateur et que vous les déplacez ensuite au fond de la maison, leurs itinéraires risquent d'être sous-optimaux ou instables.

En cas de problème, vérifiez trois points : les interférences, le nombre et la qualité des routeurs, et l’état de la batterie . De nombreux appareils Zigbee dont la batterie est faible ne parviennent pas à passer en mode appairage.

Utilisation du routeur Zigbee et limites des appareils

Chaque coordinateur a une limite quant au nombre de périphériques enfants directs (périphériques finaux qui lui sont directement connectés). Zigpy fonctionne généralement avec un maximum de 32 périphériques enfants directs, mais cela ne signifie pas que le réseau est limité à 32 appareils : avec des routeurs, on peut facilement en atteindre des centaines.

L'idée est de remplir la maison de routeurs Zigbee toujours allumés : prises, ampoules qui n'ont jamais besoin d'être éteintes, modules intégrés, etc. Chaque routeur peut, à son tour, accepter plusieurs appareils enfants, et c'est ainsi que l'on peut faire évoluer le système.

Prenons un exemple simple : un coordinateur limité à 32 appareils et trois routeurs pouvant chacun gérer 16 appareils pourraient atteindre un total de 77 unités. Dans la réalité, pour une fiabilité optimale, il est toujours préférable de privilégier un plus grand nombre de routeurs et un meilleur emplacement plutôt que de chercher à atteindre la limite théorique d'appareils connectés.

Visualisation de la topologie et de la qualité des liens

ZHA inclut une carte réseau qui permet de visualiser la connexion des nœuds . Elle affiche les relations multi-sauts et, si l'appareil les fournit, les valeurs RSSI et LQI.

Ces chiffres sont à prendre avec précaution : chaque fabricant calcule le RSSI et le LQI à sa manière , ce qui les rend difficilement comparables. Ils sont surtout utiles pour détecter les problèmes majeurs : un appareil connecté à un routeur unique et éloigné, des valeurs constamment très basses, des interruptions inattendues dans le réseau maillé, etc.

Interférence et placement du coordinateur

L'un des principaux ennemis du Zigbee est le bruit généré par les ports et câbles USB 3.x, les routeurs Wi-Fi et les boîtiers métalliques . Un adaptateur Zigbee connecté à un NAS équipé de disques durs, d'un routeur Wi-Fi et d'un enchevêtrement de câbles est presque assurément source de problèmes.

Les règles de base pour améliorer le réseau sont claires : utiliser un câble d’extension USB 2.0 bien blindé, placer le coordinateur au centre de la maison, le tenir éloigné des routeurs Wi-Fi et autres appareils bruyants et, si possible, utiliser une clé avec une antenne externe.

MQTT, Mosquitto et leur importance

De nombreux plugins essentiels pour Home Assistant utilisent MQTT comme couche de communication légère et flexible . C'est le cas de Zigbee2MQTT, de certains ponts Z-Wave plus anciens et de nombreux projets DIY.

L'extension Mosquitto implémente un courtier MQTT complet au sein de Home Assistant.

Si vous ouvrez un client comme MQTT Explorer, vous verrez une multitude de sujets et de messages en circulation constante : relevés de capteurs, états des appareils, commandes de mise sous tension et hors tension . Lorsque votre réseau Zigbee et Z-Wave est intégré via MQTT, le courtier devient un élément absolument essentiel.

Automatisation avancée avec Node-RED et automatisation native

Home Assistant a considérablement amélioré son éditeur d'automatisation visuelle . Plus besoin de se débattre avec YAML pour les tâches simples… mais lorsque la logique se complexifie, Node-RED reste un outil très puissant.

Node-RED s'installe comme extension et propose une interface web permettant de créer des flux par simple glisser-déposer. Ces flux enchaînent conditions, temporisateurs, appels de service et traitements de données. Il est particulièrement utile pour l'automatisation, car la visualisation du flux sous forme de diagramme facilite la compréhension de son fonctionnement.

Nombreux sont ceux qui combinent les deux : des automatisations simples dans l’éditeur natif de Home Assistant et des flux de travail plus complexes (logique de planification complexe, intégration de plusieurs sources de données, etc.) dans Node-RED. Ce n’est pas obligatoire, mais cela offre une grande flexibilité.

Modules complémentaires pour le développement, l'administration et l'accès à distance

Au-delà de la simple couche domotique, il existe un certain nombre de plugins qui facilitent grandement la gestion quotidienne et l'extension de Home Assistant.

Serveur de code Studio

Studio Code Server intègre une version de Visual Studio Code directement dans le navigateur, sous forme d'extension pour Home Assistant. Il permet de modifier les fichiers configuration.yaml, les automatisations, les scripts et tout autre fichier sans quitter l'interface.

Il inclut la coloration syntaxique, la saisie semi-automatique pour les schémas YAML et Home Assistant , et vous permet de personnaliser l'éditeur, d'installer des extensions et de téléverser des fichiers. Indispensable pour quiconque effectue encore de nombreuses configurations manuelles.

Terminal SSH et Web avancé

Ce module complémentaire offre un terminal SSH accessible via un navigateur, compatible avec les clés et proposant des options avancées. C'est la solution la plus pratique pour exécuter des commandes sur l'hôte, consulter les journaux, installer HACS ou effectuer des réglages mineurs sans avoir recours à un client SSH externe.

Il est également très utile pour les diagnostics : lorsqu’un système ne démarre pas, un journal système ou une commande « docker ps » bien exécutée vous épargnera bien des soucis.

Tailscale et Cloudflare pour un accès distant sécurisé

Si vous souhaitez accéder à Home Assistant depuis l'extérieur de votre domicile, plusieurs options s'offrent à vous, mais deux modules complémentaires se distinguent par leur sécurité : Tailscale et Cloudflared.

Tailscale configure un VPN maillé entre vos appareils , basé sur WireGuard mais avec une configuration beaucoup plus conviviale.

Cloudflare, en revanche, crée des tunnels chiffrés entre votre instance Home Assistant et son réseau . Cela vous permet d'exposer Home Assistant sur Internet sans ouvrir de ports, grâce à votre propre nom de domaine et aux certificats gérés par Cloudflare. C'est l'une des solutions les plus sûres et les plus simples pour bénéficier d'un accès distant permanent, moyennant la nécessité d'un nom de domaine et d'une configuration initiale.

Surveillance, confidentialité et services supplémentaires qui font toute la différence

Une fois les bases établies (Zigbee/Z-Wave, MQTT, automatisation et accès à distance), il est temps de peaufiner l'expérience avec des modules complémentaires qui améliorent la visibilité, la sécurité et la commodité.

Disponibilité Kuma

Uptime Kuma est un outil de surveillance de la disponibilité qui s'utilise comme extension pour superviser votre Home Assistant, vos autres services réseau, vos appareils critiques, vos caméras, etc. Il vous permet de configurer des contrôles HTTP, des requêtes ping, des vérifications de ports et de certificats, et de recevoir des alertes en cas de panne.

Grâce à ses tableaux de bord et à ses graphiques, il est facile de repérer les schémas de pannes, les temps de réponse et les petits problèmes intermittents qui passeraient normalement inaperçus.

AdGuard Accueil

Son intégration en tant qu'extension dans Home Assistant vous permet de centraliser les statistiques de navigation, d'améliorer la confidentialité et d'augmenter la vitesse de chargement sur votre réseau domestique, ainsi que d'offrir des contrôles parentaux et des listes noires personnalisées.

Grocy, Jellyfin, Music Assistant et autres services utiles

Home Assistant ne se limite pas aux lumières et aux prises électriques. Grâce à ses extensions, il devient un véritable centre névralgique pour la gestion de votre maison et vos divertissements.

• Épicerie: gestionnaire d'inventaire (garde-manger), tâches ménagères et planification qui s'intègre à HA pour créer des rappels et des automatisations basés sur les dates d'expiration ou les stocks.
• JellyfinServeur multimédia open source qui organise et diffuse vos films, votre musique et vos séries sans frais ni cloud externe.
• Assistante musicaleCouche de gestion audio multiroom qui intègre les sources locales, les radios en ligne et les services de streaming sous le contrôle centralisé de Home Assistant.

ESPHome, Frigate et Matter : l’avenir des plugins dans le domaine de la domotique

L'un des principaux atouts de Home Assistant est sa capacité à simplifier la réalisation de projets DIY (Do It Yourself) lorsqu'on souhaite aller au-delà des solutions disponibles en magasin . C'est là qu'interviennent ESPHome, Frigate et Matter Bridge.

ESPHome pour les appareils DIY basés sur ESP

ESPHome est quasiment indispensable si vous aimez bricoler. Il vous permet de configurer et de gérer des appareils basés sur ESP8266/ESP32 (capteurs, relais, écrans, etc.) à l'aide de YAML et grâce aux mises à jour OTA intégrées.

Depuis Home Assistant, vous pouvez compiler le firmware, l'installer et maintenir tous vos appareils à jour. Vos appareils personnalisés fonctionnent ainsi comme des intégrations officielles , avec des entités entièrement exposées et sans dépendre de services cloud chinois.

Frigate en tant que NVR intelligent

Frigate est un enregistreur vidéo réseau (NVR) doté d' une détection d'objets par IA en temps réel . Il s'intègre à Home Assistant et peut déclencher des automatisations lorsqu'il détecte des personnes, des véhicules, des animaux, etc., sur vos caméras IP.

Cela permet de créer avec une grande précision des scénarios tels que « si une personne se trouve dans le jardin et que l'alarme est activée, envoyer une notification et allumer les lumières » , en évitant les fausses alarmes dues aux mouvements des arbres, à la pluie, etc.

Matter Bridge et les écosystèmes externes

Matter Bridge sert de passerelle entre les appareils Matter et Home Assistant sans nécessiter de réappairage. De plus, il permet d'afficher vos entités HA comme des appareils Matter auprès d'autres systèmes de contrôle (tels que Google Home, Apple HomeKit, etc.).

Doté d'une interface simple et évolutive, cet outil deviendra essentiel à mesure que de nouveaux appareils Matter apparaîtront sur le marché et que vous souhaiterez tous les contrôler via Home Assistant sans renoncer à vos assistants vocaux habituels.

Sauvegardes : le module complémentaire qui ne semble pas urgent… jusqu’à ce qu’il le devienne.

Enfin, et surtout : sans système de sauvegarde fiable, vous prenez des risques . Home Assistant est fréquemment mis à jour, les extensions évoluent constamment et les pannes matérielles ne sont pas rares.

Des modules complémentaires comme Samba Backup ou Home Assistant Google Drive Backup vous permettent d'automatiser des sauvegardes complètes de votre instance et de les enregistrer hors site (sur un NAS via Samba, Google Drive, etc.). L'objectif est de pouvoir restaurer l'intégralité de votre installation ou un module complémentaire spécifique sans perdre des semaines de travail.

L'expérience de nombreux utilisateurs montre clairement qu'une restauration système majeure est tôt ou tard inévitable . Disposer de sauvegardes récentes, testées et accessibles fait toute la différence entre une simple frayeur et la nécessité de reconstruire entièrement son système domotique.

Avec tous ces plugins et concepts clairement expliqués — de ZHA et MQTT aux modules complémentaires pour le développement, la surveillance, l'accès à distance et les sauvegardes — il devient évident que Home Assistant est bien plus qu'une simple application d'éclairage : c'est une plateforme complète où les bons plugins transforment une installation standard en un écosystème domotique robuste, flexible et entièrement contrôlé, à condition de consacrer du temps au choix des éléments et à la compréhension de leur fonctionnement.