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 tuo browser sia connesso alla stessa rete Wi-Fi del dispositivo Shelly.

Accesso all'interfaccia web

Per accedere all'interfaccia web:

1. 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.

2. 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 delle impostazioni visibili nell'interfaccia web sono disponibili solo se il dispositivo è connesso a Internet. Per farlo, segui questi passaggi:

1. Dall'interfaccia web, vai su Impostazioni>Wi-Fi.

2. Inserisci o seleziona la tua 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.

3. 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. Al successo della connessione 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, 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 spiegate le impostazioni di ciascun elemento 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, inclusi AP, Wi-Fi, Bluetooth, Cloud e connessione MQTT. Ecco cosa significano i diversi colori di stato:

Icona AP:Grigio: modalità AP disabilitata. Blu: modalità AP abilitata. Icona Wi-Fi:

Grigio: connessione Wi-Fi disabilitata.Bianco: connessione Wi-Fi abilitata, ma non stabilita. Blu: il dispositivo è connesso al Wi-Fi. Icona Bluetooth: Grigio: connessione disabilitata.

Blu: connessione abilitata.Icona Cloud: Grigio: connessione a Shelly Cloud disabilitata. Bianco: connessione a Shelly Cloud abilitata, ma non stabilita.

Blu: il dispositivo è connesso a Shelly Cloud.Icona MQTT: Grigio: MQTT disabilitato. Blu: MQTT abilitato. Icona aggiornamento firmware:

Blu: è disponibile una nuova versione stabile del firmware per il tuo dispositivo.Non appare: il firmware del dispositivo è aggiornato. Icona connessione Websocket: Blu: Websocket connesso.

Grigio: Websocket non connesso.Vedrai i quattro ingressi e il loro stato ( ON o

Assegna o rinomina l'ingresso.Modalità ingressoScegli una delle seguenti:Pulsante - ogni pressione del pulsante commuta lo stato dell'uscita del dispositivo.

Interruttore

- la posizione dell'interruttore corrisponde allo stato dell'uscita del dispositivo.

Questa impostazione può anche essere chiamata “

Modalità interruttore

” per alcuni dispositivi.

• InvertiQuesta impostazione consente di invertire la logica del segnale di ingresso, invertendo di fatto il comportamento del dispositivo. Per impostazione predefinita, quando il segnale di ingresso è

• ON, il dispositivo risponde accendendosi. Quando il segnale di ingresso è

OFF, il dispositivo si spegne.Tuttavia, se abiliti l'impostazione "Inverti ingresso", accadrà il contrario. Quando il segnale di ingresso è

ON

, il dispositivo si spegnerà, e quando il segnale di ingresso è OFF, il dispositivo si accenderà. Questa impostazione può essere utile in situazioni in cui è necessario invertire il comportamento del dispositivo.Reset di fabbrica dall'ingressoConsenti al dispositivo di essere resettato alle impostazioni di fabbrica tramite l'ingresso.

AzioniConfigura le azioni per il tuo dispositivo - crea nuove azioni, modifica quelle esistenti o elimina azioni. Quando crei azioni per il tuo dispositivo, devi specificare la condizione in cui l'azione si verifica. Puoi anche impostare una durata per le azioni, nonché un URL da chiamare quando la condizione per l'azione è soddisfatta.Add-onUna volta abilitato e aggiunto l'Add-on e i suoi sensori, puoi vedere tutte le informazioni in questa impostazione. Per vedere esattamente come configurarlo tramite l'interfaccia web e imparare a navigare nelle sue impostazioni, leggi la Guida all'interfaccia web Shelly Plus Add-on

Impostazioni

Impostazioni di rete

Access 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 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 che il nome della rete (SSID) è stato impostato. 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 di circa la 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 tuo servizio nella casella 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
  - Dopo aver cliccato sul pulsante

Riavvia

• , ti verrà chiesto se sei sicuro di voler riavviare il dispositivo. Clicca OK per riavviare il dispositivo e Annulla

• se non vuoi riavviarlo.Reset di fabbrica - Cliccando sul pulsante Reset tutte le impostazioni del dispositivo verranno riportate ai valori predefiniti. Qualsiasi modifica effettuata verrà annullata. Puoi confermare il reset di fabbrica cliccando OK nel pop-up, o Annulla

• per annullare il reset.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 per avvisarti se l'ora non è sincronizzata.Autenticazione - Se abiliti l'autenticazione, ti verrà chiesto di digitare 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, 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 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 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 mentre sei in Modalità Eco. Per abilitare questa impostazione clicca sull'interruttore accanto a Abilita modalità eco e poi clicca il pulsante 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à anche chiesto di inserire un Indirizzo UdpUnità - Scegli le unità in cui verranno visualizzati i dati misurati.ScriptQuesto dispositivo dispone di capacità di scripting. Puoi usarle per personalizzare e migliorare la 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 già disponibili. Accanto a ogni script potrai vedere il suo stato (in esecuzione o fermo) e un interruttore per eseguire lo script all'avvio. Se il tuo script ha errori, l'ultimo errore salvato verrà mostrato sotto il nome dello script..

• Quando sei nella vista di modifica dello script, vedrai la console sotto, così come eventuali errori che si presentano. Sopra il campo del codice ci sono 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, 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

verrai portato 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 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 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 questa impostazione causerà l'invecchiamento della memoria flash. Se decidi di abilitarlo, puoi anche scaricare i log precedenti e quelli attuali. 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.Client dispositivoVisualizza i dispositivi connessi al tuo dispositivo, ordinati nella categoria corretta. Ci sono due opzioni per la maggior parte dei dispositivi:Client Bluetooth

- dispositivi connessi al tuo dispositivo tramite Bluetooth.

Client AP

- dispositivi connessi all'Access Point del tuo dispositivo.

In questo menu potrai vedere informazioni sui client.

Client del dispositivo

Visualizza i dispositivi collegati al tuo dispositivo, ordinati nella categoria corretta. Per la maggior parte dei dispositivi sono disponibili due opzioni:

• Client Bluetooth - dispositivi collegati al tuo dispositivo tramite Bluetooth.

• Client AP - dispositivi collegati al punto di accesso del tuo dispositivo.

In questo menu, potrai visualizzare le informazioni sui clienti.