XERO Modul ModuleSensor: Unterschied zwischen den Versionen

Aus Amium_Wiki
Wechseln zu: Navigation, Suche
Zeile 99: Zeile 99:
  
  
{{setup_param|text|Text (Alarmtext)}}
+
{{setup_param|alph|Text (Alarmtext)}}
 
:Der Text der bei der Auslösung des Alarms im Modul bzw. der Statuszeile erscheinen soll.
 
:Der Text der bei der Auslösung des Alarms im Modul bzw. der Statuszeile erscheinen soll.
  
  
{{setup_param|text|Behaviour}}
+
{{setup_param|alph|Behaviour}}
 
:Einstellung des Alarmverhaltens
 
:Einstellung des Alarmverhaltens
 
:*Aus → Alarme/Warnungen werden ignoriert
 
:*Aus → Alarme/Warnungen werden ignoriert
Zeile 119: Zeile 119:
  
  
{{setup_param|text|AlertId}}
+
{{setup_param|alph|AlertId}}
 
:Identifikation des Alarms (um bei mehreren Alarmen eine eindeutige Zuordnung treffen zu können)
 
:Identifikation des Alarms (um bei mehreren Alarmen eine eindeutige Zuordnung treffen zu können)
  

Version vom 14. November 2014, 10:16 Uhr

Module sensor.png


Dieses Modul besitzt die folgenden Parameter:

Icon graph.png Raw

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


Icon module.png ReadModule

Die Quelle (=Referenzmodul) als Basiswerts für das Moduls.
Verknüpft mit den Adjust-Parametern wird daraus der Raw-Wert des ModuleSensors.


Icon numb.png Set

Der Ziel- oder Target-Wert des Moduls.


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

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

Aktivierung/Deaktivierung der Alarmbehandlunf für dieses Modul


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

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


Icon numb.png AlertOffset

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.


TODO: linearisierung/Adjust-Modul
TODO: .Adjust-Parameter