Contents / Chapter 5 / Chapter 7
The WT configuration file is a text file containing the default values for the WT common options (WTnVT and WTn52) and several keyboard sequences generated by the terminal. Some of those values could 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 on the installation procedure.
The WT 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.
Sections group keys and values. Section names are in capital
letters surrounded by brackets: "[TELNET]" denotes Telnet section.
The order of the sections in the file is not relevant.
The keys are keywords that have sense only in their own section so they can't be moved from one section into another. Case (lowercase or uppercase) is not relevant for keywords, but uppercase makes them more readable. Keys must be followed by "=" sign and the value of the parameter, i.e.: LocalBeeps=Yes.
Values follow the keys and "=" sign. Each parameter expects the value in a fixed format (indicated with the parameter definition as "<format>"). Values may be empty in some cases.
Formats are:
<Yes/No>
Needs Yes or No value.
<string / xxxx>
ASCII text characters, delimited (or not) by " character. If the
string is delimited by ", the spaces (20h) are preserved, otherwise
they are ignored. xxx 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, i.e.: \1B for character 27 |
| "Numeric" | "999" | Three decimal digits, i.e.: 065 for character "A" |
| "Alphabetic" | "..A" | Two dots and one alphabetic character, i.e. : ..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, i.e.: A50F.
<uppercase letter>
One uppercase character, i.e.: N.
[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.
[TELNET]
This section groups the features for the Telnet level negotiation and options and network features.
[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 group the 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 was replaced by [CODES_2D] section on version 4.05.
[CODES_2D]
2D (2 dimensions) barcode symbologies. Codes PDF 417, DATAMATRIX,
MAXICODE, AZTEC.
[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].
This sections groups the options for the "Barcode editing"
processing.
[COMKBD]
This section has been replaced by SCANSERIAL section.
[SCANSERIAL]
This section groups the options for connecting a serial input device scanner.
[DISPLAYFONT]
This section groups the options for the windows font the telnet screen will use.
[LAUNCHEXE]
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.
[BLUETOOTH]
This section allows to build an internal virtual COMx: port from an external captured 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.
This section allows to configure the associated files to download.
File_X=<string / name>
Name of the associated file for download (WTnDnl). By default, the files are:
File01=_WTnCEVt.cfg
File02=Fnt_VT0.cfg
File03=Fnt_VTE.cfg
File04=Fnt_VTB.cfg
File05=Fnt_PC437.cfg
File06=Fnt_PC850.cfg
File07=Fnt_PC852.cfg
This section groups PDA-specific features.
UsesVoice=<Yes/No> (Yes)
Use the voiXtreme voice engine (TTS & ASR).
Needs the voiXtreme library to be installed after the emulator.
Uses the WTnVoiCE.cfg configuration file (see Chapter
7).
PwdWConf=<string / name> (empty)
Password to access WTn local configuration menu. Default value: 234.
PwdExit=<string / name> (empty)
Password to exit the application. Default value: 307.
TaskBar=<Yes/No/Active/Lock> (No)
The TaskBar contains the Windows Start menu and the SIP Panel. In WINCE3 is on the top of the screen and
in WINCE4 is on the bottom.
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 WINCE3 is on the bottom of the screen and
in WINCE4 is on the top of the screen.
Yes=Display the command bar.
No=Do not display the command bar.
CBMenuMainMenu=<Yes/No/Ask> (Yes)
Yes=Enables the [Main Menu] option in the command bar. Needs CommandBar parameter set to YES to be visible.
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.
CBMenuDisconnect=<Yes/No/Ask> (Yes)
Yes=Enables the [Disconnect] option in the command bar. Needs CommandBar parameter set to YES to be visible.
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.
SIPPanel=<Yes/No> (Yes)
Yes=Display the icon to open the keyboard. CommandBar feature must be set to Yes.
ScrollBar=<Yes/No> (Yes)
Yes=Displays the scrollbars.
Language=< EN / FR / ES >(EN)
EN=English.
FR=French.
ES=Spanish.
CtrlEsc=<Yes/No> (Yes)
Yes=Do not Block Ctrl-Esc keystroke.
No=Blocks Ctrl-Esc keystroke.
NoMenu=<Yes/No> (Yes)
Yes=Do not display WTnCE main menu, automatically connect to the first host.
No=Display standard main menu.
BatteryAlert=<num / percent> (10)
Low Battery level MessageBox user alert.
When battery charge reach this level (%), a message box is displayed.
0 means no alert message.
AutoConnect=<Yes/No> (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 / seconds> (20)
Time to wait for RF ready before send data.
In seconds. 0 means no RF ready check.
RFWaitBeep=<Yes/No> (Yes)
Yes=Perform short beeps during RF wait time.
No=Do not beep.
RFWaitPopUp=<Yes/No> (Yes)
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.
This section allows to configure the host sessions available for the user.
Max=<num / sessions> (4)
Maximal number of sessions, range 1-4.
KeyPrev=<word / scancode> (Fn-Ctl-Y)
Previous session key.
KeyNext=<word / scancode> (Fn-Ctl-Z)
Next session key.
KeyEndSession=<word / scancode>
(Ctrl-X)
End session key.
HitAnyKey=<Yes/No> (Yes)
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").
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.
Port=<num / port #> (23)
Telnet connection port at host IP address. The user may overwrite this value.
This value is recalled in a "Bios Boot Sequence".
TTypeSelByHost=<Yes/No> (Yes)
In order to set this option to Yes, TelOpTTypeTerm=
must be on "Yes" too. If TelOpTTypeTerm= is
"No", set this option to "No" too.
Telnet protocol allows the host to select the most convenient terminal-type
choosing it among a list (normally following host custom settings) that indicates which
types of terminal emulation are available on the client and which type of
terminal emulation is preferred by the user. (The list shown by WT is always ANSI,
VT52, VT100 and VT220 terminal types).
* If TTypeSelByHost=Yes:
The final terminal type emulation is selected by host after
negotiation.
* If TTypeSelByHost=No:
Terminal type emulation
is not modifiable by the Host, it is selected by user (TTypePreferred=). (Information is only sent to the host for application
purposes).
TTypePreferred=<ANSI /
VT52 / VT100 / VT220> (empty)
* If TTypeSelByHost=Yes:
This terminal is indicated to the host as the preferred by
the user from the available terminal-type list.
* If TTypeSelByHost=No:
This terminal is indicated to be the only possible emulation
for the terminal (no list).
TTypeName=<string / Name> (empty)
Telnet terminal type negotiation uses "normalized" terminal type
names, but some hosts may need other specific forms.
If this field is empty, WT uses system "normalized" strings.
If not empty, sends the string as the name of the user's preferred terminal type (TTypePreferred=).
EmulationType=<TN->Telnet / SSH1->SSH 1.5 / SSH2->SSH 2>
(empty)
Emulation type (Telnet, SSH 1.5, SSH 2).
ProxyMode=<Disabled / Passive / Active> (Disabled)
Proxy Server state.
ProxyIP=10.10.10.15
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=. -> Looks for any ProxyServer in local
network and connects to it.
See Proxy Server for WireLess TelNet description.
ProxyPort=<numeric> (45621)
Telnet connection port at Proxy IP address.
This section groups the features for the Telnet level negotiation and options and network features. Telnet protocol has "Options" that can be negotiated between the client (WT) and the Host computer.
TelOpEchoHost=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the host to do "remote
echo".
TelOpBinHost=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the host to perform a
"binary" connection (the host may send characters from 00h to FFh).
TelOpBinTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants to
perform a "binary" connection (the terminal may send characters
from 00h to FFh)
TelOpEorHost=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host asking to do an end of
record during binary connection.
TelOpEorTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants to
perform an end of record during binary connections.
TelOpSgaHost=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host to suppress the "Go Ahead"
system.
TelOpSgaTerm=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants to
suppress the "Go Ahead" system (the terminal never sends "Go
Ahead" signal).
TelOpNawsTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants
to Send NaWS (Windows Size information). Set this option to =Yes only if the host really
needs terminal window size information.
TelOpEnvTerm=<Yes/No> (No)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants
to send environment variables. Set this option to "Yes" only if the
host really needs terminal environment information.
TelOpTTypeTerm=<Yes/No> (Yes)
(Telnet Option) During telnet connection negotiation, the terminal sends
(=Yes) or not (=No) a request to the Host indicating that the terminal wants to
send the Terminal Type information (what kind of terminal is connected) information to the
host.
DoTcpAlive= <Yes/No> (No)
Yes= WT periodically pings the Host to test TCP connection state.
DoPingToHost=<Yes/No> (Yes)
Yes=WT periodically sends an ICMP ping to Host (RFC792).
Passive=<Yes/No> (Yes)
Yes=WT waits for telnet host commands.
No=WT send telnet commands to host.
This section groups the "Logical scrolling" options to allow to map a standard 24x80 screen (called "virtual screen") in an 8 or 16x20 PDA physical display.
Do not mistake the "Logical Scrolling" (that is a PDA display movement in the emulated virtual screen) with "Screen Scrolling" (that is a text movement into the emulated terminal screen) and "Scroll Area" (that is selected a part of the emulated virtual screen).
See also "Screen and Display" figure in Chapter 3.
FixedMode=<Yes/No> (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> (0)
When in "Fixed Screen Mode" (see FixedMode=), the
left start position for terminal display on virtual screen. The first left
position is 0.
StartPosY=<num / line> (0)
When in "Fixed Screen Mode" (see FixedMode=), the
top start position for terminal display in virtual screen. The first top
position is 0.
ScrollX=<num / rows> (0)
When in "Auto Scroll Mode" (see FixedMode=), the number
of rows that the display moves (left or right side) when KeyLeft= or KeyRight=
keys are pressed.
ScrollY=<num / lines> (0)
When in "Auto Scroll Mode" (see FixedMode=), the number
of lines that the display moves (up or down side) when KeyUp= or KeyDown=
keys are pressed.
KeyUp=<word> (3200 / Fn+Ctrl+Up)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display up in logical screen.
KeyDown=<word / scancode> (3100 / Fn+Ctrl+Down)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display down in logical screen.
KeyLeft=<word / scancode> (2500 / Fn+Ctrl+Left)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display left in logical screen.
KeyRight=<word / scancode> (2600 / Fn+Ctrl+Right)
When in "Auto Scroll Mode" (see FixedMode=), the scan
code of the key that moves the display right in logical screen.
EdgeLeft=<num / rows> (4)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain at left of the cursor before making an "auto
scroll".
EdgeRight=<num / rows> (1)
When in "Auto Scroll Mode" (see FixedMode=), the lesser
number of rows that can remain at right of the cursor before making an
"auto scroll".
EdgeUp=<num / lines> (1)
When in "Auto Scroll Mode" (see FixedMode), the lesser
number of rows that can remain above the cursor before making an "auto
scroll".
EdgeDown=<num / lines> (1)
When in "Auto Scroll Mode" (see FixedMode), the lesser
number of rows that can remain under the cursor before making an "auto
scroll".
This section groups the scanner operation global options.
Enable=<Yes/No> (Yes)
Yes=The scanner is enabled by default.
No=The scanner is disabled by default.
Scanner can be dynamically enabled or disabled by specific ROI
and Telxon sequences.
TurnOffScan=<Yes/No> (Yes)
Yes=Disable scanner after a successful read, re-enable scanner by ROI escape
sequences.
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> (No)
Yes=Uses frequency (BeepFreq) and duration (BeepDur) to generate a beep after a successful barcode reading.
No=Uses default hardware configuration.
BeepFreq=<num / Hertz> (2600)
Scan beep frequency (in Hertz).
BeepDur=<num / milliseconds> (200)
Beep duration in milliseconds.
BeepFile=<string> (empty)
Scan beep WAV file used by some platforms.
Redundancy=<num / pass> (1)
Number of good barcode readings needed to decode successfully.
May be required, if using poor quality barcodes, to prevent misreads.
Warning: redundancy increases the decode time.
1=No redundancy (one pass)
SpottingBeam=<Yes/No> (No)
Activates the "Double Trigger" feature for the Long Range scanners,
which 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 scanners uses the double trigger.
No=The scanner the scanner doesn't use the double trigger.
ReplaceChar X=<hex-string>
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. 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. i.e.: \1B for character 27.
"Numeric" (999): Three decimal digits(ASCII). i.e.: 065 for character "A".
"Alphabetic" (..A): Two dots and one alphabetic character. i.e.: ..X for character "X".
Hex-strings may be delimited by " " to be more readable.
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 is included on [CODES_2D] section on version 4.05)
DATAMATRIX (this symbology is included on [ CODES_2D] section on version 4.05)
MAXICODE (this symbology is included on [ CODES_2D] section on version 4.05)
AZTEC (this symbology is included on [ CODES_2D] section on version 4.05)
CODE_UCC_128
These sections group the symbology-specific options.
On=<Yes/No> (most popular)
The scanner tries to decode this symbology.
Warning: Enabling too many symbologies should increase decode time and produce
misreads.
Min=<num / char number> (smart ...)
Minimum characters accepted for this barcode type.
Max=<num / char number> (smart ...)
Maximum 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.
Suffix=<hex-string>
This string is sent after the barcode: <ScanPrefix><BarcodePrefix><Code><BarcodeSuffix><ScanSuffix>
In this format, three characters represent one final character.
Opt=<num> (0)
0=Option disabled.
1=Option Enabled.
Options are available in some barcodes (supplemental, check-digit, etc.).
This section groups the configuration options of the PDA-attached printer.
Type=<string / Name> (PS1000)
Type of printer connected.
Port=<num / Com#> (1)
Communication port COMx:. One digit.
Baud=<num> (96)
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> (N)
O=Odd
E=Even
N=None
M=Mark
S=Space
Data parity.
DataBits=<num> (8)
7= 7 Data bits.
8= 8 Data bits.
Data bits.
StopBits=<num> (1)
1= 1 stop bit.
2= 2 stop bits.
Stop bits.
FlowControl=<uppercase letter>
(H)
N=None (no flow control).
S=Software flow control (XON / XOFF).
H=Hardware flow control (CTS / RTS).
Dsr=<Yes/No> (Yes)
Yes=Data Set Ready (DSR) sensing signal for connection.
No=Ignore DSR.
Cts=<Yes/No> (No)
Yes=Clear To Send (CTS) sensing signal for connection.
Np=Ignore CTS.
Cd=<Yes/No> (No)
Yes=Carrier detect (CD) sensing signal for connection.
No=Ignore CD.
Tmout=<num / seconds> (20)
Maximum time (in seconds) to wait for printer ready signal before it fails.
If printer fails, a message alerts the user and allow to retry print operation or
abort.
AskReprint=<Yes/No> (Yes)
Yes=After a successful print, ask the user to reprint the same label or to
continue.
No=After a successful print, informs the user and continues.
Delay=<num> (0)
Time to wait (in milliseconds) before printing.
This section groups the options for debugging files 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> (No)
Logs in a file all data received.
InFile=<string / name> (\In.log)
File Name.
OutLog=<Yes/No> (No)
Logs in a file all data sent.
OutFile=<string / name> (\Out.log)
File Name.
Four sections, [BC_EDIT_0] to [BC_EDIT_3].
These sections group the options for the "Barcode editing" process.
Barcode readings may be modified by performing an editing process before sending
them to the input fields.
The editing process has three parts:
1) Evaluates the match conditions to determine if the process applies to this
barcode reading. The barcode must match ALL the conditions switched to
"Yes" (LenDo, MatchDo, TypeDo).
2) Filters the barcode by the "Y/N" pattern (Filter) to keep or eliminate data.
3) Inserts some characters by the "*" mask (Insert).
On=<Yes/No> (No)
Yes=Evaluate this section and perform Barcode Editing (if match).
No=Do not evaluate this section (all the following options are ignored).
LenDo=<Yes/No> (No)
Yes=Do match barcode length.
Editing is performed if this condition is satisfied.
LenMin=<number / length> (0)
Minimum length to match.
LenMax=<number / length> (32)
Maximum length to match.
MatchDo=<Yes/No> (No)
Yes=Do Match string.
Editing is performed if the barcode satisfies this condition.
MatchPos=<num / position> (1)
Position in the barcode to perform the match test (start at 1).
MatchStr=<string / pattern> (033)
String to match in the barcode.
TypeDo=<Yes/No> (No)
Yes=Do match Barcode type.
Editing is performed if the barcode satisfies this condition.
TypeBc=<num / barcode> (CODE_128)
Type of barcode.
Filter=<string / pattern> (NNYYYYNNYYYN)
Editing; filters the source barcode data with this pattern:
Y=Keep the character.
N=Ignore the character.
Insert=<string / mask> (****013****)
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**********
On 4.X.X versions, this section has been replaced by SCANSERIAL
section.
This section groups the options for the communication 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).
This section groups the options for connecting a serial input device scanner.
On 3.X.X versions, this section was 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.
This section groups the options for the windows fonts that Telnet will use on
the text screen.
Select only fixed width fonts.
Family=<string> ("Courier
New")
Font type (family).
FullName=<string> ("Courier
New Bold")
Font full name.
Size=<string> (16)
Font size (height) in pixels.
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.
SizeDHDW=<num> (24)
Size of the DOUBLE-HEIGHT / DOUBLE WIDTH font.
DEC_VT protocol allows font display in double height, double width and double
height/double width. Only double height/double width mode is taken into account
using the same font with a different size. Choose the font size carefully for it
to roughly double the size of "Size". It may be
impossible to get an exact double size.
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.
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
Line=<num> (1)
Line position (Y, 1 based) of the pattern to look for.
Column=<num> (1)
Column position (X, 1 based) of the pattern to look for.
Match=<string> (ABCDEF)
Text pattern to look for on the emulated terminal display.
ExeName=<string>
dot-exe file name of the application to launch.
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 according to the operating system (CE300, CE 4.20 / CE 5.0) of the PDA.
No bluetooth supported.
The bluetooth section has the following options:
On=<Yes/No> (No)
Yes=Configure Bluetooth driver as COMx: port.
No=Do not configure.
Port=<Num> (6)
Communication virtual COMx: port to create. One digit.
Set ComKbd port to this virtual COMx: port to get the data.
Mac=<word/scancode> (020406080A0C)
MAC address of the BlueTooth Device to get.
In Hexadecimal characters.
MAC address 000000000000 means the user
must input the address by configuration menu.
Channel=<Num> (1)
BlueTooth RF channel to use.
WakeUp=<String> (No)
Yes=Reload Bluetooth at Power On wake up (Useful for Bluetooth virtual com
ports).
On=<Yes/No>
Yes=Use the BT persistent button in configuration section.
No=Do not use it.
In WinCE 5.0 or WM2005 devices, allows to keep persistent the BT association.