Honepvell

BasicTE
Basic TerminaI Emulation
For Honeywell computers powered by Android 6.0 and higher

User Guide
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Disclaimer
Honeywell International Inc. ("H II") reserves the right to make changes in specifications and other information contained in
this document without prior notice, and the reader should in all cases consult HII to determine whether any such changes
have been made. The information in this publication does not represent a commitment on the part of HI I.
HII shall not be liable for technical or editorial errors or omissions contained herein; nor for incidental or consequential
damages resulting from the furnishing. performance. or use of this material. HII disclaims all responsibility for the
selection and use of software and/or hardware to achieve intended results.
This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this
document may be photocopied, reproduced, or translated into another language without the prior written consent of Hll.
Copyright© 2017-2020 Honeywell International Inc. All rights reserved.
Web Address: www.honeywellaidc.com
Android is a trademark of Google Inc.
Other product names or marks mentioned in this document may be trademarks or registered trademarks of other
companies and are the property of their respective owners.
For patent information, refer to www.hsmpats.com

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]

 TABLE OF CONTENTS

Customer Support .................................................................................................................. iv

Technical Assistance ............................................................................................................. iv
Product Service and Repair ................................................................................................ iv
Limited Warranty .................................................................................................................... iv
Send Feedback ........................................................................................................................ iv

Chapter 1 - Get Started .................................................................................... 1

About Basic Terminal Emulator................................................................................................ 2
Supported Mobile Devices ................................................................................................... 2
About BasicTE Licensing ...................................................................................................... 2
About Honeywell License Manager.................................................................................. 4
About BasicTE and Network Protocols ........................................................................... 5
Install BasicTE on Your Mobile Device .................................................................................. 5
Launch BasicTE .............................................................................................................................. 7
About Configure Autorun ..................................................................................................... 9
Close BasicTE .................................................................................................................................. 9
About Status Indicators ............................................................................................................ 10
About the Toolbar.................................................................................................................. 10
About the Connection Status Bar................................................................................... 11
About Basic TE Applications .................................................................................................... 12
VT/ANSI Alert Sounds ......................................................................................................... 12
About 5250 Applications ................................................................................................... 12
VT/ANSI Applications .......................................................................................................... 14

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]

 Chapter 2 - Configure and manage BasicTE ............................................. 17
Configure BasicTE with EZConfig ......................................................................................... 18
Enterprise Provisioner (EP) ............................................................................................... 18
How to Edit the XML File .................................................................................................... 20
Configure Multiple Devices Using Configuration Barcodes................................ 21
Configure General Application Settings ............................................................................. 22
Configure the BasicTE Exit Password ........................................................................... 22
Configure Hardware Escape Key..................................................................................... 23
Configure the Orientation.................................................................................................. 24
Pan the BasicTE Viewport by Touching the Screen ................................................. 24
Move the Cursor Location by Touching the Screen ................................................ 25
Zoom In or Out on the Screen with a Pinching Gesture......................................... 26
Configure Full Screen Mode ............................................................................................. 26
Wireless Printing.................................................................................................................... 27
Enable Barcode Data Editor Plugin in TE.................................................................... 27
Screen Wake ............................................................................................................................ 27
Key Mapping Functionality in TE .................................................................................... 28
Configure Options for Each Session .................................................................................... 29
Configure a TCP/IP Connection ...................................................................................... 30
Configure Basic TE for SSH................................................................................................ 31
Configure Protocol Options .............................................................................................. 33
Configure BasicTE Screen Sizes and Cursor Behavior .......................................... 37
Set BasicTE to Display a Prompt to Reconnect.. ....................................................... 39
Barcode Settings ................................................................................................................... 41
Block Mode..................................................................................................................................... 44
Use the SnapShot Feature ....................................................................................................... 44
Upload a SnapShot File ...................................................................................................... 45
Configure SnapShot Settings .......................................................................................... 46

Chapter 3 - Customization and Security ................................................... 49

Use the Auto-Login Feature .................................................................................................... 50
Develop Auto-Login Script Files ..................................................................................... 50
Commands for Auto-Login Script Files........................................................................ 50

ii BasicTerminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Use Auto-Login Search Strings .......................................................................................50
Use Control Characters .......................................................................................................51
Load the Auto-Login Script File ......................................................................................51
Disable the Auto-Login Feature ......................................................................................52
Sample Auto-Login Script Files .......................................................................................52
About Honeywell Launcher......................................................................................................52
Configure Access to BasicTE ............................................................................................53
Honeywell Guidelines for BasicTE Security .......................................................................55

Appendix A - Scan Barcodes .......................................................................... 5 7

Scan Barcodes While Using BasicTE ...................................................................................58
Use a Ring Scanner with BasicTE ..........................................................................................62

Appendix B - Soft Input Panel Use ............................................................... 65

About BasicTE and Soft Input Panels ..................................................................................66
About the Default Soft Input Panels ..............................................................................66
SIP Options in Portrait Mode ............................................................................................66
SIP Options in Landscape Mode .....................................................................................68
About the SIP Keys....................................................................................................................... 70
Editing Keys ............................................................................................................................. 70
Custom Keyboard and Landscape KB Creation............................................................... 71
Landscape KB Guidelines. ................................................................................................. 71
Sample of Default Keyboard XML File .......................................................................... 72
Default Key lndex ................................................................................................................... 76
Keyboard Remapping Functionality .............................................................................. 76

iii
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Customer Support
Technical Assistance
To search our knowledge base for a solution or to log in to the Technical Support
portal and report a problem, go to www.hsmcontactsupport.com.
For our latest contact information, see www.honeywellaidc.com/locations.

Product Service and Repair

Honeywell International Inc. provides service for all of its products through service
centers throughout the world.

To obtain warranty or non-warranty service, you must first obtain a Return Material
Authorization number (RMA #), and then return your product to Honeywell (post­
age paid) with a copy of the dated purchase record.
To learn more, go to www.honeywellaidc.com and select Service & Repair at the
bottom of the page.

Limited Warranty
For warranty information, go to www.honeywellaidc.com and click Resources>
Product Warranty.

Send Feedback
Your feedback is crucial to the continual improvement of our documentation. To
provide feedback about this manual, contact the Honeywell Technical Communi­
cations department at [email protected].

iv
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 GET STARTED

This chapter introduces the Basic Terminal Emulator application and includes
these sections:
• About Basic Terminal Emulator
• Install BasicTE on Your Mobile Device
• Launch BasicTE
• Close BasicTE
• About Status Indicators
• About Basic TE Applications

1
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About Basic Terminal Emulator
The Basic Terminal Emulator (TE) application emulates VT/ANSI and 5250
terminals on your Honeywell mobile device. For all supported Honeywell-branded
mobile devices, the BasicTE program name is "Basic Terminal Emulator".

The BasicTE application uses Transmission Control Protocol/Internet Protocol

(TCP/IP), telnet and SSH network protocols to provide reliable data transfers
between the host mobile device and terminal. Implementation of VT/ANSI mobile
device emulation supports both 7-bit and 8-bit communication environments. An
8-bit asynchronous character encoding scheme and a 7-bit code extension
technique ensures the mobile device is compatible with ANSI and ISO standards.

To facilitate data transfers, the Honeywell mobile device processes characters

received from the host mobile device as standard ANSI character codes and
functions. When the keys on the terminal are used, the application generates and
transmits keyboard codes back to the host mobile device. The terminal supports
VT/ANSI mobile device top-row functions, main keypad, editing and auxiliary key
emulation. Character codes supported include 7-bit and 8-bit types.

Supported Mobile Devices

These mobile devices support BasicTE:
• Dolphin 75e Handheld mobile devices powered by Android 6.0
• Dolphin CT50 Handheld mobile devices powered by Android 6.0
• CN75/CN75e Handheld mobile devices powered by Android 6.0
• CN51 Handheld mobile devices powered by Android 6.0
• CT60/CN80/CT40 Handheld mobile devices powered by Android 7.0 and higher
• CK65 Handheld mobile devices powered by Android 8.0 and higher
• Thor VMlA powered by Android 8.0 and higher
• EDA50/EDA50K/EDA60K/EDA70 powered by Android 7.0 and higher
• EDA51/EDA61K/EDA75 powered by Android 8.0 and higher

Note: BasicTE will be supported on all the Android devices from CTS0 to O75E, Phoenix
(CX75), Mobility edge, and EDA devices.

About BasicTE Licensing

Using BasicTE requires an application license. If a demo version of the BasicTE
application was preinstalled on your Honeywell mobile device, you need to
purchase an application license to use BasicTE once the demo period (60 days)
has expired.

Note: Install TE application (SCP or DCP bundle) after confirming that the OS, device date
and device time are updated to avoid any issues with demo license exportation.

2 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 If a Licensed version of the Basic TE application was preinstalled on your Honeywell
mobile device, you do not need to purchase an application License to use Basic TE.
If BasicTE was not preinstalled on the mobile device, you need to install the
application and purchase an application License to use BasicTE once the demo
period (60 days) has expired.

If the device SKU is enabled on a new device, then the permanent license
"icp.emulator.browser.d" will be activated on those devices.

Note: Refer device data sheet for SKU details.

About Upgrades
To upgrade the BasicTE application on the mobile device, you must have a valid
application License and an active maintenance License installed. Application
Licenses include one year of maintenance upgrades starting from the time the
License is activated. Maintenance must be renewed before the end of the first year
or before the current maintenance license expires, failing which a new application
License must be purchased for utilizing any application upgrades.

About Demo Licenses

After you install BasicTE, the application runs in demo mode for 60 days or until
you purchase an application License. During the 60-day demo period, a demo
mode message box appears when you Launch BasicTE. The message displays the
days remaining on the demo License. Select OK to dismiss the demo message and
use the application.

After 60 days, a License expired message box appears informing you the free trial
period has come to an end. Select OK to dismiss the message and close the
application.
For information on purchasing and installing Licenses, contact your Honeywell
representative.

3
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 How to Identify the Active License Type
If a license is active on the Honeywell mobile device, you can identify the license
type from the About screen in the BasicTE application.

To View License Information

1. Open the BasicTE app.

2. Touch the three dots Din the upper right corner.

3. Select About. The license type is identified in the Type field and in the extension
of the Feature name.
• Clientpack.d.demo
The ".d.demo" extension indicates a demo license.
• Clientpack.d, icp.emulator.browser.d
The ".d" extension indicates a permanent application license.
• Clientpack.maint.d
The ".maint.d" extension indicates a maintenance license.

About Honeywell License Manager

You can use the Honeywell License Manager to download and distribute your
BasicTE licenses.

To Download License Manager

1. Go to www.honeywellaidc.com.
2. Select Resources> Downloads> Software.
3. Click on the Technical Support Downloads Portal link,
https://hsmftp.honeywell.com.
4. Create an account if you have not already created one. You must login to
download the software.
5. Install the Honeywell Download Manager tool on your PC prior to trying to
download any files. The link for the Honeywell Download Manager is located in
the Note above the software tree.
6. Locate License Manager in the Software directory:
Software > Software and Tools > Emulators Browsers and Tools > License
Manager > Current.
7. Select Download. Follow the prompts to download the application.
8. Refer to the License Manager online help for information on working with
licenses.

4 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About BasicTE and Network Pro cols
BasicTE applications use the following network protocol options. For network
configuration options, refer to your mobile device user manual.

Protocol Description
TCP/IP The mobile device running BasicTE communicates through access points
directly connected to the host mobile device.

Install BasicTE on Your Mobile Device

The BasicTE application for Android devices is part of Software Client Pack (SCP)
and Device Client Pack CDCP)

The DCP/SCP bundle installs three applications on the mobile device: the BasicTE
application, Enterprise Browser, and Honeywell Launcher. If DCP/SCP did not
come preinstalled on the mobile device, you can download the software bundle
from www.honeywellaidc.com.

For a list of prerequisites for each device, refer to the software release notes.

Note: Before attempting to download and install software, see "Supported Mobile
Devices" and "About Basic TE Licensing".

Note: The mobile device must have power for the entire length of the installation process or
it could become unstable. Do not attempt to remove the battery during the process.

To Download DCP/SCP

