1 WireLess TelNet VT – Tutorial Common cases of configuration WTnVT (Telnet / SSH) Tutorial...

1WireLess TelNet VT – Tutorial Common cases of configuration www.softogo.com

WTnVT (Telnet / SSH)Tutorial

Common cases of configuration


WTn52 -> 5250 / 3270 emulation Not in this document!

Define the emulation 52 / VT

5250 (SNA LU 6.2)

5251-11, 5292-2, etc. AS400 / iSeries / i5 (OS/400)

3270 (SNA LU 3)

3278-2, 3279-2, etc. IBM/3090 S/390 (System/370)

WTnVT -> VT, ANSI, SSH emulation

Telnet VT

VT100, VT220, ANSI, etc. Win2000-2008/UNIX

SSH

Xterm, VTxxx, etc. UNIX / Linux

Open the WTn52 (5250 / 3270) tutorial


License activation

Configuring the emulator

Keyboard mapping

Touch screen actions

Display configuration

Barcode reading

Display Translation

Advanced configuration

Table of contents


Options:

• On-line, by Internet connection.

• E-mail license request.

Demo mode:

Telnet sessions disconnect itself after 5 minutes.Document

License activation guide

License activation

License activation may be performed using a desktop PC or directly with the PDA if the device has internet connection availability


• Access to the emulator configuration

Start >

WireLess TelNet WCE VT SSH >

TelNet Clients - Default Profile > (PDA Model)

Emulator configuration is stored in files on the PC. At each modification they will be copied to the PDA

How to configure the emulator?

Change the configuration, i./e.:

[VT_EMULATION]

DragDisplay = Yes

Download configuration to the PDA3

1

Restart the program to read new configuration

4

Configuration

Configuration download by ActiveSync

2


It is possible to map any keystroke to any character sequence

Keyboard Mapping

Configuration

The changes are done in the VT configuration file.

Access it from installation page.

TIP! -> some samples

Configure F5:Applications expects specificescape sequences for function keys.

Ctrl-CMake Ctrl-C with F3

On-line Forum

On-line Forum

Warning, configure the section of the emulated model to use (TTypePreferred).

[VT_FNKEYS_ANSI][VT_FNKEYS_VT100]

On-line help


How-to configure the keyboard mapping?

Keyboard Mapping

In the VT configuration

SEQUENCE sent to Host

FunctionKey

TIP! -> In the configuration file

The keys are grouped by terminal model (ANSI, VT52, VT100) then by function type (FN, Shift + FN, Cursor) :

[VT_FNKEYS_ANSI]Function keys for an ANSI emulation.[VT_SFNKEYS_ANSI]Shift + Function keys for an ANSI emulation.[VT_CURKEYS_ANSI]Movement cursor keys for an ANSI emulation.[VT_CURKEYSAPP_ANSI]Movement cursor keys for an ANSI emulation in “application” mode.

On-line help

Terminal model

The sequence differs following the emulated terminal

(TTypePreferred).


You need to:

Identify the 'scancode‘ of the key or keystroke to be mapped to an escape sequence.

Keyboard Mapping

TIP! -> Identify the scan code:

In the “Keyboard Test” dialog on the PDA it is possible to check the scan code generated by any key.

Configuration > Keyboard Test

On-line help

A keystroke that is not in any group On-line help

Configuration (VT file)[VT_SCANCODES]

Allows to map any scan code to any sequence (regardless the selected terminal type).

• One scan code (key)• One sequence to send to Host

Example:To map needed special characters

that are not present in the PDA keyboard. Press “ESC” to perform a “tab”

On-line forum


Touch screen actionsTouch screen actionsTouch screen actionsTouch screen actions


With the touch screen, the stylus or the fingers, it is possible to perform actions


Display scroll

Scroll the display in the virtual screen by moving the stylus.

Allow to scroll the visible part of the emulated screen in the display to view all the content.

Configuration (VT file)

[VT_EMULATION]

DragDisplay = Yes

Available features

On-line help

On-line forum




VT Function keys on screen

Send an escape sequence to the Host by touching the screen.

Using the stylus you can touch any "Fx“ text on the screen.

(x= is the function number). i./e.: if the text reads “F4”, when touching over this text, emulator sends F4 escape sequence to Host.

Configuration (VT file)

[VT_EMULATION]

FunctionByTap = Yes

Available features

On-line help

On-line forum




Available features

Double Tap

With a double tap on the screen, you can generate any keystroke, which also can be a function.

Operation

Touch two times the screen in the same place, then remove the stylus.

Configuration

(VT file)

[VT_EMULATION]

DoubleTap=\XX (key code)

Example of use

It is possible to configure the “double tap” to launch the virtual keyboard (SIP Panel) on the screen.

• SipScanCode (Use the same code than DoubleTap – 00FF for example)

It is also possible to generate:

Enter (\0D)

Letters / digits « ..A »

On-line help

On-line forum


Configure it by changing the font size in the current session

2. See the resulting configuration in the PDA

Go to configuration dialog and see the currently selected size and font.

3 .Make the configuration persistent

• Change the configuration on the PC.

The generic configuration file

[DISPLAYFONT]FullName=Size=

On-line help

1. Try the different sizes in the active session

• In the active session, on the menu “Tools”, with “Text Size +” and “Text Size –” is possible to dynamically change the font size.

On-line help

On-line forum


Configure it by changing the number of visible rows / columns on screen

Font and size

• Try different layouts with different fonts and sizes.

Warning.

Prefer fixed width fonts (monospaced)

Font ExampleExample 1 Example 2

Font ExampleExample 1 Example 2

TIP1. Test it in the PDA

• Connect emulator to Host.

• With the menu “Go” / “main“, go back to main menu.

