Le projet zigbee2mqtt est un projet Open Source qui permet à chacun de fabriquer sa propre passerelle domotique Zigbee. On pourra récupérer des mesures et piloter des accessoires compatibles sans avoir besoin d’acheter une gateway officielle.
Zigbee2MQTT utilise un sniffer Zigbee CC2531 pour intercepter et mimer les commandes Zigbee. Les commandes et les mesures sont échangées à un serveur ou une appli domotique via des messages MQTT. Le projet est compatible avec de nombreuses fabricants de matériels domotiques Zigbee. Xiaomi (accessoires Aqara et Mijia), ampoules connectées Philips Hue, Ikea Tradfi, Osram Lightify, Innr…
Principe du pont domotique zigbee2mqtt pour Xiaomi Aqara
Les concepteurs du projet ont tout simplement utilisé un sniffer Zigbee USB pour décoder les trames envoyées par les accessoires Xiaomi vers la passerelle officielle. C’est un gros travail de retro-engeneering (conception inversée). L’interface est bidirectionnelle, c’est à dire qu’elle est capable de décoder les états (ON/OFF, couleur, température, puissance consommée…) mais aussi d’envoyer des commandes (en mimant la gateway officielle Aqara). Un serveur (broker) MQTT sert de passerelle informatique entre un serveur domotique (ici Home Assistant) et la passerelle zigbee2mqtt.
Coté matériel, le pont zigbee2mqtt utilise un sniffer basé sur le circuit CC2531 (environ 5€) de Texas Instrument. Il faudra acheter un CC Debugger de Texas Instrument (environ 10€) pour installer et mettre à jour le firmware sur le sniffer. Il faudra également acheter un câble spécifique (GBAN) qui permet de relier le CC Debugger au Sniffer CC2531 (environ 2€). Voici une photographie de pont Zigbee. C’est beaucoup moins beau que la gateway originale de Xiaomi, mais c’est le prix à payer pour garder le contrôle de ses données personnelles. On verra comment faire un boitier sympa en impression 3D. Coté budget, on reste très largement en dessous de la gateway officielle qui est vendue seule environ 25€.
Source : https://github.com/Koenkk/zigbee2mqtt/wiki/Getting-started
Coté logiciel, l’interface a été développé en Javascript à l’aide de Nodejs. On pourra donc le faire fonctionner sans compilation sur n’importe quelle plateforme. Il est également possible de tester le projet dans un container Docker (nous l’avions utilisé en 2017 pour tester les logiciels domotiques sans avoir à les installer).
Matériel nécessaire
Le projet zigbee2mqtt lancé en octobre 2017 gagne très rapidement en popularité. Il est développé par 6 contributeurs très actifs. Pour vous lancer dans le montage de la passerelle domotique Zigbee2MQTT vous aurez besoin du matériel suivant :
- Un Sniffer CC2531 USB.
- Un CC Debogger (programmateur spécifique de Texas Instrument) ainsi que le câble dédié pour installer le firmware.
Le plus économique est d’acheter un kit de démarrage qui regroupe un sniffer, le CC Debogger avec son câble. Ensuite, vous pourrez acheter d’autres sniffers séparément pour augmenter la couverture de votre domicile (y compris en extérieur).
Kit de démarrage
Contient un sniffer CC2531 USB, le CC Debogger avec son câble
Sniffer CC2531
Il permet d’intercepter et d’envoyer les commandes Zigbee. Choisissez de préférence un module avec extérieure pour augmenter la zone de couverture et avoir une meilleure réception.
CC Debogger
Permet de télécharger le firmware dans le sniffer CC2531
Câble de programmation
Ce câbles particulier est nécessaire pour relier le CC Debogger au Sniffer. On l’utilisera pour installer le firmware ou le mettre à jour
Installer le firmware sur le Sniffer Zigbee
Suivez ensuite les étapes détaillées dans ce tutoriel pour installer le firmware sur le sniffer Zigbee
Intégrer les accessoires Zigbee à un serveur domotique à l’aide de Zigbee2MQTT
Une fois que le pont Zigbee est prêt, il ne reste plus qu’à intégrer vos accessoires domotiques sur votre seveur. Voici un exemple avec Domoticz
”]Accessoires domotiques compatibles
La liste des accessoires compatibles est tout simplement impressionnante. Impossible de tout lister en détail, ce qui est important toutefois, ce sont les références des produits compatibles. Vous trouverez la liste actualisée des accessoires domotiques compatibles sur le WiKi officiel.
Ampoules IKEA Tradfri
Modèles compatibles LED1545G12, LED1546G12, LED1623G12, LED1537R6, LED1650R5, LED1536G5, LED1622G12, LED1624G9, LED1649C5, ICTC-G-1, ICPSHC24-10EU-IL-1, ICPSHC24-30EU-IL-1, L1527, L1529, L1528, L1531, E1603, E1524, Model, LED1545G12, LED1546G12, LED1623G12
Un aperçu des ampoules IKEA les plus vendues
Modèle | Description |
---|---|
LED1545G12 | Ampoule IKEA TRADFRI LED E27 980 lumen, dimmable, blanc (on/off, luminosité, température des couleurs) |
LED1623G12 | Ampoule IKEA TRADFRI LED E27 1000 lumen, dimmable, blanc opal (on/off, luminosité) |
LED1537R6 | Ampule IKEA TRADFRI LED GU10 400 lumen, dimmable, white spectrum (on/off, luminosité, température des couleurs) |
LED1650R5 | Ampoule IKEA TRADFRI LED GU10 400 lumen, dimmable (on/off, luminosité) |
LED1536G5 | Ampoule IKEA TRADFRI LED E14 400 lumen, dimmable, blanc spectrum, blanc opal (on/off, luminosité, température des couleurs) |
Ampoules connectées Philips Hue
Toute la gamme d’accessoires Philips Hue est supportée par le projet dont voici les références 7299760PH, 7146060PH, 433714, 9290011370, 8718696449691, 7299355PH, 915005106701, 9290012573A, 9290002579A, 8718696485880, 915005733701, 464800, 8718696695203, 8718696598283, 8718696548738, 3261030P7, 3261331P7, 3216331P5, 3216431P5, 7199960PH, 324131092621, 9290012607
Les modèles suivants ont une référence compatible et sont disponibles sur Amazon
Ampoules Osram
Modèles compatibles 4058075816718, AA69697, AC03645, AC03642, AA70155, AA68199, AB32840, 4058075816794, AC03641, 4052899926158, AB401130055, AB3257001NJ, 4052899926110, 4058075036185, 4058075036147, AB35996, AC08562, AC01353010G, AC03648, AC0251100NJ
Les modèles suivants ont une référence compatible et sont disponibles sur Amazon
Ampoules Sylvania
Modèles compatibles 73742, 73740, 73693, 74283, 74696, 72922-A, 71831, 74282, LTFY004
Ces modèles ne sont pas commercialisés en France.
Ampoules Innr
Modèles compatibles RB 185 C, BY 185 C, RB 285 C, RB 165, RB 175 W, RB 178 T, RS 125, RS 128 T, RB 145, RB 248 T, BY 165, PL 110, ST 110, UC 110, DL 110 N, DL 110 W, SL 110 N, SL 110 M, SL 110 W, SP 120
Les modèles suivants ont une référence compatible et sont disponibles sur Amazon
Accessoires domotiques Xiaomi Aqara ou Mijia
Certains produits sont destinés au marché intérieur chinois (prise connectées, certains interrupteurs). Ils ne sont pas certifiés CE et FCC. Il est déconseillé de les acheter sauf si vous résidez en Chine. Avec l’arrivée de Xiaomi en Europe, ces produits devraient rapidement évoluer pour répondre aux standards Européens en US. Tous les autres accessoires Xiaomi fonctionnent sur batterie (CR2032 en général).
Modèle | Description |
---|---|
WXKG01LM | Bouton connecté Xiaomi MiJia wireless switch (simple, double, triple, quadruple, clic long) |
WXKG11LM | Interrupteur Xiaomi Aqara wireless switch (single, double, triple, quadruple clic) |
WXKG03LM | Interrupteur Xiaomi Aqara single key wireless wall switch autocollant (simple clic) |
WXKG02LM | Interrupteur Xiaomi Aqara double key wireless wall switch autocollant (gauche, droite) |
QBKG04LM | Interrupteur Xiaomi Aqara single key wired wall switch à encastrer (on/off) |
QBKG03LM | Interrupteur Xiaomi Aqara double key wired wall switch à encastrer (l1 and l2 on/off) |
WSDCGQ01LM | Capteur Xiaomi MiJia temperature & humidity sensor (temperature et humidité) |
WSDCGQ11LM | Capteur Xiaomi Aqara temperature, humidity and pressure sensor (temperature, humidité et pression atmosphérique) |
RTCGQ01LM | Capteur de mouvement PIR Xiaomi Mijia human body movement sensor (présence) |
RTCGQ11LM | Capteur de mouvement PIR Xiaomi Aqara human body movement and illuminance sensor (présence) |
MCCGQ01LM | Contacteur de porte et fenêtre Xiaomi Mijia door & window contact sensor (contact) |
MCCGQ11LM | Contacteur de porte et fenêtre Xiaomi Aqara door & window contact sensor (contact) |
SJCGQ11LM | Détecteur de fuite d’eau Xiaomi Aqara water leak sensor (vrai / faux) |
MFKZQ01LM | Cube magique Xiaomi Mi smart home cube (shake, wakeup, fall, tap, slide, flip180, flip90, rotation gauche et droite) |
ZNCZ02LM | Prise connectée Xiaomi Mi power plug ZigBee (on/off, puissance consommée). Non CE |
QBCZ11LM | Prise connectée Xiaomi Aqara socket Zigbee (on/off, puissance consommée). Non CE |
JTYJ-GD-01LM/BW | Détecteur de fumées Xiaomi MiJia Honeywell. Non CE |
JTQJ-BF-01LM/BW | Détecteur de fuite de gaz Xiaomi MiJia gas leak detector |
A6121 | Serrure connectée Xiaomi Vima Smart Lock |
DJT11LM | Détecteur de vibration Xiaomi Aqara vibration sensor (drop, tilt et touch) |
ZNCLDJ11LM | Motorisation de rideaux Xiaomi Aqara curtain motor (ouvrir, fermer, stop, position) |
Ampoules RGB Sengled
Les ampoules à LED RGB Sengled sont compatibles Alexa. Elles sont disponibles sur Amazon à partir de 20€
Modèles compatibles E11-G13, E11-G23/E11-G33, Z01-CIA19NAE26, Z01-A19NAE26, E11-N1EA, E12-N14, E1ACA4ABE38A, 9290012573A, 9290002579A, 8718696485880, 915005733701, 464800, 8718696695203, 8718696598283, 8718696548738, 3261030P7, 3261331P7, 3216331P5, 3216431P5, 7199960PH, 324131092621, 9290012607
Accessoires Heiman
Heiman est un fabricant de détecteurs de fumées, contacteur de porte et détecteur de fuite d’eau. Modèles compatibles HS1SA, HS3SA, HS1DS, HS1DS-E, HS1WL
Ampoules et contrôleurs de LED Gledopto
Gledopto est un fabricants chinois d’ampoules à LED et des contrôleurs d’éclairage à LED. La plupart des produits sont disponibles sur Amazon. Si vous n’êtes pas pressé, vous pouvez acheter en direct de Chine beaucoup moins cher sur la boutique officielle.
Références compatibles avec Zigbee2MQTT : GL-C-008, GL-C-006, GL-S-007Z, GL-B-007Z, GL-B-008Z, GL-D-003Z, GL-S-003Z, GD-CZ-006




