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 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 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. 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. È 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 individuali spiegano solo le funzionalità di connettività disponibili per quel dispositivo specifico.

Piè di pagina

In fondo allo schermo, da sinistra a destra, sono visualizzati 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, tra cui una per 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 dispositivo.Non appare: il firmware del dispositivo è aggiornato. Icona connessione Websocket: Blu: Websocket connesso.

Grigio: Websocket non connesso.Nella pagina Home vedrai i quattro ingressi e cliccandoci sopra vedrai le impostazioni rilevanti spiegate di seguito: Impostazioni ingresso Nome

Seleziona modalità ingresso:

Pulsante

- ogni pressione del pulsante commuta lo stato dell'uscita del dispositivo.

Interruttore

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

Analogico

(non presente come opzione in tutti i dispositivi) - utilizzando l'ingresso analogico, il dispositivo determina la percentuale di luminosità in base alla percentuale dell'ingresso.

Imposta tipo di uscita

• Interruttore a levetta (solo Interruttore) - Il dispositivo agirà come un interruttore a levetta con uno stato per

• ON e uno per

• OFF. Se l'ingresso è in modalità Analogica, il dispositivo seguirà lo stato dell'ingresso analogico.

Interruttore momentaneo (solo Pulsante):

• - Ogni pressione del pulsante commuta lo stato dell'uscita del dispositivo. Se l'interruttore è ON, si spegnerà (OFF), e viceversa.Interruttore a bordo (solo Interruttore)

• - Ogni cambiamento di posizione dell'interruttore commuta lo stato dell'uscita del dispositivo.Interruttore staccato - L'ingresso diventa staccato (separato) dall'uscita e non ha effetto su di essa. In pratica, non potrai controllare la luce tramite l'ingresso.Azione all'accensioneQuesta impostazione è solitamente usata in caso di interruzione di corrente e “accensione” si riferisce al momento in cui l'elettricità viene ripristinata e il dispositivo si riaccende.Accendi

• - Quando alimentato, il dispositivo si accenderà.Spegni

• - Quando alimentato, il dispositivo sarà spento.Ripristina ultimo stato noto dell'uscita/relè

- Quando alimentato, lo stato dell'uscita sarà quello dell'ultima volta che il dispositivo era acceso (prima della perdita di corrente).:

Stato attuale dell'interruttore (solo Interruttore a levetta)

• - Segue lo stato dell'interruttore, quindi se è impostato su ON

• , il dispositivo si accenderà e lo stesso vale quando l'interruttore è impostato su OFF

• .Inverti

• Questa 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 è OFF, il dispositivo si accenderà. Questa impostazione può essere utile in situazioni in cui è necessario invertire il comportamento del dispositivo.Ripristino alle impostazioni di fabbrica

Abilitando questa impostazione potrai resettare il dispositivo alle impostazioni di fabbrica tramite l'ingresso e non solo tramite l'app o l'interfaccia web.AzioniConfigura 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 e un URL da chiamare quando la condizione è soddisfatta.OrariQuesta funzione richiede una connessione Internet funzionante, così il dispositivo può 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 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 sui pulsanti 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 i 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. Facendo così 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 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 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 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.Add-onDisabilita l'add-on cliccando su Nessuno, oppure abilita l'add-on sensore o l'add-on LoRa. Selezionare un'opzione diversa richiederà il riavvio del dispositivo. Se selezioni l'add-on sensore, l'aggiunta di periferiche avviene tramite il

pulsante nella sezione

Periferiche

. Se c'è un problema con uno dei sensori e non riceve valori, verrà visualizzato N/A. I sensori disponibili per l'add-on sono:

Temperatura e Umidità (DHT22)Impostazioni temperaturaNome - Imposta il nome della periferica con cui vuoi che venga visualizzata.+Soglia Delta - Una variazione di temperatura superiore al valore specificato in gradi Celsius attiva il report dei dati del sensore. Il minimo è 0,1℃ e il massimo è 5℃.Offset - Un valore che verrà aggiunto (se positivo) o sottratto (se negativo) alle letture della temperatura per renderle più accurate.Impostazioni umidità

