Anleitung zur Anpassung der Benutzeroberfläche - ABL Sursum

LOMD112/LOMD212 – Anleitung zur Anpassung der Benutzeroberfläche
Anleitung zur Anpassung der Benutzeroberfläche
Allgemeines
Das Touchdisplay LOMDx12 wird mit einer Demosoftware und dem zugehörigen Source-Code
ausgeliefert, die eine erste Inbetriebnahme ermöglicht.
Die Anpassung der Demosoftware an die eigenen Anforderungen kann auf zwei Arten erfolgen:
1.) Wenn die Funktionalität der Demosoftware ausreicht, kann die optische Erscheinung durch die einfache
Änderung verschiedener Konfigurations- und Bilddateien angepasst werden.
2.) Zusätzliche Funktionen können durch Änderung des Source-Code im EigerScript realisiert werden (hierzu sind
jedoch erhebliche Programmierkenntnisse erforderlich).
Das Programm ist in mehrere Seiten, so genannte Views aufgeteilt. Jedem View sind bestimmte Funktionen und
Bilder zugeordnet.
View Funktion
1 Erster View nach einem Reset.
Hier werden die Grundkonfigurationen eingelesen und die Hauptfunktionen initialisiert.
Wenn über die serielle RS232-Schnittstelle Dateien übertragen werden sollen, so muss das Programm
in dieser View mit dem Button angehalten werden (siehe auch Dokument 03 0019 01).
2 Anlagenübersicht anzeigen.
Es können Datum/Uhrzeit, die angeschlossenen LOMOcompakt und die höchste Alarmmeldung
angezeigt so wie die Sprache umgeschaltet werden.
3 Datum und Zeit senden.
10 Kopiervorlage für die Views 11…26. Wird nicht angezeigt und sollte nicht verändert werden.
11…26 Statusanzeige für eine LOMOcompact.
Jeder View ist eine feste LOMO-Nr. zugeordnet.
View 11 Nr. 01, View 12 Nr. 02 usw.
Es können die beiden Bezeichnungstexte, der Status der digitalen Ein- und Ausgänge, die
Spannungswerte der analogen Eingänge, die Werte eines Timers und eines Zählers so wie die
Meldungen der LOMO 852 und der angeschlossenen LOMO 552 angezeigt werden.
Die Konfigurationsdatei „config.ini“
Diese Datei liegt auf der CF-Karte im Verzeichnis „.\LOMO“. Es handelt sich um eine reine ASCII-Datei die in
jedem beliebigen Texteditor bearbeitet werden kann.
Der Dateiinhalt muss zwingend folgende Form aufweisen:
LOMD112.nn,s,bbb,uuu,tttttttttttttttt.
nn: Displaynummer (01…16)
s: Sprache (0 = 1.Sprache (Deutsch), 1 = 2.Sprache (Englisch), 2 = 3.Sprache (frei), 3 = 4.Sprache (frei))
bbb: Zeit in Sekunden bis zur Beleuchtungsabschaltung in View 2 (000 = keine Abschaltung)
uuu: Zeit in Sekunden bis zur Umschaltung auf View 2 aus anderen Views (000 = keine Umschaltung)
t: Klartext mit bis zu 16 Zeichen zur Anlagenbeschreibung (wird in View 2 angezeigt)
Die Sprachdatei „LANGUAGE.CSV“
Diese Datei liegt auf der CF-Karte im Verzeichnis „.\LOMO“. Es handelt sich um eine ASCII-Tabellen-Datei die in
jedem beliebigen Texteditor oder komfortabler in einen geeigneten Tabellenprogramm (z.B. Microsoft Excel)
bearbeitet werden kann.
Die Datei besteht aus 4 Spalten die durch ein Semikolon getrennt sind. Die Spalten sind den Sprachen aus der
Konfigurationsdatei zugewiesen. Im Moment sind darin nur die Wochentage und Fehler für die Datumsanzeige in
View 2 enthalten.
Seite 1
Dok. Nr. 05 0012 01_A

