Skip to main content

Objekt: Alarmgruppe

Mit Alarmgruppen strukturieren Sie die Verwaltung der einzelnen Alarme für eine Applikation. Für die Konfiguration hängen Sie pro Gruppe ein Objekt Alarmgruppe unterhalb des Objekts Alarmkonfiguration ein.

Im Editor des Alarmgruppenobjekts definieren Sie in einer Tabelle die einzelnen Alarme der Gruppe mit ihren Eigenschaften. Jeder Alarm gehört genau einer Alarmgruppe an.

Im Alarmgruppeneditor definieren Sie auch Einstellungen für die gesamte Gruppe, wie zum Beispiel den Archivierungstyp, eine gemeinsame Deaktivierungsvariable und eine gemeinsame Textliste.

Beachten Sie die Möglichkeit, Alarme in eine csv-Datei zu exportieren und zu importieren, siehe unten.

Mit Hilfe von Ordner-Elementen können Sie im Gerätebaum eine hierarchische Struktur von Alarmgruppen angelegen.

Dialog: Alarmgruppe

Textliste

Name der Textliste, in der die Alarmmeldungstexte gespeichert werden (siehe unten: Nachricht. CODESYS erzeugt diese Liste automatisch, wenn Sie eine Alarmgruppe anlegen. Sie können hier auch eine andere, bereits bestehende Textliste auswählen.

Archivierung

Auswahl des Alarmspeicherungsobjekts für diese Alarmgruppe. Wenn Sie ein Alarmspeicherungsobjekt angeben, aktiviert CODESYS die Alarmspeicherung.

Deaktivierung

Boolesche Variable, die alle Alarme dieser Gruppe deaktiviert. CODESYS löst dann diese Alarme nicht mehr aus, selbst wenn die Alarmbedingung erfüllt ist. Bereits aktive Alarme sind davon nicht betroffen.

Tabelle 719. Tabelle der Alarme

Sie tragen die Eigenschaften der einzelnen Alarme in die entsprechenden Tabellenspalten ein. Abhängig vom gewählten Überwachungstyp erhalten Sie für zusätzlich nötige Parameter Eingabefelder unterhalb der Tabelle.

ID

Diese eindeutige ID entspricht der ID der zugehörigen Textliste. Sie können die ID im ID-Feld der Tabelle verändern, wobei die ID innerhalb der Alarmgruppe immer eindeutig bleiben muss. Eine Änderung der ID in der Alarmtabelle bewirkt unmittelbar auch eine Änderung in der Textliste und umgekehrt.

Überwachungstyp

Auswahlliste der Überwachungstypen. Je nach Typ sind unterschiedliche Bearbeitungsfelder unterhalb der Tabelle verfügbar, die die Bedingung für den Alarm definieren. Die Felder beschreiben einen Ausdruck, der den Alarm auslösen soll. Siehe nachfolgende Tabelle.

Details

Dieses Feld zeigt die in den Feldern unterhalb der Tabelle vorgenommenen Konfigurationseinstellungen für den ausgewählten Alarmtyp.

Sie können die Bedingung auch direkt hier im Feld eingeben. Wenn Sie einen Ausdruck eingeben, der nicht zum gerade gewählten Überwachungstyp passt, wird der Typ automatisch angepasst.

Deaktivierung

Variable zum Deaktivieren des Alarms (optional).

Klasse

Zugeordnete Alarmklasse.

Nachricht

Obligatorischer Eintrag eines Meldungstextes (Nachricht), den CODESYS im Visualisierungselement Alarmtabelle anzeigen soll, sobald der Alarm auftritt. Den hier angegebenen Text trägt CODESYS automatisch in die Textliste der Alarmgruppe ein. Sie können Zeilenumbrüche mit Strg+Eingabe einfügen. CODESYS unterstützt die folgenden Platzhalter, die zur Laufzeit mit dem Istwert ersetzt werden:

<DATE>

Datum des Wechsels in den aktuellen Status.

<TIME>

Uhrzeit des letzten Statuswechsels.

<EXPRESSION>

Ausdruck (innerhalb des Alarms definiert), der den Alarm ausgelöst hat.

<PRIORITY>

Priorität des Alarms (in der Alarmklasse definiert).

<TRIGGERVALUE> *

Wert, der verursacht hat, dass die Alarmbedingung wahr wurde.

<ALARMID>

Alarm-ID wie in der ersten Spalte der Alarmtabelle angezeigt.

<CLASS>

Name der Alarmklasse (definiert im Alarm).

<ALLDEFAULT>

Gesamte Information zum Alarm wird ausgegeben.

<CURRENTVALUE> *

Istwert der überwachten Variable.

<LATCH1> *

Wert der ersten Latch-Variable zum Zeitpunkt, als der Alarm ausgelöst wurde. Hinweis: Sie können auch mehr als zwei Latch-Variablen verwenden. Fügen Sie dafür über das Kontextmenü weitere Spalten ein.

<LATCH2> *

Wert der zweiten Latch-Variable zum Zeitpunkt, als der Alarm ausgelöst wurde.

<ALARM>

TRUE im Falle von Alarmstatus „Active“, FALSE bei jedem anderen Alarmstatus.

<STATE>

Alarmstatus:

0 = „normal“, 1 = „active“ (aktiv), 2 = „waiting for ACK“ (Warten auf Quittierung), 3 = „active, acknowledged“

(noch aktiv + bereits quittiert)

* Für <TRIGGERVALUE>, <CURRENTVALUE>, <LATCHn> können Sie auch Formatierungsangaben, wie sie für die C-Funktion printf gültig sind, verwenden; Beispiel: „Der Wert beträgt <CURRENTVALUE %d>„.

Standardmäßig ist nur 1 Spalte für einen Meldungstext vorhanden. Sie können über das Kontextmenü weitere hinzufügen, die dann bei der Spaltenkonfiguration der Visualisierungselemente Alarmtabelle und Alarmbanner bei der Eigenschaft Datentyp zur Auswahl stehen.

Min. Anstehzeit:

Definiert, wie lange die Alarmbedingung mindestens erfüllt sein muss, damit CODESYS den Alarm auslöst. Damit kann CODESYS nur kurz auftretende Alarmbedingungen unterdrücken.

Format gemäß der IEC 6-1131, beispielsweise t#2ms.

Latch-Variable 1, Latch-Variable 2

Sie verwenden die Latch-Variablen, um zusätzliche Werte aufzuzeichnen, wenn der Alarm aktiv wird. Eine Latch-Variable muss skalaren Typs (8 Byte) oder vom Typ STRING oder WSTRING sein. CODESYS zeichnet eine Latch-Variable oder einen Latch-Ausdruck mit auf, wenn der Alarm aktiv wird und ermöglicht so das Bereitstellen zusätzlicher Information zum Alarm.

Hinweis: In Nachricht können Sie eine Alammeldung mit den Informationen aus Latch-Variablen erweitern. Weiterhin können Sie die Alarmvisualisierung so konfigurieren, dass Sie die dargestellten Alarme nach dem Inhalt der Latch-Variablen filtern können. Sehen Sie dazu unten unter „Siehe auch“ die entsprechenden Hilfeseiten.

Beispiel: Beim Überwachen einer Motordrehzahl werden zusätzlich die Temperatur und der Strom erfasst.

Standardmäßig sind Spalten für zwei Latch-Variablen vorhanden. Sie können über das Kontextmenü weitere Spalten einfügen, die dann bei der Spaltenkonfiguration der Visualisierungselemente Alarmtabelle und Alarmbanner bei der Eigenschaft Datentyp zur Auswahl stehen.

Höherpriorer Alarm

Wenn der Alarm ausgelöst wurde, kann er durch das Auslösen eines anderen Alarms quittiert werden.

Beispiel: Eine Temperaturüberwachung soll bei Temp > 60° C eine Warnung und bei Temp > 90° einen Fehler ausgeben. Wenn die Temperatur ansteigt, erscheint ab 60° C die Warnmeldung. Ab 90° C wird der Alarm für den Fehler ausgelöst. Dieser Alarm quittiert automatisch die 60°-Warnung.



Tabelle 720. Überwachungstypen

Digital:

Ausdruck: zu überwachender Ausdruck. Auf der rechten Seite der Ausdruck, gegen den geprüft wird. In der Mitte wählen Sie den gewünschten Vergleichsoperator (= oder <>).

Obere Grenze1):

