Contents / Chapter 5Chapter 7

CHAPTER 6 COMMON CONFIGURATION FILE OPTIONS

6.I Features and syntax

WTn configuration file is a text file containing the default values for WT common options (WTnVT and WTn52) and several keyboard sequences generated by the terminal. Some of these values can be dynamically modified by the Host system. The name of this file is always "_WTnCE.Cfg". It's recommended to modify it only with IniEditor, an application included in the installation procedure.

WTn configuration file is a "Windows dot-ini-Like" text file, which includes:

The lines in the configuration file must be: Printer Header, Comments, Sections, Keys + Values or empty lines.

6.I.1 Sections

Sections group the option keys and values. Section names are in capital letters and in between square brackets, e.g.: [TELNET] denotes the Telnet section.
The order of the sections in the file is not relevant.

6.I.2 Keys

Keys are keywords that make sense only inside their own section, so they can't be moved from one section to another. Using lowercase or uppercase is not relevant for keywords, but it may be useful to make them more readable. Keys must be followed by "=" sign and the value of the parameter, e.g.: LocalBeeps=Yes.

6.I.3 Values

Values follow the keys and the "=" sign. Each parameter expects the value in a fixed format (indicated with the parameter definition in the form "<format>"). Values may be empty in some cases.

Formats are:

<Yes/No>
Needs a Yes or No value.

<string / xxxx>
Text ASCII characters, delimited or not by the " (inverted commas) character. If the string is delimited by ", the spaces (20h) are preserved, otherwise they are ignored. xxxx indicates the units or the meaning of the value.

<hex-string>
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):

