Guida all’integrazione dei dispositivi Shelly Zigbee

Modificato il Lun, 23 Feb alle 4:07 PM

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:

  1. Premi rapidamente il pulsante del dispositivo 5 volte.

  2. 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)

  1. Vai a:
    Settings → Devices & Services → Add Integration → Add Zigbee Device

  2. Clicca su Add Device.

  3. Attendi che il dispositivo Shelly venga rilevato.

  4. Selezionalo e assegna facoltativamente un nome e un’area.

Per Zigbee2MQTT

  1. Apri l’interfaccia web di Zigbee2MQTT (in genere http://<tuo-ip>:8080).

  2. Clicca su Permit Join.

  3. Attendi che il dispositivo Shelly venga scoperto.

  4. 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.1 nel browser.

3. Aggiornare tramite interfaccia web

  • Vai su: Settings → Firmware

  • Installa l’ultima versione firmware disponibile che include miglioramenti Zigbee.

4. Verificare lo stato della connessione Zigbee

Stato ZigbeeSignificato
joinedIl dispositivo è correttamente connesso alla rete
steeringIl dispositivo è in modalità di associazione e sta cercando una rete
failedIl 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

ProblemaSoluzione
Nessuna risposta dopo 5 pressioniAssicurati che le pressioni siano rapide e distinte; attendi 5–10 secondi dopo la sequenza
Il dispositivo non viene visualizzatoVerifica 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 disconnessioniAvvicina il dispositivo al coordinatore o aggiungi router Zigbee per rafforzare la rete