Introduction
Dans un monde de plus en plus connecté, l’automatisation domestique joue un rôle clé pour améliorer le confort, la sécurité et l’efficacité énergétique de nos habitations. Home Assistant, une plateforme open source puissante et flexible, se distingue comme l’une des solutions les plus populaires pour centraliser et contrôler divers appareils connectés. Compatible avec une multitude de protocoles et d’appareils, elle permet de gérer des lumières, des thermostats, des capteurs, et bien plus encore, le tout depuis une interface unique et personnalisable.
L’objectif de ce tutoriel est de guider pas à pas l’installation et la configuration de Home Assistant OS (HAOS) sur un Raspberry Pi 4. Ce guide se concentre également sur l’intégration du Raspbee2, un module performant servant de coordinateur Zigbee, pour connecter et contrôler facilement des appareils domotiques utilisant ce protocole (si vous possédez une clé Sonoff, les commandes de configurations seront également partagées). En suivant ce tutoriel, vous obtiendrez un système domotique robuste, flexible et adapté à vos besoins. Une alternative avec une clé Zigbee Sonoff sera également expliquée pour ceux qui préfèrent cette option.
Ce tutoriel s’adresse aussi bien aux débutants qu’aux utilisateurs expérimentés souhaitant configurer un système domotique performant. Avec Home Assistant et le module Raspbee2, vous serez en mesure de créer un environnement intelligent, où vos appareils communiquent et interagissent harmonieusement pour répondre à vos besoins quotidiens.
1. Préparation du matériel
1.1 Matériel requis
Avant de commencer l’installation de HAOS sur votre Raspberry Pi 4, il est crucial de réunir tout le matériel nécessaire et de préparer correctement votre carte SD pour garantir une installation sans problème.
- Raspberry Pi 4 (4 Go ou 8 Go de RAM recommandé) : c’est la plateforme qui exécutera Home Assistant OS.
- Carte microSD (32 Go ou plus, classe 10 minimum) : elle contiendra le système d’exploitation HAOS.
- Alimentation 5V, 3A avec connecteur USB-C : assurez-vous qu’elle est de bonne qualité pour éviter des coupures de tension.
- Module Raspbee2 : ce coordinateur Zigbee se connecte aux pins GPIO du Raspberry Pi pour permettre la communication avec vos appareils Zigbee.
- Câble réseau Ethernet (optionnel) : recommandé pour une connexion réseau stable durant la configuration initiale (peut être remplacé par le Wi-Fi si nécessaire).
Pourquoi le Raspbee2 ? Ce module compact s’intègre parfaitement au Raspberry Pi via les broches GPIO, permettant un design minimaliste et pratique. Cela facilite son intégration dans un boîtier personnalisé.
1.2 Préparation de la carte SD
Dans un premier temps, il nous faut télécharger les logiciels nécessaires à la création d’une carte SD pour l’OS « HAOS ».
Commençons par télécharger Raspberry Pi Imager sur le site officiel Raspberry Pi. Puis lancez le logiciel.
Sélectionnons notre modèle, raspberry Pi 4 puis choisir le système d’exploitation, Choisir l’OS > Other specific-purpose OS > Home assistants and home automation > Home Assistant > version pour RPi4/400. Enfin, il nous faut sélectionner notre emplacement de stockage.
Lançons l’écriture en cliquant sur Write.
Avant de remettre la carte SD dans le raspberry, on va créer un fichier nommé ssh sans extension et on va le glisser à la racine des dossiers de la carte SD. Cette manipulation va permettre d’autoriser la connexion ssh du raspberry. On pourra ensuite administrer à distance notre serveur.
2. Installation de Home Assistant OS (HAOS)
Une fois le matériel préparé et la carte SD configurée, nous allons procéder à l’installation de HAOS sur le Raspberry Pi4.
Pour commencer, nous allons connecter le coordinateur Zigbee
2.1 Configuration du coordinateur zigbee : raspbee2
Le coordinateur Zigbee est l’élément central qui permet de connecter vos appareils domotiques utilisant ce protocole.
Débranchons le RPi4, retirons la carte SD et la brancher sur notre ordinateur. Il faut modifier le fichier config.txt situé à la racine de la carte SD. Nous allons activer UART, I2C et RTC en ajoutant les lignes suivantes.
enable_uart=1
dtparam=i2c_arm=on
dtparam=i2c_vc=on
dtoverlay=miniuart-bt
dtoverlay=i2c-rtc,pcf85063
Sauvegarder le fichier et remettre la carte SD dans le RPi4.
Pour la clé Sonoff Dongle 3.0, il suffit seulement de la brancher dans un port USB. Aucun paramétrage du fichier config.txt n’est nécessaire.
Une fois le coordinateur installé, démarrez votre Raspberry Pi et accédez à l’interface Home Assistant à partir de l’adresse http://homeassistant.local:8123. Suivez les instructions pour finaliser la configuration initiale. Passons maintenant à la préparation de notre réseau zigbee.
Il existe deux outils pour intégrer des produits sous zigbee dans HA. Nous pouvons utiliser Zigbee Home Automation (ZHA),une intégration native de HA, ou Zigbee2MQTT (Z2M), une solution indépendante offrant davantage de possibilités de personnalisation. Cependant, ce dernier nécessite un certain nombre d’opération de paramétrage de notre système. C’est la solution que j’ai choisie.
| Caractéristique | Zigbee2MQTT | ZHA |
| Simplicité d’installation | ⚠️ Nécessite MQTT et configuration manuelle | ✅ Intégration native et facile à configurer |
| Compatibilité des appareils | ✅ Très large, supporte de nombreux appareils | ⚠️ Bonne, mais certains appareils peuvent manquer |
| Personnalisation | ✅ Paramètres avancés disponibles | ⚠️ Options limitées |
| Indépendance | ✅ Fonctionne indépendamment de Home Assistant | ⚠️ Dépend de Home Assistant |
| Diagnostic et logs | ✅ Journaux détaillés et complets | ⚠️ Fonctionnalités de base |
Pour l’utilisation de ZHA, allez dans Paramètres > Appareils et services > Ajouter une intégration.
Recherchez « ZHA ». Si vous utilisez le module Rasbee2, cochez /dev/ttyAMA0 puis appuyez sur valider. Si vous utilisez la clé USB Sonoff, cochez /dev/ttyUSB0 puis appuyez sur valider. Suivez les instructions pour terminer la configuration.
Si vous préférez plus de personnalisation et que vous souhaitez installer Zigbee2MQTT, suivez la suite du tutoriel.
2.2 Installation de MQTT Broker
Le protocole MQTT est souvent utilisé en complément du Zigbee pour la gestion des appareils domotiques. Nous allons installer le broker MQTT avec des configurations adaptées pour les deux types de coordinateurs.
Accédons à l’interface Home Assistant. Allez dans Paramètres > Modules complémentaires > Boutique des modules complémentaires. Rechercher Mosquitto broker et installez-le.
Une fois installé, activez l’option Lancer au démarrage et cliquez sur Démarrer.
A présent il va falloir créer un utilisateur dédié à MQTT. Allez dans Paramètres > Personnes > Ajouter une personne. Nommez cet utilisateur mqtt_user, cochez Autoriser la connexion et saisissez un mot de passe. Cochez Accès local uniquement puis faites Créer.
Maintenant, allez dans Paramètres > Appareils et services > Ajouter une intégration.
Recherchez « MQTT ». La fenêtre suivante va s’afficher :
| Courtier : <IP_DU_SERVEUR> (192.168.XXX.XXX dans mon cas) |
| Port : 1883 |
| Nom utilisateur : mqtt_user |
| Mot de passe : Celui de l’utilisateur mqtt_user. |
| Cliquer sur Créer |
2.3 Installation de Zigbee2MQTT
Allez dans Paramètres > Modules complémentaires > Boutique des modules complémentaires. Cliquez sur les 3 points en haut à droite, puis dépôt. Copier/coller le dépôt et ajoutez le.
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Actualisez la page, puis retournez dans Paramètres > Modules complémentaires > Boutique des modules complémentaires et recherchez Zigbee2MQTT. Installez le.
Cliquez sur l’onglet Configuration du module que vous venez d’installer.
| SOCAT : La configuration de socat est automatique. Voici le code qui m’est donné. enabled: false master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777 slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5 options: « -d -d » log: false |
|
| MQTT : Ajouter l’utilisateur mqtt_user et le mot de passe défini. |
|
| Serial : Raspbee2 port: /dev/ttyAMA0 adapter: deconz |
Serial : Clé Sonoff port : /dev/ttyUSB0 |
Activez l’option Lancer au démarrage et démarrez le service.
Vous pouvez à présent accéder à l’interface Zigbee2MQTT via le dashboard ajouté et associer vos premiers appareils.
3. Installation et configuration de HACS
Installer HACS en 2025 est devenu beaucoup plus simple qu’auparavant. Les étapes à suivre sont les suivantes :
- Accéder au dépôt de HACS
- Installer le module complémentaire HACS
- Redémarrer Home Assistant
- Acceptation des conditions d’utilisation de HACS
- Lier HACS et Github
Pour accéder au dépôt de HACS (Home Assistant Community Store), cliquez sur ce lien. Attention toutefois, si vous avez plusieurs serveur Home Assistant, de bien vérifier votre adresse IP une fois avoir cliqué sur Open link lors de la demande
d’authentification.
Cliquez sur Installer, puis une fois terminé, redémarrez Home Assistant.
Allez ensuite dans Paramètres > Appareils et services > Ajouter une intégration.
Recherchez « HACS ». Une fenêtre de validations des conditions d’utilisation va s’afficher. Prenez connaissance des termes, cochez toutes les cases, puis appuyez sur Valider.
Enfin, une dernière opération nous est demandée. Il faut lier Home Assistant à Github en insérant un code d’appairage. Suivez la procédure d’installation, nous sommes très bien guidés.
Pour terminer, cliquez sur Authorize hacs. Un nouveau dashboard HACS vient de s’ajouter dans la barre latérale.
Conclusion
Vous avez maintenant un système domotique robuste, personnalisable et fonctionnel, capable de gérer une multitude de périphériques connectés via Zigbee. Grâce à Home Assistant, au module Raspbee2 (ou à la clé Sonoff), et aux outils comme Zigbee2MQTT ou ZHA, votre maison devient plus intelligente et adaptée à vos besoins.
A bientôt !