1. Go to www.honeywellaidc.com.
2. Select Resources > Downloads > Software.
3. Click on the Technical Support Downloads Portal link,
https://hsmftp.honeywell.com. Note that you will need to create an account to
download any Honeywell software.
4. Create an account if you do not already have one. You must login to download
the software.
5. Install the Honeywell Download Manager tool on your PC. The manager is
required to download software.
6. Select particular device in hsmsftp to download the DCP/SCP Package.
7. Select the DCP/SCP software bundle for your device.
8. Select Download and follow the prompts to download the application.

5
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 To Install DCP/SCP

1. Copy the .zip file from your PC to the

\Internal Storage\honeywell\autolnstall folder on the mobile device.
2. Touch All Apps > AutoInstall.
• Verify Enable Autolnstall has a check mark in the box.
3. Touch Verify Apps.
• Verify Verify Apps has a check mark in the box.
4. Click on Packages upgrade.

Optional Installation Method

1. Copy the .zip file from your PC to the

\Internal Storage\honeywell\autoinstall folder on the mobile device.
2. Touch All Apps > Autolnstall.
• Verify Enable Autolnstall has a check mark in the box.
3. Touch Packages upgrade. The mobile device automatically initiates a reboot
and installs the software.

6 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Launch BasicTE
You can start BasicTE manually or you can use the Configure Autorun Power tool to
set BasicTE to automatically launch when you power on the mobile device.

Note: If the Basic TE application is within a 60-day demo period, a demo mode message box
appears when you launch the application. The message displays the days remaining
on the demo license. Select OK to dismiss the message and use the application. To
learn more about application licensing, see "About Basic TE Licensing· on page 2.

To Start BasicTE Manually

• Touch All Apps > Terminal Emulation.

After BasicTE initializes, the main screen appears.

Touch IIto access

additio= menu options. • • • • • • •

Touch(:!;=:) to access the

Soft Input Panel (SIP).

BasicTE Main Screen

During BasicTE working sessions, useful status information appears at the top and
bottom of the screen. To learn more, see "About Status Indicators· on page 10.

Note: By default, Basic TE screens show white text on a black background. The content and
options in each screen depend on the installed hardware options in your mobile
device.

7
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Note: Always Turn ON the Provisioning mode to allow the application to have extra
privileges (Provisioning mode option is available under Honeywell Settings in
Settings.)

You can also whitelist the Basic TE application providing the package name of
Basic TE in DeviceConfig.xml file as mentioned below.

1'.1 b ( •. U 1 fl,AM

t- EZConfig Editor :
•
t,,;,I ...., ..... , _,.
KcyWakeUp
@ Bat1ery LEO
@HXLogger
H1deProv,s1onerTasksUI
@ Touch panel
@ Bug reporter
e Prov1s1on,ng Mode
Prov1s1on mode
Provision password
Prov1s1on wh1tel1st
Key

Value com.honeywell.oidc.cp.ETE

De0t.. Comma separated list of packages that

always have access to Honeywell

Provisioning Whitelist BasicTE

If you do not, the Basic TE application will close with a dialog prompt "Basic TE App is
not whitelisted''.

8 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About Configure Autorun
The Configure Autorun app is used to specify the applications you want
automatically launched after a mobile device reboot. Applications that can be set
to run automatically are listed on either the Normal screen or the Autorun screen.
You can toggle between the two screens by selecting the heading. The heading that
the app appears under indicates if it has been set to automatically run after a
reboot. If an application is set to auto-run, it is moved from the Normal screen to
the Autorun screen.
To auto-start BasicTE using Configure Autorun

1. Touch All Apps e > Power Tools b > EZConfig

2. Select Configure Autorun IJ.
3. Select Normal if it is not already selected.
4. Touch and hold Terminal Emulator.
5. Select OK to confirm. The app now appears on the Autorun tab instead of the
Normal tab.

Close BasicTE
When BasicTE is running, you can touch the three dots II in the upper right
corner of the screen, and then select Logout to close the application.

Note: By default, Basic TE requires a password to exit the application. The default password
is cr52401. To customize the exit password or change the application exit behavior,
see "Configure the Basic TE Exit Password" on page 22.

9
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About Status Indicators
The status bar at the top of the screen provides information relevant to the
operating system and mobile device hardware such as the battery charge level,
network connection type and network signal strength. To learn more about the
status icons and their meaning, see the user manual for your specific mobile
device model .
When Basic TE is running, the Toolbar located at the top of the screen and the
status bar located at the bottom of the screen provide real time feedback on the
connection status and access to additional options.
--- OS Status Bar
----i__ Basic TE Toolbar

--- Basic TE Status Bar

BasicTE Main Screen

About the Toolbar

The BasicTE Toolbar provides access to the following:
• Terminal IP Address or Device IP Address
If no session is in process, "No Session" shows.

• SIP Icon I:�:)

Select to show/ hide the onscreen keyboard. To learn more, see "About the
Default Soft Input Panels" on page 66.

• Menu lconO
Select to access additional options and information about the software (e.g.,
About, SIP Options, Logout, Session Name Running). The content of the menu
changes depending on if a session is active and if the BasicTE application is
being managed through the Honeywell Launcher.

Device IP 192 168 43.249 11!!11 :

BasicTE Toolbar Sample

10 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Access the About Screen
You may need to know the BasicTE version if you are upgrading or if you need to
contact Product Support.

• Touch Don the BasicTE application screen, and then select About.

The BasicTE version is shown just below the program name. License information
also appears on the About screen (i.e., Feature, Status, Type, Version and Expiration
Date). To return to the main screen, touch the arrow next to the TE icon.

About the Connection St t s Bar

At the bottom of the BasicTE screen, the connection status of the current session
appears. When a session is running the following information is shown:
• Connection Status
This indicates the status of the connection between the mobile device and host
or server (i.e., Connected, Re-connecting, or No Sessions).
• IP Address
This is the IP Address of the host or server that the mobile device is trying to
connect to for the session.

BasicTE Connection Status Bar Sample

Note: When trying to reconnect, the connection icon flashes red and yellow.

11
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About BasicTE Applications
This section describes how to use the Basic Terminal Emulator application for your
particular mobile device.

For the BasicTE VT/ANSI application, BasicTE emulates VTl00, VT220, VT320,
VT340, or ANSI terminals.

For the BasicTE 5250 application, BasicTE emulates the IBM-5291-1 and
IBM-5292-2 mobile devices.

VT/ANSI Alert Sounds

In VT/ANSI emulation, alerts occur when the host sends down a bell character
(\x07). The default error sound is the critical.wav file located in
/Internal Storage/honeywell/ETE/Media. You can replace this file if you want to
play a different sound.

About 5 250 Applications

This section describes several features of the BasicTE 5250 emulation mode.

Special Function Keys

This section describes the special function keys.

AID-Generating Keys
AID-generating keys generate AID codes that go in the display data stream to the
host system. They alert the host system that the application server or controller
requires some action. BasicTE emulates all of the Al D-generating keys on a 5250
Display Station.

AID-Generating Keys

Key Description
Clear The system environment determines the results of this key. If the
mobile device is in session, [CLEAR) issues the AID code hex BD, which
requests the host system issue a Clear Unit command to the mobile
device to clear the display. If not in session, [CLEAR) clears the entire
display regeneration buffer.
Enter/Rec Adv Enters information.
Fl-F24 User-defined command functions. Refer to your application's user
manual for details on the functions.
Help (non-error state) Issues a hex F3 Al D byte to the host system.
Roll Up and Roll Down Roll display up or down one page. Roll Up issues Al D code hex F5. Roll
Down issues AID code hex F4.

12 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Editing Keys
Editing keys have functions assigned to them by the application software in use.
Editing keys are Find, Insert, Next Screen, Previous Screen, Remove, and Select.
See Appendix B.

Field Exit Key

Field Exit exits an input field and moves the cursor to the beginning of the next
input field. If you press this key while the cursor is between characters, all
characters in the field to the right of the cursor are erased.

Signal Keys
Signal keys cause a Signal command to go from the controller to the host system.

Signal Keys

Key Description
Attention Press this key to alert the host system that the function request is not
honored. Attention is valid when the keyboard is locked or unlocked. It
does not change the keyboard state or the cursor location.

Special Control Keys

Use special control keys to change operator-generated information in the display.
These keys do not work when the keyboard is locked.

Special Control Keys

Key Description
Clear The system environment determines the results of this key. If the
mobile device is in session, [CLEAR] issues the AID code hex BD. which
requests the host system issue a Clear Unit command to the mobile
device to clear the display. If not in session, [CLEAR] clears the entire
display regeneration buffer.

Delete Deletes the character in the position where the cursor was located.

Erase Input Clears all fields to nulls, and cursor moves to the first input position on
screen. This command does not erase protected fields. If you press this
key when the screen shows only protected fields, the cursor returns to
the home position.
Error Reset Restores the original data on the error line of the display and resets the
state.
Hex Enters hexadecimal codes from the keypad to generate EBCDIC
characters needed for input or display.
Home Moves the cursor to the position specified by the insert cursor (IC)
address.
Insert Sets or turns off the insert mode for the input field the operator has the
cursor in. The operator must reset the insert state before exiting it by
either pressing Reset or Insert again.

13
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Special Host Key
The special 5250 host key is System Request.

Special Host Keys

Key Description
System Request Data on the error line is saved, the error line is cleared, a column
separator and underscore field attribute are supplied to column 1 of
the error line, and the cursor is located under column 2 to begin polling
keystrokes.

Additional Functions
This table lists additional operations you can perform on your mobile device. About

5250 Additional Functions

Key Description
.J (New Line) Moves the cursor to the first unprotected character position of the first
line in the screen. If the screen is a protected field, the cursor returns to
the home position.

Dup (duplicate enabled Controller repeats hex "lC" from the cursor position to the end of the
fields only) field (appears as an overstruck asterisk).

Field- Advances cursor to the previous input field. For numeric fields, makes
the input a negative number.
Field+ Advances cursor to the next input field. For numeric fields, makes the
input a positive number.
Field Mark This is valid within any unprotected entry input field in which the Dup or
Field Mark key is allowed (FFW bit 3 set to on). The Field Mark character
(X • lE') is displayed as an overscore on I BM 5251 Display Stations and
as a space on all other supported workstations. If an operator presses
the Field Mark key in an entry field that does not allow the Dup or Field
Mark key, operator error 0019 is posted. The Field Mark code point is
allowed in an outbound data stream.

Forward Tab Moves the cursor to the first position in the next input field.

14 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 VT/ANSI Applications
This section describes several features of VT/ANSI mode.

Main Keypad
The VT/ANSI main keypad consists of standard keys and function keys. Standard
keys generate letters, numbers, and symbols. Function keys generate special
function codes. The following table describes the keys.
VT/ANSI Main Keyboard

Key Description
Delete Operation depends on how the DEL to BS option is set in the TE
configuration menus. The key either sends a delete (DEL. 7 F
hexadecimal) or a backspace CBS. 08 hexadecimal).
Enter Sends either a CR character COD hexadecimal) or a CR character COD
hexadecimal) and an LF character (OA hexadecimal), depending on the
set or reset state of line feed or new line mode (LNM).
Shift Used with other standard keys to send uppercase characters.
Space bar Sends an SP character (20 hexadecimal).
Tab Sends a horizontal tab (HT) character (09 hexadecimal).

Compose character Not supported.

VT/ANSI Editing Keypad

The editing keypad has editing keys and cursor (arrow) keys.

Editing Keys
Editing keys have functions assigned to them by the application software in use.
Editing keys are Find, Insert, Next Screen, Previous Screen, Remove, and Select.
See Appendix B.

VT/ANSI Function Keys

VT220/320/340 mobile devices support function keys [Fl]to [F20]. Keys [Fl] to
[F4] are used for hold screen, print screen, set-up, data/talk, and break. For VT220/
320/340, [Fl] to [F4] are PFl to PF4.

Function Key Mapping

Function Keys [Fl] to [F20] can be remapped. See Key Mapping Functionality in TE
on page 28.

15
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Transmission Mode
You can toggle from Character mode to Block mode by sending the 10h command
from the server to the device. For more information see Block Mode on page 44.

Local Edit Mode

If your application software program supports local editing, you can use the mobile
device in Local Edit Mode, a feat ure of the VT330/ VT340 mobile device.