LOMD112/LOMD212 – Anleitung zur Anpassung der Benutzeroberfläche
Die Meldungsdatei „MSG.CSV“
Diese Datei liegt auf der CF-Karte im Verzeichnis „.\LOMO“. Es handelt sich um eine ASCII-Tabellen-Datei die in
jedem beliebigen Texteditor oder komfortabler in einen geeigneten Tabellenprogramm (z.B. Microsoft Excel)
bearbeitet werden kann.
Die Datei besteht aus 4 Spalten die durch ein Semikolon getrennt sind. Die Spalten sind den Sprachen aus der
Konfigurationsdatei zugewiesen. Die Zeilennummer stellt die Meldungsnummer dar. Sendet die LOMOcompact
z.B. die Meldungsnummer 152, so wird in der Alarmanzeige in View 2 der Text aus Zeile 152 (in der
ausgewählten Sprache) angezeigt.
Die Anzeigedatei „V02_EGI.CSV“ und Bilddateien für View 2
Diese Dateien liegen auf der CF-Karte im Verzeichnis „.\LOMO\V02_EGI“.
Die Anzeigedatei ist eine ASCII-Tabellen-Datei die in jedem beliebigen Texteditor oder komfortabler in einen
geeigneten Tabellenprogramm (z.B. Microsoft Excel) bearbeitet werden kann. Die Datei besteht aus 6 Spalten die
durch ein Semikolon getrennt sind. Die Zeilen sind verschiedenen Objekten (Bild und/oder Funktion) zugeordnet.
Die Spalten haben folgende Bedeutung:
NAME: Bezeichnung des Objekts. Diese Spalte sollte nicht geändert werden.
X: X-Position der oberen linken Ecke des Objekts
Y: Y-Position der oberen linken Ecke des Objekts
W: Breite des Objekts (sollte mit der Breite des Bildes überein stimmen)
H: Höhe des Objekts (sollte mit der Höhe des Bildes überein stimmen)
TYP: Die meisten Objekte kennen nur 2 Typen: 0 = nicht anzeigen; 1 = anzeigen
Die Bilddateien müssen mit dem Programm „EigerGraphicSuite“ erstellt werden.
Zuordnung von Name, Bilddatei und Funktion
Name Bilddatei Funktion
V02BG V02BG.egi Hintergrundbild; Typ = 0 -> hellgrauer Hintergrund.
L01…L16
F01…F04
V02L01_0.egi
…
V02L16_0.egi
V02F01_0.egi
…
V02F01_0.egi
Bild der entsprechenden LOMOcompact (01 – 16) .
Umschaltung in zugehörigen View (11…26).
Je nach Modulstatus wird das Bild mit einem farbigen Rahmen angezeigt:
Weiß -> Modul nicht erkannt
Grün -> Modul erkannt, keine Meldungen vorhanden
Gelb -> Modul erkannt, Info-Meldungen vorhanden
Rot -> Modul erkannt, Alarm-Meldungen oder Fehler vorhanden
Bild für die entsprechende Sprache, Sprachumschaltung.
In der Demo nur Sprache 1 (Deutsch) und 2 (Englisch) aktiviert.
F05…F14 ----- Keine Bilder und keine Funktion.
F15 ----- Kein Bild, Datums- und Uhrzeitanzeige, Umschalten in View 3.
Typ = 1 -> große Schrift, Typ = 2 -> kleine Schrift.
F16 ----- Kein Bild, Alarmanzeige, Löschen der Alarmmeldung.
Es werden die Meldungen der LOMOcompact angezeigt, die die höchste Alarm-ID
sendet. Die Alarmanzeige bleibt so lange aktiv, bis sie quittiert wird.
Ist keine Alarmmeldung vorhanden, so wird ein graues Rechteck angezeigt.
Die Höhe (H) ist intern auf 87 festgelegt!
Achten Sie bei der Breite (W) darauf, dass die längste Meldung angezeigt werden
kann.
Seite 2
Dok. Nr. 05 0012 01_A

