Vai al contenuto
Elausys

HyperVisu / Configurazione del dispositivo

Impostazioni oggetti, logging e notifiche

Range, etichette, lettura all'avvio, logging InfluxDB, persistenza dello stato e regole di notifica.

elausys · 17 luglio 2026
In questa pagina

Impostazioni oggetti

Ogni oggetto di comunicazione dispone di una finestra di dialogo delle impostazioni: apri la riga dell'oggetto e fai clic su Modifica. I parametri visualizzati dipendono dal protocollo, ma gli elementi comuni sono:

Generale

CampoDescrizione
NomeIl nome dell'oggetto.
DatatypeIl tipo di dati dell'oggetto. La selezione di un tipo di dati diverso dal tipo nativo dell'oggetto mostra un avviso: è necessaria una trasformazione per la conversione (vedere “Trasformazioni valori e stato”).
DirezioneIngresso, uscita o entrambi.

Impostazioni valore

CampoDescrizione
Range - Min / MaxIl range di valori.
Label - Min / MaxEtichette per gli estremi del range (ad es. Chiuso / Aperto).
Cifre decimaliPrecisione di visualizzazione.
UnitàL'unità visualizzata (ad es. °C, kWh).

Impostazioni per protocollo

  • KNX: Indirizzo di gruppo, Data Point Type — il server legge l'indirizzo all'avvio per mostrare immediatamente un valore nell'app.
  • Home Assistant: Entity ID e opzionalmente l'Attributo da leggere.
  • Modbus: vedere “Integrazione Modbus TCP”.
  • HTTP: vedere “Integrazione HTTP”.
  • MQTT: topic, formato del payload, opzioni di pubblicazione e sottoscrizione — vedere “Integrazione MQTT”.
  • BACnet/IP: tipo e istanza dell'oggetto, tipo di valore, sottoscrizione alla variazione di valore (COV) e priorità di scrittura — vedere “Integrazione BACnet/IP”.
  • TCP/UDP: chiave, template di comando e interrogazione, pattern di corrispondenza — vedere “Integrazione TCP/UDP”.
  • Virtuale: Valore predefinito e Persistente (mantiene il valore tra i riavvii) — vedere “Dispositivi virtuali e Node-RED”.
  • Telecamera: l'URL dello stream della telecamera (vedere “Configurazione telecamere e videocitofono”).
  • Videocitofono: indirizzo del videocitofono e credenziali (vedere “Configurazione telecamere e videocitofono”).

Notifiche

Un oggetto può generare una notifica push quando un valore ricevuto soddisfa una regola:

CampoDescrizione
TipoNo (disattivato), Uguale, Maggiore di, Minore di.
ValoreLa soglia o il valore di corrispondenza.
Intervallo (s)Tempo minimo tra notifiche ripetute per la stessa condizione.

Le notifiche vengono inviate all'app sotto forma di messaggi push (vedere “Notifiche push”).

Logging

  • Abilita logging — registra ogni variazione di valore nello storico delle serie temporali (InfluxDB). Questo alimenta i grafici di andamento nell'app, i grafici dei contatori, le dashboard Grafana e l'esportazione CSV (vedere “Storico e data logging”). La riga del dispositivo mostrerà quindi il badge REGISTRATO.
  • Mantieni stato — salva il valore alla modifica e lo ripristina dopo un riavvio del server.

Le modifiche hanno effetto al salvataggio; la registrazione inizia con il valore successivo ricevuto.

La finestra di dialogo delle impostazioni per un oggetto di temperatura KNX.

Generatore di pannelli Grafana

Gli oggetti registrati offrono l'azione Pannello Grafana che genera un pannello Grafana o una query Flux per l'oggetto:

  1. Scegli il tipo di pannello, la funzione di aggregazione, il periodo di aggregazione, l'intervallo di tempo e un titolo.
  2. Quindi copia il JSON del pannello o solo la query (Flux) per incollarla direttamente in Grafana, oppure seleziona una dashboard di destinazione e fai clic su Aggiungi pannello: il pannello verrà aggiunto a quella dashboard. Puoi anche creare una nuova dashboard specificandone il nome.

Se un elemento non è configurato correttamente, la finestra di dialogo indica il problema: Grafana è disabilitato (abilitalo in Servizi), nessun token API impostato (vedere “Servizi e protocolli”), Grafana non è raggiungibile oppure il token non dispone dei permessi di Editor. I dettagli su Grafana e le dashboard sono disponibili in “Storico e data logging”.

La finestra di dialogo del pannello Grafana per un oggetto di potenza registrato.

Domande frequenti

Dove posso modificare l'unità di misura e i decimali di una lettura?

Espandi la riga dell'oggetto del dispositivo e fai clic su Modifica. Utilizza Unità e Cifre decimali sotto Impostazioni valore.

Quando inizia la registrazione dello storico?

Abilita il logging e salva. La registrazione inizia con il valore successivo ricevuto e memorizza le variazioni successive in InfluxDB.

In cosa differisce Mantieni stato dal logging?

Il logging registra uno storico di serie temporali. Mantieni stato salva l'ultimo valore alla modifica e lo ripristina dopo il riavvio del server.

Come posso ridurre le notifiche ripetute sulle soglie?

Imposta l'intervallo di notifica in secondi. Definisce il tempo minimo tra notifiche ripetute per la stessa condizione.

Perché il generatore di pannelli Grafana segnala un problema?

Verifica che Grafana sia abilitato e raggiungibile e che il relativo token API sia configurato con permessi di Editor.

Continua a esplorare

Trova le altre guide per questo prodotto nella documentazione.

Torna a Configurazione del dispositivo