16 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 CONFIGURE AND MANAGE BASICTE

This chapter explains how to configure the Basic Terminal Emulator application by
editing the te_settings.xml configuration file on the mobile device.
The chapter includes these sections:
• Configure BasicTE with EZConfig
• Configure General Application Settings
• Configure Options for Each Session
• Block Mode
• Use the SnapShot Feature

17
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure BasicTE with EZConfig
Configure the BasicTE application for your handheld mobile device by modifying
the te_settings.xml file that resides in the
\lnternalStorage\Honeywell\EZconfig\generated folder on the device.
The xml file will be generated only when user clicks on generate option in the
device EZConfig.
You can customize the settings in the file using one of the following methods:
• Open and edit the file directly on the mobile device using the standard editor
that is part of the EZConfig Power Tool application.
• Copy the .xml file to a desktop mobile device, modify it with the optional
advanced EZConfig Editor, and then transfer the file back to the device.
• Configure BasicTE using Enterprise Provisioner tool (EP). Refer to Enterprise
Provisioner (EP) section for more information.

Note: The standard editor is a feature of the EZConfig Power Tool application included on
the mobile device. The advanced EZConfig editor is part of the optional EZConfig for
Mobility software suite that is available for download from www.honeywellaidc.com.
This manual explains editing the .xml file using the standard editor provided on the
mobile device. To learn more about the advanced EZConfig editor, see the Dolphin
Power Tools Versions 4.x User Guide for devices powered by Android, available for
download at www.honeywellaidc.com.

Enterprise Provisioner (EP)

Enterprise Provisioner (EP) is a Windows software application to create
provisioning tasks for Honeywell Android devices.

The Provisioning includes:

• Device settings
• OS updates
• Installing files (APK, Licenses etc)
• Run an application
• File operations on the device
• Create file/directory
• Rename file/directory
• Copy file/directory
• Delete file/directory
• Delete directory content
• Wait for network, reboot, intent
• Reboot the device
• Delay provisioning for X number of milliseconds

18 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Once the settings have been changed and provisioning tasks have been defined,
you can generate 2D barcodes that a device can scan to be provisioned. The
application has a built-in HTTP server for transferring files to devices. The
application barcode also supports remote file servers such as Staging Hub.

Download Enterprise Provisioner

To download Enterprise Provisioner

1. Go to the Honeywell software download website at

https://hsmftp.honeywell.com.
2. Sign in or create an account if you don't already have one.

Note: You need to download and install the Download Manager. Click on the link and follow
the screen prompts.
3. Locate the Enterprise Provisioner software in the directory and download.

Install Enterprise Provisioner

To install the software, run the EP_installer.msi file that was downloaded.

Start Enterprise Provisioner

Start Enterprise Provisioner by clicking the desktop shortcut that was created
during installation or from the Start menu:
• Click on Start> Honeywell > Enterprise Provisioner.
• If you are using the Staging Hub Foundation, you can start Enterprise
Provisioner directly from the Staging Hub Console: Click on Tools> Start
Enterprise Provisioner.

Honeywell Device Provisioning Using Enterprise Provisioner

Select the Settings/Provisioning/Barcodes package on the top of the screen, then
use the tabs on the screen to change menus and create tasks for the device

-
selected.

rill'
l'tt(ttt-mn ..,.. ,.__1 -
�.,.

C"J;...."t

Enterprise Provisioner Interface

19
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 To configure TE from EP, the user should generate barcode with default values,
which should be a complete file.
Note: Use the zoom option to make everything on a page larger or smaller. To make
everything on the page larger, hold Ctrl and push the mouse wheel up (forward). To
make everything on the page smaller, hold Ctrl and push the mouse wheel down
(backward).

How to Edit the XML File

You only need to open and edit the te_settings.xml file in EZConfig if you want to
change the BasicTE application default configuration.
Open the XIVIL File

1. Touch All Apps 8 > Power Tools O > EZConfig

2. Touch el next to "EZConfig".

3. Select Editor.
4. Touch OPEN XML> ezconfig > generated.
5. Touch te_settings.xml to open the file for editing.
Edit the XIVIL File

1. Touch the+ icon to expand the sections and locate the key you want to edit.
2. Select the key from the section tree, and then touch inside one of the fields
(e.g., Key, Value, or Desc) to edit the information. A selected field is underlined in
green. If a field is shaded in gray, the text cannot be edited.
3. Edit the text. If you want to close the onscreen keyboard and edit another field,
press the Back button, and then select the other field.

4. Press IIand then select Save. Saving does not apply the changes to the
application.

5. Touch IIagain and then select Update Configure. If prompted, reboot the
mobile device to apply the changes.

Generate a XML File

Generate a new copy with the Generator feature in the EZConfig Power Tool app.
To Generate a Copy

1. Open EZConfig.

2. Touch ea next to "EZConfig".

20 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 3. Select Generator. A new te_settings.xml file is automatically created and saved
in the \Internal Storage\honeywell\EZConfig\generated folder.

Note: Once user modifies the Default settings, TE will always generate xml file with
modified values, and not the default values.

Configure Multiple Devices Using Configuration Barcodes

Once your first device is configured, you can generate configuration barcodes and
use them to configure other devices with the same settings.

To Create a Configuration Barcode

1. Modify te_settings.xml file using EZConfig Editor (as described above) in the
first device and save the file.
2. Copy .xml file from /device/Internal Storage/honeywell/EZConfig/
generated folder to a local PC.
3. Open the file with EZConfig Editor and generate the barcodes by clicking on the

Generate Barcode �l icon.

4. Print the barcodes and scan them with the other devices to apply the same
configuration.
When the barcode is scanned, EZConfig creates the te_settings.XM L file located at
the /Internal Storage/honeywelVpersist folder in the device. When the
application restarts, BasicTE will read the configuration file from persist folder.

21
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure General Application Settings
Once the te_settings.xml is open in the Editor, expand the General section by
selecting the plus sign(+) to view the application settings.
0 General
Enable Exit Password
Allow Instant Exit
Full Screen Mode
Exit Password
Hardware Escape Key Configuration
OnentatJon General Application Settings
Pan via Touch Panel
Focus via Touch Panel
Zooming Via Touch Panel
Wireless Pnntmg
Data Editor Plugin
Screen Wake
Key Mapping
BasicTE General Settings

Configure the BasicTE Exit Password

By default, you must use a password(cr524O1) to exit the BasicTE application, but
you can set the exit behavior to one of the following options:
• Require a custom password to exit.
• Request confirmation to exit with no password required.
• Exit without requiring a password or a request to confirm exit.

Note: If both the Exit Password and Instant Exit settings are enabled, the Exit Password
value takes priority. If both the Exit Password and Instant Exit settings are disabled,
the application prompts to confirm exit.
To Enable an Exit Password or Request to Confirm Exit

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch TerminalEmulator and then General to expand the sections.
3. Select Enable Exit Password.
4. Edit the Value field:
• If the value is set to False, the application requests confirmation before
exiting the application. No password is required.
• If the value is set to True, the application prompts the user for a password
before exiting the application.

22 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 5. Touch II and then select Save.
6. Touch II again and then select Update Configure.

To Change the Default Exit Password

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch TerminalEmulator and then General to expand the sections.
3. Select Exit Password.
4. Enter a string of up to 10 characters for the exit password. The default is
cr524O1.

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

To Enable an Instant Exit with No Password or Confirmation Request

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch TerminalEmulator and then General to expand the sections.
3. Select Allow Instant Exit.
4. Type False in the Value field.

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Configure Hardware Escape Key

If you press the 'Esc' hardware key, Escape keycode (lb) followed by the Navigation
bar on any physical hardware keypad supported devices, the back key functionality
will be triggered on the application.

You can modify the Hardware Escape Key functionality as mentioned below:
• 0 = Escape followed by Back as per OS functionality
• 1 = Only Escape

23
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure the Orientation
By default the screen orientation automatically switches between landscape and
portrait mode if the mobile device is physically rotated. You can change the default
screen orientation behavior by editing the te_settings.xml file.

To Change the Default Screen Mode (Orientation) in BasicT E

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch TerminalEmulator and then General to expand the sections.
3. Select Orientation.
4. Type 0, 1, 2, 3, or 4 in the Value field.

5. When you are finished making changes, touch II and then select Save.
6. Touch II again and then select Update Configure.
For more information on these values, see the next table.

Orientation Values

Value Descriptions
0 Default value.
Automatically switches between Landscape mode and Portrait mode depending on how
the mobile device is rotated. Any other value excluding 1, 2, 3, or 4 is considered to be the
same as the default value.
1 Landscape Left
When the key value is set to 1, BasicTE opens in Landscape Left mode. Rotating the
mobile device does not change the orientation.
2 Landscape Right
When the key value is set to 2, BasicTE opens in Landscape Right mode. Rotating the
device does not change the orientation.
3 Portrait
When the key value is set to 3, BasicTE opens in Portrait mode. Rotating the device does
not change the orientation.
4 Landscape Sensor
Automatically switches between Landscape Right and Landscape Left depending on how
the mobile device is rotated.

Pan the BasicTE Viewoort by Touching the Screen

Depending on the number of rows and columns configured in te_settings.xml file,
you may need to pan the screen to scroll through all the information. Simply drag
your finger across the screen or use a vertical or horizontal swiping motion.
Pan via Touch Panel is enabled by default and applies to all sessions when enabled.
You can enable or disable this feature by modifying the te_settings.xml file.

24 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 To Disable Pan via Touch Panel

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Pan via Touch Panel.
4. Edit the value to set the mode:
• 0 = Disabled.
• 1 = Viewport Mode (default). The screen moves in the same direction you
drag or swipe on the touch panel.

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Move the Cursor Location by To

You can enable the Focus via Touch Panel feature, which moves the cursor to any
entry field when you touch the mobile device screen at the field location.

Focus via Touch Panel is disabled by default and applies to all sessions when
enabled. You can enable or disable this feature by modifying the te_settings.xml
file.

Note: If you enable this feature when using VT-ANSI emulation, the entire screen is defined
as a field.

To Enable Focus via Touch Panel

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Focus via Touch Panel.
4. Edit the value to set the mode:
• 0 = Disabled (default). Screen taps are ignored.
• 1 =Enabled.The entire screen is treated as a field and the cursor should
move in response to a tap.

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

25
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Zoom In or Out on the Screen with a Pinchina Gesture
You can zoom in or out on the BasicTE screen by making a pinching gesture. Place
two fingers close together on the screen, drag them apart to zoom in, and then
drag them back together to zoom out. Zooming in decreases the total number of
rows and columns displayed on the screen but increases the font size for easier
viewing.

Zooming via Touch Panel is enabled by default and applies to all sessions. You can
enable or disable this feature by modifying the te_settings.xml file.
To Disable Zooming via Touch Panel

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Zooming via Touch Panel.
4. Edit the value to set the mode:
• 0 =Disabled.Screen taps are ignored.
• 1 =Enabled (default). The entire screen is treated as a field and the cursor
should move in response to a tap.

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Configure Full Screen Mode

This setting enables or disables the Full Screen Mode.

To Configure Full Screen Mode

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Configure Full Screen Mode.
4. Edit the value to set the mode:
• True= Enable. When enabled, application will launch in Full Screen Mode
and OS status bar will hide automatically.
• False=Disable (default).

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

26 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Wireless Printing
You can enable Bluetooth (Wireless) Printing in BasicTE application.

To Configure Wireless Printing

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Configure Wireless Printing.
4. Edit the value to set the mode:
• True= Enable. Allows to send printing commands via Bluetooth.
• False= Disable (default).

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Note: Currently, printing support is available only in ANSI emulation, both Line mode and
Screen mode.

Enable Barcode Data Editor Plugin in TE

Data Editor Plug in option will allow user to add the plugin in order to modify the
barcode scan data. Data Editor Plugin is a configurable option. If the user wants to
configure Data Editor Plugin, the user should define 'AppPackageName/
PluginClassName' in the value field.

Example: AppName: ScanResultReceiver

PackageName: com.sample.scanresultreceiver
Classname: DataEditingPlugin

You need to enter com.sample.scanresultreceiver/DataEditingPlugin in the

