🔌 Zigbee2MQTT: Gestione Protocolli Locali

::: info Indipendenza dal Cloud: L’uso di Zigbee2MQTT permette di utilizzare migliaia di dispositivi di marche diverse (Xiaomi, IKEA, Philips Hue, Sonoff) senza i loro bridge proprietari e senza che alcun dato lasci la rete locale. :::

1. L’Architettura Decoupled

A differenza dei sistemi monolitici, qui separiamo il livello fisico dal livello applicativo:

1. Hardware (Coordinator): Una chiavetta USB (es. Sonoff ZBDongle-P) collegata fisicamente al server Proxmox e passata alla VM.
2. Zigbee2MQTT (Bridge): Un servizio che traduce i segnali radio Zigbee in messaggi JSON.
3. Mosquitto (MQTT Broker): Il “postino” che riceve i messaggi e li smista.
4. Home Assistant: Riceve i messaggi dal Broker e crea le entità (luci, sensori, interruttori).

2. Configurazione Hardware (USB Passthrough)

Come documentato nella sezione Setup VM Proxmox, la chiavetta USB deve essere mappata correttamente:

• Proxmox GUI: VM -> Hardware -> Add -> USB Device.
• Consiglio Tecnico: Usa una prolunga USB (almeno 50cm). Le porte USB 3.0 dei PC generano interferenze elettromagnetiche che riducono drasticamente la portata del segnale Zigbee.

3. Installazione Add-ons Correlati

A. Mosquitto Broker

È il middleware fondamentale.

1. Installa l’Add-on Mosquitto broker.
2. Crea un utente dedicato in Home Assistant (Impostazioni -> Persone -> Utenti) chiamato mqtt-user.
3. Configura l’integrazione MQTT in Home Assistant per puntare al broker locale.

B. Zigbee2MQTT

1. Aggiungi il repository esterno in Add-on Store: https://github.com/zigbee2mqtt/hassio-addon.
2. Nella configurazione dell’Add-on, specifica la porta seriale della chiavetta:

serial:
  port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_...

📈 Flusso del Segnale (Mermaid)

graph LR
    SENS[Sensore Zigbee] -- Radio Zigbee --> DONG[USB Dongle]
    DONG -- Serial --> Z2M[Zigbee2MQTT]
    Z2M -- JSON via MQTT --> MOS[Mosquitto Broker]
    MOS -- Pub/Sub --> HA[Home Assistant]
    HA --> UI[Dashboard/Automazioni]

4. Pairing e Gestione Dispositivi

L’interfaccia di Zigbee2MQTT è accessibile dalla barra laterale di Home Assistant.

• Permit Join: Attiva l’accettazione di nuovi dispositivi.
• Map: Visualizzazione grafica della rete Mesh. Ricorda che i dispositivi alimentati a rete (lampadine, prese) fungono da Router, estendendo la portata della rete per i dispositivi a batteria (End Devices).

💡 Note dell’Ingegnere (Critical Thinking)

• Separation of Concerns: Usare Zigbee2MQTT via MQTT significa che se riavvii Home Assistant, la tua rete Zigbee resta attiva e stabile. Se decidessi di cambiare sistema domotico in futuro, la rete Zigbee rimarrebbe invariata poiché è gestita da un processo separato.
• Canali Radio: Zigbee lavora sulla frequenza 2.4GHz, la stessa del Wi-Fi. Per evitare collisioni, assicurati che il tuo Wi-Fi sia sui canali 1, 6 o 11 e che Zigbee sia sul canale 11, 15, 20 o 25.
• Backup: Zigbee2MQTT salva i dati della rete in /config/zigbee2mqtt. Includi sempre questa cartella nei tuoi backup.

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #Zigbee #MQTT #Zigbee2MQTT #IoT #HomeAutomation