XERO Modul ModuleSensor: Unterschied zwischen den Versionen

Version vom 14. November 2014, 09:31 Uhr (Quelltext anzeigen) Han (Diskussion | Beiträge) ← Zum vorherigen Versionsunterschied		Version vom 14. November 2014, 10:15 Uhr (Quelltext anzeigen) Han (Diskussion | Beiträge) Zum nächsten Versionsunterschied →
Zeile 94:		Zeile 94:
−	Mit der Taste {{button|Adjust}} kann die oben angesprochene Umrechnung des Referenz-Wertes ("ReadModule") in den Modul-Wert ("Raw") parametriert werden:	+	==== Gruppe: Alert Setup ====
		+	{{setup_param|bool|AlertStatus}}
		+	:Aktivierung/Deaktivierung der Alarmbehandlunf für dieses Modul
−	[[Datei:Module_sensor_adjust.png|600px|thumb|none]]
		+	{{setup_param|text|Text (Alarmtext)}}
		+	:Der Text der bei der Auslösung des Alarms im Modul bzw. der Statuszeile erscheinen soll.
		+	{{setup_param|text|Behaviour}}
		+	:Einstellung des Alarmverhaltens
		+	:*Aus → Alarme/Warnungen werden ignoriert
		+	:*Lokal → Alarme/Warnungen werden nur angezeigt
		+	:*Auto → Alarme werden verarbeitet und automatisch quittiert (default)
		+	:*Alarm → Alarme werden verarbeitet und automatisch quittiert
		+	:*Warnung → Warnungen werden verarbeitet und automatisch quittiert
		+	:*Manuell → Alarme werden verarbeitet; müssen aber manuell quittiert werden
		+	:*Halt → Alarme führen zum Abbruch "kritischer" Funktionen
		+	:*Emergency → im Alarmfall wird das "Notfallmacro" ausgeführt
		+	{{setup_param|time|Inhibit}}
		+	:Die Alarm-"Vorhaltezeit" → wie lange muss die Alarmbedingung dauerhaft erfüllt sein, damit der Alarm auslöst.
−	Unit	+	{{setup_param|text|AlertId}}
−	min	+	:Identifikation des Alarms (um bei mehreren Alarmen eine eindeutige Zuordnung treffen zu können)
−	max	+
−	linearisierung	+
−	sollwert	+
−	alarmmanagement: soll*rel%+-abs	+
		+	{{setup_param|numb|AlertOffset}}
		+	:
		+
		+	{{setup_param|numb|AlertMin}} und {{setup_param|numb|AlertMax}}
		+	:Die Alarm-Grenzen für den .Raw-Wert.
		+	:Liegt der .Raw-Wert mindestens die {{setup_param|time|Inhibit}}-Zeit ausserhalb dieser Grenzen, so wird ein Alarm ausgelöst (Vorausgesetzt natürlich {{setup_param|bool|AlertStatus}} ist aktiviert)
		+
		+	{{setup_param|numb|AlertThreshold}} und {{setup_param|numb|AlertRelative [in %]}}
		+	:Definieren gemeinsam die Alarmgrenzen in Bezug auf den Set-Wert des Moduls
		+	:Die Alarmgrenzen werden wie folgt errechnet:
		+	::<tt> AlertMin = Set * (1-AlertRelative) - AlertThreshold</tt>
		+	::<tt> AlertMax = Set * (1+AlertRelative) + AlertThreshold</tt>
		+
		+	Je nachdem ob AlertMin/AlertMax oder AlertThreshold/AlertRelative zuletzt geändert wurden, gilt der eingestellte Wert in AlertMin/AlertMax oder die aus AlertThreshold und AlertRelative errechneten Min/Max Werte.
		+	Es empfiehlt sich AlertThreshold und/oder AlertRelative auf "#" zu setzen falls sie nicht verwendet werden sollen, damit ersichtlich ist ob Min/Max errechnet oder manuell eingegeben wurden.
		+
		+
		+
		+	{{todo|linearisierung/Adjust-Modul}}
		+	{{todo|.Adjust-Parameter}}

---

Version vom 14. November 2014, 10:15 Uhr

Dieses Modul besitzt die folgenden Parameter:

Raw

Der "Wert" des Moduls.

Wird aus dem Wert des von "ReadModule" referenzierten Moduls und den Adjust-Parametern errechnet.

ReadModule

Die Quelle (=Referenzmodul) als Basiswerts für das Moduls.

Verknüpft mit den Adjust-Parametern wird daraus der Raw-Wert des ModuleSensors.

Set

Der Ziel- oder Target-Wert des Moduls.

Die weiteren Konfigurations-Möglichkeiten des Moduls sind über Setup erreichbar:

Hier können (zusätzlich zu den allgemeinen Parametern) folgende Einstellungen vorgenommen werden:

Gruppe: Value Setup

History

Gibt die Dauer der zu speichernden History-Fensters an.

Es wird jeweils über den im Parameter Timer definierten Zeitinterval ein Messwert gespeichert. Messwerte die älter als das hier definierte Interval sind werden verworfen.

Bei der Angabe des Zeitintervalles sind folgende "Einheiten" definiert:

• "s" für Sekunden
• "m" für Minuten
• "h" für Stunden
• "d" für Tage

Die Angabe "1h" bedeutet also "eine Stunde"; Gleichbedeutend mit "60m" oder "3600s"

T90

Messwertfilterung in Sekunden. "0"=keine Filterung.

Die Angabe von "3" würde z.B. bedeuten, dass der .Raw-Wert jeweils über 3 Sekunden gemittelt wird.

Min und Max

Soll der Messwert analog dargestellt werden (Gauge, Bargaph, etc.), können hier das Minimum und Maximum für die analoge Anzeige definiert werden.

Format

Dient der Formattierung des Digitalwertes.

Wird hier ein einfacher Zahlenwert angegeben, so bedeutet das die Anzahl der Nachkomma-Stellen.

Ein vorangestelltes "e" erzwingt hingegen eine Ausgabe in Wissenschaftlicher Exponential-Darstellung.

Weiters ist es möglich, die Formattierung mit den Zeichen "0" bzw. "#" vorzugeben. Die Verwendung von "0" erzwingt vorangestellte "0"en, falls die Anzeige unter einem gewissen Wert liegt.

Beispiele für die Formattierung des .Raw-Wertes "123.4567"

• "2" → 123.46
• "e2" → 1.46e+002
• "0.00" → 123.46
• "#.##" → 123.46
• "0000.00" → 0123.46
• "####.##" → 123.46

Eine ausfühliche Beschreibung zur Formattierung von Zahlenwerten ist hier zu finden.

Gruppe: Value Status (Statistics)

Statistics

Falls Statistics auf "true(ein)" gesetzt wird, wird für den .Raw-Wert dieses Moduls laufend eine Statische Auswertung durchgeführt.

Soll eine Neu-Berechnung der Werte "ab jetzt" erfolgen, so kann dies duch aus/ein-Schalten von "Statistics" erzwungen werden.

Min (min. Wert)

Der bisherige Maximal-Wert

Max (max. Wert)

Der bisherige Minimal-Wert

Average (Mittelwert)

Der bisherige Durchschnitts-Wert (μ)

StdDev (Standardabweichung)

Die bisherige Standardabweichung (σ) des Durchschnitts-Wertes

OnSet

Über die Parameter "Inhibit" und "Threshold" (in %) kann definiert werden, welchen Wert der Modulwert (".Raw") in Bezug auf den ".Set"-Wert über die Inhibit-Time hinweg annehmen muss, damit das "OnSet"-Macro aufgerufen wird.

In diesem Macro können dann Aktionen gesetzt/programmiert werden, die somit ausgeführt werden, sobald das "OnSet"-Kriterium erfüllt wird.

Stable

Ähnlich dem "OnSet" wird "Stable" aktiv wenn der Modulwert über einen gewissen Zeitraum stabil war.

Gruppe: Alert Setup

AlertStatus

Aktivierung/Deaktivierung der Alarmbehandlunf für dieses Modul

24px Text (Alarmtext)

Der Text der bei der Auslösung des Alarms im Modul bzw. der Statuszeile erscheinen soll.

24px Behaviour

Einstellung des Alarmverhaltens

• Aus → Alarme/Warnungen werden ignoriert
• Lokal → Alarme/Warnungen werden nur angezeigt
• Auto → Alarme werden verarbeitet und automatisch quittiert (default)
• Alarm → Alarme werden verarbeitet und automatisch quittiert
• Warnung → Warnungen werden verarbeitet und automatisch quittiert
• Manuell → Alarme werden verarbeitet; müssen aber manuell quittiert werden
• Halt → Alarme führen zum Abbruch "kritischer" Funktionen
• Emergency → im Alarmfall wird das "Notfallmacro" ausgeführt

Inhibit

Die Alarm-"Vorhaltezeit" → wie lange muss die Alarmbedingung dauerhaft erfüllt sein, damit der Alarm auslöst.

24px AlertId

Identifikation des Alarms (um bei mehreren Alarmen eine eindeutige Zuordnung treffen zu können)

AlertOffset

AlertMin und AlertMax

Die Alarm-Grenzen für den .Raw-Wert.

Liegt der .Raw-Wert mindestens die Inhibit-Zeit ausserhalb dieser Grenzen, so wird ein Alarm ausgelöst (Vorausgesetzt natürlich AlertStatus ist aktiviert)

AlertThreshold und AlertRelative [in %]

Definieren gemeinsam die Alarmgrenzen in Bezug auf den Set-Wert des Moduls

Die Alarmgrenzen werden wie folgt errechnet:

AlertMin = Set * (1-AlertRelative) - AlertThreshold

AlertMax = Set * (1+AlertRelative) + AlertThreshold

Je nachdem ob AlertMin/AlertMax oder AlertThreshold/AlertRelative zuletzt geändert wurden, gilt der eingestellte Wert in AlertMin/AlertMax oder die aus AlertThreshold und AlertRelative errechneten Min/Max Werte. Es empfiehlt sich AlertThreshold und/oder AlertRelative auf "#" zu setzen falls sie nicht verwendet werden sollen, damit ersichtlich ist ob Min/Max errechnet oder manuell eingegeben wurden.