Mnemonic Format Description
"Escaped" "/HH" A slash ("/" or "\") and a two-digits hexadecimal value, e.g.: \1B for character 27.
"Numeric" "999" Three decimal digits, e.g.: 065 for character "A".
"Alphabetic" "..A" Two dots and one alphabetic character, e.g.: ..X for character "X".

Hex-strings may be delimited by " to be more readable.

<num / xxxx>
Decimal numeric value (0 - 9). xxxx indicates the units or the meaning of the value.

<word>
Hexadecimal four-digits value. e.g. A50F.

<uppercase letter>
One uppercase character. e.g. N.

6.II Sections

[DOWNLOADS]
This section allows you to configure the associated files for download.
[TERMINAL]
This section groups the PDA-specific features.
[SESSIONS]
This section allows to configure the host sessions available for the user.
[SESSION_X]
These sections (_0 to _3) group the Telnet connection options specific for each session.
[SCROLL]
This section groups the "Logical scrolling" options to allow to map a standard 24x80 screen in a 8, or 16 PDA display.
[SCANNER]
This section groups the global scanner operation options.

The following sections contain symbology-specific options:
[UPC_E0]
Code UPC E0
[UPC_E1]
Code UPC E1
[UPC_A]
Code UPC A
[EAN_8]
Code Ean 8
[EAN_13]
Code EAN 13
[MSI]
Code MSI
[CODABAR]
Code CODABAR
[CODE_39]
Code 39
[CODE_D25]
Code Discrete 2/5
[CODE_I25]
Code Inter leaved 2/5
[CODE_11]
Code 11
[CODE_93]
Code 93
[CODE_128]
Code 128
[PDF_417]

Code PDF 417. This section will be replaced by [CODES_2D] on version 4.05 and further.
[CODES_2D]
2D (2 dimensions) barcode symbologies. Codes PDF 417, DATAMATRIX, MAXICODE, AZTEC.
Not implemented yet.
[CODE UCC 128]
Barcode symbology. Code UCC/EAN 128


[PRINTER]
This section groups the options for the PDA-attached printer.
[DBGOPT]
This section groups the options for debugging files generation.
[BC_EDIT_X]

Four sections, [BC_EDIT_0] to [BC_EDIT_3].
These sections group the options for the "Barcode edition" process.
[COMKBD]
This section will be replaced by SCANSERIAL section.
[SCANSERIAL]
This section will be implemented on version 4 and further. Allows to connect a serial input device scanner.
[DISPLAYFONT]
This section groups the options for the windows font the telnet screen will use.
[BLACKSCREEN]
This section allows to display an entire black screen when in input time out occurs and lock serial com input data.
Black Screen state is unlocked by specific keyboard action. This feature will be used for security reasons in Vehicle mounted terminals.
[BLUETOOTH]
This section allows to build an internal virtual COMx: port from an external captured a BlueTooth Device (as a wireless scanner). Input data from device will be captured by ComKbd feature and returned to user application as barcodes (block mode) or keystrokes.
[USER_SOUND_X]
This section allows to configure the sounds that will be played by the WTnCE52 client.
[TTS]
This section groups the options for TTS (Text To Speech), TelNet voice applications.
[KBD_MACRO]
This section allows to configure a key to perform a "macro" sequence of keyboard actions.

6.III [DOWNLOADS] Section

This section allows to configure the associated files for download.

FileX=
<string / name> 
Name of the associated file for download. By default, the files are:
File01=_WTn52.cfg

6.IV [TERMINAL] Section

This section groups the PDA-specific features.

UsesVoice=<Yes/No> (No)
Uses or not, the voice system (TTS & ASR) processing the voice configuration file (chapter 7)

PwdWConf=<string / name> (empty)
WTn Configuration Password. 234 by default.

PwdExit=<string / name> (empty)
Exit password. 307 by default.

TaskBar=<Yes/No> (No)
The TaskBar contains the Windows Start menu and the SIP Panel. In PPC2003, WM2005 is on the top of the screen and in WINCE4.20, WINCE5.0 is on the bottom of the screen. 
Yes=Displays the task bar, only the OK button is enabled.
No=Do not display the task bar.
Active=Displays the task bar, all buttons are active.
Lock=Displays the task bar, no button is active.

CommandBar=<Yes/No> (Yes)
The Command Bar contains the Application Menu. In PPC2003, WM2005 is on the bottom of the screen and in WINCE4.20, WINCE5.0 is on the top of the screen. 
Yes=Display the command bar
No=Do not display the command bar 

CBMenuMainMenu=
<0/1/2>
Controls the [Main Menu] option in the command bar.
0 (No ) means the option is disabled.
1 (Yes) means the option is enabled.
2 (Ask) means the option is enabled, but needs user confirmation.
Needs CommandBar parameter set to YES to be visible.

CBMenuDisconnect=<0/1/2>
Controls the [Disconnect] option in the command bar.
0 (No ) means the option is disabled.
1 (Yes) means the option is enabled.
2 (Ask) means the option is enabled, but needs user confirmation.
Needs CommandBar parameter set to YES to be visible.

CBMenuPrnScr=<0/1>
Controls the [Prn: Scr.] option in the command bar.
0 (No ) means the option is disabled.
1 (Yes) means the option is enabled.
Needs CommandBar parameter set to YES to be visible.
This option allows to generate a text file in the PDA with the contents of the current PDA screen.

CBMenuTextSize=<0/1>
Controls the [Size + / Size -] option in the command bar.
0 (No ) means the option is disabled.
1 (Yes) means the option is enabled.
Needs CommandBar parameter set to YES to be visible.

SipPanel=<Yes/No/Lock> (Yes)
Yes= Display the WM5 standard icon to open the keyboard. 
No= Do not display WM5 standard icon. Use 'SipScanCode' or double tap to show the sip panel.
Lock= Display WM5 standard icon, but locked. Use 'SipScanCode' or double tap to show the sip panel.
In 'Lock' mode, the keyboard is on 'FLOATING' mode and can be dragged.
Needs CommandBar parameter set to "YES" to have a visible SIP button.

ScrollBar=<Yes/No> (Yes)
Yes=Display the scrollbars.

Language=<string / name (EN)
User interface language 
EN=English.
FR=French.
ES=Spanish.

CtrlEsc=<Yes/No>
Yes=Allow WinCE to process Ctrl-Esc keystroke.
No=Block Ctrl-Esc keystroke.

NoMenu=<Yes/No>
Yes=Do not display the WTnCE main menu, automatically connect to the first host.
No=Display standard main menu.
Warning! Exits the application at end of connection.

BatteryAlert=<Num>
Low Battery level MessageBox user alert.
When battery charge reaches this level (%), a message box is displayed. 
Range 0-99. 0 means no alert message.

AutoConnect=<Yes/No>
Yes=Automatically connect to the first host (session 0). The main menu is displayed during 2 seconds.
No=Display standard main menu.

RFWaitTime=<Num>
Time to wait for RF ready before sending data, range 0-360.

RFWaitBeep=<Yes/No>
Yes=Perform short beeps during RF wait time.
No=Do not beep.

RFWaitPopUp=<Yes/No>
Yes=Show a PopUp error message when timeout exceeds RFWaitTime.
No=Do not show a PopUp.

RFQuality=<num> (2)
WiFi signal strength quality check (0 - 5).
Emulator blocks (RED indicator) if received WiFi signal is under this value.
0=No WiFi, 5=Excellent.
WARNING: Setting this to 5 could block emulator permanently.

AlphaState=<word / scancode> (0000)
Keyboard Alphabetic State used to show the ALPHA cursor [a].
(see the terminal specific State code 'St=' in the Keyboard test).

GoToKey= <num> (0000)
This is a keyboard scan code. Go to another running application Hot Key.

GoToApp= <string/name> (WDP_LAUNCHER)
Name of the application window or full path to the .exe file. 

WinFullScreen=<Yes/No> (Yes)
Yes=WTnVT program uses all the screen size.
No=WTnVT program uses a part of the screen, indicated by WinSizeX and WinSizeY.

WinSizeX= <num> (200)
Screen width. In pixels.

WinSizeY= <num> (200)
Screen length. In pixels.

6.V [SESSIONS]

This section allows to configure the host sessions available for the user.

Max=<num / sessions> (4)
Maximum number of sessions, range 1-4.

KeyPrev=<word / scancode> (0019 Fn-Ctl-Y)
Previous session key (Ctrl-Y).

KeyNext=<word / scancode> (001A // Fn-Ctl-Z)
Next session key (Ctl-Z).

KeyEndSession=<word / scancode> (0018 // Fn-Ctl-X)
End session key (Ctl-X).

HitAnyKey=<Yes/No> 
Yes=Display the message "Hit any key" when connection ends.
No=Do not display it.

ByGprs=<Yes/No> 
Yes = The network connection is made using WAN (GPRS).
No = The network connection is made using WLAN (WiFi).
When "ByGprs"=Yes, please select a RAS connection in "CnxGprs".

CnxGprs=<string / name>
Name of the RAS connection used to access GPRS Network.
Select an EXISTING system RAS connection (created by "Programs / Settings / Connections").

6.VI [SESSION_X]

These sections (_0 to _3) group the Telnet specific connection options for each session.

SessName=<string / name> (empty)
Name of the session displayed to the user.

HostIP=<string / address> (0.0.0.0)
Host IP address or URL name. The user may overwrite this value. This value is recalled in a "cold-boot / clean-boot start Sequence".

Port=<num / port #> (23)
Telnet connection port at host IP address. The user may overwrite this value. This value is recalled in a "cold-boot / clean-boot start Sequence".

TTypeSelByHost=<Yes/No> (Yes)
In order to set this option to Yes, TelOpTTypeTerm=Yes is needed too. If WTn TelOpTTypeTerm= option is "No", set this option to "No" too.
Telnet protocol allows the host to select the most convenient terminal-type chosen among a list (normally following host custom settings) indicating which type of terminal emulation are available in the client side and which type of terminal emulation is wished by the user. (The list shown by WTn is always ANSI, VT52, VT100 and VT220 terminal types). 
* If TTypeSelByHost=Yes:
    The final terminal type emulation done by WTn is selected by the Host.
* If TTypeSelByHost=No:
    Terminal type emulation selected by user (TTypePreferred=) is not modifiable by the Host. (Information is only sent to the host for application purposes).

TTypePreferred=<number> (3)
* If TTypeSelByHost=Yes:
    This terminal is indicated to the host as the one preferred by the user from the available terminal-type list.
* If TTypeSelByHost=No:
    This terminal is indicated to be the only emulation possible by the terminal (no list).

TTypeName="<string / Name>"
Telnet terminal type negotiation uses "normalized" terminal type names, but some hosts may need other specific forms.
If this string is empty, WTn uses system "normalized" strings.
If not empty, uses this as preferred terminal name (TTypePreferred=).

DevName="<string / Name>" (empty)
Device Name (or Workstation ID) negotiated with "environment" telnet option (see TelOpEnvTerm=).
Using "[IP]", a generic mask for last digits of IP address, xxx[IP]yyy becomes xxx53yyy on a terminal having 999.999.999.53 as IP address.
Using "[0IP]", a generic mask for last digits of IP address, xxx[0IP] becomes xxx003 on a terminal having 999.999.999.3 as IP address.

EmulationType=<string / Name> (empty)
Terminal emulation type. Valid values are VT and 52.

ProxyMode=<Disabled / Passive / Active> (Disabled)
Proxy Server state.

ProxyIP=?+
Url/address of the ProxyServer system or "." to use the auto-discovery wizard to connect to any ProxyServer.
Sample:
ProxyIP=10.10.10.15 -> Connects directly to host at 10.10.10.15 IP address.
ProxyIP=. -> Look for any ProxyServer in local network and connects to it.
If the IP address is followed by a "+", that means if the Proxy connection fails, a direct connect to the host will be performed.

See Proxy Server for WireLess TelNet description.

ProxyPort=<numeric> (45621)
Telnet connection port at Proxy IP address.

6.VII [SCROLL] Section

This section groups the "Logical scrolling" options to allow to map a standard 24x80 screen (called "virtual screen") in a 8, or 16x20 PDA physical display.

Do not confuse "Logical Scrolling" (i.e. a PDA display movement in the emulated virtual screen) with "Screen Scrolling" (i.e. a text movement in the emulated terminal screen) and "Scroll Area" (i.e. the selected a part of the emulated virtual screen).

See also "Screen and Display" figure in Chapter 3.

FixedMode=<Yes/No>
Yes="Fixed Screen Mode". The PDA display shows a part of the terminal virtual screen, and never moves, even if the cursor is out of the display. The "Logical Scroll Keys" have no effect.
No="Auto Scroll Mode". The PDA display always shows the screen area where the cursor is. The display moves following "edges" (see EdgeXXX=). In this mode, The "Logical Scroll Keys" manually moves the display into the screen (see KeyXXX=). 

StartPosX=<num / row>
Select column number to determine initial position of the display on the virtual screen wide.
When "FixedMode"=Yes, terminal display begins on the left position of the virtual screen.

StartPosY=<num / line>
Choose row number to determine initial position of the display on the virtual screen length.
When "Fixed Screen Mode"=Yes, terminal display begins on the top position of the virtual screen.

EdgeLeft=<num / rows>
When in "Auto Scroll Mode" (see FixedMode=), the least number of rows that can remain at left of the cursor before making an "auto scroll".

EdgeRight=<num / rows>
When in "Auto Scroll Mode" (see FixedMode=), the least number of rows that can remain at right of the cursor before making an "auto scroll".

EdgeUp=<num / lines>
When in "Auto Scroll Mode" (see FixedMode=), the least number of rows that can remain above the cursor before making an "auto scroll".

EdgeDown=<num / lines>
When in "Auto Scroll Mode" (see FixedMode=), the least number of rows that can remain underneath the cursor before making an "auto scroll".

6.VIII [SCANNER] Section

This section groups the scanner operation global options.

Enable=<Yes/No>
Yes=The scanner is enabled by default
No=The scanner is disabled by default.

TurnOffScan=<Yes/No>
Yes=Disable scanner after a successful reading.
This feature is not currently implemented.

Prefix=<hex-string>
This string is sent before the barcode <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters) :
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

Suffix=<hex-string>
This string is sent after the barcode <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters) :
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

BeepOnDecode=<Yes/No>
Yes=generates a beep after a successful barcode reading.
No=Do not beep.

BeepFreq=<num / Hertz>
Succesful scan beep frequency. (in hertz).

BeepDur=<num / milliseconds>
Beep duration in milliseconds.

BeepFile=<string>
Scan beep WAV file used by some platforms.

Redundancy=<num / pass>
Number of good barcode readings needed to successfully decode it.
May be required if using poor quality barcodes to prevent misreadings.
Warning: redundancy increases the decoding time.
1=No redundancy (one pass)

SpottingBeam=<Yes/No>
Activates the "Double Trigger" feature for the Long Range scanners that allows to have an aiming spot (first position, fixed) and a scanning spot (second position, sweep).
Do not activate this option in a standard scanner.
Yes=The scanner uses the double trigger.
No=The scanner doesn't use the double trigger.
Not impelemted option.

ReplaceChar_X (_1 to _4)=<ASCII>
Replacing characters when scanning barcodes allows to keep out not supported characters.
This option is suitable for EAN128 control characters processing.
Format /ss/rr (/ss=source char, /rr=replacement char) by pairs. Up to 4 possible character replacement.
/00 means no replacement.

ConsecutiveTimeout=<num>
Delay time between two consecutive barcode reads. In milliseconds.

AutoScan=0
0=The scanner is controlled by trigger.
1=The scanner is automatically enabled when the session is opened.

AutoKey=<word / scancode> (0000)
Hot key allowing to switch from trigger mode to automatic scanner mode.

 

6.IX [<Symbology>] Sections

The available symbologies are:
UPC_E0
UPC_E1
UPC_A
EAN_8
EAN_13
MSI
CODABAR
CODE_39
CODE_D25
CODE_I25
CODE_11
CODE_93
CODE_128
PDF_417 (this symbology will be included on [CODES_2D] section on version 4.05 and further)
DATAMATRIX (this symbology will be included on [ CODES_2D] section on version 4.05 and further)
MAXICODE (this symbology will be included on [ CODES_2D] section on version 4.05 and further)
AZTEC (this symbology will be included on [ CODES_2D] section on version 4.05 and further)
CODE_UCC_128

These sections group the symbology-specific options.

On=<Yes/No>
The scanner is able to decode this symbology.
Warning: Enabling too many symbologies increases decoding time and generates misreadings.

Min=<num / char number>
Minimum number of characters accepted for this barcode type.

Max=<num / char number>
Maximum number of characters accepted for this barcode type.

For Symbol platforms only:
If Min= < Max=, reads barcodes between Min= and Max= length.
If Min= > Max=, reads barcodes that have Min= OR Max= length.
If Min=0 and Max=0, reads variable barcode length (minimum and maximum allowed depend on the barcode type).
Warning : Some barcode types may generate misreadings with variable length.
To read a CODE_128 over 55 characters, Min and Max must be =0.

Prefix=<hex-string>
This string is sent before the barcode <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

Suffix=<hex-string>
This string is sent after the barcode <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

Opt=<num>
0=Option disabled.
1=Option Enabled.
Options are available in some barcodes (supplemental, check-digit, etc.).

6.X [PRINTER] Section

This section groups the options for the PDA-attached printer.

Type=<string / Name>
Type of printer connected (WiFi or Serial).

Port=<num / Com#>
Communication port. One digit.
1=Com1
2=Com2
This field is mandatory if Type=Serial

Baud=<num>
Baud rate. Two digits.
12=1200 Bauds
24=2400 Bauds
48=4800 Bauds
96=9600 Bauds
19=19200 Bauds
38=38400 Bauds.
This field is mandatory if Type=Serial.

Parity=<uppercase letter>
Data parity.
O=Odd
E=Even
N=None
M=Mark
S=Space
This field is mandatory if Type=Serial.

DataBits=<num>
Data bits.
7= 7 Data bits.
8= 8 Data bits.
This field is mandatory if Type=Serial.

StopBits=<num>
Stop bits.
1= 1 stop bit.
2= 2 stop bits.
This field is mandatory if Type=Serial.

FlowControl=<uppercase letter>
N=None (No flow control).
S=Software flow control (XON / XOFF).
H=Hardware flow control (CTS / RTS).
This field is mandatory if Type=Serial.

Dsr=<Yes/No>
Yes=Sense "Data Set Ready" (DSR) signal for connection.
No=Ignore DSR.
This field is mandatory if Type=Serial.

Cts=<Yes/No>
Yes=Sense "Clear To Send" (CTS) signal for connection.
Np=Ignore CTS.
This field is mandatory if Type=Serial.

Cd=<Yes/No>
Yes=Sense "Carrier detect" (CD) signal for connection.
No=Ignore CD.
This field is mandatory if Type=Serial.

Tmout=<num / seconds>
Maximum waiting time for printer ready signal before it fails.
If printer fails, a message alerts the user and allows to retry print operation or abort.
This field is mandatory if Type=Serial.

AskReprint=<Yes/No>
Yes=After a successful print, ask the user to reprint the same label or to continue.
No=After a successful print, inform the user and continue.
This feature is not currently implemented.

IpAddress=<Num>
IP address or 0.0.0.0
This field is mandatory if Type=Wifi.

TCPPort=<Num>
Port.
This field is mandatory if Type=Wifi.

6.XI [DBGOPT] Section

This section groups the options for debugging file generation. These options may be used ONLY for debugging purposes. Full memory condition is not checked, and subsequent printing operations may fail. You MUST manually empty the files.

InLog=<Yes/No>
Yes=Logs all received data in a file.

InFile=<string / name>
File Name.

OutLog=<Yes/No>
Logs all sent data in a file.

OutFile=<string / name>
File Name.

ErrLog=<Yes/No>
Indicates whether to log protocol errors.

ErrDir=<string / name>
Folder for errlog files.

ErrLevel=<num>
Debug Level.
Debug level 0 means no debug (default value).
Debug level 99 is highest level.

PrnScr
The replacement character for the space char when printing screen.

6.XII [BC_EDIT_X] Section

Four sections, [BC_EDIT_0] to [BC_EDIT_3].
These sections group the options for the "Barcode edition" process.
Barcode reads may be modified by performing an editing process before send them to the input fields.
The edition process has three steps:
1) Evaluates the match conditions to determine if the process applies to the current barcode reading. The barcode must match ALL the conditions switched to "Yes" (LenDo, MatchDo, TypeDo).
2) Filters the barcode to keep or eliminate data by the "Y/N" pattern (Filter).
3) Inserts some characters by the "*" mask (Insert).

