Aller au contenu principal

2. Zigbee2MQTT

le site du projet https://www.zigbee2mqtt.io/ et le dépôt github à https://github.com/Koenkk/zigbee2mqtt et la documentation à https://www.zigbee2mqtt.io/guide/getting-started/

1. installation​

je choisis d'utiliser docker comme pour HASS

attention : celle-ci installe le broker MQTT m Mosquitto en prérequis

  • après avoir vérifier que le matériel est reconnu !!! attention semble plus compliqué avec xubuntu server depuis la version 21.10 (à cause de la suppression des paquets de driver tty sur la rpy) donc en 2 étapes :
lsusb | grep Texas
sudo apt install linux-modules-extra-raspi
sudo reboot
ls -al /dev/ttyA*
ls -al /dev/serial/by-id/
  • création d'un dossier et injection du fichier pour docker-compose
mkdir zigbee2Mqtt
cd zigbee2Mqtt
nano docker-compose.yml

avec le contenu suivant dans mon cas

version: '3.8'
services:
  mqtt:
    image: eclipse-mosquitto:latest
    restart: unless-stopped
    volumes:
      - "./mosquitto-data:/mosquitto"
    ports:
      - "1883:1883"
      - "9001:9001"
    command: "mosquitto -c /mosquitto-no-auth.conf"

  zigbee2mqtt:
    container_name: zigbee2mqtt
    restart: unless-stopped
    image: koenkk/zigbee2mqtt
    volumes:
      - ./zigbee2mqtt-data:/app/data
      - /run/udev:/run/udev:ro
    ports:
      - 8080:8080
    environment:
      - TZ=Europe/Paris
    devices:
      - /dev/ttyACM0:/dev/ttyACM0
  • création du fichier de configuration de ce projet
mkdir zigbee2mqtt-data 
cd zigbee2mqtt-data 
nano configuration.yaml

avec le contenu adapté

# Let new devices join our zigbee network
permit_join: true
# Docker-Compose makes the MQTT-Server available using "mqtt" hostname
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://mqtt
# Zigbee Adapter path
serial:
  port: /dev/ttyACM0
# Enable the Zigbee2MQTT frontend
frontend:
  port: 8080
# Let Zigbee2MQTT generate a new network key on first start
advanced:
  network_key: GENERATE

2. démarrage​

simplement avec la commande et aussi pour avoir les logs

docker-compose up -d
docker-compose logs -f

vérification en se connectant sur l'url de la rpy port 8080... et valider la possibilité de connexion sur hass sur l'interface

dans hass : ajouter l'accès MQTT en plus, cf la documentation à https://www.zigbee2mqtt.io/guide/configuration/homeassistant.html

3. usage​

pour mon capteur... cf https://www.zigbee2mqtt.io/devices/WSDCGQ11LM.html pour la procédure appairage à la clé

  • attention : le coordinateur Zigbee reste en appairage permanent (mais peut être désactivé via l'interface web !!)