value field provided under the setting.

Screen Wake
When the user enables this option, the device screen will always wakeup when TE is
opened.

To Enable Screen Wake

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.

27
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 3. Touch Screen Wake
4. Edit the value to set the mode:
• True= Enable (default)
• False = Disable

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Key Mapping Functionality in TE

If you enable Key Mapping functionality in TE, it will read CustomKeyboard.xml file
from \Internal Storage\h oneywell\ETE\KB folder, so that mapped key values will
be sent from TE.
To Enable Key Mapping Functionality

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch General.
3. Touch Key Mapping.
4. Edit the value to set the mode:
• True = Enable
• False= Disable (default)

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

Redefine Function Key Mapping

Keys can be remapped using the name (i.e. Escape) with ASCII Code (i.e. 27) or with
Hex Code (i.e. \xlb). When using Hex Code, the value should be entered inside
curly brackets ( {\xlb} ). For multiple key events, the value should be in square
brackets separated by a comma ( [Fl, Enter]).

28 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure Options for Each Session
You can configure a set of options for each of the four sessions by modifying the
key values in the session section. For example, you can assign each session a
custom host name or friendly name.
To Configure Options for Each Session

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Select Session 1, Session 2, Session 3, or Session 4.

.
3. Continue to expand the sections under the session until you find the Key you
want to modify.
. ,, ,.
� EZConflg Editor :

8 Session 1
0 TCP/IP Options
8 Host A
0 SSH Options
SSH UserName
SSH Password
SSH Private Key
SSH Key Passphrase

Key

Deac Configure the Secure Shell (SSH)

options for the host.

Expanded Session Section in EZConfig

4. Touch a key to select it and change the value as needed.

5. When you are finished making changes, touch II and then select Save.
6. Touch II again and then select Update Configure.
For more information on these settings, see the next table.

TCP/IP Configuration Section Descriptions

Sections Description Values

TCP/IP Options Sets network options for TCP/IP connections.
For more information. see ·configure a TCP/IP
Connection" on page 15.
Protocol Options Sets options for VT/ANSI or 5250 protocols. For
more information. see "Configure Protocol
Options" on page 17.

29
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 TCP/IP Configuration Section Descriptions

Sections Description Values

LCD Parameters Sets BasicTE screen sizes and the screen cursor
behavior. For more information, see "Configure
BasicTE Screen Sizes and Cursor Behavior· on
page 22.

Display Options Sets BasicTE screen behavior (i.e., Prompt on

Reconnect). For more information, see "Set
BasicTE to Display a Prompt to Reconnect" on
page 21.

Session Name Sets the customizable host name (or friendly String of up to 11
name) for the session. characters.

Configure a TCP/IP Connection

You can configure TCP/IP settings for a single host (Host A) for each of up to four
different sessions.

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Select Session 1, Session 2, Session 3, or Session 4.
3. Touch TCP/IP Options.
4. Touch Host A. The list of configuration items for Host A appears.
• Host
• Emulation
• Port Number
• Protocol
5. Touch a key to select it and change the value as needed. You may need to
expand a section further to view all the relevant keys.

6. When you are finished making changes, touch II and then select Save.
7. Touch II again and then select Update Configure.

30 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 For more information on these settings, see the next table.

TCP/IP Configuration Options for Sessions

Section/Key Description Values

Host IP address of the application server. None

Emulation Select the type of terminal emulation: VT/ANSI VT/ANSI (Default)-1

or 5250. 5250=2

Port Number Selects the port number you want to use to make 0 to 65535.
a connection to the host mobile device. Default is 23.

Protocol Defines the security protocol to use for data Telnet (Default)-0
communication. SSH=l

Configure BasicTE for SSH

When using an SSH connection, you can edit the te_settings.xml file to include the
necessary user name and security inputs (e.g., password, private key) required by
the host for the connection.

Note: If you do not configure a user name and password in the te_settings.xml file, an SSH
Login Page screen appears requiring you to manually enter a user name and
password. If you configure a user name but not a password, only the password field
on the SSH Login Page that appears is editable.

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Select Session 1, Session 2, Session 3, or Session 4.
3. Touch TCP/IP Options.
4. Touch Host A.
5. Touch SSH Options .
• I 1;' 14

+- EZConf1g Editor :

9 �s,on 1
TCP/IP Opto0111
9 Host A
6 SSH Options
SSH UserName
SSH Pas1w0<d
SSH Pl'lvate Key
SSH Key PasSJ)hras@

Confogu,e lhe Secure Sl1ell (SSH)

O!J1ions fo, tht hosl.

SSH Options Expanded in EZConfig

6. Touch a key to select it and change the value as needed. You may need to
expand a section further to view all the relevant keys.

31
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 7. When you are finished making changes, touch II and then select Save.
8. Touch II again and then select Update Configure.
For more information on these settings, see the next table.

SSH Option Descriptions

Key Description Values

SSH UserName Stored username you are prompted to enter 0 to 80 characters.
when you choose to connect to Port 22 (SSH) Default is a null string.
instead of Port 23 (Telnet).
SSH Password Stored password you are prompted to enter 0 to 80 characters.
when you choose to connect to Port 22 (SSH) Default is a null string.
instead of Port 23 (Telnet).
SSH Private Key Key file SSH uses for private key authentication. 0 to 80 characters.
Specify the relative path from Default is a null string.
\Internal Storage\honeywell\ETE\SSH\, or
prefix the absolute path with \.
SSH Key Passphrase Passphrase required to access the SSH Private 0 to 80 characters.
Key file. If blank, BasicTE assumes no Default is a null string.
passphrase was configured.

32 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure Protocol Options
You can set protocol options for each of up to four different sessions.

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4.
3. Touch Protocol Options.
4. Select VT-ANSI or 5250. See protocol options below.
e ,_ b
• Q 111

f- EZConf,g Edrtor :

0 session 1
Sessum Name1
8 TCP IP Opt,ons
Host A
0 Protocol Options
0 VTANSI
TemunalTypel
Answe<Sackl
local fchol
.Qu&o Advance 1
Autn Tnu,11tmn1

OH<

Protocol Options Expanded in EZConfig

5. Change the values as needed.

6. When you are finished making changes, touch II and then select Save.
7. Touch II again and then select Update Configure.
VT-ANSI Protocol Options

Option Description Values

Term Type Enables user to enter a character string that will Default value will be
be sent to the Host as a part of Term Type Host empty.
Parameter.
This is the client type string that determines the
specific client to emulate.
The user can configure VT200, VT52, VTlOO,
VT340. and ANSI as terminal types. Each host
emulation type has its own default type.
If nothing is configured, xterm will be sent.
Answer Back When enabled, the mobile device sends the Range is Oto 30
specified character string to the host in response characters.
to an inquiry (hexadecimal 05). When ENO is Default is the Mobile
sent. only the first thirty characters of the name device model+ Serial
are transmitted back to the host. number.
For more information, see About the Answerback
Character String.

33
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 VT-ANSI Protocol Options

Option Description Values

Local Echo When enabled, local echo displays characters On or Off.
from terminal memory but not from host Default is Off.
memory.
Auto Advance When scanning barcodes, the cursor moves l= Enable
automatically to the next unprotected field, even 0= Disable (default)
if the first input field is not completely filled. If
the cursor is on the last input field and a barcode
is scanned, it is filled and the cursor moves to the
next unprotected field.
Note: Block mode must also be enabled to use
this option.
Auto Transmit When scanning barcodes, the entire screen is l= Enable
sent to the host after the user exits the last field 0= Disable (default)
on the screen. If the final cursor movement was a
backspace or back tab, the data is not sent to the
host. If the final cursor movement was pressing a
key or scanning a barcode, then it will be sent to
the host. The data sent depends on GATM,
MATM, and SATM settings.
Note: Block mode must also be enabled to use
this option.

Backspace In Interactive mode (Character mode), 0= Backspace

Configuration Backspace/Delete will be sent to the seNer. In l= Delete
Edit mode (Block mode), it will be handled
locally.

5250 Protocol Options

Option Description Values

Enable Colors Enable or disable colors in 5250 Emulation. Enable= l
Disable=O (default)
Lock Error Message When enabled, a 5250 Write Error Code Enable=l
command error message is visible by placing the Disable=O (default)
cursor on the error message line. When the
RESET key is pressed, the cursor is restored to
where it would have been if this option was not
enabled (the location specified by a 5250 Insert
Cursor command) and the cursor mode option
then causes that area of the screen to be visible.
When disabled, behavior for the 5250 Write Error
Code command error message is normal.
Destructive BS Enable or disable Destructive BS. Enable=l
Disable=O (default)
Device Name Enables user to get configured Device Name None
string in response to the host. Range is 1 to 30
characters.
Field Exit on Scan Enables to perform Field Exit automatically if True= Enable
field is being exited due to barcode scan. False= Disable
(default)

34 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 5250 Protocol Options

Option Description Values

Auto Enter on Scan Enables to perform Enter automatically when True= Enable
barcode scanned in last field. False= Disable
(default)
Auto Tab on Scan Enables to perform a Tab automatically when True= Enable
barcode scanned in field. False= Disable
(default)
Stream on Scan Enables to scan Stream Scan to multiple field. True = Enable
False= Disable
(default)
Scan Length Error Enables sound and error message in Scan True = Enable
Length Error. False= Disable
(default)

About the Answerback Character String

Enable Answerback to send a character string to the host in response to an inquiry
(hexadecimal 05). The string can be Oto 30 characters long and possibly longer if
you use wildcards as described in this section. Default is the mobile device serial
number.

Note: Although the string can be longer than 30 characters, only the first thirty characters
of the name are transmitted back to the host when ENQ is sent.
Use the SIP to enter the character string. If you enter any of the following control
characters, it is sent out. Control strings count as one character.

7-Bit Commands

Use To Get
<BS> Backspace
When received by the mobile device from the host. the cursor position moves to
the left of the current cursor position.
When received by the Host from the mobile device. the character in front of the
cursor is deleted and the cursor is moved into the vacant position.

<HT> Horizontal Tab

Moves the cursor to the next predetermined position (tab stop) to the right.

<LF> Line Feed

Moves the cursor down one line.

<VT> Vertical Tab

Moves the cursor down one line unless the cursor is outside the scrolling region
when the Vertical Tab character is received. The cursor does not move past the
bottom of the virtual screen.
<FF> Form Feed
This control character is processed as a line feed in the TE client and advances
the cursor down one line.
<CR> Carriage Return
Returns the cursor to the left margin of the row where the cursor is positioned.

35
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 8-Bit Commands

Use To Get
EPA End Protected Area
Ends the protected area in page memory that cannot be edited when forms are
created from the host.
SPA Start of Protected Area
Starts the protected area in page memory that cannot be edited when forms are
created from the host.

Note: The default answerback string is %Sx. If the answerback string is empty in the
te_settings.xml file, the mobile device should respond with the serial number when
the host sends an ENO.
To configure an Answerback string that includes mobile device-specific
information, use wildcard characters in the string. For more information on
wildcard characters, see the next table.

Wildcard Characters for Answerback

Use To Get
%Mx Entire Mac address of the device in capital
letters.
0/omx Entire Mac address of the device in lower case
letters.
%M1-%M2-%M3-%M4-%M5-%M6 1st through 6th part of MAC address in capital
letters.
%m1-%m2-%m3-%m4-%m5-%m6 1st through 6th part of MAC address in lower
case letters.
%MO-%M7 Out of boundary values test. The mobile device
receives the same string: %MO-%M7.
%m0-%m1:%M6-%M8 Mixed value test. The mobile device receives
xx-xx:xx-%M8 where xx refers to the
corresponding values of the Mac Address.
%Ix Entire IP address.
%ix Entire IP address.
%11.%12.%13.%14 1st through 4th octet of IP address.
%i1.%i2.%i3.%i4 1st through 4th octet of IP address.
%10:%i7 Out of boundary values test. The mobile device
receives the same string: %10:%i7.
%i0-%i 1:%13-%15 Mixed value test. The mobile device receives
O/oiO-xx:xx-%15, where xx refers to the
corresponding values of the IP Address.
%14. 4th octet of IP address.
%Sx Entire serial number of the mobile device in
capital letters.
0/osx Entire serial number of the mobile device in
lower case letters.

