Home-Assistant – Lexique
[rtoc_mokuji title= »Sommaire » title_display= »left » heading= »h3″ list_h2_type= »round » list_h3_type= »number1″ frame_design= »frame2″ animation= »slide »]
Voici une liste de quelques termes, mots et vocabulaire utilisés dans le cadre de la domotique et plus précisément de Home-Assistant.
GLOSSAIRE
Les technologies de communication entre appareils (IoT/domotique)
| Technologie | Type de connexion | Portée | Consommation | Avantages | Inconvénients |
|---|---|---|---|---|---|
| Zigbee | Maillé IEEE 802.15.4 (2,4 GHz) |
10–30 m (intérieur) | Faible | Rapide, maillage, standard ouvert, local | Besoin d’un coordonnateur, configuration parfois technique |
| Z-Wave | Maillé (868 MHz) |
30–100 m | Très faible | Fiable, maillage stable, interopérabilité | Protocole propriétaire, matériel souvent plus cher |
| Wi-Fi | Point-à-point IEEE 802.11_ |
30–50 m (selon murs) | Élevée | Très répandu, pas besoin de hub | Gros consommateurs d’énergie, congestion réseau |
| Bluetooth / BLE | Point-à-point ou Mesh (BLE) (2,4 GHz) |
5–15 m | Très faible | Intégration facile (smartphones), peu énergivore | Portée réduite, maillage limité (sauf BLE Mesh) |
| Thread | Maillé (IPv6) (2,4 GHz) IEEE 802.15.4 |
~30 m | Faible | Maillage IP, sécurisé, conçu pour la domotique | Encore jeune, nécessite Border Router |
| Matter (protocole) | Sur Zigbee, Thread ou Wi-Fi | Dépend du support | Faible à moyenne | Standard universel, interopérable (Apple, Google, Amazon) | Encore en déploiement, matériel récent requis |
| EnOcean | RF sans pile (via récupération d’énergie) (868-868,6 Mhz) |
~30 m | Ultra faible | Sans pile, durable, sans entretien | Portée plus faible, écosystème limité |
| 433 MHz / RF propriétaires | Radio simple (non maillé) | Jusqu’à 100 m | Très faible | Simple, pas cher | Pas de retour d’état, pas de sécurité, pas de standard |
| Infra-rouge (IR) | Point-à-point | Quelques mètres (ligne directe) | Faible | Utilisé pour TV/clim | Pas de retour d’état, dépend de la direction |
| LoRa / LoRaWAN | Bas débit longue portée (863–870 MHz) |
Plusieurs km | Très faible | Pour capteurs en extérieur | Débit limité, pas pour la domotique de maison |
Zigbee
Protocole de communication sans fil utilisé pour connecter des appareils (capteurs, interrupteurs, ampoules, etc.) à faible consommation. Alternatif au Wi-Fi et au Bluetooth, il forme un réseau maillé.
End-device (périphérique terminal)
➤ Rôle :
- Il n’envoie ni ne relaie de messages pour les autres appareils.
- Il ne communique qu’avec un routeur ou directement avec le coordinateur.
➤ Caractéristiques :
- Très basse consommation (idéal pour les capteurs sur piles).
- Souvent en sommeil pour économiser l’énergie.
- Ne garde pas la topologie du réseau en mémoire.
- Exemple : capteur de température, bouton, détecteur de mouvement.
➤ Avantages :
- Idéal pour les appareils fonctionnant sur piles.
- Simple et économe en énergie.
➤ Inconvénients :
- Dépendant d’un routeur ou coordinateur à proximité pour se connecter au réseau.
- Moins de fiabilité si éloigné du réseau.
Router (Routeur)
➤ Rôle :
- Il relaye les messages entre les autres nœuds (end devices ou autres routeurs).
- Il étend la portée du réseau Zigbee.
➤ Caractéristiques :
- Toujours alimenté (prise secteur en général).
- Maintient une connexion active au réseau.
- Peut avoir plusieurs end devices connectés à lui.
- Exemple : ampoule connectée, prise intelligente.
➤ Avantages :
- Renforce la stabilité et la portée du réseau Zigbee.
- Indispensable dans un réseau maillé étendu.
➤ Inconvénients :
- Consomme plus (doit rester allumé).
- Ne convient pas aux appareils sur piles.
Coordonnateur / Coordinateur
Le cerveau du réseau Zigbee, souvent un dongle USB comme les modèles Sonoff ou plus performants : les modèles SMLIGHT.
Il démarre le réseau, gère les connexions et interagit avec Z2M.
Dans un réseau Zigbee, le « coordinateur » :
- C’est l’appareil maître du réseau Zigbee.
- Il démarre le réseau et en gère la structure (il attribue les adresses, supervise les routes, etc.).
- Il est unique dans un réseau Zigbee (1 seul coordinateur par réseau).
- Il peut aussi agir comme un routeur (mais pas forcément).
Zigbee2MQTT (Z2M)
Un pont logiciel qui connecte les appareils Zigbee à un serveur domotique (comme Home Assistant) via MQTT. Il permet de contrôler et surveiller les appareils Zigbee sans dépendre de cloud propriétaires.
MQTT (Message Queuing Telemetry Transport)
Protocole léger de messagerie pub/sub (publication/abonnement) utilisé pour échanger des données entre appareils dans une maison connectée.
- Broker MQTT : Serveur central qui gère la communication entre les appareils (ex: Mosquitto).
- Topic : Une adresse de communication où sont envoyés ou reçus les messages (ex :
zigbee2mqtt/salon/temperature). - Payload : Le contenu du message (par exemple :
{"temperature": 22.5}).
Bridge (Pont)
Le mot « bridge » peut désigner plusieurs choses selon le contexte, par exemple :
1. Dans un contexte Zigbee propriétaire (ex : Philips Hue, IKEA Tradfri) :
Le « bridge » Hue ou « passerelle » IKEA est un appareil qui :
-
- Fait office de coordinateur Zigbee.
- Sert aussi de passerelle entre Zigbee et le Wi-Fi / Ethernet.
- Communique avec les appareils Zigbee et avec le smartphone/app via le réseau local ou Internet.
👉 Donc ici, le bridge inclut un coordinateur Zigbee à l’intérieur.
2. Dans Zigbee2MQTT ou Home Assistant :
-
- Le mot « bridge » peut aussi désigner le service logiciel qui fait le pont entre Zigbee et MQTT.
- Par exemple : Zigbee2MQTT est un bridge logiciel.
- Il reçoit les infos du coordinateur USB.
- Il les traduit en messages MQTT pour Home Assistant (ou autre).
Bridge vs Coordinateur
| Terme | Rôle principal | Matériel ou logiciel ? | Est-il un coordinateur ? |
|---|---|---|---|
| Coordinateur | Gère le réseau Zigbee (unique par réseau) | Matériel Zigbee | ✅ Oui (obligatoirement) |
| Bridge | Fait le pont entre Zigbee et un autre monde (Wi-Fi, MQTT…) | Matériel ou logiciel | ❌ Pas forcément (mais peut l’inclure) |
Appairage (Pairing)
Processus qui connecte un nouvel appareil Zigbee au réseau. L’appareil est détecté par Z2M et assigné à un nom.
ZIGBEE2MQTT (Z2M)
Rôle principal de Z2M :
Z2M agit comme un pont (gateway) entre :
- le réseau Zigbee (capteurs, ampoules, interrupteurs…)
- et le système domotique (via MQTT, comme Home Assistant, Domoticz, etc.)
Il convertit les messages Zigbee en messages MQTT, lisibles et exploitables.
Fonctions détaillées de Z2M :
| Fonction | Description |
|---|---|
| Gestion du réseau Zigbee | Z2M gère le coordonnateur, les appairages, les routes, les dispositifs. |
| Traduction Zigbee ↔ MQTT | Il convertit les messages Zigbee (bruts) en JSON clair, publié sur des topics MQTT. |
| Contrôle des appareils | Il permet d’envoyer des commandes aux appareils Zigbee via MQTT (ex: allumer une lampe, changer la température). |
| Réception des données | Il reçoit les mesures des capteurs Zigbee (température, humidité, présence…) et les publie automatiquement en MQTT. |
| Mise à jour OTA | Il peut gérer les mises à jour de firmware Zigbee (si l’appareil le permet). |
| Indépendance totale | Il permet d’utiliser des appareils de différentes marques ensemble sans cloud ni application. |
| Interface Web (en option) | Il dispose d’une interface (frontend) pour voir les appareils, la topologie, les logs, etc. |
Exemple concret :
- Un capteur de température Aqara envoie
22.4°Cvia Zigbee. - Le coordonnateur reçoit cette info et la transmet à Z2M.
- Z2M publie un message MQTT :
Topic : zigbee2mqtt/salon
Payload : {"temperature": 22.4} - Home Assistant reçoit ce message via MQTT et l’affiche dans ton dashboard.
Attributes / Reporting
- Attributes (attributs) : Données exposées par un capteur (ex : température, humidité).
- Reporting (rapports) : Fréquence à laquelle un capteur envoie ses données (peut être réglable).
Bindings et Groups
- Binding : Connexion directe entre deux appareils Zigbee sans passer par Z2M (ex : bouton → ampoule).
- Group : Ensemble d’appareils Zigbee (ex :
Salon) contrôlables d’un coup.
MQTT
MQTT – Comment ça marche ?
MQTT c’est juste un protocole de messagerie léger, basé sur un modèle pub/sub :
Publication / Abonnement. Le logiciel derrière cette technologie s’appel un brocker.
3 éléments essentiels :
| Élément | Rôle |
|---|---|
| Broker | Le serveur central MQTT qui distribue les messages (ex : Mosquitto). |
| Publisher | Celui qui envoie un message à un « topic ». (ex: Z2M qui publie une température) |
| Subscriber | Celui qui reçoit les messages d’un topic auquel il est abonné (ex : Home Assistant). |
Exemple dans Zigbee2MQTT :
- Le capteur de température envoie
22.4°Cà Z2M. - Z2M publie ce message au format MQTT :
- Topic :
zigbee2mqtt/salon - Payload :
{"temperature": 22.4}
- Topic :
- Home Assistant est abonné au topic
zigbee2mqtt/#(le#signifie tous les sous-topics) → il reçoit la donnée. - Tu peux aussi envoyer une commande vers un appareil :
- Topic :
zigbee2mqtt/lampe_salon/set - Payload :
{"state": "ON"}
- Topic :
Organisation des Topics MQTT :
Typiquement :
zigbee2mqtt/
├── lampe_salon → {"state":"ON"}
├── salon → {"temperature":22.4, "humidity":55}
├── bridge/
│ ├── state → "online"
│ ├── devices → liste des appareils
│ └── log → messages système
Ici, lampe_salon ainsi que salon sont des topics.
En résumé :
- Z2M publie des données des appareils Zigbee vers MQTT.
- Home Assistant ou autre s’abonne aux topics pour lire ou interagir avec ces appareils.
- La communication est bidirectionnelle, rapide, locale, et légère.
MQTT Topics associés au bridge :
| Topic MQTT | Fonction |
|---|---|
zigbee2mqtt/bridge/state |
État du pont (online/offline) |
zigbee2mqtt/bridge/devices |
Liste de tous les appareils Zigbee appairés |
zigbee2mqtt/bridge/config |
Configuration du réseau Zigbee |
zigbee2mqtt/bridge/log |
Logs systèmes et événements Zigbee |
zigbee2mqtt/bridge/networkmap |
Topologie du réseau Zigbee |
zigbee2mqtt/bridge/request/* |
Envoi de requêtes (ex : redémarrer, re-interviewer, etc.) |
zigbee2mqtt/bridge/response/* |
Réponse aux requêtes |
MQTT Topics importants avec Z2M
zigbee2mqtt/bridge/state→ État du pont (en ligne ou non).zigbee2mqtt/bridge/devices→ Liste des appareils appairés.zigbee2mqtt/nom_de_l_appareil→ Données ou commandes d’un appareil.
Interview
Phase où Z2M interroge un appareil après appairage pour découvrir ses capacités et ses attributs.
Converters
Modules internes à Z2M qui interprètent les messages Zigbee et les convertissent en format MQTT lisible.
OTA (Over The Air Update)
Mise à jour sans fil du firmware d’un appareil Zigbee (si pris en charge).