Ausdruck: wie für Digital beschrieben, aber mit den Vergleichsoptionen > oder >= und optional einer Hysterese in %.

Untere Grenze1):

Ausdruck: wie für Digital beschrieben, aber mit den Vergleichsoptionen < oder <= und optional einer Hysterese in %.

Innerhalb des Bereichs1):

Ausdruck: zu überwachender Ausdruck.

Bereich: CODESYS löst den Alarm aus sobald der zu überwachende Ausdruck innerhalb des hier definierten Bereichs liegt. Das linke Feld definiert einen Ausdruck für die Untergrenze dieses Bereichs, das rechte Feld einen Ausdruck für die obere Grenze. Der zu überwachende Ausdruck wird im Feld dazwischen angezeigt. Sie müssen die Vergleichsoperatoren entsprechend setzen. Optional können Sie eine Hysterese in % definieren.

Außerhalb des Bereichs1):

Ausdruck: zu überwachender Ausdruck.

Bereich: CODESYS löst den Alarm aus sobald der zu überwachende Ausdruck außerhalb des hier definierten Bereichs liegt. Das linke Feld definiert einen Ausdruck für die Untergrenze dieses Bereichs, das rechte Feld einen Ausdruck für die obere Grenze. Der zu überwachende Ausdruck wird im Feld dazwischen angezeigt. Sie müssen die Vergleichsoperatoren entsprechend setzen. Optional können Sie eine Hysterese in % definieren.

