Requisiti di sistema
Assicurati di disporre dei seguenti componenti e accessi:
Un coordinatore Zigbee (ad es. Sonoff ZBDongle, ConBee II, SkyConnect) collegato al tuo sistema domotico
Un software di gestione Zigbee installato e operativo, come:
Home Assistant con integrazione ZHA, oppure
Zigbee2MQTT con broker MQTT correttamente configurato
Un dispositivo Shelly con supporto Zigbee e accesso fisico al pulsante
Un computer o dispositivo mobile connesso alla stessa rete locale della piattaforma domotica
Configurazione passo per passo
Passo 1: Passare al firmware Zigbee (se applicabile)
Alcuni dispositivi Shelly vengono forniti con firmware Wi-Fi/Matter predefinito. Se il dispositivo supporta Zigbee ma non è in modalità Zigbee, è necessario effettuare il cambio manualmente.
Per firmware inferiori alla versione 1.7.0:
Premi rapidamente il pulsante del dispositivo 5 volte.
Attendi 5–10 secondi mentre il dispositivo passa alla modalità firmware Zigbee.
Nota: Questa procedura è necessaria solo una volta, a meno che il firmware non venga successivamente riportato manualmente alla modalità Wi-Fi.
Per firmware versione 1.7.0 e successive:
Il cambio firmware può essere effettuato solo tramite l’interfaccia web locale:
Settings → Switch to Matter/Zigbee
Passo 2: Attivare la modalità di associazione (pairing)
Il dispositivo Shelly deve essere in modalità di associazione per connettersi alla rete Zigbee.
Modalità di associazione automatica: attivata dopo un ripristino alle impostazioni di fabbrica
Modalità di associazione manuale: premi rapidamente il pulsante 3 volte
Passo 3: Associare il dispositivo alla rete Zigbee
Per Home Assistant (ZHA)
Vai a:
Settings → Devices & Services → Add Integration → Add Zigbee DeviceClicca su Add Device.
Attendi che il dispositivo Shelly venga rilevato.
Selezionalo e assegna facoltativamente un nome e un’area.
Per Zigbee2MQTT
Apri l’interfaccia web di Zigbee2MQTT (in genere
http://<tuo-ip>:8080).Clicca su Permit Join.
Attendi che il dispositivo Shelly venga scoperto.
Rinominalo e configuralo secondo necessità.
Passo 4: Utilizzare il dispositivo
Dopo l’associazione corretta, il dispositivo esporrà le entità Zigbee disponibili, come:
Interruttori
Sensori
Indicatori del livello batteria (se supportati)
Ora puoi utilizzare il dispositivo in automazioni, scene o tramite controllo manuale dalla tua piattaforma Zigbee.
Passo 5 (Consigliato): Aggiornare il firmware Zigbee
Per prestazioni ottimali e compatibilità continua, aggiorna il dispositivo Shelly all’ultima versione del firmware Zigbee disponibile.
⚠️ Gli aggiornamenti firmware devono attualmente essere eseguiti in modalità Wi-Fi/BLE. Gli aggiornamenti OTA tramite Zigbee non sono ancora supportati.
Procedura di aggiornamento
1. Attivare la modalità Wi-Fi/BLE
Tieni premuto il pulsante sul retro per 5 secondi per cambiare modalità.
2. Collegarsi al punto di accesso del dispositivo
Dopo il ripristino, il dispositivo trasmette un punto di accesso Wi-Fi locale.
Collegati ad esso e apri
http://192.168.33.1nel browser.
3. Aggiornare tramite interfaccia web
Vai su:
Settings → FirmwareInstalla l’ultima versione firmware disponibile che include miglioramenti Zigbee.
4. Verificare lo stato della connessione Zigbee
| Stato Zigbee | Significato |
|---|---|
| joined | Il dispositivo è correttamente connesso alla rete |
| steering | Il dispositivo è in modalità di associazione e sta cercando una rete |
| failed | Il dispositivo non è riuscito a unirsi alla rete |
Se lo stato mostra “failed”, premi rapidamente il pulsante 3 volte per riattivare la modalità di associazione.
Risoluzione dei problemi
| Problema | Soluzione |
|---|---|
| Nessuna risposta dopo 5 pressioni | Assicurati che le pressioni siano rapide e distinte; attendi 5–10 secondi dopo la sequenza |
| Il dispositivo non viene visualizzato | Verifica che sia in modalità Zigbee; ripeti l’associazione premendo 3 volte il pulsante |
| Il dispositivo appare come “unknown” | Attendi alcuni minuti; aggiorna le definizioni dei dispositivi del coordinatore Zigbee |
| Segnale Zigbee debole o disconnessioni | Avvicina il dispositivo al coordinatore o aggiungi router Zigbee per rafforzare la rete |