Sonoff MINI-ZBD Interruptor de Contacto Limpio Smart Zigbee

# Integrazione Home Assistant per controllo locale Zigbee ## Panoramica Questa guida descrive come configurare un sistema di controllo locale Zigbee con Home Assistant, eliminando la dipendenza dal cloud e garantendo privacy e affidabilità. --- ## Requisiti Hardware ### Coordinatore Zigbee (scegliere uno) - **Sonoff Zigbee 3.0 USB Dongle Plus** (consigliato) - **HUSBZB-1** (dual Zigbee/Z-Wave) - **ConBee II / RaspBee II** (Dresden Elektronik) - **CC2652P** basato su moduli vari ### Hardware per Home Assistant - Raspberry Pi 4 (2GB+ RAM) - Home Assistant Yellow - Home Assistant Green - Qualsiasi PC/NUC con Home Assistant OS --- ## Metodi di Integrazione ### 🥇 Metodo 1: ZHA (Zigbee Home Automation) *Integrazione nativa di Home Assistant* **Vantaggi:** - ✅ Integrato nativamente in HA - ✅ Nessun componente aggiuntivo richiesto - ✅ Configurazione semplice - ✅ Supporto multiprotocollo **Svantaggi:** - ❌ Meno dispositivi supportati rispetto a Z2M - ❌ Automazioni Zigbee limitate **Installazione:** ``` Impostazioni → Dispositivi e Servizi → Aggiungi Integrazione → ZHA ``` --- ### 🥈 Metodo 2: Zigbee2MQTT (Z2M) *Soluzione più potente e flessibile* **Vantaggi:** - ✅ Oltre 3000 dispositivi supportati - ✅ Controllo avanzato della rete - ✅ Esposizione tramite MQTT - ✅ Community molto attiva - ✅ Mappe della rete Zigbee **Svantaggi:** - ❌ Richiede broker MQTT (Mosquitto) - ❌ Configurazione più complessa --- ## Installazione Zigbee2MQTT ### Step 1: Installare Mosquitto Broker ```yaml # Add-on Store → Mosquitto Broker # Configurazione base: logins: - username: mqtt_user password: password_sicura ``` ### Step 2: Configurare utente MQTT in HA ``` Impostazioni → Persone → Utenti → Crea utente MQTT ``` ### Step 3: Installare Zigbee2MQTT Add-on Aggiungere repository: ``` https://github.com/zigbee2mqtt/hassio-zigbee2mqtt ``` ### Step 4: Configurazione Z2M ```yaml # Configurazione Zigbee2MQTT mqtt: base_topic: zigbee2mqtt server: mqtt://core-mosquitto user: mqtt_user password: password_sicura serial: port: /dev/ttyUSB0 # Adattare alla propria porta # oppure per dongle USB: # port: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee... homeassistant: enabled: true frontend: enabled: true port: 8099 advanced: log_level: info network_key: GENERATE # Genera automaticamente pan_id: GENERATE channel: 11 # Canali consigliati: 11, 15, 20, 25 ``` --- ## Ottimizzazione della Rete Zigbee ### Selezione del Canale ``` Canali Zigbee vs WiFi 2.4GHz: ├── Zigbee CH 11 → Lontano da WiFi CH 1,6,11 ├── Zigbee CH 15 → Buona separazione ├── Zigbee CH 20 → Consigliato con WiFi CH 6 └── Zigbee CH 25 → Consigliato con WiFi CH 11 ``` ### Dispositivi Router (Mesh) ```yaml # Dispositivi che estendono la rete (sempre alimentati): - Prese smart Zigbee - Lampadine smart (collegare sempre) - Ripetitori dedicati IKEA TRÅDFRI # Dispositivi End Device (solo ricevono): - Sensori batteria - Telecomandi - Sensori porta/finestra ``` --- ## Automazioni di Esempio ### Luce con Sensore di Movimento ```yaml alias: "Luce Corridoio - Sensore Movimento" description: "Accende la luce al movimento e la spegne dopo 5 minuti" trigger: - platform: state entity_id: binary_sensor.sensore_corridoio_occupancy to: "on" condition: - condition: state entity_id: sun.sun state: below_horizon action: - service: light.turn_on target: entity_id: light.luce_corridoio data: brightness_pct: 80 color_temp: 4000 - wait_for_trigger: - platform: state entity_id: binary_sensor.sensore_corridoio_occupancy to: "off" for: "00:05:00" - service: light.turn_off target: entity_id: light.luce_corridoio mode: restart ``` ### Notifica Batteria Scarica ```yaml alias: "Avviso Batteria Dispositivi Zigbee" trigger: - platform: numeric_state entity_id: - sensor.sensore_porta_battery - sensor.sensore_finestra_battery - sensor.telecomando_battery below: 20 action: - service: notify.mobile_app data: title: "⚠️ Batteria Scarica" message: "{{ trigger.to_state.name }} ha {{ trigger.to_state.state }}% di batteria" ``` --- ## Dashboard Zigbee ```yaml # Esempio card per monitoring rete type: vertical-stack cards: - type: entities title: "🔷 Stato Rete Zigbee" entities: - entity: sensor.zigbee2mqtt_bridge_state name: "Bridge Status" - entity: sensor.zigbee2mqtt_bridge_devices name: "Dispositivi Connessi" - type: custom:zigbee2mqtt-networkmap # Richiede custom card da HACS ``` --- ## Troubleshooting Comune | Problema | Soluzione | |----------|-----------| | Dispositivo non trovato | Tenere in modalità pairing vicino al coordinatore | | Segnale debole | Aggiungere router Zigbee intermedi | | Interferenze WiFi | Cambiare canale Zigbee | | Coordinatore non rilevato | Verificare permessi porta USB (`dialout` group) | | Dispositivo offline frequente | Controllare livello batteria o interferenze | --- ## Sicurezza ```yaml # Best practice sicurezza - Usare network_key personalizzata (non GENERATE in produzione) - Abilitare autenticazione MQTT - Aggiornare regolarmente Z2M e HA - Backup configurazione periodico - Limitare accesso frontend Z2M ``` --- ## Risorse Utili - 📚 [Zigbee2MQTT Docs](https://www.zigbee2mqtt.io) - 🔍 [Dispositivi Supportati Z2M](https://www.zigbee2mqtt.io/supported-devices/) - 🏠 [ZHA Device Compatibility](https://zigbee.blakadder.com) - 💬 [Community HA Italia](https://community.home-assistant.io) - 🛒 [Guida acquisto coordinatori](https://www.zigbee2mqtt.io/guide/adapters/)