XERO Modul ModuleSensor

Dieses Modul besitzt die folgenden Parameter:

Raw

Der Rohwert des von "ReadModule" referenzierten Moduls.

Der Wert des Moduls wird aus dem Rohwert den Adjust-Parametern errechnet.

ReadModule

Die Quelle (=Referenzmodul) als Rohwert für das Modul.

Set

Der Soll-Wert des Moduls.

Wird verwendet für das Alarmmanagement, Statistik und zur analogen Anzeige (Bargraph, Gauge) - siehe unten!

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
• "H4" → 007B (Hexadezimal-Darstellung eines Ganzzaligen Wertes mit Gesamtlänge 4)
• "b8" → 01111011 (Binär-Darstellung eines Ganzzaligen Wertes mit Gesamtlänge 8)

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

Zeigt den aktuellen Alarmstatus an (aktiv/inaktiv)

Text (Alarmtext)

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

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.

AlertId

Dieser Parameter wird nur für Host-Systeme verwendet; er dient der Identifikation des Alarms auf dem Host-System

AlertIdOffset

Dieser Parameter wird nur für Host-Systeme verwendet; er dient der Identifikation des Alarms auf dem Host-System

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.

Gruppe: Module Setup

Unit

Ermöglicht die Angabe der Eineit des Wertes.

Die XERO versucht bekannte Einheiten automatisch zu erkennen und somit den Umrechnungsfaktor zu bestimmen.

So wird z.B. bei der Angabe "ppm" und unter der Annahme dass die Einheit (Unit) des ReadModule z.B. "%" ist der Umrechnungsfaktor "1000" ermittelt - und der Wert automatisch richtig dargestellt!

Bekannte Einheiten sind u.a.:

• ppm
• %

TODO: SCAN: was gibt's sonst noch? glaub es funktioniert noch nicht ganz richtig; denn wenn zB der rohwert als unit % hat und das modul ebenfalls, dann wird *100 gerechnet; da aber beide "gleich" sind, sollte keine umrechnung erfolgen?! ebenso bei "%" auf "ppm". da wird IMHO statt 10000 -> 1000000 verwendet... es funktioniert "nur" richtig, wenn der rohwert kein unit hat... aber evtl. sehe ich das falsch?!

Adjust Die Folgenden Parameter dienen zur Umrechung des Rohwertes (x) nach der Formel:

y = k*x + d

Wobei "x" der Rohwert und "y" der errechnete Wert ist.

Offset

Absolute Verschiebung des Rohwertes (="d")

Gain

Verstärkungsfaktor (="k")

TODO: SCAN: diesen und die folgenden parameter bitte beschreiben

Mode

bla bla bla

OffsetDrift

bla bla bla

OffsetOrigin

bla bla bla

GainDrift

bla bla bla

GainOrigin

bla bla bla

Linearization

bla bla bla

x/y werte --> Splines --> ...

Value1

bla bla bla

Value2

bla bla bla

Date

bla bla bla