Home Assistant
Come configurare Shelly 2PM su Home Assistant: Guida Completa
Guida tecnica dettagliata per configurare Shelly 2PM su Home Assistant in modalità tapparella o due canali, con calibrazione, verifiche e risoluzione problemi.
Introduzione alla configurazione dello Shelly 2PM
Lo Shelly 2PM è uno dei relè smart più versatili sul mercato, ampiamente utilizzato per la domotizzazione di tapparelle, tende da sole o per il controllo indipendente di due carichi elettrici separati. Questa guida illustra come integrare il dispositivo all'interno di Home Assistant sfruttando l'integrazione nativa, garantendo una comunicazione stabile tramite protocollo MQTT o HTTP (tramite l'integrazione ufficiale Shelly). Il risultato finale sarà un sistema reattivo, sicuro e perfettamente integrato nella plancia di controllo della tua smart home.
Prima di iniziare, è fondamentale chiarire i prerequisiti e i limiti operativi. Lavorando con tensioni di rete a 230V, la sicurezza elettrica è la priorità assoluta: se non si possiedono le competenze di base o se l'impianto presenta anomalie, è obbligatorio affidarsi a un elettricista qualificato prima di procedere con il cablaggio fisico. Sul fronte software, questa guida si riferisce alle versioni recenti del firmware Shelly (Generation 2, firmware 1.x e successivi) e alle ultime release di Home Assistant Core con integrazione Shelly basata su RPC/WebSocket.
Prerequisiti, compatibilità e precauzioni di sicurezza
Per completare con successo la configurazione, assicurati di disporre dei seguenti elementi:
- Uno Shelly 2PM correttamente cablato all'impianto elettrico (modalità Roller Shutter o Relay).
- Una rete Wi-Fi stabile a 2.4 GHz raggiungibile dal dispositivo.
- Uno smartphone o un PC per la configurazione iniziale tramite il web server integrato dello Shelly.
- Un'istanza di Home Assistant Green aggiornata e connessa alla stessa rete locale (o tramite VLAN opportunamente instradata).
Avviso di sicurezza fondamentale: scollega sempre l'interruttore generale magnetotermico prima di intervenire sui cavi elettrici della scatola di derivazione o del frutto a muro. Il mancato rispetto delle norme di sicurezza può causare folgorazioni gravi o danni permanenti al dispositivo.
Procedura passo dopo passo
Segui attentamente questa procedura per configurare lo Shelly 2PM e integrarlo all'interno di Home Assistant, partendo dal reset del dispositivo fino al controllo dei sensori.
- Alimenta il dispositivo e connettiti alla rete Wi-Fi temporanea generata dallo Shelly (denominata Shelly2PM-xxxxxx) tramite uno smartphone o un PC.
- Apri un browser web e digita l'indirizzo IP predefinito dello Shelly (solitamente
192.168.33.1) per accedere al pannello di controllo web locale. - Accedi alla sezione delle impostazioni di rete (Internet & Security) per configurare la connessione alla tua rete Wi-Fi domestica stabile, inserendo SSID e password corretti.
- Aggiorna il firmware del dispositivo all'ultima versione disponibile tramite il pannello di controllo web, così da garantire la massima compatibilità con le API locali di Home Assistant.
- Imposta la modalità di funzionamento desiderata accedendo alle preferenze del dispositivo: seleziona 'Roller' se utilizzi il modulo per una tapparella, oppure 'Relay' se controlli due carichi indipendenti.
- Abilita il protocollo RPC (se non già attivo di default) e annota l'indirizzo IP statico assegnato al dispositivo dal tuo router, oppure imposta una prenotazione DHCP fissa.
- Apri Home Assistant, vai nella sezione 'Impostazioni' e successivamente su 'Dispositivi e servizi': l'integrazione Shelly dovrebbe rilevare automaticamente il nuovo dispositivo grazie alla scoperta mDNS.
- Clicca su 'Configura' per aggiungere lo Shelly a Home Assistant, assegnandoli un'area di appartenenza e verificando la comparsa delle entità di controllo e dei sensori di potenza.
Configurazione avanzata: Modalità Tapparella e Calibrazione
La gestione delle tapparelle richiede una configurazione particolarmente accurata per consentire a Home Assistant di calcolare la percentuale di apertura e chiusura. Una volta impostato lo Shelly 2PM in modalità Roller, è necessario inserire i dati relativi al tempo stimato di corsa totale in salita e in discesa.
La procedura di calibrazione
La calibrazione automatica o manuale serve a istruire il relè sui tempi esatti di movimento del motore. Accedi al pannello web dello Shelly, vai nelle impostazioni della copertura (Cover) e avvia la procedura di calibrazione. Il dispositivo effettuerà un ciclo completo di apertura e chiusura per misurare il tempo di percorrenza e la resistenza del motore, garantendo così che i comandi di posizionamento percentuale (es. 50%) inviati da Home Assistant siano precisi.
Verifica del risultato e test funzionali
Terminata l'integrazione, è d'obbligo eseguire una serie di verifiche per accertarsi che il sistema rispondi correttamente e in sicurezza:
- Verifica che i comandi di apertura, chiusura e stop impartiti dalla dashboard di Home Assistant muovano correttamente la tapparella o attivino i relè.
- Controlla che i sensori di potenza istantanea (Watt) e di energia cumulata (kWh) restituiscano valori realistici e coerenti con i carichi collegati.
- Testa i pulsanti fisici collegati agli ingressi SW1 e SW2 dello Shelly per confermare che il controllo manuale locale continui a funzionare anche in caso di disconnessione momentanea della rete Wi-Fi.
- Verifica la stabilità della connessione controllando che l'entità RSSI (segnale Wi-Fi) mantenga valori ottimali (superiori a -70 dBm).
Problemi comuni e risoluzione
Se riscontri anomalie durante o dopo la configurazione, consulta la seguente tabella per identificare la causa e applicare la soluzione corretta.
| Problema riscontrato | Causa probabile | Soluzione consigliata |
|---|---|---|
| Home Assistant non rileva lo Shelly | Dispositivi su subnet differenti o mDNS bloccato | Verifica che Home Assistant e Shelly siano sulla stessa VLAN o che il router permetta il traffico multicast mDNS. Assegna un IP statico. |
| La tapparella si muove al contrario | Inversione dei cavi di fase sui morsetti O1 e O2 | Inverti fisicamente i cavi di marcia salita/discesa sui morsetti del relè oppure modifica il parametro di inversione nel pannello web dello Shelly. |
| La calibrazione della copertura fallisce | Tempo di timeout troppo breve o motore senza finecorsa meccanici | Aumenta i margini di sicurezza temporali nelle impostazioni del modulo e ripeti la calibrazione a motore freddo. |
Domande frequenti (FAQ)
Posso usare lo Shelly 2PM senza una connessione a Internet?
Sì, lo Shelly 2PM funziona interamente in locale tramite la rete Wi-Fi domestica e il protocollo mDNS/RPC. Home Assistant dialoga con esso localmente senza la necessità di connettersi al Cloud Shelly, garantendo privacy e funzionamento anche in assenza di connessione Internet esterna.
Qual è il carico massimo supportato dallo Shelly 2PM?
Lo Shelly 2PM supporta fino a un massimo di 10A per canale e 16A totali per il dispositivo, con una tensione di alimentazione compresa tra 110 e 240 VAC. Per carichi induttivi complessi o motori particolarmente potenti, si raccomanda l'uso di un relè di potenza di supporto.
È possibile mantenere i vecchi interruttori a muro tradizionali?
Assolutamente sì. Gli ingressi SW1 e SW2 dello Shelly 2PM sono progettati proprio per accogliere i comandi da interruttori o pulsanti fisici esistenti, permettendo un controllo ibrido (manuale e smart).
Come posso resettare lo Shelly 2PM alle impostazioni di fabbrica?
Puoi effettuare un reset hardware tenendo premuto il pulsante di reset integrato sul dispositivo per circa 10 secondi, oppure agendo dall'interfaccia web nella sezione di manutenzione del firmware.
Occorrente
Materiali usati
I collegamenti portano alle pagine dei prodotti indicati. Il prezzo Amazon, quando disponibile, proviene dall’API ufficiale ed è aggiornato con data e ora; prezzo e disponibilità finali sono quelli della pagina Amazon.