Panoramica

I dispositivi Shelly offrono un'interfaccia web locale che consente di controllare e configurare i dispositivi tramite un browser web standard, sia dal computer che dal dispositivo mobile. Con essa, puoi accendere o spegnere gli elettrodomestici collegati al tuo dispositivo, impostare orari e configurare azioni da eseguire quando vengono soddisfatte 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:

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 rete Wi-Fi preferita e poi inserisci la password. In alternativa, è possibile connettersi a una rete aperta selezionando la casella per connettersi a reti Wi-Fi aperte. Inoltre, si consiglia di 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. 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. Si consiglia di 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 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 diverse icone nell'intestazione. I loro significati e i colori di stato sono spiegati di seguito:

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.Nel menu principale puoi abilitare la modalità di associazione per il Gateway cliccando sull'icona accanto a Abilita modalità di associazione . Il processo di associazione inizierà e il testo cambierà in

Il TRV mostra la percentuale della batteria, la potenza del segnale, le letture della temperatura attuale e l'apertura della valvola (da 0% a 100%). Puoi anche vedere e regolare la temperatura target. Per aggiungere sensori aggiuntivi al BLU TRV, clicca sul pulsante Aggiungi sensore accanto al dispositivo nel menu principale.Cliccando sul dispositivo si apre un nuovo menu di impostazioni, dove puoi regolare la temperatura target tra 4°

C e 30

°

C spostando il punto sul cerchio incompleto con i gradi, oppure usare le icone più e meno per cambiare la temperatura target. Inoltre, l'icona del fuoco al centro è un pulsante boost, che apre completamente la valvola (al 100%) per raggiungere più velocemente la temperatura target.Sotto ci sono le impostazioni per il BLU TRV:Nome

Assegna o rinomina il TRV. Clicca su Salva impostazioni per completare il processo di denominazione.Calibra TRVClicca sul pulsante blu

Calibra

accanto a questa impostazione per iniziare il processo di calibrazione.

Comportamento TRVSeleziona/deseleziona le seguenti impostazioni a tuo piacimento:Riscaldamento a pavimento - Verranno considerati validi solo i dati dell'impostazione esterna e non le letture di quella integrata.

Riscaldamento accelerato - Velocizza il processo di riscaldamento riducendo il tempo necessario per raggiungere la temperatura target con questa impostazione.

Calibrazione automatica - Consenti al dispositivo di correggere automaticamente la calibrazione se necessario.Prevenzione intasamenti - Previeni intasamenti consentendo al dispositivo di assicurare almeno un movimento della valvola a settimana.Interfaccia TRV

Seleziona l'unità di temperatura desiderata e scegli se far ruotare e/o bloccare il TRV. La rotazione permette allo schermo del dispositivo di ruotare di 180

°

• in base al modo in cui è montato, mentre il blocco aggiunge un livello di sicurezza bloccando il display. Inoltre, c'è un cursore di luminosità, dove puoi regolare la luminosità dello schermo su 8 livelli - da 0 a 7.

• Abilita TRV

• Abilita il TRV attivando questa impostazione (attivo per impostazione predefinita) e disabilitalo solo se intendi utilizzare chiamate API avanzate per controllare manualmente la posizione della valvola. Altrimenti, non è consigliabile disabilitare l'apertura e chiusura automatica della valvola.

• Compensazione temperatura

Ti permette di regolare le letture del sensore di temperatura del dispositivo per compensare il calore emesso dallo stesso dispositivo. Impostando una compensazione della temperatura, puoi assicurarti che le letture siano più accurate e riflettano la temperatura reale dell'ambiente.

Temperatura target finestra aperta predefinitaAbilita la sovrascrittura della temperatura quando la finestra è aperta e scegli un valore per la temperatura, oltre alla durata della sovrascrittura in minuti.Durata boost TRV

Imposta la durata (in minuti) del boost (il tempo in cui la valvola sarà aperta al 100% dopo aver premuto il pulsante boost per raggiungere più velocemente la temperatura target).

Aggiornamento TRV

Controlla e installa aggiornamenti firmware per mantenere il TRV aggiornato. Puoi vedere le versioni attuali del firmware e del bootloader in questa impostazione.

Sensori collegati

Monitora eventuali sensori collegati al tuo TRV - sia sensori di temperatura che sensori porta/finestra - in questa impostazione. Se non ne hai, verrà mostrato un messaggio nell'impostazione.

Elimina TRV

Rimuovi il TRV dai dispositivi associati cliccando sul pulsante blu

Elimina

. Se desideri aggiungerlo di nuovo, dovrai ripetere il processo di associazione.

Azioni

Configura le azioni per il tuo dispositivo - crea nuove azioni, modifica azioni 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, così come un URL da chiamare quando la condizione per l'azione è soddisfatta.

Orari

Questa funzione richiede una connessione Internet funzionante, così il dispositivo può sincronizzare l'ora. Ti 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 il pulsante su/giù o digita un numero per impostare un'ora in ore e minuti..

