Come creare una dashboard

Come creare una dashboard SharKNX nell’app: spazi, pagine e widget, l’editor, come appare e funziona una dashboard, e come condividerla.

Una dashboard è uno schermo touch per un impianto KNX: ambienti con pulsanti, cursori e letture che inviano su indirizzi di gruppo e li ascoltano. La crei nell’editor dell’app, e tu o il tuo cliente la usate nella vista dashboard. Questa guida presuppone che tu conosca le basi di KNX (indirizzi di gruppo, tipi di datapoint), non che tu conosca SharKNX.

Preferisci un editor di testo? Una dashboard è un file JSON che puoi anche scrivere a mano. Vedi il riferimento Formato file delle dashboard e i suoi esempi.

Piano gratuito: le dashboard sono incluse in ogni piano. Ogni comando che una dashboard invia conta negli invii giornalieri del piano gratuito; le letture di stato all’apertura no. Vedi Piani di Abbonamento.

In questa pagina

1. Di cosa è fatta una dashboard
2. Iniziare una dashboard
3. L’editor
4. Spazi e pagine
5. Aggiungere widget
6. Il modulo di un widget
7. Quale widget per cosa
8. Curare l’aspetto
9. Connessione, progetto e sicurezza
10. Eseguire una dashboard
11. Una dashboard per il tuo cliente
12. Condivisione e backup
13. Quando qualcosa non va

Di cosa è fatta una dashboard

L’interfaccia principale dell’app, con il progetto, il monitor e gli altri strumenti, si chiama vista professionale. Le dashboard si trovano nella pagina Dashboard, la terza scheda della barra di navigazione inferiore.

Limiti: 10 pagine per spazio, 100 widget per pagina, 8 livelli di spazi sotto Home, 500 spazi e 5.000 widget per dashboard, nomi fino a 50 caratteri. Vedi Limiti.

Iniziare una dashboard

Nella pagina Dashboard, tocca +:

• Crea dashboard apre l’editor su una dashboard nuova e vuota: Home con una pagina. Non viene salvato nulla finché non la salvi.
• Importa dashboard legge un file .json, ad esempio uno esportato da un altro dispositivo o uno degli esempi.

La scheda di una dashboard salvata ha ▶ (Esegui, aprila nella vista dashboard) e ✎ (aprila nell’editor). Tocca un altro punto della scheda per tutte le sue azioni - vedi Pagina Dashboard.

Da un progetto ETS: con un progetto caricato nell’app e una dashboard che ha solo Home, ⋮ → Crea spazi da ETS nell’editor costruisce l’albero degli spazi dagli edifici, piani e locali del progetto (nomi, annidamento e icone). Crea solo spazi, ognuno con una pagina vuota; i widget li aggiungi tu.

L’editor

L’editor è un modello della dashboard, non una dashboard in funzione: non invia nulla e non legge nulla. I widget mostrano un aspetto di esempio, e toccarne uno lo seleziona invece di azionarlo.

Su un telefono:

• Riga in alto: ✕ (Chiudi editor), lo spazio in cui ti trovi (toccalo per passare a un altro spazio), ⋮ (Impostazioni dashboard) e Salva.
• In basso: Griglia / Albero, Aspetto, Seleziona e + (Aggiungi).

Su tablet o desktop: gli stessi comandi, con Aggiungi, Griglia, Albero, Aspetto e Seleziona in una barra laterale. Da 840 dp di larghezza, la riga in alto mostra il percorso dello spazio corrente (Home › Piano terra › Cucina), e ogni passaggio apre quello spazio.

Griglia e Albero sono due viste della stessa dashboard. Griglia mostra le pagine come appariranno. Albero mostra la struttura: gli spazi, le loro pagine e i loro widget. In Albero puoi trascinare spazi e pagine per spostarli.

Il salvataggio è esplicito. Non viene salvato nulla finché non tocchi Salva. Se chiudi con modifiche non salvate, l’editor chiede se salvare, scartare o annullare (Salva, Scarta, Annulla). Le rimozioni e gli spostamenti offrono Annulla nel loro messaggio.

