Ereigniszähler Modul

Beschreibung

Das "eventcounter" Modul bietet die Funktionalität die Zeitreihen von numerischen und booleschen Kanäle auszuwerten. Es können für einen Eingangskanal vom Benutzer ein oder mehrere Zähler definiert werden, die anhand von einem Ereignistypen und weiteren Parameter, folgende Ereignis zählen kann:

• Über/Unterschreitung eines Grenzwertes bei numerischen Kanälen
• Für boolesche Kanäle die Anzahl der Übergänge Low nach High, High nach Low oder Beides

Schnittstellen

• smartCORE Kanäle
• RPC Callbacks(für das "opticloud"-Modul)

JSON-Konfiguration

Im folgenden Abschnitt werden Beispiele für Konfigurationen zum Definieren von eigenen Zählern gelistet.

Beispielkonfiguration(minimal)

Eine minimale Konfiguration besteht nur aus der Angabe welche Eingangskanäle von einem Zähler ausgewertet werden soll.

{
  "module": "eventcounter",
  "factory": "eventcounter",
  "config": {
    "channels": [
      {
        "inputChannel": "Producer.BooleanChannel"
      },
      {
        "inputChannel": "Producer.DoubleChannel"
      },
      {
        "inputChannel": "Producer.IntChannel"
      },
      ...
    ]
  }
}

Beispielkonfiguration(maximal)

{
  "module": "eventcounter",
  "factory": "eventcounter",
  "config": {
    "pollingInterval": 1000,
    "channels": [
      {
        "inputChannel": "Producer.FloatChannel",
        "outputChannel": "Events.MyCounter",
        "threshold": 13.5,
        "eventType": "Falling",
        "enableStartTimeChannel": true
      },
      ...
    ]
  }
}

Parameterliste

Globale Parameter

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
channels	Ja	Array[Zähler]	-	-	Liste von Definitionen aller Ereigniszähler. Siehe weiter unten.
pollingInterval	Nein	Number	[100 - 10000 ]	500	Konstantes Zeitintervall(ms), nachdem die Zähler den zugewiesenen Eingangskanal nach verfügbaren Werten abfragen.

Zählerstruktur

Allgemeine Zählerparameter

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
inputChannel	Ja	String	Any	-	Eingangskanal für den Ereigniszähler.
outputChannel	Nein	String	Any	*	Name des Zählerkanals aus dem der letzte Zählerwert gelesen werden kann.
eventType	Nein	String Enum	["Rising","Falling","Both"]	"Rising"	Eventtyp nach dem der Zähler die Zeitreihe auswertet.
enableStartTimeChannel	Nein	Bool	-	false	Auf true setzen, um die Produktion von Zeitstempeln** zu aktivieren, die auf den letzten Zählerneustart hinweisen.

*Bei Nichtangabe wird für den Ausgangskanal ein Name nach folgenden Muster gebildet: {inputChannel}.{eventType}Counter
**Der Zeitstempel gibt die Nanosekunden seit der UNIX-Epoche an. Der Name eines Zeitstempelkanals wird wie folgt gebildet: {outputChannel}.LastStartTime

Parameter für numerische Kanäle

Es folgt eine Liste von Parameter, die für numerische Eingangskanäle ausgewertet werden.

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
threshold	Nein	Number	Any	0	Numerischer Schwellenwert für die Erkennung der Schwellenwertüberschreitung.

Anmerkung zur optiCLOUD Konfiguration

Im folgenden Abschnitt werden zusätzliche Hinweise zur Konfiguration und Nutzung des "opticloud"-Moduls in Verbindung mit diesem Modul aufgeführt.

optiCLOUD Kanal Konfiguration

Folgende Konfiguration wird für die Übertragung der Zähler- und Zeitstempelkanäle empfohlen:

{
  "module": "opticloud_eventcounter_example",
  "factory": "opticloud",
  "config": {
    "channels": [
      {
        "messageType": "telemetry",
        "name": "*Counter"
      },
      {
        "messageType": "clientAttribute",
        "name": "Events.*.LastStartTime"
      }
    ],
    ...
  }
}

RPC Callbacks

Referenz für die verfügbaren RPC Callbacks:

Name	Instanzfunktion?	Payload Beispiel	Beschreibung
reset	Ja	{"counter":"producer1.signal.Counter"}	Setzt den Zähler mit dem Ausangskanal producer1.signal.Counter auf 0 zurück*
set	Ja	{"counter":"producer1.signal.Counter", "value": 300}	Setzt den Zähler mit dem Ausangskanal producer1.signal.Counter auf 300*

*Wahlweise können auch alle Zähler mit "counter":".*" gesetzt bzw. zurückgesetzt werden.

Modul-Informationen

Information	Wert
Autoren	optiMEAS Measurement and Automation Systems GmbH
seit smartCORE	2.5
Modultyp	Consumer
Abhängigkeiten	KEINE