XERO Modul ModuleSensor: Unterschied zwischen den Versionen

Aus Amium_Wiki
Wechseln zu: Navigation, Suche
Zeile 5: Zeile 5:
  
 
{{setup_param|graph|Raw}}
 
{{setup_param|graph|Raw}}
−
:Der "Wert" des Moduls.  
+
:Der Rohwert des von "ReadModule" referenzierten Moduls.  
−
:Wird aus dem Wert des von "ReadModule" referenzierten Moduls und den Adjust-Parametern errechnet.
+
:Der Wert des Moduls wird aus dem Rohwert den Adjust-Parametern errechnet.
  
  
 
{{setup_param|module|ReadModule}}
 
{{setup_param|module|ReadModule}}
−
:Die Quelle (=Referenzmodul) als Basiswerts für das Moduls.
+
:Die Quelle (=Referenzmodul) als Rohwert für das Modul.  
−
:Verknüpft mit den Adjust-Parametern wird daraus der Raw-Wert des ModuleSensors.
+
  
  
 
{{setup_param|numb|Set}}
 
{{setup_param|numb|Set}}
−
:Der Ziel- oder Target-Wert des Moduls.
+
:Der Soll-Wert des Moduls.
 +
:Wird verwendet für das Alarmmanagement, Statistik und zur analogen Anzeige (Bargraph, Gauge) - siehe unten!
  
  
Zeile 58: Zeile 58:
 
:*"0000.00" → 0123.46
 
:*"0000.00" → 0123.46
 
:*"####.##" → 123.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 [http://msdn.microsoft.com/de-de/library/dwhawy9k(v=vs.110).aspx hier] zu finden.
 
Eine ausfühliche Beschreibung zur Formattierung von Zahlenwerten ist [http://msdn.microsoft.com/de-de/library/dwhawy9k(v=vs.110).aspx hier] zu finden.
  
Zeile 96: Zeile 98:
 
==== Gruppe: Alert Setup ====
 
==== Gruppe: Alert Setup ====
 
{{setup_param|bool|AlertStatus}}
 
{{setup_param|bool|AlertStatus}}
−
:Aktivierung/Deaktivierung der Alarmbehandlunf für dieses Modul
+
:Zeigt den aktuellen Alarmstatus an (aktiv/inaktiv)
  
  
Zeile 120: Zeile 122:
  
 
{{setup_param|alph|AlertId}}
 
{{setup_param|alph|AlertId}}
−
:Identifikation des Alarms (um bei mehreren Alarmen eine eindeutige Zuordnung treffen zu können)
+
:Dieser Parameter wird nur für Host-Systeme verwendet; er dient der Identifikation des Alarms auf dem Host-System
  
  
−
{{setup_param|numb|AlertOffset}}
+
{{setup_param|numb|AlertIdOffset}}
−
:
+
:Dieser Parameter wird nur für Host-Systeme verwendet; er dient der Identifikation des Alarms auf dem Host-System
 +
 
  
 
{{setup_param|numb|AlertMin}} und {{setup_param|numb|AlertMax}}
 
{{setup_param|numb|AlertMin}} und {{setup_param|numb|AlertMax}}
 
:Die Alarm-Grenzen für den .Raw-Wert.
 
: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)
 
: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 %]}}
 
{{setup_param|numb|AlertThreshold}} und {{setup_param|numb|AlertRelative [in %]}}
Zeile 140: Zeile 144:
  
  
 +
==== Gruppe: Module Setup ====
 +
{{setup_param|alph|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 {{setup_param|module|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?!}}
 +
 +
{{setup_param|module|Adjust}}
 +
Die Folgenden Parameter dienen zur Umrechung des Rohwertes (x) nach der Formel:
 +
 +
:<tt>y = k*x + d</tt>
 +
 +
Wobei "<tt>x</tt>" der Rohwert und "<tt>y</tt>" der errechnete Wert ist.
 +
 +
:{{setup_param|numb|Offset}}
 +
::Absolute Verschiebung des Rohwertes (=<tt>"d"</tt>)
 +
 +
:{{setup_param|numb|Gain}}
 +
::Verstärkungsfaktor (="<tt>k</tt>")
 +
 +
{{todo|SCAN: diesen und die folgenden parameter bitte beschreiben}}
 +
:{{setup_param|alph|Mode}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|OffsetDrift}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|OffsetOrigin}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|GainDrift}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|GainOrigin}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|Linearization}}
 +
::bla bla bla
 +
::x/y werte --> Splines --> ...
 +
 +
:{{setup_param|numb|Value1}}
 +
::bla bla bla
 +
 +
:{{setup_param|numb|Value2}}
 +
::bla bla bla
  
−
{{todo|linearisierung/Adjust-Modul}}
+
:{{setup_param|time|Date}}
−
{{todo|.Adjust-Parameter}}
+
::bla bla bla

Version vom 14. November 2014, 12:45 Uhr

Module sensor.png


Dieses Modul besitzt die folgenden Parameter:

Icon graph.png Raw

Der Rohwert des von "ReadModule" referenzierten Moduls.
Der Wert des Moduls wird aus dem Rohwert den Adjust-Parametern errechnet.


Icon module.png ReadModule

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


Icon numb.png 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:

Module sensor setup.png


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

Gruppe: Value Setup

Icon time.png History

Gibt die Dauer der zu speichernden History-Fensters an.
Es wird jeweils über den im Parameter Icon time.png 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"


Icon time.png 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.


Icon numb.png Min und Icon numb.png Max

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


Icon alph.png 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)

Icon bool.png 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.


Icon numb.png Min (min. Wert)

Der bisherige Maximal-Wert


Icon numb.png Max (max. Wert)

Der bisherige Minimal-Wert


Icon numb.png Average (Mittelwert)

Der bisherige Durchschnitts-Wert (μ)


Icon numb.png StdDev (Standardabweichung)

Die bisherige Standardabweichung (σ) des Durchschnitts-Wertes


Icon bool.png 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.


Icon bool.png Stable

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


Gruppe: Alert Setup

Icon bool.png AlertStatus

Zeigt den aktuellen Alarmstatus an (aktiv/inaktiv)


Icon alph.png Text (Alarmtext)

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


Icon alph.png 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


Icon time.png Inhibit

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


Icon alph.png AlertId

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


Icon numb.png AlertIdOffset

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


Icon numb.png AlertMin und Icon numb.png AlertMax

Die Alarm-Grenzen für den .Raw-Wert.
Liegt der .Raw-Wert mindestens die Icon time.png Inhibit-Zeit ausserhalb dieser Grenzen, so wird ein Alarm ausgelöst (Vorausgesetzt natürlich Icon bool.png AlertStatus ist aktiviert)


Icon numb.png AlertThreshold und Icon numb.png 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

Icon alph.png 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 Icon module.png 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?!

Icon module.png 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.

Icon numb.png Offset
Absolute Verschiebung des Rohwertes (="d")
Icon numb.png Gain
Verstärkungsfaktor (="k")
TODO: SCAN: diesen und die folgenden parameter bitte beschreiben
Icon alph.png Mode
bla bla bla
Icon numb.png OffsetDrift
bla bla bla
Icon numb.png OffsetOrigin
bla bla bla
Icon numb.png GainDrift
bla bla bla
Icon numb.png GainOrigin
bla bla bla
Icon numb.png Linearization
bla bla bla
x/y werte --> Splines --> ...
Icon numb.png Value1
bla bla bla
Icon numb.png Value2
bla bla bla
Icon time.png Date
bla bla bla
Von „http://wiki.amium.at/wiki/index.php?title=XERO_Modul_ModuleSensor&oldid=348“