LOMD112/LOMD212 – Anleitung zur Anpassung der Benutzeroberfläche
Die Anzeige- und Bilddateien für die Views 11 bis 26
Die Dateien für die Views 11 bis 26 sind identisch aufgebaut. Im Folgenden wird Beispielhaft View 11
(LOMOcompact 01) erläutert, für die Views 12 bis 26 gilt dies sinngemäß.
Die Anzeige- („V11_EGI.CSV“) und Bilddateien liegen auf der CF-Karte im zugehörigen Verzeichnis
„.\LOMO\V11_EGI“.
Die Anzeigedatei hat die gleiche Struktur wie die für View 2.
Für jeden digitalen Status werden 3 Bilder benötigt:
*NO.egi -> Modul nicht aktiv
*OF.egi -> Signalstatus ist aus (low bzw. 0)
*ON.egi -> Signalstatus ist ein (high bzw. 1)
Je nach Modul-/Signalstatus wird das entsprechende Bild angezeigt.
Bei den reinen Textanzeigen (kein Bild) gilt:
- Je nach Höhe (H) wird der Text mit unterschiedlichen Schriftgrößen angezeigt.
- Ist das Modul nicht aktiv, so wird der Text dunkelgrau auf hellgrauem Hintergrund dargestellt.
- Ist das Modul aktiv, so wird der Text schwarz auf weißem Hintergrund dargestellt.
Zuordnung von Name, Bilddatei und Funktion
Name Bilddatei Funktion
V11BG V11BG.egi Hintergrundbild; Typ = 0 -> hellgrauer Hintergrund.
BZ1, BZ2 ----- Keine Bilder, Bezeichner 1 und 2 der LOMOcompact.
A01…A05
V11A01xx.egi
…
V11A05xx.egi
Bilder für digitale Ausgänge (1..5) des Master-Moduls (LOMO 852).
LED V11LEDxx.egi Bilder für die rote LED des Master-Moduls (LOMO 852).
A11…A15
A21…A25
E01…E08
E11…E15
E21…E25
V11A11xx.egi
…
V11A15xx.egi
V11A21xx.egi
…
V11A25xx.egi
V11E01xx.egi
…
V11E08xx.egi
V11E11xx.egi
…
V11E15xx.egi
V11E21xx.egi
…
V11E25xx.egi
Bilder für digitale Ausgänge (1..5) des Slave-Moduls 1 (LOMO 552).
Bilder für digitale Ausgänge (1..5) des Slave-Moduls 2 (LOMO 552).
Bilder für digitale Eingänge (1..8) des Master-Moduls (LOMO 852).
Bilder für digitale Eingänge (1..5) des Slave-Moduls 1 (LOMO 552).
Bilder für digitale Eingänge (1..5) des Slave-Moduls 2 (LOMO 552).
V01, V02 ----- Keine Bilder, Spannungsanzeige mit 3 Nachkommastellen für analoge Eingänge
(1..2) des Master-Moduls (LOMO 852).
V11, V12 ----- Keine Bilder, Spannungsanzeige mit 3 Nachkommastellen für analoge Eingänge
(1..2) des Slave -Moduls 1 (LOMO 552).
V21, V22 ----- Keine Bilder, Spannungsanzeige mit 3 Nachkommastellen für analoge Eingänge
(1..2) des Slave -Moduls 2 (LOMO 552).
TIM ----- Keine Bilder, Anzeige des Timerwertes.
Über den Typ (1…16) wird die Timernummer (0…15) festgelegt.
CNT ----- Keine Bilder, Anzeige des Zählerwertes.
Über den Typ (1…8) wird die Zählernummer (0…7) festgelegt.
Seite 3
Dok. Nr. 05 0012 01_A

LOMD112/LOMD212 – Anleitung zur Anpassung der Benutzeroberfläche
MSG ----- Kein Bild, Meldungsanzeige.
Es werden die Meldungen der LOMOcompact angezeigt.
keine Meldung -> graues Rechteck
Info-Meldungen -> gelber Rahmen
Alarm-Meldung -> roter Rahmen
Die Höhe (H) ist intern auf 87 festgelegt!
Achten Sie bei der Breite (W) darauf, dass die längste Meldung angezeigt werden
kann.
Seite 4
Dok. Nr. 05 0012 01_A