Indietro torna allo spazio in cui eri prima, come in un browser. Usa ✕ per uscire dall’editor.

Spazi e pagine

Aggiungi → Spazio apre il modulo Nuovo spazio:

• Nome, spazio superiore, posizione e icona.
• Aggiungi widget di navigazione (attivo per impostazione predefinita): mette un collegamento al nuovo spazio sulla pagina in cui eri, così lo si raggiunge da lì. Disattivalo per gli spazi che raggiungi in un altro modo.

Aggiungi un altro crea lo spazio e lascia aperto il modulo per il successivo, con lo stesso spazio superiore e la stessa icona. Per creare una serie numerata in un colpo solo (Stanza 1 fino a Stanza 12), usa Più spazi….

Il menu degli spazi (tocca il nome dello spazio corrente) sfoglia gli spazi un livello alla volta e offre Aggiungi spazio, Modifica spazio ed Elimina spazio. Eliminare uno spazio elimina anche i suoi sottospazi, i loro widget e ogni collegamento che vi porta, e offre Annulla. Home non si può eliminare.

Pagine: usa i comandi sotto le pagine per aggiungere o rimuovere una pagina (uno spazio ne mantiene almeno una). In Albero, trascina una pagina per riordinarla o su un altro spazio per spostarla lì.

I collegamenti non sono la gerarchia. Un collegamento allo spazio (widget di navigazione) può aprire qualsiasi spazio, in qualsiasi punto dell’albero, e più collegamenti possono aprire lo stesso spazio. Eliminare un collegamento non elimina mai il suo spazio.

Aggiungere widget

Aggiungi → Widget (o lo spazio tratteggiato Aggiungi widget dopo l’ultimo widget) apre il catalogo dei widget, raggruppato per categoria:

La ricerca trova un widget per nome o descrizione. Molte voci sono predefiniti, un widget generico già impostato per uno scopo: Interruttore luce è un Controllo binario con nomi e icone da luce, e Temperatura è uno Stato valore in °C. Aprono un modulo intitolato al predefinito, con le sue scelte già fatte.

Il widget viene aggiunto alla pagina in cui ti trovi, dopo il suo ultimo widget.

Disporre: tocca un widget per selezionarlo e aprirne le azioni: Modifica widget, Duplica, Sposta… (in un’altra posizione, pagina o spazio) ed Elimina (con Annulla). Un collegamento allo spazio offre anche Apri. Per riordinare a mano, tieni premuto un widget e trascinalo; tienilo sul bordo dello schermo per portarlo alla pagina successiva.

Seleziona sceglie più widget (o più spazi) insieme, su più pagine e spazi, per duplicarli, spostarli o eliminarli insieme. Puoi avviarlo anche tenendo premuto un widget e rilasciandolo sul posto.

Come si dispone una pagina: i widget riempiono la pagina riga per riga, nel loro ordine, ognuno nel primo punto in cui entra. Un widget che non entra nel resto di una riga inizia la successiva, e il vuoto resta: l’editor lo mostra, e lo chiudi riordinando o ridimensionando. I widget non vengono mai ingranditi per riempire lo spazio. La stessa disposizione vale per ogni schermo; uno schermo più largo ha semplicemente più colonne.

Il modulo di un widget

Ogni widget ha lo stesso tipo di modulo, in schede dall’alto verso il basso. Su un telefono si apre come pagina intera; su un tablet, in un pannello laterale.

Una piccola ⓘ accanto a un campo lo spiega.

Indirizzi

