XERO Modul ModuleSensor: Unterschied zwischen den Versionen

Aus Amium_Wiki
Wechseln zu: Navigation, Suche
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
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 22: Zeile 22:
 
[[Datei:Module_sensor_setup.png|600px|thumb|none]]
 
[[Datei:Module_sensor_setup.png|600px|thumb|none]]
  
−
Hier können (zusätzlich zu [[XERO_Menüs_Setup|allgemeinen Parametern]]) folgende Einstellungen vorgenommen werden:
+
 
 +
Hier können (zusätzlich zu den [[XERO_Menüs_Setup|allgemeinen Parametern]]) folgende Einstellungen vorgenommen werden:
 +
 
 
==== Gruppe: Value Setup ====
 
==== Gruppe: Value Setup ====
 
{{setup_param|time|History}}
 
{{setup_param|time|History}}
−
:Gibt die Dauer der zu speichernden History-Werte an.
+
:Gibt die Dauer der zu speichernden History-Fensters an.
−
:Es wird alle über den im Parameter {{setup_param|time|Timer}} definierten Zeitinterval ein Messwert gespeichert. Messwerte die älter als hier definiert werden verworfen.
+
:Es wird jeweils über den im Parameter {{setup_param|time|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"
 +
 
  
 
{{setup_param|time|T90}}
 
{{setup_param|time|T90}}
−
:
+
:Messwertfilterung in Sekunden. "0"=keine Filterung.
−
{{todo|SCAN: ...}
+
:Die Angabe von "3" würde z.B. bedeuten, dass der .Raw-Wert jeweils über 3 Sekunden gemittelt wird.
  
−
{{setup_param|time|Min}} und {{setup_param|time|Max}}
 
−
:Wird der Messwert analog dargestellt (Gauge, Bargaph, etc.) so können hier das Minimum und Maximum für die analoge Anzeige definiert werden.
 
  
−
{{setup_param|time|Format}}
+
{{setup_param|numb|Min}} und {{setup_param|numb|Max}}
 +
:Soll der Messwert analog dargestellt werden (Gauge, Bargaph, etc.), können hier das Minimum und Maximum für die analoge Anzeige definiert werden.
 +
 
 +
 
 +
{{setup_param|alph|Format}}
 
:Dient der Formattierung des Digitalwertes.  
 
:Dient der Formattierung des Digitalwertes.  
 
:Wird hier ein einfacher Zahlenwert angegeben, so bedeutet das die Anzahl der Nachkomma-Stellen.
 
:Wird hier ein einfacher Zahlenwert angegeben, so bedeutet das die Anzahl der Nachkomma-Stellen.
−
:Ein vorangestellter "e" erzwingt hingegen eine Ausgabe in Wissenschaftlicher Exponential-Darstellung.
+
: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.
 
: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"
 
:Beispiele für die Formattierung des .Raw-Wertes "123.4567"
Zeile 47: Zeile 58:
 
:*"0000.00" → 0123.46
 
:*"0000.00" → 0123.46
 
:*"####.##" → 123.46
 
:*"####.##" → 123.46
−
Weitere Möglichkeiten zu Formattierung von Zahlenwerten sind [http://msdn.microsoft.com/de-de/library/dwhawy9k(v=vs.110).aspx|hier] zu finden.
+
:*"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.
  
  
  
 +
==== Gruppe: Value Status (Statistics) ====
 +
{{setup_param|bool|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.
  
−
Falls in {{button|Setup}} der Parameter {{setup_param|bool|Statistics}} auf "true" gesetzt wird, sind zusätzlich folgende Parameter verfügbar:
 
  
−
{{setup_param|numb|Min}}
+
{{setup_param|numb|Min (min. Wert)}}
−
:
+
:Der bisherige Maximal-Wert
  
  
−
{{setup_param|numb|Max}}
+
{{setup_param|numb|Max (max. Wert)}}
−
:
+
::Der bisherige Minimal-Wert
 +
 
 +
 
 +
{{setup_param|numb|Average (Mittelwert)}}
 +
::Der bisherige Durchschnitts-Wert (μ)
 +
 
 +
 
 +
{{setup_param|numb|StdDev (Standardabweichung)}}
 +
:Die bisherige Standardabweichung (σ) des Durchschnitts-Wertes
  
  
Zeile 72: Zeile 96:
  
  
−
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}}
 +
:Zeigt den aktuellen Alarmstatus an (aktiv/inaktiv)
 +
 
 +
 
 +
{{setup_param|alph|Text (Alarmtext)}}
 +
:Der Text der bei der Auslösung des Alarms im Modul bzw. der Statuszeile erscheinen soll.
 +
 
 +
 
 +
{{setup_param|alph|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.
 +
 
 +
 
 +
{{setup_param|alph|AlertId}}
 +
:Dieser Parameter wird nur für Host-Systeme verwendet; er dient der Identifikation des Alarms auf dem Host-System
 +
 
 +
 
 +
{{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}}
 +
: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.
 +
 
 +
 
 +
==== 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.:
 +
:*Konzentration: ppb, ppm, Vol%, %, 1/m³, 1/cm³, 1/mm³...
 +
:*Durchluss: l/min, ml/min, g/h, kg/h, ...
 +
:*Temperatur: °C, Kelvin
 +
:*Zeit: h, m, s
 +
:*Gewicht: g, kg
 +
:*Länge: mm, m
 +
:*Spannung: mV, V
 +
:*Strom: uA, mA, A
 +
:*Druck: Pa, mbar, bar
 +
:*Klima: %relF
 +
 
 +
{{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>")
  
−
[[Datei:Module_sensor_adjust.png|600px|thumb|none]]
+
:{{setup_param|alph|Mode}}
 +
::Modus/Art der Justierung: Gas, Cuvette oder XERO
  
 +
:{{setup_param|numb|OffsetDrift}}
 +
::Versatz des Offsets seit der letzten Grundjustierung (Origin)
  
 +
:{{setup_param|numb|OffsetOrigin}}
 +
::Offset der Grundjustierung (Origin)
  
 +
:{{setup_param|numb|GainDrift}}
 +
::Versatz der Verstärkung seit der letzten Grundjustierung (Origin)
  
 +
:{{setup_param|numb|GainOrigin}}
 +
::Verstärkung der Grundjustierung (Origin)
  
 +
:{{setup_param|numb|Linearization}}
 +
::Linearisierung mittels Kennlinie
 +
::Über eine Liste von midestens drei x/y Stützpunkten wird Splineinterpolation gelegt.
  
 +
:{{setup_param|numb|Value1}}
 +
::Sollwert erster Justierpunkt (manuelle Justierung in der XERO)
  
−
Unit
+
:{{setup_param|numb|Value2}}
−
min
+
::Sollwert zweiter Justierpunkt (manuelle Justierung in der XERO)
−
max
+
−
linearisierung
+
−
sollwert
+
  
−
alarmmanagement: soll*rel%+-abs
+
:{{setup_param|time|Date}}
 +
::Datum der letzten Justierung

Aktuelle Version vom 17. November 2014, 09:03 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.:
  • Konzentration: ppb, ppm, Vol%, %, 1/m³, 1/cm³, 1/mm³...
  • Durchluss: l/min, ml/min, g/h, kg/h, ...
  • Temperatur: °C, Kelvin
  • Zeit: h, m, s
  • Gewicht: g, kg
  • Länge: mm, m
  • Spannung: mV, V
  • Strom: uA, mA, A
  • Druck: Pa, mbar, bar
  • Klima: %relF

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")
Icon alph.png Mode
Modus/Art der Justierung: Gas, Cuvette oder XERO
Icon numb.png OffsetDrift
Versatz des Offsets seit der letzten Grundjustierung (Origin)
Icon numb.png OffsetOrigin
Offset der Grundjustierung (Origin)
Icon numb.png GainDrift
Versatz der Verstärkung seit der letzten Grundjustierung (Origin)
Icon numb.png GainOrigin
Verstärkung der Grundjustierung (Origin)
Icon numb.png Linearization
Linearisierung mittels Kennlinie
Über eine Liste von midestens drei x/y Stützpunkten wird Splineinterpolation gelegt.
Icon numb.png Value1
Sollwert erster Justierpunkt (manuelle Justierung in der XERO)
Icon numb.png Value2
Sollwert zweiter Justierpunkt (manuelle Justierung in der XERO)
Icon time.png Date
Datum der letzten Justierung
Von „http://wiki.amium.at/wiki/index.php?title=XERO_Modul_ModuleSensor&oldid=352“