LOMD112/LOMD212 – Manual on customizing the user interface
Manual on customizing the user interface
Basic Information
The touch screen LOMDx12 is delivered with a demo software and the associated source code, which allows firsttime
operation.
The adaptation of the demo software to your own needs can be done in two ways:
1.) If the functionality of the demo software is sufficient, the visual appearance may be adjusted by simply
changing various configuration and image files.
2.) Additional functions can be realized by changing the source code in the EigerScript (for this, however,
considerable programming skills are required).
The program is divided into several pages, so-called Views. Each View is assigned to certain functions and
images.
View Function
1 First View after a reset.
Here the basic configurations are read and the main functions are initialized.
When files are transferred via the serial RS232 interface, the program must be stopped in this View by
clicking the button (see also document 03 0019 01).
2 Show system overview.
Date / time, the connected LOMOcompacts and the highest alarm message can be displayed as the
language changed.
3 Send date and time.
10 Template for the Views 11 to 26. Is not displayed and should not be changed.
11…26 Status display for a LOMOcompakt.
Each view is assigned to a fixed LOMO number.
View 11 No. 01, View 12 No. 02 etc.
The two description texts, the status of the digital inputs and outputs, the voltage of the analogue
inputs, the values of a timer and a counter as the messages of the connected LOMO 852 and LOMO
552 can be displayed.
The configurations file “config.ini”
This file is stored on the CF card in the directory “.\LOMO”. It is a plain ASCII file that can be edited in any text
editor.
The file contents must necessarily have the form:
LOMD112.nn,s,bbb,uuu,tttttttttttttttt.
nn: Number of the display (01…16)
s: Language (0 = 1.Language (German), 1 = 2.Language (English), 2 = 3.Language (unused),
3 = 4.Language (unused))
bbb: Time in seconds until the light off in View 2 (000 = no light off)
uuu: Time in seconds before switching to View 2 from other Views (000 = no switching)
t: Plain text with up to 16 characters of the system description (will be shown in View 2)
The languages file “LANGUAGE.CSV”
This file is stored on the CF card in the directory “.\LOMO”. It is an ASCII table file that can be edited in any text
editor or comfortable in a suitable spreadsheet program (e.g. Microsoft Excel).
The file consists of four columns which are separated by a semicolon. The columns are assigned to the
languages in the configuration file. At the moment only the weekdays and error for the date display in View 2 are
contained therein.
Page 5
Doc. No. 05 0012 01_A

LOMD112/LOMD212 – Manual on customizing the user interface
The messages file “MSG.CSV”
This file is stored on the CF card in the directory “.\LOMO”. It is an ASCII table file that can be edited in any text
editor or comfortable in a suitable spreadsheet program (e.g. Microsoft Excel).
The file consists of four columns which are separated by a semicolon. The columns are assigned to the
languages in the configuration file. The line number represents the message number.
For Example: If the LOMOcompact transmits the message number 152, the text from line 152 (in the selected
language) appears in the alarm display.
The display file “V02_EGI.CSV” and the image files for View 2
These files are stored on the CF card in the directory “.\LOMO\V02_EGI”.
The display file is an ASCII table file that can be edited in any text editor or comfortable in a suitable spreadsheet
program (e.g. Microsoft Excel). The file consists of six columns which are separated by a semicolon. The lines
are associated with different objects (picture and/or function). The columns have the following meaning:
NAME: Description of the object. This column should not be changed.
X: X-position of the upper left corner of the object
Y: Y-position of the upper left corner of the object
W: Width of the object (should match the width of the image)
H: Height of the object (should match the height of the image)
TYP: Most objects have only two types: 0 = do not show; 1 = show
The image files must be created using the "EigerGraphicSuite".
Assignment of name, image file and function
Name Image file Function
V02BG V02BG.egi Background image; “Typ” = 0 -> light gray background.
L01…L16
F01…F04
V02L01_0.egi
…
V02L16_0.egi
V02F01_0.egi
…
V02F01_0.egi
F05…F14 ----- No images and no function.
Image of the corresponding LOMOcompact (01 – 16).
Change to corresponding View (11…26).
Depending on the module status, the image is displayed with a colored frame:
White -> Module not detected
Green -> Module detected, no messages present
Yellow -> Module detected, Info messages present
Red -> Module detected, Alarm messages or error present
Image for the corresponding language, language change.
In the demo, only languages 1 (German) and 2 (English) are enabled.
F15 ----- No image, date and time display, Switch to View 3
“Typ” = 1 -> large font, “Typ” = 2 -> small font.
F16 ----- No image, alarm display, Deleting the alarm message.
The messages of the LOMOcompact which transmits the highest alarm ID are
displayed. The alarm display will remain active until it is acknowledged.
If no alarm is present, a gray box is shown.
The height (H) is internally fixed at 87!
Make sure when choosing the width (W) that the longest message can be displayed.
Page 6
Doc. No. 05 0012 01_A

