Come integrare Shelly Gen1, Gen2 e Gen3 in Home Assistant

L’integrazione Shelly di Home Assistant comunica direttamente con il dispositivo sulla rete locale: non richiede il cloud Shelly per il controllo. Shelly Gen1, Gen2 e Gen3 sono famiglie hardware/firmware con API ed entità leggermente diverse; Home Assistant gestisce le differenze tramite una sola integrazione. Questa guida non sostituisce lo schema elettrico del modello: i dispositivi collegati alla rete elettrica devono essere installati da personale qualificato.

Prerequisiti & Hardware Necessario

• Un dispositivo Shelly Gen1, Gen2 o Gen3 alimentato secondo la tensione e lo schema del suo modello. Non applicare una tensione generica: verificare sempre l’etichetta e il manuale del prodotto.
• Home Assistant aggiornato e collegato alla stessa rete IP del dispositivo Shelly, oppure routing/firewall che permettano il traffico locale.
• Accesso all’interfaccia web del dispositivo e al router per individuare o riservare l’indirizzo IP.
• Rete Wi-Fi 2,4 GHz quando richiesta dal modello; alcuni dispositivi cablati o Pro usano Ethernet.
• Nessun link d’acquisto è inserito: questa è una procedura software e il modello Shelly deve essere scelto in base a carico, tensione e installazione.

Procedura passo-passo

1. Identifica la generazione. Leggi il modello sull’etichetta o nell’interfaccia web. Non confondere la generazione del dispositivo con la versione dell’integrazione Home Assistant. Gen1 richiede firmware almeno 1.9; alcuni Gen1, tra cui DUO, Bulb RGBW, Dimmer, Dimmer 2, RGBW2 e Vintage, richiedono almeno 1.11. Gen2 richiede firmware almeno 1.0. Verifica sempre la compatibilità del modello specifico.
2. Completa la messa in servizio hardware. Alimenta il dispositivo esclusivamente secondo il manuale. Per moduli da incasso o carichi a tensione di rete, disattiva il quadro, verifica l’assenza di tensione e fai eseguire il cablaggio a un elettricista. Per il primo abbinamento usa la procedura Wi-Fi prevista dal modello; non collegare un dispositivo 2,4 GHz a una rete solo 5 GHz.
3. Aggiorna il firmware. Apri l’interfaccia web del dispositivo, controlla la versione e installa un firmware stabile compatibile. Non interrompere alimentazione o rete durante l’OTA. Dopo il riavvio verifica che il dispositivo torni online.
4. Assegna un indirizzo stabile. Crea una prenotazione DHCP nel router e annota l’IP, per esempio 192.168.1.50. Se Shelly è in una VLAN IoT, Home Assistant deve poter raggiungere quell’IP e le regole firewall devono consentire il traffico richiesto dall’integrazione.
5. Configura nome e orario. Nel Web UI Shelly imposta un nome univoco, il fuso orario corretto e un server SNTP raggiungibile. La misurazione energetica e alcune funzioni temporali dipendono dall’orologio sincronizzato.
6. Aggiungi l’integrazione. In Home Assistant apri Impostazioni → Dispositivi e servizi → Aggiungi integrazione, cerca Shelly e segui la configurazione. Se l’auto-discovery mostra il dispositivo, seleziona Configura. Altrimenti inserisci manualmente l’hostname o l’indirizzo IP; la porta predefinita va cambiata solo se il dispositivo è collegato tramite Shelly Range Extender.
7. Controlla le entità. Un relay viene normalmente esposto come switch. Può essere esposto come light se il tipo appliance/consumption del dispositivo è configurato come luce. Per Gen2 e successivi gli script Shelly possono apparire come entità switch disabilitate di default: abilitali solo se ti servono.
8. Configura Bluetooth dove supportato. Se usi uno Shelly con scanner Bluetooth, nelle opzioni dell’integrazione scegli Auto per la maggior parte dei casi. Active aggiorna più rapidamente ma aumenta il consumo; Passive consuma meno ma può fornire meno dati. I dispositivi Shelly BLU non sono gestiti dall’integrazione Shelly, salvo BLU TRV tramite Shelly BLU Gateway Gen3: usa BTHome quando previsto.
9. Verifica il controllo locale. Spegni temporaneamente l’accesso Internet del dispositivo, senza interrompere la LAN. Da Home Assistant aziona il relay o leggi il sensore. Se il controllo continua a funzionare, la comunicazione locale è corretta e non dipende dal cloud.
10. Configura le automazioni. Usa le entità create dall’integrazione e assegna nomi basati sulla stanza e sulla funzione, non sul solo modello. Per carichi critici crea anche una condizione di sicurezza e definisci il comportamento dopo il riavvio di Home Assistant.
11. Proteggi l’accesso. Imposta una password nell’interfaccia Shelly, aggiorna il firmware e non pubblicare il Web UI sulla WAN. Se il dispositivo è in VLAN IoT, consenti Home Assistant verso gli IP Shelly e blocca l’accesso amministrativo dagli SSID ospiti.

Verifica del funzionamento

1. In Home Assistant apri la scheda Shelly e verifica che il dispositivo sia disponibile.
2. Aziona il relay o modifica il setpoint e controlla che lo stato torni entro pochi secondi.
3. Per un misuratore verifica potenza, energia e timestamp; valori fermi indicano spesso rete o SNTP non funzionanti.
4. Riavvia Home Assistant e il dispositivo Shelly: l’integrazione deve riconnettersi usando l’indirizzo riservato.
5. Se possibile, blocca l’uscita Internet del dispositivo e ripeti il test per confermare il controllo locale.

Problemi comuni

FAQ essenziali

Serve MQTT per integrare Shelly?

No. L’integrazione ufficiale Shelly di Home Assistant comunica direttamente con il dispositivo. MQTT è un percorso alternativo e non necessario per la configurazione standard.

Gen1, Gen2 e Gen3 si configurano allo stesso modo?

Il flusso Home Assistant è simile, ma API, entità, script e requisiti firmware cambiano tra generazioni. Identifica sempre modello e firmware prima di diagnosticare un problema.