Nome - Imposta il nome della periferica con cui vuoi che venga visualizzata.

Soglia Delta - Una variazione di umidità relativa superiore al valore specificato attiva il report dei dati del sensore. Il minimo è 1% e il massimo è 20%.

• Offset - Un valore che verrà aggiunto (se positivo) o sottratto (se negativo) alle letture dell'umidità per renderle più accurate.

• Azioni

• Crea e modifica azioni. Quando crei un'azione, ti verrà chiesto di specificare alcune cose:

Tempo attivo - Un intervallo di tempo nelle 24 ore del giorno in cui l'azione può essere attivata.

• Esegui quando - Solo dopo un cambiamento di temperatura o ogni 60 secondi.

• Condizione - Specifica quando vuoi che l'azione si verifichi. Puoi scegliere

• inferiore a

o

superiore a

• un certo valore per far scattare l'azione quando la temperatura scende sotto o sale sopra il valore scelto.

• Quindi fai - Usando URL e azioni locali, specifica cosa vuoi che il dispositivo faccia quando la condizione è soddisfatta. Puoi inviare URL interni o esterni, cioè puoi inviare URL a questo dispositivo o a un altro dispositivo.

• Assicurati di premere il pulsante Salva azione se stai modificando o creando un'azione.Temperatura (DS18B20)Panoramica

• - mostra le letture del sensore (la temperatura).

Impostazioni temperaturaNome - Imposta il nome della periferica con cui vuoi che venga visualizzata.Soglia Delta - Una variazione di temperatura superiore al valore specificato in gradi Celsius attiva il report dei dati del sensore. Il minimo è 0,1℃ e il massimo è 5℃.

Offset - Un valore che verrà aggiunto (se positivo) o sottratto (se negativo) alle letture della temperatura per renderle più accurate.

AzioniCrea e modifica azioni. Quando crei un'azione, ti verrà chiesto di specificare alcune cose:

Tempo attivo - Un intervallo di tempo nelle 24 ore del giorno in cui l'azione può essere attivata.

• Esegui quando - Solo dopo un cambiamento di temperatura o ogni 60 secondi.

• Condizione - Specifica quando vuoi che l'azione si verifichi. Puoi scegliere

• inferiore a

o

superiore a

• un certo valore per far scattare l'azione quando la temperatura scende sotto o sale sopra il valore scelto.

• Quindi fai - Usando URL e azioni locali, specifica cosa vuoi che il dispositivo faccia quando la condizione è soddisfatta. Puoi inviare URL interni o esterni, cioè puoi inviare URL a questo dispositivo o a un altro dispositivo.

• Assicurati di premere il pulsante Salva azione se stai modificando o creando un'azione.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 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 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), tentare di disabilitare il Wi-Fi farà apparire un pop-up che chiede se si desidera 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 di nuovo.

  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. 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 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 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.RPC su UDP.

• - Comunica con il tuo 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 dispositivo
  Nome 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 riportate ai valori predefiniti. Qualsiasi modifica effettuata verrà annullata. Puoi confermare il ripristino alle impostazioni di fabbrica 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 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 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 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 Udp.Unità di temperatura - Scegli le unità in cui verranno visualizzati i dati misurati - Celsius o Fahrenheit.

• 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 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 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 opzioni per

Salvare

, Avvia/Arresta, o

Eliminare lo script. Puoi anche accedere a Snippet e Documenti cliccando sulle etichette corrispondenti.ComponentiCreazione di un componenteL'impostazione Componenti consente 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 per visualizzare la funzionalità dello script nella pagina Home. I componenti possono essere raggruppati; solo i gruppi e i componenti al loro interno saranno visualizzati nella pagina Home. 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, Vista, e

• URL Icona Personalizzata da compilare. Il campo URL Icona Personalizzata non è obbligatorio, ma può essere usato per personalizzare l'aspetto dei componenti nella pagina Home. Puoi rinominare o eliminare un componente, così come creare azioni per esso, usando i pulsanti accanto a ogni componente.I diversi tipi di componente possono avere campi aggiuntivi specifici per quel tipo. Sono spiegati di seguito.Il tipo di componente Booleano memorizza un valore vero/falso e ha due titoli diversi che l'utente può inserire a seconda che il valore sia vero o falso, oltre a due icone separate. Il menu a tendina per il valore predefinito includerà i diversi stati del dispositivo. Le opzioni di vista sono Nascosto

