Panoramica
I dispositivi Shelly offrono un'interfaccia web locale che consente di controllare e configurare i dispositivi tramite un browser web standard, sia da computer che da dispositivo mobile. Con essa, puoi accendere o spegnere gli apparecchi collegati al tuo dispositivo, impostare orari e configurare azioni da eseguire quando si verificano determinate condizioni.
Nota che non è necessaria una connessione a Internet o Shelly Cloud per utilizzare l'interfaccia web locale - l'unico requisito è che il tuo browser sia connesso alla stessa rete Wi-Fi del dispositivo Shelly.
Accesso all'interfaccia web
Per accedere all'interfaccia web:
Collega il tuo dispositivo a una rete Wi-Fi con un nome (SSID) che segue questo formato: "DeviceName-XXXXXXXXXX", dove 'DeviceName' è il nome del dispositivo a cui vuoi connetterti, mentre 'XXXXXXXXXX' rappresenta una combinazione unica di lettere e numeri, che costituisce l'ID del dispositivo.
Dopo aver stabilito la connessione al Access Point / AP del dispositivo (la rete Wi-Fi menzionata al punto 1), l'accesso all'interfaccia web avviene inserendo l'indirizzo IP universale per tutti i dispositivi Shelly 192.168.33.1 nel tuo browser.
Ora sei nell'interfaccia web del tuo dispositivo.
Connessione del dispositivo a una rete Wi-Fi
Alcune impostazioni visibili nell'interfaccia web sono disponibili solo se il dispositivo è connesso a Internet. Per farlo, segui questi passaggi:
Dall'interfaccia web, vai su Impostazioni>Wi-Fi.
Inserisci o seleziona la rete Wi-Fi preferita e poi digita la sua password. In alternativa, è possibile connettersi a una rete aperta selezionando la casella per connettersi a reti Wi-Fi aperte. Inoltre, è consigliato impostare un indirizzo IP statico.
Concedi al dispositivo qualche secondo per tentare la connessione alla rete Wi-Fi fornita. Se la password inserita è errata o la rete Wi-Fi non ha sufficiente segnale o stabilità, verrà visualizzato un messaggio nell'interfaccia web che ti informerà che la connessione non è stata possibile. Una volta connesso con successo al Wi-Fi, apparirà un link contenente il nuovo indirizzo IP come testo sopra le impostazioni Wi-Fi. Copia e incolla semplicemente questo link nel tuo browser.
Ora sei nell'interfaccia web del tuo dispositivo connesso a Internet. La prossima volta che dovrai accedere all'interfaccia web, basterà connettersi alla stessa rete Wi-Fi del dispositivo e digitare il nuovo indirizzo IP ottenuto al punto 3. Impostare un indirizzo IP statico è consigliato perché garantisce un accesso costante a quell'indirizzo specifico.
Comprendere la struttura
L'interfaccia web può essere suddivisa in quattro sezioni principali: intestazione, piè di pagina, menu principale e contenuto principale.
Intestazione
L'intestazione è composta da due elementi: il nome del dispositivo a sinistra e alcune icone che mostrano le principali funzionalità di rete e connettività del dispositivo a destra. Queste icone possono includere funzionalità come Wi-Fi, Bluetooth, MQTT e altro, oltre a un'icona che indica se sono disponibili aggiornamenti firmware per il dispositivo. Passando con il mouse su un'icona, verranno fornite ulteriori informazioni. Troverai una legenda con il significato di ogni icona nella guida all'interfaccia web di ciascun dispositivo. Nota che le guide specifiche spiegano solo le funzionalità di connettività disponibili per quel dispositivo specifico.
Piè di pagina
In fondo allo schermo, da sinistra a destra, sono visualizzati il nome del modello del dispositivo, il suo ID, la versione dell'interfaccia web, la versione del firmware del dispositivo e infine l'ora corrente. Se l'ora non è sincronizzata, riceverai una notifica nella parte superiore dello schermo e alcuni orari e azioni potrebbero non funzionare come previsto. Alcune versioni precedenti dell'interfaccia web non includono tutti questi elementi.
Menu principale
Il menu principale nella versione desktop dell'interfaccia web si trova a sinistra, mentre su mobile appare come un menu hamburger con un'icona di tre linee orizzontali sovrapposte. Il menu contiene elementi diversi a seconda del dispositivo, ma cliccando su un elemento si accede a una pagina diversa. Puoi anche usarlo per tornare alla pagina Home cliccando su Home.
Contenuto principale
Cliccando su un elemento del menu principale, potrai navigare nell'interfaccia web. Tutto ciò che vedi sullo schermo, esclusi intestazione, piè di pagina e menu principale, è considerato contenuto principale.
*Nota che non tutti gli screenshot dell'interfaccia web mostrati in alto in ogni pagina della guida all'interfaccia web (dove è presente uno screenshot) sono dell'ultima versione. Pertanto, potrebbero apparire leggermente diversi dall'ultima versione e potrebbero non rappresentare l'aspetto dell'interfaccia web di ogni dispositivo.

