La versione Zigbee2MQTT 2.7.0 è stata rilasciata introducendo nuove funzioni, diversi miglioramenti e alcune problematiche che hanno coinvolto una parte degli utenti, poi corrette nella successiva 2.7.1.
Questo aggiornamento si concentra soprattutto sull’ampliamento delle funzioni del bridge e sulla compatibilità con nuovi dispositivi, ma ha anche generato alcuni comportamenti inattesi nei sistemi basati su Home Assistant OS.
Nuove Funzionalità
Tra le principali novità della versione 2.7.0 troviamo:
- Bridge Request API (azione diretta): introdotta la possibilità di eseguire comandi
bridge/request, utile ad esempio per il reset dei dispositivi Philips Hue tramite numero seriale, grazie al lavoro di reverse engineering condotto dalla community. - Nuove funzioni di Bind, Reporting e Mappa: miglioramenti nella gestione dei dispositivi Zigbee e nella visualizzazione della rete, con possibilità di ottenere informazioni più dettagliate e aggiornate sui nodi.
Miglioramenti
Zigbee2MQTT 2.7.0 include una serie di miglioramenti estesi a numerosi dispositivi:
- Iris iL07_1 – ora espone il livello di batteria.
- Aqara T2, T1, T1M e T1 – aggiunto supporto a più funzioni, ampliando la compatibilità con la gamma completa di sensori e attuatori.
- Third Reality 3RDP01072Z e 3RSB02015Z – supporto aggiuntivo per nuove funzionalità.
- SONOFF S60ZBTPF – ora mostra i valori di energia, semplificando il monitoraggio dei consumi.
- Aqara W100 – supporto completamente rivisto.
- IKEA E2204/E2206 – esposizione dei parametri child_lock e led_enable.
- Profalux MAI-ZTM20C – aggiunti comandi azione e voltaggio batteria.
- MultIR MIR-SM200 – aggiunto supporto al comando “silence”.
Queste ottimizzazioni migliorano l’interoperabilità e la precisione delle letture, specialmente in scenari con un elevato numero di dispositivi.
Problemi riscontrati dopo l’aggiornamento
Subito dopo il rilascio, diversi utenti hanno segnalato malfunzionamenti specifici:
- Crash e riavvii del servizio: alcuni sistemi hanno registrato errori come
ERROR_EXCEEDED_MAXIMUM_ACK_TIMEOUT_COUNTeHOST_FATAL_ERROR, in particolare con dongle SONOFF Zigbee-E (EmberZNet 8.0.x). - Aumento eccessivo delle scritture su disco: in alcuni casi sono stati registrati fino a 200 MB/ora di scritture, legate alla nuova funzione Activity introdotta nel frontend.
Questo ha causato rallentamenti e ritardi nelle risposte dei dispositivi, in particolare in reti con oltre 100 nodi Zigbee. - Luci che si accendono da sole al minimo: diversi utenti hanno segnalato accensioni casuali di lampadine a bassa luminosità dopo l’update, problema risolto solo dopo il downgrade alla versione 2.6.3.
- Rallentamenti nella creazione della mappa di rete Zigbee e ritardi nei comandi verso prese e lampadine.
Il maintainer Koenkk ha confermato che i problemi erano legati a un bug nella gestione dell’attività del frontend e che la correzione è stata inclusa nella branch di sviluppo, poi rilasciata con la versione 2.7.1 come hotfix ufficiale.
Come risolvere i problemi
Chi ha riscontrato comportamenti anomali può adottare le seguenti soluzioni:
- Aggiornare alla versione 2.7.1, che risolve i problemi di crash e di eccessive scritture su disco.
- Verificare il firmware del coordinatore Zigbee: aggiornare all’ultima versione stabile, come EmberZNet 7.4.5 o 8.0.2, ha permesso a molti utenti di stabilizzare la rete.
- In caso di malfunzionamenti persistenti, eseguire un rollback alla versione 2.6.3 e successivamente reinstallare Zigbee2MQTT da zero, copiando solo la cartella
data/.
Aggiornare Zigbee2MQTT
Per chi utilizza Home Assistant OS, aggiornare Zigbee2MQTT è semplicissimo: basta accedere al menu delle impostazioni, dove la notifica di aggiornamento dovrebbe comparire come prima voce. Per chi invece utilizza HomeAssistant Core installato mediante Docker Compose, strumento che rappresenta la base dei setup che tratteremo su questo portale, l’aggiornamento può essere effettuato seguendo questi passaggi.
Conclusione
L’aggiornamento Zigbee2MQTT 2.7.0 ha introdotto funzioni utili e un’estensione del supporto ai dispositivi, ma anche una serie di problemi poi corretti nella release successiva.
Con l’arrivo della 2.7.1, la piattaforma è tornata stabile, mantenendo i nuovi miglioramenti del bridge e del sistema di reporting, garantendo una gestione più efficiente della rete Zigbee.
Per chi desidera approfondire, l’elenco completo delle novità è disponibile nel changelog ufficiale