SECTION 5
Communications and Device Support
PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide 5-31
Gold Shifted Keypress Definitions
Whenever the
[GOLD]
key is pressed, 13 bytes define the key number of the
logical keyboard. These bytes are referred to as a
keyboard macro
. The first
byte specifies the length of the macro. The second through 13th bytes provide a
combination of scan codes, break codes, or extended key codes. A keyboard
macro may consist of only one byte of code information.
Keyboard macros are invoked whenever you press the
[GOLD]
key and then
immediately press a second key. You can cancel a keyboard macro by (1)
pressing the gold key again before pressing any other key or (2) by releasing the
key that you pressed after you pressed the
[GOLD]
key. Keyboard macros may
continue to repeat as long as the second key is pressed and held.
Macros comprising only one byte of code information are treated as special keys.
There are five predefined specialĆkey macros processed internally to the H8:
"
Contrast up
"
Contrast down
"
Backlight on/off toggle
"
Increase backlight intensity
"
Decrease backlight intensity
The standard macros for the key numbers of the physical keyboard are defined
as follows. Key numbers not listed are undefined.
Key # Unshifted
Macro Codes Macro Length
1
Backlight Toggle
0x03
1
33
Contrast Up
0x01
1
41
Contrast Down
0x02
1
Macro Redefinition
The interface for keyboard macro redefinition is a call to INT 15h with the
following parameters:
On Entry:
ES:DX = Points to the 12Ćbyte macro definition
CL = Contains the length of the macro
BL = Contains the logical key position
BH = 14h (Define key macro function number)
AX = 5380h (OEM function call)
On Return:
AH = Nonzero if error
5. Communications
and Device Support