36 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Wildcard Characters for Answerback

Use To Get
o/osl 0/os20/os3°/os4o/os5o/os6o/os7°/os8°/os9o/o Entire Mac address of the device in lower case
sao/osb0/osco/osdo/ose letters.

o/oS1 °/oS2o/oS3o/oS4°/oS5o/oS6o/oS7°/oS8o/oS9o/o Entire serial number of the device in capital

Sao/oSbo/oSc0/oSdo/oSe letters.

%SA%SB%SC%SD%SE Out of boundary values test. The mobile device

receives the same string: %Ss:%sS.

%Serial ID:%s7%S8%s9%Sa Mixed value test. The mobile device receives

%Serial ID:XXXXXXXXX, where xx refers to the
serial number.

ID:%s0%sl%s2%s3%s4%s5%s6%s7%s8°/os The mobile device receives the entire serial

9 number, MAC Address. and IP Address.
MAC:%ml-%m2-%m3-%m4-%m5-%m6 ID:xxxxMAC:xxxxlP:xxxx
IP:%il.%i2.%i3.%i4

%Wildcard%s Invalid string test. The mobile device receives the

same value: %Wildcard%s.

Configure BasicTE Screen Sizes and Cursor Behavior

You can set the BasicTE screen size and cursor behavior for each of the four
available sessions.

To Configure Screen Size and Cursor Behavior

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4. T he list of configuration
items for that session appears.
3. Touch LCD Parameters .
•I 10 JO

� EZConflg Edrtor :

Session 1
® TCP/IP Options
Protocol Options
LCD Parameters
Screen Rows
Screen Columns
Screen Mode
Display Options

Key

V luo

o, Configures the liquid crystal display

(LCD) parameters.

LCD Parameters Expanded in EZConfig

37
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 4. Touch a key to select it and change the value as needed.

5. When you are finished making changes, touch II and then select Save.
6. Touch II again and then select Update Configure.
For more information on these settings, see next table.

LCD Parameters Settings

Key Description Values

Screen Rows Number of rows that appear on the screen. The 1 to 24
default value of 10 is used if the value Default Value is 10.
configured is less than 1 or exceeds 24.
Screen Columns Number of columns that appear on the screen. l to 80
The default value is used if the value configured Default Value is 20.
is less than l or exceeds 80.
Screen Mode Configures how the cursor positions itself on the Center Cursor• 0
display. Corner Mode (default) = 1
The default value is used if the value configured Page Mode = 2
exceeds 3. Lazy Mode - 3
For more information, see "About Screen Mode"
on page 38.

Key Uppercase When enabled, letters will display on CAPS LOCK True= Enable
(Uppercase). False= Disable (default)

About Screen Mode

Screen Mode defines the cursor position and movement as you scroll through data
in the display buffer, which stores data in a standard CRT format as sent from the
host mobile device. Use Screen Mode options to optimize your view.

Screen Mode Option Descriptions

Option Description
Center Cursor Cursor remains in the center of the screen as you scroll through data. On
reaching a boundary of the full CRT screen, the cursor moves past the
center of the screen. When the cursor reaches the boundary of the CRT
screen, the cursor does not wrap to the next line in the display.

Corner Mode (default) Cursor remains in the lower-right corner of the screen as you scroll
through data, beginning at the upper-left corner of the full CRT screen.
Cursor remains there as data advances in the scrolled direction (up, down,
right, or left). On reaching a boundary of the full CRT screen, the display
and cursor move in the scrolled direction. Cursor stops moving when it
reaches the CRT screen boundary and does not wrap to the next line in the
display.
Use this option when your application uses only the upper-left corner of
the full CRT screen.

38 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Screen Mode Option Descriptions

Option Description
Page Mode Divides the full CRT screen into predefined "pages· and starts the mobile
device display on page 1. Cursor first appears in the upper right corner. As
you scroll. only the cursor moves and the data on the screen does not
appear to move. When you scroll off the edge of the displayed page, the
display snaps to the next (or previous) page. On reaching a boundary of
the CRT screen, the cursor stops moving.
Because the 24-row by BO-column CRT screen cannot be divided equally.
some pages in Page Mode overlap each other and the same information is
shown on both pages.
Lazy Mode Cursor starts in the upper left corner of the screen and moves across the
display in the scrolled direction. When the cursor goes beyond the edge of
the display, the data moves in the opposite direction to the cursor, which
remains at the edge of the display.

Set BasicTE to Display a Promot to Reconnect

You can configure BasicTE to display a "Connection Failed" message on the screen
if the connection between the host and application has been lost or the mobile
device goes out of Wi-Fi network range. Basic TE does not try to reconnect until you
manually initiate the action by touching RECONNECT in the message window.
Enabling this feature reduces network traffic.

When the feature is disabled, no reconnect prompt is initiated and the mobile
device continuously tries to reconnect with the host. A "Reconnecting" message
appears in the lower left corner of the screen.
The Prompt on Reconnect feature is disabled by default.

To Enable a Prompt Before Reconnecting to the Host

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4. The list of configuration
items for that session appears.
3. Touch Display Options.
4. Touch Prompt on Reconnect.

39
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 • I 10"

f- EZConflg Editor :

9 Session 1
@ TCP/IP Options
@ Protocol Options
@ LCD Parameters
0 Drsplay Optrons
Prompt on Reconnect
Session NarJ>e
Session 2

Va.ue

Dn, Confrguru the display options for

Enterprise Terminal Emula1or.

Display Options Expanded in EZConfig

5. Edit the value to change the setting:

• 0 = Disable (default).
• 1 =Enable.A message appears notifying you of a connection failure between
the mobile device and host. BasicTE does not try to reestablish a connection
with the host until you touch Reconnect on the screen.

6. Touch II and then select Save.

7. Touch II again and then select Update Configure.

40 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Barcode Settings
The mapping between messages and barcodes is called Symbology. There are 19
different barcode symbologies available in the EZConfig Editor, which includes:
• UPC-A
• UPC-E
• Standard 2 of 5
• Interleaved 2 of 5
• EAN-13
• EAN-8
• Code 93
• Code 39
• Code 128
• Code 11
• Codabar
• GS1128
• QRCode
• CodaBlock-A
• CodaBlock-F
• GridMatrix
• DataMatrix
• RSS
• Decoding

To Configure Barcode Symbology

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4. The list of configuration
items for that session appears.
3. Touch Barcode.

41
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 4. Select the barcode symbology from the list available and change the setting as
desired.

eb 0•1,,u,...,,1 !I b O • ■ ,-,O�At-'
<- EZConf,g Editor : f- EZConf,g Editor :

E)Barco<le @ Code 11
Decoding Code 128
@RSS Code39
@ OataMatnx @ Code93
GndMatnx @EAN-8
CodaBlock-F @EAN 13
CodaBlock-A Interleaved 2 of 5
QRCode St..ndard 2 of 5
GSl 128 UPC-E
Codabar UPC-A
CodP.11 Svmbolo011 Prefi,1
l\ey Key

ValU<!

Otte Oesc

Barcode Expanded in EZConfig

5. Touch II and then select Save.

6. Touch II again and then select Update Configure.

42 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Prefix and Suffix
A prefix or suffix can be appended to the scanned barcode data. By default, there is
no prefix or suffix (value is empty).

To set a Prefix and/or Suffix for a barcode

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4. The list of configuration
items for that session appears.
3. Touch Barcode.
e.; 0 -. ■':.'�AM
f- EZConf,g Editor :

COde 39
+ Code93
EANS
EAN 13
Interleaved 2 of 5
Standard 2 of 5
@UPCE
• UPC·A
Symbology Prefix1
Suffix1
Pref,x1

Value

Desc

Barcode Expanded in EZConfig

4. Select Prefix or Suffix and set the value. Range of characters is 00 to FF.

Symbology Prefix
The Symbology Prefix or AIM ID of barcode symbology.
To set a Prefix and/or Suffix for a barcode

1. Open te_settings.xml configuration file in the standard editor. For help, see
"Open the XML File" on page 20.
2. Touch Session 1, Session 2, Session 3, or Session 4. The list of configuration
items for that session appears.

43
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 3. Touch Barcode.
@! 6 0 • ■ t,0"4AM

f- EZConf,g Editor :

Cod<. 39
@ Code93
EAN-8
EAN-13
lntetlea,ed 2 of S
Standard 2 of S
UPC-E
UPC-A
Symbology PrefIX l
Suffixl
Pre(UJl

Barcode Expanded in EZConfig

4. Select Symbology Prefix and set the value.

• True = Enable
• False = Disable (default)

Block Mode
Block Mode enables the device to send an entire block of data to the host at one
time instead of sending each character. To enable Block Mode the server must
send the !Oh command to the device (Block Mode is not configured in
te_settings.xml file) and the device automatically switches to Block Mode.

Use the SnapShot Feature

You can use the SnapShot feature to take high-resolution pictures. For example,
you might use SnapShot to take a picture of damaged goods in a warehouse.

To Access the SnapShot Feature

1. Open the BasicTE app.

2. Touch the three dots II in the upper right corner.

3. Select SnapShot.
Once the SnapShot interface is opened, the camera turns on and the screen shows
streaming video. From this screen you can:

• Touch al to go back to the main TE screen.

44 Basic Terminal Emulation (TE)
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 • Take a picture by touching [£1 or pressing Enter.
• Upload a picture from your device to the host by touching IJ. See Upload a
SnapShot File for more info.

• Adjust the flash mode by touching II:

• IJ Flash ON

• II Flash AUTO
• II Flash OFF
Once you have taken a picture, you can:

• Discard the image by touching t3.

• Save the image by touching PJ.
• Add text by touching rJ.Text is limited to 40 characters. After typing your text,
touch OK. The text is added to the bottom of the image. To edit the text, touch
rJ again, edit the text, then click OK.
Upload a SnapShot File
To Send a SnapShot to the Host

1. Open the BasicTE app.

2. Touch the three dots II in the upper right corner and select SnapShot.
3. Touch IJ and select the check box for each image you want to send to the host.
4. Touch IJ to send the images.

On this screen you can also delete images from your device by touching El.
Note: Images uploaded to the host will be automatically deleted from your device.

At any time touch Ill to return to the previous screen.

45
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Configure SnapShot Setti
You can configure the following SnapShot settings:
• Local storage folder
• Image type
• File name
• Remove file name extension
• File name prefix
• Image upload method
• Image upload type
• Remote host options
• Add text options
To Configure SnapShot Settings

1. Open and edit the te_settings.xml file with EZConfig, see To configure TE from
EP, the user should generate barcode with default values, which should be a
complete file. on page 20.
2. Select SnapShot under General.

f- EZConfig Edrtor :

snll)St.01
Local rnage Folder
Image Type
snapshot File Narre
RemM Frie Na11e Exlenslon
Fie Name Prefx
Image Send !Jelhod
Image Upload Type
0 Remote Ho$1 Opt,ons
Remote Host
Remote Usemame
Remote Password
Rtmo•e lmagefo der
Add Text

SnapShot Expanded in EZConfig

3. Change the settings as needed. When you are finished, touch II and then
select Save.

4. Touch II again, and then select Update Configure.

46 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Setting Description
Local Image Folder Define the folder where you want to store images on your local device.
Default= lnternaVStorage/honeywelVETE/Pictures
You can change the name of the storage folder in te_settings.xml.
When you take pictures, the folder will be automatically created
(lnternaVStorage/honeywelVETE/XXXX).
Image Type Select JPEG or PNG.
Default= JPEG

SnapShot File Name Create a file name for SnapShot pictures.

Value is a string of Oto 100 characters.
Default= P_Serial Number_lP address_Timestamp
The following wildcards can be used:
%S First 11 characters of the serial number of the device.

%Sx Full serial number of the device.

%M Mac address of the device where the period(.) is changed to a

dash(-).

%1 IP address of the device, where the period(.) is change to an

underscore L).
%C Counter
%T Times tamp
The Times tamp is also part of the default file name. If it is not
included in the file name, it will be automatically added at the end of
the file name.

Remove File Name Enable or disable the ability to see the file extension.
Extension 0 = Extension on, 1 = Extension off.
Default= 0
File Name Prefix Define the file name prefix that will be appended as a prefix to the file
name. The prefix can be letter, numbers or special characters.
Default= Empty(no prefix)