,

Interruttore, e Etichetta. La vista Interruttore mostra un pulsante toggle, quindi il valore del componente cambia a ogni clic. La vista Etichetta mostra il titolo per il valore del componente.Il tipo di componente Numero memorizza valori tra -999999999999999 e 999999999999999. Il valore predefinito deve essere un numero in questo intervallo. Puoi anche cambiare l'unità e il passo. Le opzioni di vista sono Nascosto,

Campo, Slider, Barra di progresso, e Etichetta. La vista Campo mostra un campo di input, la vista Etichetta mostra il valore, la vista Barra di progresso rappresenta visivamente il progresso e la vista Slider mostra un'interfaccia a cursore per l'interazione.Il tipo di componente Testo memorizza una stringa fino a 255 caratteri. Le opzioni di vista sono Nascosto,

Campo, Etichetta, e Immagine. La vista Campo mostra un campo di input, la vista Etichetta mostra il titolo e la vista Immagine richiede un valore URL che usa per mostrare un'immagine.Il tipo di componente Enum memorizza un gruppo di costanti denominate. Le opzioni di vista sono Nascosto, Menu a tendina, e

Etichetta. Se selezioni la vista Etichetta, il componente mostrerà il titolo per impostazione predefinita, ma se è specificata un'immagine, questa avrà la precedenza e sarà mostrata al suo posto.Il tipo di componente Pulsante fornisce un ingresso virtuale simulato che consente agli utenti di interagire con l'interfaccia utente registrando e segnalando clic. Invia poi notifiche tramite canali connessi e può essere usato per attivare automazioni e webhook. Ha due opzioni di vista - Pulsante, che mostra il componente pulsante nella tua pagina Home, e

Nascosto. Se un componente è impostato su Nascosto, non sarà visualizzato nella pagina Home. Altrimenti, i gruppi di componenti appariranno sotto gli ingressi e/o uscite del dispositivo e mostreranno i componenti che fanno parte di quei gruppi.Creazione di un gruppo di componentiPer creare un gruppo:.

Clicca sul accanto a Gruppi definiti dall'utente

e verrai portato al menu di creazione del gruppo.

Inserisci il nome del gruppo.

• Seleziona i componenti desiderati da includere nel gruppo.+La modifica del menu gruppi avviene tramite l'icona a matita accanto al e ti permette di cambiare l'ordine dei gruppi cliccando sulle frecce su e giù per spostare un gruppo in alto o in basso.Azioni sui componenti

• Il menu Azioni è ora strutturato in base al tipo di componente. Quindi puoi creare azioni per i tuoi componenti e saranno separate nelle cinque categorie menzionate.

• Scripting

I componenti possono essere inclusi negli script e programmati per cambiare valori in base a una condizione. Per specificare un componente in uno script, devi usare il suo ID. Gli ID dei componenti partono da 200 e sono limitati a 299. Potrai vedere l'ID del componente nel menu +Componenti

.

Componenti BTHome

I componenti BTHome ti permettono di creare componenti virtuali/dinamici associati a dispositivi reali che emettono pacchetti BTHome, come i dispositivi Shelly BLU. Per usare i componenti BTHome, deve essere stabilita una connessione Bluetooth riuscita. Apparirà un messaggio che informa se l'osservatore Bluetooth è disabilitato, insieme a un pulsante per abilitarlo e riavviare il dispositivo.

Una volta stabilita la connessione, per aggiungere un dispositivo BTHome (Bluetooth), clicca sul segno accanto a Componenti BTHome

. Il dispositivo cercherà dispositivi Bluetooth disponibili, ma puoi cliccare sul pulsante

Scansiona