Robinet thermostatique connectée eCozy
Le robinet thermostatique connecté eCozy référencé 1TST-EU est supporté
Autres fabricants
D’autres fabricants moins connus sont également pris en charge. Ce sont bien souvent des marques locales ou des marques d’enseignes étrangères.
GE (General Electric, présent uniquement sur le marché US), EcoSmart (ampoules), EDP (prise connectée), Dresden Elektronik (multi-prises connectées), Climax, Commercial Electric, Calex, Centralite, Bitron, Airam, AduroSmart, Müller Licht, Ksentry Electronics, Nanoleaf, Netvox, Nue, Paulman, Paul Neuhaus, Trust, iCasa, iLux
Convaincu, voici des tutoriels pour vous lancer !
Voici une série de tutoriels qui explique en détail comment fabriquer votre gateway Zigbee, jumeler vos accessoires et intégrer vos équipements à un serveur domotique DIY
- Sonoff BASICZBR3 et ZBBridge, nouveau module et pont ZigBee pour domotique DIY
- Quelle passerelle domotique choisir ? RFXCom, Z-Wave, Zigbee, Xiaomi Aqara, Philips Hue…
- Utiliser les plugins sur Domoticz. Installation manuelle ou via Python Plugin Manager
- Inclure les accessoires domotiques Xiaomi Aqara ou Mijia à Jeedom avec les plugins Virtuel et MQTT
- Test du détecteur de fumée Xiaomi Mijia Honeywell avec Domoticz, notification d’urgence avec PushOver
- Zigbee2MQTT. Inclure des accessoires Xiaomi Aqara à Domoticz via plugin ou Node-RED
- Assembler le pont Zigbee2MQTT, boitier, démo Node-RED. Hack ponts zigbee Hue et Xiaomi Aqara
- Matériel et kit pour projet Zigbee2MQTT, pont domotique Zigbee Open Source compatible Xiaomi, Philips Hue, Tradfi…
Le projet zigbee2mqtt est un projet mature qui prend en charge un grand nombre d’accessoires domotiques. Si vous avez des connaissances encore limitées en électronique et le Terminal Linux, le projet ZiGate (présenté précédemment) est commercialisé sur la boutique en ligne au prix de 49€ ou 69€ avec une extension WiFi qui permet de se libérer du PC ou du Raspberry Pi.
Page GitHub du projet : zigbee2mqtt
- ESP32, broches GPIO et fonctions associées. I/O, PWM, RTC, I2C, SPI, ADC, DAC
- ESP32-CAM. Broches et équipements ESP-EYE, AI Thinker, TTGO T-Camera, M5Stack Timer Camera…
- ESP32-CAM. Quel modèle choisir ? ESP-EYE, AI Thinker, TTGO T-Camera, M5Stack Timer Camera…
- M5Stack Atomic GPS. Tracker ESP32 TinyGPS++, export GPX sur carte SD, visualisation sur Google Maps ou VSCode
- Home Assistant. Installer le snap sur NAS Synology sur une machine virtuelle Ubuntu
Hello, j’ai acheter mon module Zigbee, flasher avec Zigbee2MQTT. J’ai installer le plugin domoticz, tout est configuré.
Cependant, je viens d’ajouter mon premier capteur : DJT11LM
Et il m’affiche ceci dans Domoticz : {“type”: “response”, “requestId”: 3, “isError”: false, “payload”: [{“ID”: 1, “devices”: [], “friendly_name”: “Zigbee Devices”, “optimistic”: true}]}
Impossible de l’exploiter, je suis un peu perdu …
Bonjour. Avez-vous configuré le fichier YAML de zigbee2mqtt en suivant les instructions de ce tutoriel ? https://projetsdiy.fr/test-zigbee2mqtt-inclure-accessoires-xiaomi-aqara-mijia-domoticz-nodered/
Bonjour, Article très intéressant, mais je sais pas si c’est que moi, on comprend pas bien ce qu’il faut acheter ?
les sniffers c’est une liste de modèle différents ? on en choisis un parmi les 4 ?
idem pour les câbles
et les débbuger ?
et je suppose que les kits, on en choisit un et que c’est complet ?
Bonjour, oui vous avez parfaitement compris. J’ai repris le texte pour clarifier. Choisissez un kit, ce sont les mêmes kits, de fabricants différents. Une fois que vous avez votre kit de démarrage, vous pourrez uniquement acheter des sniffers si la couverture de votre domicile n’est pas suffisante. Bonne journée.
Intéressant comme projet… à suivre !