zigbee2mqtt
1.41.0
Vous permet d'utiliser vos appareils Zigbee sans le pont ou la passerelle du fournisseur.
Il relie les événements et vous permet de contrôler vos appareils Zigbee via MQTT. De cette façon, vous pouvez intégrer vos appareils Zigbee à n'importe quelle infrastructure de maison intelligente que vous utilisez.
La documentation vous fournit toutes les informations nécessaires pour être opérationnel ! Assurez-vous de ne pas sauter de sections s'il s'agit de votre première visite, car elles pourraient contenir des détails importants pour vous.
Si vous n'êtes pas familier avec la terminologie Zigbee , assurez-vous de lire ceci pour vous aider.
Zigbee2MQTT s'intègre bien à (presque) toutes les solutions domotiques car il utilise MQTT. Cependant, les intégrations suivantes méritent d'être mentionnées :
Zigbee2MQTT est composé de trois modules, chacun développé dans son propre projet Github. En commençant par le matériel (adaptateur) et en remontant ; zigbee-herdsman se connecte à votre adaptateur Zigbee et met une API à disposition des niveaux supérieurs de la pile. Par exemple, pour le matériel Texas Instruments, zigbee-herdsman utilise l'API de surveillance et de test TI zStack pour communiquer avec l'adaptateur. Zigbee-herdsman gère la communication Zigbee de base. Le module zigbee-herdsman-converters gère le mappage des modèles d'appareils individuels vers les clusters Zigbee qu'ils prennent en charge. Les clusters Zigbee sont les couches du protocole Zigbee au-dessus du protocole de base qui définissent des éléments tels que la façon dont les lumières, les capteurs et les interrupteurs communiquent entre eux sur le réseau Zigbee. Enfin, le module Zigbee2MQTT pilote zigbee-herdsman et mappe les messages zigbee aux messages MQTT. Zigbee2MQTT assure également le suivi de l'état du système. Il utilise un fichier database.db pour stocker cet état ; un fichier texte avec une base de données JSON des appareils connectés et leurs capacités. Zigbee2MQTT fournit une interface Web qui permet la surveillance et la configuration.
Zigbee2MQTT utilise TypeScript (partiellement pour l'instant). Par conséquent, après avoir modifié les fichiers du répertoire lib/ vous devez recompiler Zigbee2MQTT. Cela peut être fait en exécutant npm run build . Pour un développement plus rapide au lieu d'exécuter npm run build vous pouvez exécuter npm run build-watch dans une autre session de terminal, cela sera recompilé au fur et à mesure que vous modifiez les fichiers. La première fois avant la construction, vous devez exécuter npm install --include=dev Avant de soumettre les modifications, exécutez npm run test-with-coverage , npm run pretty:check et npm run eslint
Voir Appareils pris en charge pour vérifier si votre appareil est pris en charge. Il existe une liste assez longue, comprenant des appareils de fournisseurs comme Xiaomi, Ikea, Philips, OSRAM et plus encore.
S'il n'est pas répertorié dans Appareils pris en charge, la prise en charge peut être ajoutée (assez) facilement, voir Comment prendre en charge de nouveaux appareils.
Si vous avez besoin d'aide, vous pouvez vérifier les problèmes ouverts. N'hésitez pas à nous aider avec les Pull Requests lorsque vous avez pu réparer des choses, ajouter de nouveaux appareils ou simplement partager votre amour sur les réseaux sociaux.