• Digitare: a tre livelli (1/2/3), a due livelli (1/515) o un numero semplice. La tastiera offre solo cifre e /.
• Scegliere da un progetto: con un progetto caricato, la lente apre i suoi indirizzi di gruppo per cercare e scegliere. Un indirizzo scelto compila anche il nome del widget e il suo tipo (ad esempio i nomi Aperto/Chiuso e l’icona di un contatto finestra).
• Suggerimento di stato: dopo che hai scelto un indirizzo di comando, il modulo può suggerire l’indirizzo di stato corrispondente trovato sullo stesso canale del dispositivo. Tocca Usa per prenderlo; non viene mai compilato da solo.
• Più indirizzi di invio: un Controllo binario o un Controllo valore può inviare lo stesso valore a fino a 10 indirizzi (Aggiungi indirizzo).
• I tipi vengono controllati: un indirizzo il cui tipo di datapoint non va bene per il widget viene segnalato e blocca il salvataggio. Un indirizzo senza tipo impostato in ETS viene sempre accettato.
• Leggi stato all'apertura (alla fine della scheda Indirizzi KNX, con un indirizzo di stato): chiede il valore dell’indirizzo di stato quando la dashboard si apre o si riconnette. Disattivalo per gli oggetti non leggibili.

Con o senza stato? Con un indirizzo di stato, il widget mostra ciò che riporta il dispositivo, comprese le modifiche fatte da pulsanti, timer e funzioni centrali. Senza, mostra l’ultimo valore scritto sul suo indirizzo di invio, dalla dashboard o da chiunque altro sul bus. Per carichi semplici basta, ma non vede una modifica fatta su un altro indirizzo.

Aggiungere e salvare

• Aggiungi posiziona il widget e chiude il modulo.
• Aggiungi un altro lo posiziona e lascia aperto il modulo per il successivo, mantenendo le impostazioni ma svuotando nome e indirizzi, che identificano un singolo widget.
• Salva (in modifica) mantiene il posto del widget sulla pagina.

Un widget a cui manca ancora qualcosa di necessario, come un indirizzo obbligatorio, appare come Incompleto: Aggiungi e Salva restano disattivati finché non è completo.

Quale widget per cosa

Curare l’aspetto

Tema e pulsanti

Il pulsante Aspetto dell’editor sceglie il tema della dashboard: Automatico (segue la modalità chiara o scura del dispositivo), Chiaro, Scuro, Notte, Grande Onda, Crepuscolo nel Sahara, Aurora o Città al neon. Sceglie anche l’aspetto dei Pulsanti sulle schede: Pieno (uno sfondo tenue) o Semplice (solo i simboli). Il tema si può cambiare anche più tardi dalla vista dashboard.

Dimensioni

Ogni widget offre le dimensioni in cui ha qualcosa in più da mostrare, da 1×1 fino a 4×2 (e 3×3 per alcuni). Una scheda più grande mostra di più: in 1×1 un dimmer mostra il suo livello, in 3×1 aggiunge una striscia da trascinare, e in 2×2 il cursore o − +. Scegli la dimensione in Generale; l’anteprima mostra il risultato. Una fila di quattro celle riempie la larghezza di un telefono.

Sezioni

Una Sezione (in Layout) è un titolo sopra i widget che la seguono, fino alla sezione successiva. Occupa sempre una riga tutta sua. Dalle un’icona e un colore. Attiva Comprimibile per comprimere ed espandere i suoi widget con un tocco nella vista dashboard; si apre sempre espansa.

Colori

Per impostazione predefinita, ogni widget prende i colori dal tema. Apri la scheda Aspetto di un widget per dargli i suoi:

• Colore della scheda: lo sfondo della scheda, in ogni stato.
• Colore acceso e Colore spento (widget con uno stato acceso) o Colore dell'icona (gli altri): l’icona, il testo di stato e il contorno quando è acceso. Anche i pulsanti e il cursore del widget prendono questo colore.

