LXE MX3X, Reference Manual

Page: 120 / 150

110 Appendix A Key Maps
MX3X Reference Guide E-EQ-MX3XRG-A
Creating Custom Key Maps for the MX3X
Prerequisite: LXE SDK CD
Introduction
A command-line compiler called KEYCOMP.EXE is provided on the SDK CD. Using this
compiler, the System Administrator can convert a sample default key map text file into a custom
key map text file which, when loaded onto the MX3X, can be chosen by the user to replace the
default MX3X keymap and then switched back when they are finished using the customized keys.
This custom key map file can be made to re-define the system return code for each of the 61 keys,
key press or key press combinations. All keys, except the power key, can be re-mapped.
Custom keymaps for the MX3X are created on a desktop PC using the command line compiler
KEYCOMP.EXE. Keycomp processes the input keymap source file and outputs a registry text
file.
Note: Each VK_code has a numeric value (for example, VK_F20 = hex 83), these are
documented in the SDK include file WINUSER.H (from Microsoft). The numeric value is
what needs to go into the registry. Whether the value is hex or decimal depends on the
registry editor being used - the one in the MX3X requires decimal, but the desktop one
used over ActiveSync that a developer may use requires hex.
For Example
Default values: ScanCodeLeft = hex 83, decimal 131
ScanCodeRight = hex 84, decimal 132
Example:
KEYCOMP DEFAULT.KEY (writes KEYCOMP.REG to local directory)
Input File Compiler Text File
DEFAULT.KEY
Æ
KEYCOMP.EXE
Æ
KEYCOMP.REG
This output file should be renamed to xxx.REG (the suffix must remain REG), then copied to the
MX3X over ActiveSync. Once the file is loaded on the MX3X, double-click the file from the
Windows CE Explorer desktop. This will run the REGLOAD utility to put it into the registry, and
save the registry to non-volatile flash. The keymap is now a permanent part of the MX3X, and the
REG file is no longer needed unless it is necessary to perform a cold boot; this will return the
registry to factory defaults, and it will be necessary to double-click the REG file again.
Once the keymap has been added to the registry, it should appear in the Keyboard control panel,
in the Keymap popup menu. To activate the keymap, select the keymap from the popup menu, and
close the control panel with the OK button. To return to the default keymap, select
0409 from the
keymap popup and click OK.
The compiler has three functional stages:
•
First, the input file is read and parsed for any syntax errors. The data read is stored in
internal tables.
•
Second, the data parsed from the input file is validated to see that all of the items required
by the keyboard driver for normal operation are present.