Connecter Zigbee2MQTT au cloud Elark

Pré-requis

• Une instance Zigbee2MQTT v1.34+ déjà fonctionnelle (capteurs jumelés, MQTT local OK).
• Un compte Elark avec un mot de passe MQTT renseigné dans Paramètres › Identifiants par défaut.

Si vous voulez garder vos automations Home Assistant existantes, gardez Zigbee2MQTT connecté à son broker actuel en parallèle — il est possible de publier sur deux brokers via mosquitto bridge. Voir la section Bridge double broker en bas.

Étape 1 — Créer une passerelle Zigbee2MQTT dans Elark

1. Dans l’app, ouvrez Passerelles MQTT › + Nouvelle passerelle.
2. Choisissez Zigbee2MQTT dans la liste.
3. Donnez-lui un nom (ex. « Maison principale ») et un topic racine. Par défaut zigbee2mqtt — gardez-le si vous n’en avez qu’une.
4. Validez. Notez le claim_code qui s’affiche sur la fiche.

Étape 2 — Modifier la configuration de Zigbee2MQTT

Éditez le fichier configuration.yaml de votre instance Z2M. Selon votre installation :

• Raspberry Pi natif : /opt/zigbee2mqtt/data/configuration.yaml
• Docker : volume monté, souvent ./data/configuration.yaml
• HA OS add-on : /share/zigbee2mqtt/configuration.yaml

Remplacez la section mqtt: par :

mqtt:
  base_topic: zigbee2mqtt
  server: 'mqtts://mqtt.elark.cloud:8883'
  user: <claim_code_passerelle>
  password: <mqtt_password_elark>
  reject_unauthorized: true
  client_id: elark-z2m-<id-unique>      # important si plusieurs instances
  keepalive: 60
  version: 4
  # Republie l'état complet à chaque (re)connexion :
  force_disable_retain: false

Sauvegardez puis redémarrez Z2M :

# Raspberry Pi natif
sudo systemctl restart zigbee2mqtt

# Docker
docker compose restart zigbee2mqtt

# HA OS
# Onglet Add-ons → Zigbee2MQTT → Restart

Étape 3 — Vérifier la connexion

Dans les logs Z2M, vous devez voir :

Zigbee2MQTT:info  2026-05-19 14:32:11: Connecting to MQTT server at mqtts://mqtt.elark.cloud:8883
Zigbee2MQTT:info  2026-05-19 14:32:12: Connected to MQTT server
Zigbee2MQTT:info  2026-05-19 14:32:12: MQTT publish: topic 'zigbee2mqtt/bridge/state', payload '{"state":"online"}'

Côté Elark, allez sur Passerelles MQTT et cliquez « Voir devices » — vous devez voir vos capteurs Zigbee apparaître au fur et à mesure (chaque appareil republie son état dans les premières secondes).

Étape 4 — Mappage des entités

Elark utilise le mécanisme de découverte natif de Z2M (topic zigbee2mqtt/bridge/devices). Pour chaque appareil détecté, il crée :

• une fiche dans Mes appareils,
• des entités selon les exposes Z2M : switch pour les prises, light pour les ampoules, sensor pour température / humidité / batterie, cover pour les volets, binary_sensor pour contacts/PIR.

Cela peut prendre 30 s à 2 min selon le nombre d’appareils. Si certains capteurs ne remontent pas, forcez une republish depuis l’interface Z2M :Devices › Refresh.

Renommer un appareil

Renommez vos devices côté Z2M (UI Devices › Edit › Friendly name). Le nouveau nom remonte automatiquement dans Elark via le topic bridge/devices. Pas besoin de rejumeler ni recréer côté Elark.

Commandes depuis l’app

Tous les set que vous pouvez faire en MQTT direct passent par l’app Elark. Exemple : actionner un interrupteur Ikea Tradfri → Elark publie en interne :

zigbee2mqtt/Salon/Plafonnier/set {"state":"ON","brightness":180}

Z2M relaye au mesh Zigbee, puis publie l’état mis à jour sur zigbee2mqtt/Salon/Plafonnier, qu’Elark capte. Délai end-to-end typique : 200-600 ms.

Bridge double broker (Z2M → broker local ET Elark)

Si vous voulez garder vos automations Home Assistant ou Node-RED existantes et juste aussi publier vers Elark, configurez un bridge sur votre Mosquitto local :

# /etc/mosquitto/conf.d/elark-bridge.conf
connection elark-cloud
address mqtt.elark.cloud:8883
remote_username <claim_code_passerelle>
remote_password <mqtt_password_elark>
remote_clientid mosq-bridge-elark
bridge_protocol_version mqttv311
bridge_insecure false
bridge_capath /etc/ssl/certs
topic zigbee2mqtt/# out 1 "" ""
topic zigbee2mqtt/+/set in 1 "" ""
try_private false
notifications false
cleansession true
keepalive_interval 60

Puis : sudo systemctl restart mosquitto.

Tous les messages Z2M sortent vers Elark, et toutes les commandes .../set arrivant d’Elark sont retransmises à Z2M en local.

Dépannage

• « unauthorized » dans les logs Z2M : le mot de passe n’est pas le bon. Vérifiez dans Paramètres › Identifiants par défaut › Mot de passe MQTT.
• Aucun device n’apparaît : vérifiez que Z2M publie bien zigbee2mqtt/bridge/devices. Un message force_disable_retain: false en config force la republish.
• Latence élevée (> 2 s) : vérifiez la qualité réseau de votre Pi. Z2M est très sensible aux pertes Wi-Fi — préférez l’Ethernet.
• Doublons dans la liste : un même appareil sur deux instances Z2M (homonyme). Renommez l’une via friendly_name.