Dolphin Peripherals 6100 User Manual
®
Dolphin
For
Windows Mobile
Windows Mobile
Windows
®
CE 5.0 (Dolphin 6100, 6500, 7600)
Power Tools
®
5.0
®
2003 Second Edition
User’s Guide
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.
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.
©2007–2010 Honeywell International Inc. All rights reserved.
Web Address: www.honeywellaidc.com
Trademarks
Dolphin, Dolphin RF, HomeBase, Mobile Base, and QuadCharger are trademarks or registered
trademarks of Hand Held Products, Inc. or Honeywell International Inc.
Microsoft, Windows, Windows Mobile, Windows CE, Windows NT, Windows 2000, Windows ME,
Windows XP, ActiveSync, Outlook, and the Windows logo are trademarks or registered trademarks of
Microsoft Corporation.
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
Please refer to the product packaging for a list of patents.
Other Trademarks
The Bluetooth trademarks are owned by Bluetooth SIG, Inc. U.S.A. and licensed to Honeywell.
Table of Contents
Chapter 1 - Accessing and Upgrading Power Tools
Dolphin Power Tools Overview............................................................................................1-1
Software Requirements .......................................................................................................1-2
Dolphin Power Tools Main Window .....................................................................................1-2
Additional Dolphin Power Tools ...........................................................................................1-4
Dolphin 6100, 6500, and 7600 Power Tools........................................................................1-5
Upgrading Power Tools .......................................................................................................1-6
Chapter 2 - EZConfig
EZConfig Editor....................................................................................................................2-2
Sample EXM Files..........................................................................................................2-2
Opening EZConfig Editor on the Workstation ................................................................2-3
Menu and Toolbar Options ..................................................................................................2-3
File Menu .......................................................................................................................2-3
Working with Open EXM Files .......................................................................................2-7
Working with Sections....................................................................................................2-7
Working with Keys........................................................................................................2-11
Creating New Configuration Documents......................................................................2-14
Associating Applications ..............................................................................................2-15
Registry Documents...........................................................................................................2-16
Processing Registry Documents on the Terminal ........................................................2-18
Creating Bar Codes ...........................................................................................................2-19
Converting Known INI and MNU Files ...............................................................................2-25
EZConfig Editor on the Terminal........................................................................................2-27
Editing Sections ...........................................................................................................2-28
Editing Keys .................................................................................................................2-29
Launching Associated Applications..............................................................................2-30
EZConfig Client..................................................................................................................2-31
Using EZConfig Client..................................................................................................2-31
EZConfig Client Window ..............................................................................................2-33
Command Line Arguments ..........................................................................................2-34
Chapter 3 - DeviceConfig
DeviceConfig.exm File .........................................................................................................3-1
Settings in Control Panel Applets...................................................................................3-1
DeviceConfig.exm Sections and Keys .................................................................................3-2
Connections Section ......................................................................................................3-2
Radio Manager Section..................................................................................................3-2
System Section ............................................................................................................3-12
Applications Section.....................................................................................................3-15
Launching DeviceConfig.exe Manually..............................................................................3-17
Temporary Option for Bar Code Deployment ....................................................................3-17
iii
Chapter 4 - Startup Power Tools
Autorun ................................................................................................................................ 4-1
Autorun.exm File............................................................................................................ 4-1
Start Options.................................................................................................................. 4-5
AutoInstall............................................................................................................................ 4-7
Program Install Locations .............................................................................................. 4-7
AutoInstall.exm .............................................................................................................. 4-8
Command Line Arguments............................................................................................ 4-8
Chapter 5 - ScanWedge
Enabling ScanWedge .......................................................................................................... 5-1
ScanWedge.exm Sections .................................................................................................. 5-2
Settings Section............................................................................................................. 5-3
Comm Section ............................................................................................................... 5-6
Decode Section .............................................................................................................5-9
Centering Section ........................................................................................................ 5-12
Formatting.................................................................................................................... 5-13
Symbologies Section ................................................................................................... 5-18
VK (Virtual Key) Mapping Section ...............................................................................5-21
Virtual Key Codes Table.................................................................................................... 5-22
Command Line Arguments................................................................................................ 5-27
Chapter 6 - Additional Power Tools
BattMon ............................................................................................................................... 6-2
InstallerCE ........................................................................................................................... 6-4
HotKeys ............................................................................................................................... 6-5
Keyboard Status .................................................................................................................. 6-7
NoSIP .................................................................................................................................. 6-9
RASMan ............................................................................................................................ 6-11
Reboot ............................................................................................................................... 6-14
Suspend ............................................................................................................................ 6-15
SysInfo............................................................................................................................... 6-16
Chapter 7 - Battery Analyzer
Requirements ...................................................................................................................... 7-1
Recommendation........................................................................................................... 7-1
Analyzing a Battery.............................................................................................................. 7-2
Stopping an Analyze Cycle............................................................................................ 7-2
Command Line Arguments.................................................................................................. 7-3
Advanced Mode...................................................................................................................7-3
Chapter 8 - RegEdit
Editing the Registry ............................................................................................................. 8-1
Menus.................................................................................................................................. 8-3
File Menu.......................................................................................................................8-3
Edit Menu.......................................................................................................................8-3
View Menu..................................................................................................................... 8-4
iv
Importing Registry Files....................................................................................................... 8-5
Exporting Specific Registry Settings.................................................................................... 8-6
Other Export Options..................................................................................................... 8-6
Backing Up the Registry ...................................................................................................... 8-6
Restoring the Registry ................................................................................................... 8-7
RegBackup .......................................................................................................................... 8-8
Command Line Arguments................................................................................................ 8-10
Dolphin 7600 Registry Power Tools .................................................................................. 8-11
Registry Edit Options in EZConfig ..................................................................................... 8-13
Chapter 9 - EZMenu
Default EZMenu Configuration Files.................................................................................... 9-1
Menu Configuration File Sections........................................................................................ 9-3
Start Options.................................................................................................................. 9-6
Locking Down the Application Window................................................................................ 9-9
Chapter 10 - Network Utilities
Accessing Network Utilities .............................................................................................. 10-1
IP Config............................................................................................................................ 10-2
Ping ...................................................................................................................................10-4
Route ................................................................................................................................. 10-6
WiFi Status ...................................................................................................................... 10-10
Backup Radio Settings .................................................................................................... 10-12
Restore Radio Settings.............................................................................................. 10-12
Chapter 11 - SetRAM
Accessing SetRAM............................................................................................................ 11-2
RAM Memory Allocation in DeviceConfig.......................................................................... 11-2
SetRAM Window ............................................................................................................... 11-2
RAM Memory Restrictions................................................................................................. 11-3
Chapter 12 - Print Power Tools
Print Demo......................................................................................................................... 12-1
BTPrint............................................................................................................................... 12-1
Chapter 13 - Customer Support
Technical Assistance......................................................................................................... 13-1
Online Technical Assistance........................................................................................ 13-1
v
vi
1
Accessing and Upgrading Power Tools
Dolphin Power Tools Overview
Dolphin Power Tools are installed in every Dolphin terminal. Different versions of Power Tools apply to
different Dolphin terminals depending on their model or operating system. Consequently, screen captures
that appear in this document may contain tools that do not apply to your device. Please consult the
following table.
Power Tool
AutoInstall
Autorun
Battery Analyzer
BattMon
DeviceConfig
EZConfig Editor
EZConfig Client
EZMenu
HotKeys
Keyboard Status
Network Utilities:
Windows Mobile
5/6
6.0: 7600 (GSM)
5.0: 7850/7900/
9500/
••••
••••
•
•••
••••
••••
••••
••••
••
•••
Windows Mobile
2003 Second
Edition
7900/9500 7600 6100/6500
Windows CE
5.0
Windows CE
5.0
IPConfig
Ping
Route
WiFi Status
Backup Radio Settings
Restore Radio Settings
NoSIP
RASMan
Reboot
RegBackup
RegEdit
RegRestore
••••
••••
••••
•
•
•
••
••
••••
••••
••••
••••
1 - 1
Power Tool
Windows Mobile
5/6
Windows Mobile
2003 Second
Edition
Windows CE
5.0
Windows CE
5.0
ScanWedge
SetRAM
Suspend
SysInfo
••••
•
••••
••••
Software Requirements
Dolphin Terminals
Power Tools are designed to work with the following mobile device platforms:
•Microsoft
•Microsoft
•Microsoft
•Microsoft
Desktop
The Power Tools installer and the workstation version of EZConfig Editor are designed to work with the
following operating systems:
•Microsoft
•Microsoft
•Microsoft
•Microsoft
•Microsoft
®
Windows Mobile® 2003 Software for Pocket PCs
®
Windows Mobile® 2003 Second Edition Software for Pocket PCs
®
Windows Mobile® 5.0
®
Windows® CE 5.0 (Dolphin 7600, 6100, 6500)
®
Windows® XP
®
Windows® 2000
®
Windows® NT
®
.NET Framework 2.0
®
ActiveSync® (version 4.2 or higher)
Dolphin Power Tools Main Window
Note: Check the Dolphin Power Tools Overview (see page 1-1) to determine the applicable tools for your device.
On Windows Mobile-based Dolphins,
Start > Power Tools.
tap
1 - 2
On the Dolphin 7600, 6100, 6500
tap Start > Programs > Power To ols.
Icon Name Description See Page
Battery
Analyzer
BattMon Programs the LEDs on the top panel to monitor battery power. 6-2
EZConfig
Utilities
HotKeys* Activates button assignments in the Buttons setting. 6-5
Keyboard
Status*
NoSIP* Turns off the Soft Input Panel (SIP) in every application window. 6-9
Network
Utilities
RASMan* Establishes a remote access service (RAS) connection. 6-11
Helps manage the battery. 7-1
Opens a window that displays the EZConfig utilities on the terminal.
• EZConfig Editor on the Terminal (see page 2-27)
• EZConfig Client (see page 2-31)
Puts an icon on the Navigation bar that indicates the alpha-numeric
status of the keyboard.
Opens a window that displays the Network utilities:
• IP Config (see page 10-2)
• Ping (see page 10-4)
• Route (see page 10-6)
• WiFi Status (see page 10-10)
• Backup Radio Settings (see page 10-12)
• Restore Radio Settings (see page 10-12)
2-1
6-7
10-1
Reboot Performs a warm or cold boot from the touch screen, as opposed to
the keyboard commands.
RegBackup Backs up the registry. 8-6 & 8-11
RegEdit Allows you to edit the registry and import and export registry keys. 8-1
RegRestore Loads the RegBackup file. 8-7 & 8-12
ScanWedge Enables the Dolphin terminal to interpret as keystrokes data
received via the decoder, serial port, or IrDA interface.
SetRAM* Allows you to re-set the memory allocation; applies only to Windows
Mobile 5.0-based terminals.
Suspend Manually puts the terminal into Suspend mode from the touch
screen, as opposed to the keyboard commands or time-out
settings.
SysInfo Displays system information. 6-16
6-14
5-1
11-1
6-15
1 - 3
Exiting the Power Tools Main Window
• Scroll down and tap the Exit icon .
•Tap File > Exit (ESC).
• Press ESC on the keyboard.
View Options
The View menu changes the organization of the Power Tools main window and is located at the bottom
(Windows Mobile) or the top (Windows CE) of the screen. A checkmark appears next to the selected view.
This menu enables you to choose between:
•Small Icon View
• Large Icon View (Default view)
•List View
• Detail View (This view displays a description of the Power Tool in a column to the right of the name.)
Additional Dolphin Power Tools
These Power Tools are in the Dolphin terminal but do not appear on the main window.
Note: The storage location on the Dolphin 6100/6500 is \Honeywell.
Name Function Storage Location Access Location Page
AutoInstall Installs CAB files after a
hard reset.
AutoRun Programs which
applications launch at
startup.
BTPrint Prints to a Bluetooth
device.
DeviceConfig Configures the terminal
EZMenu Programs custom
application windows.
\IPSM (\Honeywell
for 6100/6500)
\IPSM (\Honeywell
for 6100/6500)
\Program
Files\Power Tools
\IPSM (\Honeywell
for 6100/6500)
\Program
Files\Power Tools
\IPSM\AutoInstall
(\Honeywell for
6100/6500)
\IPSM (\Honeywell
for 6100/6500)
\Program
Files\Power Tools
\IPSM
Dolphin 7600:
\Program
Files\Power Tools
\IPSM\*Menu.exm files
(\Honeywell for
6100/6500)
4-7
4-1
12-1
3-1
9-1
1 - 4
Name Function Storage Location Access Location Page
InstallerCE Stores CAB files after they
install instead of deleting
them.
\Program
Files\Power Tools
You do not launch
InstallerCE.
4-1
Dolphin 6100, 6500, and 7600 Power Tools
The Dolphin 6100, 6500, and 7600 with Windows CE 5.0 contain the following Power Tools (except where
noted):
• AutoInstall (see page 4-7)
• Autorun (see page 4-1)
• BattMon (see page 6-2) (does not apply to Dolphin 6100/6500)
• BTPrint (see page 12-1)
• DeviceConfig (see page 3-1)
• EZConfig (see page 2-1)
• EZMenu (see page 9-1)
• IP Config (see page 10-2)
• InstallerCE (see page 6-4) (does not apply to Dolphin 6100/6500)
• Ping (see page 10-4)
• Reboot (see page 6-14)
• RegBackup (see page 8-8)
• RegEdit (see page 8-1)
• RegRestore (see page 8-12)
• Route (see page 10-6)
• ScanWedge (see page 5-1)
• Suspend (see page 6-15)
• SysInfo (see page 6-16)
1 - 5
Upgrading Power Tools
Dolphin Power Tools come loaded in every Dolphin terminal and are included in system upgrades. The
Power Tools CAB file is part of a Demos and Power Tools upgrade.
Acquiring Upgrades
Upgrades are available from Customer Support (see page 13-1) or www.honeywellaidc.com.
Installing an Upgrade to the Workstation
Dolphin Power Tools upgrades come in the form of an upgrade executable that installs upgrade files to
the workstation and transfers the appropriate upgrade files to the Dolphin terminal.
Requirements
1. Download the new Honeywell Power Tools and Demos for WM 5.0 Setup rx.xx.exe to the
Program Files folder on the workstation.
2. Click the Honeywell Power Tools and Demos for WM 5.0 Setup rx.xx.exe to install.
An active Microsoft® ActiveSync® connection between a host workstation and the terminal.
1 - 6
3. Click Next.
4. If you accept the terms of the license agreement, select I accept the terms… click Next.
5. Read the description on the screen and click Install.
6. On the next screen, click Install and program begins installing.
7. When the installation is complete, click Finish.
1 - 7
Dolphin Power Tools and Demos Folder on the Workstation
After installation on the workstation is complete, the upgrade files are stored in the C:\Program
Files\Honeywell\Power Tools and Demos for WM 5.0\Device Image folder. The Device Image folder
contains a subfolder for each operating system on the Dolphin terminal.
Note: If a Honeywell folder does not already exist in the Program Files folder, the installation creates one.
The Demos and Power Tools folder on the workstation contains three folders:
Folder This folder contains…
DOCS User guides for Demos and Power Tools (including this guide).
EZConfig Editor EZConfig Editor program and sample EXM files.
Device Image Ghost images of the IPSM upgrade. The contents of each subfolder should replace the
contents of the
\IPSM (\Honeywell for 6100/6500) folder on the Dolphin terminal.
1 - 8
Installing an Upgrade on the Terminal
1. Using the appropriate Dolphin communication peripheral for your series, connect the Dolphin
terminal to the workstation and ensure that the ActiveSync connection is running.
2. On the workstation, open Windows Explorer and navigate to the
\IPSM (\Honeywell for 6100/6500)
folder on the Dolphin terminal.
3. Back up your current \IPSM
4. On the terminal, delete the entire contents of the \IPSM
(\Honeywell for 6100/6500) folder to the workstation.
(\Honeywell for 6100/6500) folder.
5. Tap Start > Programs > Honeywell > Power Tools and Demos for WM 5.0 > Device Image.
6. Copy all items (including the Autoinstall folder).
7. Navigate to the
8. Copy and paste radio CABs, application CAB files, and programs to the \IPSM
6100/6500)
\IPSM (\Honeywell for 6100/6500) folder on the Dolphin terminal and paste.
(\Honeywell for
and \IPSM\Autoinstall (\Honeywell\Autoinstall for 6100/6500) folders.
If you have custom EXM files with settings you want to keep, merge those EXM files with the new
EXM files, and paste them on to the Dolphin terminal.
9. When all the files are pasted, cold boot the terminal.
10. The Power Tools upgrade installs during startup.
1 - 9
1 - 10
2
EZConfig
Overview
EZConfig is a suite of products that configures Dolphin terminals quickly and efficiently. With the tools in
the EZConfig suite, you can package data on the workstation, then deploy and unpackage that data on
the Dolphin terminal.
Components
There are two main components: EZConfig Editor and EZConfig Client.
EZConfig Editor
Edits and creates configuration and registry documents in the EXM file format for Dolphin terminals. There
are two versions of EZConfig Editor: one for the workstation and one for the terminal.
Both editors:
• Create and modify EXM files–Working with Open EXM Files (see page 2-7)
• Convert INI files to EXM files–Converting Known INI and MNU Files (see page 2-25)
In addition, EZConfig Editor on the workstation
• Generates bar codes from EXM files–Creating Bar Codes (see page 2-19)
For details about the workstation editor, see EZConfig Editor on page 2-2.
For details about the terminal editor, see EZConfig Editor on the Terminal on page 2-27.
EZConfig Client
Decodes the bar codes generated by EZConfig Editor on the workstation.
For details, see EZConfig Client on page 2-31.
Upgrades
EZConfig Editor on the workstation must be installed on the workstation separately from the Power Tools
upgrade. Obtain the Honeywell EZConfig Editor Setup rXX.exe from www.honeywellaidc.com and
install the EXE on the workstation.
All components on the terminal–the EZConfig Editor and EZConfig Client–are installed during Power
Tools and Demos upgrades. For more information, see Upgrading Power Tools on page 1-6.
2 - 1
EZConfig Editor
EZConfig Editor creates, edits, and manages EXM files for Dolphin terminals. There is an EZConfig Editor
on the workstation and an EZConfig Editor on the terminal. In the workstation editor, EXM files are edited,
saved, then transferred to the terminal. In the terminal editor, EXM files are edited and saved right on the
terminal; see EZConfig Editor on the Terminal (page 2-27).
EXM Files
The EXM file format is an XML format customized for Dolphin terminals that are comprised of sections
that sometimes contain 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, the terminal defaults to the EXM file and a warning
message appears at startup. Remove the INI file from the terminal to avoid this warning message.
Types of Configuration Files
There are two types of configuration files in the EXM file format:
Configuration documents Program and configure the terminal; see Opening EXM Files on page 2-6.
Registry documents Update and modify the registry; see Registry Documents (page 2-16).
Sample EXM Files
After you install the new build on the workstation, default EXM files are stored in the C:\Program
Files\Honeywell\Power Tools and Demos for WM 5.0\EZConfig EXM Files folder.
Use these files as templates to create new EXM files.
2 - 2
Opening EZConfig Editor on the Workstation
Menu
Toolbar
After you complete installation, EZConfig Editor is available on the workstation from the Start menu.
On Windows Mobile-based devices, click Start > Programs > Honeywell > EZConfig Editor >
EZConfig Editor.
On the Dolphin 7600, click Start > Programs > Power Tools > EZConfig Utilities > EZConfig Editor.
Menu and Toolbar Options
The menu and toolbar at the top of the window contains many options.
File Menu
Menu Item Description
New
Open
Open from Device Opens an EXM file located on the terminal. The location of the file appears in the title bar
Save
Save As Saves the open file with a new name to the location you select on the workstation.
Save to Device As Saves an open file to the terminal; see Saving to the Device on page 2-13.
Creates a new document. There are two options:
• Configuration Document - Creates a configuration file;
Creating New Configuration Documents (page 2-14).
• Registry Document - Creates a registry file in the EXM file format;
Registry Documents (page 2-16).
Opens an EXM file located on the workstation.
with the word “[Remote]” to identify that the open file is located on the terminal.
Note: Requires an ActiveSync connection between the workstation and the terminal.
Saves the open file to the location you select on the workstation.
This option is disabled for new and imported files; use Save As instead.
Note: Requires an ActiveSync connection between the workstation and the terminal.
2 - 3
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
Properties
Create EZConfig
Bar Code
Exit Closes EZConfig Editor.
Associates the EXM file with an application on the terminal; see Associating Applications
on page 2-15.
Embeds the open EXM file in an Aztec bar code; see Generating Bar Codes on page 2-
20.
Edit Menu
For Section Edit menu options, see Working with Sections on page 2-7.
For Key Edit menu options, see Working with Keys on page 2-11.
View Menu
Menu Item Description
View Locks
Displays an icon over locked sections. For example,
2 - 4
Information about locks on subsections and keys also appears in the Status Bar (see
page 2-7).
Tool s Menu
Menu Item Description
Simplify Document
Note: You cannot
Simplifies the EXM file, which makes it smaller.
Simplifying
permanently removes
undo this
action!
Because the following menu items execute commands on the terminal, there must be an ActiveSync connection
between the workstation and the terminal.
Launch Associated
Application
• Disabled sections and keys
• Descriptions
• Bar code settings
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.
For more information, see Simplified (page 2-21) on the Advanced Tab (see page 2-21).
If the open EXM file is associated with an application on the terminal, this item is active
and launches the associated application on the terminal.
Note: You would use this option after saving the EXM file to the terminal; see Save to
Device As on page 2-3.
*Warm Boot Warm boots the terminal.
*Cold Boot Cold boots the terminal.
*Some settings affect the boot process and these menu items can help you run a test
without switching to the terminal.
Upgrade Remote
INI Files*
Launches the tool that converts existing INI files stored on a device to the EXM file
format. For more details, see Converting Known INI and MNU Files on page 2-25.
Note: Does not apply to the 6100/6500.
2 - 5
Opening EXM Files
EZConfig Editor opens EXM files stored on the workstation or the terminal (if an ActiveSync connection
is established).
Opening EXM Files on the Workstation
Click File > Open or the Open toolbar button and select the EXM file.
When you select a known MNU or INI file, EZConfig Editor prompts you to convert the file. When you
select Yes, EZConfig Editor imports the file and converts it to the EXM file format. Then, you can click
File > Save As to save the file with the EXM extension.
You cannot save known INI or MNU files in their original format. For a list of known files, see Known INI
and MNU Files on page 2-25.
The preferred conversion method is to use the batch conversion tool and then make your edits to the new
EXM files. For details, see Converting Known INI and MNU Files on page 2-25.
Opening Remote EXM Files
The workstation and the terminal must be connected via ActiveSync!
EZConfig Editor can open EXM files located on the terminal so that you can make edits to the terminal’s
configuration real-time.
When the terminal and workstation are connected by ActiveSync, click File > Open From Device and the
remote open window opens. (\Honeywell for 6100/6500)
To open, double-tap on a file or select it and click OK.
Note: You can also open EXM files in the editor on the terminal; see EZConfig Editor on the Terminal (page 2-27).
2 - 6
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
Whether you open an EXM or INI 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
See Section Locks on page 2-9.
Selected Key
See Key Types on page 2-13.
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. The root node identifies the EXM file and “Root” appears in the description.
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.
2 - 7
Edit Menu Options
Select a section click Edit to see the available options.
Rename Activates the section name so that you can rename the section.
Note: You cannot modify the name if the section is locked; see Section Locks (page 2-9).
Cut Cuts a selected section.
Copy Copies a selected section.
Paste Pastes the section that was just cut or copied at the same level as the selected section.
Paste as Child 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.
Delete Deletes a selected section.
Note: Because you cannot undo a delete, consider disabling rather than deleting.
Enable Sections are enabled by default. This menu item enables sections that have been disabled
prior. 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
Disable All Sections are enabled by default. This menu item disables sections 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 2-5) 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 2-21) when creating the bar code.
Insert Section This menu item inserts a new section. You can also press the Insert key (INS).
Append Child Section This menu item adds a new child section to a selected section. The new child section is
inserted below the previous section.
Enable All.
2 - 8
Modifying Section Names
To change a section name, double-click on the folder and type in the new name or select Rename on the
Edit menu. Type in the new name and press ENTER.
Note: You cannot modify the name if the section is locked or disabled; see Section Locks (page 2-9).
Modifying Section Descriptions
Descriptions are not required to process key values but do help document the EXM file and often contain
valuable information. If you want to modify a section description, select the section, click inside the section
description, and begin typing. You cannot modify descriptions of locked sections.
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, press and hold:
• ALT to drop a section as a child section.
• 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 them. When dragging, a copy of the section is dragged to the new file. When dropping, drop the
section directly on top of the section you want it to be a child section of.
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 Status Bar
Indicator
Name Lock The section name is
Key Lock All keys are locked.
Subsection
Lock
Note: All locks are applied to each individual section and are not recursive. Only text that appears in blue can be
modified.
Description Effect
• Section Name and Description cannot be
locked.
All immediate subsections
are locked.
modified.
• Key Names and Descriptions cannot be
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.
2 - 9
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
Delete + Add Deletes non-common children elements (i.e., subsections, and keys) in
the target file, then adds the new information from the bar code.
Basically, the new section replaces the old section.
This is the default merge mode for new sections.
Disable +
Add
Add Only Adds new information (sections and keys) to the existing section. If this
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 removed from the simplified bar code
end up as disabled in the target file.
is a brand new section, the new section is added to the existing EXM
file.
Note: Disabled sections removed from the simplified bar code are not
modified in the target file.
To change section-level merge modes, select a section and right click.
Exclusive
Inclusive
The folder colors change immediately after selection.
2 - 10
Working with Keys
The same options
appear on both
menus.
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’re attempting to edit.
Edit Menu Options
Select a key and right-click or click Edit to see the available options.
Rename Activates the key name so that you can rename the key.
Note: Rename is disabled if the key is locked or disabled; see Key Types (page 2-13).
Cut Cuts a selected key.
Copy Copies a selected key.
Paste Disabled; keys can be pasted only as children of a section.
Paste as Child Pastes the key just cut or copied in the selected section. Keys are not multi-level; all keys
paste at the same level within a section.
Note: You can cut, copy and paste keys within an EXM file or across EXM files.
Delete Deletes a selected key.
Note: You cannot undo a delete; you might want to consider disabling rather than deleting.
Enable Enables keys that were disabled. When a key is enabled, the client application can read
and apply its value. When you enable a key, make sure to specify a value for that key; do
not leave it blank.
Note: To enable a key, its parent section must be enabled.
Disable Disables keys. Enabled keys have key values in blue. Disabled keys have key values in
black.
The terminal does not read disabled keys and disabled keys are removed if the file is
simplified; see Simplify Document (page 2-5).
Because many key values are 1 for enable and 0 for disable, remember that disabling
a key means that the terminal behaves as if the key is not there when reading the file,
NOT that the key’s value is set to disabled. The terminal simply moves on to read the
next enabled key.
Insert New Key This menu item inserts a new key above the selected key.
Note: You can also press the Insert key (INS).
2 - 11
Modifying Key Names
To modify key names, double-click on the key name or select Rename on the Edit menu. Type in the new
name and press ENTER or TAB.
Note: You cannot modify the description if the key is locked; see Key Types (page 2-13). Only text that appears in
blue can be modified.
Modifying Key Values
You can modify a key value only if its text appears in blue. In that case, double-click on the value or select
the key and press ENTER. Type in the new value and press ENTER or TAB to save.
Modifying Key Descriptions
Descriptions are not required to process key values but do help document the EXM file and often contain
valuable information. To modify a key’s description, click on the key, then click in the key description area.
When the cursor is active, you can type in the text.
Note: You cannot modify the description if the key is locked; see Key Types (page 2-13).
Moving Keys
To move keys within an EXM file, use the drag and drop method. Press and hold the CTRL key to drag
and drop a copy of the key to the new location.
Note: You cannot move a key if it is locked by its section.
To move keys between EXM files, open two instances of EZConfig Editor and drag and drop keys
between them. When you select the key and drag, a copy of the key is dragged to the new file. In the new
file, drop the key in the key area of a selected section; keys are always dropped at the same level within
a section.
2 - 12
Key Types
When a key is selected, its properties display in the Status bar.
Lock Type Status Bar
Indicator
Name Lock Keys are locked by the
Read Only Read-only keys cannot be
Encrypted
Note: Locked and Read Only properties are not recursive. Properties are applied to each individual key. Only text
that appears in blue can be modified.
Description Effect
• Name and Description cannot be
section.
The key name is locked
individually.
modified in any way. They
appear in red.
Key’s value appears as
asterisks (*) for added
security.
modified.
• Keys cannot be added, moved, or
deleted within the section.
• Name and Description cannot be
modified.
• These keys can be moved.
• Name, Description, and Value cannot be
modified.
• Keys cannot be added, moved, or
deleted within the section.
Note: Encrypted keys are also stored
encrypted in the EXM file. If you open
the EXM file in a text editor, you won't
see the data as clear text.
Saving to the Device
You can save EXM files directly to the terminal when there is an ActiveSync connection between the
terminal and the workstation. Select File > Save to the Device As and the Save Remote File window
opens.
Select the location on the terminal where you want to store the file and click OK. The file is downloaded
directly to the terminal via ActiveSync.
Note: EXM files for Dolphin Power Tools must be stored in the
\IPSM (\Honeywell
for 6100/6500) folder.
2 - 13
Creating New Configuration Documents
The terminal reads
root node first.
The Description
says “Root” to
indicate that this is
the root section.
To create new EXM files that are configuration documents, you can open an existing EXM file and save
it with a new name or create an EXM file from scratch.
1. Click File > New > Configuration Document. The root node is created and appears as the top level
section. All sections must be at least one level down from the root node. The name of the root node
is always the same as the filename.
Note: You can also create registry documents in the EXM file format. For details, see Registry Documents on page
2-16.
2. To create the first subsection, select the root node, right-click, and select Append Child Section.
Insert Section is disabled because you cannot insert sections at the same level as the root node.
3. Enter a Name and a Description and click OK.
The name is required, the description is optional.
4. To add a new section at the same level, right-click and select Insert Section.
To add a new section one level down, right-click and select Append Child Section.
5. To add keys, select a section, right-click in the key value section, and select Append Key.
6. Enter the Name, Value, and Description and click OK.
The name is required, the description is optional.
7. Continue adding sections and keys.
8. If necessary, associate this EXM file with an application; see Associating Applications (page 2-15).
9. Click File > Save As to save the file.
Save is disabled so that you save the document with a name other than “NewDocument.exm.”
2 - 14
Loading...