Zigbee est un protocole de communication sans fil conçu pour les applications domotiques et de domotique industrielle, offrant une faible consommation d’énergie et une portée étendue grâce à son maillage réseau. Il permet à divers dispositifs tels que des ampoules connectées, des capteurs et des interrupteurs de communiquer entre eux.
Zigbee2MQTT est une passerelle qui permet de contrôler des appareils Zigbee via MQTT sans avoir besoin d’une passerelle propriétaire. Il traduit les messages Zigbee en messages MQTT, facilitant ainsi l’intégration avec des systèmes domotiques comme Calaos.
Les dispositifs Zigbee peuvent agir en tant que routeurs ou coordinateurs pour étendre la portée du réseau. En ajoutant des dispositifs secteur (comme des prises intelligentes ou des ampoules connectées), vous pouvez augmenter la couverture du signal Zigbee dans toute votre maison.
Un adaptateur Zigbee compatible :
Consultez la liste complète des adaptateurs supportés : Zigbee2MQTT Adapters
Le type d’adaptateur déterminera la manière de configurer zigbee2mqtt.
Le fichier de configuration se trouve à l’emplacement :
/mnt/calaos/zigbee2mqtt/configuration.yaml
Avec l’éditeur
nano
en ligne de commande il est possible d’éditer ce fichier.
La configuration ressemble à ca:
# Home Assistant integration (MQTT discovery)
homeassistant: false
# allow new devices to join
permit_join: true
# MQTT settings
mqtt:
# MQTT base topic for zigbee2mqtt MQTT messages
base_topic: zigbee2mqtt
# MQTT server URL
server: 'mqtt://127.0.0.1'
# MQTT server authentication, uncomment if required:
# user: my_user
# password: my_password
# Serial settings
serial:
# Location of CC2531 USB sniffer
port: /dev/ttyACM0
frontend: true
Selon l’adaptateur choisi il faudra configurer l’option port
correctement afin de permettre à zigbee2mqtt de l’utiliser:
serial:
port: '/dev/ttyACM0'
serial:
port: 'tcp://slzb-06.local:6638'
Il faudra également modifier les paramètres MQTT si besoin, en particulier username
et password
.
Par défaut dans Calaos-OS, MQTT est configuré sans authentification. Si vous souhaitez plus de sécurité il est préférable de configurer un nom d’utilisateur et mot de passe.
Zigbee2MQTT est déjà inclus dans Calaos OS. Pour l’activer, exécutez la commande suivante dans le terminal de votre serveur Calaos :
systemctl enable zigbee2mqtt.service
systemctl restart zigbee2mqtt.service
Après avoir modifié la configuration, redémarrez le service pour appliquer les changements :
systemctl restart zigbee2mqtt.service
http://<adresse-ip-de-calaos>:8080
.Sur cette interface il vous faudra faire l’appairage et configuration des dispositifs Zigbee avant de pouvoir les ajouter dans Calaos.
Activer le Mode Appairage
Sur l’interface web de Zigbee2MQTT, cliquez sur le bouton “Permit join (All devices)” pour autoriser l’appairage de nouveaux dispositifs.
Mettre le Dispositif en Mode Appairage
Suivez les instructions du fabricant pour mettre votre dispositif en mode appairage. Il est aussi possible de consulter la page du dispositif sur le site de Zigbee2MQTT pour savoir comment faire l’appairage.
Exemple: Pour une ampoule connecté TRADFRI, l’explication se trouve ici: Zigbee2mqtt TRADFRI
Vérification de l’Appairage
Une fois le dispositif détecté, il apparaîtra dans la liste avec un identifiant par défaut.
Renommer le Dispositif
Ajouter des Routeurs pour Étendre le Réseau
Calaos utilise MQTT pour communiquer avec Zigbee2MQTT. Il faudra donc ajouter un IO MQTT pour chaque appareils que vous souhaitez piloter dans Calaos. Il faut prendre en compte qu’un IO dans Calaos représente une valeur. Prenons l’exemple d’une sonde de températeur et humidité Aquara. On voit dans la doc que cet appareil va exposer plusieurs valeurs: temperature
, humidity
, pressure
, battery
, … Dans Calaos il faudra créer un IO pour chacune des propriétés: Un IO pour la température, un IO pour l’humidité, etc…
Dans Calaos Installer il y a un outil dédié qui est capable de se connecter au Broker MQTT et de détecter les appareils zigbee disponibles sur Zigbee2MQTT. Il faudra sélectionner la propriété avec laquelle vous souhaitez créer un IO, et l’assistant fera la configuration pour vous.