Bonjour à tous,
Je rencontre un problème avec l’appairage de mes appareils Zigbee sous Zigbee2MQTT. Après plusieurs tentatives et vérifications, mon dongle Sonoff Zigbee 3.0 USB Dongle Plus semble bien détecté et Zigbee2MQTT démarre correctement, mais aucun appareil ne s’ajoute malgré l’activation du mode appairage. 
Configuration Zigbee2MQTT (extrait)
mqtt:
base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: mqtt
password: xxxxx
serial:
adapter: zstack
port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_6e02b54d23b6ed11a9ebe10ea8669f5d-if00-port0
advanced:
log_level: debug
channel: 15
network_key: GENERATE
permit_join: true
frontend:
port: 8099
Ce qui fonctionne :
Le dongle est bien détecté :
ls -l /dev/serial/by-id/
# Résultat :
usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_6e02b54d23b6ed11a9ebe10ea8669f5d-if00-port0 -> ../../ttyUSB0
Zigbee2MQTT démarre correctement :
ha addons logs 45df7312_zigbee2mqtt
[info] Zigbee2MQTT started![info] Connected to MQTT server
Mosquitto fonctionne et Zigbee2MQTT est bien connecté :
mosquitto_sub -h core-mosquitto -u mqtt -P xxxxx-t zigbee2mqtt/bridge/state
{"state":"online"}
L’activation de l’appairage fonctionne :
mosquitto_pub -h core-mosquitto -u mqtt -P xxxxxx-t zigbee2mqtt/bridge/request/permit_join -m '{"value":true, "time":255}'
[info] Zigbee: allowing new devices to join.
Ce qui ne fonctionne pas :
Impossible d’appairer un appareil Zigbee
Même en mettant un appareil en mode appairage, aucun nouveau device n’apparaît dans Zigbee2MQTT.
Aucune trace de tentative d’appairage dans les logs
Lorsque je lance :
mosquitto_sub -h core-mosquitto -u mqtt -P xxxxx-t zigbee2mqtt/#
Je ne vois aucune tentative de connexion de nouveaux appareils.
Erreur MQTT « Invalid Payload » au début
Avant d’ajouter "time":255 à ma commande permit_join, j’avais cette erreur dans l’interface web de Zigbee2MQTT :
z2m: Request 'zigbee2mqtt/bridge/request/permit_join' failed with error: 'Invalid payload'
Depuis que j’ai corrigé cela, l’appairage est activé, mais aucun appareil ne se connecte.
Actions déjà tentées :
- Vérification que Zigbee2MQTT tourne bien → OK
- Vérification de la connexion MQTT → OK (
mosquitto_subfonctionne) - Vérification que le dongle est bien détecté → OK (
ls -l /dev/serial/by-id/) - Redémarrage du dongle USB et de Zigbee2MQTT → OK
- Essai sur un autre canal Zigbee (25 au lieu de 15) →
Toujours pas d’appairage - Réinitialisation de l’appareil Zigbee (appui long + reset complet) → Toujours pas d’appairage
- Changement du port USB du dongle → Pas d’amélioration
- Désactivation / réactivation de
permit_joinet redémarrage HA → Toujours rien
Questions aux experts Zigbee2MQTT :
- Pourquoi aucun appareil ne s’affiche dans les logs MQTT lorsqu’ils tentent de s’appairer ?
- Y a-t-il une étape que j’aurais oubliée pour que l’inclusion fonctionne ?
- Y a-t-il un problème de compatibilité avec certains appareils Zigbee ?
- Le dongle pourrait-il être mal flashé ? Dois-je le reflasher avec un autre firmware ?
- Des paramètres spécifiques à tester dans
configuration.yaml?
Merci d’avance pour votre aide ! 
Toute suggestion est la bienvenue.
Si besoin, je peux fournir d’autres logs ou tester des commandes spécifiques. 
Ma configuration :
- Home Assistant OS (HAOS)
- Zigbee2MQTT Add-on installé via le repository officiel (
45df7312_zigbee2mqtt) - Mosquitto MQTT Add-on installé et fonctionnel
- Dongle USB : Sonoff Zigbee 3.0 USB Dongle Plus (basé sur CC2652P)
- Version de Zigbee2MQTT : 2.0.0
- Version de zigbee-herdsman : 3.2.1
- Firmware du dongle :
zStack3x0 20210708
| version | core-2025.1.4 |
|---|---|
| installation_type | Home Assistant OS |
| dev | false |
| hassio | true |
| docker | true |
| user | root |
| virtualenv | false |
| python_version | 3.13.1 |
| os_name | Linux |
| os_version | 6.6.62-haos-raspi |
| arch | aarch64 |
| timezone | Europe/Paris |
| config_dir | /config |
Home Assistant Community Store
| GitHub API | ok |
|---|---|
| GitHub Content | ok |
| GitHub Web | ok |
| HACS Data | ok |
| GitHub API Calls Remaining | 5000 |
| Installed Version | 2.0.4 |
| Stage | running |
| Available Repositories | 1505 |
| Downloaded Repositories | 22 |
AccuWeather
| can_reach_server | ok |
|---|---|
| remaining_requests | 33 |
Home Assistant Cloud
| logged_in | true |
|---|---|
| subscription_expiration | 31 août 2025 à 02:00 |
| relayer_connected | true |
| relayer_region | eu-central-1 |
| remote_enabled | true |
| remote_connected | true |
| alexa_enabled | false |
| google_enabled | true |
| cloud_ice_servers_enabled | true |
| remote_server | eu-central-1-13.ui.nabu.casa |
| certificate_status | ready |
| instance_id | b4b8335cfd294451a88beb93010fa9b8 |
| can_reach_cert_server | ok |
| can_reach_cloud_auth | ok |
| can_reach_cloud | ok |
Home Assistant Supervisor
| host_os | Home Assistant OS 14.2 |
|---|---|
| update_channel | stable |
| supervisor_version | supervisor-2024.12.3 |
| agent_version | 1.6.0 |
| docker_version | 27.2.0 |
| disk_total | 116.5 GB |
| disk_used | 55.9 GB |
| healthy | true |
| supported | true |
| host_connectivity | true |
| supervisor_connectivity | true |
| ntp_synchronized | true |
| virtualization | |
| board | rpi5-64 |
| supervisor_api | ok |
| version_api | ok |
| installed_addons | Terminal & SSH (9.16.0), AdGuard Home (5.2.3), File editor (5.8.0), Linky (1.5.0), go2rtc (1.9.8), ESPresense Companion (1.0.15), AppDaemon (0.16.7), Studio Code Server (5.18.1), Spotify Connect (0.13.0), Frigate (0.14.1), NGINX Home Assistant SSL proxy (3.11.1), RPC Shutdown (2.5), Grafana (10.2.2), Jellyfin NAS (10.10.4), Jellyseerr (2.3.0), Radarr (5.17.2.9580), Sonarr (4.0.12.2866), qBittorrent (5.0.3), FlareSolverr (3.3.21), Jackett NAS (0.22.1309), OpenVPN Client (0.2.9), Mosquitto broker (6.5.0), Zigbee2MQTT (2.0.0-2) |
Dashboards
| dashboards | 2 |
|---|---|
| resources | 11 |
| views | 15 |
| mode | storage |
Recorder
| oldest_recorder_run | 18 janvier 2025 à 02:40 |
|---|---|
| current_recorder_run | 30 janvier 2025 à 23:13 |
| estimated_db_size | 384.89 MiB |
| database_engine | sqlite |
| database_version | 3.47.1 |
Spotify
| api_endpoint_reachable | ok |
|---|
