Sonoff ZBDongle-P: Errore SRSP - ZDO - mgmtPermitJoinReq after 6000ms su Zigbee2MQTT

1. A cosa serve

La guida risolve il blocco dell'avvio della modalità di accoppiamento (Permit Join) su Zigbee2MQTT quando si utilizza la chiavetta USB Sonoff ZBDongle-P (chip Texas Instruments CC2652P). L'errore si manifesta con un timeout di 6000 millisecondi che impedisce l'aggiunta di nuovi dispositivi Zigbee alla rete.

2. Specifiche e compatibilità

Hardware interessato: Sonoff ZBDongle-P (CC2652P + CP2102N). Firmware: Z-Stack 3.x. Piattaforme: Zigbee2MQTT su Home Assistant OS / Container.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Cavo prolunga USB 2.0 schermato da 1 metro. 2. Accesso alla configurazione seriale di Zigbee2MQTT.

Fase 1: Preparazione

Scollega il coordinatore ZBDongle-P dalla porta USB diretta del server ed inseriscilo su una prolunga USB 2.0 per allontanarlo dalle interferenze a 2.4 GHz generate dalle porte USB 3.0.

[SCHEMA GRAFICO: Connessione Seriale ZBDongle-P: Server Host ---> Prolunga USB 2.0 (1.5m) ---> ZBDongle-P (Port: /dev/serial/by-id/..., rtscts: false)]

Utilizza sempre il percorso seriale persistente /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus... anziché /dev/ttyUSB0 per evitare che la porta seriale cambi al riavvio del server!

Non scollegare mai il coordinatore Zigbee mentre l'Add-on Zigbee2MQTT sta eseguendo l'inizializzazione del database.

Fase 2: Configurazione

• Apri l'Add-on Zigbee2MQTT in Home Assistant. 2. Entra nella scheda Configurazione (Configuration). 3. Nella sezione serial, imposta rtscts: false. 4. Verifica che il percorso della porta seriale punti al device ID fisso. 5. Salva e riavvia l'Add-on.

Parametri seriali Z2M: port: /dev/serial/by-id/..., adapter: zstack, rtscts: false.

Fase 3: Automazione / Uso pratico

File di configurazione correttivo configuration.yaml per Zigbee2MQTT:

serial:
  port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_20211215-if00-port0
  adapter: zstack
  rtscts: false
advanced:
  log_level: info

Automazione YAML di monitoraggio dello stato del bridge Zigbee:

alias: "Diagnostica - Allarme Bridge Z2M Offline"
trigger:
  - platform: state
    entity_id: sensor.zigbee2mqtt_bridge_state
    to: "offline"
action:
  - service: notify.persistent_notification
    data:
      title: "🚨 Zigbee2MQTT Offline"
      message: "Il bridge Zigbee2MQTT ha perso la connessione con il coordinatore."

Verifica e test operativo

Clicca sul pulsante 'Attiva accoppiamento (Permit Join All)' nell'interfaccia di Zigbee2MQTT: il conto alla rovescia da 254 secondi deve avviarsi immediatamente.

Il LED verde sul corpo del Sonoff ZBDongle-P inizia a lampeggiare ed il registro mostra zstack: permit join success.

Cosa fare se qualcosa non funziona

• Errore persiste: Aggiornare il firmware del ZBDongle-P con l'utility cc2538-prog. 2. Porta seriale non trovata: Sostituire il cavo di prolunga USB. 3. Accesso negato: Verificare i permessi della porta seriale su Linux.

9. Sicurezza e privacy

Tutti i comandi di gestione della rete Zigbee rimangono locali ed isolati all'interno dell'hub Home Assistant.

10. Requisiti e Risorse Ufficiali

Questa guida risolve una problematica tecnica di configurazione o sistema domotico. Di seguito i riferimenti alle documentazioni ufficiali:

* 🌐 Documentazione Ufficiale Home Assistant: [home-assistant.io/help](https://www.home-assistant.io/help/)

* 📦 Repository GitHub Troubleshooting: [github.com/home-assistant/core/issues](https://github.com/home-assistant/core/issues)

* 🛠️ Prerequisiti di sistema: Server Home Assistant OS aggiornato, connessione di rete LAN locale ed accesso Amministratore.