Zigbee2MQTT 2.0.0: Tutte le Novità

Il tanto atteso aggiornamento Zigbee2MQTT 2.0.0 è finalmente disponibile, portando con sé una serie di importanti cambiamenti, ottimizzazioni strutturali e alcune modifiche che richiedono particolare attenzione durante la fase di aggiornamento. Questa nuova versione non si limita a piccoli miglioramenti ma introduce cambiamenti che avranno un impatto diretto sulla configurazione, sull'utilizzo e sulle automazioni già esistenti.

In questo articolo analizzeremo nel dettaglio tutte le novità, esplorando le modifiche più rilevanti, i nuovi approcci alle configurazioni e i cambiamenti che potrebbero influenzare le automazioni esistenti.

Una Struttura Tecnica Rivista

La versione 2.0.0 rappresenta un aggiornamento cruciale per Zigbee2MQTT, con una revisione profonda del codice e un’attenzione particolare all'ottimizzazione delle prestazioni e alla stabilità generale.

Miglioramenti chiave:

• Gestione avanzata dei driver delle antenne Coordinator.
• Rimozione definitiva di funzionalità obsolete.
• Ottimizzazione dei comandi e delle telemetrie MQTT.

Questi cambiamenti garantiscono una maggiore affidabilità anche per installazioni con reti Zigbee estese e complesse.

Gestione dei Coordinator Zigbee

Una delle novità più rilevanti riguarda la gestione dei Coordinator Zigbee. Zigbee2MQTT è ora in grado di rilevare automaticamente sia il tipo di antenna che il driver appropriato (zstack, ember, deconz, zigate, zboss). Tuttavia, per evitare errori in fase di avvio, è fortemente consigliato per chi non lo ha già fatto, esplicitare questi parametri nella configurazione, specie in caso di assenza del parametro serial.adapter. Vediamo insieme qualche esempio di configurazione.

Esempi di Configurazione Corretta

1. Per l'Antenna ZBDongle-P

serial:
  port: /dev/ttyUSB0
  adapter: zstack

2. Per l'Antenna ZBDongle-E (firmware NCP)

serial:
  port: /dev/ttyUSB0
  adapter: ember

Queste configurazioni assicurano un riconoscimento corretto del dispositivo Coordinator e prevengono eventuali problemi durante l’avvio.

Cambiamenti nei Sensori Action e Click

Un altro dei cambiamenti significativi è la rimozione definitiva delle entità sensor.*_action e sensor.*_click, precedentemente utilizzate per catturare eventi come click singolo, doppio click o pressioni prolungate.

Queste entità non sono più supportate, e le automazioni basate su di esse smetteranno di funzionare.

Come funzionava prima:

- alias: "vecchia_gestione"
  triggers:
    - platform: state
      entity_id: sensor.pulsante_sonoff
  actions:
    - choose:
        - conditions:
            - condition: template
              value_template: "{{ trigger.to_state.state == 'single' }}"
          sequence:
            - service: light.turn_on
        - conditions:
            - condition: template
              value_template: "{{ trigger.to_state.state == 'double' }}"
          sequence:
            - service: light.turn_off

Questa sintassi non è più valida e deve essere aggiornata.

Nuova Sintassi con Subtype

1. Utilizzando Trigger basati su Dispositivo

- alias: "nuova_gestione"
  triggers:
    - platform: device
      domain: mqtt
      device_id: DEVICE_ID
      type: action
      subtype: single
      id: single
    - platform: device
      domain: mqtt
      device_id: DEVICE_ID
      type: action
      subtype: double
      id: double
  actions:
    - choose:
        - conditions:
            - condition: trigger
              id: "single"
          sequence:
            - service: light.turn_on
        - conditions:
            - condition: trigger
              id: "double"
          sequence:
            - service: light.turn_off

2. Utilizzando Trigger basati su MQTT

- alias: "nuova_gestione"
  triggers:
    - platform: mqtt
      topic: zigbee2mqtt/pulsante_sonoff/action
      payload: "single"
      id: single
    - platform: mqtt
      topic: zigbee2mqtt/pulsante_sonoff/action
      payload: "double"
      id: double
  actions:
    - choose:
        - conditions:
            - condition: trigger
              id: "single"
          sequence:
            - service: light.turn_on
        - conditions:
            - condition: trigger
              id: "double"
          sequence:
            - service: light.turn_off

Questi nuovi approcci sono più chiari, robusti e permettono una migliore gestione degli eventi. Potrebbero però dare dei grattacapi a chi è abituato ad utilizzare l'interfaccia grafica.

Nuove Integrazioni e Dispositivi Supportati

Sono stati aggiunti oltre 70 nuovi dispositivi, tra cui:

• Termostati Tuya.
• Lampadine Philips Hue di ultima generazione.
• Sensori di movimento avanzati.
• Dispositivi per il controllo delle tende e tapparelle.

Inoltre, sono stati migliorati molti dispositivi esistenti, con una gestione più precisa dei loro parametri.

Breaking Changes

Nonostante le molteplici novità, i seguenti cambiamenti nella versione 2.0.0 richiedono attenzione:

• Rimozione definitiva delle entità sensor.*_action e sensor.*_click.
• Necessità di configurare manualmente il parametro serial.adapter.
• Disabilitazione delle opzioni legacy tramite parametri di configurazione consigliati.

È essenziale verificare attentamente la configurazione e aggiornare le automazioni esistenti prima di completare l’aggiornamento.

Preparazione all'Aggiornamento

Come già detto, aggiornare a questa versione richiede particolare attenzione:

1. Backup Completo: Prima di tutto, assicurati di avere una copia completa della tua configurazione.
2. Verificare le Note di Rilascio: Consulta la documentazione ufficiale per individuare eventuali interventi richiesti.
3. Eseguire l’Aggiornamento Gradualmente: Non forzare il processo e monitora i log per individuare eventuali problemi.

Aggiornamento file di configurazione

Prima di procedere con l'aggiornamento, è altamente consigliato aggiornare il file configuration.yamldi Zigbee2MQTT inserendo i seguenti parametri:

advanced:
  homeassistant_legacy_entity_attributes: false
  homeassistant_legacy_triggers: false
  legacy_api: false
  legacy_availability_payload: false
device_options:
  legacy: false

Queste impostazioni garantiscono la disabilitazione delle funzionalità obsolete, permettendo una migrazione lineare alla versione 2.0.0.

Backup e Percorso della Configurazione

Nei sistemi basati su Home Assistant OS o Supervised, Zigbee2MQTT ha spostato la configurazione nella cartella specifica dell’addon per garantire una perfetta integrazione con il sistema di backup automatico di Home Assistant.

Cosa fare?

• Fermare l'addon Zigbee2MQTT.
• Spostare la cartella di configurazione nel nuovo percorso /addon_config/zigbee2mqtt.
• Aggiornare il data_path nel file di configurazione.
• Riavviare l’addon.

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.

Leggi anche

Comandi essenziali per la gestione del sistema!

11 Novembre 2024

  Commenti

Conclusioni

L'aggiornamento Zigbee2MQTT 2.0.0 rappresenta un passo significativo verso una gestione più moderna ed efficiente delle reti Zigbee. Le ottimizzazioni tecniche, la nuova gestione dei sensori Action e Click e le raccomandazioni per la configurazione sono elementi cruciali per garantire una transizione senza intoppi.

Per ulteriori dettagli e per discutere con la community, puoi consultare la pagina ufficiale di Zigbee2MQTT 2.0.0.

Se hai bisogno di supporto per la migrazione o per l’adeguamento delle automazioni, sono qui per aiutarti.