XERO Arena Example01

Aus Amium_Wiki
Wechseln zu: Navigation, Suche

Information: die folgenden Screenshots sind mit einer aktuellen Entwicklerversion der XERO erstellt worden.

Es sind daher einige Bedienlemente geringfügig anders dargestellt - der Ablauf bzw. die Funktion sind jedoch unverändert!


Ein einfacher Temperatursensor

Ziel: Kennenlernen der Bedienung und Konzepte der XERO in einem "Step-by-Step" Beispiel!


Programstart

Nach dem Start (Xero.exe) wird der Arena-Auswahl Dialog angezeigt:

Xero example01 selectarena.png

Befindet sich (noch) keine Arena in .\Config\, wird der Ordner angelegt und die XERO im Design-Modus gestartet.

(zuvor sind mehrere Dialoge zu bestätigen)

Befindet sich genau eine Arena in .\Config\, so wird der Dialog nur kurz angezeigt und dann diese Arena umgehend geladen.

Sind mehrere Arenas vorhanden, so muss die zu ladende Arena mit einem Klick (bzw. Enter) ausgewählt werden. (Die zuletzt verwendete Arena ist vorselektiert)


Nach dem Laden der ausgewählten Arena befindet man sich am Startschirm (siehe Bedienoberfläche):

Xero example01 startscreen.png

Mit der Taste Schema wird nun in den Design-Modus gewechselt, um Module hinzuzufügen bzw. zu bearbeiten. Erkennbar ist dieser Modus am karierten Hintergrund und den Ankern an den Modulen (siehe weiter unten)

Um ein neues Modul hinzuzfügen, wird mit der Maus an der gewünschten Position ein Rahmen in der beliebiger Grösse aufgezogen.

(Position und Grösse können später jederzeit verändert werden)


Xero example01 addmodule.png

Nun wird der Modul-Auswahl-Dialog angezeigt:

Xero example01 selectmodule.png

Hier sind (nach Kategorien gruppiert) alle verfügbaren Module gelistet. Im Beispiel hier wählen wir aus der Gruppe "Schema" das Modul "ModuleSensor" aus.

Die allermeisten Module erfordern nun die Angabe einiger wichtiger Parameter - das Modul "ModuleSensor" zeigt z.B. Den folgenden Dialog an:

Xero example01 selectmodule parameters.png

Um fortfahren zu können müssen eine oder mehrere Parameter ausgefüllt werden - erst dann wird der OK angezeigt. In unserem Beipiel geben wir an, dass

  • das "ReadModule" (also das Modul welches den Rohwert liefert) "AK_1_3" heisst (das könnte z.B. den Wert einer AK-Quelle "AK_1" mit Offset 3 bedeuten);
  • der Maximalwert des Sensors "250" sein soll und
  • der Sensor einen Wert mit der Einheit (Unit) "°C" anzeigen soll.
  • Sein Name wird mit "T_1" festgelegt.

Nach Bestätigen mit OK wird das neue Modul zum Schema hinzugefügt. (über die Taste Cancel kann der Vorgang jederzeit abgebrochen werden und es wird kein neues Modul hinzugefügt)

Module können in ihrer Position und Grösse jederzeit verändert werden:

  • Position: Click-and-Drag im "freien" Bereich auf dem Modul
  • Grösse: Click-and-Drag auf dem "Size-Anchor" rechts unten


Xero example01 moduleanchors.png

Wir haben oben als Quelle für den Sensor T_1 das Modul AK_1_3 angegeben. Da es dieses Modul (noch) nicht gibt, zeigt T_1 auch keinen Wert an ('#' ist bei XERO das Symbol für kein bzw. undefinierter Wert)

Da angenommen wird, dass beim Abarbeiten dieses Tutorials kein physikalischer Sensor zur Verfügung steht um Messwerte einzulesen, werden wir einen Rohwert simulieren. Eine einfache Möglichkeit hierzu ist die Verwendung eines Counters.

Dazu fügen wir ein Modul Counter ein (Timer→Counter) und geben ihm den Namen "AK_1_3".