Tramonto/Alba: il dispositivo Shelly può accendersi/spegnersi (o eseguire un'azione specificata) automaticamente all'alba/al tramonto, o a un'ora specificata prima o dopo l'alba/il tramonto. Clicca il pulsante su/giù o digita un numero per impostare un'ora in ore e minuti.Per creare un orario avanzato

• :

• La funzione di 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 verifica 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. Facendo così apparirà un nuovo menu con ore e minuti. Lasciando ore e minuti e selezionando alba o tramonto, l'orario si verificherà esattamente all'alba o al tramonto. Modificando i valori di ore e minuti si creerà uno sfasamento, quindi inserendo valori negativi l'orario si verificherà esattamente [ore e/o minuti impostati] prima dell'alba/tramonto, mentre inserendo valori positivi l'orario si verificherà [ore e/o minuti impostati] dopo l'alba/tramonto. Non è possibile inserire un valore positivo per uno (ore/minuti) e un valore negativo per l'altro.

• Dopodiché, specifica semplicemente l'azione che vuoi che il dispositivo esegua nella sezione

• Fai cosa

• . Clicca su

• Salva

• una volta terminato per salvare il nuovo orario.

• Nel menu Orari puoi visualizzare tutti i tuoi orari. Puoi scegliere di visualizzare ciascuno 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 ti 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 rimanente di azioni non visualizzate. Per attivare/disattivare un orario, usa il pulsante di attivazione a destra.

ImpostazioniImpostazioni 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 Wi-Fi 1 e Wi-Fi 2 sono 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 attivando 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 attivando 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 attivando gli interruttori a destra. Puoi anche abilitare SSL e inserire il server, nome utente e password, ma tieni presente che abilitare SSL ridurrà la durata della batteria probabilmente di 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 nella casella di testo e dal menu a discesa 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 di segnale 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, oltre alla loro configurazione IP, indirizzo MAC e indirizzi IP interni ed esterni.RPC su UDP - Comunica con il tuo dispositivo e invia richieste tramite una chiamata di procedura remota (RPC) su un server User Datagram Protocol (UDP). Questo può essere utile per controllare e monitorare il dispositivo da remoto, senza la necessità di un server o connessione dedicata..

• Per usare questa impostazione, devi inserire la porta di ascolto e l'indirizzo di destinazione per il server UDP. La porta di ascolto è il numero di porta su cui il dispositivo ascolterà le richieste in arrivo, mentre l'indirizzo di destinazione è l'indirizzo IP del server a cui verranno inviate le richieste.Una volta inserite le informazioni richieste, puoi usare il protocollo RPC su UDP per inviare richieste al dispositivo e ricevere risposte.Impostazioni dispositivoNome dispositivo (info)
  - Visualizza l'ID del dispositivo, il 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.Ripristino alle impostazioni di fabbrica - Cliccando sul pulsante Reset tutte le impostazioni del dispositivo verranno ripristinate ai valori predefiniti. Qualsiasi modifica effettuata verrà annullata. Puoi confermare il ripristino alle impostazioni di fabbrica cliccando su OK nel pop-up, o Annulla

• per annullare il ripristino.Posizione e fuso orario - Il fuso orario e la posizione verranno rilevati automaticamente, ma puoi modificarli manualmente da questa impostazione scegliendo un fuso orario dal menu a discesa 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 informarti se l'ora non è sincronizzata.Autenticazione - Se abiliti l'autenticazione, ti verrà chiesto di digitare una password, che userai poi 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 di dispositivi 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 su 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 sul 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 UdpLED di sistema - Abilita/Disabilita il LED di sistema del dispositivo selezionando/deselezionando la casella accanto a AbilitaScript

• Questo 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 prelevare dati da servizi esterni come previsioni meteo. Uno script è un programma scritto in un sottoinsieme di JavaScript.Nell'interfaccia web, quando vai al menu Script.

• , vedrai gli script esistenti o, se non ne hai, puoi crearne uno o aprire la libreria per esplorare quelli già disponibili. Accanto a ogni script potrai vedere il suo stato (se è in esecuzione o fermo) e un interruttore che permette di 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 compaiono. Sopra il campo del codice ci sono opzioni per Salvare.

,

Avvia/Arresta

, o Eliminare lo script. Puoi anche accedere a

Snippet e Documentazione cliccando sulle etichette corrispondenti.ComponentiCreazione di un componenteL'impostazione Componenti permette all'utente di creare Componenti Dinamici, che inizialmente non esistono nel dispositivo. I componenti virtuali, un tipo di componente dinamico, sono usati per memorizzare o trasferire dati tra script o esecuzioni e visualizzare la funzionalità dello script nella pagina principale. I componenti possono essere raggruppati; solo i gruppi e i componenti al loro interno saranno visualizzati nella pagina principale. I componenti che non appartengono a un gruppo non saranno visualizzati lì. Il numero di componenti e gruppi di componenti per dispositivo è limitato.Per creare un componente:Clicca sul pulsante

Crea nuovo

accanto a

Componenti definiti dall'utente.Seleziona il tipo di componente che vuoi creare - Booleano, Numero, Testo, Enum o Pulsante. Quando creato, ogni tipo di componente ha i campi

Nome

• , Visualizza, e URL Icona Personalizzata che devi compilare. Il campo

• URL Icona Personalizzata non è obbligatorio, ma può essere usato per personalizzare l'aspetto dei componenti nella pagina principale. Puoi rinominare o eliminare un componente, così come creare azioni per esso, usando i pulsanti accanto a ogni componente.I diversi tipi di componenti possono avere campi aggiuntivi specifici per quel tipo. Sono spiegati di seguitoIl tipo di componente Booleano memorizza un valore vero/falso e campi, che devi compilare. URL icona personalizzata Il campo non è obbligatorio, ma può essere utilizzato per personalizzare l'aspetto dei tuoi componenti nella pagina principale. Puoi rinominare o eliminare un componente, oltre a creare azioni per esso, utilizzando i pulsanti situati accanto a ciascun componente.

I diversi tipi di componenti possono avere campi aggiuntivi, specifici per quel tipo. Sono spiegati di seguito

Il Boolean il tipo di componente memorizza un valore vero/falso e