Oggetto 'Gruppo di allarme'

I gruppi di allarme servono a strutturare la gestione dei singoli allarmi di un'applicazione. Per la configurazione, per ogni gruppo si inserisce un oggetto «Alarm Group» sotto l'oggetto «Alarm Configuration».

Nell'editor dell'oggetto gruppo di allarmi, si definiscono i singoli allarmi del gruppo con le loro proprietà in una tabella. Ogni allarme appartiene esattamente a un gruppo di allarme.

Nell'editor dei gruppi di allarme si definiscono anche le impostazioni per l'intero gruppo (ad esempio, il tipo di archiviazione, una variabile di disattivazione condivisa e un elenco di testo condiviso).

Si noti la possibilità di esportare e importare gli allarmi da e verso un file CSV (vedere sotto).

È possibile creare una struttura gerarchica di gruppi di allarme nella struttura del dispositivo con l'aiuto di elementi di cartella.

Finestra di dialogo "Gruppo di allarme

«Elenco testi»	Nome dell'elenco di testo in cui viene salvato il testo del messaggio di allarme (vedere sotto): «Messaggio»). CODESYS genera l'elenco automaticamente quando si crea un gruppo di allarme. È anche possibile selezionare un elenco di testo esistente.
«Archiviazione»	Selezione dell'oggetto di memorizzazione degli allarmi per il gruppo di allarmi. Quando si specifica un oggetto di memorizzazione degli allarmi, CODESYS attiva la memorizzazione degli allarmi.
«Disattivazione»	Variabile booleana che disattiva tutti gli allarmi di questo gruppo. CODESYS non attiva più questi allarmi, anche se la condizione di allarme è soddisfatta. Gli allarmi già attivi non sono interessati da questa operazione.