Um nun ein Modul detaillierter konfigurieren zu können, muss man den Designmodus durch abermaliges Betätigen der Taste Schema wieder verlassen.

Klickt man nun bei einem Modul auf das Symbol im linken Bereich,


Xero example01 moduleclicksymbol.png

kann man das betreffende Modul im Detail konfigurieren - es öffnet sich folgender Dialog:

Xero example01 moduleconfiguration.png

Um den Zähler zu starten, müssen wir ihm einen Startwert zuweisen: dazu klicken wir in das grüne Status-Fenster oben und geben in dem sich öffnenden Numerischen Eingabedialog den Wert "1" ein:

Xero example01 numberdialog.png

Nach der Bestätigung mit "Enter" bzw. "OK" beginnt der Zähler zu laufen. In ein-Sekunden-Intervallen von 0 bis 100.

Wir wollen für unser Beispiel einen Sensor simulieren, welcher Temperaturen in 1/10 Kelvin in einem Bereich von ca. 30-220°C liefert. Dazu müssen wir das Modul weiter konfigurieren.

Sehen wir uns dazu den Modul-Konfigurations-Dialog genauer an:

Xero example01 moduleconfiguration2.png

Der Dialog ist aufgeteilt in

  • den Statusbereich (oben)
  • den Hauptbereich (mitte)
  • den Parameter-Bereich (unten; weitere Parameter können auch rechts angezeigt werden - siehe unten)
  • den Steuerungs-Bereich (die Tasten ganz rechts)

Die Parameter, die allen Modulen gemeinsam sind, sind über die Taste Setup erreichbar (Hauptparameter):

Xero example01 moduleconfiguration setup.png

INFO: Die Bedeutung dieser Parameter ist in Setup beschrieben!

Konfigurieren wir das Modul nun folgendermassen - jeweils mit Klick auf den betreffenden Parameter:

  • .Min = 3000
  • .Max = 5000
  • .Timer = 0.2s

Und nach dem Zurückwechseln in das Schema dieses Moduls (Vorlage:ButtonSchema) ändern wir noch den Parameter

  • .Increment = 11.3

(im Parameter-Bereich unten)

Somit zählt unser Zähler nun von 3000 bis 5000. Und zwar alle 0.2 Sekunden um einen Wert von 11.3. (Hintergrund: der Zähler simuliert somit einen Temperatur-Sensor mit Werten zwischen 28 und 228°C in 1/10 Kelvin Auflösung; das Ganze mit einer linearen Rampe von 11.3/10 Kelvin pro 0.2 Sekunden)

Danach schließen wir den Modul-Konfigurationsdialog.

Nun sollte unser ModuleSensor "T_1" statt dem "#" einen Wert anzeigen. (ACHTUNG: es kann mehrere Sekunden dauern bis der Wert das erste Mal angezeigt wird)


Nun müssen wir das Temperatur-Modul "T_1" so konfigurieren, dass der Wert des (simulierten) Sensors vernünftig (richtig) dargestellt wird - dazu klicken wir in den Symbol-Bereich des ModulSensors "T_1":

Xero example01 moduleclicksymbol2.png

- es öffnet sich folgender Dialog:


Xero example01 moduleconfiguration t1.png

Oben in der Statuszeile wird (statt dem Gesamt-System-Status) nun der Status dieses einen Moduls angezeigt. In diesem Beispiel ist am Modul selbst (wie auch im Modul-Konfigurations-Dialog oben) zusätzlich das Symbol "(OR)" (kleiner Kreis mit violettem Hintergrund) dargestellt. "OR" bedeutet z.B. "Over-Range", d.h. der aktuelle Modulwert (3780) ist höher als der als ".Max" definierte (250)...

Im Hauptbereich des Modul-Dialogs befindet sich ein Chart. Jedes Modul speichert seine Messwerte für eine im Parameter ".History" definierte Zeit. Der Messwert-Verlauf wird in diesem Chart dargestellt.

