Vai al contenuto
Elausys

HyperVisu / Configurazione del dispositivo

Impostazioni oggetto, registrazione e notifiche

Intervalli, etichette, registrazione su InfluxDB, persistenza dello stato e regole di notifica.

elausys · 17 luglio 2026
In questa pagina

Impostazioni dell'oggetto

Ogni oggetto di comunicazione ha una finestra di impostazioni: espandi il dispositivo e fai clic sull'ingranaggio alla fine della riga dell'oggetto (Edit Object). Ciò che vedi dipende dal protocollo, ma le parti comuni sono:

General

FieldDescription
Object NameIl nome dell'oggetto.
DatatypeIl tipo di dato dell'oggetto. Scegliendo un tipo di dato diverso da quello nativo dell'oggetto compare un avviso: serve una trasformazione per convertire tra i due (vedi «Value Transformations & Health»).
AddressIl collegamento dell'oggetto: l'indirizzo di gruppo, l'entità o l'indirizzo di protocollo a cui è connesso.

La finestra non ha un'impostazione di direzione: se un oggetto riceve valori, invia comandi o entrambi dipende dal tipo di widget (vedi «The Devices Workspace»).

Value settings

FieldDescription
Range - Min / MaxL'intervallo dei valori.
Label - Min / MaxEtichette per gli estremi dell'intervallo (ad es. Closed / Open).
Decimal digitsLa precisione di visualizzazione.
UnitsL'unità visualizzata (ad es. °C, kWh).

Impostazioni per protocollo

  • KNX: l'indirizzo di gruppo (Address) e il tipo di datapoint (Datatype). Non esiste l'opzione «Read on Start»: ogni volta che la connessione KNX viene stabilita, il server legge tutti gli oggetti che ricevono un valore e hanno un indirizzo, così l'app mostra subito i valori.
  • Home Assistant: Entity ID e, facoltativamente, l'Attribute da leggere.
  • Modbus: vedi «Modbus TCP Integration».
  • HTTP: vedi «HTTP Integration».
  • MQTT: topic, formato del payload, opzioni di pubblicazione e sottoscrizione; vedi «MQTT Integration».
  • BACnet/IP: tipo e istanza dell'oggetto, tipo di valore, sottoscrizione al cambio di valore e priorità di scrittura; vedi «BACnet/IP Integration».
  • TCP/UDP: chiave, modelli di comando e di interrogazione, pattern di corrispondenza; vedi «TCP/UDP Integration».
  • Virtual: l'intervallo (Range - Min / Range - Max) e Persist State (mantiene il valore dopo i riavvii); non esiste un'impostazione di valore predefinito; vedi «Virtual Devices & Node-RED».
  • Camera: il Camera Stream URL (vedi «Cameras & Videophone Setup»).
  • Videophone: l'indirizzo e le credenziali del videocitofono (vedi «Cameras & Videophone Setup»).

Notifiche

Un oggetto può generare una notifica push quando un valore ricevuto soddisfa una regola. Attiva Notifications, poi imposta:

FieldDescription
TypeEqual, Greater than o Lower than.
ValueLa soglia o il valore di confronto.
Interval (s)Il tempo minimo tra due notifiche. È un intervallo minimo, non un timer di ripetizione.

Una regola scatta quando il valore supera la soglia, non per tutto il tempo in cui resta oltre. Una regola Greater than invia una notifica quando il valore raggiunge la soglia; la successiva è possibile solo dopo che il valore è sceso di nuovo sotto la soglia, e mai prima di Interval (s) dalla precedente. Un oggetto ha una sola regola di notifica.

Le notifiche vengono consegnate all'app come messaggi push (vedi «Push Notifications»).

Settings

  • Log historical values: scrive ogni variazione di valore nello storico a serie temporali (InfluxDB). È ciò che alimenta i trend nell'app, i grafici dei contatori, le dashboard Grafana e l'esportazione CSV (vedi «History & Data Logging»). La riga dell'oggetto mostra allora l'icona del database e il pulsante Grafana (la legenda LOGGED e GRAFANA, vedi «The Devices Workspace»).
  • Persist State: salva il valore alla variazione e lo ripristina dopo il riavvio del server. È indipendente dalla registrazione.

Fai clic su Save object per salvare la finestra, poi su Apply changes nella barra laterale e conferma (vedi «Admin Panel Tour»). La registrazione parte dal valore ricevuto successivamente.

La finestra delle impostazioni di un oggetto di temperatura KNX.

Il costruttore di pannelli Grafana

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

  1. Scegli il tipo di pannello, la funzione di aggregazione e il periodo di aggregazione, l'intervallo di tempo e un titolo.
  2. Poi copia il Panel JSON oppure solo la query (Flux) da incollare tu stesso in Grafana, oppure scegli una dashboard di destinazione e fai clic su Add panel: il pannello viene aggiunto a quella dashboard. Puoi anche creare una nuova dashboard indicandone il nome.

Se manca qualcosa, la finestra indica esattamente cosa: Grafana è disabilitato (abilitalo in Services), non è impostato alcun token API (vedi «Services & Protocols»), Grafana non è raggiungibile oppure il token non ha il permesso Editor. I dettagli su Grafana e sulle dashboard sono in «History & Data Logging».

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

Domande frequenti

Dove si cambiano le unità e i decimali di una lettura?

Espandi il dispositivo e fai clic sull'ingranaggio alla fine della riga dell'oggetto (Edit Object). Usa Units e Decimal digits in Value settings.

Quando inizia la registrazione dello storico?

Attiva Log historical values, salva l'oggetto e applica le modifiche. La registrazione parte dal valore ricevuto successivamente e salva in InfluxDB le variazioni di valore seguenti.

In cosa Persist State è diverso dalla registrazione?

La registrazione salva uno storico a serie temporali. Persist State salva l'ultimo valore alla variazione e lo ripristina dopo il riavvio del server.

Come posso ridurre gli avvisi ripetuti di soglia?

Imposta l'Interval della notifica in secondi. Definisce il tempo minimo tra due notifiche; una regola scatta di nuovo solo dopo che il valore ha attraversato di nuovo la soglia.

Perché il costruttore di pannelli Grafana segnala un problema?

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

Continua a esplorare

Trova le altre guide per questo prodotto nella documentazione.

Torna a Configurazione del dispositivo