Ognuno offre Tema, sette colori con nome o Personalizzato (qualsiasi colore, scelto su un campo colore o digitato come #RRGGBB):

• I colori con nome seguono il tema. Una scheda blu è la scheda del tema tinta di blu: azzurra in un tema chiaro, blu profondo in uno scuro. Un colore dell’icona con nome prende una tonalità chiara o scura, quella leggibile sulla sua scheda.
• I colori personalizzati sono esatti, uguali in ogni tema.
• Testo e pulsanti si adattano da soli: su un colore della scheda, il testo diventa bianco o nero quando quello del tema non sarebbe leggibile, e i pulsanti il cui colore non sarebbe leggibile prendono invece una tonalità del colore della scheda.

Consigli sui colori:

• Dai a ogni ambiente, o a ogni gruppo sotto una sezione, il proprio colore della scheda, così uno spazio si riconosce a colpo d’occhio.
• Usa gli accenti per dare un significato: un colore acceso per tutte le luci, un altro per il riscaldamento.
• Controlla i colori personalizzati nell’anteprima, soprattutto una scheda scura in un tema chiaro.

Connessione, progetto e sicurezza

Il ⋮ dell’editor apre le Impostazioni dashboard: Nome, Connessione, Progetto, Sicurezza e Crea spazi da ETS. Le modifiche si applicano alla chiusura del foglio.

Connessione

Come la vista dashboard raggiunge il bus ogni volta che si apre:

Se all’apertura della dashboard l’app è già connessa altrove, la dashboard chiede (Già connesso) se mantenere la connessione (Mantieni l'attuale) o cambiarla (Cambia). Uscire dalla dashboard lascia la connessione com’è.

Le credenziali (password del tunneling sicuro, la chiave backbone) si impostano nella vista professionale, mai nella dashboard - vedi Come Configurare KNX IP Secure.

Progetto e sicurezza

La dashboard in sé non ha impostazioni di sicurezza. L’app cifra e decifra gli indirizzi Data Secure con le chiavi che ha caricato.

• Nessun progetto (predefinito): l’editor sceglie gli indirizzi dal progetto aperto nell’app, e la dashboard usa la sicurezza che l’app ha caricato.
• Progetto di questa dashboard: scegli un progetto ETS dall’Archivio. La dashboard conserva una propria copia delle chiavi di gruppo Data Secure e delle credenziali IP Secure del progetto, cifrata sul dispositivo. Se viene eseguita in un’app senza nulla di caricato, le chiavi vengono installate senza chiedere. Se è caricato altro, chiede se scaricarlo (Scarica) o mantenerlo (Mantieni l'attuale). Ciò che ha installato viene rimosso alla fine dell’esecuzione.

La riga Sicurezza mostra ciò che la dashboard contiene (indirizzi sicuri, tunnel, chiave backbone) e se corrisponde alla connessione.

Un indirizzo sicuro di cui mancano le chiavi non si aggiorna mai. Non causa errori, quindi controlla Sicurezza quando un widget sicuro resta sconosciuto. Vedi KNX Data Secure.

Eseguire una dashboard

Tocca ▶ Esegui. La vista dashboard si apre subito, a schermo intero, e si connette in background. I valori compaiono man mano che vengono letti e ricevuti: prima la pagina sullo schermo, poi il resto della dashboard.

Usare i widget

• Luci e interruttori: un tocco commuta. Su una luce con dimmer, colore o bianco regolabile, tocca l’icona per accenderla o spegnerla e il resto della scheda per i suoi comandi.
• Scenari e collegamenti agli spazi: un tocco richiama lo scenario o apre lo spazio.
• Tutto il resto: cursori, − + e pulsanti funzionano sulla scheda dove li mostra; un tocco in un altro punto della scheda apre il suo pannello di controllo, con tutti i comandi del widget: predefiniti, un valore digitato, ogni modalità.
• Le letture non fanno nulla al tocco.

Una scheda con indirizzo di stato mostra ? finché lo stato non risponde; una senza parte da un valore predefinito (spento, 0 %) finché qualcosa non viene inviato al suo indirizzo. Nel suo angolo possono comparire due segni: ! quando il gateway ha rifiutato l’ultimo comando, e un collegamento interrotto quando il suo indirizzo di stato non risponde.

Il dock

La barra in basso contiene ⌂ (Home), ☰ (spazi; una barra laterale sui tablet) e ⚙ (impostazioni), più lo stato della connessione sui tablet (in alto a destra sui telefoni): un collegamento verde da connesso, ambra durante la connessione, un collegamento interrotto senza connessione. Tocca lo stato per la pagina del gateway, con Riconnetti.

⚙ Impostazioni: Gateway, Aspetto (tema e pulsanti, salvati subito), Mantieni lo schermo acceso, Disponi i widget e Torna alla vista professionale.

La campanella in alto elenca le notifiche dell’esecuzione (Attività): comandi rifiutati dal gateway, connessione persa e ripristinata, indirizzi che non rispondono mai. Disattiva i banner di notifica le tiene solo in Attività.

Preferiti, scorciatoie del dock e disposizione

Disponi i widget (in ⚙, o tenendo premuta una parte vuota di una pagina) permette a chi usa la dashboard di riordinarla senza l’editor:

• Trascina una scheda (tenendola premuta) per riordinarla o portarla su un’altra pagina dello stesso spazio. Lasciandola dopo l’ultima pagina se ne crea una nuova.
• Tocca una scheda per Aggiungi ai Preferiti e Aggiungi al dock.
• Annulla e Fatto sono in alto.

I preferiti compaiono in una pagina propria, prima della prima pagina di ogni spazio (★ nei punti delle pagine). In quella pagina, trascinali per riordinarli.

Le scorciatoie del dock mettono fino a 6 widget nel dock come icone. Una scorciatoia fa ciò che fa un tocco sulla sua scheda: una luce commuta (e si illumina quando è accesa), uno scenario viene richiamato, un dimmer o un termostato apre il suo pannello di controllo. Su un telefono stretto, l’ultimo posto diventa ⋯ per le scorciatoie che non entrano.

Le modifiche fatte nella vista dashboard (tema, schermo acceso, disposizione, preferiti, dock) vengono salvate nella dashboard. Aggiungere, modificare ed eliminare widget resta compito dell’editor.

Una dashboard per il tuo cliente

Per un pannello a parete o il tablet di un cliente:

1. Crea e salva la dashboard, ed eseguila una volta per verificare ogni widget.
2. Usa Gateway configurato se il dispositivo deve connettersi sempre a un solo gateway, o mantieni Automatico per usare quello dell’app.
3. Per un impianto Data Secure o IP Secure, scegli Progetto di questa dashboard così la dashboard porta con sé le sue chiavi.
4. Nella pagina Dashboard, apri le azioni della dashboard → Apri all'avvio dell'app. L’app aprirà allora questa dashboard come unica schermata. Facoltativamente imposta un PIN per uscire (4 o 6 cifre).
5. Attiva Mantieni lo schermo acceso nel ⚙ della vista dashboard per un pannello che non deve mai andare in standby.

Il PIN viene chiesto prima di Torna alla vista professionale. Non è una misura di sicurezza; evita solo di lasciare la dashboard per errore.

PIN dimenticato: tieni premuto ⌂ (Home) nel dock per 20 secondi. Il PIN viene rimosso e si apre la vista professionale. La dashboard continua ad aprirsi all’avvio.

Condivisione e backup

Esporta (nelle azioni della dashboard nella pagina Dashboard) salva un file .json:

• JSON non protetto: la dashboard come file modificabile, senza chiavi né password. Per i backup, per condividere un progetto grafico o per modificarla a mano.
• Con chiavi: la dashboard con le chiavi Data Secure degli indirizzi che usa e le credenziali necessarie alla sua connessione, cifrate con una password scelta da te. Per passare la dashboard di un impianto sicuro a un altro dispositivo.

Importa dashboard (sotto + nella pagina Dashboard) legge entrambi i tipi; un file protetto chiede la sua password. Se esiste già una dashboard con lo stesso nome, scegli Importa come copia o Sostituisci. Se il file ha problemi, un elenco li spiega uno per uno, con Copia dettagli.

Il formato è descritto per intero nel riferimento Formato file delle dashboard.

Quando qualcosa non va

Correlati

• Pagina Dashboard - la scheda in cui si trovano dashboard e hunt
• Formato file delle dashboard - ogni campo del file JSON, con esempi
• Come Caricare un Progetto ETS - per scegliere gli indirizzi e per Crea spazi da ETS
• Limiti - spazi, pagine, widget e scorciatoie del dock