Installer et appairer ses ampoules Zigbee dans Home Assistant

L’appairage d’ampoules Zigbee dans Home Assistant est une opération simple qui ne prend que quelques minutes par appareil. Que vous utilisiez ZHA (Zigbee Home Automation) ou Zigbee2MQTT, la procédure est similaire et très accessible. Voici le guide complet de l’installation matérielle à la configuration des groupes de lumières.

Prérequis : le coordinateur Zigbee

Avant d’appairer la moindre ampoule, vous avez besoin d’un coordinateur Zigbee connecté à votre serveur Home Assistant.

Coordinateurs recommandés :

Sonoff

Branchez le coordinateur USB sur votre serveur Home Assistant. Si vous utilisez un Raspberry Pi ou un NUC, branchez-le sur un port USB 2.0 de préférence (moins d’interférences avec le 2,4 GHz) ou utilisez un câble d’extension USB pour l’éloigner du boîtier.

Choix de l’intégration : ZHA ou Zigbee2MQTT ?

ZHA (Zigbee Home Automation) : intégration native Home Assistant, installation en quelques clics, interface graphique complète. Idéale pour les débutants.
Zigbee2MQTT : add-on séparé (nécessite un broker MQTT), plus de configuration initiale, mais support de plus d’appareils, plus de contrôle sur les paramètres, mises à jour plus fréquentes. Préféré par les utilisateurs avancés.

Pour l’éclairage, les deux intégrations fonctionnent très bien. ZHA est recommandée pour débuter, Zigbee2MQTT pour les installations avec de nombreux appareils ou des équipements atypiques.

Installation ZHA : Paramètres → Intégrations → + Ajouter → Zigbee Home Automation → sélectionnez votre coordinateur.
Installation Zigbee2MQTT : Add-on Store → Zigbee2MQTT → Installer → Configurer le port coordinateur.

Appairer une ampoule Zigbee : procédure pas à pas

La procédure d’appairage est quasi identique pour toutes les marques :

1. Dans Home Assistant, activez le mode d’appairage :

— ZHA : Paramètres → Appareils & Services → ZHA → Ajouter un appareil

— Zigbee2MQTT : Interface web → Appareils → Activer l’inclusion (bouton en haut)

2. Mettez l’ampoule en mode appairage :

— Philips Hue : allumez/éteignez 5 fois rapidement (1 sec on, 1 sec off)

— IKEA : approchez un aimant de la petite pastille sur certains modèles, ou utilisez la télécommande IKEA

— Sonoff/TuYa : allumez/éteignez 3 fois ou maintenez allumé 5 secondes (l’ampoule clignote pour indiquer le mode appairage)

3. L’ampoule clignote → elle est découverte et s’ajoute automatiquement.

4. Renommez l’appareil clairement : ‘Ampoule Salon Principal’, ‘Spot Cuisine Gauche’…

Créer des groupes de lumières

Un groupe de lumières permet de contrôler plusieurs ampoules comme une seule entité. Indispensable pour un lustre à 6 ampoules ou les spots d’une cuisine.

Dans ZHA, les groupes Zigbee matériels sont supportés : la commande est envoyée directement au groupe via le réseau Zigbee (plus réactif que la commande individuelle).

Configuration dans configuration.yaml (méthode universelle) :

light:
  - platform: group
    name: Salon Principal
    entities:
      - light.ampoule_salon_1
      - light.ampoule_salon_2
      - light.ampoule_salon_3

Ou via l’interface Helpers (Paramètres → Appareils → Assistants → Créer un assistant → Groupe) pour les versions récentes de Home Assistant.

Le groupe apparaît comme une seule entité light dans Home Assistant, avec tous les attributs : luminosité, couleur, température de blanc.

Optimiser la fiabilité du réseau Zigbee pour l’éclairage

Les ampoules Zigbee sont des routeurs du réseau maillé Zigbee : elles répercutent les messages des autres appareils Zigbee voisins. Plus vous avez d’ampoules, plus votre réseau est dense et fiable.

Bonnes pratiques :

Ne jamais couper l’alimentation secteur des ampoules Zigbee (elles ne peuvent plus router si hors tension)
Répartissez les ampoules dans toutes les pièces pour une couverture uniforme
Évitez les objets métalliques entre les ampoules et le coordinateur (murs métalliques, structure acier)
Si des ampoules sont dans des pièces éloignées, assurez-vous qu’une ampoule intermédiaire est allumée entre elles et le coordinateur

Diagnostique réseau dans Zigbee2MQTT : l’onglet Carte réseau affiche les liaisons entre appareils et les puissances de signal (LQI). Un LQI > 150 est bon, > 200 est excellent.