Sonoff ZBDongle-P: ZHA error DeliveryError / NWK_TABLE_FULL limite direct children raggiunto

1. A cosa serve

La guida risolve l'errore NWK_TABLE_FULL e DeliveryError su ZHA quando il coordinatore Sonoff ZBDongle-P raggiunge il limite massimo di collegamenti diretti (Direct Children) con i dispositivi Zigbee a batteria.

2. Specifiche e compatibilità

Hardware: Sonoff ZBDongle-P. Limite Direct Children: Max 32-50 dispositivi a batteria collegati direttamente al coordinatore. Piattaforme: ZHA / Zigbee2MQTT.

3. Materiali e prerequisiti necessari

Prerequisiti: 1. Presa smart Zigbee o modulo relè 230V con funzione Router Zigbee. 2. Mappa di rete ZHA/Z2M.

Fase 1: Preparazione

Apri la mappa della rete Zigbee su Home Assistant (ZHA > Visualizzazione Rete) e conta il numero di frecce che collegano direttamente i sensori a batteria alla chiavetta Sonoff senza passare da dispositivi a 230V.

[SCHEMA GRAFICO: Ristrutturazione Mesh Zigbee: Coordinatore ZBDongle-P <--- (Max 32 Nodi) ---> Router 230V (Presa Sonoff/Shelly) <--- Sensori a Batteria]

Aggiungi 3 o 4 prese smart Zigbee (Router) distribuite nella casa PRIMA di associare nuovi sensori a batteria: i sensori si collegheranno automaticamente ai router liberando la tabella del coordinatore!

Non tentare di aumentare il limite di tabelle ricompilando il firmware Z-Stack oltre i 200 nodi senza un adeguato coordinatore ad elevate prestazioni.

Fase 2: Configurazione

• Inserisci una presa smart Zigbee (es. Sonoff S26R2ZB) a metà casa. 2. Rimuovi 5 o 6 sensori a batteria che si trovano lontani. 3. Associa nuovamente i sensori a batteria facendoli passare attraverso la nuova presa smart router.

Gestione tabella di rete ZHA: zha.permit (con seleziona del router specifico).

Fase 3: Automazione / Uso pratico

Automazione YAML per notificare l'esaurimento dei nodi radio della rete:

alias: "Diagnostica - Allarme Limite Nodi Zigbee"
trigger:
  - platform: event
    event_type: zha_event
    event_data:
      command: "nwk_table_full"
action:
  - service: notify.persistent_notification
    data:
      title: "⚠️ Tabella Zigbee Piena"
      message: "Il coordinatore ha raggiunto il limite di connessioni dirette. Aggiungere router 230V."

Script YAML per forzare il pairing tramite un router specifico:

alias: "ZHA - Pairing tramite Presa Router Soggiorno"
sequence:
  - service: zha.permit
    data:
      ieee: "00:12:4b:00:22:aa:bb:cc"
      duration: 120

Verifica e test operativo

Esegui il pairing di un nuovo sensore Zigbee scegliendo la voce Accoppia tramite questo dispositivo selezionando la presa router: l'associazione avverrà immediatamente senza generare DeliveryError.

La mappa ZHA mostra la linea verde di collegamento tra il sensore e la presa router.

Cosa fare se qualcosa non funziona

• DeliveryError persiste: Sostituire le batterie scariche sui sensori che tentano continuamente la riconnessione. 2. Router non estende la rete: Verificare che la presa smart sia stabilmente alimentata a 230V. 3. Memoria piena: Aggiornare il firmware del Dongle-P alla versione Z-Stack 20230507.

9. Sicurezza e privacy

Topologia di rete Mesh distribuita in locale per la massima tolleranza ai guasti.

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.