XERO Arena Example01

Aus Amium_Wiki
Version vom 1. Dezember 2014, 20:24 Uhr von Han (Diskussion | Beiträge)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

Information: die folgenden Screenshots sind mit einer aktuellen Entwicklerversion der XERO erstellt worden. Es sind daher einige Bedienlemente eventuell anders dargestellt - der Ablauf bzw. die Funktion sind jedoch unverändert!

Ein einfacher Temperatursensor

Ziel: Kennenlernen der grundsätzlichen 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 umgehend diese Arena 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 Benutzeroberfläche]:

Xero example01 startscreen.png

Mittels 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 unten)

Um ein neues Modul hinzuzfügen, wird mit der Maus an der gewünschten Position ein Rahmen in der gewünschten Grösse aufgezogen.�(Die Position und Grösse kann später natürlich 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. Im Beipiel hier wird angegeben, dass das "ReadModule" (also das Modul welches den Rohwert liefert) "AK_1_3" heisst; 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 nicht gibt, zeigt T_1 auch keinen Wert an ('#' ist bei XERO das Symbol für kein oder 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-200°C liefert. Dazu müssen wir das Modul detaillierter konfigurieren.�Sehen wir und deshalb 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)

Alle 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!

Wir konfigurieren wir das Modul nun folgendermassen - jeweils mit Klick auf den betreffenden Parameter: • .Min = 3000 • .Max = 5000 • .Timer = 0.2s

Und nach dem Schliessen des Haupparameter-Dialogs ändern wir noch den Parameter • .Increment = 11.3 im Modul-Dialog 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 also einen Temperatur-Sensor mit Werten zwischen von 28 bis 228°C in 1/10 Kelvin; 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)


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

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) ist zusätzlich das Symbol "(OL)" (kleiner Kreis mit violettem Hintergrund) dargestellt. "OR" bedeutet z.B. "Over-Range", d.h. der aktuelle Modulwert (1813) 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 in ".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 mehr 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. Oder anders Ausgedrückt: eine Menge/Gruppe von "Sensor" Modulen bildet ein neues Modul. Dieses komplexere Modul kann wieder Verwendet werden um wiederum komplexere Module zu bilden. Und: eine Gruppe von - mehr oder weniger komplexen - Modulen bildet eine Arena (=Schema)


Der Aufbau des Minimal-Moduls "Sensor"

Fügt man zu einem Schema das Modul "Sensor" hinzu (Register-->Sensor), verlässt anschliessend den Designmodus und klickt links auf das Symbol des eingefügten Sensors, so öffnet sich der Konfigurations-Dialog des "Sensors":


Xero example01 moduleconfiguration s1.png

Man sieht, dass der Sensor folgende Parameter (=Sub-Module) enthält: • .Raw --> der Rohwert • .Set --> der Ziel- oder Target-Wert, wird verwendet�Führungsgrösse bei Regler (Sollwert) 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.