Guida all’integrazione dei dispositivi Shelly Zigbee

Modificato il Gio, 31 Lug alle 3:50 PM

Requisiti di sistema

Prima di iniziare, assicurati di avere quanto segue:

  • Un coordinatore Zigbee (es. Sonoff ZBDongle, ConBee II, SkyConnect) collegato al tuo sistema domotico

  • Un software di controllo Zigbee installato e funzionante, come:

    • Home Assistant con integrazione ZHA

    • Zigbee2MQTT con un broker MQTT

  • Un dispositivo Shelly compatibile con Zigbee, con accesso fisico al pulsante

  • Un computer o dispositivo mobile connesso alla stessa rete del tuo sistema domotico


Guida passo passo

Passaggio 1: Passare al firmware Zigbee (se necessario)

Alcuni dispositivi Shelly vengono forniti con firmware Wi-Fi/Matter di default. Se il tuo dispositivo supporta Zigbee ma è in modalità Wi-Fi, procedi così:

  1. Premi rapidamente il pulsante 5 volte

  2. Attendi 5–10 secondi per il passaggio alla modalità Zigbee

Nota: Questo passaggio è necessario solo una volta, a meno che tu non torni successivamente al firmware Wi-Fi.


Passaggio 2: Attivare la modalità di accoppiamento

Per connettersi alla rete Zigbee, il dispositivo deve essere in modalità di accoppiamento:

  • Modalità automatica: attivata dopo un ripristino di fabbrica

  • Modalità manuale: premi rapidamente il pulsante 3 volte


Passaggio 3: Associare il dispositivo alla rete Zigbee

Con Home Assistant (ZHA)

  1. Vai su:
    Impostazioni → Dispositivi e servizi → Aggiungi integrazione → Aggiungi dispositivo Zigbee

  2. Clicca su “Aggiungi dispositivo”

  3. Attendi che il dispositivo Shelly venga rilevato

  4. Selezionalo e assegna un nome e una stanza se lo desideri

Con Zigbee2MQTT

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

  2. Clicca su “Permit Join”

  3. Attendi che il dispositivo venga rilevato

  4. Rinominalo e configurarlo come necessario


Passaggio 4: Utilizzo del dispositivo

Dopo l'accoppiamento, il dispositivo espone le entità disponibili, ad esempio:

  • Interruttori

  • Sensori

  • Stato della batteria (se supportato)

Puoi ora usare il dispositivo in automazioni, scene o per il controllo manuale tramite la tua piattaforma Zigbee.


Passaggio 5 (consigliato): Aggiornamento del firmware Zigbee

Per prestazioni ottimali e massima compatibilità, aggiorna sempre il dispositivo Shelly all’ultima versione del firmware Zigbee.

⚠️ Attenzione: Gli aggiornamenti OTA tramite Zigbee non sono attualmente supportati. È necessario passare temporaneamente alla modalità Wi-Fi/BLE.

Procedura di aggiornamento

  1. Attiva la modalità Wi-Fi/BLE
    Tieni premuto il pulsante posteriore per 5 secondi

  2. Connettiti al punto di accesso del dispositivo

    • Dopo il reset, il dispositivo creerà un access point Wi-Fi

    • Connettiti ad esso e apri il browser su http://192.168.33.1

  3. Aggiorna il firmware tramite interfaccia web

    • Vai su Impostazioni → Firmware

    • Installa l’ultima versione disponibile

  4. Verifica lo stato Zigbee

Stato ZigbeeSignificato
joinedIl dispositivo è connesso alla rete Zigbee
steeringIl dispositivo è in modalità accoppiamento
failedConnessione fallita – ripetere l’accoppiamento

Se lo stato mostra “failed”, premi 3 volte rapidamente il pulsante per riavviare l’accoppiamento.


Risoluzione dei problemi

ProblemaSoluzione
Nessuna reazione dopo 5 pressioniAssicurati che le pressioni siano rapide e distinte; attendi 5–10 secondi
Il dispositivo non appareVerifica che sia in modalità Zigbee; ripeti l’accoppiamento (3 pressioni)
Il dispositivo è “sconosciuto”Attendi alcuni minuti; aggiorna il software Zigbee o le definizioni dei dispositivi
Connessione Zigbee instabileAvvicina il dispositivo al coordinatore o aggiungi dispositivi router Zigbee