LOMD112/LOMD212 – Manual on customizing the user interface
The display files and the image files for the Views 11 to 26
The files for the Views 11 to 26 are identical constructed. Hereinafter as an example View 11 (LOMOcompact 01)
is explained, for the Views 12 to 26 this applies analogously.
The display („V11_EGI.CSV“) and image files are stored on the CF card in the directory “.\LOMO\V11_EGI”.
The display file has the same structure as that for View 2.
For each digital status 3 images are required:
*NO.egi -> Module not aktive
*OF.egi -> Signal status is of (low or 0)
*ON.egi -> Signal status is on (high or 1)
Depending on the status of the module or signal the corresponding image is displayed.
For the plain text display (no picture) applies:
- Depending on the height (H) the text is displayed with different font sizes.
- If the module is not active, the text is shown dark gray on light gray background.
- If the module is active, the text is displayed black on white background.
Assignment of name, image file and function
Name Image file Function
V11BG V11BG.egi Background image; “Typ” = 0 -> light gray background.
BZ1, BZ2 ----- No images, Descriptor 1 and 2 of the LOMOcompact.
A01…A05
V11A01xx.egi
…
V11A05xx.egi
Images for the digital Outputs (1 to 5) of the master module (LOMO 852).
LED V11LEDxx.egi Images for the red LED of the master module (LOMO 852).
A11…A15
A21…A25
E01…E08
E11…E15
E21…E25
V11A11xx.egi
…
V11A15xx.egi
V11A21xx.egi
…
V11A25xx.egi
V11E01xx.egi
…
V11E08xx.egi
V11E11xx.egi
…
V11E15xx.egi
V11E21xx.egi
…
V11E25xx.egi
Images for the digital Outputs (1 to 5) of the slave module 1 (LOMO 552).
Images for the digital Outputs (1 to 5) of the slave module 2 (LOMO 552).
Images for the digital Inputs (1 to 8) of the master module (LOMO 852).
Images for the digital Inputs (1 to 5) of the slave module 1 (LOMO 552).
Images for the digital Inputs (1 to 5) of the slave module 2 (LOMO 552).
V01, V02 ----- No images, Voltage display with 3 decimal digits for analogue Inputs (1 to 2) of the
master module (LOMO 852).
V11, V12 ----- No images, Voltage display with 3 decimal digits for analogue Inputs (1 to 2) of the
slave module 1 (LOMO 552).
V21, V22 ----- No images, Voltage display with 3 decimal digits for analogue Inputs (1 to 2) of the
slave module 2 (LOMO 552).
TIM ----- No images, Display of the timer value.
With “Typ” (1 to 16) the timer number (0 to 15) is determined.
CNT ----- No images, Display of the counter value.
With “Typ” (1 to 8) the counter number (0 to 7) is determined.
Page 7
Doc. No. 05 0012 01_A

LOMD112/LOMD212 – Manual on customizing the user interface
MSG ----- No image, Message display.
The messages of the LOMOcompact are displayed.
No messages -> gray box
Info messages -> yellow border
Alarm messages -> red border
The height (H) is internally fixed at 87!
Make sure when choosing the width (W) that the longest message can be displayed.
Page 8
Doc. No. 05 0012 01_A