per scansionare di nuovo. I dispositivi trovati appariranno sotto quel pulsante. Perché un dispositivo venga trovato durante la scansione, deve essere in +modalità di associazione, che si attiva tenendo premuto il pulsante del dispositivo. Un'altra opzione per aggiungere un dispositivo è usare un indirizzo MAC. Per farlo, clicca su Aggiungi dispositivo tramite indirizzo MAC e inserisci l'indirizzo MAC del dispositivo che vuoi aggiungere.Per aggiungere sensori, clicca su Configura accanto al dispositivo Bluetooth scelto. In questa schermata puoi nominare il dispositivo BTHome (Bluetooth), aggiungere una chiave di crittografia e inserire un URL Icona Personalizzata per personalizzare l'aspetto del componente BTHome nella pagina Home. La chiave di crittografia è usata per la decrittazione dei pacchetti e può essere recuperata usando l'applicazione

Shelly BLU Debug.Sotto il campo della chiave di crittografia ci sono i sensori supportati, che puoi aggiungere cliccando sul segno accanto a quelli che vuoi aggiungere. Una volta aggiunti, appare un'icona a matita accanto al sensore e cliccandola puoi modificare il nome, aggiungere un URL Icona Personalizzata o usare l'icona del cestino per eliminare completamente il sensore.Per salvare il componente BTHome, clicca su Salva impostazioni. Per eliminare un componente, clicca sull'icona del cestino sopra i campi di testo.

Per modificare un componente BTHome, clicca sull'icona dell'ingranaggio. Verrai portato alle sue impostazioni, che sono la stessa schermata che vedi quando aggiungi il componente.+KNX

KNX è un protocollo di comunicazione standardizzato per l'automazione degli edifici. Viene usato per controllare e gestire vari aspetti dei sistemi di un edificio, inclusi illuminazione, riscaldamento, ventilazione, sicurezza, gestione energetica e altro. KNX permette a dispositivi e sistemi di diversi produttori di comunicare tra loro su una rete comune.Generale

Per usare

KNX

, clicca sulla casella accanto a Abilita

. Poi inserisci un indirizzo individuale unico per il tuo dispositivo nella rete KNX.

Nelle Impostazioni Multicast, inserisci l'indirizzo IP (chiamato Indirizzo) per il gruppo multicast in cui vuoi che il dispositivo comunichi. Gli indirizzi vanno da 224.0.0.0 a 239.255.255.255. L'impostazione

Porta indica il numero di porta all'interno di quel gruppo multicast dove avviene la comunicazione. Insieme definiscono la destinazione per i messaggi multicast all'interno di una rete.IngressiA seconda del dispositivo, avrai un numero diverso di ingressi in questo menu. Per ogni ingresso, seleziona uno Stato ingresso, che può essere Interruttore

,

Pulsante, o specificamente per dispositivi con dimmerazione - Dimmerazione a pulsante singolo, o Dimmerazione a doppio pulsante.Sotto, a seconda dello stato ingresso selezionato, noterai uno o più oggetti, con testo a destra che ne indica dimensione e tipo di dato. Per le diverse modalità ingresso, sono:Interruttore - Ha un oggetto chiamato Oggetto Interruttore, con dimensione di 1 bit e DPT (Tipo Punto Dati) 1.001, che indica un tipo di interruttore con due stati - acceso/spento (1/0). Puoi aggiungere fino a tre oggetti Interruttore usando il pulsante

Aggiungi

• .Pulsante - Prima seleziona una funzione per il pulsante - ON, OFF

• , o Toggle. Lo stato ingresso pulsante ha due oggetti - un oggetto Single-push e un oggetto Feedback. Puoi aggiungere fino a tre oggetti Single-push usando il pulsante Aggiungi e un oggetto Feedback. Entrambi sono di tipo Interruttore, con dimensione 1 bit e DPT 1.001. L'oggetto Feedback può essere lo stesso del Single-push o può avere un indirizzo diverso, che si imposta deselezionando l'opzione Uguale all'oggetto Single-push e inserendo un nuovo indirizzo.Dimmerazione a pulsante singolo - Prima seleziona un passo di dimmerazione, da dimmerazione completa a dimmerazione 1/64