Image Send Method 0 = Automatic: Image is directly uploaded to the host when you take
the picture.
l = Manual: Image is saved on the device and you must manually
upload the file(s) to the host.
Default= 0

Image Upload Type The image can be uploaded to an FTP site or a shared network.
0 = FTP network address.
l = Shared Network.
Default= 0

Remote Host Options For a remote host. add the following information:
Remote Host: FTP or Remote Host IP.
Remote Username: Remote Host User name.
Remote Password: Remote Host Password.
Remote Image Folder: Remote folder path where user wants to save
data.
If the server path is not valid an error will show.

Add Text Define if Add Text is mandatory or not. If mandatory, you must add
text before you can save an image.
0= Optional, l = Mandatory.
Default= 0

47
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 48 Basic Terminal Emulation (TE)
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 CUSTOMIZATION AND SECURITY

This chapter describes how you can initiate auto-login or use Honeywell Launcher
to manage BasicTE access. The chapter includes these sections:
• Use the Auto-Login Feature
• About Honeywell Launcher
• Honeywell Guidelines for BasicTE Security

49
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Use the Auto-Login Feature
Use the auto-login feature to send the same login information each time you log
into the host. When you start BasicTE, the computer checks for an auto-login script
file. If a script file exists, the computer runs the login commands from the auto­
login script file before BasicTE starts.
To use this feature, develop an auto-login script file and load it on the computer.
This section explains how to develop a script and includes a list of control
characters and the procedure for disabling auto-login.

Develop Auto-Login Script Files

A typical auto-login script file consists of a series of "WaitFor" and "Send"
commands.

Note: The auto-login script must be an ASCII text file. The file name is session specific and
should be in format: autologl.scr for Session 1, autolog2.scr for Session 2,
autolog3.scr for Session 3 and autolog4.scr for Session 4. You can also keep a single
file for all sessions with the name autolog.scr. If a session specific file is not found for
a single or multiple sessions, the autolog.scr file is used.

Commands for Auto-Login Seri t Files

You can use several commands to create auto-login script files. All commands are
case-sensitive. For example, WaitFor is a command, but Waitfor is not a valid
command. For examples of script files, see "Sample Auto-Login Script Files" on
page 52.

Waitfor
Wait for a list of up to ten strings. Strings must be enclosed in quotes and
separated by a comma.

Send
Sends a character string enclosed in quotes or a string variable to the host. The
character string enclosed in quotes can have an embedded control key in the
Basic TE application.

Use Auto-Login Search Strings

Conditions for auto-login search strings are as follows:
• Searches are case-sensitive.
• Each WaitFor command searches the entire screen from the top.

SO Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Use line wrapping to look for unique strings. If a screen from the host has multiples
of the word you are looking for, use the preceding spaces to identify a unique
string.

Example: If the screen sent to the computer is:

Linux rlogin 2.4.6
Login:
Password:

The autologin script would be:

WaitFor "Login:"#Wait for the login prompt.

Send "XXXXX"#Send the user name.
Send "<TAB>"#Send Tab to Host.
WaitFor "Password:"#Wait for the password prompt.
Send "XXXXX"#Send the password.
Send "<ENTER>"#Send Enter to Host.

Use Control Characters

To include control characters in your auto-login script file, all control characters
must be enclosed by< > (angle brackets).

VT/ANSI Control Characters for Auto-Login Script File

Control Character Definition

<ENTER> Enter
<SPACE> Space
<TAB> Tab

Load the Auto-Login Script File

After you create an auto-login script, copy the file to your computer. For more
information on copying files, see the user manual for your computer.
To ensure that your customized files (autolog.scr) are executed, you need to copy
the files to the directory where the Basic TE executable is stored.

Path: \Internal Storage\Honeywell\ETE\Scripts\

Note: Auto-Login Scripts can be used in both Telnet and SSH connections.

51
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Disable the Auto-Login Feature
To disable auto-login, rename or delete the autolog.scr file. Renaming the file
ensures that you can use the same auto-login script file later by changing the
name back to autolog.scr. To enable a new script file, rename a different script file
to autolog.scr.

Note: Do not rename the file by adding a number to the end (e.g., autologl.scr or
autolog2.scr). The file name is session specific. The number defines the session. To
learn more, see "Develop Auto-Login Script Files· on page 50.
Follow this procedure to rename or delete the auto-login script file.
To Rename or Delete the Auto-login File

1. Establish a USB file transfer (MPT) connection between the computer and your
PC.
2. Browse to the auto-login file.
3. Right-click the file and select Delete from the popup menu. The file is deleted.
Or select Rename from the popup menu and rename the file to disable the
feature.

Sample Auto-Login Script File

You can use this sample script file as is or as the starting point for creating your
own auto-login script files.

Example: Auto-Login With All Computers Using the Same Account

WaitFor "Login:"#Wait for the login prompt

Send "username"#Send the user name
Send "<TAB>"#Send a tab
WaitFor "Password:"#Wait for the password prompt
Send "letmein"#Send the password
Send "<ENTER>"#Send a carriage return

• The WaitFor command waits for a string to be displayed by the host.

• The first Send command sends a fixed user name. The second Send sends a
fixed password.

About Honeywell Launcher

With Honeywell Launcher active on a computer, you can limit each end user's
access to applications - whether that is a single application or a limited set of
applications. You approve the level of access you want for each of your workers.
This keeps your workers focused on line of business applications. It also prevents

52 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 them from accessing applications that might distract them and lead to
unproductive activity. And by restricting configuration to ad min users, Honeywell
Launcher prevents production workers from initiating configuration changes that
could lead to downtime and help desk calls. To learn more about the Honeywell
Launcher, see the user guide available for download at www.honeywellaidc.com.

Configure Access to BasicTE

If you want to keep the BasicTE application in Lockdown mode , you can control
access to the application through the Honeywell Launcher. Four configuration
modes are available using the Launcher software:
• Single-User and Single-Application Mode
Does not require login credentials to open BasicTE.
Requires login credentials to switch user.
• Multi-User and Multi-Application Mode
Requires login credentials to open BasicTE.
Requires BasicTE be closed before opening other applications.
• Single-User and Multi-Application Mode
Requires login credentials to open BasicTE.
Requires BasicTE be closed before opening other applications.
• Multi-User and Single-Application Mode
Does not require login credentials to open BasicTE.
Requires login credentials to switch user.

Note: When in Single-Application modes, once you launch Basic TE you cannot use the
Back key to exit the application.

Use Single-User and Single-Application Mode

Use the Single-User and Single-Application mode if you want to manage who uses
the BasicTE software but not restrict who can open the application.

When this mode is used, login credentials are required to switch from one user to
another in the BasicTE application but not to open the application.

Honeywell Launcher Screen

To Switch Users in BasicTE

1. Touch Oto access the options menu in the open BasicTE application.
2. Select SwitchUser.

53
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 3. Input the required security credentials (e.g., User Name and Password).
4. Select Login.

Use Multi-User and Multi-Applicatior, Mode

Use the Multi-User and Multi-Application mode if you want to restrict access to the
BasicTE application and prevent the user from opening other applications during
BasicTE use.

When this mode is enabled, the user must first log into the Launcher software
using secure credentials, and then open the BasicTE application. Once the
application is open, the user cannot open another application without first closing
the BasicTE application.

Honeywell Launcher

test .,
........ J
Login

1 2 3 4 5 6 7 8 9 0

• ?

Ale /

Honeywell Launcher Login Screen

To Exit BasicTE

1. Press the Back button.

2. If prompted, enter an exit password.
This step is only required if the "Enable Exit Password" key value is set to
enabled in the te_settings.xml file. To learn more, see "Configure the BasicTE
Exit Password" on page 22.
3. Select Yes to confirm exit and break the connection.

To Exit the Launcher

1. Touch
2. Select Log Out.

54 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Honeywell Launcher Menu

Use Multi-User and Single-Application Mode

Use the Multi-User and Single-Application mode if you want to manage who uses
the BasicTE software but not restrict who can open the application.

When this mode is used, login credentials are required to switch from one user to
another in the BasicTE application but not to open the application.
■■ , i. U 1,,' 'AM

Honeywell Launcher Screen

To Switch Users in BasicTE

1. Touch Oto access the options menu in the open BasicTE application.
2. Select SwitchUser.
3. Input the required security credentials (e.g., User Name and Password).
4. Select Login.

Honeywell Guidelines for BasicTE Security

Follow the recommended actions below to improve security when using BasicTE
on the computer. To learn more about network and security guidelines for Android
devices, go to www.honeywellaidc.com and download the Android Network and
Security Guide from the product page for your computer.
• Change the TE password to a non-default value. Apply standard password
security measures (e.g., do not use words; use a mix of letters and numbers).
Change account and password defaults and remove any unused accounts from
the computer.
• Create regular backups of the data present on the computer. Keep all software
on the computer updated to the latest release.
• Limit access to modify, delete and update the data on the device to an Admin or
trusted user.

55
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 • Install only signed and trusted applications on the computer.
• Use the lockdown functionality of Honeywell Launcher to limit the number of
users able to access the BasicTE application.
• Use the Generate option in EZConfig to restore the default settings of the
te_settings.xml file if possible corruption occurs. To learn more about EZConfig,
see the Dolphin Power Tools for Devices Powered by Android user guide at
www.honeywellaidc.com.
• Allow only admin access to the computer root level of the file system to reduce
computer vulnerability to hackers gaining control of the file system.
• Data transmitted through Telnet is not secure and can be seen by anyone on the
same network. If an unsecured wireless connection is used, anyone nearby can
detect and read the transmissions. Proper network encryption is necessary
when working with potentially sensitive data. Honeywell recommends using an
SSH connection to prevent unauthorized access to the data.

56 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 SCAN BARCODES

This appendix includes a list of barcode symbologies supported when using

BasicTE and either the internal scanner in the computer or a Honeywell wearable
solution. This appendix includes these sections:
• Scan Barcodes While Using BasicTE
• Symbology Prefix

57
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Scan Barcodes While Using BasicTE
Note: BasicfE cannot control the scanned data in V^tl7A and VM3A because user should
conf i gu re exte rn a I sc an ne rs se pa r ate ly.

