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 elettrodomestici 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 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, è consigliabile 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. È consigliabile 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 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:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
Icona connessione Websocket:
Blu: Websocket connesso.Grigio: Websocket non connesso.Vedrai il pulsante di attivazione che può accendere o spegnere il dispositivo. È etichettato come output, ma puoi cambiarne il nome nelle impostazioni.Sotto ci sono due sezioni - Ultima attivazione da
e
Sovraccarichi
. Nella prima vedrai l'azione da eseguire all'accensione del dispositivo, nella seconda i sovraccarichi attivi e i loro valori. Cliccando su uno di essi puoi modificarli facilmente direttamente da questo menu o dalle impostazioni designate, spiegate di seguito con le altre impostazioni.
Impostazioni output
NomeAssegna o rinomina l'output.Azione all'accensioneImposta un'azione che il dispositivo deve eseguire all'accensione. Puoi disattivare questa impostazione o scegliere Ripristina ultima
per ripristinare l'ultima azione eseguita dal dispositivo. Inoltre, puoi scegliere
Corrispondi input, che fa funzionare il dispositivo in base allo stato dell'interruttore o pulsante collegato.Tipo di elettrodomesticoScegli il tipo di elettrodomestico collegato al dispositivo dalla lista, che include Generale, Relè, Luci, Presa, .
Riscaldamento
e Intrattenimento
ProtezioniSovraccarico in watt
- Configura il relè Shelly per spegnersi quando il consumo di energia raggiunge un certo valore. Il valore massimo consentito è pari alla corrente massima moltiplicata per la tensione massima.Sovratensione in volt
- Se la tensione di alimentazione supera un certo valore, il canale verrà spento.
Sovracorrente in ampere
- Se la corrente di alimentazione supera un certo valore, il canale verrà spento.
Azioni
Configura le azioni per il 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 sui 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 o al tramonto, o a un'ora specificata prima o dopo l'alba o il tramonto. Clicca sui pulsanti su/giù o digita un numero per impostare l'ora e i minuti.
Per creare un orario avanzato:
La funzione orario avanzato utilizza cron per eseguire attività con un singolo orario, invece di usare più orari base.
Creare un orario avanzato differisce dal creare un orario base a causa del 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. Puoi scegliere di visualizzarli con orario base o avanzato. L'orario base mostra l'ora e i giorni in cui l'orario si verifica, mentre l'orario 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 il pulsante di attivazione a destra.Timer
Permette 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
-
Impostazioni di reteAccess Point
- Configura l'AP del dispositivo, inclusa l'attivazione o disattivazione (usando 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 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 entrambi Wi-Fi 1 e Wi-Fi 2 sono abilitati e il dispositivo Shelly si disconnette da una rete, 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 chiede 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 dispositivi. L'impostazione predefinita è che il cloud sia abilitato. Se disabiliti il supporto cloud del dispositivo, perderai la connessione al dispositivo da fuori della 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 server, nome utente e password, ma tieni presente che abilitare SSL ridurrà la durata della batteria probabilmente della metà.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 servizio nel campo di testo e dal menu a tendina sotto Connettività SSL scegli tra , .
ca.pem o user_ca.pemRipetitore di segnale
- Attivando la funzione
Ripetitore di segnale
si crea un hotspot a cui puoi connettere dispositivi Wi-Fi. Se un dispositivo Shelly con il ripetitore abilitato è connesso a un router Wi-Fi e a Internet, tutti i dispositivi connessi ad esso sono anch'essi connessi al router e a Internet.Anche se il dispositivo Shelly non è connesso a un router Wi-Fi, tutti i dispositivi connessi possono comunque comunicare con esso e tra loro. Sotto sono riportate informazioni sui client AP connessi: quanti sono, la loro configurazione IP, indirizzo MAC e indirizzi IP interni ed esterni.Impostazioni dispositivoNome dispositivo (info)
- Visualizza l'ID del dispositivo, la rete Wi-Fi a cui è connesso e il Wi-Fi RSSI.Riavvia - Cliccando sul pulsante Riavvia ti verrà chiesto se sei sicuro di voler riavviare il dispositivo. Clicca OK
per riavviare e Annulla per non riavviare.Ripristino alle impostazioni di fabbrica - Cliccando sul pulsante Reset tutte le impostazioni del dispositivo verranno riportate ai valori predefiniti. Qualsiasi modifica effettuata verrà annullata. Puoi confermare il ripristino cliccando OK
nel pop-up o Annulla per annullare.Posizione e fuso orario
- 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.
Se l'ora del dispositivo non è sincronizzata con l'ora corrente, orari e azioni potrebbero non funzionare come previsto. Apparirà un messaggio che ti avvisa se l'ora non è sincronizzata.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 quando richiesto.Firmware
- In questa impostazione puoi vedere l'ID del dispositivo, la versione del firmware, l'ID build e l'ID build web. Usa il pulsante Copia sopra l'ID firmware o l'ID build web per copiare il contenuto negli appunti. Puoi anche vedere le nuove versioni disponibili, controllare aggiornamenti e aggiornare facilmente il dispositivo. C'è anche l'opzione per caricare un firmware personalizzato, ma il flashing con firmware personalizzato annulla irreversibilmente la garanzia del dispositivo.Certificato utente (Configurazione TLS) - Carica certificato autorità personalizzato, certificato client e chiave client trascinando i file o sfogliando i file cliccando il pulsante dedicato. Clicca Carica
per caricare i file e Pulisci per rimuovere i file che non vuoi caricare.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 sull'interruttore accanto a Abilita modalità eco
e poi clicca su Applica per salvare le modifiche..
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à chiesto anche di inserire un
Indirizzo Udp.Script
Questo 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 eventuali errori che compaiono. Sopra il campo del codice ci sono le opzioni per Salvare, Avvia/Arresta, 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 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 è Numero, ma inserendo testo il tipo cambia in Stringa. Per salvare la chiave clicca semplicemente su 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.
Diagnostica
Da 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.
Client dispositivoVisualizza i dispositivi connessi al tuo dispositivo, ordinati nella categoria corretta. Per la maggior parte dei dispositivi ci sono due opzioni:
Client Bluetooth