• Go to [configure] / [Display Configuration], change the value in the combo-box, then click on [select].

2. Make the configuration persistent

Configuration option (generic file)

[DISPLAYFONT]FullName=Size=

On-line forum

• Indicator shows rows and columns following the selected configuration

On-line help

On-line help


Barcode readingBarcode readingBarcode readingBarcode reading


CONFIGURATION

(generic file)

Configure the suffix to add after the barcode read.

Configuration Option

[SCANNER]

Suffix=\0D

Read a barcode, then send [ENTER]

Enter as terminator

Configure the suffix to be added after reading a specific barcode type.

Configuration option

[CODE_39]

[CODE_128]

…

Suffix=..X..Y\0D

• It is possible to add a prefix and / or a suffix in any barcode read

• Ii is possible to add a prefix and / or a suffix to a specific barcode type (code 39, code 128).

• <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>

On-line help

On-line help

On-line forum


Read a barcode, then replace unwanted characters

Cleaning the barcode

CONFIGURATION (Generic file)

Configure the characters to be replaced in any barcode. Four replacement options.


[SCANNER]

ReplaceChar1= <Out><In>

Options

• The character to suppress.

• The replacement character.

On-line help

On-line forum


Display TranslationDisplay TranslationDisplay TranslationDisplay Translation


There are options to give back the original UNICODE display

Display translation

Explanation:

•The Telnet protocol is over 7 bits (0x00-0x7F) or 8 bits (0x00-0xFF) (ASCII).

•The display is now in UNICODE – 16 Bits (0x0000-0xFFFF).

On-line help

Application UNICODE 16 Bits

Display UNICODE

Telnet Server ASCII 8 Bits

Wireless Telnet VT ASCII 8 BitsTelnet protocol ASCII 8 Bits

16 >> 8Conversio

n

8 >>16Conversio

n

DEC_VT3 Translators

Type 0

PC_LIKE1 Translator

Type 1

ANSI1 Translator

Type 2

ASCIIWithout

translator

UTF-8Without

translator


There are options to give back the original UNICODE display

Display translation

Explanation:

Select the translation type. You need to know how is working or configured the server, or proceed by “trial and error”. [VT_EMULATION] (VT file)

TranslatorType=3 (3=ASCII, without translator)TranslatorType=0 will use translators with XltType=0 (DEC_VT) TranslatorType=1 will use translators with XltType=1 (PC_LIKE)

•Modify (if needed) the translation tables. For translators ‘PC_LIKE’ there is some tables that use the Microsoft “page code” for MS-DOS (437, 850, 852).The translators are files (that can be modified) downloaded with the emulator.[TRANSLATOR_3] (VT file)XltName=\Flash Disk\Fnt_PC852.cfg XltType=1 (1=PC_LIKE)

•Test with different TranslatorType, and for PC_LIKE with different translators:Fnt_PC437.cfg, Fnt_PC850.cfg, Fnt_PC852.cfg.

On-line help

0=DEC_VT3 Translators

Type 0

1=PC_LIKE1 Translator

Type 1

2=ANSI1 Translator

Type 2

3=ASCIIWithout

translator

4=UTF-8Without

translator

On-line forum

On-line forum

On-line forum

On-line help


Avoid end of session

Editing barcode reads

Connecting a serial scanner

Terminal type


There is an option to simulate a dialogue

How-to avoid end of session?PDA configuration

Explanation:

1. Some host poll the connected devices.

2. If the PDA is off (power off) it can’t respond to Host.

3. On non response, the server will disconnect the client.

PDA CONFIGURATION

(Generic file)

[TELNET]

DoTcpAlive = YES

• It is possible to set the PDA to perform a periodic “ping” with the host to avoid end of session.

On-line help


Editing barcode reads

Configuration (generic file)

[BC_EDIT_X]

On=<Yes/No>

TIP! -> What can you do?

• Process following read length

• Process following barcode type

• Filter to suppress or keep:

Ex: (NNYYYYNNYYYN)Y=keep the char.N=Suppress the char.

• Add characters:

Ex: (****013****)

*=Keep the charNNN=Adds a char.

On-line help

Barcode reads can be modified by an edit processing before sending them to input fields.

How does it work?

1. Evaluate processing conditions.

2. Filter the reading to keep or suppress characters.

3. Add characters.

On-line forum


Connecting a serial scanner

TIP!

3 powerful options

WakeUp

Restart connection at PDA wake-up.

RestartBtn

Shows ComKbd button. Close and reopen the COMX: port by a click(useful for Bluetooth ports).

RestartKey

Key to restart (close and open) the COMx: port.

Configuration options to connect a serial scanner

CONFIGURATION

(generic file)


[SCANSERIAL]

On=<Yes/No/OnOff>

Remind to configure a suffix (terminator) in the serial scanner to perform the code transmission.

On-line help


Terminal type

Options to negotiate the terminal type

CONFIGURATION

(generic file)

Option to configure

[SESSION_X] TTypeSelByHost=Yes TTypePreferred= 3 (VT220) TTypeName=

On-line help

Explanation:•The terminal type is sent to Host by emulator (TTypePreferred)

•The Host can modify it (TTypeSelByHost).

•The applications may check the terminal type (UNIX / LINUX- $TERM)

•The emulator can send a user defined terminal type (TTypeName)

Current emulation is displayed in the session bar.

TIP! -> Has the host changed the terminal type?

On-line forum

1 WireLess TelNet VT – Tutorial Common cases of configuration WTnVT (Telnet / SSH) Tutorial...

Documents

Transcript of 1 WireLess TelNet VT – Tutorial Common cases of configuration WTnVT (Telnet / SSH) Tutorial...