Use BasicTE and either the integrated scanner in the computer or a Honeywelt
wearable solution ring scanner (i.e., mode[ 8620) to scan barcodes.

Supported Barcode Symbologies

Barcode Symbotogy
UPC-A
UPC-E
Standard 2 of 5
lnterleaved 2 of 5
EA N -13
EAN -8
Code 93
Code 39
Code L28
Code 1L
Codabar
GS 1128
Q RCod e

Coda Block A

Coda Block- F
Grld Nlatrix
Data N,4atrix

IRSS
Decoding

Prefix
This option witl automatica[[y insert the requested data at the head of the incoming
data stream before it is disptayed. Control characters and characters not
accessible from the keyboard can be represented using the Hat Encoding tabte.

Suffix
This option wi[[ automaticatty insert the requested data at the tait of the incoming
data stream before it is displayed. Control characters and characters not
accessible from the keyboard can be represented using the Hat Encoding tabte.

58 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 HAT Encoding Characters Hex 00 through AD

Desired Hex Desired Hex

Hat Encoded Hat Encoded
ASCII Value ASCII Value
A@ ~A
NUL 00 ESA 87 G
~A
SOH 01 A
A HTS 88 H
~A
STX 02 A
B HTJ 89 l
~A
ETX 03 A
c VTS BA J
~A
EQT 04 A
D PLO BB K
~A
ENO 05 A
E PLU BC L
~A
ACK 06 AF
RI 8D M
AG ~A
BEL 07 SS2 BE N
~A
BS 08 A
H SS3 BF O
~A
HT 09 A
l DCS 90 P
AJ ~A
LF OA PUl 91 O
~A
VT OB AK
PU2 92 R
~A
FF oc AL
STS 93 S
~A
CR OD A
M CCH 94 T
~A
so OE A
N MW 95 U
~A
SI OF A
o SPA 96 V
~A
OLE 10 AP EPA 97 W
~A
DCl (XON) 11 A
o 98 X
~A
DC2 12 A
R 99 Y
~A
DC3 (XOFF) 13 A
S 9A Z
~A
DC4 14 A
T CSI 9B (
NAK 15 A
U ST 9C ~A\\
~A
SYN 16 Av osc 9D )
~M
ETB 17 A
W PM 9E
~A
CAN 18 A
x APC 9F _ (Underscore)
Ay ~
EM 19 (no-break AO (Tilde and
space) Space)
~I
SUB lA A
Z i Al
ESC lB A[
<t A2
~ .
~
FS lC A\\ £ A3 #
A) ~
GS 1D ? A4 $
~
RS lE M ¥ A5 %
~
us lF A
_(Underscore) I A6 &
~A ~
80 @ § A7

59
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Desired Hex Desired Hex
Hat Encoded Hat Encoded
ASCII Value ASCII Value
..
81 ~A A AS ~(
82 ~B
A
© A9 ~)
83 ~A
C a
AA ~*
IND 84 ~O
A
(( AB ~+
NEL 85 ~A E ? AC ~
SSA 86 ~F
A
(soft hyphen) AD ~- (Dash)

HAT Encoding Characters Hex AE through FF

Desired Hex Desired Hex

Hat Encoded Hat Encoded
ASCII Value ASCII Value
� AE ~. (Period) ' 07 ~W
-
AF ~I 0 08 ~X
0
BO ~O (Zero) (J 09 ~Y
± Bl ~l u DA ~Z
2
82 ~2 0 DB ~[
3
83 ~3 0 DC ~\\
84 ~4 y DD ~]
? 85 ~5 p DE ~ \A
CJ! 86 ~6 B OF ~_ (Underscore)
87 ~7 a EO ~
88 ~8 a El ~a
1
89 ~9 a E2 ~b
0
BA ~· a E3 ~c
» BB ~· a E4 ~d
¼ BC ~< a E5 ~e
½ BO ~= ffi E6 ~f
¾ BE ~> <;: E7 ~g
(.. BF ~? e ES ~h
A co ~@ e E9 ~i
A Cl ~A e EA ~j
A C2 ~B e EB ~k
A C3 ~C i EC ~l
A C4 ~D i ED ~m
A C5 ~E i EE ~n
k C6 ~F I EF ~o
c; C7 ~G a FO ~p
E cs ~H n Fl ~q
E C9 ~I 6 F2 ~r

Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Desired Hex Desired Hex
Hat Encoded Hat Encoded
ASCII Value ASCII Value
E CA -J 6 F3 -s
E CB -K 6 F4 -t
i cc -L 6 F5 -u
i CD -M 6 F6 -v
i CE -N F7 -w
T CF -0 0 F8 -x
£) DO -P u F9 -y
N Dl -Q u FA -z
6 D2 -R 0 FB -{
6 D3 -s 0 FC -I
6 D4 -T y FD -}
0 D5 -u p FE --
b D6 -v y FF ~ "?

Symbology Prefix
The AIM Code ID is a 3 character IS0/IEC identifier (originally created by AIM)
generated by the decoder of a scanner, and gives information about the symbology
of the barcode which was scanned.

Format: ]cm
where:
] = flag character (ASCII 93)
c = code character (defined by Al M for that symbology)
m = modifier character

The AIM Code ID is not part of a barcode. It is generated by the decoder of a scan
engine to represent the barcode symbology which was scanned.

Based on the AIM Code ID, wedge software or terminal emulation software might
be set up to process scanned data in a user-defined way.

Note that barcode scanners may also generate 1-character barcode identifiers
instead of the 3-character AIM Code ID. The actual characters used are defined by
the manufacturer of that scan engine and might be different, depending on that
manufacturer.

Decoding
With area imagers there can be multiple barcodes in the field of view, and
sometimes the imager does not decode the barcode that was meant to be decoded,
especially with so called pick-list where just a specific barcode in a column of
barcodes should be read.

61
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Centering can be used for linear products but only for the horizontal plane to avoid
adjacent barcodes to the left or right from accidentally being read.

The centering feature is used to narrow the imager's field of view so that the imager
only reads the barcode which is intended to be read by the user. When Centering is
turned on, the imager only reads barcodes that intersect or that are contained
within a predefined Decode Window. At least part of the barcode must be within the
defined Decode Window to be decoded by the imager.

How to enable the Decoding feature

In the BasicTE, the following decoding values can be configured:
• Enable Center decoding
• Enable Decode Window Bottom
• Enable Decode Window Left
• Enable Decode Window Right
• Enable Decode Window Top

Editing Keys
Editing Keys

To Enter ANSI 5250

F+ N/A Field Plus
F- N/A Field Minus

FE N/A Field Exit

Eln N/A Erase Line

EOF N/A Erase End of the Line

Cir N/A Clear

DUP N/A Duplicate

Hip N/A Help

Rst N/A Reset

Rup N/A Roll Up

RDn N/A Roll Down

Hm NIA Home

Srq N/A System Request

Attn Attention

Use a Ring Scanner with BasicTE

Note: The Honeywell wearable solution ring scanner (model 8620) works with the Dolphin
75e only if the Dolphin 75e is attached to a docking station.

62 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 When the Honeywell 8620 ring scanner is inserted into the sled of Dolphin 75e, the
computer emits an audible sound and the green LED on the computer and on the
ring scanner illuminate. The ring scanner can be connected to the Dolphin 75e at
any time. BasicTE does not need to be running to scan barcodes through the ring
scanner.

Note: If no audible or visual feedback is received when the ring scanner is connected to the
sled, communication between the devices has not been established. Check to make
sure the scanner is properly inserted.

63
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 64 Basic Terminal Emulation (TE)
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 SOFT INPUT PANEL USE

This appendix provides information on the SIP for BasicTE functionality on

computers that support BasicTE. The chapter includes these topics:
• About BasicTE and Soft Input Panels
• About the Default Soft Input Panels
• SIP Options in Portrait Mode
• SIP Options in Landscape Mode
• Custom Keyboard and Landscape KB Creation

65
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About BasicTE and Soft Input Panels
This section includes information on using and configuring the soft input methods
specific to BasicTE. For information on using the hardware buttons on your
Honeywell computer, see the computer user manual.

About the Default Soft Input Panels

While BasicTE is running, touch [1111111] in the Toolbar to access the Soft Input Panel
(SIP). By default, one of two configurations appear depending on the orientation of
the screen.
• TE specific KB layout with Alpha, Numeric, AID, and Function keys.

q w e y u o p
a s d f g h k
z x c v b n m
Fun AID 123 Tab Bsp

Portrait Mode

• Custom U Shaped Keyboard appears in landscape mode.

Landscape Mode

Touch [Ui•OO to toggle between showing and hiding the SIP.

You can change the default screen mode behaviors by editing te_settings.xml. To
learn more, see "Configure the Orientation" on page 24.

Note: If you change the screen orientation, the SIP automatically closes. Press the [ljiijjj) to
show the SIP in the new orientation.

SIP Options in Portrait Mode

BasicTE supports four types of SIP in portrait mode:
• Alphanumeric Keyboard
• Function Key Keyboard

66 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 • AID Keyboard
• Numeric Keyboard

Alphanumeric SIP
Touch [1111111] in the Toolbar to access the Soft Input Panel (SIP).

q w e r t y U i O p
a s d g h k
z x c v b n m
Fun AID 123 Tab Bsp

Android OS Keyboard

When the SIP is displayed, you can use it for entering characters or accessing
options.

Function SIP
When the screen is in portrait mode, you can use the Function Key SIP to access
function keys from Fl to F24.

Note: Function keys F22, F23, and F24 are not currently supported for VT-ANSI emulation.
To Access the Function Key SIP

1. Touch Din the Toolbar.

2. Select Function SIP.
Fl F2 F3 F4 FS F6 F7

F8 F9 FlO Fll F12 F13 F14

FlS F16 F17 F18 F19 F20

abc AID 123 Tab Bsp

Function SIP

When the SIP is displayed, you can use it for function key access and toggling
between the AID and Numeric keyboards.

• Touch ■ to switch to the AID keyboard.

• Touch llto switch to the Numeric keyboard.

AID SIP
When the screen is in portrait mode, you can use the AID SIP to access keys
specific to VT-ANSI emulation.

To access the AID SIP:

67
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 1. Touch II in the Toolbar.
■.
2. Select Function SIP.

3. Touch

Esc Hm End PUp PDn

Sel Ins Del

abc Fun 123 Tab Bsp

AIDSIP

When the SIP is displayed, you can use it for cursor or page navigation and editing

■
relevant to VT-ANSI emulation.

■
• Touch to switch to the Function keyboard.

■
• Touch to switch to the Numeric keyboard.

• Touch to enter Home.

Numeric SIP
When the screen is in portrait mode, you can use the Numeric SIP to access
numeric keys 0-9.

To access the Numeric SIP

1. Touch II in the Toolbar.

■.
2. Select Function SIP.

3. Touch

2 3
. :: $
I

4 5 6 & + '
7 8 9
< 0 >
,be Fun AID Tab Bsp

Numeric SIP

SIP Options in Landscape Mode

When the screen is in landscape mode, the default SIP for BasicTE is the Honeywell
custom U shaped keyboard.

The Function SIP option under menu II

does not appear when landscape mode is
active. Switch to Portrait mode to use Function SIP.

68 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Touch (jjiilll) in the Toolbar to access the Soft Input Panel (SIP). Five custom
landscape configurations are available:
• Lowercase Alphabet Keyboard
• Uppercase Alphabet Keyboard
• Function Keys Keyboard
• Numeric Keyboard
• Special Character Keyboard

To cycle through the five keyboard modes, touch - or •.

Lowercase Alphabet Keyboard

Uppercase Alphabet Keyboard

Function Keys Keyboard

Numeric Keyboard

Special Characters Keyboard

69
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 About the SIP Keys
This section describes how to use the SIPs when running BasicTE. The SIPs
function the same way for all computers.

Editing Keys
Editing keys have functions assigned to them by the application software in use.
See your application documentation for information about editing key functions.
Editing keys are Find, Insert, Next Screen, Previous Screen, Remove, and Select.
To Enter an Editing Key

Press the keys listed below in the section for the computer

Editing Keys

To Enter VT/ANSI 5250

Erase Input N/A ERL
Del Shift - Del Shift- Del
Enter Enter Enter
Home N/A Hm
Insert Insert Ins
New Line (Return N/A N.L.
Reset N/A Res
Find Find N/A
Insert here Insert
Next screen NextSc NIA

Prev screen PrevSc N/A

Remove Remove N/A
Select Select

70 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Custom Keyboard and Landscape KB Creation
You can customize keyboard layout in landscape mode and also use the same file
to remap the keys in BasicTE by creating and saving a CustomKeyboard.xml file in
the \Internal storage\honeywell\ETE\KB folder on the computer.

Landscape KB Guidelines.
The CustomKeyboard.xml is implemented during BasicTE startup. The file can be
modified while the application is running.

Make sure to follow these guidelines, when you create a CustomKeyboard.xml

configuration file.
• File name must be CustomKeyboard.xml.
• Save the CustomKeyboard.xml file in the \Internal storage\honeywell\ETE\KB
folder on the computer.
• The mode, key, value, and keylndex names should not be empty.
• The mode name should be unique.
• At least one key should be present in a mode.
• The maximum number of modes that can be defined is 6.
• Total number of keys is 32.
• Keys 1-30 are configurable.
• Keys 31 and 32 are fixed for the« and » buttons and cannot be custom
configured.
• Keylndex values should be� 1 and :s; 30.
• In the tag <key>
• "text" is the value shown on the button
• "value" is the value sent to the host
• "keylndex" is the button to enable (on keyboard layout)
• Keys that are not defined in the xml file do not show on the layout.
• Text length on keys 1-20 and 29-32 should not exceed 3 characters.
• Text length on keys 21-28 should not exceed 2 characters.
• The value that is sent to the host is in plain text.
A sample of the default BasicTE keyboard XML file is provided on page 72 to use as
a reference. See page 72 for key Index layout information.

Troubleshooting
If you have trouble getting the custom SIP configuration to appear instead of the
default SIP, check these items.

71
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Verify the custom SIP configuration file is:
• Saved as "CustomKeyboard.xml".
• Located in \Internal storage\honeywell\ETE\KB folder on the computer.
Verify the Custom Keyboard.xml file does not include:
• More than 6 modes.
• Any modes without keys.
• Duplicate mode names.
• A blank or unassigned mode name.
• A blank or unassigned key text, value, or keylndex.
• A keylndex with a value that is <1 or >30.

Sample of Default Keyboard XML File

<?xml version = "l.0" encoding = "UTF-8" ?>
<!--Copyright 2017 Honeywell International Inc. All rights
reserved.-->
<Layout>
<Mode Name= "abc">
<key text= "Spc" value = " " keyindex = "l"></key>
<key text= "Tab" value = "Tab" keyindex = "2"></key>
<key text= "a" value = "a" keyindex = "3"></key>
<key text= "b" value = "b" keyindex = "4"></key>
<key text= "c" value = "c" keyindex = "S"></key>
<key text= "d" value = "d" keyindex = "6"></key>
<key text= "e" value = "e" keyindex = "7"></key>
<key text= "f" value = "f" keyindex = "8"></key>
<key text= "g" value = "g" keyindex = "9"></key>
<key text= "h" value = "h" keyindex = "lO"></key>
<key text= "i" value = "i" keyindex = "ll"></key>
<key text= "j" value = "j" keyindex = "l2"></key>
<key text= "k" value = "k" keyindex = "l3"></key>
<key text= "l" value = "l" keyindex = "l4"></key>
<key text= "m" value = "m" keyindex = "l5"></key>
<key text= "n" value = "n" keyindex="l6"></key>
<key text= "o" value = "o" keyindex = "l7"></key>
<key text= "p" value = "p" keyindex = "l8"></key>
<key text= "q" value = "q" keyindex = "l9"></key>
<key text= "r" value = "r" keyindex = "20"></key>
<key text= "s" value = "s" keyindex = "21"></key>
<key text="t" value = "t" keyindex = "22"></key>
<key text= "u" value= "u" keyindex = "23"></key>
<key text= "v" value = "v" keyindex = "24"></key>
<key text= "w" value = "w" keyindex ="25"></key>

72 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 <key text="x" value ="x" keyindex ="26"></key>
<key text="y" value = "y" keyindex="27"></key>
<key text="z" value = "z" keyindex ="28"></key>
<key text= ",_" value ="Backspace" keyindex = "29"></key>
<key text="�" value ="\n" keyindex = "30"></key>
</Mode>
<Mode Name= "ABC">
<key text="Spc" value= " " keyindex = "l"></key>
<key text="Tab" value ="Tab" keyindex = "2"></key>
<key text= "A" value = "A" keyindex ="3"></key>
<key text="B" value="B" keyindex ="4"></key>
<key text="C" value = "C" keyindex = "S"></key>
<key text="D" value = "D" keyindex ="6"></key>
<key text= "E" value = "E" keyindex ="7"></key>
<key text= "F" value = "F" keyindex ="8"></key>
<key text= "G" value = "G" keyindex ="9"></key>
<key text= "H" value = "H" keyindex ="l0"></key>
<key text= "I" value = "I" keyindex ="ll"></key>
<key text = "J" value = "J" keyindex = "l2"></key>
<key text= "K" value = "K" keyindex ="l3"></key>
<key text= "L" value = "L" keyindex = "l4"></key>
<key text= "M" value = "M" keyindex ="lS"></key>
<key text= "N" value ="N" keyindex = "l6"></key>
<key text= "O" value = "O" keyindex ="l7"></key>
<key text="P" value ="P" keyindex = "l8"></key>
<key text="Q" value="Q" keyindex ="l9"></key>
<key text="R" value ="R" keyindex = "20"></key>
<key text= "S" value ="S" keyindex= "21"></key>
<key text= "T" value ="T" keyindex = "22"></key>
<key text="U" value = "U" keyindex = "23"></key>
<key text="V" value = "V" keyindex ="24"></key>
<key text="W" value = "W" keyindex ="25"></key>
<key text= "X" value = "X" keyindex = "26"></key>
<key text="Y" value = "Y" keyindex = "27"></key>
<key text="Z" value = "Z" keyindex = "28"></key>
<key text=",_" value ="Backspace" keyindex = "29"></key>
<key text="�" value="\n" keyindex = "30"></key>
</Mode>
<Mode Name= "FUN">
<key text="F17" value ="Fl7" keyindex ="9"></key>
<key text ="Fl8" value = "Fl8" keyindex="l0"></key>
<key text="Fl9" value = "Fl9" keyindex = "ll"></key>
<key text="F20" value= "F20" keyindex = "l2"></key>
<key text="Fl3" value ="Fl3" keyindex = "l3"></key>
<key text="Fl4" value ="Fl4" keyindex="l4"></key>
<key text="FlS" value = "FlS" keyindex = "lS"></key>

73
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 <key text = "Fl6" value= "Fl6" keyindex= "l6"></key>
<key text = "F9" value= "F9" keyindex= "l7"></key>
<key text = "FlO" value = "FlO" keyindex= "l8"></key>
<key text = "Fll" value = "Fll" keyindex="l9"></key>
<key text = "Fl2" value= "Fl2" keyindex= "20"></key>
<key text = "Fl" value = "Fl" keyindex = "21"></key>
<key text = "F2" value= "F2" keyindex="22"></key>
<key text = "F3" value= "F3" keyindex = "23"></key>
<key text = "F4" value= "F4" keyindex= "24"></key>
<key text= "F5" value= "F5" keyindex= "25"></key>
<key text= "F6" value= "F6" keyindex= "26"></key>
<key text = "F7" value= "F7" keyindex = "27"></key>
<key text = "F8" value= "F8" keyindex = "28"></key>
<key text = "-" value= "Backspace" keyindex= "29"></key>
<key text = "+J" value= "\n" keyindex= "30"></key>
</Mode>
<Mode Name= "AID/NUM">
<key text = "Esc" value = "Escape" keyindex= "5"></key>
<key text = "PUp" value = "PageUp" keyindex= "7"></key>
<key text="PDn" value = "PageDown" keyindex="8"></key>
<key text= "Spc" value = " " keyindex= "9"></key>
<key text = "Tab" value = "Tab" keyindex="lO"></key>
<key text = "fi" value = "UpArrow" keyindex= "ll"></key>
<key text = "il" value= "DownArrow" keyindex= "l2"></key>
<key text = "Hm" value= "Home" keyindex= "l3"></key>
<key text = "End" value= "End" keyindex= "l4"></key>
<key text = "¢:" value = "LeftArrow" keyindex= "l5"></key>
<key text = "⇒" value = "RightArrow" keyindex = "l6"></key>
<key text= "Ins" value= "Insert" keyindex= "l7"></key>
<key text = "Sel" value= "Select" keyindex= "l8"></key>
<key text= "-" value="Backspace" keyindex= "l9"></key>
<key text = "+J" value= "\n" keyindex= "20"></key>
<key text = "l" value= "l" keyindex ="21"></key>
<key text = "2" value= "2" keyindex= "22"></key>
<key text = "3" value= "3" keyindex= "23"></key>
<key text = "4" value="4" keyindex="24"></key>
<key text = "5" value= "5" keyindex= "25"></key>
<key text = "6" value= "6" keyindex= "26"></key>
<key text = "7" value= "7" keyindex="27"></key>
<key text = "8" value = "8" keyindex= "28"></key>
<key text="9" value = "9" keyindex= "29"></key>
<key text = "O" value= "O" keyindex= "30"></key>
</Mode>
<Mode Name = "SYM">
<key text = "Spc" value = " " keyindex= "l"></key>
<key text="Tab" value= "Tab" keyindex= "2"></key>

74 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 <key text =" " value = " " keyindex ="3"></key>
<key text ="!" value ="!" keyindex ="4"></key>
<key text ="@" value= "@" keyindex="S"></key>
<key text = "#" value="#" keyindex= "6"></key>
<key text= "$" value= "$" keyindex="7"></key>
<key text="%" value ="%" keyindex="8"></key>
<key text ="&amp;" value="&amp;" keyindex = "9"></key>
<key text ="*" value ="*" keyindex="lO"></key>
<key text = "(" value="(" keyindex= "ll"></key>
<key text = ")" value=")" keyindex="l2"></key>
<key text = "+" value = "+" keyindex="l3"></key>
<key text = " =" value =" = " keyindex="l4"></key>
<key text = " [" value = "[" keyindex="lS"></key>
<key text = "]" value= "]" keyindex="l6"></key>
<key text = ":" value =":" keyindex="l7"></key>
<key text = ";" value=";" keyindex="l8"></key>
<key text= "&quot;" value="&quot;" keyindex="l9"></key>
<key text= "'" value = "'" keyindex ="20"></key>
<key text = "," value ="," keyindex ="21"></key>
<key text ="." value = "." keyindex="22"></key>
<key text ="&lt;" value="&lt;" keyindex = "23"></key>
<key text ="&gt;" value="&gt;" keyindex = "24"></key>
<key text ="/" value = "/" keyindex="25"></key>
<key text ="\" value = "\" keyindex="26"></key>
<key text ="?" value ="?" keyindex="27"></key>
<key text="-" value ="-" keyindex="28"></key>
<key text ="-" value = "Backspace" keyindex = "29"></key>
<key text ="+i" value = "\n" keyindex= "30"></key>
</Mode>
</Layout>

75
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Default Key Index
Use the images below as a reference when assigning keylndex values in your
CustomKeyboard.xml file.

6 8
10 11 12
13 14 15 n
17 18 M 20
31 32 21 n 23 24 2s 26 27 28 29 JO

Default keylndex for Modes "abc': "ABC", and "SYM"

8
9 10 11 12
13 U 15 16
17 18 19 20
31 37 21 n 23 24 25 26 21 28 29 JO

Default keylndex for Mode "AID/NUM"

10 11 12
13 14 15 16
11 18 19 20
31 32 21 22 23 24 25 26 27 28 29 JO

Default keylndex for Mode "FUN"

Keyboard Remapping Functionality

You can use the same CustomKeyboard.xml file to remap the keys as well as in
landscape mode without enabling any option in TE settings. If you want to enable
keymapping in portrait mode, you need to enable Key Mapping option in general
settings in the te_setting.xml file. If you enable the following values, the same keys
mapped in custom KB will be reflected in portrait mode.

Below are the rules to map the keys.

1. Mode/key/value/keylndex name should not be empty.

2. Mode name should be unique.
3. At least one key should be present in the mode.
4. Max number of modes that can be defined are 6.
5. keylndex values should be >=1 and <=30.

76 Basic Terminal Emulation (TE)

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 6. In the tag <key>

"text" is the value shown on button

"value" is the value sent to host

"macro" is the value sent to host when macros are activated. Macros will be
activated by adding "KeyToActivateMacro" attribute in Layout tag.

Example: < Layout KeyToActivateMacro="*"> II this activates macros when* is pressed.

"keylndex· is the button to enable.
7. Keys not defined in xml will not be shown on layout.
8. Text on keys 1-20 and 29-32 length should not exceed 3 characters.
9. Text on keys 21-28 length should not exceed 2 characters.
10. For multiple key events, value should be inside square bracket[] separated by
comma.

Example: [Fl,"Enter"] where Fl will be followed by Enter.

Maximum 3 key events can be mapped to single key.

11. Value should be inside curly bracket {}, if escaped hexadecimal sequence is
used.

Example: Value = "{\xlb}" for \xlb i.e., ESC

12. Emulation SpecificLayout: User can make a layout specific for an Emulation by
mentioning <Emulation="5250"> property in Mode.

Example: <Mode Name="abc" Emulation= "5250"> II for showing layout only in 5250 mode
<Mode Name="abc" Emulation="VT-ANSI"> II for showing layout only in VT­
ANSI mode

<Mode Name="abc"> II For showing a layout in both modes, the emulation

value can be anything else or can be removed completely.

77
Honeywell Platinum Elite Partner (800) 428-8643 [email protected]
 Honeywell
9680 Old Bailes Road
Fort Mill. SC 29707

www.honeywellaidc.com

Honeywell Platinum Elite Partner (800) 428-8643 [email protected]

BTE-A-EN-UG-01 Rev A
06/20