Set_keymap_item command (kb) – MagTek USB MagnePrint Swipe Reader with Encryption User Manual

Page 51

Advertising
background image

Section 4. USB Communications

43

Starting with the firmware release with software ID 21042812F01, when
both the key usage ID and the key modifier byte are set to 0xFF for a
given ASCII value, the ALT ASCII code is sent instead of the key map
values. The ALT ASCII code is a key press combination consisting of the
decimal value of the ASCII character combined with the ALT key
modifier. For example, to transmit the ASCII character ‘?’ (063 decimal),
keypad ‘0’ is sent combined with left ALT key modifier, next keypad ‘6’
is sent combined with the left ALT key modifier, last keypad ‘3’ is sent
combined with the left ALT key modifier.

Data structure:

Request Data:

Offset Field

Name

Description

0

ASCII value

Value of the ASCII character to be
retrieved from the key map. This can be
any value between 0 and 127 (0x7F). For
example, to retrieve the key map item for
ASCII character ‘?’ (card data end
sentinel) use the ASCII value of ‘?’ which
is 63 (0x3F).

Response Data:

Offset Field

Name

Description

0

Key Usage ID

The value of the USB key usage ID that is
mapped to the given ASCII value. For
example, for the United States keyboard
map, usage ID 56 (0x38) (keyboard / and
?) is mapped to ASCII character ‘?’.

1

Key Modifier Byte The value of the USB key modifier byte

that is mapped to the given ASCII value.
For example, for the United States
keyboard map, modifier byte 0x02 (left
shift key) is mapped to ASCII character ‘?’.


Result codes:

0 (success)


Example Request (Hex):

Cmd Num

Data Len

Data

03 01

3F

Example Response (Hex):

Result Code Data Len

Data

00 02

38

02


SET_KEYMAP_ITEM COMMAND (KB)

Command number:

4

Description:

This command is used to set a key map item of the active key map. The
active key map is determined by the active key map property. Data from a
magnetic stripe card is a sequence of ASCII characters. These ASCII
characters are mapped to key strokes and these key strokes are sent to the

Advertising