Änderung:

Ausdruck: zu überwachender Ausdruck. CODESYS löst den Alarm aus sobald sich sein Wert ändert.

Ereignis:

In diesem Fall löst die Applikation den Alarm (Ereignis-Alarm) aus, wozu sie Funktionen der Bibliothek AlarmManager.library verwendet.

1) Für diesen Überwachungstyp können Sie den angegebene Ausdruck entweder absolut oder relativ überwachen. Absolut bedeutet, dass der Grenzwert durch einen festen Wert oder eine Variable, die einen festen Wert liefert, definiert ist. Relativ bedeutet, dass der Grenzwert von einem Ausdruck abhängt; beispielsweise: Obere Grenze: Variable x >= 0.9 * y.

Hysterese in %: Wenn Sie eine Hysterese angeben, ist die Alarmbedingung erfüllt bis eine bestimmte Abweichung vom angegebenen Grenzwert erreicht wird. Die Größe der Abweichung ist in Prozent [%] des Grenzwerts angegeben. Beispiel:

Obere Grenze: i_temp >= 30Hysterese: 10%. Sobald Variable i_temp den Wert 30 erreicht oder überschreitet, ist der Alarm aktiv. Der Alarm ist nicht mehr aktiv, wenn der Wert unterhalb 27 fällt.



Das Kontextmenü enthält folgende Befehle zum Hinzufügen und Entfernen von zusätzlichen Spalten für Nachrichten und Latch-Variablen:

  • _cds_icon_add_message_column.png Nachrichtenspalte hinzufügen

  • _cds_icon_remove_message_column.png Nachrichtenspalte entfernen

  • _cds_icon_add_latch_variable_column.png Latch-Variablen-Spalte hinzufügen

  • _cds_icon_remove_latch_variable_column.png Latch-Variablen-Spalte entfernen

Export und Import von Alarmen

Im Kontextmenü der Alarmtabelle finden Sie Befehle für den Export und den Import von Alarmen in und aus einer csv-Datei:

  • _cds_icon_export_alarms.png Alarme exportieren: Der Befehl öffnet den Standarddialog zum Speichern einer Datei im Dateisystem. Der Dateityp Alarmgruppen-Exportdatei (*.csv) ist voreingestellt. Sie können so die aktuelle Alarmliste in eine csv-Datei exportieren.

  • _cds_icon_import_alarms.png Alarme importieren: Der Befehl öffnet den Standarddialog zum Suchen nach einer Datei im Dateisystem. Der Dateityp Alarmgruppen-Exportdatei (*.csv) für Dateien, die Alarmdefinitionen beschreiben, ist voreingestellt.