[TUTO] HA : Configurer clé Zigbee ConBee II avec Zigbee2mqtt et Mosquitto-broker

Nous verrons dans ce nouveau tutoriel comment configurer votre clé Zigbee ConBee II avec les add-ons Zigbee2mqtt et Mosquitto-broker sur votre environnement domotique Home Assistant.

Le protocole Zigbee en un coup d’oeil :

• Protocole sans fil standardisé – Zigbee Alliance
• Le Zigbee fonctionne sur les fréquences 868MHz (Europe), 915MHz (Amériques et Australie) ou 2.4GHz (Partout).
• Utilise un réseau maillé au language universel, jusqu’à 65000 noeuds
• Chiffrement sécurisé 128 bits AES
• Portée de 10 à 20 mètres en intérieur et de 75 à 300 mètres en extérieur
• Très économique
• Forte alternative au protocole Z-Wave (généralement plus accessible)

Prérequis, matériels et versions

Configuration de la clé Zigbee ConBee II

Avec serveur MINI FORUM + Proxmox

Tout d’abord, branchez la clé USB ConBee II au niveau de votre serveur MINI FORUM, puis rendez-vous sur l’interface d’administration de Proxmox.

Depuis le serveur virtuel Home Assistant OS et l’onglet « Hardware », cliquez sur « Add » puis sur « USB Decice ».

Sélectionnez « Use USB Port » puis sélectionnez la clé USB ConBee II.

Vérifiez qu’il s’agit bien de la clé ConBee puis cliquez sur « Add ».

Rendez-vous cette fois-ci sur l’interface d’administration de Home Assistant puis redémarrer complètement Home Assistant. Vous pouvez également passer par Proxmox pour redémarrer la VM si vous le souhaitez.

Une fois redémarré, retournez sur Home Assistant dans la partie « System » pour vérifier que la clé USB est bien détectée.

La clé Conbee apparait bien.

Vous pouvez garder de côté l’information « ttyACM0 ».

Configuration Add-on Mosquitto-broker

Nous allons maintenant configurer le premier add-on. Pour ce faire, rendez-vous dans la configuration de Home Assistant puis cliquez sur « Add-ons, Backups & Supervisor ».

Cliquez en bas à droite sur « Add add-on » puis recherchez l’add-on « Mosquitto Broker ».

Cliquez sur « Install ».

Cliquez sur l’onglet « Configuration » puis ajoutez les informations suivantes en prenant le soin de bien remplaçer le code en gras.

logins:
  - username: votre_username
    password: votre_password

Cliquez sur « Save » lorsque vous avez terminé.

Retournez dans l’onglet « Info » puis activez toutes les options et enfin cliquez sur « Start ».

Configuration Add-on Zigbee2mqtt

Nous allons pour terminer configurer l’add-on « zigbee2mqtt ». Attention car cet add-on ne fait pas parti de l’add-on store par défaut, il faudra ajouter un nouveau « repository » avant.

Depuis l’add-on store, cliquez tout en haut à droite sur les 3 petits points puis sur « Repositories ».

Ajoutez le repository suivant :

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Vous avez désormais accès à l’add-on « Zigbee2mqtt ».

Cliquez sur « Install ».

Depuis l’onglet « Configuration », ajoutez / modifiez le fichier avec les données suivantes :

• Réutilisez les identifiants précédemment utilisés dans la configuration de l’add-on « Mosquitto broker »
• Vérifiez que le port correspond bien au port de votre clé USB ConBee
• Modifiez le channel par 15

mqtt:
  base_topic: zigbee2mqtt
  user: votre_username_mqtt
  password: votre_password_mqtt

serial:
  port: /dev/ttyACM0
  adapter: deconz

advanced:
  log_level: warn
  pan_id: 6754
  channel: 15

Cliquez ensuite pour finir sur « Save ».

Retournez dans l’onglet « Info » puis activez toutes les options.

Vous pouvez maintenant cliquez sur « Start » pour démarrer l’add-on.

L’add-on « Zigbee2mqtt » devrait maintenant être disponible dans le menu de gauche. Cliquez sur l’add-on puis rendez-vous dans l’onglet « Settings » puis dans « About ». Si tout est bien configuré, vous devriez voir comme ci-dessous votre clé USB ConBee II.

Intégration Mosquitto Broker

Il faut maintenant configurer correctement l’intégration de l’add-on Mosquitto Broker. Pour ce faire, rendez-vous dans le menu principal « Configuration » puis cliquez sur « Devices & Services ».

Depuis le menu « Integrations », recherchez « MQTT » puis cliquez sur « Configure ».

Cliquez sur « Submit ».

Les nouveaux « device » sont automatiquement découverts.

Votre serveur Home Assistant est désormais prêt à recevoir des équipements compatibles Zigbee !