Menu principale
Di seguito sono riportate le spiegazioni di ogni impostazione nel menu principale, inclusa la visualizzazione come contenuto principale cliccando sulle diverse impostazioni. Una breve introduzione alle icone nell'intestazione, specifica per questo dispositivo, è presente anche nella spiegazione della pagina Home. Nota che l'intestazione è presente in tutte le schermate, non solo nella pagina Home.
Pagina Home
Nell'interfaccia web vedrai cinque icone nell'intestazione, inclusi AP, Wi-Fi, Bluetooth, Cloud e connessione MQTT. Ecco cosa significano i diversi colori di stato:
|
|
|
|
|
![]() |
|
|
|
|
|
|
|
|
|
|
Access Point - Configura l'AP del dispositivo, inclusa l'attivazione o disattivazione (tramite l'interruttore) e l'impostazione di una password. L'access point del dispositivo è una rete aperta per impostazione predefinita. L'SSID è unico e non può essere modificato.Wi-Fi - Registra il dispositivo Shelly per connettersi a un massimo di 2 reti Wi-Fi diverse.Inserisci (scrivendo nel campo di testo) o seleziona la rete Wi-Fi cliccando sull'icona a forma di freccia per sfogliare tutte le reti disponibili. Puoi selezionare una rete aperta e impostare anche un indirizzo IP statico.
Abilita Wi-Fi 1, o Wi-Fi 2, o entrambi contemporaneamente (usando l'interruttore accanto a ciascuno). Se Wi-Fi 1 e Wi-Fi 2 sono entrambi abilitati e il dispositivo Shelly si disconnette da una delle reti, si connetterà all'altra. È possibile abilitare il Wi-Fi solo dopo aver impostato il nome della rete (SSID). Se il dispositivo non ha altre connessioni disponibili (AP, Bluetooth, Ethernet (se applicabile) o una seconda rete Wi-Fi), tentando di disabilitare il Wi-Fi apparirà un pop-up che ti chiederà se vuoi continuare.
Bluetooth
- Disabilita/abilita il Bluetooth tramite l'interruttore. L'impostazione predefinita del Bluetooth del dispositivo è abilitata.Connettività
-
Nota per la comunicazione RPC: Quando una chiamata RPC non viene eseguita, appare un messaggio banner che ti informa che il dispositivo non risponde in tempo e ha perso la connessione. Quando la connessione viene ripristinata, la richiesta verrà inviata nuovamente.
Cloud
- Collegare il tuo Shelly al cloud ti permette di controllarlo da remoto e ricevere notifiche e aggiornamenti sui tuoi dispositivi. L'impostazione predefinita è che il cloud sia abilitato. Se disabiliti il supporto cloud del dispositivo, perderai la connessione al dispositivo dall'esterno della sua rete locale!
MQTT - Configura il dispositivo Shelly per eseguire azioni tramite MQTT. Per impostazione predefinita, MQTT è disabilitato, ma puoi abilitarlo tramite l'interruttore. Modificare queste impostazioni causerà il riavvio del dispositivo. Ci sono altre impostazioni, come
Notifiche stato RPC via MQTT
(che ti permette di comunicare con il dispositivo tramite notifiche RPC) e Aggiornamento stato generico via MQTT
(per ricevere un aggiornamento generale dello stato), che puoi abilitare/disabilitare tramite gli interruttori a destra. Puoi anche abilitare SSL e inserire il tuo server, nome utente e password, ma tieni presente che abilitare SSL ridurrà la durata della batteria, probabilmente dimezzandola.Websocket in uscita
- Specifica se il canale HTTP crea un'eccezione I/O quando una connessione in ingresso viene chiusa mentre è ancora in uso dal servlet. Per impostazione predefinita, questa impostazione è disabilitata. Per abilitarla, clicca sull'interruttore accanto a Abilita. Inserisci l'indirizzo del tuo servizio nella casella di testo e dal menu a tendina sotto Connettività SSL scegli ,
ca.pem o user_ca.pemImpostazioni dispositivoNome dispositivo (info) - Visualizza l'ID del dispositivo, il Wi-Fi a cui è connesso e il *Wi-Fi RSSI.Posizione e ora - Il fuso orario e la posizione verranno rilevati automaticamente, ma puoi modificarli manualmente scegliendo un fuso orario dal menu a tendina e inserendo latitudine e longitudine. C'è anche un pulsante .
Rileva posizione automaticamente
, che farà rilevare nuovamente la posizione al dispositivo se il tentativo precedente è fallito.Autenticazione - Se abiliti l'autenticazione, ti verrà chiesto di inserire una password, che userai per accedere all'interfaccia web del dispositivo. Una volta abilitata, per disabilitarla clicca sull'interruttore e inserisci la password di autenticazione quando richiesto.Firmware
- In questa impostazione puoi vedere l'ID del dispositivo, la versione del firmware e l'ID di build, così come l'ID di build web. Puoi anche vedere le nuove versioni disponibili, controllare aggiornamenti e aggiornare facilmente il dispositivo. È presente anche un'opzione per caricare un firmware personalizzato, tuttavia il flashing con firmware personalizzato annulla irreversibilmente la garanzia del dispositivo.Certificato utente (Configurazione TLS) - Carica certificati di autorità personalizzati, certificati client e chiavi client trascinando i file o sfogliando i file tramite il pulsante dedicato. Clicca su Carica
per caricare i file e su Cancella
per rimuovere i file che non vuoi caricare.Debug
- Questa impostazione include debug Mqtt, Websocket e Udp. Per abilitare uno di questi, clicca sull'interruttore accanto all'impostazione specifica. Per il debug Udp ti verrà anche chiesto di inserire un indirizzo udpImpostazioni avanzateCliccando sulla freccia accanto a questa impostazione, verranno rivelate le impostazioni avanzate. Sono spiegate di seguito.KVSKVS
sta per Key-Value Storage ed è un tipo di database non relazionale che funziona usando un semplice metodo chiave-valore per memorizzare i dati. In un dispositivo puoi memorizzare fino a 50 coppie chiave-valore. Cliccando sul pulsante .
Aggiungi valore
accederai alla schermata di creazione del valore, che ti chiede di inserire una chiave (fino a 42 caratteri) e un valore (fino a 253 caratteri). Sotto la casella di testo per il valore è indicato il tipo di valore corrente. Per impostazione predefinita, il tipo di valore è
Numero
, ma inserendo testo il tipo cambierà in Stringa. Per salvare la chiave, clicca semplicemente sul pulsante Salva. Per modificare un valore esistente, cliccaci sopra. Per eliminare una coppia chiave-valore, clicca sul pulsante Elimina che appare sotto quando modifichi la chiave. Cliccando sul punto interrogativo accanto al nome dell'impostazione accederai alla documentazione API, che fornisce ulteriori informazioni su come funziona il KVS per i dispositivi Shelly.DiagnosticaDa questa impostazione puoi scaricare i log di debug. Abilitare il log di debug senza motivo non è consigliato, poiché rallenterà il dispositivo e causerà l'invecchiamento della memoria flash. Se decidi di abilitarlo, puoi anche scaricare i log precedenti e quelli correnti. Tieni presente che uscire da questa pagina resetterà il logger e i dati di log.Ping HTTPInserisci un URL nel campo di testo designato per inviare una richiesta HTTP dal tuo dispositivo. L'interfaccia web ti informerà se la richiesta è stata eseguita con successo o è fallita. pulsante che appare sotto di esso quando si va a modificare la chiave. Facendo clic sul punto interrogativo accanto al nome dell'impostazione si verrà indirizzati alla documentazione API, che fornirà ulteriori informazioni su come KVS funziona con i dispositivi Shelly.
Diagnostica
Da questa impostazione, puoi scaricare i log di debug. Abilitare il log di debug senza una motivazione non è consigliato, poiché il dispositivo potrebbe rallentare e questa impostazione può causare l'usura della memoria flash. Se decidi comunque di abilitarlo, puoi anche scaricare i log precedenti e quelli attuali. Tieni presente che uscire da questa pagina reimposterà il logger e i dati di log.
Ping HTTP
Inserisci un URL nel campo di testo designato per inviare una richiesta HTTP dal tuo dispositivo. L'interfaccia web ti informerà quindi se la richiesta è andata a buon fine o meno.