Tab. 820: Tabella degli allarmi
Le proprietà dei singoli allarmi vengono inserite nelle colonne della tabella corrispondenti. A seconda del tipo di monitoraggio selezionato, sotto la tabella sono presenti campi di immissione per i parametri aggiuntivi richiesti.
«ID»	Questo ID univoco corrisponde all'ID dell'elenco di testo associato. È possibile modificare l'ID nel campo «ID» della tabella. L'ID deve essere sempre unico all'interno del gruppo di allarme. Una modifica dell'ID nella tabella degli allarmi provoca direttamente anche una modifica nell'elenco di testo e viceversa.
«Tipo di osservazione»	Casella di riepilogo dei tipi di osservazione. A seconda del tipo, sotto la tabella sono disponibili diversi campi di modifica che definiscono la condizione dell'allarme. I campi definiscono un'espressione che attiva l'allarme. Vedere la seguente tabella.
«Dettagli»	Questo campo mostra le impostazioni di configurazione (definite nei campi sotto la tabella) per il tipo di allarme selezionato. È anche possibile specificare la condizione direttamente nel campo. Se si immette un'espressione che non corrisponde al tipo di osservazione attualmente selezionato, il tipo viene adattato automaticamente.
«Disattivazione»	(opzionale) Variabile per la disattivazione dell'allarme.
«Classe»	Classe di allarme assegnata.
«Messaggio»	Richiesto l'inserimento di un testo di messaggio (messaggio) che CODESYS visualizzerà nell'elemento di visualizzazione «Alarm Table» quando si verifica l'allarme. Il testo inserito qui viene trasferito automaticamente da CODESYS all'elenco di testo del gruppo di allarme. È possibile inserire interruzioni di riga premendo [Ctrl]+[Invio]. CODESYS supporta i seguenti segnaposto, che vengono sostituiti dal valore effettivo in fase di esecuzione:
	`‎<DATE>‎`	Data della modifica dello stato attuale.
	`‎<TIME>‎`	Ora dell'ultima modifica dello stato.
	`‎<EXPRESSION>‎`	Espressione (definita all'interno dell'allarme) che ha fatto scattare l'allarme.
	`‎<PRIORITY>‎`	Priorità dell'allarme (definita nella classe di allarme).
	`‎<TRIGGERVALUE>‎` *	Valore che ha causato l'avverarsi della condizione di allarme.
	`‎<ALARMID>‎`	ID dell'allarme visualizzato nella prima colonna della tabella degli allarmi.
	`‎<CLASS>‎`	Nome della classe di allarme (definita nell'allarme).
	`‎<ALLDEFAULT>‎`	Vengono emesse informazioni complete sull'allarme.
	`‎<CURRENTVALUE>‎` *	Valore effettivo della variabile monitorata.
	`‎<LATCH1>‎` *	Valore della prima variabile latch al momento dell'attivazione dell'allarme. Nota: È inoltre possibile utilizzare più di due variabili di latch. A questo scopo, inserire colonne aggiuntive dal menu contestuale.
	`‎<LATCH2>‎` *	Valore della variabile del secondo latch al momento dell'attivazione dell'allarme.
	`‎<ALARM>‎`	`‎TRUE‎` nel caso dello stato di allarme "Attivo", `‎FALSE‎` con ogni altro stato di allarme.
	`‎<STATE>‎`	Stato dell'allarme: 0 = "normale", 1 = "attivo", 2 = "in attesa di ACK", 3 = "attivo, riconosciuto" (ancora attivo e già riconosciuto)
	* Per `‎<TRIGGERVALUE>‎`, `‎<CURRENTVALUE>‎` e `‎<LATCHn>‎` è possibile utilizzare anche specifiche di formattazione come quelle valide per la funzione C `‎printf‎` (esempio: "`‎The value is <CURRENTVALUE %d>‎`"). Per impostazione predefinita, è disponibile solo una colonna per il testo del messaggio. È possibile aggiungere altre colonne dal menu contestuale che sarà disponibile nella proprietà «Tipo di dati» per la configurazione delle colonne degli elementi di visualizzazione «Tabella allarmi» e «Banner allarmi».
«Min. Pend. Tempo»:	Definisce la durata minima per soddisfare la condizione di allarme in modo che CODESYS attivi l'allarme. In questo modo, CODESYS può inibire condizioni di allarme che si verificano solo per un breve periodo. Formato conforme a IEC 61131 (esempio: `‎t#2ms‎`).
«Latch var 1», «Latch var 2»	Le variabili di latch vengono utilizzate per registrare valori aggiuntivi quando l'allarme diventa attivo. Una variabile di latch deve essere di tipo scalare (8 byte) o di tipo `‎STRING‎` o `‎WSTRING‎`. CODESYS registra una variabile di latch o un'espressione di latch quando l'allarme diventa attivo. In questo modo, è possibile fornire informazioni aggiuntive sull'allarme. Nota: In «Message», è possibile includere le informazioni delle variabili di latch in un messaggio di allarme. Inoltre, è possibile configurare la visualizzazione degli allarmi in modo da filtrare gli allarmi visualizzati in base al contenuto delle variabili di latch. Per ulteriori informazioni, consultare le pagine di aiuto corrispondenti sotto la voce "Vedi anche". Esempio: Quando si monitora la velocità di un motore, vengono registrate anche la temperatura e la corrente. Per impostazione predefinita, le colonne sono disponibili per due variabili di latch. È possibile inserire altre colonne dal menu contestuale che sarà disponibile nella proprietà «Tipo di dati» per la configurazione delle colonne degli elementi di visualizzazione «Tabella allarmi» e «Banner allarmi».
«Allarme più alto»	Una volta scattato, l'allarme può essere confermato dall'attivazione di un altro allarme. Esempio: Un monitor di temperatura dovrebbe emettere un'avvertenza a > 60 °C e un errore a > 90 °C. Se la temperatura aumenta, l'avviso viene visualizzato a partire da 60 °C. A partire da 90° C, viene attivato l'allarme per l'errore. Questo allarme riconosce automaticamente l'avviso di 60°.

Tab. 821: Tipi di osservazioni
«Digital»:	«Espressione»: Espressione da osservare. A destra, l'espressione per il confronto. Al centro, si seleziona l'operatore di confronto desiderato («=» o `‎<>‎`).
«Limite superiore»¹⁾:	«Espressione»: Come descritto per «Digital», ma con le opzioni di confronto «>» o `‎>=‎` e, facoltativamente, un'isteresi «in %».
«Limite inferiore»¹⁾:	«Espressione»: Come descritto per «Digital», ma con le opzioni di confronto «<» o `‎<=‎` e, facoltativamente, un'isteresi «in %».
«All'interno dell'intervallo»¹⁾:	«Espressione»: Espressione da osservare. «Intervallo»: CODESYS attiva l'allarme quando l'espressione monitorata rientra nell'intervallo definito qui. Il campo di sinistra definisce un'espressione per il limite inferiore di questo intervallo. Il campo di destra definisce un'espressione per il limite superiore. L'espressione da monitorare viene visualizzata nel campo intermedio. È necessario impostare gli operatori di confronto di conseguenza. È possibile definire un'isteresi «in %» opzionalmente.
«Fuori gamma»¹⁾:	«Espressione»: Espressione da osservare. «Intervallo»: CODESYS attiva l'allarme quando l'espressione monitorata è al di fuori dell'intervallo definito qui. Il campo di sinistra definisce un'espressione per il limite inferiore di questo intervallo. Il campo di destra definisce un'espressione per il limite superiore. L'espressione da monitorare viene visualizzata nel campo intermedio. È necessario impostare gli operatori di confronto di conseguenza. È possibile definire un'isteresi «in %» opzionalmente.
«Modifica»:	«Espressione»: Espressione da osservare. CODESYS attiva l'allarme quando il suo valore cambia.
«Evento»:	In questo caso, l'applicazione attiva l'allarme (allarme evento) utilizzando le funzioni della libreria `‎AlarmManager.library‎`.
¹⁾Per questo tipo di osservazione, è possibile monitorare l'espressione specificata come assoluta o relativa. Assoluto significa che il valore limite è definito da un valore fisso o da una variabile che restituisce un valore fisso. Relativo significa che il valore limite dipende da un'espressione; ad esempio: limite superiore: «Variabile x >= 0,9 * y». «Isteresi in %»: Quando si specifica un'isteresi, la condizione di allarme viene soddisfatta finché non viene raggiunta una certa deviazione dal valore limite specificato. L'entità della deviazione è specificata come percentuale [%] del valore limite. Esempio: Limite superiore: `‎i_temp >= 30‎` `‎Hysteresis: 10%‎`. L'allarme si attiva quando la variabile `‎i_temp‎` raggiunge o supera il valore 30. L'allarme non è più attivo se il valore scende sotto 27.

Il menu contestuale comprende i seguenti comandi per aggiungere e rimuovere colonne aggiuntive per i messaggi e le variabili di latch:

«Aggiungere la colonna dei messaggi»
«Rimuovere la colonna dei messaggi»
«Aggiungere la colonna latch var»
«Rimuovere il fermo della colonna»

Esportazione e importazione di allarmi

Nel menu contestuale della tabella degli allarmi si trovano i comandi per l'esportazione e l'importazione degli allarmi da e verso un file CSV:

«Esportazione di allarmi»: Il comando apre la finestra di dialogo predefinita per il salvataggio di un file nel file system. Il tipo di file predefinito è ‎Alarm Group Export File (*.csv)‎. In questo modo è possibile esportare l'elenco degli allarmi correnti in un file CSV.
«Importazione di allarmi»: Il comando apre la finestra di dialogo predefinita per la ricerca di un file nel file system. Il tipo di file predefinito è ‎Alarm Group Export File (*.csv)‎ per la descrizione delle definizioni di allarme.