On=<Yes/No>
Yes=Evaluate this section and perform Barcode Edition (if match).
No=Do not evaluate this section (all the following options are ignored).

LenDo=<Yes/No>
Yes=Match barcode length.
Edition is performed if this condition is satisfied.

LenMin=<number / length>
Minimum length to match.

LenMax=<number / length>
Maximum length to match.

MatchDo=<Yes/No>
Yes=Match string.
Edition is performed if this condition is satisfied.

MatchPos=<num / position>
Position in the barcode to perform the match test (Starting at 1).

MatchStr=<string / pattern>
String to match in the barcode.

TypeDo=<Yes/No>
Yes=Match Barcode type.
Edition is performed if this condition is satisfied.

TypeBc=< barcode>
Type of barcode.

Filter=<string / pattern> 
Editing. Filter the source barcode data with this pattern:
Y=Keep the character.
N=Ignore the character.

Insert=<string / mask> 
Editing. After filter processing, applies this mask to the resulting data:
*=Keeps the character from the barcode
NNN=Inserts a new char
There are three ways to supply "hex-strings" (each target character takes always 3 source characters):
"Escaped", "/HH": A slash ("/" or "\") and a two-digits hexadecimal value, e.g. \1B for character 27.
"Numeric", "999": Three decimal digits, e.g. 065 for character "A".
"Alphabetic", "..A": Two dots and one alphabetic character, e.g. ..X for character "X.
i. e. to add "A" as prefix: 
Insert=065********** or
Insert=\41********** or
Insert=..A**********

6.XIII [COMKBD] Section

This section will be replaced by SCANSERIAL section on version 4.X.X. 
This section groups the options for the communications port as keyboard.

ComKbdOn=<Yes/No>
Yes=Uses the communication port as a keyboard entry.
No=Do not use.

Port=<num / Com#>
1=Com1
2=Com2
Communication port. One digit.

Baud=<num>
12=1200 Bauds
24=2400 Bauds
48=4800 Bauds
96=9600 Bauds
19=19200 Bauds
38=38400 Bauds.
Baud rate. Two digits.

Parity=<uppercase letter>
O=Odd
E=Even
N=None
M=Mark
S=Space
Data parity.

DataBits=<num>
7= 7 Data bits.
8= 8 Data bits.
Data bits.

StopBits=<num>
1= 1 stop bit.
2= 2 stop bits.
Stop bits.

BlocMode=<Yes/No>
Yes=Data is received as a block delimited by the Sob (Start Of Block) pattern (optional) and Eob (End Of Block) Pattern (mandatory). Data between Sob and Eob is used. Data may be processed as a barcode (prefix, etc.) if AsBarcode=Yes.
No=Data is received one character at a time, and processed as a keyboard entry (caps, lower and translation routines). For translation routines a 00 is added to create a scan-code.

AsBarcode=<Yes/No>
Yes=The input data (with BlocMode=Yes) is processed as a barcode. Prefix, suffix, and edit mode are available.
No=The input data is processed as a block of keyboard entry.

Sob=<hex-string>
Start of block pattern. Used when BlocMode=Yes only. Optional blocks may not have start pattern.
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters) :
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

