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à mostrato un messaggio nell'interfaccia web che ti avvisa 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 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. È consigliato impostare un indirizzo IP statico 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, ci sono 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 cima a 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 spiegate le impostazioni del 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, tra cui una per AP, Wi-Fi, Bluetooth, Cloud e connessione MQTT. Ecco cosa significano i diversi colori di stato:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Modalità notte
Abilita la modalità notte e imposta gli orari di inizio e fine. Durante questo periodo, la luce brillerà alla luminosità personalizzata impostata con il cursore sotto gli orari di inizio e fine. Puoi anche abilitare un'azione selezionando la casella accanto a
Abilita azione
, che potrai configurare e che il dispositivo eseguirà quando entrerà in modalità notte. Clicca su
Salva impostazioni per salvare le modifiche.Azione all'accensione
Imposta un'azione che il dispositivo deve eseguire all'accensione. Puoi disabilitare questa impostazione o scegliere
Ripristina ultima per ripristinare l'ultima azione eseguita dal dispositivo.Indicatori LEDIndicatore LED Wi-Fi - Il dispositivo ha una spia luminosa dietro il pulsante di accensione che mostra lo stato della connettività Wi-Fi. Se il dispositivo è connesso, la luce blu rimane accesa costantemente. Puoi scegliere di spegnerla.
Indicatore LED di alimentazione
- C'è una luce LED bianca dietro il pulsante di accensione che di default si accende quando il Dimmer è acceso. Questa impostazione si chiama Corrispondenza ingresso. Per configurare la luce in modo che si accenda quando il Dimmer è spento, scegli l'impostazione
Ingresso invertito
. Puoi anche scegliere di spegnerla completamente o tenerla sempre accesa.Azioni
Configura le azioni per il tuo dispositivo: crea nuove azioni, modifica quelle esistenti o elimina azioni. Quando crei azioni, devi specificare la condizione in cui l'azione si verifica. Puoi anche impostare una durata per le azioni e un URL da chiamare quando la condizione è soddisfatta.OrariQuesta funzione richiede una connessione Internet funzionante per sincronizzare l'ora. Permette di creare, visualizzare, modificare ed eliminare orari.Ci sono due tipi di orari: Base e
Avanzato
Per creare un orario
base
:
Seleziona il/i giorno/i della settimana.Scegli un intervallo di tempo: ora, alba o tramonto.Imposta l'ora per il/i giorno/i specificato/i:Ora: clicca i pulsanti su/giù o digita un numero per impostare l'ora e i minuti..
Tramonto/Alba: il dispositivo Shelly può accendersi/spegnersi (o eseguire un'azione specifica) automaticamente all'alba/al tramonto, o a un'ora specificata prima o dopo l'alba/il tramonto. Clicca i pulsanti su/giù o digita un numero per impostare l'ora e i minuti.Per creare un orario avanzato
:
La funzione di orario avanzato usa
-
cron
per eseguire attività con un solo orario, invece di usare più orari base.
Creare un orario avanzato differisce dal creare un orario base per il menu
Quando eseguire. Ti chiede di selezionare uno o più valori, un intervallo di valori o un passo tra valori (scegli uno dei tre cliccando su
Seleziona, Intervallo
, o Passo per ogni valore) per:
Secondi (0-59)Minuti (0-59)Ore (0-23)Giorni (1-31)Mesi (GEN-DIC)Giorni della settimana (DOM-SAB)Per creare un orario che si ripete ogni secondo/minuto/ora/giorno/mese/giorno della settimana, basta selezionare la casella sotto i valori nella sezione desiderata (secondi, minuti, ore, giorni, mesi o giorni della settimana). Inoltre, puoi usare lo sfasamento alba/tramonto selezionando la casella accanto a questa opzione. Così facendo apparirà un nuovo menu con ore e minuti. Lasciando ore e minuti e selezionando alba o tramonto, l'orario avverrà esattamente all'alba o al tramonto. Modificando i valori di ore e minuti si crea uno sfasamento: inserendo valori negativi l'orario avverrà esattamente [ore e/o minuti impostati] prima dell'alba/tramonto, mentre inserendo valori positivi l'orario avverrà [ore e/o minuti impostati] dopo l'alba/tramonto. Non è possibile inserire un valore positivo per uno (ore/minuti) e negativo per l'altro.
Dopodiché, specifica l'azione che vuoi che il dispositivo esegua nella sezione
Fai cosa
. Clicca su
Salva
per salvare il nuovo orario.
Nel menu Orari puoi visualizzare tutti gli orari impostati. Puoi scegliere di visualizzarli con tempo base o avanzato. Il tempo base mostra l'ora e i giorni in cui l'orario si verifica, mentre il tempo avanzato mostra un testo nella scheda Orario che invita a cliccarla per maggiori informazioni.
Entrambe le visualizzazioni mostrano le azioni sopra. Se ci sono più di tre azioni, vengono visualizzate come +n dove n è il numero di azioni rimanenti non visualizzate. Per attivare o disattivare un orario, usa l'interruttore a destra.
TimerPermette di gestire automaticamente l'alimentazione. Puoi usare:Accensione automatica: Dopo lo spegnimento, l'uscita del relè si accenderà automaticamente dopo un periodo di tempo predefinito (in secondi).Spegnimento automatico:
Dopo l'accensione, l'uscita del relè si spegnerà automaticamente dopo un periodo di tempo predefinito (in secondi).
Impostazioni - dispositivo
Queste impostazioni si trovano nel menu a sinistra e si riferiscono al dispositivo.
Impostazioni di rete
Access Point - Configura l'AP del dispositivo, inclusa l'attivazione o disattivazione e l'impostazione di una password. L'access point del dispositivo è una rete aperta di default. L'SSID è unico e non può essere modificato.
WiFi - Registra il dispositivo Shelly per connettersi a fino a 2 reti Wi-Fi diverse.
Inserisci o seleziona la rete Wi-Fi. Puoi scegliere una rete aperta e impostare un indirizzo IP statico.
Abilita Wi-Fi 1, o Wi-Fi 2, o entrambi contemporaneamente. Se entrambi sono abilitati e il dispositivo Shelly si disconnette da una rete, si connetterà all'altra.
Bluetooth
- Disabilita/abilita il Bluetooth tramite l'interruttore. L'impostazione predefinita del Bluetooth è abilitata.Connettività
-
Cloud - Collegare il tuo Shelly al cloud ti permette di controllarlo da remoto e ricevere notifiche e aggiornamenti sui dispositivi. L'impostazione predefinita è che il cloud sia abilitato. Se disabiliti il supporto cloud, perderai la connessione al dispositivo da fuori della rete locale!
MQTT
- Configura il dispositivo Shelly per eseguire azioni tramite MQTT. Di default MQTT è disabilitato, ma puoi abilitarlo tramite l'interruttore. Cambiare queste impostazioni farà riavviare il dispositivo. Ci sono altre impostazioni, come
Notifiche stato RPC via MQTT (che 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 server, nome utente e password, ma tieni presente che abilitare SSL riduce 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. Di default questa impostazione è disabilitata. Per abilitarla, clicca l'interruttore accanto a Abilita. Inserisci l'indirizzo del servizio nel campo di testo e dal menu a tendina sotto Connettività SSL scegli tra ,
ca.pem o user_ca.pemRipetitore di segnale - Questa impostazione estende la portata operativa del dispositivo, configurandolo per funzionare a distanze maggiori. Per abilitare il ripetitore, clicca l'interruttore e poi Applica*Impostazioni dispositivoInfo dispositivo - Visualizza l'ID del dispositivo, la rete Wi-Fi a cui è connesso e il Wi-Fi RSSI.
.Posizione e fuso orario - Il fuso orario e la posizione vengono 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 fa rilevare nuovamente la posizione se il tentativo precedente è fallito.Autenticazione - Se abiliti l'autenticazione, ti verrà chiesta una password da usare per accedere all'interfaccia web del dispositivo. Una volta abilitata, per disabilitarla clicca l'interruttore e inserisci la password 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. C'è anche un'opzione per caricare un firmware personalizzato, ma il flashing con firmware personalizzato annulla irreversibilmente la garanzia del dispositivo.Certificato utente - Carica un certificato SSL personalizzato trascinando il file o sfogliando i file tramite il pulsante dedicato.Modalità Eco
- Riduci il consumo energetico del dispositivo abbassando la frequenza della CPU e l'attività del modem in modalità Eco. Per abilitare questa impostazione clicca l'interruttore accanto a Abilita modalità eco
e poi clicca Applica
per salvare le modifiche.Debug
- Questa impostazione include debug Mqtt, Websocket e Udp. Per abilitare uno di questi, clicca l'interruttore accanto all'impostazione specifica. Per il debug Udp ti verrà anche chiesto di inserire un indirizzo udp.ScriptQuesto dispositivo supporta la funzionalità di scripting. Puoi usarla per personalizzare e migliorare le funzionalità del dispositivo in base alle esigenze specifiche dell'utente. Questi script possono considerare lo stato del dispositivo, comunicare con altri dispositivi o recuperare dati da servizi esterni come previsioni meteo. Uno script è un programma scritto in un sottoinsieme di JavaScript.Nell'interfaccia web, andando nel menu
Script vedrai gli script esistenti o, se non ne hai, potrai crearne uno o aprire la libreria per esplorare quelli disponibili. Accanto a ogni script vedrai il suo stato (in esecuzione o fermo) e un interruttore per eseguire lo script all'avvio. Se lo script ha errori, l'ultimo errore salvato sarà mostrato sotto il nome dello script.Quando sei nella vista di modifica dello script, vedrai la console sotto e gli eventuali errori che compaiono. Sopra il campo del codice ci sono le opzioni per .
Salvare
,
Avviare/Fermare o Eliminare
lo script. Puoi anche accedere a Snippet e Documentazione cliccando sulle etichette corrispondenti.Impostazioni avanzateCliccando sulla freccia accanto a questa impostazione, si rivelano 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 dati. In un dispositivo puoi memorizzare fino a 50 coppie chiave-valore. Cliccando sul pulsante
Aggiungi valore
si accede alla schermata di creazione del valore, che richiede 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. Di default il tipo è
Numero, ma inserendo testo il tipo cambia in Stringa. Per salvare la chiave, clicca semplicemente il pulsante Salva. Per modificare un valore esistente, cliccaci sopra. Per eliminare una coppia chiave-valore, clicca il pulsante Elimina che appare sotto quando modifichi la chiave. Cliccando sul punto interrogativo accanto al nome dell'impostazione si accede 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é rallenta il dispositivo e causa l'invecchiamento della memoria flash. Se decidi di abilitarlo, puoi anche scaricare i log precedenti e quelli attuali. Attenzione che uscire da questa pagina resetta il logger e i dati di log.Ping HTTPInserisci un URL nel campo di testo dedicato per inviare una richiesta HTTP dal dispositivo. L'interfaccia web ti informerà se la richiesta è andata a buon fine o è fallita.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 lasciare 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 comunicherà se la richiesta è andata a buon fine o meno.
