Usb Communications; Usb Interface; About Usb Reports; Usb Keyboard Emulation - Magtek iDynamo 5 Gen III Programmer's Manual

2 - Connection Types
2.2

USB Communications

2.3

USB Interface

This USB device conforms to the USB specification revision 2.0 and Human Interface Device (HID) class
specification version 1.11. The device is set up as a full-speed, high-powered USB device that draws
power from the USB bus. iDynamo5 Gen III identifies itself to the USB host with MagTek's vendor ID
of 0x0801 and Product ID (PID) of 0x0020. All USB enumeration will include the device serial number.

2.3.1 About USB Reports

HID reports used by the host can be divided into two types:
•
Feature Reports, which the host uses to send commands to the device and receive responses using
Get Feature and Set Feature.
•
Input Reports are used by the device to send unsolicited notifications to the host when the device's
state changes, or to send asynchronous responses to the host when a command completes. The device
commonly uses input reports when reporting card swipes, device events, or when a command takes
more time for the device to process than is reasonable for the host to wait on a blocking call for the
device to acknowledge completion.

2.3.2 USB Keyboard Emulation

A device in KB mode identifies itself to the USB host as a keyboard and transmits data to the host as
ASCII as though it is being typed by a person on an actual keyboard. It does this by mapping each of the
possible ASCII characters in the stream to keystrokes. To send an ASCII character to the host, the device
looks up the ASCII character in the key and retrieves a combination of a single Key Usage which is a
unique value assigned to every keyboard key, and a Key Modifier Byte and sends them to the host. The
key modifier byte modifies the meaning of the key usage ID, by indicating whether any combination of
the right or left Ctrl , Shift
Definition for Human Interface Devices (HID)] are pressed at the same time as the key usage ID.
The device transmits ASCII 0 to 31 and 127 as their equivalent control code combinations. For example,
for a carriage return value 13 (0x0D), the device appears to the host as a keyboard where a person very
quickly presses and holds the
When the keymap contains a Key Usage ID and Key Modifier Byte of 0xFF for the ASCII value the
device wants to send, the device uses
simulates holding down the
character it wants to send. For example, to transmit the ASCII character '?' (063 decimal in the ASCII
table), the device sends keypad '0' combined with the
key modifier, then keypad '3' combined with the
with the
Left Alt

2.3.2.1 Commands and Responses

Feature reports are used to send commands and receive responses, even when KB mode is active.

2.3.2.2 Notifications (RFU)

Table 2-1 Notification in KB mode
Description
Message ID = "N001"
Notification Length
Notification
iDynamo 5 Gen III| Secure Card Reader | Programmer's Manual (COMMANDS)
, Alt or GUI keys [as defined by Universal Serial Bus (USB) Device Class
key, then presses the
Ctrl
Alt ASCII code keystrokes instead of key map values, meaning it
key on a keyboard and typing the three-digit decimal value of the ASCII
Alt
Type Txt Len Notes
Clear ASCII 4
Clear HEX 4
Clear Hex var
Page 10 of 48 (D998200587-101)
key, then releases both keys.
M
key modifier, then keypad '6' combined
Left Alt
key modifier.
Left Alt
Notification Msg ID in KB mode
Notification Length
Notification in ASCII-Hex