Guida all'interfaccia web Shelly H&T Gen3
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 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 delle 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à, un messaggio verrà mostrato nell'interfaccia web, notificandoti 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. È 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 - l'intestazione, il piè di pagina, il menu principale e il 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 in alto allo schermo e alcuni orari e azioni potrebbero non funzionare come previsto. Alcune versioni precedenti dell'interfaccia web non includono tutti questi componenti.
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 viene portati 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 del menu principale, inclusa la visualizzazione del 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:
 |
|
 |
|
 |
|
 |
|
 |
|
 |
|
|
|
|
|
|
|
|
|
|
.
Offset
Ti permette di regolare le letture del dispositivo per compensare il calore emesso dallo stesso. Impostando un offset di temperatura, puoi assicurarti che le letture siano più accurate e riflettano la temperatura reale dell'ambiente. Il valore minimo è -50 °C, il massimo 50 °C.
Impostazioni umidità
Nome
Modifica il nome dell'Umidità. Questo sarà il nome visualizzato nella pagina Home.Soglia deltaImposta la soglia di umidità in percentuale che attiverà il risveglio del dispositivo. Puoi digitare un valore tra 1% e 20% nella casella di testo. Un cambiamento di umidità relativa superiore al valore specificato attiva la segnalazione dei dati del sensore. Per salvare le modifiche, clicca su
Applica
.
Offset
Per rendere più accurate le letture di umidità, imposta un offset. Questo è un valore che verrà aggiunto o sottratto alle letture. Il valore minimo è -50%, il massimo 50%.
Azioni
Configura le azioni per il tuo dispositivo - crea nuove azioni, modifica quelle esistenti o elimina azioni. Quando crei azioni per il 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.
ImpostazioniImpostazioni 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 di default. 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 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 a banner che ti informa che il dispositivo non risponde in tempo e ha perso la connessione. Quando la connessione viene ristabilita, 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 sua 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 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 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 sull'interruttore accanto a Abilita. Inserisci l'indirizzo del servizio nella casella di testo e dal menu a tendina sotto Connettività SSL scegli tra
, ca.pem o user_ca.pemRPC su UDP - Comunica con il dispositivo e invia richieste tramite una Remote Procedure Call (RPC) su un server User Datagram Protocol (UDP). Questo può essere utile per controllare e monitorare il dispositivo da remoto, senza bisogno 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 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 il ripristino.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 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, 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.
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à di temperatura - Scegli le unità in cui verranno visualizzati i dati misurati - Celsius o Fahrenheit.Impostazioni avanzate
Cliccando 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 vedrai il tipo di valore corrente. Di default, 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 verrai portato alla documentazione API, che fornirà ulteriori informazioni su come funziona 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 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 dispositivo. L'interfaccia web ti informerà se la richiesta è stata eseguita con successo 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 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 comunicherà se la richiesta è andata a buon fine o meno.