• . Questo cambia la velocità di dimmerazione. La dimmerazione completa è la più veloce perché va da 0 a 100% alla velocità impostata, mentre la dimmerazione 1/64 dimmererà 1/64 della dimmerazione completa per lo stesso tempo. Questo stato ingresso ha tre oggetti - Single-push, Long-push e Feedback. Puoi aggiungere fino a tre oggetti Single-push e Long-push usando il pulsante Aggiungi e un oggetto Feedback, che può essere uguale al Single-push o avere un indirizzo diverso, impostato deselezionando Uguale all'oggetto Single-push e inserendo un nuovo indirizzo. Gli oggetti Single-push e Feedback sono di tipo Interruttore, dimensione 1 bit e DPT 1.001. L'oggetto Long-push è per il controllo dimmer, con dimensione 4 bit e DPT 3.007. L'oggetto Controllo Dimmer consiste in due valori - uno per indicare aumento (1) o diminuzione (0) e uno corrispondente al passo.Dimmerazione a doppio pulsante - Prima seleziona un passo di dimmerazione, da dimmerazione completa a dimmerazione 1/64

• . Questo cambia la velocità di dimmerazione. La dimmerazione completa è la più veloce perché va da 0 a 100% alla velocità impostata, mentre la dimmerazione 1/64 dimmererà 1/64 della dimmerazione completa per lo stesso tempo. Poi seleziona la direzione della dimmerazione - su/accensione o giù/spegnimento. Questo stato ingresso ha due oggetti - Single-push e Long-push. Puoi aggiungere fino a tre oggetti Single-push e Long-push usando il pulsante Aggiungi. L'oggetto Single-push è di tipo Interruttore, dimensione 1 bit e DPT 1.001. L'oggetto Long-push è per il controllo dimmer, dimensione 4 bit e DPT 3.007. L'oggetto Controllo Dimmer consiste in due valori - uno per indicare aumento (1) o diminuzione (0) e uno corrispondente al passo.UsciteIl menu uscite è diviso in tre sezioni - Comandi, Feedback e Misurazioni. Per ogni tipo di oggetto in Comandi, puoi avere fino a cinque oggetti. Questi sono i tipi di oggetti per ogni sezione:Comandi:Oggetto Interruttore - Ha dimensione 1 bit e DPT 1.001, che indica un tipo di interruttore con due stati - acceso/spento (1/0).Feedback:

Oggetto Feedback - Ha dimensione 1 bit e DPT 1.001, che indica un tipo di interruttore con due stati - acceso/spento (1/0). L'oggetto Feedback è usato per segnalare lo stato del dispositivo.

Misurazioni

(Questi tipi di oggetti hanno dimensione 4 byte.):

• Oggetto Tensione - Ha DPT 14.027, che indica un oggetto

Potenziale elettrico

• di tipo Double con tre valori.

Oggetto Corrente - Ha DPT 14.019, che indica un oggetto Corrente elettrica

• di tipo Double con tre valori.Oggetto Potenza attiva - Ha DPT 14.056, che indica un oggetto Potenza

• di tipo Double con tre valori.Oggetto Energia attiva - Ha DPT 13.010, che indica un oggetto Energia attiva

• di tipo long, misurato in watt-ora.A seconda del dispositivo, potresti avere tipi aggiuntivi di oggetti nelle sezioni, come:Comandi:

• Oggetto dimmerazione relativa - Ha dimensione 4 bit e DPT 3.007, che indica un oggetto Controllo dimmer composto da due valori - uno per indicare aumento (1) o diminuzione (0) e uno corrispondente al passo.

Oggetto dimmerazione assoluta - Ha dimensione 1 byte e DPT 5.001, che indica un oggetto

Scala

• composto da un valore da 1 a 100 per rappresentare la percentuale.Misurazioni (Questi tipi di oggetti hanno dimensione 4 byte.):

• Oggetto energia generata - Ha DPT 13.010, che indica un oggetto Energia attiva di tipo long, misurato in watt-ora.

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

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 è Numero, ma inserendo testo il tipo cambierà 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 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 causerà l'invecchiamento della memoria flash. Se decidi di abilitarlo, puoi anche scaricare i log precedenti e 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.Client dispositivo

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