Unterhalb bzw. rechts davon sind einige "Interne" (Sub-)Module dieses Moduls dargestellt (in diesem Fall: ".Command", ".Set", ".Raw" und ".ReadModule"). Bei manchen (komplexeren) Modulen sind hier weitere Sub-Module vorhanden. Diese können sich auch im Hauptbereich befinden.

In der XERO ist alles aus Modulen modelliert. Ein Modul ist gleichzeitig auch die kleinste Einheit. Das einfachste Modul ist das Modul "Sensor" (in der Gruppe "Register").

Komplexere Module bestehen aus vielen Modulen die jeweils selbst wieder aus Modulen bestehen. Dieses komplexere Modul kann dann verwendet werden um wiederum komplexere Module zu bilden.

Und: eine Gruppe von - mehr oder weniger komplexen - Modulen bildet eine Arena (=Schema).


Der Aufbau des Moduls "Sensor"

Praktisch jedes Xero Modul ist eine Erweiterung des Basis-Moduls Sensor.

Schauen wir uns deshalb dieses Modul genauer an:

Wir fügen also zum Schema das Modul Sensor mit Namen "S_1" hinzu (Register&arr;Sensor), verlassen anschliessend den Designmodus und klicken links auf das Symbol des eingefügten Sensors - es öffnet sich der Konfigurations-Dialog des "Sensors":


Xero example01 moduleconfiguration s1.png

Man sieht, dass der Sensor folgende Parameter (bzw. Sub-Module) enthält:

  • .Raw --> der Rohwert
  • .Set --> der Ziel- oder Target-Wert, wird verwendet
  • als Führungsgrösse bei Regler (Sollwert)
  • zur Berechnung von Alarmgrenzen
  • bei Visualisierungen (Gauges, etc.)
  • .Chart --> ein Spezial-Modul zur Anzeige der Messwert-Historie

Zusäzlich dazu enthält noch jedes Minimal-Modul ("Sensor") die folgenden Parameter die ersichtlich sind, wenn man auf Setup klickt:


Xero example01 moduleconfiguration s1 setup.png

Die Bedeutung dieser Parameter ist in [...setup...] beschrieben!


...zurück zum ModuleSensor "T_1": Dieses besitzt (wie weiter oben ersichtlich) zusätzlich zu den Minimal-Parametern des Moduls "Sensor" die beiden Parameter:

  • .Command --> wird für allgemeine Funktionssteuerung benutzt. Ist für dieses Beispiel nicht relevant!
  • .ReadValue --> das Modul, von dem der ".Raw" Wert dieses Moduls bezogen/gelesen wird.

Bei den meisten Modulen empfiehlt sich die Konfiguration von zumindest den folgenden Modul-Parametern:

  • .Unit

die angezeigte Einheit

Wird auch zum automatischen Umrechnen verwendent. z.B. von [ppm] in [%] oder von [°C] in [K]

°C

  • .Adjust

unter der Annahme, dass unser Module von welchem der Roh-Wert bezogen wird (AK_1_3) die Temperatur in 1/10° und in Kelvin liefert, müssen wir den Rohwert umrechnen, also:

°C = .Raw / 10 - 273.15

dazu:

.Adjust.Gain = 0.1

.Adjust.Offset = -273.15

  • .Format

wir wollen den Wert mit einer Kommastelle anzeigen - also:

.Format = #.0

  • .Type (Appearance-Type)

Der Sensor soll mit einem Temperatur-Symbol statt dem Standard-Symbol dargestellt werden:

.Type = TI

  • Alert: Falls der Wert 200°C um mehr als 20 sec überrschreitet, soll ein Alarm ausgelöst werden:

.Alert-Max = 200

.Inhibit = 20s

  • .Label

.Label = Temp Pumpe


Nachdem alle diese Parameter gesetzt wurden, schaut unser Modul-Dialog wie folgt aus:


Xero example01 moduleconfiguration t1 setup.png

…und das Modul auf dem Haupt-Schema so:


Xero example01 module t1.png

Somit zeigt unser ModuleSensor "T_1" nun den (simulierten) Sensorwert "AK_1_3" korrekt in °C an.