E_CE_TouchKonsole_2.3_G4_de
Transcription
E_CE_TouchKonsole_2.3_G4_de
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
E_IND_PPC_TouchKonsole_2.3_G4.doc
Dokument-Version 2008/06
© 2008 by
Zetes GmbH
Langenhorner Chaussee 42
D-22335 Hamburg
www.zetesIND.com
Updates zu diesem Dokument finden Sie unter www.zetesIND.com
Inhaltsverzeichnis
Inhalt
1
Einleitung IND TouchKonsole......................................................................... 4
1.1
Allgemeines................................................................................................ 4
1.2
IND Quadrino ............................................................................................. 5
1.3
Schreibweise.............................................................................................. 5
2
Installation ...................................................................................................... 6
2.1
Voraussetzungen ....................................................................................... 6
2.2
Einfache Installation ................................................................................... 6
2.3
Installation zur Inbetriebnahme .................................................................. 7
2.4
Lizenzierung............................................................................................... 8
3
Demo-Modus.................................................................................................. 9
4
Die IND TouchKonsole................................................................................. 10
4.1
Message-Zeile.......................................................................................... 10
4.2
Programmstart ......................................................................................... 11
4.3
Terminal-Tastatur..................................................................................... 12
4.4
Terminal-Bildschirm ................................................................................. 12
4.5
Bildschirmschoner.................................................................................... 13
4.6
Programmfunktionen................................................................................ 13
5
Service-Funktionen ...................................................................................... 16
5.1
Einleitung ................................................................................................. 16
5.2
IND VT220 Demo..................................................................................... 17
6
SSH-Verschlüsselung .................................................................................. 18
7
Konfiguration ................................................................................................ 20
7.1
Der INI-Editor ........................................................................................... 20
7.2
Die INI-Datei............................................................................................. 21
7.2.1
INI-Abschnitt: Telnet ............................................................................ 21
7.2.2
INI-Abschnitt: Login.............................................................................. 23
7.2.3
INI-Abschnitt: VT220............................................................................ 25
7.2.4
INI-Abschnitt: 5250 .............................................................................. 31
7.2.5
INI-Abschnitt: Windowed...................................................................... 33
7.2.6
INI-Abschnitt: Setup ............................................................................. 34
7.2.7
INI-Abschnitt: Font ............................................................................... 39
7.2.8
INI-Abschnitt: ColorDefinition ............................................................... 41
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 2 / 82
Inhaltsverzeichnis
7.2.9
INI-Abschnitt: TouchPad.*.................................................................... 42
7.2.10
INI-Abschnitt: Layout* .......................................................................... 45
7.2.11
INI-Abschnitt: KeyboardMapping ......................................................... 47
7.2.12
INI-Abschnitt: Scanner ......................................................................... 50
7.2.13
INI-Abschnitt: Scanner.Symbol.*.......................................................... 54
7.2.14
INI-Abschnitt: Scanner.Intermec.*........................................................ 58
7.2.15
INI-Abschnitt: Scanner.IND.................................................................. 60
7.2.16
INI-Abschnitt: Scanner.KeyboardWedge ............................................. 61
7.2.17
INI-Abschnitt: Special........................................................................... 62
7.2.18
INI-Abschnitt: Debug............................................................................ 64
7.3
Makro-Befehle.......................................................................................... 66
7.3.1
Makro-Befehle unter VT220................................................................. 67
7.3.2
Makro-Befehle unter 5250 ................................................................... 69
7.4
Barcode-Scripting..................................................................................... 72
7.4.1
Befehls-Zusammensetzung ................................................................. 72
7.4.2
Escape-Zeichen ................................................................................... 74
7.4.3
Scripting-Befehle.................................................................................. 75
7.4.4
Beispiele .............................................................................................. 78
8
Proprietäre VT-Kommandos......................................................................... 79
8.1
CSI-Befehle.............................................................................................. 80
8.1.1
Zeilenweises Doppelt-Hoch ................................................................. 80
8.1.2
Zeichenweises Doppelt-Hoch und Doppelt-Breit.................................. 80
8.2
ROI-Befehle ............................................................................................. 81
8.2.1
Druckerport auswählen ........................................................................ 81
8.2.2
Reader aktivieren................................................................................. 81
8.2.3
Scanner- / Keyboard-Eingabe.............................................................. 82
8.2.4
Font-Auswahl ....................................................................................... 82
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 3 / 82
1
1
Einleitung IND TouchKonsole
Einleitung IND TouchKonsole
1.1
Allgemeines
Die IND TouchKonsole ermöglicht Funkterminals mit einem Windows Mobile- bzw.
Windows CE-Betriebssystem den Zugriff auf Hostsysteme. Mittels einer
Terminalemulation kann das Terminal Daten mit dem Hostsystem über das TCP/IPund Telnet-Protokoll austauschen. Hierfür muss das Hostsystem einen TelnetServer-Prozess bereitstellen.
Die IND TouchKonsole unterstützt Funkterminals diverser Hersteller mit folgenden
Betriebssystemen:
Microsoft Pocket PC 2002 / 2003 / Windows Mobile 5
Microsoft Windows CE 4.1 / 4.2 (CE.NET) / CE 5
Von der IND TouchKonsole werden folgende Emulationen unterstützt:
VT220 - mit vollem Funktionsumfang
IBM 5250 mit Standard-Funktionsumfang
Zu den besonderen Merkmalen der IND TouchKonsole zählen:
Vollbildmodus - der ganze Bildschirm steht für die Terminalemulation zur
Verfügung, Kopfzeile und Statuszeile sind ausgeblendet
Unterstützung aller gängigen Betriebssystem-Versionen und HardwareHersteller
Einfache Bedienung für den Anwender und viele wichtige Einstellmöglichkeiten für den Administrator mit simpler Konfiguration über eine INI-Datei
Zusätzliche auf dem Bildschirm einblendbare Tastaturen, die auch per FingerKlick bedient werden können - zur Ergänzung der meist eingeschränkt
vorhandenen Hardwaretasten
Individuelle Einstellung der Fontgröße
Volle VT220-Unterstützung (einschließlich VT100) mit u. a. Scrolling Regions,
Protected Characters, Fettschrift, blinken, doppelt hoch und breit sowie
zusätzlich die Unterstützung von 16 Farben (VT320-Farbschema sowie
optimiertes Farbschema für Graustufen-Terminals)
Unterstützt Terminals mit beliebiger Auflösung ab 240x240 Bildpunkte sowie
das Intermec CK30-Terminal (160x160 Bildpunkte ohne TouchScreen)
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 4 / 82
1
1.2
Einleitung IND TouchKonsole
IND Quadrino
Die TouchKonsole enthält einige Anpassungen für den Betrieb auf dem
IND Quadrino Terminal (bzw. dessen OEM-Varianten), um dem Bediener zusätzliche
Funktionen des Geräts zugute kommen zu lassen:
Unterstützung der Summit-WLAN-Karte sowie Bereitstellen von WLANLogging-Funktionen
Einstellen der Display-Helligkeit mit Makros (z.B. über das Touchpad)
Direkte Interaktion mit der ScanWedge für schnelleres Barcode-Scannen
Automatische Auswahl von quadratischen Buttons für das TouchPad
Umleitung der Message-LED auf die CPU-LED
1.3
Schreibweise
Alle Pfadangaben, Dateinamen sowie Menü-Einträge, Button-Bezeichnungen etc.
sind im Fließtext zur Kennzeichnung in Anführungszeichen "..." gesetzt. Die
Anführungszeichen sind jedoch nicht Teil des Namens!
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 5 / 82
2
2
Installation
Installation
2.1
Voraussetzungen
Folgende Soft- und Hardware sollte für die Installation bereitgehalten werden:
Software-Archiv mit der benötigten IND TouchKonsole
Microsoft ActiveSync (ab Version 4.5 oder höher)
PC mit Microsoft Windows 2000 oder XP
Terminal mit Betriebssystem Microsoft Windows Mobile oder Windows CE
(s. o.) und installiertem Compact Framework
Cradle mit PC-Anschlusskabel (seriell oder USB) bzw. Ladekabel
2.2
Einfache Installation
Im Folgenden wird eine einfache Installation anhand eines Terminals mit dem
Betriebssystem Microsoft Pocket PC 2003 beschrieben, die für Testzwecke
ausreichend ist.
1) Auf einem PC muss ActiveSync installiert werden, sofern dieses Programm
noch nicht installiert ist. Wenn das Programm nicht zur Verfügung steht, kann
es im Internet von der Microsoft Seite kostenlos heruntergeladen werden.
Hierzu der Link:
http://www.microsoft.com/windowsmobile/activesync/default.mspx
Die weiteren Installationsanweisungen sind dort zu finden.
2) Das Terminal muss über das Cradle oder das Ladekabel mit dem PC
verbunden werden. ActiveSync startet automatisch und fragt nach einer neuen
Partnerschaft. Dieser Dialog sollte abgebrochen werden, damit keine
Synchronisation der Termine, Kontakte etc. zwischen PC und Terminal erfolgt.
Es wird dann mit einer Gastpartnerschaft gearbeitet, die einen Dateiaustausch
erlaubt. Sollte keine Verbindung zustande kommen, müssen auf dem Pocket
PC die ActiveSync-Einstellungen bzgl. der Kommunikationsschnittstelle USB
oder Seriell (sowie bei Seriell die Geschwindigkeit) überprüft werden.
3) Im Windows Explorer ist nun unter Arbeitsplatz ein neuer Eintrag "Mobiles
Gerät" zu finden. Nach dem Wechsel in "Pocket PC Arbeitsplatz" und dann in
"Program Files" muss ein neuer Ordner "IND TouchKonsole" angelegt werden.
Anmerkung: Ort und Name des Ordners können aber auch beliebig gewählt
werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 6 / 82
2
Installation
4) In das soeben erstellte Verzeichnis werden folgende Dateien kopiert:
TouchKonsole.EXE
TouchKonsole.INI
TxToolsCE.DLL
TxToolsCE.RegistryCalls.DLL
Cour.TTF
CourBD.TTF
LICENCE.ALL (falls verwendet, siehe Kapitel "Lizenzierung")
Wenn die spezielle Version mit intern angesteuertem Symbol-Scanner
verwendet wird, müssen auch die folgenden Dateien kopiert werden:
Symbol.dll
Symbol.Barcode.dll
Symbol.Keyboard.dll
Symbol.WirelessLAN.dll
Wenn die spezielle Version mit intern angesteuertem Intermec-Scanner
verwendet wird, muss auch folgende Datei kopiert werden:
Intermec.DataCollection.dll
5) Wenn ein Link im Programme Menü erstellt werden soll, so muss die LinkDatei "IND TK für PPC.lnk" in das folgende Verzeichnis kopiert werden:
"\Windows\Start Menu\Programs" oder in "\Windows\Start Menu“
2.3
Installation zur Inbetriebnahme
Um das Terminal effektiv im Produktivbetrieb einzusetzen, muss die Software auf
dem Terminal kaltstartfest installiert werden. Das bedeutet, dass die Software und
auch die weiteren Einstellungen am Terminal, wie z.B. die Netzwerkadresse, nach
einem Kaltstart wie zuvor vorhanden sind, ohne dass das Gerät neu installiert
werden muss. Ein Kaltstart ist dann notwendig, wenn das Gerät sich aufgehangen
hat und trotz eines Warmstarts nicht wieder richtig läuft. Ein Kaltstart auf einem
Windows CE Gerät entspricht dem Ausschalten bei einem normalen PC, nur dass
hier alle nachträglich installierte Software und auch alle getätigten Einstellungen
verloren gehen. Achtung: Auch ein längeres Liegenlassen des Terminals, bei dem
sowohl der Austausch-Akku als auch der interne Akku völlig leer werden können,
kommt einem Kaltstart gleich!
Das kaltstartfeste Hinterlegen von Einstellungen und Software unterscheidet sich auf
den verschiedenen Terminals teilweise erheblich voneinander. Weitere Informationen
hierzu sind im Handbuch "B_Windows_CE_Konfiguration" zu finden.
Bei Fragen wenden Sie sich bitte an folgende Adresse:
Zetes GmbH
Abteilung PocketPC
Telefon: 040-532888-15
IND bietet gerne Unterstützung bei der Installation an.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 7 / 82
2
2.4
Installation
Lizenzierung
Unlizenziert läuft die IND TouchKonsole nur im Demo-Modus oder zeitlich begrenzt
auch mit Kommunikation zum Host. Ohne Lizenz ist es möglich, das Programm für
jeweils zehn Minuten mit uneingeschränktem Funktionsumfang zu starten. Beim Start
des Programms wird der Registrierungs-Key angezeigt. Dieser muss IND unter o. g.
Adresse oder Telefonnummer mitgeteilt werden, um den zugehörigen Lizenz-Key zu
erhalten.
Der Lizenz-Key muss in der Datei "TouchKonsole.INI" eingetragen werden (siehe
Kapitel "Service-Funktionen").
Alternativ kann die Datei "LICENCE.ALL" genutzt werden. Dies empfiehlt sich vor
allem bei größeren Installationen. In dieser Datei können sämtliche Lizenz-Keys aller
Terminals stehen. Damit ist eine einfache und einheitliche Installation gewährleistet.
Die Datei "LICENCE.ALL" ist eine simple ASCII-Datei, in der die Lizenz-Keys mit
Carriage Return + Line Feed getrennt stehen. Hier ein Beispiel:
4063629544
2253403944
2918515722
1882408192
1092984642
0092674046
3096000513
2870548518
1087604947
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 8 / 82
3
3
Demo-Modus
Demo-Modus
Der Demo-Modus dient ausschließlich Test- und Vorführzwecken und bietet daher
keine Kommunikation mit dem Host. Die TouchKonsole startet mit dem IND
Eingangsbildschirm. Dort sind alle weiteren Funktionalitäten wie Service-Menü und
virtuelle Tastatur voll funktionsfähig.
Über die programmierbaren Makros der virtuellen Tastatur können z.B. umfangreiche
VT220-Kommandos getestet und Demo-Bildschirme erstellt werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 9 / 82
4
4
Die IND TouchKonsole
Die IND TouchKonsole
4.1
Message-Zeile
Die Message-Zeile befindet sich am unteren Bildschirmrand und zeigt aktuelle
Meldungen an. Sie beherbergt auch weitere nützliche Anzeigen wie:
5250-Maskenstatus
Batterieanzeige
Funkqualität
TCP/IP-Aktivität
Symbol-Keyboardstatus (aktives Layout)
Um zusätzlichen Platz auf dem Bildschirm zu schaffen, kann sie im VT220-Betrieb
ausgeblendet werden, solange keine Nachricht angezeigt wird.
Werden Fehlermeldungen in der Message-Zeile angezeigt, sind diese meist länger,
als in die Zeile hineinpasst. In diesem Fall kann für eine Sekunde auf den Text
gedrückt werden, um diesen als MessageBox anzeigen zu lassen. Nur Meldungen,
die nicht kritisch genug sind, um dafür die TouchKonsole anzuhalten, werden in der
Message-Zeile angezeigt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 10 / 82
4
4.2
Die IND TouchKonsole
Programmstart
Bevor die IND TouchKonsole gestartet wird, muss im Netzwerk ein Telnet-Server zur
Verfügung stehen. Weiterhin muss die Netzwerk-Einrichtung des Terminals
vollständig und lauffähig sein.
Das Programm wird durch Anklicken des Icons „IND TK für PPC“ im Startmenü
gestartet. Ist dieser Eintrag bei der Installation nicht kopiert worden, so ist auch ein
Start durch Anklicken der Datei im File-Explorer möglich. Hierzu muss in das
Verzeichnis, in das das Programm kopiert worden ist, gewechselt werden.
Anmerkung: Unter dem Betriebssystem Windows CE ist ein Doppelklick zum Starten
der Dateien notwendig, während es bei Windows Mobile ein Einfachklick ist.
Das Programm meldet sich mit dem Startbildschirm und versucht die Verbindung
zum Telnet-Server aufzubauen.
Schlägt der Verbindungsaufbau fehl, so erscheint in der unteren Zeile:
"NO CONNECTION. TAP SCREEN TO RETRY".
Dies bedeutet, dass beim Berühren des Touch-Bildschirms erneut versucht wird, die
Verbindung zum Server herzustellen. Gelingt dies nicht, kann eventuell der
Systemadministrator oder das Kapitel "Service-Funktionen" weiterhelfen. Entweder
gibt es Probleme mit dem Netzwerk, dem Telnet-Server oder den Einstellungen des
Terminals.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 11 / 82
4
Die IND TouchKonsole
Wenn der Aufbau der Verbindung funktioniert hat, verschwindet der gezeigte
Eingangsbildschirm und es werden die Daten gezeigt, die der Server sendet. Das
Layout dieses Bildschirms ist alleine vom Server abhängig und kann daher nicht an
dieser Stelle gezeigt werden.
4.3
Terminal-Tastatur
Die Hardwaretastatur des eingesetzten Terminals kann ganz unterschiedlich sein.
Die Spanne reicht von vier Softkeys (Standard Windows Mobile) bis hin zu
aufwendigen Tastaturen mit Buchstaben, Ziffern, Cursortasten, Funktionstasten
usw. Alle diese Tastaturen werden unterstützt und können genutzt werden. Einzig
vom Telnet-Server hängt es ab, ob sie auch richtig interpretiert werden können.
Fehlen dem Terminal Tasten, die für die Bedienung der Terminalemulation
notwendig sind, ist es möglich, mehrere virtuelle Tastaturen auf dem Bildschirm zu
generieren, die bei Berühren des Bildschirms an der entsprechenden Stelle diese
Tastatur-Codes
senden.
Weitere
Informationen
hierzu
sind
unter
"Programmfunktionen" bzw. "INI-Abschnitt: TouchPad.*" ff. zu finden.
4.4
Terminal-Bildschirm
Der Bildschirm des Terminals ist nicht nur kleiner als der eines normalen PCs,
sondern er hat auch weniger Bildpunkte zur Verfügung, so dass effektiv wesentlich
weniger auf den Bildschirm passt, als wenn die Terminalemulation auf einem PC
läuft. Dies sollte unbedingt bei der Gestaltung der Dialoge auf dem Telnet-Server
beachtet werden! Meistens besitzt das Terminal 240*320 Pixel. Es gibt aber auch
Terminals sowohl mit weniger als auch mit mehr Pixeln. Die Auflösungen 240*320
und 160*160 sowie ab Version 2.1 auch 320*240 werden von der IND TouchKonsole
optimal unterstützt.
Des Weiteren gibt es auch Terminals, die keinen Touchscreen besitzen und nur über
die Tastatur bedient werden können. Auch diese Terminals werden entsprechend
unterstützt, wie im Kapitel "Service-Funktionen" beschrieben.
In der IND TouchKonsole besteht die Möglichkeit, die Font-Größe anzupassen.
Dadurch wird die Schrift entweder kleiner, so dass mehr auf den Bildschirm passt
oder sie wird größer und dadurch besser lesbar.
Achtung: Bei einer Verkleinerung der Schriftart passt zwar mehr auf den Bildschirm,
die Schrift behält jedoch nicht die gleiche Brillanz, da pro Zeichen wesentlich weniger
Bildpunkte verwendet werden!
Weitere Informationen zum Einstellen der Schriftgröße sind im Kapitel "ServiceFunktionen" zu finden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 12 / 82
4
4.5
Die IND TouchKonsole
Bildschirmschoner
Die IND TouchKonsole besitzt einen Bildschirmschoner, der nicht nur den Bildschirm
sondern vor allem auch die Kapazität der Akkus schont. Er geht nach einer
einzustellenden Zeit automatisch an, wenn keine Tasten gedrückt und keine Daten
vom Host empfangen werden. Der Bildschirm wird dann vollständig abgeschaltet.
Um dies zu kennzeichnen, fängt die LED an, in einem bestimmten Rhythmus zu
blinken (zweimal kurz an und lange Pause). In diesem Zustand ist das restliche
Terminal
weiterhin
aktiv,
um
ein
schnelles
Anschalten
ohne
Kommunikationsverzögerung zu gewährleisten.
Zum Wiedereinschalten muss der Bildschirm berührt oder eine Taste gedrückt
werden. Die Ein-/Aus-Taste schaltet in diesem Zustand das Gerät aus, sie darf daher
nicht zum Aufwecken genutzt werden. Der Bildschirmschoner kann abgeschaltet
werden, wenn diese Funktionalität nicht gewünscht ist. Weitere Informationen zum
Bildschirmschoner sind im Kapitel "Service-Funktionen" zu finden.
Achtung: Diese Funktion wird in seltenen Fällen vom Terminal herstellerbedingt nicht
unterstützt!
4.6
Programmfunktionen
Die Bedienung der IND TouchKonsole ist durch die Dialoge bestimmt, die der TelnetServer an das Terminal sendet. Die Bedienung ist genauso, als ob die
Terminalemulation auf einem normalen PC ablaufen würde.
Zum Eingeben der Daten kann die Terminal-Tastatur oder alternativ die virtuellen
Tastaturen der TouchKonsole verwendet werden.
Wenn der Host ein WAIT-Signal sendet, wird dies als Text in der Status-Zeile
angezeigt. Sowohl Hardware-Tastatur als auch die virtuelle Tastatur sind so lange
gesperrt, bis sie vom Host wieder freigegeben werden.
Die IND TouchKonsole bietet bis zu vier verschiedene, virtuelle, direkt erreichbare
Tastaturen mit jeweils fünf Tasten, wobei ein Verschachteln in mehrere
hintereinander liegende Ebenen möglich ist. D.h., von der ersten Tastatur kann man
auf eine weitere gelangen, die wiederum andere Tasten anbietet. Die Darstellung
und die Funktion der Tasten können ganz unterschiedlich sein und werden vom
Administrator festgelegt. Ab Version 2.1 können auch mehr als fünf Tasten definiert
werden, was aber erst ab einer vertikalen Auflösung von min. 320 Pixeln sinnvoll ist.
Die virtuelle Tastatur wird bei Berührung des Bildschirms eingeblendet und
verschwindet bei der nächsten Berührung - außer es wird eine der "BildschirmTasten" gedrückt. Bei eingeblendeter virtueller Tastatur wird der Bildschirminhalt
jeweils so verschoben, dass die Cursorposition weiterhin sichtbar ist (nur bei
eingeschaltetem Follow Cursor).
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 13 / 82
4
Die IND TouchKonsole
Jedem Viertel des Bildschirms kann eine andere Tastatur zugeordnet werden. Die
nachfolgenden Bilder sollen dies verdeutlichen:
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 14 / 82
4
Die IND TouchKonsole
Weitere Sonderfunktionen werden durch Berührung des Bildschirms in den äußeren
Ecken aufgerufen:
Linke obere Ecke:
Anzeige der Programmversion in der oberen Zeile
Rechte obere Ecke:
Aufruf des Menüs für Programmeinstellungen (siehe "Service-Funktionen")
Linke untere Ecke:
Neustart der IND TouchKonsole und Neuanmeldung am Telnet-Server (u. U.
ist diese Funktion vom Administrator gesperrt)
Rechte untere Ecke:
Anzeige der Systemtastatur in der unteren Bildschirmhälfte
Achtung: Das Menü für Programmeinstellungen kann vom Administrator mit einem
Passwort belegt sein. Es kommt dann die entsprechende Abfrage, die mit "OK"
bestätigt werden muss. Der Button "abc" blendet die Systemtastatur ein, falls die
Tastatur des Terminals nicht ausreicht.
Anmerkung: Wenn bei der TouchKonsole die Scrollbalken aktiv sind, befindet sich
der zu berührende Bereich nicht in den äußeren Ecken des physikalischen
Bildschirms, sondern in den Ecken innerhalb des Scrollbereichs.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 15 / 82
5
5
Service-Funktionen
Service-Funktionen
5.1
Einleitung
Die Service-Funktionen, d.h. die Programmeinstellungen, werden über ein
gesondertes Menü aufgerufen. Dieses ist – zu einem beliebigen Zeitpunkt nach dem
Programmstart – zu erreichen, indem die rechte obere Bildschirmecke mit dem
Eingabestift angeklickt wird. Je nach Einstellung erscheint vorher eine
Passwortabfrage, die richtig beantwortet werden muss. War das Passwort falsch, so
verschwindet
der Dialog
wieder,
ohne
dass
anschließend
in
die
Programmeinstellungen verzweigt wird.
Je nach Bildschirmauflösung kann das Service-Menü unterschiedliche Formen
annehmen. Wenn das Terminal keinen Touchscreen besitzt, erfolgt die Bedienung
mit den Tasten Tab sowie Shift+Tab und den Cursortasten.
Über den Schiebebalken "Font Size" kann die vom Telnet-Client angezeigte
Schriftgröße für die Dauer der aktuellen Sitzung verändert werden.
Achtung: Eine dauerhafte Änderung der Schriftgröße kann nur durch Änderung der
INI-Einstellungen erreicht werden!
"Edit Ini" ermöglicht das Ändern der Einstellungen direkt auf dem Terminal (siehe
Kapitel "Konfiguration").
Die Funktion "TestScreen" unterstützt bei der Auswahl der richtigen Font-Größe. Der
Bildschirm wird vertikal und horizontal in der ersten Reihe, bzw. Spalte mit einem
Zahlenlineal beschriftet. Außerdem wird nach jedem Ausführen der Funktion
"TestScreen" die maximale Anzahl Zeilen und Spalten in der Mitte des Bildschirms
angezeigt. Dies soll helfen zu erkennen, wie viel auf den Bildschirm des jeweiligen
Terminals passt. Je nach Terminaltyp und Betriebssystem kann dies unterschiedlich
sein (s. nächste Seite).
Anmerkung: Eventuell muss das Service Menü geschlossen werden, um den
gesamten Testbildschirm zu erkennen!
Der Button "Restart" bewirkt eine Abmeldung mit erneuter Anmeldung am TelnetServer für den Fall, dass es Probleme mit der Verbindung gibt.
Mit dem Button "Shutdown" wird die IND TouchKonsole beendet.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 16 / 82
5
Service-Funktionen
Beispiel eines Testbildschirms in verschiedenen Font-Größen mit und ohne ServiceMenü:
5.2
IND VT220 Demo
Um einen Teil des Funktionsumfangs der TouchKonsole zu zeigen, gibt es einen IND
VT220 Demo-Bildschirm. Dieser kann aufgerufen werden, indem bei der Passwortabfrage zum Service-Menü das Passwort "inddemo" (ohne Anführungszeichen)
eingeben wird. Es erscheint der folgende Bildschirm:
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 17 / 82
6
6
SSH-Verschlüsselung
SSH-Verschlüsselung
Ab der Version 2.3.0.50 ist die PPC TouchKonsole auch mit SSH-Verschlüsselung
verfügbar. Sie gewährleistet, dass der Datenverkehr zwischen Server und Client
nicht mehr abgehört werden kann, selbst wenn er über öffentliche Netze geleitet
wird. Um diese Version nutzen zu können, wird jedoch ein anderer Lizenz-Schlüssel
als für die Version ohne SSH benötigt.
Außerdem wird mit der SSH-Version eine weitere Datei mitgeliefert:
WeOnlyDo.Client.SSH_CE.dll
Um die SSH-Verschlüsselung einsetzen zu können, sind folgende INI-Parameter
wichtig:
[TELNET]
HostType=1
Host=10.51.1.1
Port=22
[AutoLogin]
AutoLoginUSR=user
AutoLoginPWD=123
Mit "HostType=1" wird von der Benutzung der normalen WinSock umgeschaltet auf
die Benutzung der DLL für die SSH-Verschlüsselung. Die Login-Parameter werden
standardmäßig aus den bekannten Abschnitten der TouchKonsole.ini ausgelesen. Zu
empfehlen ist allerdings der alternative Einsatz einer config.ssh Datei, die alle
relevanten Anmeldeinformationen verschlüsselt enthält.
Um zu gewährleisten, dass die Anmeldeinformationen nicht in die Hände von
Unbefugten gelangen, bzw. wenn Authentifizierung mittels Public Key / Private Key
oder Fingerprint verwendet werden soll, wird ein spezielles Konfigurationsprogramm
bereitgestellt, das eine von der TouchKonsole lesbare verschlüsselte Datei generiert,
die alle oben genannten Parameter aufnehmen kann.
Im Gegensatz zur XP-Version ist die CE-Version nicht in der Lage, Key-Dateien zu
verarbeiten, da die dafür benötigte KeyManager.dll nur für XP verfügbar ist. Die Keys
müssen mit dem SSH-Konfigurator in die Datei config.ssh importiert werden und
liegen dann in einem für die CE-Version lesbaren Format vor.
Näheres
hierzu
und
zu
SSH
allgemein
"D_IND_TouchKonsole_SSH_Konfigurator" zu finden.
ist
im
Handbuch
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 18 / 82
6
SSH-Verschlüsselung
Für den Aufbau der verschlüsselten Verbindung sind auf dem Handgerät aufwendige
Berechnungen durchzuführen. Dadurch würde der Verbindungsaufbau bis zu 30
Sekunden benötigen. Um dies zu kompensieren, wird nach dem ersten
Verbindungsaufbau im Hintergrund bereits der nächste Teilschlüssel berechnet,
wodurch sich der Verbindungsaufbau auf unter 10 Sekunden beschleunigt. Beim
Beenden der TouchKonsole wird der aktuell vorgehaltene Teilschlüssel in der Datei
e.dh gespeichert, so dass er beim nächsten Start wieder zur Verfügung steht. Diese
Datei wird nicht mit ausgeliefert, sondern grundsätzlich auf dem Endgerät berechnet,
um die Unvorhersagbarkeit zu gewährleisten.
Sobald beim Verbindungsaufbau der SSH-Host seinen Fingerprint bereitstellt,
wechselt die Anzeige auf "Authenticating…" um zu signalisieren, dass die TCPVerbindung zum Host bereits steht und nun die Verschlüsselung ausgehandelt wird.
So lange die gesicherte SSH-Verbindung nicht fertig aufgebaut ist, wird ein rotes
"OFF"-Icon eingeblendet. Also auch, wenn mit der SSH-Version reguläres Telnet
gefahren wird. Nur bei bestehenden gesicherten Verbindungen wird auf ein grünes
"SSH"-Icon gewechselt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 19 / 82
7
7
Konfiguration
Konfiguration
Alle Einstellungen der IND TouchKonsole erfolgen in einer INI-Datei. Diese kann auf
dem PC editiert und anschließend auf das Terminal übertragen werden. Alternativ
kann die Änderung auch direkt auf dem Terminal passieren. Hierzu ist einfach der
Button "Edit Ini" in den Programmeinstellungen aufzurufen.
7.1
Der INI-Editor
Im INI-Editor können alle Einstellungen verändert werden. Abschließend muss der
Button "Save + Restart" benutzt werden, um die Änderungen zu übernehmen.
Hierbei wird ein Neustart des Programms durchgeführt, der auch eine neue
Verbindung zum Server bedingt.
Über den Button "Cancel" können die getätigten Eingaben verworfen werden. Der
INI-Editor wird verlassen ohne die Daten zu speichern.
Der Button "abc" ruft die Systemtastatur auf und unterstützt so bei der Eingabe von
Buchstaben und Ziffern, falls die Terminaltastatur nicht genügend Möglichkeiten
bietet.
Ab Version 2.3 ist ein neuer Editor integriert, der zusätzlich über eine Auswahlliste für
den Abschnitt verfügt. Nur der aktuell ausgewählte Abschnitt wird angezeigt. Dies
bietet den Vorteil, dass ein Abschnitt schneller gefunden und übersichtlicher
angezeigt werden kann.
Anmerkung: Wenn das Terminal keinen Touchscreen besitzt, können die Buttons mit
den Tasten Tab und Shift+Tab erreicht werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 20 / 82
7
7.2
Konfiguration
Die INI-Datei
Alle Einstellungen der IND TouchKonsole erfolgen in einer INI-Datei. Diese kann mit
dem integrierten Editor oder einem beliebigen anderen Editor (z.B. Notepad) editiert
werden. Die Änderungen werden beim nächsten Starten des Programms aktiv.
7.2.1 INI-Abschnitt: Telnet
LicenceKey=
HostType=0
Host=10.51.1.1
Port=23
Emulation=220
Handshake=0
KeepAlive=1
WaitForLanReady=1
SendBufferedDelay=2
LicenceKey
Hier kann der Lizenz-Key eingetragen werden; alternativ kann
dieser in der Datei "LICENCE.ALL" stehen, siehe Kapitel
"Lizenzierung"
HostType
Verwendung von unverschlüsselter Telnet-Kommunikation (0)
oder verschlüsselter Kommunikation mittels SSH (1)
Host
IP-Adresse oder Name des Telnet-Servers
Port
Port-Nummer, über die mit dem Telnet-Server kommuniziert
wird. Für Telnet ist dies in der Regel 23 und für SSH 22
Emulation
Einstellung der Art der Emulation; folgende Werte sind möglich:
220 oder 5250
Handshake
Handshake=1 legt fest, dass das Terminal mit dem Handshake
anfängt; bei 0 muss der Host anfangen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 21 / 82
7
Konfiguration
KeepAlive
Bei KeepAlive=1 setzt die TouchKonsole alle 30 Sekunden ein
UDP-Paket an Port 9 (SINK) des Hosts ab. Wird für den Betrieb
auf einem Fahrzeug-Terminal normalerweise nicht benötigt
WaitForLanReady Vor dem Senden wird abgefragt, ob das Funknetz bereit ist. Dies
kann mit 0 deaktiviert werden. Dadurch kann ein
Performancegewinn erzielt werden, wenn viele kleine
Datenpakete in schneller Abfolge übertragen werden. Der
Nachteil dabei ist, dass es zum Funkabbruch kommt, wenn nach
dem Wiedereinschalten des Gerätes sofort eine Taste gedrückt
wird
SendBufferedDelay Wenn Barcodescanner verwendet werden ist es sinnvoll, so
lange mit dem Senden zu warten, bis der Barcode in einem
einzelnen Paket gesendet werden kann. Dieses gepufferte
Senden kann jedoch bei schnellem Scannen dazu führen, dass
in einem gesendeten Paket mehrere Barcodes stehen, was
einige Server nicht verarbeiten können. Gültige Werte sind 0 bis
1000 ms (0 schaltet den Puffer ab), Standard ist 2 ms
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 22 / 82
7
Konfiguration
7.2.2 INI-Abschnitt: Login
AutoLogin=1
SeekLoginUSR=ogin:
SeekLoginPWD=assword:
AutoLoginUSR=gast
AutoLoginPWD=123
PromptUser=0
AutoLoginVAL3Enabled=0
AutoLoginVAL3=
SeekLoginVAL3=
AutoLoginVAL4Enabled=0
AutoLoginVAL4=
SeekLoginVAL4=
AutoLoginVAL5Enabled=0
AutoLoginVAL5=
SeekLoginVAL5=
AutoLoginTTL=25
AutoLogin
Einschalten der automatischen Anmeldung am Host (0=aus,
1=an); AutoLoginUSR und AutoLoginPWD müssen dann
ebenfalls gefüllt werden
Achtung: Name und Passwort sind, abhängig vom Host, meist
case-sensitive!
SeekLoginUSR
Such-Zeichenfolge, wodurch der vom Host angeforderte LoginName identifiziert wird
SeekLoginPWD
Such-Zeichenfolge, wodurch das vom Host angeforderte LoginPasswort identifiziert wird
AutoLoginUSR
Login-Name für die automatische Anmeldung. Dieser kann auch
bei Benutzung von SSH verwendet werden
AutoLoginPWD
Login-Passwort für die automatische Anmeldung. Dieses kann
auch bei Benutzung von SSH verwendet werden
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 23 / 82
7
Konfiguration
PromptUser
Anzeige einer Login-Maske, um den Benutzer Namen und
Passwort eingeben zu lassen. Wurden Werte für AutoLoginUSR
oder AutoLoginPWD hinterlegt, werden diese als Standardwerte
vorbelegt. Diese Funktion ist auch sinnvoll bei Verwendung von
SSH, um ein Ablegen von Anmeldeinformationen auf dem Gerät
völlig zu verhindern. Wird eines der o.g. Felder aus der
Config.SSH-Datei geladen, wird das entsprechende Feld in der
Login-Maske automatisch ausgeblendet.
AutoLoginVALxEnabled
Nachdem mit Login-Name und Passwort bereits zwei Parameter
ausgetauscht worden sind, gibt es hier noch zusätzliche
Parameter mit den Nummern 3, 4 und 5. Mit dieser Einstellung
werden sie jeweils eingeschaltet (0=aus, 1=an).
AutoLoginVALx
X-ter Parameter, der an den Host übergeben wird
SeekLoginVALx
X-te Such-Zeichenfolge, wodurch der vom Host angeforderte x-te
Parameterwert identifiziert wird
AutoLoginTTL
Zeitfaktor in Anzahl Datenpaketen (bzw. Anzahl Masken bei
5250), währenddessen auf das Login vom Host gewartet wird
(danach wird nicht mehr nach den aktivierten SeekLogin…Zeichenfolgen gesucht)
Anmerkung:
Bei VT220 wird beim Finden eines SeekLogin…-Parameters sofort der jeweilige
AutoLogin…-Wert gesendet, gefolgt von (je nach aktuell eingestelltem NewlineMode)
entweder Cr oder CrLf.
Bei 5250 wird die empfangene Maske nach den aktivierten SeekLogin…-Parametern
abgesucht und der jeweilige AutoLogin…-Wert in das Feld, das dem Text folgt,
eingetragen. Wurden alle aktivierten Parameter gefunden (SeekLoginUSR und
SeekLoginPWD sind immer aktiviert), wird die Maske automatisch freigegeben und
die gefüllten Felder an den Host zurückgesendet.
Ab Version 2.3 ist es möglich, bei den AutoLogin…-Werten auch Makros zu
definieren. Dazu muss der Wert mit "Macro:" beginnen. Beispiel:
AutoLoginUSR=Macro:user01{tab}
Bei Verwendung eines Makros unter VT220 wird für den Wert kein automatisches
Zeilenendezeichen (Cr) gesendet. Dies ist sinnvoll, da z.B. bei der Verwendung des
VT220-Modus einer AS/400 sonst mit dem Senden des Benutzernamens die Maske
freigegeben wird und die Anmeldung fehlschlägt. Weitere Informationen zu Makros
sind im Abschnitt "Makro-Befehle" zu finden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 24 / 82
7
Konfiguration
7.2.3 INI-Abschnitt: VT220
TerminalType=VT220
StationName=VT220
Rows=24
Columns=80
FixedDimensions=0
FixedRoiDimensions=0
RoiFontScaling=2
BackgroundColor=15
ForegroundColor=0
BitMode=8
Map=0
NewlineMode=0
BSsendsDEL=1
CursorMode=0
KeypadMode=0
HardResetMode=0
Wait=0
LocalEcho=0
MultiNationalMode=1
SmoothScrolling=0
AutoWrapMode=1
InsertMode=0
DosMode=0
PrimaryDA=62;1;2;6;9
SecondaryDA=10;203;0
KeyboardLanguage=7
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 25 / 82
7
Konfiguration
TerminalType
Telnet-Terminal-Typ, der zurückgegeben wird, wenn der TelnetServer diesen über Kommando TTY abfragt
StationName
Name, der zurückgegeben wird, wenn der Telnet-Server diesen
abfragt (Enquiry ASCII-Zeichen '05')
Rows
Host-Bildschirmauflösung Zeilen: mögliche Werte für VT220 sind
2 bis 100.
Columns
Host-Bildschirmauflösung Spalten: mögliche Werte für VT220
sind 1 bis 200.
Achtung: Sollte die Anwendung nicht auf den Bildschirm passen, so können die
Parameter für Fontsize, FollowCursor und ScrollBars angepasst werden.
FixedDimensions
Vom Host gesendete Befehle, die Auflösung zu ändern, werden
ignoriert. Stattdessen werden fest die in der INI eingestellten
Werte für Rows und Columns verwendet.
FixedRoiDimensions
Wie FixedDimensions, jedoch für den ROI-Font-Befehl.
RoiFontScaling
Wird vom Host per ROI-Befehl eine andere Anzeigegröße
gewünscht, werden bei RoiFontScaling=1 alle Fontgrößen
probiert, um eine optimale Größe für die gewünschte Anzeige zu
finden. Bei RoiFontScaling=2 werden
außerdem die
Schriftgrößen bei doppelt hoher und/oder doppelt breiter Anzeige
probiert, um eine optimale Anzeige zu gewährleisten.
BackgroundColor
Einstellung der Hintergrundfarbe
ForegroundColor
Einstellung der Vordergrundfarbe (Textfarbe)
Folgende Farben können eingestellt werden:
0 Schwarz
8 Dunkelgrau
1 Rot
9 Hellrot
2 Grün
10 Hellgrün
3 Braun
11 Gelb
4 Blau
12 Hellblau
5 Magenta
13 Rosa
6 Cyan
14 Hellcyan
7 Hellgrau
15 Weiß
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 26 / 82
7
Map
Konfiguration
Umschaltung des oberen (G1/GR-) Teils (Byte 128 bis 255 bzw.
160 bis 254) des DEC Multinational Character Sets:
0
Standard G1/GR DEC Multinational Character Set
1
ISO-8859-1 / WIN 28591 (Latin-1 / Western European)
2
ISO-8859-2 / WIN 28592 (Latin-2 / Eastern European)
3
ISO-8859-3 / WIN 28593 (Latin-3 / Southern European)
4
ISO-8859-4 / WIN 28594 (Latin-4 / Baltic)
5
ISO-8859-5 / WIN 28595 (Cyrillic)
7
ISO-8859-7 / WIN 28597 (Greek (version from 2003))
9
ISO-8859-9 / WIN 28599 (Latin-5 / Turkey)
10
ISO-8859-10 (Latin-6 / Nordic)
13
ISO-8859-13 (Latin-7 / Baltic)
14
ISO-8859-14 (Latin-8 / Celtic)
15
ISO-8859-15 / WIN 28605 (Latin-9 / Western European)
16
ISO-8859-16 (Latin-10 / Southeast European)
437
OEM 437 (US)
737
OEM 737 (Greek)
850
OEM 850 (Multilingual Latin 1)
852
OEM 852 (Latin 2)
855
OEM 855 (Cyrillic)
857
OEM 857 (Turkish)
858
OEM 858 (Multilingual Latin 1 + Euro)
866
OEM 866 (Russian)
1250 WIN 1250 (Central Europe)
1251 WIN 1251 (Cyrillic)
1252 WIN 1252 (Latin 1)
1253 WIN 1253 (Greek)
1254 WIN 1254 (Turkish)
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 27 / 82
7
Konfiguration
Die Umschaltung ist teilweise für den Betrieb in Regionen
außerhalb Nordamerika und Westeuropa erforderlich.
Achtung: Die OEM- und WIN 12xx-Codepages sind nicht VTkonform! Bei ihrem Einsatz wird automatisch die Verarbeitung
von C1-Steuerzeichen (128 bis 159) abgeschaltet und
stattdessen werden die entsprechenden Zeichen der
ausgewählten Codepage angezeigt.
Darüber hinaus ist es möglich, eine einfache ASCII-Datei
namens "VT220Maps.txt" im TouchKonsolen-Verzeichnis
abzulegen. Diese Datei wird nach obigem Mapping geladen, um
einzelne Zeichen nochmals umzumappen. Jede Zeile enthält
zwei durch Leerzeichen getrennte HEX-Werte. Der linke Wert im
Bereich von 80 bis FF gibt das zu ersetzende Byte und der
rechte Wert das einzusetzende Unicode-Zeichen an. Bei Angabe
von Bytes im Bereich von 80 bis 9F wird automatisch die
Verarbeitung von C1-Steuerzeichen deaktiviert. Nur angegebene
Bytes werden überschrieben.
Z.B. bewirkt 88 20AC den Austausch von Byte 136 durch das €Zeichen.
BitMode
Festlegung, ob das Terminal die Daten zum Host im 7-Bit oder 8Bit-Modus übertragen soll
Anmerkung: der Host legt selbst fest, in welchem Modus er
sendet. Die TouchKonsole akzeptiert beim Empfang beide Modi
NewlineMode
Der NewlineMode legt fest, wie das Abschließen einer Zeile
gehandhabt wird; bei NewlineMode=0 schickt der Host Carriage
Return + Line Feed und das Terminal schickt bei Enter nur
Carriage Return; im NewlineMode=1 schickt der Host Line Feed
und des Terminal schickt bei Enter Carriage Return + Line Feed
BSsendsDel
Bei BSsendsDel=0 wird Backspace mit Key-Code 8 gesendet
und bei BSsendsDel=1 ist es Key-Code 127
CursorMode
Umschaltung der Cursortasten zwischen normalem Modus
(CursorMode=0) und Application-Modus (CursorMode=1); die
beiden Modi unterscheiden sich durch das Senden
unterschiedlicher Key-Codes und den u. U. damit verbundenen
differenzierten Aktionen
KeypadMode
Umschaltung des numerischen Ziffernblocks zwischen
numerischem Modus (KeypadMode=0) und Application-Modus
(KeypadMode=1); die beiden Modi unterscheiden sich durch das
Senden unterschiedlicher Key-Codes und den u. U. damit
verbundenen differenzierten Aktionen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 28 / 82
7
Konfiguration
HardResetMode
Der Parameter bestimmt, wie sich das Terminal beim Empfang
von "ESC c" verhält; die Einstellung HardResetMode=0 setzt den
Bildschirm zurück und führt einen Soft-Reset durch,
HardResetMode=1 startet das komplette Programm neu (inkl.
Neustart der TCP/IP-Verbindung)
Wait
Die TouchKonsole startet mit gesperrter Tastatur, bis diese vom
Host freigegeben wird (0=Tastatur frei, 1=gesperrt)
LocalEcho
Einschalten des lokalen Echos, d.h. alle Tasten, die gedrückt
werden, werden sofort auf dem Bildschirm dargestellt, ohne dass
sie vom Host gespiegelt werden müssen (0=aus, 1=an)
MultiNationalMode Mit MultiNationalMode=1 wird der multi-nationale Schriftsatz
eingestellt
SmoothScrolling
Einschalten des weichen Scrollens (0=aus, 1=an). Hierbei wird
mit max. 6 Zeilen pro Sekunde gescrollt
AutoWrapMode
Mit AutoWrapMode=1 wird bei Eingabe über das Zeilenende
hinaus automatisch zum Anfang der nächsten Zeile gesprungen.
Mit AutoWrapMode=0 bleibt der Cursor auf dem letzten Zeichen
der aktuellen Zeile stehen
InsertMode
Mit InsertMode=1 wird bei Texteingabe der Rest der Zeile
entsprechend nach rechts verschoben. Mit InsertMode=0 wird
der angezeigte Text überschrieben
DosMode
Bei einem VT220-Terminal bleibt der Cursor bei Rückschritt oder
Bewegung nach links auf dem ersten Zeichen der aktuellen Zeile
stehen. Mit DosMode=1 wird wie bei MS-DOS zum letzten
Zeichen der darüber liegenden Zeile gesprungen
PrimaryDA
Für
dieses
Attribut
wird
dtandardmäßig
62;1;2;6;9
zurückgegeben ("I am a service class 2 terminal (62) with 132
columns (1), printer port (2), selective erase (6), and I support 7bit national replacement character sets (9)."). Erwartet ein Host
eine andere Antwort, kann diese hier übersteuert werden.
SecondaryDA
Für dieses Attribut wird standardmäßig 10;203;0 zurückgegeben
("I am an IND Telnet terminal, my firmware version is 2.03, and I
have 0 options installed."). Erwartet ein Host eine andere
Antwort, kann diese hier übersteuert werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 29 / 82
7
Konfiguration
KeyboardLanguage
Für dieses Attribut wird dtandardmäßig 7 zurückgegeben
(german keyboard layout). Erwartet ein Host eine andere
Antwort, kann diese hier übersteuert werden. Gültige Werte sind
hierbei:
8
Dutch
1 North American
9
Italian
2 British
10 Swiss (French)
3 Flemish
11 Swiss (German)
4 French Canadian 12 Swedish
5 Danish
13 Norwegian
6 Finnish
14 French/Belgian
7 German
15 Spanish
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 30 / 82
7
Konfiguration
7.2.4 INI-Abschnitt: 5250
Achtung:
Bei 5250 sind einige Parameter, die bei VT220 einstellbar sind, fest vorgegeben:
Als Antwort auf Telnet-Kommando TTY wird fest "IBM-5292-2" zurückgegeben
Bei 5250 ist die Auflösung generell auf 24 Zeilen * 80 Spalten festgelegt
Map=273
Devname=TERMINAL1
ColSeps=1
TransmitAllUserVars=0
Map
Einstellung der Übersetzungstabelle der übertragenen Zeichen
Die TouchKonsole verfügt über folgende Tabellen:
37 USA, Kanada (englisch), Portugal, Brasilien, Australien, Neuseeland
256 Niederlande
273 Deutschland, Österreich
277 Dänemark, Norwegen
278 Finnland, Schweden
280 Italien
284 Spanien, Latein-Amerika
285 Großbritannien
297 Frankreich
200 Belgien, Kanada (französisch), Schweiz
871 Island
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 31 / 82
7
Konfiguration
Devname
Devname ist ein Parameter, der über Telnet-Parameteraustausch
(Subnegotiation) vom Host aus abgefragt werden kann, um den Namen
des Terminals festzustellen
ColSeps
Mit ColSeps=0 kann die Anzeige des Attributs "Spaltentrenner"
unterdrückt werden
Mit TransmitAllUserVars=1 Übermittlung aller UserVars, auch wenn
nur einzelne angefordert wurden
TransmitAllUserVars
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 32 / 82
7
Konfiguration
7.2.5 INI-Abschnitt: Windowed
Enabled=0
Left=1
Top=1
Enabled
Einschalten des Windowed-Mode. Dieser Modus schaltet automatisch
die Parameter "FollowCursor", "ScrollBars" sowie "SmoothScrolling"
aus. Der Modus bewirkt, dass der Bildschirm fest so verschoben ist,
dass die angegebene Koordinate als obere linke Ecke erscheint. Im
Gegensatz zur XP-Version kann aber nicht über den Rand des per
[VT220] "Rows" und "Columns" festgelegten Bildschirms hinaus
verschoben werden (bei 5250 ist der Bildschirm fest auf 24x80
eingestellt). In diesem Fall wird die Anzeige automatisch wieder
entsprechend nach rechts und unten verschoben, bis der Bildschirm
gefüllt ist. Um dies zu vermeiden, kann unter [Font] eine größere
Schriftart gewählt werden.
Left
Spalte, die nun als erste auf dem Bildschirm ausgegeben wird. Gültige
Werte sind 1 bis 200.
Top
Zeile, die nun als erste auf dem Bildschirm ausgegeben wird. Gültige
Werte sind 1 bis 100.
Sollte es im Betrieb Probleme mit diesem Modus geben, sollte zusätzlich der
Parameter "FixedDimensions" auf "1" gesetzt werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 33 / 82
7
Konfiguration
7.2.6 INI-Abschnitt: Setup
Admin=0
AdminPassword=123
Demo=0
BeepFile=3
BeepGraphically=0
MessageLED=0
ScreenSaver=1
ScreenSaverDelay=60
SIP=1
UserRestart=1
AutoRestart=1
FollowCursor=1
CursorType=1
ScrollBars=0
MessageLineAlwaysOn=1
TouchScreen=1
MenuShortcut=Ctrl+F1
FullScreen=1
ControlBox=1
MinimizeBox=1
OverrideColorCheck=0
PrinterPort=2
COM1Settings=9600,N,8,1,N,50
COM2Settings=9600,N,8,1,N,50
COM3Settings=9600,N,8,1,N,50
RoiCom1=1
RoiCom2=2
RoiCom3=3
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 34 / 82
7
Konfiguration
Admin
Schaltet den Admin-Modus ein/aus; Admin=0 erzwingt die
Passwortabfrage für das Aufrufen der Programmeinstellungen
beim Klicken der rechten oberen Ecke, bei Admin=1 ist die
Passwortabfrage abgeschaltet
AdminPassword
Festlegen des Passworts für den Admin-Modus (nur bei
Admin=0), dieses ist nicht case-sensitive
Demo
Bei Demo=1 erfolgt keine Verbindung mit dem Host (nur für
Demozwecke),
Demo=0
ist
der
Normalmodus
mit
Hostverbindung
BeepFile
BeepFile=1 gibt den Ton "Ding" aus, bei 2 ist es "Chord", 3 ist
"Robot", 4 ist "Train" und 5 ist "Oh-Oh"; alternativ kann eine
Wave-Datei mit Pfad angegeben werden; zum Beispiel:
"\Windows\notify.wav" – die Eingabe in der INI Datei erfolgt ohne
Anführungszeichen! Beepfile=9 erzeugt einen StandardSignalton aus dem Speaker; für alle anderen Töne ist eine
eingebaute Soundkarte notwendig.
BeepGraphically
BeepGraphically=1 schreibt das Wort "BEEP" auf das Display,
um dem Benutzer in lauten Umgebungen einen BEEP auch
optisch zu signalisieren; bei BeepGraphically=2 flackert nur die
LED und bei BeepGraphically=3 wird das Wort "BEEP" auf den
Bildschirm geschrieben und zusätzlich flackert die LED
MessageLED
Wenn die Standard LED nicht "0" ist, kann hier ein anderer Wert
eingetragen werden (die LED sollte im Stand-by blinken)
ScreenSaver
Um Strom zu sparen, kann der Bildschirm automatisch
abgeschaltet werden. Gleichzeitig wird ein automatisches
Ausschalten des Gerätes unterbunden (0=aus, 1=an). In
ScreenSaverDelay muss die zugehörige Zeit eingestellt werden
ScreenSaverDelay Zeit in Sekunden, nach der der Bildschirm abgeschaltet werden
soll (nur bei ScreenSaver=1)
SIP
Bei SIP=1 kann der Benutzer durch Anklicken der rechten
unteren Ecke die System-OnScreen-Tastatur einblenden.
UserRestart
UserRestart=1 ermöglicht dem Benutzer, auch ohne AdminModus selbstständig einen Restart durch Anklicken der linken
unteren Ecke durchzuführen
AutoRestart
Bei Verbindungsabbruch wird die TouchKonsole automatisch
neu gestartet (0=aus, 1=an; 2=erweitert); ist AutoRestart=0, so
kommt die Meldung "NO CONNECTION. TAP SCREEN TO
RETRY". Bei AutoRestart=2 wird (zusätzlich auch bei
Fehlschlagen des Verbindungsaufbaus) 30 Sekunden lang
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 35 / 82
7
Konfiguration
dauerhaft neu gestartet, bis eine Verbindung aufgebaut werden
konnte.
FollowCursor
Der Bildschirminhalt wird immer so verschoben, dass der Cursor
sichtbar ist (0=aus, 1=an)
CursorType
Ändern des Aussehens des Cursors; Cursortype=0 stellt einen
Unterstrich dar, Cursortype=1 einen Block-Cursor, CursorType=2
einen Kasten und CursorType=3 einen nicht-blinkenden Kasten
Scrollbars
vertikale und horizontale Scrollbars ein- bzw. ausschalten
(0=aus, 1=an)
MessageLineAlwaysOn
Dauerhaftes Einschalten der Statuszeile inkl. Batterie-Anzeige
(0=aus, 1=an)
Touchscreen
Mit Touchscreen = 0 kann dem Programm mitgeteilt werden,
dass das Terminal keinen Touchscreen besitzt; die Navigation
über Hardware-Tasten wird damit aktiviert (siehe auch
Parameter MenuShortCut)
MenuShortCut
Tastenkombination, über die das Menü aufgerufen werden kann.
Im Menü befinden sich die Funktionen, die sonst über die
Berührung der Ecken auf dem Bildschirm ausgelöst werden
können (siehe Bild unten); dieser Parameter ist nur aktiv, wenn
Touchscreen = 0 ist. Folgende Eingaben sind als Shortcut
möglich und können mit "+" verbunden werden: Shift, Ctrl, Alt,
a..z, 0..9, F1..F24, Enter, Esc, Ins, Del, Up, Down, Left, Right,
Backspace, Space, Tab, Decimal; Beispiele: "Ctrl+F1",
"Shift+Esc", "Shift+Alt+F2"
FullScreen
Normalerweise wird die TouchKonsole als Fullscreen-Applikation
ausgeführt, so dass ein Aufrufen von anderen Programmen nicht
möglich ist (FullScreen=1). Wenn die TouchKonsole als
normales Programm ausgeführt werden soll, kann dies über
FullScreen=0 eingestellt werden (s. auch die Parameter
ControlBox und MinimizeBox)
ControlBox
Beim Ausführen als normale Applikation kann die Titelleiste mit
Minimierenund
Beenden-Button
über
ControlBox=1
eingeblendet werden
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 36 / 82
7
Konfiguration
MinimizeBox
Auf Pocket PCs ist ein gleichzeitiges Anzeigen von Minimieren
und Schließen nicht vorgesehen. Es wird nur ein "X" angezeigt,
um das Programm in den Hintergrund zu stellen. Soll der "OK"Button zum Schließen angezeigt werden, kann dies über
MinimizeBox=0 geschehen
OverrideColorCheck
Die TouchKonsole verfügt über eine automatische Umschaltung
der Farbschemata, um eine optimale Darstellung auch auf
Graustufen-Geräten zu ermöglichen. Dies kann jedoch nicht
direkt abgefragt werden. Deshalb wird bei Geräten mit max. 256
Farben angenommen, dass es sich um Graustufen-Geräte
handelt. Wenn dies nicht der Fall ist, kann mit
OverrideColorCheck=1 wieder auf das Farbschema für ColorGeräte umgeschaltet werden
PrinterPort
Auswahl des COM-Ports, der beim Start der TouchKonsole
standardmäßig genutzt werden soll. 0=deaktiviert, 1..3=COMAnschluss 1 bis 3. Der Anschluss kann vom Server über ROIBefehle geändert werden
COMxSettings
Konfiguration von COM-Port 1 bis 3 für Reader und Printer:
Reihenfolge:
Baudrate, Parity, DataBits, StopBits, Handshake, Timeout
Standard: 9600,N,8,1,N,50
Gültige Werte sind:
1
2
3
4
5
6
(optional)
(optional)
(optional)
(optional)
(optional)
(optional)
Baudrate
Parity
DataBits
StopBits
Handshake
Timeout
300
600
1200
2400
4800
9600
14400
19200
38400
57600
115200
N
7
(=None) 8
O
(=Odd)
E
(=Even)
M
(=Mark)
S
(=Space)
1
1.5
2
N
1
(=None)
..
S
1000
(=XOn/XOff)
H
(=CTS/RTS)
D
(=DSR/DTR)
Der Timeout gibt die Wartezeit in ms nach dem letzten
empfangenen Zeichen an, bevor Daten gesendet werden.
Sollten ein oder mehrere Parameter fehlen oder ungültig sein,
werden die entsprechenden Standard-Werte eingesetzt
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 37 / 82
7
Konfiguration
Alternativ zu den physikalischen COM-Ports können auch UDPPorts definiert werden, an die die Daten geschickt werden
können. Optional kann auch ein lokaler Listen-Port für die ReadAnweisungen spezifiziert werden. Der lokale Port und der der
Gegenstelle können gleich sein. Die Einstellung erfolgt über das
Stichwort UDP sowie die IP und den Port der Gegenstelle.
Äquivalent zu den COM-Settings erfolgt die Trennung durch
Kommata.
Reihenfolge:
Protocol, RemoteIP, RemotePort, LocalPort
Beispiele:
COM1Settings=UDP,192.168.1.1,8000
COM1Settings=UDP,192.168.1.1,8000,8000
1
2
3
4
(fest)
(Pflichtfeld)
(Pflichtfeld)
(optional)
Protocol RemoteIP RemotePort LocalPort
UDP
X.X.X.X
XXXX
XXXX
Ab Version 2.3.0.50 kann auch der Parameter DTS angegeben
werden. Dies bewirkt, dass beim Öffnen eines Reader-Kanals
(durch den Server) gescannte Barcodes nun auf diesen ReaderKanal umgelenkt werden. Die Barcodes werden hierbei
zusätzlich mit den ASCII-Zeichen 0x02 (STX) und 0x03
(ETX)umrahmt.
Beispiel:
COM1Settings=DTS
RoiComx
Der Server kann per ROI-Kommando zwischen COM1, COM2
und COM3 wählen. Diese Auswahl entspricht standardmäßig
obigen COMxSettings. Wird ein Terminal, das nur über COM1
verfügt, durch ein Terminal ersetzt, das nur über Com2 verfügt,
so müsste der Server entsprechend angepasst werden.
Stattdessen kann hier ein anderer Port aus den obigen
Einstellungen gewählt werden. Der ersetzte Port muss hierbei
durch den Wert 0 abgeschaltet werden, z.B.:
RoiCom1=2
RoiCom2=0
RoiCom3=3
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 38 / 82
7
Konfiguration
7.2.7 INI-Abschnitt: Font
Size=2
Bold=0
DoubleWidth=0
DoubleHeight=0
Size
Einstellung der Standard-Schriftgröße, mit der die IND
TouchKonsole die Emulation startet; die Größe kann Werte von 0
bis 11 annehmen; die Schriftgröße kann auch per Schiebebalken
in den Programmeinstellungen geändert werden, ist dann aber
nicht dauerhaft gesetzt
Bold
Generelle Nutzung der Fettschrift (0=aus, 1=an); hierzu muss die
Fettschriftart auf dem Gerät installiert sein
Aufgrund von Unterschieden bei der Umsetzung der Font-Größen auf den
Plattformen Pocket PC 2002, 2003 und CE.NET sowie des weiteren Windows Mobile
und CE 5 ist die Darstellung der Fonts geringfügig abweichend. Die ungefähren
Werte sind der nachstehenden Tabelle zu entnehmen (Angaben in Spalten * Zeilen):
Size
PPC 2002
PPC 2003
CE.NET
0
80 * 53
80 * 53
80 * 53
1
48 *40
48 *40
48 *35
2
34 * 23
40 * 26
34 * 26
3
34 * 21
34 * 21
34 * 23
4
30 * 20
30 * 20
30 * 21
5
24 * 18
24 * 18
24 * 18
6
22 * 15
22 * 16
22 * 14
7
18 * 14
18 * 14
18 * 13
8
17 * 12
17 * 12
17 * 12
9
15 * 10
15 * 11
15 * 10
10
11 * 8
12 * 8
11 * 8
11
10 * 7
10 * 7
10 * 7
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 39 / 82
7
Konfiguration
DoubleWidth
Falls die Einstellung der Größe über Size nicht ausreichen sollte,
kann die Ausgabe auf dem Bildschirm mit diesem Parameter auf
die doppelte Breite gezoomt werden.
DoubleHeight
Falls die Einstellung der Größe über Size nicht ausreichen sollte,
kann die Ausgabe auf dem Bildschirm mit diesem Parameter auf
die doppelte Höhe gezoomt werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 40 / 82
7
Konfiguration
7.2.8 INI-Abschnitt: ColorDefinition
Die Darstellung der sechzehn Farben kann umdefiniert werden, indem den einzelnen
Farben neue RGB-Farbwerte zugewiesen werden. In der INI-Datei entspricht
"Color0" der Farbe 0, also schwarz; bei ColorF handelt es sich um die Farbe 15, also
weiß (siehe o. g. Tabelle). Die zugewiesene RGB-Farbe muss in den
entsprechenden Hexadezimalwert umgerechnet werden. Hier als Beispiel die
Definition aller Farben mit ihren ursprünglichen Werten. Die INI-Einträge können
entfallen, wenn die Originalfarben beibehalten werden sollen.
Color0=000000
Color1=FF0000
Color2=008000
Color3=C0853F
Color4=0000FF
Color5=FF00FF
Color6=00FFFF
Color7=D3D3D3
Color8=A9A9A9
Color9=FF6347
ColorA=90EE90
ColorB=FFFF00
ColorC=ADD8E6
ColorD=FF69B4
ColorE=E0FFFF
ColorF=FFFFFF
Bei monochromen Displays wird ein alternatives Farbschema geladen, das aber
ebenso durch diese Einstellungen verändert werden kann.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 41 / 82
7
Konfiguration
7.2.9
INI-Abschnitt: TouchPad.*
Je nachdem, ob VT220 oder 5250 eingestellt worden ist, heißt die Sektion
"[Touchpad.VT220]" oder "[Touchpad.5250]". Die Schlüssel hierzu sind allerdings
gleich. Ab Version 2.1 wird unterschieden, ob die TouchKonsole im Hochformat oder
Querformat ausgeführt wird. Die alten INI-Parameter werden alternativ weiterhin
unterstützt.
Enabled=1
BackColor=7
Style=0
PortraitUL=1
PortraitUR=2
PortraitLL=3
PortraitLR=4
LandscapeUL=5
LandscapeUR=6
LandscapeLL=7
LandscapeLR=8
PanelHeight=64
ButtonWidth=40
ButtonHeight=40
AlwaysOn=0
DefaultPortraitLayout=1
DefaultLandscapeLayout=5
ButtonDefaultTextSize=16
ButtonDefaultBackColor=8
ButtonDefaultForeColor=0
Enabled
Aktivierung der virtuellen Tastatur (0=aus, 1=an)
BackColor
Hintergrundfarbe der virtuellen Tastatur; siehe auch Farbtabelle
unter "INI-Abschnitt: VT220"
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 42 / 82
7
Konfiguration
Style
Festlegung des Button-Styles: 0 sind runde und 1 sind eckige
Buttons. Auf dem Quadrino werden automatisch eckige Buttons
angezeigt.
PortraitUL
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Hochformat der obere linke (upper-left) Bereich
des Bildschirms berührt wird
PortraitUR
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Hochformat der obere rechte (upper-right) Bereich
des Bildschirms berührt wird
PortraitLL
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Hochformat der untere linke (lower-left) Bereich
des Bildschirms berührt wird
PortraitLR
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Hochformat der untere rechte (upper-right) Bereich
des Bildschirms berührt wird
LandscapeUL
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Querformat der obere linke (upper-left) Bereich
des Bildschirms berührt wird
LandscapeUR
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Querformat der obere rechte (upper-right) Bereich
des Bildschirms berührt wird
LandscapeLL
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Querformat der untere linke (lower-left) Bereich
des Bildschirms berührt wird
LandscapeLR
Angabe des Layouts der virtuellen Tastatur, die geladen werden
soll, wenn bei Querformat der untere rechte (upper-right) Bereich
des Bildschirms berührt wird
PanelHeight
Einstellung der Höhe des TouchPads in Pixeln (Standard=64).
Wird mehr oder weniger Platz benötigt, kann die Höhe hier
eingestellt werden.
ButtonWidth
Die Breite eines TouchPad-Buttons in Pixeln (Standard=40).
Werden Buttons in anderer Größe oder rechteckige bzw.
elliptische Buttons benötigt, kann dies hier optimiert werden.
ButtonHeight
Die Höhe eines TouchPad-Buttons in Pixeln (Standard=40).
Werden Buttons in anderer Größe oder rechteckige bzw.
elliptische Buttons benötigt, kann dies hier optimiert werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 43 / 82
7
Konfiguration
AlwaysOn
Dauerhaftes Einschalten des Touchpads (0=aus, 1=an). Es kann
zwischen verschiedenen Layouts durch Berühren der
entsprechenden Bereiche auf dem Bildschirm gewechselt
werden, jedoch kann das Touchpad nicht mehr ausgeblendet
werden
DefaultPortraitLayout
Name des Touchpads, das nach dem Start bei Verwendung von
AlwaysOn und Hochformat-Anzeige angezeigt wird
DefaultLandscapeLayout
Name des Touchpads, das nach dem Start bei Verwendung von
AlwaysOn und Querformat-Anzeige angezeigt wird
ButtonDefaultTextSize
Standardwert für die Textgröße der Buttonbeschriftung
ButtonDefaultBackColor
Standardwert für die Hintergrundfarbe der Buttons
ButtonDefaultForeColor
Standardwert für die Textfarbe der Buttonbeschriftung
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 44 / 82
7
Konfiguration
7.2.10 INI-Abschnitt: Layout*
Ab Version 2.1 ist die Anzahl der Buttons nicht mehr fest auf fünf eingestellt. Es
können dem folgenden Schema entsprechend auch mehr definiert werden. Die
Anzahl wird automatisch erkannt und beim Wechsel des Layouts dynamisch
angepasst. Für den Betrieb der TouchKonsole im Querformat sind sechs Buttons ein
idealer Wert.
Button1Text=F1
Button1Sequence={F1}
Button2Text=F2
Button2Sequence={F2}
Button3Text=F3
Button3Sequence={F3}
Button4Text=F4
Button4Sequence={F4}
Button5Text=more
Button5Sequence={Goto2}
Button5TextSize=10
Button5ForeColor=0
Button5BackColor=11
Das Auslassungszeichen <x> steht jeweils für den Index des Buttons: "1" .. "5":
Button<x>Text
Beschriftung des jeweiligen Buttons
Button<x>Sequence
Zeichencode des jeweiligen Buttons, der an den Host geschickt
wird; hierbei handelt es sich um das jeweilige Zeichen
("Button1Sequence=a") oder um einen einzelnen Makro-Befehl
oder eine Makro-Sequenz (siehe Abschnitt "Makro-Befehle");
eine Besonderheit ist das Wechseln auf eine weitere,
verschachtelte Tastatur mit "GOTO" bzw. Ausblenden des
TouchPads mit "HIDE".
Button<x>TextSize
Font-Größe der Beschriftung des jeweiligen Buttons; dieser Wert
überschreibt den Standard aus ButtonDefaultTextSize
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 45 / 82
7
Konfiguration
Button<x>ForeColor
Textfarbe der Beschriftung des jeweiligen Buttons; dieser Wert
überschreibt den Standard aus ButtonDefaultForeColor; es kann
verwendet werden, um z.B. die Verzweigung auf eine weitere
Tastatur farblich zu kennzeichnen
Button<x>BackColor
Hintergrundfarbe des jeweiligen Buttons; dieser Wert
überschreibt den Standard aus ButtonDefaultBackColor; es kann
verwendet werden, um z.B. die Verzweigung auf eine weitere
Tastatur farblich zu kennzeichnen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 46 / 82
7
Konfiguration
7.2.11 INI-Abschnitt: KeyboardMapping
Keyboard-Mapping bietet Unterstützung bei fehlenden Hardwaretasten. Hier können
Ersatztasten spezifiziert werden, die statt der gedrückten Taste gesendet werden
sollen. Hierzu einige Beispiele:
SHIFT+3=F3
.=,
CTRL+A=LEFT
LEFT=MACRO:{BACKTAB}
RIGHT=TAB
F10=MACRO:{FIELDPLUS}
SHIFT+ESC=MACRO:{QUIT}
a=MACRO:{SPACE}{65}{66}
F5=Macro:{esc}[16~
Auf der linken Seite steht jeweils die in Wirklichkeit gedrückte Taste, die ersetzt
werden soll, und auf der rechten Seite die darauf folgende Aktion.
Die zu ersetzende Taste kann entweder als Zeichen (z.B. "*") oder als
Keycodebezeichner (z.B. "MULTIPLY") angegeben werden. Nicht sichtbare Zeichen
(ASCII-Wert kleiner 32) und Tasten ohne ASCII-Code (z.B. "F1" oder "SHIFT")
müssen immer als Keycodebezeichner angegeben werden. Weiterhin müssen für
Leerzeichen, Pluszeichen und Gleichheitszeichen die Keycodebezeichner "SPACE",
"PLUS" und "EQUAL" genutzt werden, da sie Teil der Syntax sind.
Eine Taste kann jeweils zusammen mit der Shift-, Control- oder Alt-Taste gedrückt
werden. Die beiden Tasten werden dann mit einem Pluszeichen verbunden. Beispiel:
"SHIFT+F1=…". Kombinationen von diesen drei Tasten werden auf den Terminals in
der Regel nicht unterstützt.
Bei Auswertung der zu ersetzenden Taste ist darauf zu achten, dass hier der
Tastaturcode der gedrückten Taste und nicht ihre ASCII-Entsprechung verarbeitet
wird. Lediglich zur Vereinfachung der Definition werden die Zeichen bzw.
Keycodebezeichner verwendet. Eine Taste kann zusammen mit der Shift-, Controloder Alt-Taste gedrückt werden. Kombinationen von diesen drei Tasten werden auf
dem Pocket PC in der Regel nicht unterstützt. Das Keyboard-Mapping ist außerdem
auf das amerikanische Tastatur-Layout abgestimmt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 47 / 82
7
Konfiguration
Bei der Aktion, die auf der rechten Seite des Gleichheitszeichens folgt, kann es sich
entweder um eine Taste, einen Aktionscode oder eine Makro-Sequenz handeln. Um
eine Makro-Sequenz handelt es sich, wenn ein Makro-Befehl (siehe Tabelle über
Makro-Befehle unter "INI-Abschnitt: Layout") genutzt wird oder eine Abfolge
verschiedener Zeichen. Wenn es sich um eine Makro-Sequenz handelt, muss in
jedem Fall das reservierte Wort "MACRO:" vorangestellt werden.
Folgende Keycodebezeichner sind verfügbar:
Keycodebezeichner
CTRL / CONTROL
SHIFT
ALT
LEFT / RIGHT / UP / DOWN
BACKSPACE / BACK
DELETE / DEL
ENTER / RETURN
TABULATOR / TAB
END
ESCAPE / ESC
HOME
INSERT / INS
PAGEUP
PAGEDOWN / PAGEDN
SPACE
ADD
SUBTRACT
MULTIPLY
DIVIDE
TILDE
COMMA
PERIOD
QUESTION / QM
OPENBRACKET
CLOSEBRACKET
SEPARATOR / SEP
SEMICOLON
QUOTE
a..z, A..Z
0..9
F1..F20/F24
entspricht Taste
SHIFT + Taste
=
*
/
~
,
.
/
[
]
\
;
'
a..z
0..9
+
_
`
<
>
?
{
}
|
:
"
A..Z
)..(
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 48 / 82
7
Konfiguration
Das Keyboard-Mapping funktioniert nach folgender Syntax:
Zeichen | { SHIFT | CTRL | ALT + } Keycodebezeichner = Zeichen | Aktionscode | Makrosequenz
"|" entspricht einem logischen Oder und "{ }" umschließt einen optionalen Teil.
Zulässige Zeichen sind alle ASCII-Zeichen von 33 bis 255. Als Aktionscodes sind
erlaubt: F1..F20/F24, LEFT, RIGHT, UP, DOWN, SPACE, PLUS, EQUAL.
Achtung: Da die Tastaturcodes der Tasten zum Host gesendet werden, müssen
Großbuchstaben immer im Zusammenhang mit "SHIFT" verwendet werden. Soll das
erstetzte Zeichen ein Großbuchstabe sein, muss daher eine Makro-Sequenz
verwendet werden. Vorsicht, bei Makro-Sequenzen gelten wiederum die ASCIIZeichen und nicht die Tastaturcodes! Hierzu ein Beispiel, bei dem die Logik der ShiftTaste für die Taste "A" gedreht wird:
a=MACRO:A
oder
a=SHIFT+a
SHIFT+a=MACRO:a
oder
SHIFT+a=a
"a=SHIFT+a" ist der einzige Sonderfall, bei dem auch auf der rechten Seite "SHIFT+"
erlaubt ist!
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 49 / 82
7
Konfiguration
7.2.12 INI-Abschnitt: Scanner
Die TouchKonsole ist in der Lage, die Barcodescanner diverser Geräte direkt
anzusteuern oder mit den entsprechenden externen Programmen zu kommunizieren.
Außerdem werden diverse zusätzliche Funktionen zur Barcode-Behandlung
angeboten.
Ab Version 2.3.0.50 unterstützt die TouchKonsole ein weiteres Feature des
abgelösten Terminals FTF2440. Hierbei können gescannte Barcodes auf einen
Reader-Kanal umgeleitet werden, sobald der Host diesen öffnet. Siehe hierzu [Setup]
COMxSettings.
ScannerType=0
ShowScannedBarcode=0
ScannerOnSound=1
ScannerOffSound=3
MultiScan=1
TransmitCodeID=0
BarcodeScript=A(0)[A\0D]
Prefix=
Suffix={ENTER}
AutoInhibit=0
SoftTrigger=0
ScannerType
0 schaltet den internen Treiber ab. Wenn ein Barcodescanner
vorhanden ist und verwendet werden soll, so muss dies durch
ein externes Programm (z.B. ScanWedge) geschehen, das die
empfangenen Barcodes in den Tastaturpuffer schreibt. Siehe
hierzu auch ScannerType 3 und 4.
1 verwendet den internen Symbol Scannertreiber. Dies bedingt
die
Verwendung
der
speziellen
Symbol-Version
der
TouchKonsole. Außerdem muss bei Verwendung dieses Treibers
die ScanWedge bzw. DataWedge deaktiviert werden! Die
Konfiguration des Barcodescanners erfolgt dabei in den
Abschnitten Scanner.Symbol.*.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 50 / 82
7
Konfiguration
2 verwendet den internen Intermec Scannertreiber. Dies bedingt
die Verwendung der speziellen Intermec-Version der
TouchKonsole. Die Konfiguration des Barcodescanners erfolgt
dabei in den Abschnitten Scanner.Intermec.*.
3 verwendet eine spezielle Schnittstelle des Quadrinos (bzw. der
OEM-Varianten anderer Anbieter) ab Software-Version 1.5. Die
Quadrino ScanWedge findet Verwendung (und muss
dementsprechend im ControlPanel konfiguriert werden), jedoch
werden die empfangenen Barcodes nicht in den Tastaturpuffer
geschrieben. Stattdessen meldet sich die TouchKonsole per
TCP/IP direkt an der ScanWedge an und empfängt auf diesem
Weg die Daten, was einen Geschwin-digkeitszuwachs bedeutet
und auch Funktionen wie das Barcode Scripting zur Verfügung
stehen. Die Übergabe des Barcode-Typen vom Scanner kann
nur mittels Symbol Code ID erfolgen. Die Konfiguration erfolgt im
Abschnitt Scanner.IND.
4 verwendet keinen internen Treiber. Die Daten werden wie bei
ScannerType 0 von einem externen Programm in den
Tastaturpuffer geschrieben. Falls dieses externe Programm
(bzw. der Barcodescanner selbst) so konfiguriert werden kann,
dass als Prefix ASCII-Zeichen 02 (STX / Start of Text) und als
Suffix 03 (ETX / End of Text) gesendet wird, kann die
TouchKonsole dies erkennen und den Barcode ausschneiden.
Somit steht auch das Barcode Scripting etc. zur Verfügung. Die
Übergabe des Barcode-Typen vom Scanner kann nur mittels
Symbol Code ID erfolgen. Die Konfiguration erfolgt im Abschnitt
Scanner.KeyboardWedge.
ShowScannedBarcode
Anzeige des gescannten Barcodes
(0=aus, 1=an)
in der Messagezeile
ScannerOnSound /
ScannerOffSound Beim servergesteuerten (bzw. bei 5250 automatischen) Ein- bzw.
Ausschalten des Barcode-Scanners kann zusätzlich ein Ton
abgespielt werden, um dem Benutzer die Aktion akustisch zu
signalisieren. Die Auswahl der Werte ist hier identisch wie unter
"BeepFile" beschrieben (s. "INI-Abschnitt: Setup")
MultiScan
Scannen desselben
(0=aus, 1=an)
Barcodes
hintereinander
zulassen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 51 / 82
7
Konfiguration
TransmitCodeID
Dem gescannten Barcode wird vor der Übertragung zum Host
ein Buchstabe (Symbol Code-ID) vorangestellt, der den Typ des
Barcodes kennzeichnet. Dies bedingt bei ScannerType 3 oder 4,
dass der entsprechende Typ auch vom Barcodescanner geliefert
wird:
A
UPC-A / UPC-E0 / UPC-E1 / EAN-8 / EAN-13
B
Code 39 / Code 32
C
Codabar
D
Code 128 / ISBT 128
E
Code 93
F
I2of5 (Interleaved 2 of 5)
G
D2of5 / IATA D2of5 (Discrete 2 of 5)
H
Code 11
J
MSI
K
EAN 128
L
Bookland EAN
M Trioptic Code 39
N
Coupon Code
X
other type
BarcodeScript
Der Barcode kann von der TouchKonsole bereits vor dem
Senden an den Host manipuliert werden. Hierzu wurde ein
umfangreicher Script-Interpreter implementiert. Dieser wird im
Abschnitt "Barcode-Scripting" beschrieben. Achtung: "Prefix" und
"Suffix" sollten auskommentiert werden, da sie sonst
anschließend verarbeitet werden.
Prefix
Es wird dem Barcode ein Präfix vorangestellt, wobei MakroSequenzen verwendet werden können (siehe "INI-Abschnitt:
Layout"). Es kann alternativ unter "BarcodeScript" auch der
Befehl "A(0)[P…]" verwendet werden.
Suffix
Es wird an das Ende des Barcodes ein Suffix angehängt, wobei
Makro-Sequenzen verwendet werden können (siehe "INIAbschnitt: Layout"). Es kann alternativ unter "BarcodeScript"
auch der Befehl "A(0)[A…]" verwendet werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 52 / 82
7
Konfiguration
AutoInhibit
Nach erfolgreichen Scannen kann die TouchKonsole den
Scanner automatisch für eine Zeit von bis zu 30 Sekunden
abschalten, um den zeitlichen Abstand zwischen zwei Scans
künstlich zu vergrößern (0=deaktiviert, 1..30=aktiviert)
SoftTrigger
Bei manchen Geräten kann es durch ungünstige Lage der ScanTasten sinnvoll sein, den Scan-Strahl durch Drücken auf den
Bildschirm zu aktivieren. Hierzu wird unter Abschnitt
"TouchPad.*" der entsprechende Quadrant "PortraitXX" bzw.
"LandscapeXX" auf "0" gesetzt. Zusätzlich muss diese Funktion
hier durch Setzen auf "1" freigeschaltet werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 53 / 82
7
Konfiguration
7.2.13 INI-Abschnitt: Scanner.Symbol.*
Es gibt einen allgemeinen Abschnitt "[Scanner.Symbol.Parameters]" und für jeden
Barcodetyp einen weiteren spezifischen Abschnitt, wie zum Beispiel
"[Scanner.Symbol.UPCA]"
[Scanner.Symbol.Parameters]
GoodDecodeBeep=1
GoodDecodeBeepFrequency=3333
GoodDecodeBeepTime=333
GoodDecodeLEDTime=333
BadDecodeBeep=1
BadDecodeBeepFrequency=333
BadDecodeBeepTime=666
BadDecodeLEDTime=999
GoodDecodeBeep
Einschalten des Pieptons bei gelesenem Barcode (0=aus, 1=an)
GoodDecodeBeepFrequency
Tonhöhe des Pieptons in Hertz bei gelesenem Barcode
GoodDecodeBeepTime
Dauer des Pieptons in Millisekunden bei gelesenem Barcode
GoodDecodeLEDTime
Dauer des LED-Leuchtens in Millisekunden bei gelesenem
Barcode
BadDecodeBeep
Einschalten des
(0=aus, 1=an)
BadDecodeBeepFrequency
Tonhöhe des Pieptons in Hertz bei nicht gelesenem Barcode
BadDecodeBeepTime
Dauer des Pieptons in Millisekunden bei nicht gelesenem
Barcode
BadDecodeLEDTime
Dauer des LED-Leuchtens in Millisekunden bei nicht gelesenem
Barcode
Pieptons
bei
nicht
gelesenem
Barcode
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 54 / 82
7
Konfiguration
[Scanner.Symbol.UPCA]
[Scanner.Symbol.Codabar]
[Scanner.Symbol.D2OF5]
Enabled=1
Enabled=1
Enabled=1
ReportCheckDigit=0
Min=0
Min=0
Preamble=0
Max=0
Max=0
Redundancy=0
Redundancy=0
[Scanner.Symbol.UPCE0]
CLSIEditing=0
Enabled=1
[Scanner.Symbol.Code11]
NOTISEditing=0
ReportCheckDigit=0
Enabled=1
Preamble=0
[Scanner.Symbol.Code128]
Min=0
ConvertToUPCA=0
Enabled=1
Max=0
EAN128Enabled=1
Redundancy=0
ISBT128Enabled=1
ReportCheckDigit=0
Other128Enabled=1
CheckDigitCount=0
[Scanner.Symbol.UPCE1]
Enabled=1
ReportCheckDigit=0
Min=0
Preamble=0
[Scanner.Symbol.MSI]
Max=0
ConvertToUPCA=0
Enabled=1
Redundancy=0
Min=0
[Scanner.Symbol.EAN13]
[Scanner.Symbol.Code93]
Max=0
Enabled=1
Redundancy=0
[Scanner.Symbol.EAN8]
Min=0
CheckDigitCount=0
Enabled=1
Max=0
CheckDigitScheme=0
ConvertToEAN13=0
Redundancy=0
ReportCheckDigit=0
[Scanner.Symbol.Code39]
[Scanner.Symbol.I2OF5]
Enabled=1
Enabled=1
Min=0
Min=0
Max=0
Max=0
Redundancy=0
Redundancy=0
ReportCheckDigit=0
CheckDigitScheme=0
VerifyCheckDigit=0
ReportCheckDigit=0
FullASCII=0
ConvertToEAN13=0
Enabled=1
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 55 / 82
7
Konfiguration
Enabled
Dieser Barcode-Typ wird zugelassen (0=aus, 1=an)
ReportCheckDigit
Die Prüfziffer wird an die Anwendung übergeben (0=aus, 1=an)
Preamble
Preamble=0: dem Barcode wird keine Präambel vorangestellt,
Preamble=1: dem Barcode wird die Nummernsystem-ID
vorangestellt (eine 1 für UPC E1 und eine 0 für alle anderen
UPC-Typen), Preamble=2: dem gescannten Barcode wird
zusätzlich vor der Nummernsystem-ID noch eine 0 als
Platzhalter für den Ländercode vorangestellt
ConvertToUPCA
Konvertierung von UPC E0 bzw. E1 nach UPCA (0=aus, 1=an)
ConvertToEAN13
Konvertierung von EAN 8 nach EAN 13 (0=aus, 1=an)
Min
Minimal zulässige Länge des Barcodes
Max
Maximal zulässige Länge des Barcodes
Redundancy
Einschalten der Redundanzprüfung (0=aus, 1=an): Der Scanner
schaltet sich nach dem ersten Erkennen des Barcodes nicht ab,
sondern scannt ihn ein zweites Mal. Nur wenn beide Scans
übereinstimmen, wird der Barcode weitergeleitet.
VerifyCheckDigit
Barcode abweisen, wenn Prüfziffer ungültig ist
FullASCII
FullASCII ist eine besondere Funktionalität vom Code 39
Barcode, der den gesamten ASCII-Zeichensatz zur Verfügung
stellt (0=aus, 1=an)
CLSIEditing
Der Codabar Barcode wird formatiert: Start- und Stop-Zeichen
werden entfernt und nach dem ersten, fünften und zehnten
Zeichen wird ein Leerzeichen eingefügt (0=aus, 1=an)
NOTISEditing
Start- und Stop-Zeichen des Codabar Barcodes werden entfernt
(0=aus, 1=an)
EAN128Enabled
Innerhalb des Codes 128 wird der EAN 128 freigeschaltet
(0=aus, 1=an)
ISBT128Enabled
Innerhalb des Codes 128 wird der ISBT 128 freigeschaltet
(0=aus, 1=an)
Other128Enabled
Innerhalb des Codes 128
freigeschaltet (0=aus, 1=an)
werden
alle
weiteren
Typen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 56 / 82
7
Konfiguration
CheckDigitScheme
Bei MSI: CheckDigitScheme=0 bedeutet, dass die Prüfziffer nach
Modulo 11/10 berechnet wird und bei CheckDigitScheme=1 nach
Modulo 10/10; bei I2OF5 gilt folgendes: 0=kein Schema, 1=USS
Schema und 2=OPCC Schema
CheckDigitCount
Anzahl der Prüfziffern: Code 11 kann 0,1 oder 2 Prüfzifferstellen
besitzen (Werte: 0, 1, 2) und MSI 1 oder 2 Stellen (Werte: 0, 1),
Achtung: die Prüfziffern zählen nicht zur Länge des Barcodes
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 57 / 82
7
Konfiguration
7.2.14 INI-Abschnitt: Scanner.Intermec.*
Es gibt für jeden Barcodetyp einen spezifischen Abschnitt, wie zum Beispiel
"[Scanner.Intermec.UPCA]". Die Lautstärke des Scanner-Piepens kann nur über die
Windows-Lautstärkeregelung eingestellt werden, deswegen entfällt dieser Abschnitt.
[Scanner.Intermec.UPCA]
[Scanner.Intermec.Codabar]
[Scanner.Intermec.D2OF5]
Enabled=1
Enabled=1
Enabled=1
ReportCheckDigit=0
Min=3
[Scanner.Intermec.Code11]
CLSIEditing=0
Enabled=1
[Scanner.Intermec.UPCE]
ReportCheckDigit=0
Enabled=1
[Scanner.Intermec.Code128]
ReportCheckDigit=0
Enabled=1
[Scanner.Intermec.MSI]
[Scanner.Intermec.EAN13]
EAN128Enabled=1
Enabled=1
Enabled=1
ISBT128Enabled=1
Min=1
Min=1
ReportCheckDigit=0
[Scanner.Intermec.EAN8]
Enabled=1
[Scanner.Intermec.Code93]
ConvertToEAN13=0
Enabled=1
[Scanner.Intermec.Code39]
[Scanner.Intermec.I2OF5]
Enabled=1
Enabled=1
Min=0
Min=2
ReportCheckDigit=0
CheckDigitScheme=0
VerifyCheckDigit=0
ReportCheckDigit=0
FullASCII=0
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 58 / 82
7
Konfiguration
Enabled
Dieser Barcode-Typ wird zugelassen (0=aus, 1=an)
ReportCheckDigit
Die Prüfziffer wird an die Anwendung übergeben (0=aus, 1=an)
ConvertToEAN13
Konvertierung von EAN 8 nach EAN 13 (0=aus, 1=an)
Min
Minimal zulässige Länge des Barcodes. Der Wertebereich ist je
nach Barcode-Typ unterschiedlich. Die kleinstmöglichen Werte
sind obiger Tabelle zu entnehmen.
VerifyCheckDigit
Barcode abweisen, wenn Prüfziffer ungültig ist
FullASCII
FullASCII ist eine besondere Funktionalität vom Code 39
Barcode, der den gesamten ASCII-Zeichensatz zur Verfügung
stellt (0=aus, 1=an)
CLSIEditing
Der Codabar Barcode wird formatiert: Start- und Stop-Zeichen
werden entfernt und nach dem ersten, fünften und zehnten
Zeichen wird ein Leerzeichen eingefügt (0=aus, 1=an)
EAN128Enabled
Innerhalb des Codes 128 wird der EAN 128 freigeschaltet
(0=aus, 1=an)
ISBT128Enabled
Innerhalb des Codes 128 wird der ISBT 128 freigeschaltet
(0=aus, 1=an)
CheckDigitScheme
Bei MSI: CheckDigitScheme=0 bedeutet, dass die Prüfziffer nach
Modulo 11/10 berechnet wird und bei CheckDigitScheme=1 nach
Modulo 10/10; bei I2OF5 gilt folgendes: 0=kein Schema, 1=USS
Schema und 2=OPCC Schema
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 59 / 82
7
Konfiguration
7.2.15 INI-Abschnitt: Scanner.IND
Port=8001
TransmitsCodeID=1
Port
TCP-Port, über den sich die TouchKonsole bei der Quadrino
ScanWedge (bzw. bei der ScanWedge der OEM-Varianten
anderer Anbieter) anmeldet, um die Barcodes zu empfangen.
TransmitsCodeID
Der Typ des Barcodes kann nur als dem Barcode vorangestellter
Buchstabe (Symbol Code ID) übermittelt werden. Wenn der
Barcodescanner dementsprechend eingestellt worden ist, wird
bei TransmitsCodeID=1 dieser Buchstabe abgeschnitten und der
entsprechende Barcode-Typ dem Barcode Scripting übergeben.
Achtung: Für UPC-A, UPC-E0, UPC-E1, EAN8 und EAN13 wird
derselbe Buchstabe übergeben. Im Barcode Scripting kann somit
zwischen diesen Typen nicht unterschieden werden. Falls auf
einen dieser Typen abgefragt werden soll, muss im Script EAN13
angegeben werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 60 / 82
7
Konfiguration
7.2.16 INI-Abschnitt: Scanner.KeyboardWedge
TransmitsCodeID=1
TransmitsCodeID
Der Typ des Barcodes kann nur als dem Barcode vorangestellter
Buchstabe (Symbol Code ID) übermittelt werden. Wenn der
Barcodescanner dementsprechend eingestellt worden ist, wird
bei TransmitsCodeID=1 dieser Buchstabe abgeschnitten und der
entsprechende Barcode-Typ dem Barcode Scripting übergeben.
Achtung: Für UPC-A, UPC-E0, UPC-E1, EAN8 und EAN13 wird
derselbe Buchstabe übergeben. Im Barcode Scripting kann somit
zwischen diesen Typen nicht unterschieden werden. Falls auf
einen dieser Typen abgefragt werden soll, muss im Script EAN13
angegeben werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 61 / 82
7
Konfiguration
7.2.17 INI-Abschnitt: Special
Unter diesem Abschnitt sind alle Optionen aufgeführt, die einzelne spezielle
Versionen der TouchKonsole betreffen
WLANShowStatus=1
WLANShowPercent=1
WLANThreshold=30
RxTx=0
KeyboardBypass=0
SymbolKeyboard=1
SimpleAlphaToggle=0
WLANShowStatus Wird eine Funkkarte erkannt, wird automatisch ein FunkstärkeSymbol eingeblendet, wenn der Parameter auf "1" steht.
Außerdem wird zusätzlich die Signalqualität in Prozent angezeigt
(s. "WLANShowPercent") sowie das Senden bei zu schlechter
Qualität verhindert (s. "WLANThreshold"), um Verbindungsabbrüche zu vermeiden. Es werden Funkkarten, die über den
Standard-Windows-Dialog konfiguriert werden (WZC, Wireless
Zero Config) unterstützt sowie Summit CF-Karten (z.B. im
Quadrino und seinen OEM-Varianten oder in Nordic ID
Terminals; das Quadrino enthält bereits die erforderliche Datei
sdc_wrap.dll), Symbol WLAN-Karten (in der Symbol-Version der
TouchKonsole) und Intermec WLAN-Karten (in der IntermecVersion der TouchKonsole). Die TouchKonsole wählt
automatisch den richtigen Treiber aus. Deswegen ersetzt dieser
Parameter
die
alten
Parameter
"QuadrinoWLAN",
"SymbolWLAN" und "IntermecWLAN", die zwar weiterhin
funktionieren, aber aus der INI gelöscht bzw. durch den neuen
Parameter ersetzt werden sollten.
WLANShowPercent Zeigt zusätzlich zum Symbol die aktuelle Feldstärke in Prozent
an. Wird dies nicht gewünscht, kann der Wert auf "0" gesetzt
werden. Dieser Parameter ersetzt "WLANNoPercent", der genau
anders herum funktionierte.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 62 / 82
7
Konfiguration
WLANThreshold
Schwelle der Funkstärke in Prozent, unter der die TouchKonsole
nicht
mehr
senden
soll,
um
daraus
resultierende
Verbindungsabbrüche zu vermeiden (Gültige Werte: 1 bis 50;
Standard-Wert ist 30)
RxTx
Blendet zwei kleine "LEDs" am unteren rechten Bildschirmrand
ein, die mit "R" (Receive, Empfangen) und "T" (Transmit,
Senden) beschriftet sind. Diese blinken auf, wenn Daten vom
TCP/IP-Stack empfangen bzw. diesem übergeben werden. Dies
ist sehr nützlich zur Analyse von Funkproblemen, da so
erkennbar ist, ob die TouchKonsole Daten zurückhält (SendePuffer bzw. zu schlechter Empfang) oder das Gerät selber.
KeyboardBypass
Pocket PC bzw. Windows Mobile Terminals belegen
standardmäßig zahlreiche F-Tasten zur Regelung der Helligkeit,
der Lautstärke usw. Auf den meisten Terminals kann dies nicht
deaktiviert werden. Mit KeyboardBypass erhält die TouchKonsole
exklusiven Zugriff auf die Tastatur, so dass die F-Tasten wieder
uneingeschränkt zur Verfügung stehen.
SymbolKeyboard
Wird die Symbol-Version der TouchKonsole verwendet, wird
automatisch ein Keyboard-Status-Symbol eingeblendet, insofern
der Symbol-Treiber dies unterstützt. Angezeigt wird der Status
einer etwaig vorhandenen Funktionstaste sowie der kumulierte
Status der Alpha-, Shift- und CapsLock-Tasten. Beim Modell
PPT88xx muss vor Benutzung der Keyboard-Anzeige ein Patch
aufgespielt werden
SimpleAlphaToggle Wird ein Gerät mit Telefon-Tastatur verwendet, so kann man mit
der Alpha-Taste zwischen den drei Modi Zahlen, Klein- sowie
Großbuchstaben umschalten. Muss häufig zwischen Zahlen und
Buchstaben gewechselt werden, kann mit SimpleAlphaToggle=1
das Umschalten zu Großbuchstaben verhindert, bzw.
übersprungen werden, um die Bedienung zu beschleunigen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 63 / 82
7
Konfiguration
7.2.18 INI-Abschnitt: Debug
TcpTrace=0
ConnectionLog=0
WLanLog=0
FileOutputEnabled=1
TcpOutputEnabled=0
TcpOutputIP=
TcpOutputPort=11620
TcpTrace
Bei TcpTrace=1 wird ein Protokoll der empfangenen und
gesendeten Datenpakete in die Datei TCPTrace.log geschrieben.
Achtung: Dieses Protokoll wird nicht automatisch gelöscht und
verlangsamt den Betrieb der TouchKonsole.
Ab Version 2.3.0.50 werden außerdem die Versionsnummer
sowie die Ursache von Verbindungsabbrüchen geloggt.
ConnectionLog
Bei ConnectionLog=1 wird bei Verbindungsende eine kurze
Statistik in die Datei TcpTrace.log geschrieben (Zeitstempel von
Verbindungsstart, Dauer sowie letzter Datenübermittlung)
WLanLog
Diese Funktion ist nicht in allen TouchKonsole-Versionen und
nicht auf allen Geräten verfügbar. WLanLog=0 schaltet die
Funktion ab. WLanLog=1 bis WLanLog=100 schaltet die
Funktion ein. Außerdem wird so ein Schwellwert in Prozent
angegeben, unter dem die Signalstärke sekündlich protokolliert
wird. Es werden Informationen über die WLAN-Karte (Version,
Treiber, MAC-Adresse etc) protokolliert. Außerdem werden
Änderungen der ESSID und des aktuell verbundenen Access
Points und des Verbindungsstatus protokolliert.
Standard-PPC-TouchKonsole und Gerät mit Summit-Karte:
Die Feldstärke wird in dB protokolliert. Außerdem die aktuelle
Verbindungsgeschwindigkeit und der verwendete Kanal.
Symbol-PPC-Version auf entsprechenden Geräten:
Die Feldstärke wird in Prozent protokolliert.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 64 / 82
7
Konfiguration
Die folgenden Parameter werden nur von der Debug-Version der TouchKonsole
ausgewertet:
FileOutputEnabled Schaltet das Loggen aller Aktionen in die Datei
TouchKonsole.log ein. Achtung: Dieses Protokoll wird nicht
automatisch gelöscht und kann somit sehr groß werden.
TcpOutputEnabled Sendet das Protokoll aller Aktionen an einen bestimmten
Empfänger. Dort muss ein geeignetes Programm zur Anzeige
installiert sein. TcpOutput beeinträchtigt die Stabilität der
TouchKonsole und sollte deshalb nur in Ausnahmefällen benutzt
werden. Außerdem eignet sich diese Funktion nicht zur Analyse
von Funkproblemen, da der Debug-Datenstrom ebenfalls per
Funk übertragen wird.
TcpOutputIP
Gibt die IP-Adresse des Log-Empfängers an.
TcpOutputPort
Gibt den Port an, auf dem der Log-Empfänger lauscht.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 65 / 82
7
7.3
Konfiguration
Makro-Befehle
Die TouchKonsole kann vordefinierte Befehlssequenzen an den Host senden, die
über Makros definiert werden. Dies ist in den Abschnitten "AutoLogin", "Layout*" und
"KeyboardMapping" möglich. Der Abschnitt "Layout*" arbeitet ausschließlich mit
Makros. In den anderen Abschnitten müssen Makros mit dem Text "Macro:"
eingeleitet werden, um in diesen Modus zu wechseln.
Die Makro-Befehle können beliebig zu Makro-Sequenzen kombiniert werden, indem
sie hintereinander gehangen werden. Ausnahme ist der GOTO Befehl, mit dem im
Abschnitt "Layout*" auf eine weitere virtuelle Tastatur verzweigt werden kann. Hier ist
eine Verknüpfung mit weiteren Makro-Befehlen nicht sinnvoll.
Beispiele für Verknüpfungen verschiedener Makro-Befehle:
Button1Sequence=exit{CR}{LF}
Button2Sequence=cd myprog{RETURN}startprog{RETURN}
Anmerkung zu VT220:
Je nach Modus, der vom Telnet-Server festgelegt wird, werden u. U. verschiedene
Codes geschickt. Hierbei kann es sich entweder um den 7-Bit oder den 8-Bit VTModus handeln. Nähere Informationen zum Thema VT100/VT200 sind im Internet zu
finden, z.B. unter folgender Adresse: http://www.vt100.net/docs/vt220-rm/
Je nachdem, ob es sich um VT220 oder 5250 handelt, sind verschiedene MakroBefehle zulässig. Diese werden im Folgenden erklärt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 66 / 82
7
Konfiguration
7.3.1 Makro-Befehle unter VT220
{ESC}
{ESCAPE}
ASCII-Zeichen (27) wird gesendet
{CSI}
Je nach Modus wird Zeichen CSI (155) oder ESC + "[" gesendet
{SS3}
Je nach Modus wird Zeichen SS3 (143) oder ESC + "O" gesendet
{HELP}
Taste F15 wird gesendet
{DO}
Taste F16 wird gesendet
{FIND}
Taste "Find" wird gesendet
{INS}
{INSERT}
{INSERTHERE}
Taste "Insert Here" wird gesendet
{DEL}
{DELETE}
{REM}
{REMOVE}
Taste "Remove" wird gesendet
{SEL}
{SELECT}
Taste "Select" wird gesendet
{PREVSCREEN}
{PAGEUP}
{ROLLDOWN}
Taste "Prev Screen" wird gesendet
{NEXTSCREEN}
{PAGEDOWN}
{ROLLUP}
Taste "Next Screen" wird gesendet
{BS}
{BACKSPACE}
Taste "Backspace" wird gesendet - je nach Einstellung in der INIDatei handelt es sich um ASCII-Zeichen (8) oder (127)!
{SP}
{SPACE}
Taste "SPACE“ (Leertaste) wird gesendet
{TAB}
{TABULATOR}
{HT}
Taste "Horizontal Tabulator" wird gesendet
{LB}
{LEFTBRACKET}
Taste "{" wird gesendet
{RB}
{RIGHTBRACKET}
Taste "}" wird gesendet
{CR}
Zeichen CR (13) wird gesendet
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 67 / 82
7
Konfiguration
{LF}
Zeichen LF (10) wird gesendet
{RETURN}
{ENTER}
Je nach Newline-Modus wird Zeichen CR oder CR + LF gesendet
{UP}
Je nach Cursor-Modus wird "Cursor-Key Up" oder "Application-Key
Up" gesendet
{DOWN}
Je nach Cursor-Modus wird "Cursor-Key Down" oder "ApplicationKey Down" gesendet
{LEFT}
Je nach Cursor-Modus wird "Cursor-Key Left" oder "Application-Key
Left" gesendet
{RIGHT}
Je nach Cursor-Modus wird "Cursor-Key Right" oder "ApplicationKey Right" gesendet
{F1} .. {F20}
Eine Funktionstaste wird gesendet
{0} .. {255}
Sendet das ASCII-Zeichen, das zwischen den Klammern steht
a .. Z
0 .. 9
Beliebige alphanumerische Zeichen können geschickt werden
{QUIT}
Die Verbindung zum Host-System wird beendet
{EXIT}
{SHUTDOWN}
Die TouchKonsole wird (evtl. nach Passwortabfrage) beendet
{RESTART}
Neustart der TouchKonsole mit erneutem Login am VT220 Host (bei
Parameter [SETUP] AutoRestart=0 erfolgt eine Sicherheitsabfrage)
{SCREENSHOT}
Der aktuelle Inhalt des Bildschirm-Puffers wird, mit einem DatumUhrzeit-Stempel versehen, im Verzeichnis der TouchKonsole als
BMP Datei abgespeichert
{GIGIDEMO}
Es wird eine animierte Demo gestartet
{GOTOx}
Nur Abschnitt "Layout*": Aktiviert Tastatur-Layout x (wobei x eine
Zahl größer Null ohne führende Nullen sein muss); eine beliebige
Schachtelung der GOTO Befehle ist möglich, so dass man von einer
Tastatur auf die nächste gelangt
{HIDE}
Nur Abschnitt "Layout*": Nach dem Ausführen des Makros wird das
Touchpad ausgeblendet
{ME}
Das gesamte Makro dieses Buttons wird nicht an den Host sondern
an die TouchKonsole selbst gesendet; für Test- und Demozwecke
{POSy;x}
Der Cursor wird an Zeile y und Spalte x gesetzt; für Test- und
Demozwecke; nur sinnvoll im Zusammenhang mit {ME}
{BRIGHTUP}
{BRIGHTDOWN}
Nur Quadrino: Display heller oder dunkler stellen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 68 / 82
7
Konfiguration
7.3.2 Makro-Befehle unter 5250
{ESC}
{ESCAPE}
{QUIT}
Die Verbindung zum Host-System wird beendet
{EXIT}
{SHUTDOWN}
Die TouchKonsole wird (evtl. nach Passwortabfrage) beendet
{HELP}
Taste "Help" wird gesendet
{INS}
{INSERT}
Taste "Insert" wird verarbeitet: Überschreiben oder Einfügen
aktivieren
{DEL}
{DELETE}
{REM}
{REMOVE}
Taste "Delete" wird verarbeitet: Das Zeichen rechts vom Cursor wird
gelöscht und alle folgenden Zeichen um eine Stelle nach links
verschoben
{ROLLDOWN}
{PREVSCREEN}
{PAGEUP}
Taste "Roll Down" wird gesendet
{ROLLUP}
{NEXTSCREEN}
{PAGEDOWN}
Taste "Roll Up" wird gesendet
{BS}
{BACKSPACE}
Taste "Backspace" wird verarbeitet
{SP}
{SPACE}
Taste "Space" (Leertaste) wird verarbeitet
{TAB}
{TABULATOR}
{HT}
Taste "Tabulator" wird verarbeitet
{BACKTAB}
5250-Tastenkombination "Shift+Tabulator" wird verarbeitet
{LB}
{LEFTBRACKET}
Taste "{" wird verarbeitet
{RB}
{RIGHTBRACKET}
Taste "}" wird verarbeitet
{NEWLINE}
{CR}
{LF}
{RETURN}
Taste "Newline" wird verarbeitet
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 69 / 82
7
Konfiguration
{ENTER}
Taste "Enter" (Datenfreigabe) wird verarbeitet
{UP}
Taste "Cursor-Key Up" wird verarbeitet
{DOWN}
Taste "Cursor-Key Down" wird verarbeitet
{LEFT}
Taste "Cursor-Key Left" wird verarbeitet
{RIGHT}
Taste "Cursor-Key Right" wird verarbeitet
{F1} .. {F20}
Eine Funktionstaste wird gesendet
{0} .. {255}
Verarbeitet das ASCII-Zeichen, das zwischen den Klammern steht
a .. Z
0 .. 9
Beliebige alphanumerische Zeichen können verarbeitet werden
{ATTN}
{ATTENTION}
Taste "Attention" (Abruf) wird gesendet
{SRQ}
{SYSRQ}
{SYSTEMREQUEST}
Taste "System Request" (System-Abruf) wird gesendet
{TRQ}
{TEST}
{TESTREQUEST}
Taste "Test Request" (Test) wird gesendet
{PRINT}
{PRINTSCREEN}
Taste "Print" wird gesendet
{RESET}
Taste "Reset" (Grundstellung) wird verarbeitet
{HOME}
Taste "Home" wird verarbeitet
{POS1}
{FIELDHOME}
Es wird zum Anfang des aktuellen Eingabefeldes gesprungen
{END}
{FIELDEND}
Es wird zum letzten eingegebenen Zeichen im aktuellen Eingabefeld
gesprungen
{DUP}
{DUPLICATE}
Der Rest des aktuellen Eingabefeldes wird „ausge-X-t“
{PREVWORD}
Es wird zum Anfang des vorangehenden Wortes gesprungen
{NEXTWORD}
Es wird zum Anfang des nachfolgenden Wortes gesprungen
{FIELDEXIT}
Sprung zum nächsten Eingabefeld
{FIELDPLUS}
{FIELD+}
Sprung zum nächsten Eingabefeld; Zahlenfelder werden als positive
Zahl eingetragen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 70 / 82
7
Konfiguration
{FIELDMINUS}
{FIELD-}
Sprung zum nächsten Eingabefeld; Zahlenfelder werden als negative
Zahl eingetragen
{POSy;x}
Der Cursor wird an Zeile y und Spalte x gesetzt.
{LOGIN}
{AUTOLOGIN}
Erneutes Freischalten der AutoLogin-Funktion, die nach
erfolgreichen Login abgeschaltet wird
{RESTART}
Neustart der TouchKonsole mit erneutem Login am 5250 Host (bei
Parameter [SETUP] AutoRestart=0 erfolgt eine Sicherheitsabfrage)
{SCREENSHOT}
Der aktuelle Inhalt des Bildschirm-Puffers wird, mit einem DatumUhrzeit-Stempel versehen, im Verzeichnis der TouchKonsole als
BMP Datei abgespeichert
{GOTOx}
Nur Abschnitt "Layout*": Aktiviert Tastatur-Layout x (wobei x eine
Zahl größer Null ohne führende Nullen sein muss); eine beliebige
Schachtelung der GOTO Befehle ist möglich, so dass man von einer
Tastatur auf die nächste gelangt
{HIDE}
Nur Abschnitt "Layout*": Nach dem Ausführen des Makros wird das
Touchpad ausgeblendet
{BRIGHTUP}
{BRIGHTDOWN}
Nur Quadrino: Display heller oder dunkler stellen
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 71 / 82
7
7.4
Konfiguration
Barcode-Scripting
Die IND TouchKonsole enthält einen mächtigen Script-Interpreter, um Barcodes vor
dem Senden an den Host manipulieren zu können. Es ist möglich, anhand des
Barcode-Typs und seiner Länge nur bestimmte Aktionen durchzuführen. Die
Scriptsprache wird im Folgenden beschrieben.
7.4.1 Befehls-Zusammensetzung
Ein Barcode-Scriptbefehl setzt sich immer aus drei Teilen zusammen:
Der Barcode-Typ-ID ("Symbology", entspricht nicht der Symbol Code-ID!)
Der Barcode-Länge in runden Klammern
Dem eigentlichen Befehl in eckigen Klammern
ID ( Länge ) [ Befehl und Parameter ]
Ein Script muss in einer einzelnen Zeile stehen, darf aber beliebig viele Scriptbefehle
enthalten. Zwischen Scriptbefehlen und oben genannten Befehlsteilen dürfen
Leerzeichen stehen, die bei Ausführung automatisch gelöscht bzw. ignoriert werden.
Leerzeichen innerhalb der Klammern werden beibehalten, sollten aber nur bei StringParametern verwendet werden. Die Verarbeitung der Scriptbefehle erfolgt von links
nach rechts. Wurden die Bedingungen eines Scriptbefehls erfüllt und der Barcode
verändert, wird dieser geänderte Barcode für die folgenden Scriptbefehle verwendet.
Der Eintrag in der INI-Datei in der Sektion [Scanner] könnte also lauten:
[Scanner]
BarcodeScript=N(9-12)[SE6] Q(16)[SS1] A(0)[C00;3;18] A(0)[A\0D]
Bei diesem Beispiel werden zuerst sechs Zeichen am Ende des Barcodes
abgetrennt, wenn es sich um einen neun bis zwölf Zeichen Langen CODE 128
handelt. Anschließend wird das erste Zeichen abgetrennt, wenn es sich um einen
EAN 128 handelt. Danach werden die ersten beiden Zeichen abgetrennt und nur die
folgenden 18 Zeichen verwendet, wenn der Barcode mit 00 anfängt. In jedem Fall
wird ein CR-Zeichen (Return) angehängt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 72 / 82
7
Konfiguration
Die ID besteht immer aus einem einzelnen Großbuchstaben und stellt eine
Bedingung dar. Nur wenn der angegebene Barcode gescannt wurde, wird der
Scriptbefehl ausgeführt:
A
Any (jeder Barcode-Typ)
B
UPCE 0
J
D 2 of 5
C
UPC 1
K
I 2 of 5
D
UPC A
L
Code 11
E
MSI
M Code 93
F
EAN 8
N
Code 128
O
PDF 417
G EAN 13
H
Codabar P
IATA D 2 of 5
I
Code 39
UCC/EAN 128
Q
Die Länge stellt eine Bedingung dar. Nur wenn der Barcode die angegebene Länge
aufweist, wird der Scriptbefehl ausgeführt. Drei Formate sind gültig:
0
Jede beliebige Länge akzeptieren
12
Barcode muss genau n Zeichen lang sein (in diesem Fall 12 etc.)
9-14 Barcode muss mindestens n1 und höchstens n2 Zeichen lang sein
(in diesem Fall 9 bis 14 etc.)
Im Gegensatz zur Konfiguration des Symbol Barcode-Scanners ist es nicht möglich,
einen Min-Wert anzugeben, der größer als der Max-Wert ist (um zwei bestimmte
Längen anzugeben). In diesem Fall muss der Scriptbefehl mehrfach mit jeweils fester
Länge definiert werden.
Ein Befehl wird immer durch einen einzelnen Großbuchstaben definiert. Ihm folgt bei
einigen Befehlen ein Sub-Befehl, der ebenfalls durch einen einzelnen
Großbuchstaben dargestellt wird. Anschließend kommen die Parameter, die in der
Regel durch Semikolons getrennt werden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 73 / 82
7
Konfiguration
Es gibt drei Arten von Parametern, die hier wie folgt gekennzeichnet werden:
n Zahlen (müssen größer als 0 sein)
c
Character (einzelnes ASCII-Zeichen)
s
Strings (Zeichenketten beliebiger Länge)
Es wird an Stelle 1 angefangen zu zählen. Das erste Zeichen ist also an Stelle 1, das
Zweite an 2 usw.
Der Kennzeichnung folgt in dieser Beschreibung eine Zahl, die die Position des
Parameters angibt (z.B. n1, c2 oder s3). Parameter sind Case-Sensitiv.
7.4.2 Escape-Zeichen
Da diverse Zeichen nicht erlaubt sind, da sie zur Scriptsteuerung dienen (z.B.
Klammern, Semikolons, umgekehrte Schrägstriche, Steuerzeichen usw.), müssen
diese als zweistellige hexadezimale Zahl angegeben werden, die nach einem
umgekehrten Schrägstrich steht, also z.B. "\09" für Tab.
Eine Auswahl an Zeichen und ihren HEX-Werten:
Tab
\09
Return
\0D
Escape
\1B
Group Separator
\1D
Leerzeichen
\20
Runde Klammer auf "("
\28
Runde Klammer zu ")"
\29
Semikolon ";"
\3B
Eckige Klammer auf "["
\5B
Umgekehrter Schrägstrich "\" \5C
Eckige Klammer zu "["
\5D
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 74 / 82
7
Konfiguration
7.4.3 Scripting-Befehle
7.4.3.1 Anhängen (Append)
A s1
Dem Barcode wird s1 angehängt.
7.4.3.2 Voranstellen (Prepend)
P s1
Dem Barcode wird s1 vorangestellt.
7.4.3.3 Auffüllen (Lengthen/Padding)
Wenn der Barcode die angegebene Länge unterschreitet, wird er mit dem
angegebenen Zeichen aufgefüllt.
L S n1 ; c2
Den Barcode von links mit Zeichen c2 auf Länge n1 auffüllen.
L E n1 ; c2
Den Barcode von rechts mit Zeichen c2 auf Länge n1 auffüllen.
7.4.3.4 Zeichen abschneiden (Strip)
Es werden Zeichen vom Barcode unbedingt abgeschnitten.
S S n1
Es werden n1 Zeichen vom Anfang des Barcodes entfernt.
S E n1
Es werden n1 Zeichen vom Ende des Barcodes entfernt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 75 / 82
7
Konfiguration
7.4.3.5 Ersetzen (Replace)
R c1 c2
Alle Vorkommen von Zeichen c1 werden durch Zeichen c2 ersetzt.
7.4.3.6 Erweitertes Ersetzen (Xtended Replace)
X s1 ; s2
Alle Vorkommen von s1 werden durch s2 ersetzt. Wenn s2 leer ist, werden alle
Vorkommen von s1 gelöscht.
7.4.3.7 Einfügen (Insert)
Einfügen eines Textes.
I n1 ; s2
An Position n1 wird s2 unbedingt eingefügt.
I s1 ; n2 ; s3
Wenn Barcode mit s1 beginnt, dann s3 an Position n2 einfügen.
I n1 ; s2 ; n3 ; s4
Wenn s2 im Barcode an Position n1 steht, dann s4 an Position n3 einfügen.
7.4.3.8 Ausschneiden (Cut)
Ein Teil des Barcodes wird ausgeschnitten (und zurückgegeben).
C n1 ; n2
Ab Position n1 werden n2 Zeichen unbedingt ausgeschnitten.
C s1 ; n2 ; n3
Wenn Barcode mit s1 beginnt, dann n3 Zeichen ab Position n2 ausschneiden.
C n1 ; s2 ; n3 ; n4
Wenn s2 im Barcode an Position n1 steht, dann n4 Zeichen ab Position n3
ausschneiden.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 76 / 82
7
Konfiguration
7.4.3.9 Löschen (Erase)
Herauslöschen von Zeichen.
C n1 ; n2
Ab Position n1 werden n2 Zeichen unbedingt gelöscht.
C s1 ; n2 ; n3
Wenn Barcode mit s1 beginnt, dann n3 Zeichen ab Position n2 löschen.
C n1 ; s2 ; n3 ; n4
Wenn s2 im Barcode an Position n1 steht, dann n4 Zeichen ab Position n3 löschen.
7.4.3.10 Groß-/Kleinschreibung (Transform to UCase/LCase)
T U
Der Barcode wird in Großbuchstaben umgewandelt.
T L
Der Barcode wird in Kleinbuchstaben umgewandelt.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 77 / 82
7
Konfiguration
7.4.4 Beispiele
Befehl
Barcode (vorher)
Barcode (nachher)
A(0)[Axxxx]
abcABC123
abcABC123xxxx
A(0)[Pxxxx]
abcABC123
xxxxabcABC123
A(0)[LS10;x]
abcABC123
xabcABC123
A(0)[LE10;x]
abcABC123
abcABC123x
A(0)[R1x]
abcABC123
abcABCx23
A(0)[XABC;XXX]
abcABC123
abcXXX123
A(0)[XABC;]
abcABC123
abc123
A(0)[I7;xxx]
abcABC123
abcABCxxx123
A(0)[Iabc;7;xxx]
abcABC123
abcABCxxx123
A(0)[I4;ABC;7;xxx]
abcABC123
abcABCxxx123
A(0)[C7;3]
abcABC123
123
A(0)[Cabc;7;3]
abcABC123
123
A(0)[C4;ABC;7;3]
abcABC123
123
A(0)[E7;3]
abcABC123
abcABC
A(0)[Eabc;7;3]
abcABC123
abcABC
A(0)[E4;ABC;7;3]
abcABC123
abcABC
A(0)[TU]
abcABC123
ABCABC123
A(0)[TL]
abcABC123
abcabc123
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 78 / 82
8
8
Proprietäre VT-Kommandos
Proprietäre VT-Kommandos
Der VT-Befehlssatz wurde in der TouchKonsole durch einige Kommandos erweitert,
die im Standard-VT-Handbuch nicht auftauchen. Sie basieren zum Teil auf den
folgenden Steuerzeichen:
Mnemonic
HEX
DEC
7-Bit-Äquivalent
Aktion
CSI
9B
155
ESC [
Einleitung einer Steuersequenz
ROI
9A
154
ESC %
Einleitung
einer
Steuersequenz
DCS
90
144
ESC P
Startzeichen einer Steuersequenz
ST
9C
156
ESC \
Endezeichen einer Steuersequenz
proprietären
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 79 / 82
8
Proprietäre VT-Kommandos
8.1
CSI-Befehle
8.1.1 Zeilenweises Doppelt-Hoch
Steuersequenz
Aktion
ESC :
Zeilenweises Doppelt-Hoch, Normal-Breit, obere Hälfte
ESC ;
Zeilenweises Doppelt-Hoch, Normal-Breit, untere Hälfte
8.1.2 Zeichenweises Doppelt-Hoch und Doppelt-Breit
Steuersequenz
Aktion
CSI 71 m
"doppelt breit" an
CSI 72 m
"doppelt hoch" an
CSI 73 m
"doppelt breit, linke Hälfte" an
CSI 74 m
"doppelt hoch, untere Hälfte" an
CSI 75 m
"doppelt breit, rechte Hälfte" an
CSI 76 m
"doppelt hoch, obere Hälfte" an
CSI 91 m
"doppelt breit" aus
CSI 92 m
"doppelt hoch" aus
CSI 93 m
"doppelt breit, linke Hälfte" aus
CSI 94 m
"doppelt hoch, untere Hälfte" aus
CSI 95 m
"doppelt breit, rechte Hälfte" aus
CSI 96 m
"doppelt hoch, obere Hälfte" aus
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 80 / 82
8
8.2
Proprietäre VT-Kommandos
ROI-Befehle
8.2.1 Druckerport auswählen
Steuersequenz
Aktion
ROI 0 P
Druckausgabe deaktivieren
ROI 1 P
COM1 auswählen
ROI 2 P
COM2 auswählen
ROI 3 P
COM3 auswählen
8.2.2 Reader aktivieren
Steuersequenz
Aktion
ROI 1 R
Reader an COM 1 an
ROI 2 R
Reader an COM 2 an
ROI 3 R
Reader an COM 3 an
ROI 9 R
Reader an COM 1 aus
ROI 10 R
Reader an COM 2 aus
ROI 11 R
Reader an COM 3 aus
Rückgabewert der TouchKonsole an den Server:
DCS {Ps} R {Data} ST
{Ps} ist der COM-Port (1/2/3), von dem empfangen wurde
{Data} sind die vom Port empfangenen Daten
Ab Version 2.3.0.50 unterstützt die TouchKonsole ein weiteres Feature des
abgelösten Terminals FTF2440. Hierbei können gescannte Barcodes auf einen
Reader-Kanal umgeleitet werden, sobald der Host diesen öffnet. Siehe hierzu [Setup]
COMxSettings.
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 81 / 82
8
Proprietäre VT-Kommandos
8.2.3 Scanner- / Keyboard-Eingabe
Steuersequenz
Aktion
ROI 0 x
Scanner aus, nur Keyboard-Eingabe möglich
ROI 1 x
Scanner- und Keyboard-Eingabe möglich
ROI 2 x
Nur Scanner-Eingabe möglich
ROI 4 x
Zu jedem Scancode wird ein ENTER hinzugefügt
ROI 5 x
Jeder Scancode wird mit einem BEEP quittiert
8.2.4 Font-Auswahl
Steuersequenz
ROI {Psf} ; {Psy} ; {Psx} w
Aktion
{Psf} ist die Font-Größe (wird nur in der CE-Version unterstützt)
{Psy} ist die Anzahl der gewünschten Zeilen (2..24)
{Psx} ist die Anzahl der gewünschten Spalten (1..80)
Die CE-Version der TouchKonsole kann beliebige Kobinationen von Zeilen und
Spalten generieren. Über die INI-Parameter "FollowCursor" und "ScrollBars" kann
ausgewählt werden, wie mit für den Bildschirm zu großen Kombinationen
umgegangen wird. Ab Version 2.3.0.50 versucht die TouchKonsole zusätzlich, eine
geeignete Fontgröße automatisch einzustellen. Näheres hierzu ist unter [Setup]
RoiFontScaling und FixedRoiDimensions zu finden.
Mögliche Befehle sind z.B.:
Steuersequenz
Aktion
ROI 255 ; 0 ; 0 w
Die TouchKonsole wird auf die Anzahl Zeilen und Spalten aus der
INI-Datei zurückgesetzt
ROI 2 ; 24 ; 80 w
Die TouchKonsole wird auf die Größe eines normalen TerminalBildschirms gesetzt. Auf den meisten CE-Geräten ist so aber nur die
Hälfte der Breite sichtbar
ROI 9 ; 10 ; 15 w
Die TouchKonsole wird auf sehr große Schrift gesetzt. Gleichzeitig
erfolgt eine Reduzierung der Dimensionen auf die darstellbare
Größe (bei Hochformat)
Handbuchkapitel E - Terminalsoftware unter Windows CE / Mobile
IND PPC TouchKonsole 2.3
Seite 82 / 82