Dolphin
Table of contents
Loading...
™
Dolphin
for Mobile Devices with Windows® Embedded Handheld
User’s Guide
Power Tools 8.x
Disclaimer
Honeywell International Inc. (“HII”) 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 HII.
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
any and all responsibility and liability 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 HII.
Web Address: www.honeywellaidc.com
Trademarks
Microsoft, Windows, Windows Mobile, Windows Phone, Windows Embedded Handheld, Windows NT,
Windows 2000, Windows XP, Windows 7, Windows 8, Windows Vista, ActiveSync, Word Mobile, Excel
Mobile and the Windows logo are either a registered trademark or registered trademark of Microsoft
Corporation in the United States and/or other countries.
The Bluetooth trademarks are owned by Bluetooth SIG, Inc., U.S.A. and licensed to Honeywell.
Other product names mentioned in this manual may be trademarks or registered trademarks of their
respective companies and are the property of their respective owners.
Patents
For patent information, please refer to www.hsmpats.com.
2013-2014 Honeywell International Inc. All rights reserved.
Table of Contents
Chapter 1 - Introduction
Dolphin Power Tools Overview............................................................................................1-1
Software Requirements..................................................................................................1-1
Power Tools Main Window ..................................................................................................1-1
About the EZMenu Tool .................................................................................................1-2
Upgrading the Power Tools .................................................................................................1-3
File Storage Locations .........................................................................................................1-3
Chapter 2 - EZConfig Utilities
Overview ..............................................................................................................................2-1
Accessing the EZConfig Utilities on the Terminal ..........................................................2-1
EZConfig Editor....................................................................................................................2-1
Workstation EZConfig Editor..........................................................................................2-1
Terminal EZConfig Editor...............................................................................................2-1
EZConfig Client....................................................................................................................2-2
EXM Files.............................................................................................................................2-2
EXM File Descriptions....................................................................................................2-2
Chapter 3 - EZConfig Editor on the Dolphin Terminal
Overview ..............................................................................................................................3-1
EXM File Structure .........................................................................................................3-1
Opening the EZConfig Editor on the Terminal .....................................................................3-1
Opening EXM Files ..............................................................................................................3-1
Viewing the EXM File Structure in the EZConfig Editor .......................................................3-1
Menu Options.......................................................................................................................3-2
File Menu .......................................................................................................................3-2
Edit Menu .......................................................................................................................3-2
View Menu .....................................................................................................................3-2
Tools Menu ....................................................................................................................3-2
Editing Sections and Keys ...................................................................................................3-3
Modifying Section Name and Description ......................................................................3-3
Modifying a Key Name, Value, or Description................................................................3-3
Moving a Section or Key ................................................................................................3-3
Enabling a Section .........................................................................................................3-3
Disabling a Section ........................................................................................................3-4
Adding a Section or Child Section..................................................................................3-4
Associating an Application to an EXM File ..........................................................................3-4
Launching.......................................................................................................................3-4
Viewing...........................................................................................................................3-4
Adding or Editing............................................................................................................3-4
Command Line Arguments ............................................................................................3-5
iii
Chapter 4 - EZConfig Editor on the Workstation (PC)
Overview.............................................................................................................................. 4-1
EXM File Structure.........................................................................................................4-1
Installing EZConfig for Mobility on the Workstation .............................................................4-1
Upgrades ....................................................................................................................... 4-1
Opening the EZConfig Editor on the Workstation................................................................ 4-1
Menus and Toolbar Options ................................................................................................4-1
File Menu.......................................................................................................................4-2
Edit Menu.......................................................................................................................4-2
View Menu ..................................................................................................................... 4-2
Tools Menu.................................................................................................................... 4-3
Opening EXM Files.............................................................................................................. 4-3
Opening EXM Files Stored on the Workstation .............................................................4-3
Opening Remote EXM Files ..........................................................................................4-3
Working with Open EXM Files.............................................................................................4-4
Status Bar......................................................................................................................4-4
Working with Sections ...................................................................................................4-4
Working with Keys ......................................................................................................... 4-7
Saving to the Device...................................................................................................... 4-9
Configuration Documents .................................................................................................. 4-10
Creating New Configuration Documents ..................................................................... 4-10
Associating Applications .............................................................................................. 4-11
Registry Documents .......................................................................................................... 4-11
Creating Registry Documents...................................................................................... 4-12
Adding Registry Keys ..................................................................................................4-12
Default Application Association for Registry Documents.............................................4-13
Updating the Registry on the Terminal ........................................................................4-13
Processing Registry Documents on the Terminal........................................................ 4-13
Create EZConfig Bar Code................................................................................................ 4-13
Document Types..........................................................................................................4-14
Bar Code Type, Size and Number............................................................................... 4-14
Bar Code Sheet ........................................................................................................... 4-14
Generating Bar Codes.................................................................................................4-14
Chapter 5 - EZConfig Client
Overview.............................................................................................................................. 5-1
Accessing EZConfig Client .................................................................................................. 5-1
The EZConfig Client Screen................................................................................................5-1
Using EZConfig Client .........................................................................................................5-2
Scanning Bar Codes Directly from the Power Tools or Demos Main Window .............. 5-2
EXM File Processing ...........................................................................................................5-2
Chapter 6 - Autorun and AutoInstall
Overview.............................................................................................................................. 6-1
iv
Autorun ................................................................................................................................ 6-1
Autorun.exm File............................................................................................................6-1
Programs Section and the Launch Sequence ...............................................................6-1
Enabling and Disabling Sections ...................................................................................6-1
Programs’ Subsections.................................................................................................. 6-1
Editing the Autorun.exm File..........................................................................................6-2
Adding a Program Subsection ....................................................................................... 6-2
Copying a File................................................................................................................ 6-2
Start Options.................................................................................................................. 6-2
Applying Startup Options to the Autorun.exm File......................................................... 6-3
AutoInstall............................................................................................................................ 6-4
Program Install Locations ..............................................................................................6-4
AutoInstall.exm .............................................................................................................. 6-4
Command Line Arguments............................................................................................ 6-4
Chapter 7 - DeviceConfig
Overview.............................................................................................................................. 7-1
DeviceConfig.exm File......................................................................................................... 7-1
Enabling DeviceConfig Functionality .............................................................................7-1
Autorun .......................................................................................................................... 7-1
Bar Code Delivery..........................................................................................................7-1
Settings in the WLAN Supplicant................................................................................... 7-1
DeviceConfig.exm Sections and Keys................................................................................. 7-1
Connections Section...................................................................................................... 7-1
System Section.............................................................................................................. 7-5
Applications Section ......................................................................................................7-6
Launching DeviceConfig.exe Manually ............................................................................... 7-6
Temporary Option for Bar Code Deployment ...................................................................... 7-6
Chapter 8 - Network Utilities
Accessing Network Utilities ................................................................................................. 8-1
Network Utilities Main Window ...........................................................................................8-1
IP Config..............................................................................................................................8-1
Displaying the Terminal’s IP Configuration....................................................................8-2
Ping .....................................................................................................................................8-2
Route ...................................................................................................................................8-3
Print ...............................................................................................................................8-3
Add ................................................................................................................................8-4
Delete ............................................................................................................................8-4
Clear .............................................................................................................................. 8-4
Backup Settings (Radio)......................................................................................................8-5
............................................................................................................................................. 8-6
Chapter 9 - Registry Power Tools
Overview.............................................................................................................................. 9-1
v
Editing the Registry ............................................................................................................. 9-1
File Menu.......................................................................................................................9-2
Edit Menu.......................................................................................................................9-3
Importing Registry Files ................................................................................................. 9-3
Exporting Specific Registry Settings..............................................................................9-3
Backing Up the Entire Registry............................................................................................ 9-3
Restoring the Registry ................................................................................................... 9-4
RegBackup.exm ............................................................................................................9-4
Command Line Arguments..................................................................................................9-6
Registry Edit Options in EZConfig ....................................................................................... 9-6
Chapter 10 - ScanWedge
Overview............................................................................................................................ 10-1
Enabling, Disabling, and Exiting ScanWedge ................................................................... 10-1
Enabling ScanWedge .................................................................................................. 10-1
Exiting ScanWedge ..................................................................................................... 10-1
Disabling ScanWedge without Exiting the Application.................................................10-1
Modifying the ScanWedge Configuration File ................................................................... 10-1
ScanWedge.exm Sections ................................................................................................ 10-2
Data Formatting Reference Charts.................................................................................... 10-2
ASCII Conversion Chart (Code Page 1252)................................................................ 10-2
Symbology Chart .........................................................................................................10-4
Symbology Section...................................................................................................... 10-6
OCR............................................................................................................................. 10-7
VK (Virtual Key) Mapping Section ............................................................................... 10-7
Virtual Key Codes Table.............................................................................................. 10-8
Command Line Arguments........................................................................................ 10-12
Chapter 11 - EZ Pairing
Hardware Requirements.............................................................................................. 11-1
Using EZ Pairing to Establish a Connection...................................................................... 11-1
Modifying the ScanWedge Configuration File to Support EZ Pairing................................ 11-1
Accessing the EZ Pairing Menu ........................................................................................ 11-2
Menu Options ..............................................................................................................11-2
Modifying the EZ Pairing Configuration File ...................................................................... 11-2
EZPairing.exm Service Settings Section ....................................................................11-2
Command Line Arguments.......................................................................................... 11-3
Chapter 12 - Additional Power Tools
BattMon .............................................................................................................................12-1
To Enable BattMon...................................................................................................... 12-1
To Disable BattMon ..................................................................................................... 12-1
Keyboard Status ................................................................................................................ 12-1
To Enable Keyboard Status......................................................................................... 12-1
To Disable Keyboard Status........................................................................................ 12-2
vi
NoSIP ................................................................................................................................12-2
To Enable NoSIP......................................................................................................... 12-2
To Disable NoSIP ........................................................................................................ 12-2
Reboot ...............................................................................................................................12-2
Chapter 13 - SysInfo
Overview............................................................................................................................ 13-1
Chapter 14 - EZMenu
Overview............................................................................................................................ 14-1
Creating Menu Configuration Files .................................................................................... 14-1
Modifying Menu Configuration Files .................................................................................. 14-1
Menu Configuration File Sections......................................................................................14-1
Settings........................................................................................................................ 14-1
MenuEntries.................................................................................................................14-1
Including an Exit Application Icon................................................................................ 14-1
Start Options................................................................................................................ 14-2
Programming the Terminal to Boot to an Application Window .......................................... 14-3
Chapter 15 - Printing
Overview............................................................................................................................ 15-1
BTPrint......................................................................................................................... 15-1
Print Demo................................................................................................................... 15-1
Chapter 16 - Customer Support
Technical Assistance.........................................................................................................16-1
vii
viii
1
Introduction
Dolphin Power Tools Overview
Note: Screen captures and icons in this user’s guide may differ from what appears on your device.
Power Tools are used to create custom launch menus and to control your application environment. Once you have created a
custom environment, the terminal displays only the applications you wish the user to see. Dolphin™ Power Tools are installed
on every Dolphin terminal. Different versions of Power Tools apply to different Dolphin terminals depending on the model or
operating system.
Software Requirements
Dolphin Terminal
Dolphin Power Tools 8.x is designed to work with Microsoft® Windows® Embedded Handheld 6.x.
Workstation (PC)
The Power Tools installer and the workstation version of EZConfig Editor are designed to work with the following operating systems and applications:
• Microsoft Windows XP
• Microsoft Windows 2000
• Microsoft Windows NT
• Microsoft Windows Vista®
• Microsoft Windows 7
• Microsoft Windows 8
• Microsoft .NET Framework 2.0
• Microsoft ActiveSync® (version 4.5 or higher)
• Microsoft Windows Mobile Device Center
Power Tools Main Window
Tap Start > Power Tools to access the Power Tools main window. The content of the window varies by Dolphin
model. To modify how the content is displayed, tap Menu > View, and then select either Small Icon, Large Icon, List, or Detail.
Icon Description Page
SysInfo displays system information including firmware versions, DLL versions, system
parameters, network information, and radio information.
BattMon programs the LEDs on the terminal to monitor battery power.
Note: BattMon is model dependent and may not be present on your device. Refer to the
terminal User’s Guide for battery status indicators specific to your Dolphin model.
EZConfig Utilities provides access to EZConfig Client, EZConfig Editor, and a series of
EXM configuration files.
EZ Pairing connects the terminal to a ring scanner using Bluetooth wireless technology.
Note: EZ Pairing is model dependent and may not be present on your device.
11-3
11-1
3-1
11-1
1 - 1
Icon Description Page
Keyboard Status places an icon on the status/notification bar at the top of the screen that
indicates the alpha-numeric status of the keyboard.
Note: Keyboard Status is model dependent and may not be present on your device. Refer
to the terminal User’s Guide for keyboard information specific to your Dolphin model.
Network Utilities provides access to the Network Utilities (i.e., IP Config, Ping, Route,
Backup Settings).
NoSIP turns off the Soft Input Panel (SIP) in every application window. 11-2
Reboot performs a reboot. 11-2
RegBackup backs up the registry. 9-3
RegRestore loads the RegBackup file. 9-4
11-1
8-1
RegEdit allows you to edit the registry and import and export registry keys. 9-1
ScanWedge allows you to send bar code data to your application. 10-1
Suspend places the terminal in Suspend mode until the Power button is pressed. 11-3
Exit Power Tools.
About the EZMenu Tool
EZMenu is an additional Power Tool that does not appear in the main window. EZMenu formats application windows to display and launch software programs on the terminal. For further information, see EZMenu beginning on page 14-1.
1 - 2
Upgrading the Power Tools
!
Upgrades for the Power Tools on the Dolphin terminal come in the form of an executable file that installs the upgrade files onto a
workstation (PC). Once the workstation installation is complete, transfer the appropriate upgrade files to the Dolphin terminal to
upgrade the Power Tools.
Upgrades are available from Customer Support (see page 16-1) or www.honeywellaidc.com.
Note: An active Microsoft
workstation and the Dolphin terminal is required to upgrade your Power Tools software.
ActiveSync, Windows Mobile Device Center or Windows Phone app connection between a host
File Storage Locations
Two folders or paths are used to denote where your files are stored. One path is for permanent storage( \IPSM\Honeywell )
and one is for active files ( \Honeywell ).
\IPSM\Honeywell
The IPSM folder is the only partition on the terminal that persists across a kernel upgrade (*.UPG file extension).
During a kernel upgrade, files are automatically copied from the \IPSM\Honeywell folder and then installed in the
\Honeywell (root file system) folder as part of the upgrade process.
\IPSM\Honeywell\AutoInstall
The files in the IPSM\Honeywell\AutoInstall folder are only installed when a factory reset or kernel upgrade
occurs. Once the files are installed, they persist through hard and soft resets. If a file is added to the folder and a
hard or soft reset is performed, it will have no effect.
\Honeywell
The Honeywell partition or root file system partition is persistent over a hard reset, soft reset, and the removal of the
battery pack or the removal of AC power. However, during a kernel upgrade, the root file system is reformatted so all
data in the folder is deleted and replaced by any files in the \IPSM\Honeywell folder as part of the upgrade process.
To prevent data loss, back up all user data to an SD card or external memory device before performing an
upgrade.
\Honeywell\AutoInstall
If you run a CAB file from within the \Honeywell\AutoInstall (user store) folder, after the program has been
installed, the CAB file will be deleted from the User Store but the program remains installed through all successive
Hard and Soft resets.
If you want the program to be part of the Autoinstall that occurs after a factory reset or software upgrade, paste the
program file(s) in both the \IPSM\Honeywell\Autoinstall folder and the \Honeywell\Autoinstall.
1 - 3
1 - 4
2
EZConfig Utilities
Overview
EZConfig Utilities is made up of the EZConfig Editor, the EZConfig Client, and a series of EXM files.
EZConfig Editor is the tool used to open and edit EXM files. EXM files are the building blocks for creating the Power Tools
screens you see on your terminal. Some EXM files (e.g., AutoInstall, Autorun, and DeviceConfig) are used to display and run
your applications. Other EXM files are used to build your own customized screens and applications for the Dolphin terminal.
There are two versions of the EZConfig Editor. One that runs on the Dolphin terminal, and one that can run on your workstation
(PC). The EZConfig Editor that runs on your workstation is also capable of generating configuration bar codes from EXM files.
EZConfig Client decodes the bar codes generated by the workstation EZConfig Editor.
Accessing the EZConfig Utilities on the Terminal
Tap Start > Power Tools > EZConfig Utilities .
EZConfig Editor
You can use the EZConfig Editor tool to create and edit configuration files in the EXM file format for Dolphin terminals. There are
two versions of the EZConfig Editor: one for the Dolphin terminal, and one for your workstation (PC).
Workstation EZConfig Editor
The workstation editor is used to:
• Create and modify EXM files that are transferred to the Dolphin terminal.
• Generate bar codes from EXM files.
For details about the workstation editor, see EZConfig Editor on the Workstation (PC), beginning on page 4-1.
Terminal EZConfig Editor
The terminal editor is used to modify and save EXM files right on the terminal.
For details about the terminal editor, see EZConfig Editor on the Dolphin Terminal, beginning on page 3-1.
2 - 1
EZConfig Client
You can use the EZConfig Client tool to scan and decode bar codes generated by EZConfig Editor on the workstation.
For details on scanning configuration bar codes, see EZConfig Client beginning on page 5-1.
EXM Files
The EXM file format is an XML format customized for Dolphin terminals that is comprised of sections that may include child
sections and keys. Keys contain the values that configure the terminal. The EXM file format supports a multi-level, hierarchical,
tree structure. The terminal reads the highest-level section first and then reads the key values in each section. EXM files replace
INI files for Power Tools and terminal configuration settings. If both an INI file and an EXM file are present for the same
application, a warning message displays at startup and the terminal uses the EXM. Remove the INI file from the terminal to
avoid the warning message.
EXM File Descriptions
Icon Name (File Name) Description Page
AutoInstall
(AutoInstall.exm)
Autorun
(Autorun.exm)
CameraDemo.exm
DemosMenu
(DemosMenu.exm)
Demo RF Settings.exm
(DemoRfSettings.exm)
DeviceConfig
(DeviceConfig.exm)
EZConfig Menu
(EZConfigMenu.exm)
EZ Pairing
(EZPairing.exm)
ImageDemo
(ImageDemo.exe.config.exm)
Installs cab files in the AutoInstall folder, ensuring they persist
through hard resets.
Specifies the software applications to be launched after each hard
reset.
Specifies the configuration settings for the Camera Demo.
Specifies the menu for the Honeywell Demos window.
Specifies the IP Address and TCP Port used by the Imaging Demo,
Scan Demo, IQ Imaging Demo and the Signature Capture Demo.
Contains terminal configuration settings. 7-1
Specifies the menu for the Honeywell EZConfig Utilities window.
Specifies the configuration settings for EZ Pairing. 11-2
Specifies the configuration settings for the Imaging Demo.
6-4
6-1
ImagingProfiles.exm
IQImageDemo
(IQImageDemo.exe.config.exm)
Network Menu
(NetworkMenu.exm)
2 - 2
Specifies imager configuration profile used for custom application
development. For detailed information, refer to the Honeywell SDK for
Windows Embedded Handheld available for download from
www.honeywellaidc.com.
Specifies the configuration settings for the IQ Imaging Demo.
Specifies the menu for the Honeywell Network Utilities window.
Icon Name (File Name) Description Page
Power Tools Menu
(PowerToolsMenu.exm)
PrintDemo Menu
(PrintDemo Menu.exm)
RegBackup
(RegBackup.exm)
Scandemo
(ScanDemo.exe.config.exm)
Scanwedge
(ScanWedge.exm)
SignatureCapture.exm
Specifies the menu for the Honeywell Power Tools window.
Specifies the menu for the Print Demo window.
Specifies the exclusion or inclusion of registry key sections and
values during an export.
Specifies the configuration settings for the Scan Demo.
Sends data from the decoder or serial port to the foreground
application as keystrokes.
Specifies the configuration settings for the Signature Capture demo.
9-1
10-1
2 - 3
2 - 4
3
Swipe left to view the full description for
the key.
Sections
Keys
Tap the keyboard icon, or to turn
the virtual keyboard display on or off.
Menu Bar
EZConfig Editor on the Dolphin Terminal
Overview
EZConfig Editor creates, edits, and manages EXM files for Dolphin terminals. There are two versions of the EZConfig Editor:
one for the Dolphin terminal and one for the workstation. In the workstation editor, EXM files are edited, saved, and then
transferred to the Dolphin terminal. In the terminal editor, EXM files are edited and saved right on the terminal.
This chapter details the terminal version of the EZConfig Editor. For information about using the workstation version of the
EZConfig Editor, see EZConfig Editor on the Workstation (PC) beginning on page 4-1.
EXM File Structure
The EXM file format supports a multi-level, hierarchical, tree structure. The terminal reads the highest level section first and
then reads the key values in each child section. The key values configure the terminal. EXM files replace INI files for Power
Tools and terminal configuration settings. If both an INI file and an EXM file are present for the same application, the terminal defaults to the EXM file and a warning message is displayed at startup.
There are two types of configuration files in the EXM file format:
• Configuration Documents program and configure the terminal. See Configuration Documents on page 4-10.
• Registry Documents update and modify the registry. See Registry Documents on page 4-11.
Opening the EZConfig Editor on the Terminal
Tap Start > Power Tools > EZConfig Utilities > EZConfig Editor .
Opening EXM Files
To open an EXM file, do one of the following:
• Open EZConfig Utilities and tap once on the EXM file.
• Open the EZConfig Editor on the terminal and select File > Open. Browse to the file location and tap once on the EXM file.
• Open File Explorer on the terminal, browse to the file location and then tap once on the EXM file.
Viewing the EXM File Structure in the EZConfig Editor
Sections appear in the top half of the editor window. Select the + sign next to a section folder to view any associated child
sections. If a section folder is gray, the section is disabled. Keys appear in the bottom half of the window when a section is
selected. When a key is enabled for editing the value, the box contains a check mark. Menu selections are displayed at the
bottom of the screen.
3 - 1
Menu Options
The lock icon means the section’s
subsections are locked.
The key icon means that the
section’s keys are locked.
File Menu
Menu Item Description
New
Creates a new document. There are two options:
• Config Doc - Creates a configuration file.
See Configuration Documents (page 4-10).
• Registry Doc - Creates a registry file in the EXM file format.
See Registry Documents (page 4-11).
Open
Save
Save As
Properties
Exit
Opens an EXM file.
Saves the open file to the location you select on the terminal. This option is disabled for
new and imported files.
Saves the open file with a new name to the location you select on the terminal.
Associates the EXM file with an application on the terminal. See Registry Documents on
page 4-11.
Closes EZConfig Editor.
Edit Menu
For editing options, see Editing Sections and Keys, beginning on page 3-3.
View Menu
Menu Item Description
Shows or hides the icons indicating if a subsection or key is locked.
Show Locks
For additional information on locks on subsections and keys, see Status Bar on page 4-4.
Tools Menu
Menu Item Description
Launch Associated App
Simplify Document
Note: You cannot undo
this action!
Warm Boot
3 - 2
For information on this item menu, see Launching on page 3-4.
Reduces the EXM file size by permanently removing:
• Disabled sections and keys
• Descriptions
Reboots the terminal.
Editing Sections and Keys
Tap the keyboard icon,
or to turn the virtual
keyboard display on or off.
Description Field
Modifying Section Name and Description
You can only edit the name and description of a section if it is unlocked or enabled. To edit a section name or description:
1. Access the Edit Section window by doing one of the following:
• Select the section and tap Edit > Modify.
• Tap and hold on the section name, and then select Modify from the Edit menu.
2. Tap inside the Name or description fields to edit the text.
3. Tap OK or Enter on the virtual keyboard to save your changes. To close without saving your changes, tap Cancel.
Modifying a Key Name, Value, or Description
You can only edit the name and description of a section if it is unlocked or enabled. To edit a key name, value, or description:
1. Access the Edit Key window by doing one of the following:
• Select the key and then tap Edit > Modify.
• Double-tap the key.
• Tap and hold on the key name, and then select Modify from the Edit menu.
2. Tap inside the Name, Value, or Description fields to edit the text.
3. Tap OK or Enter on the virtual keyboard to save your changes. To discard your changes, tap Cancel.
Note: You cannot edit the key name or description if the key is locked.
Moving a Section or Key
To move a section or key, use the Cut, Copy, Past, or Paste as Child commands on the Edit menu. Drag and drop is not
supported.
Note: By default, the Paste function pastes sections at the same level they were cut.
Enabling a Section
Sections are enabled by default. If a section was previously disabled, you can re-enable by selecting Enable from the Edit
menu. You can enable a child section only if its parent section is enabled.
3 - 3
Disabling a Section
To disable a section and all of its keys, select Disable All from the Edit menu. Disabled sections remain in the file and are
indicated with a gray folder. If you disable a section that has child sections, all of its child sections (and the child section
keys) are disabled automatically. The child section folders are also change to gray to indicate they are disabled.
When reading the EXM file, the terminal behaves as though disabled sections are not there and moves on to read the next
enabled section.
A disabled section can be removed from the EXM file permanently by using the Delete option on the Edit menu when the
section is selected. If you want all disabled section permanently removed, use the Simplify Document option on the Tools
menu.
Adding a Section or Child Section
Select Insert Section from the Edit menu.
Select Append Child Section from the Edit menu to insert a new child section to the selected section. The new child section is inserted below the previous section.
Associating an Application to an EXM File
Launching
To launch an application associated to an EXM file, open the EXM file in EZConfig editor, and then tap
Tool s > Launch Associated App. The open EXM file automatically saves, and the associated application launches while
the EXM file remains open.
Viewing
To see if an open EXM file has an associated application, open the EXM file in EZ Config editor, and tap File > Properties.
The Path field contains the launch location of the application and the Args field contains any command line arguments to
execute when the application launches.
Adding or Editing
To add or edit an application association to an EXM file:
1. Open the EXM file in EZ Config editor on the terminal.
2. Tap File > Properties.
3. In the Path field, enter or edit the location of the application executable (.exe) file on the terminal
When an application is entered in the Path field, the following occurs:
• the command line /exm %filename appears in the Args (argument) field.
• the Execute box is automatically selected.
Execute must be selected for Configuration documents. You can deselect Execute for registry documents; however,
EZConfig Client cannot update the registry unless Execute is selected. For more information, see Creating Registry
Documents (page 4-12).
4. In the Args field, enter additional command line arguments next to the command line/exm %filename. For more
information, see Command Line Arguments.
5. If the EXM should wait until the associated application has exited before continuing, select Wait Until Finished.
6. Tap OK.
7. To save your changes to the EXM file, tap File > Save or Save As.
.
3 - 4
Command Line Arguments
/exm %filename executes the EXM file; this is the default entry
/q quiet mode
/s full screen
/o no menu
/e exit if first scan fails to deliver a valid bar code
/u accept (decode) unsecured bar codes
3 - 5
3 - 6
4
EZConfig Editor on the Workstation (PC)
Overview
EZConfig Editor creates, edits, and manages EXM files for Dolphin terminals. There are two versions of the EZConfig Editor:
one for the Dolphin terminal and one for the workstation. In the workstation editor, EXM files are edited, saved, and then transferred to the Dolphin terminal. In the terminal editor, EXM files are edited and saved right on the terminal.
This chapter details the workstation (PC) version of the EZConfig Editor. For information about using the terminal version of the
EZConfig Editor, see EZConfig Editor on the Dolphin Terminal beginning on page 3-1.
EXM File Structure
The EXM file format supports a multi-level, hierarchical, tree structure. The terminal reads the highest level section first and
then reads the key values in each child section. The key values configure the terminal. EXM files replace INI files for Power
Tools and terminal configuration settings. If both an INI file and an EXM file are present for the same application, the terminal defaults to the EXM file and a warning message is displayed at startup.
There are two types of configuration files in the EXM file format:
• Configuration Documents program and configure the terminal. See Configuration Documents on page 4-10.
• Registry Documents update and modify the registry. See Registry Documents on page 4-11.
Installing EZConfig for Mobility on the Workstation
1. Access the Honeywell web site at www.honeywellaidc.com, and then locate the product page for your Dolphin model.
2. Select the Software tab.
3. Under the Tools and Utilities heading, click on the listing for Honeywell EZConfig for Mobility Setup.
4. Follow the security directions as prompted on the screen and then click on Download.
5. When prompted, select Save, and then select a location on your workstation (e.g., your desktop).
6. Double click on the downloaded EZConfig for Mobility Setup.zip file.
7. Double click on the Setup.exe file. Select OK.
8. Follow the screen prompts to install the EZConfig for Mobility program.
Upgrades
Upgrades for EZConfig Editor on the workstation are available from Customer Support (see page 16-1) or
www.honeywellaidc.com.
Opening the EZConfig Editor on the Workstation
After you complete the software installation, EZConfig Editor is available on the workstation from the Start menu.
Click Start > All Programs > Honeywell > EZConfig for Mobility > EZConfig for Mobility to open the EZConfig Editor.
Menus and Toolbar Options
When you open the EZConfig Editor, menu selections are displayed across the top of the screen, and icons for actions are
shown below the menu bar.
Note: Some menu selections and Toolbar icons will be grayed out until an EXM file is opened.
4 - 1
File Menu
The lock icon means the section’s
subsections are locked.
The key icon means that the
section’s keys are locked.
Menu Item Description
Creates a new document. There are two options:
• Configuration Document - Creates a configuration file in the EXM file format.
New
• Registry Document - Creates a registry file in the EXM file format.
See Configuration Documents (page 4-10).
See Registry Documents (page 4-11).
Open
Open Recent
Open from Device
Save
Save As
Save to Device As
Create EZConfig
Bar Code
Properties
Exit
Opens an EXM file located on the workstation.
Opens an EXM file selected from a list of recent files opened.
Opens an EXM file located on the terminal. The location of the file appears on the title bar with
the word “[Remote]” to identify that the open file is located on the terminal.
Note: This option requires an active connection between the workstation and the terminal
(e.g., ActiveSync, Windows Device Mobile).
Saves the open file to the location you select on the workstation.
This option is disabled for new and imported files; use the Save As option instead.
Saves the open file with a new name to the location you select on the workstation.
Saves an open file to the Dolphin terminal.
Note: This option requires an active connection between the workstation and the terminal.
Embeds the open EXM file in an Aztec bar code.
Associates the EXM file with an application on the terminal.
See Registry Documents on page 4-11.
Closes EZConfig Editor.
Edit Menu
For Section Edit menu options, see Working with Sections on page 4-4.
For Key Edit menu options, see Working with Keys on page 4-7.
View Menu
Menu Item Description
Show Locks
4 - 2
Shows or hides the icons that indicate if a subsection or key has been locked against editing.
For additional information on locks on subsections and keys, see Status Bar on page 4-4.
Tools Menu
Menu Item Description
Simplifies the EXM file, which makes it smaller. Simplifying a document permanently
removes:
Simplify Document
Note: You cannot
undo this
action!
Because the following menu items execute commands on the terminal, there must be an active connection between the
workstation and the terminal (e.g., ActiveSync, Windows Mobile Device Center, or Windows Phone app).
Launch Associated
App
• disabled sections and keys.
• descriptions.
• bar code settings.
Note: When you create a bar code, you can simplify the file embedded in the bar code without
affecting the open EXM file. This reduces the size of the bar code package yet keeps
the disabled sections, descriptions, and bar code settings in the open EXM file for future
reference.
If the open EXM file is associated with an application on the terminal, this item appears active
on the Tools menu and when selected launches the associated application on the terminal.
You would use this option after saving the EXM file to the terminal; see Saving to the Device
on page 4-9.
Warm Boot
Factory Reset
Device
Soft Reset (Warm Reboot) the terminal.
Factory Reset the terminal.
Opening EXM Files
EZConfig Editor opens EXM files either stored on the workstation or on the Dolphin terminal if an active connection has been
established between the terminal and workstation (e.g., ActiveSync, Windows Mobile Device Center, or Windows Phone app).
Opening EXM Files Stored on the Workstation
Click File > Open or the Open toolbar icon and select the EXM file.
Opening Remote EXM Files
To open and edit an EXM file located on the Dolphin terminal using EZConfig
Editor on the workstation:
1. Establish an active connection between the terminal and workstation.
2. Open EZConfig Editor on the workstation.
3. Click File > Open From Device.
4. Select the file, and then OK.
Note: You can also open EXM files in the editor on the terminal. See EZConfig
Editor on the Dolphin Terminal beginning on page 3-1.
4 - 3
Working with Open EXM Files
Displays the root node
and sections.
Select a section and the
details appear in the other
portions of the window.
The folders appear in
different colors to indicate
their status.
Displays the section
name and description.
Displays the keys in the
selected section.
Text that appears in blue
can be edited.
Displays the selected
key’s name and
description.
Displays the file name.
If the file is on the
terminal, the title bar
displays the remote path.
Status Bar
Section
Name
Merge
Mode
Locks on subsections and keys
Key Name
Enabled or
Disabled
Read Only Encrypted Key locked by section
When you open an EXM file, EZConfig Editor displays the content in four different sections of the window.
Status Bar
The Status Bar appears at the bottom of the window and displays information about selected sections and keys.
Selected Section
Working with Sections
The EXM file format supports a multi-level tree structure. The section tree appears in the top left quadrant of the window
when a file is open. When selected, the root node identifies the EXM file and includes the word “Root” in the description displayed in the lower left quadrant.
Sections have a name and description and contain keys that appear in the upper right quadrant when you select the section
name. Select a section by clicking on it. You can select only one section at a time.
4 - 4
See Section Locks on page 4-6.
Selected Key
See Key Types on page 4-9.
Edit Menu Options
Select a section and click Edit to see the available options.
Menu Item Description
Allows you to rename the section name. You can also double click on the description to bring
Rename
up the Modify screen.
Note: You cannot modify the name if the section is locked or disabled; see Section Locks
(page 4-6).
Cut
Copy
Paste
Paste as Child
Delete
Enable
Disable All
Cuts a selected section.
Copies a selected section.
Pastes the section that was just cut or copied at the same level as the selected section.
Pastes the section that was just cut or copied as a child of the selected section.
Note: You can cut, copy and paste sections within an EXM file or across EXM files.
Deletes a selected section.
Note: Because you cannot undo a delete, consider disabling rather than deleting.
Sections are enabled by default. This menu item enables sections that were previously
disabled. You can enable a section only if its parent section is enabled.
To enable all the keys inside a section you are enabling, SHIFT + right-click and select
Enable All.
Sections are enabled by default. This menu item disables a selected section and all of its
keys. Disabled sections remain in the file with a gray folder .
If you disable a section that has child sections, all of its child sections (and the child section
keys) are disabled automatically. The child section folders are also in gray.
When reading the EXM file, the terminal behaves as though disabled sections are not there
and moves on to read the next enabled section.
Disabled sections can be removed from the EXM file permanently using the Simplify
Document (see page 4-3) option. If you want to keep disabled sections in the EXM file on the
workstation but not in the file deployed to the terminal, use the Simplified option (see page 4-
3).
Insert Section
Append Child
Section
This menu item inserts a new section.
This menu item adds a new child section to a selected section. The new child section is
inserted below the previous section.
Moving Sections
To move sections within an EXM file, use the drag and drop method. By default, sections are dropped at the same level
in the tree.
For additional functionality when dragging and dropping, hold:
• ALT to drop a section as a child section.
4 - 5
• CTRL to copy a section and drop the copy at the same level in the tree.
• CTRL + ALT to copy a section and drop the copy as a child section.
Note: You can select only one section at a time; you cannot use SHIFT+Click or CTRL+Click to select more than one
section.
To move sections between EXM files, open two instances of EZConfig Editor and drag and drop sections between the
session windows. When dragging, a copy of the section is dragged to the new file. When dropping, drop the section
directly on top of the section where you want the child section to appear.
Note: To drop the first section into a new file, press and hold the ALT key and drop the section on the root node. All
sections must be child sections of the root node.
Section Locks
There are different types of locks on sections. The status bar indicates what type of lock is applied to a selected section.
Lock Type
Name Lock
Key Lock
Subsection
Lock
Note: All locks are applied to each individual section and are not recursive. Only text that appears in blue can be
modified.
Status Bar
Indicator
Description Effect
The section name is
locked.
All keys are locked. Key Names and Descriptions cannot be
All immediate subsections
are locked.
Section Name and Description cannot be
modified.
modified. Keys cannot be added, moved, or
deleted within the section.
Immediate subsection Names and
Descriptions cannot be modified. Immediate
subsections cannot be added, moved, or
deleted.
Section-Level Merge Modes
EXM files ship with section-level merge modes already defined according to section content. Merge modes determine
how section information is handled when an updated EXM file is deployed to the terminal where an existing version of
that EXM file is stored.
Merge modes are indicated by folder icons and in the Status bar.
Mode Description
Merge
Effect
4 - 6
Delete + Add
Disable +
Add
Add Only
Deletes non-common children elements (i.e., subsections, and keys) in the
target file, then adds the new information from the exm file. Basically, the
new section replaces the old section.
This is the default merge mode for new sections.
Disables non-common children elements (i.e., subsections, and keys) in the
target file, then adds the new information from the bar code.
Note: Disabled sections and keys end up as disabled in the target file.
Adds new information (sections and keys) to the existing section. If this is a
brand new section, the new section is added to the existing EXM file.
Note: Disabled sections are not modified in the target file.
Exclusive
Inclusive
To change section-level merge modes, select a section and right click.
The same options
appear on both
menus.
The folder colors change immediately after selection.
Working with Keys
Keys have a Name, a Description, and a Value and reside inside sections. For specific key values, consult the chapters of
this User’s Guide that describe the EXM file you are editing.
Edit Menu Options
Select a key and right-click or click Edit to see the available options.
Menu Item Description
Rename
Cut
Copy
Paste
Activates the key name so that you can rename the key. Rename is disabled if the key is
locked or disabled; see Key Types (page 4-9).
Cuts a selected key.
Copies a selected key.
Disabled; keys can be pasted only as children of a section.
4 - 7
Loading...