Terminalfenster #Y
Das Terminalfenster hilft die serielle Verbindung zu überprüfen. Dazu legt man den Pin 22 (DPROT) auf GND (Protokoll aus) und schaltet das Display ein. Alle über eine der seriellen Interfaces empfangenen Daten werden nun direkt dargestellt (ASCII Codes sowie CR/LF). FF (0x0C) löscht das Terminalfenster und setzt den Cursor nach links oben in die erste Zeile.
Das Terminalfenster bietet gleichzeitig eine einfache Möglichkeit Ausgaben zum Test während der Entwicklung und auch Fehlermeldungen zu erhalten.
Terminalfenster Einstellungen
Größen-/Positionseinstellungen (Terminal Define Window) |
x(0), y(0), Anker(7), Spalten(x-Displayauflösung/8), Zeilen(y-Displayauflösung/16) |
|
Terminal Zoom (Terminal Define Scale) |
x-Skalierung, y-Skalierung(=x-Skalierung), virtuelleAuflösung(0) |
|
Farbeinstellung (Terminal Define Color) |
Text-Farbe, Text-Deckkraft(100), Hintergrund-Farbe($000000), Hintergrund-Deckkraft(0) |
|
Zeichenreihenfolge (Terminal Define Layer) |
Zeichenreihenfolge |
|
Terminalfenster Ein-/Ausschalten (Terminal Define Output) |
Ausgabe, Sichtbar(=Ausgabe) |
|
Cursor Ein-/Ausschalten (Terminal Cursor Blink) |
Cursor |
|
Cursor Position setzen (Terminal Cursor Position) |
Spalte, Zeile(keine Änderung) |
|
Cursor Position sichern (Terminal Cursor Save) |
||
Cursor Position wiederherstellen (Terminal Cursor Restore) |
Terminalfenster Ausgaben
Ausgabe Zeichenkette (Terminal Print Ascii) |
Zeichenkette |
|
Ausgabe formatierte Zeichenkette (Terminal Print Formated) |
"Formatstring"; Wert1, Wert2, ..., WertN |
|
Ausgabe Datum/Uhrzeit (Terminal Print Date) |
"Datumsformat"; date (aktuelle Zeit); 1/100sec |
|
Ausgabe Modulkonfiguration (Terminal Print Info) |
||
Ausgabe Versionsstring (Terminal Print Version) |
Terminalfenster Einstellungen
In dieser Befehlsgruppe werden alle wichtigen Einstellungen für das Terminalfenster zusammengefasst.
#YDW |
x(0), y(0), Anker(7), Spalten(x-Displayauflösung/8), Zeilen(y-Displayauflösung/16) |
Die Abmessungen des Terminalfensters werden definiert. Die Breite ergibt sich aus der Angabe der Spalten und Zeilen und der Schriftgröße (8x16): Breite in Pixeln =8∗Spalten; Höhe in Pixeln =16∗Zeilen
|
... #YDW 50,50,7,40,10 ... |
#YDS |
x-Skalierung, y-Skalierung(=x-Skalierung), virtuelleAuflösung(0) |
x-Skalierung und y-Skalierung werden in % angegeben. Der Parameter virtuelleAuflösung (0=ignorieren, 1=anpassen) gibt an, ob die virtuelle Displayauflösung(siehe #XCV) beachtet werden soll oder nicht. Dieser Befehl wird nur benötigt, wenn das Terminal eine andere Schriftgröße bekommen soll, oder das Projekt für eine andere Displayauflösung geschrieben worden ist.
|
... #YDS 200,200 ... |
#YDC |
Text-Farbe, Text-Deckkraft(100), Hintergrund-Farbe($000000), Hintergrund-Deckkraft(0) |
Der Befehl stellt die Farbe und die Deckkraft der Schrift und des Hintergrunds ein. Die Farbe wird jeweils als 24 Bit RGB Wert übergeben (z.B. $c80000, %110010000000000000000000, (RGB(200,0,0))).
|
... #YDC $ffffff,100,$c80000 ... |
#YDL |
Zeichenreihenfolge |
Mit dem Befehl wird die Zeichenreihenfolge des Terminalfensters festgelegt:
Zeichenreihenfolge |
|
0 |
Terminal wird hinter allen Objekten dargestellt |
1 |
Terminal wird im Vordergrund dargestellt |
Standardmäßig ist das Terminal immer im Vordergrund.
|
... #YDL 0 ... |
Terminalfenster Ein-/Ausschalten
#YDO |
Ausgabe, Sichtbar (=Ausgabe) |
Mit diesem Befehl kann zum einen die Terminalausgabe aktiviert bzw. deaktivert werden und zum anderen die Sichtbarkeit eingestellt werden. Wird nur ein Parameter übergeben, so gilt dieser für beide Werte.
Festlegung der Ausgabe:
Ausgabe |
|
0 |
Terminalausgabe ist deaktiviert |
1 |
Terminalausgabe ist aktiviert |
Festlegung der Sichtbarkeit:
Sichtbarkeit |
|
0 |
Terminal ist unsichtbar |
1 |
Terminal ist sichtbar |
#YDO 0 |
Ausgaben sind deaktiviert und das Terminal ist unsichtbar |
#YDO 1 |
Ausgaben sind aktiviert und das Terminal ist sichtbar |
#YDO 0,1 |
Ausgaben sind deaktiviert und das Terminal ist sichtbar |
#YDO 1,0 |
Ausgaben sind aktiviert und das Terminal ist unsichtbar. |
#YCB |
Cursor |
Mit dem Befehl wird die Sichtbarkeit des Cursors eingestellt:
Cursor |
|
0 |
Cursor ist unsichtbar |
1 |
Cursor ist sichtbar |
#YCP |
Spalte, Zeile(keine Änderung) |
Der Befehl setzt die Cursorposition innerhalb des Terminalfensters. Wird keine Zeile angegeben, so wird sie nicht geändert. Die Position beginnt bei (1,1).
|
... #YCP 10,2 ... |
#YCS |
|
Die aktuelle Position des Cursors wird gesichert.
Cursor Position wiederherstellen
#YCR |
|
Der Cursor wird auf die zuletzt gesicherte Position gesetzt.
Terminalfenster Ausgaben
Diese Gruppe umfasst Befehle Zeichenketten und vordefinierte Ausgaben am Terminal anzuzeigen.
#YPA |
Zeichenkette |
Die Zeichen(ketten) werden im Terminalfenster ausgegeben. Es können sowohl ganze Zeichenketten (z.B. "Test", 'Test') oder einzelne ASCI Zeichen ($21, 33, ?!) übergeben werden. Das Semikolon bildet den Stringabschluss.
|
... #YPA "Hello World"$21; ... |
Ausgabe formatierte Zeichenkette
#YPF |
"Formatstring"; Wert1, Wert2, ..., WertN, Wert1, Wert2, ..., WertN |
Die formatierte Zeichenkette wird auf dem Terminal ausgegeben. Wiederholt sich der Variablensatz, wird der Formatstring erneut verwendet. Im Unterkapitel Formatierte Zeichenkette ist der Aufbau genauer erläutert.
|
... #YPF "Formatstring %d"; 42 ... |
#YPD |
"Datumsformat"; date (aktuelle Zeit); 1/100sec |
Auf dem Terminal wird das Datum und die Uhrzeit ausgegeben. Die Darstellungsweise richtet sich nach dem Datumsformat. Der Aufbau ist im Unterkapitel Datumsformate genauer erläutert.
|
... #YPD "%D.%M.%Y"; ... |
#YPI |
|
Im Terminal werden Modulparameter (u.a. Firmwareversion, Auflösung, oder Schnittstellenparameter) ausgegeben
#YPV |
|
Im Terminal wird die Firmwareversion des Moduls ausgegeben.