Eob=<hex-string>
End of block pattern. Used when BlocMode=Yes only. Mandatory, blocks should have an end pattern.
In this format, three characters represent one final character.
There are three ways to supply "hex-strings" (each target character takes always 3 source characters) :
"Escaped", "/HH". A slash ("/" or "\") and a two-digits hexadecimal value. e.g. \1B for character 27.
"Numeric", "999". Three decimal digits. e.g. 065 for character "A".
"Alphabetic", "..A". Two dots and one alphabetic character. e.g. ..X for character "X

DoTmout=<uppercase letter>
Used when BlocMode=Yes only. It applies from the moment of receiving Sob.
N= Do not apply the time out.
P= Process all the data received from the Sob until the DoTmout.
D= Do not process the data received from the Sob until the DoTmout.

BlocTmout=<num>
The time expressed in milliseconds to do the DoTmout. Used when BlocMode=Yes only.

WakeUp=<Yes/No>
Yes=Reopen COMX: port at Power On wake up (useful for Bluetooth virtual com ports).

RestartBtn= <Yes/No/OnOff>
Yes=Show ComKbd Button. Reopen COMX: port at click (useful for Bluetooth virtual COM ports).
OnOff=Show ComKbd Button. Opens or closes COMX: port at click (useful for Bluetooth virtual COM ports).

6.XIV [SCANSERIAL] Section

This section groups the options for connecting a serial input device scanner.

On 3.X.X versions, this section is called COMKBD.

On=<Yes/No/OnOff> (No)
Yes=Uses serial port as scanner entry.
No= Do not use serial port.
OnOff=Serial port will be started by the 'WireLess bar' button (blue button on the command bar).

Port=
<num> (4)
Hardware or Virtual COMX: port for external scanner input.
COMx: port number from 2 to 10.
This port number will be the bluetooth virtual port or a physical COMx: port.

Baud=<num> (9600)
Baud rate. 

Terminator=<num> (0)
Terminator character for serial input. 0 means 'all control characters (<0x20)'.

WakeUp=
<Yes/No> (Yes)
Restart the serial port if the PDA is turned off and on.

Tmout=<num> (500)
Terminates an input operation by timeout.
In milliseconds.

RestartBtn=<Yes/No> (Yes)
Yes=Show ComKbd Button. Reopen COMX: port at click (useful for Bluetooth virtual com ports).

RestartKey=<num> (2083)
Key used to restart (close an open) the COMx: port (RestartBtn MUST be Yes).
This is a keyboard Scan Code. F24 by default.

Query=
String sent through the serial port when activated.
That allows to poll another device.

OneShot=<Yes/No> (No)
Closes the port after receiving a data frame.

6.XV [DISPLAYFONT] Section

This section groups the options for the windows fonts that Telnet will use on the text screen.

FullName=<string>
Font full name.

Size=<string>
Font size.

The number of lines and columns inside the display depends on the size and type of font, the terminal model and if the commandBar is displayed or not. 

These are some configuration examples:

MC3000 /  3090
For a CommandBar with Courier New BOLD font configuration.
Size 36 => Screen 16 x 8 Lines=> Screen 17 x 8 Lines
Size 31 => Screen 20 x 9 Lines
Size 29 => Screen 21 x 10 Lines
Size 27 => Screen 22 x 10 Lines
Size 25 => Screen 24 x 11 Lines
Size 23=> Screen 26 x 12 Lines

CK30, MC50, MC9090, MC9000, HHP9500 / 7900, I700, etc...
For a CommandBar with Courier New BOLD font configuration.
Size 30 => Screen 15 x 9 Lines
Size 27 => Screen 17 x 10 Lines
Size 24 => Screen 18 X 12 Lines
Size 22 => Screen 20 x 13 Lines
Size 21 => Screen 21 x 13 Lines
Size 18 => Screen 24 x 16 Lines
Size 16 => Screen 30 x 18 Lines

See in Chapter 4 the Display Configuration screen.

WinFillColor=<Black/Red/Green/Yellow/Blue/Magenta/Cyan/White> (Black)
Background color for the part of the window not used as display. This feature can take values from 0 to 7.

6.XVI [BLACKSCREEN] Section

This section allows to display an entire black screen when in input time out occurs and lock serial com input data. Black Screen state is unlocked by specific keyboard action. 
This feature will be used for security reasons in vehicle mounted terminals.

On=<Yes/No>
Yes=Use BlackScreen user timeout feature.
No=Do not use it.

Time=<Num>
User input timeout in seconds before showing an entire black screen.

KeyUnLock=<word/scancode>
Unlock Black Screen (Ctrl-?). Use Keyboard test in the terminal to look for a suitable keystroke scancode.

6.XVII [BLUETOOTH] Section

This section allows to build an internal virtual COMx: port from an external captured Bluetooth device (as a wireless scanner). Input data will be captured from the device by ComKbd feature and will be returned to user application as barcodes (block mode) or keystrokes.

This section changes following the PDA operating system (CE300, CE 4.20 / CE 5.0).

For Win CE 3.XX (Windows for Pocket PC)

Bluetooth not supported.

For Win CE 4.20 / WM 2003

Bluetooth section has the following options:

On=<Yes/No>
Yes=Configure Bluetooth driver as COMx: Port.
No=Do not configure.

Port=<Num>
Communication virtual COMx: port to create. One digit.
Set ComKbd port to this virtual COMx: port to get the data

Mac=<word/scancode>
MAC address of the BlueTooth Device to get.
In Hexadecimal characters

Channel=<Num>
BlueTooth RF channel to use.

WakeUp=<String>
Yes=Reload Bluetooth at Power On wake up (Useful for Bluetooth virtual com ports)

For Symbol terminals with Win CE5.0 / WM 5 ( Stonestreet One stack)

On=<Yes/No>
Yes=Use the BT persistent button in configuration section.
No=Do not use.
In WinCE 5.0 or WM2005 devices, allows to keep persistent the BT association.

6.XVIII [USER_SOUND_X]

This section allows to configure the sounds that will be played by the WTnCE52 client.

Enable=<Yes/No>
Yes= Perform this beep.
No= Do not perform this beep.

IDCol=<num>
Column to look for Beep ID (IDString), starting at 1 and up to 80.

IDRow=<num>
Row to look for Beep ID (IDString), starting at 1 and up to 24.

IDString=<string>
The string ID to look for on the display (at the position defined in IDCol and IDRow) to perform the beep.

BeepTimes=<num>
How many times to repeat this Beep.

BeepMode=
0= Playing a *.WAV file by sound card (use WaveFile option).
1= Using Windows OS defined beeps (use OSBeep option). 
2= Using OEM sounds API (use OEMxxx options).

WaveFile=<string/name>
*.WAV file to play (BeepMode=0).

OSBeep=
0= MB_ICONASTERISK / SystemAsterisk (BeepMode=1)
1= MB_ICONEXCLAMATION / SystemExclamation (BeepMode=1)
2= MB_ICONHAND / SystemHand (BeepMode=1)
3= MB_ICONQUESTION / SystemQuestion (BeepMode=1)
4= MB_OK / SystemDefault (BeepMode=1)

OEMFreq=<num>
The beep frequency in Hertz (BeepMode=2).

OEMDur=<num>
The beep duration in milliseconds (BeepMode=2).

6.XIX [KBD_MACRO] Section

This section allows to configure a key to perform a "macro" sequence of keyboard actions.
The associated file 'KbdMacro.txt' contains the keyboard actions to perform.

KeyMacro=<num> (0000)
Key to trigger the corresponding "macro" action.
This is a keyboard Scan Code.

6.XX [LAUNCHEXE] Section

This section groups the options for launching an extern ".exe" application.
The application is launched when a defined pattern is found in a specific place of the terminal display.

On=<Yes/No> (No)
Looks for a pattern on the display to launch external applications.
Yes=Look for pattern
No=Do not look for

Row_X=<num> (1)
Row position (Y, 1 based) of the pattern to look for.

Column_X=<num> (1)
Column position (X, 1 based) of the pattern to look for.

Match_X=<string> (ABCDEF)
Text pattern to look for on the emulated terminal display.

CursorAtRow=<num> (0)
In no zero, checks if the cursor is at the given position.

CursorAtCol=<num> (0)
In no zero, checks if the cursor is at the given position.

ExeName=<string>
dot-exe file name of the application to launch.
If the exe name is SCANSERIAL, the serial port input is enabled.

Arguments=<string>
Command line arguments passed to exe. Can get variable data from current screen by {r,c,l} syntax.

ExeKey=<word/scancode>
Hot key allowing to start the exe instead the screen conditions.

6.XXI Sección [MONITORING]

This section allows to log emulator events with the WireLess Deployer client, to perform an activity monitoring .

On=<Yes/No> (No)
This section is enabled.

Connections=<Yes/No> (Yes)
Enables the log of the performed connections.

ResponseTmout=16
Enables the log of the host response timeout ever this value (in seconds).

ResponseAvg=<Yes/No> (Yes)
Enables the log of the performed connections.

Scans=<Yes/No> (Yes)
Enables the log of the performed scans / keystrokes during connection.

 

 

Contents / Chapter 5Chapter 7