MagTek USB MagnePrint Swipe Reader with Encryption User Manual
USB MAGNEPRINT SWIPE READER
WITH ENCRYPTION
TECHNICAL REFERENCE MANUAL
PART NUMBER 99875338-3
MARCH 2009
REGISTERED TO ISO 9001:2000
1710 Apollo Court
Seal Beach, CA 90740
Phone: (562) 546-6400
FAX: (562) 546-6301
Technical Support: (651) 415-6800
www.magtek.com
Copyright© 2001-2009
MagTek®, Inc.
Printed in the United States of America
Information in this document is subject to change without notice. No part of this document may be reproduced
or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express
written permission of MagTek, Inc.
MagTek is a registered trademark of MagTek, Inc.
USB (Universal Serial Bus) Specification is Copyright© 1998 by Compaq Computer Corporation, Intel
Corporation, Microsoft Corporation, NEC Corporation.
Appendix A is taken from Universal Serial Bus HID Usage Tables, Version 1.12, Section 10, Keyboard/Keypad
Page (0x07) ©1996-2005 USB Implementers’ Forum
Appendix B is taken from Section 8.3 Report Format for Array Items, Device Class Definition for Human
Interface Devices (HID) Version 1.11, ©1996-2001 USB Implementers’ Forum, hidcomments@usb.org
REVISIONS
Rev Number Date Notes
1 5 May 06 Initial Release
2 14 Sep 07 Corrected default setting for polling interval
3 9 Mar 09 Updated MagnePrint Status; updated Warranty and
Agency information
ii
LIMITED WARRANTY
MagTek warrants that the products sold pursuant to this Agreement will perform in accordance with MagTek’s published
specifications. This warranty shall be provided only for a period of one year from the date of the shipment of the product
from MagTek (the “Warranty Period”). This warranty shall apply only to the “Buyer” (the original purchaser, unless that
entity resells the product as authorized by MagTek, in which event this warranty shall apply only to the first repurchaser).
During the Warranty Period, should this product fail to conform to MagTek’s specifications, MagTek will, at its option,
repair or replace this product at no additional charge except as set forth below. Repair parts and replacement products will
be furnished on an exchange basis and will be either reconditioned or new. All replaced parts and products become the
property of MagTek. This limited warranty does not include service to repair damage to the product resulting from
accident, disaster, unreasonable use, misuse, abuse, negligence, or modification of the product not authorized by MagTek.
MagTek reserves the right to examine the alleged defective goods to determine whether the warranty is applicable.
Without limiting the generality of the foregoing, MagTek specifically disclaims any liability or warranty for goods resold
in other than MagTek’s original packages, and for goods modified, altered, or treated without authorization by MagTek.
Service may be obtained by delivering the product during the warranty period to MagTek (1710 Apollo Court, Seal
Beach, CA 90740). If this product is delivered by mail or by an equivalent shipping carrier, the customer agrees to insure
the product or assume the risk of loss or damage in transit, to prepay shipping charges to the warranty service location,
and to use the original shipping container or equivalent. MagTek will return the product, prepaid, via a three (3) day
shipping service. A Return Material Authorization (“RMA”) number must accompany all returns. Buyers may obtain an
RMA number by contacting Technical Support at (888) 624-8350.
EACH BUYER UNDERSTANDS THAT THIS MAGTEK PRODUCT IS OFFERED AS
IS.
MAGTEK MAKES NO OTHER WARRANTY, EXPRESS OR IMPLIED, AND
MAGTEK DISCLAIMS ANY WARRANTY OF ANY OTHER KIND, INCLUDING
ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE.
IF THIS PRODUCT DOES NOT CONFORM TO MAGTEK’S SPECIFICATIONS, THE SOLE REMEDY SHALL BE
REPAIR OR REPLACEMENT AS PROVIDED ABOVE. MAGTEK’S LIABILITY, IF ANY, SHALL IN NO EVENT
EXCEED THE TOTAL AMOUNT PAID TO MAGTEK UNDER THIS AGREEMENT. IN NO EVENT WILL
MAGTEK BE LIABLE TO THE BUYER FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST
SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF, OR
INABILITY TO USE, SUCH PRODUCT, EVEN IF MAGTEK HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
LIMITATION ON LIABILITY
EXCEPT AS PROVIDED IN THE SECTIONS RELATING TO MAGTEK’S LIMITED WARRANTY, MAGTEK’S
LIABILITY UNDER THIS AGREEMENT IS LIMITED TO THE CONTRACT PRICE OF THIS PRODUCT.
MAGTEK MAKES NO OTHER WARRANTIES WITH RESPECT TO THE PRODUCT, EXPRESSED OR IMPLIED,
EXCEPT AS MAY BE STATED IN THIS AGREEMENT, AND MAGTEK DISCLAIMS ANY IMPLIED
WARRANTY, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTY OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE.
MAGTEK SHALL NOT BE LIABLE FOR CONTINGENT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES TO
PERSONS OR PROPERTY. MAGTEK FURTHER LIMITS ITS LIABILITY OF ANY KIND WITH RESPECT TO
THE PRODUCT, INCLUDING ANY NEGLIGENCE ON ITS PART, TO THE CONTRACT PRICE FOR THE
GOODS.
MAGTEK’S SOLE LIABILITY AND BUYER’S EXCLUSIVE REMEDIES ARE STATED IN THIS SECTION AND
IN THE SECTION RELATING TO MAGTEK’S LIMITED WARRANTY.
iii
FCC WARNING STATEMENT
This equipment has been tested and was found to comply with the limits for a Class B digital device pursuant to Part 15 of
FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment
is operated in a residential environment. This equipment generates, uses, and can radiate radio frequency energy and, if
not installed and used in accordance with the instruction manual, may cause harmful interference with radio
communications. However, there is no guarantee that interference will not occur in a particular installation.
FCC COMPLIANCE STATEMENT
This device complies with Part 15 of the FCC Rules. Operation of this device is subject to the following two conditions:
(1) this device may not cause harmful interference, and (2) this device must accept any interference received, including
interference that may cause undesired operation.
CANADIAN DOC STATEMENT
This digital apparatus does not exceed the Class B limits for radio noise from digital apparatus set out in the Radio
Interference Regulations of the Canadian Department of Communications.
Le présent appareil numérique n’émet pas de bruits radioélectriques dépassant les limites applicables aux appareils
numériques de la classe B prescrites dans le Réglement sur le brouillage radioélectrique édicté par le ministère des
Communications du Canada.
This Class B digital apparatus complies with Canadian ICES-003.
Cet appareil numériqué de la classe B est conformé à la norme NMB-003 du Canada.
CE STANDARDS
Testing for compliance with CE requirements was performed by an independent laboratory. The unit under test was
found compliant with standards established for Class B devices.
UL/CSA
This product is recognized per Underwriter Laboratories and Canadian Underwriter Laboratories 1950.
RoHS STATEMENT
When ordered as RoHS compliant, this product meets the Electrical and Electronic Equipment (EEE) Reduction of
Hazardous Substances (RoHS) European Directive 2002/95/EC. The marking is clearly recognizable, either as written
words like “Pb-free”, “lead-free”, or as another clear symbol ( ).
iv
TABLE OF CONTENTS
SECTION 1. FEATURES AND SPECIFICATIONS..................................................................................................1
FEATURES............................................................................................................................................................2
HARDWARE CONFIGURATION ..........................................................................................................................2
ACCESSORIES.....................................................................................................................................................2
REFERENCE DOCUMENTS................................................................................................................................3
SPECIFICATIONS.................................................................................................................................................4
SECTION 2. INSTALLATION...................................................................................................................................7
USB CONNECTION..............................................................................................................................................7
WINDOWS PLUG AND PLAY SETUP..................................................................................................................8
MOUNTING ...........................................................................................................................................................8
SECTION 3. OPERATION......................................................................................................................................11
LED INDICATOR.................................................................................................................................................11
CARD READ........................................................................................................................................................11
SECTION 4. USB COMMUNICATIONS.................................................................................................................13
HID USAGES.......................................................................................................................................................13
MAGNETIC STRIPE READER USAGE PAGE (HID) .........................................................................................14
REPORT DESCRIPTOR (HID)............................................................................................................................14
MAGNETIC STRIPE READER USAGE PAGE (KB)........................................................................................... 16
REPORT DESCRIPTOR (KB).............................................................................................................................17
CARD DATA (HID) ..............................................................................................................................................18
Track 1 Decode Status....................................................................................................................................19
Track 2 Decode Status....................................................................................................................................19
Track 3 Decode Status....................................................................................................................................19
Track 1 Data Length........................................................................................................................................ 19
Track 2 Data Length........................................................................................................................................ 19
Track 3 Data Length........................................................................................................................................ 19
Card Encode Type...........................................................................................................................................19
Track Data.......................................................................................................................................................20
Track 1 Data....................................................................................................................................................20
Track 2 Data....................................................................................................................................................20
Track 3 Data....................................................................................................................................................20
Card Status......................................................................................................................................................20
MagnePrint Status...........................................................................................................................................21
MagnePrint Data Length..................................................................................................................................21
MagnePrint Data..............................................................................................................................................21
Device Serial Number......................................................................................................................................22
Sequence Counter...........................................................................................................................................22
CARD DATA (KB)................................................................................................................................................22
Reader Encryption Status................................................................................................................................23
PROGRAMMABLE CONFIGURATION OPTIONS.............................................................................................24
Low Level Communications.............................................................................................................................24
COMMANDS .......................................................................................................................................................24
COMMAND NUMBER.........................................................................................................................................24
DATA LENGTH....................................................................................................................................................25
DATA ...................................................................................................................................................................25
RESULT CODE...................................................................................................................................................25
GET AND SET PROPERTY COMMANDS ......................................................................................................... 25
SOFTWARE_ID PROPERTY..............................................................................................................................27
USB_SERIAL_NUM PROPERTY .......................................................................................................................27
POLLING_INTERVAL PROPERTY.....................................................................................................................28
MAX_PACKET_SIZE PROPERTY (HID)............................................................................................................29
TRACK_ID_ENABLE PROPERTY......................................................................................................................30
TRACK_DATA_SEND_FLAGS PROPERTY (KB)..............................................................................................31
v
TERMINATION_CHAR PROPERTY (KB)...........................................................................................................32
SS_TK2_7BITS PROPERTY (KB)......................................................................................................................32
SS_TK3_ISO_ABA PROPERTY (KB).................................................................................................................33
SS_TK3_AAMVA PROPERTY (KB)....................................................................................................................33
SS_TK3_7BITS PROPERTY (KB)......................................................................................................................33
PRE_CARD_CHAR PROPERTY (KB)................................................................................................................34
POST_CARD_CHAR PROPERTY (KB) .............................................................................................................34
PRE_TK_CHAR PROPERTY (KB) .....................................................................................................................34
POST_TK_CHAR PROPERTY (KB)...................................................................................................................35
ASCII_TO_KEYPRESS_CONVERSION_TYPE PROPERTY (KB).................................................................... 35
INTERFACE_TYPE PROPERTY........................................................................................................................36
ACTIVE_KEYMAP PROPERTY (KB)..................................................................................................................37
PRE_CARD_STRING PROPERTY (KB) ............................................................................................................ 38
POST_CARD_STRING PROPERTY (KB).......................................................................................................... 38
SS_TK1_ISO_ABA PROPERTY (KB).................................................................................................................39
SS_TK2_ISO_ABA PROPERTY (KB).................................................................................................................39
ES PROPERTY (KB)...........................................................................................................................................40
FS PROPERTY (KB)...........................................................................................................................................40
DEVICE_SERIAL_NUM PROPERTY .................................................................................................................41
SEQUENCE_COUNTER PROPERTY................................................................................................................41
RESET_DEVICE COMMAND .............................................................................................................................42
GET_KEYMAP_ITEM COMMAND (KB) .............................................................................................................42
SET_KEYMAP_ITEM COMMAND (KB)..............................................................................................................43
SAVE_CUSTOM_KEYMAP COMMAND (KB)....................................................................................................45
ENCRYPTION KEYS...........................................................................................................................................46
Load DUKPT Initial Key...................................................................................................................................46
Reinitialize DUKPT Key...................................................................................................................................47
Report DUKPT KSN and Counter...................................................................................................................48
SECTION 5. DEMO PROGRAM.............................................................................................................................51
INSTALLATION...................................................................................................................................................51
OPERATION........................................................................................................................................................51
SOURCE CODE..................................................................................................................................................52
APPENDIX A. KEYBOARD USAGE ID DEFINITIONS.........................................................................................53
KEYBOARD/KEYPAD PAGE (0X07)..................................................................................................................53
APPENDIX B. MODIFIER BYTE DEFINITIONS.................................................................................................... 61
APPENDIX C. GUIDE ON DECRYPTING DATA...................................................................................................63
TABLES AND FIGURES
Figure 1-1. USB MagnePrint Swipe Reader with Encryption................................................................................. viii
Table 1-2. Specifications........................................................................................................................................ 4
Figure 1-2. Dimensions..........................................................................................................................................5
Figure 2-1. Reader Cable and Connector.............................................................................................................. 7
Table 2-1. 4-Pin Connector.................................................................................................................................... 7
Figure 2-2. Mounting Hole Dimensions.................................................................................................................. 9
Table A-1. Keyboard/Keypad................................................................................................................................. 53
Table B-1. Modifier Byte......................................................................................................................................... 61
vi
vii
viii
Figure 1-1. USB MagnePrint Swipe Reader with Encryption
SECTION 1. FEATURES AND SPECIFICATIONS
The USB (Universal Serial Bus) Swipe Reader is a compact magnetic stripe card reader that
conforms to ISO standards. In addition to reading three tracks of data from a card, this Reader
also includes MagnePrint technology. The MagnePrint data will be included with the track data
on each transaction. In order to maximize card security, this model of the Reader incorporates
data encryption to protect the card contents and MagnePrint information. The Reader is
compatible with any device having a host USB interface. A card is read by sliding it, stripe
down and facing the LED side, through the slot either forward or backward.
An LED (Light Emitting Diode) indicator on the Reader panel provides the operator with
continuous status of the Reader operations.
The reader conforms to the USB HID (Human Interface Device) Class specification Version 1.1.
This allows host applications designed for most versions of Windows to easily communicate to
the device using standard Windows API calls that communicate to the device through the HID
driver that comes with Windows.
The Reader can be operated in two different modes:
• HID (herein referred to as “HID mode”) and
• HID with Keyboard Emulation (herein referred to as “KB mode”)
When operating in the HID mode, this device will not use keyboard emulation. It behaves like a
vendor defined HID device so that a direct communication path can be established between the
host application and the device, without interference from other HID devices.
When configured for the Keyboard Emulation (KB) mode, the Reader emulates a USB HID
United States keyboard or, optionally, any international keyboard using ALT ASCII code keypad
key combinations or customizable key maps. This allows host applications designed to acquire
card data from keyboard input to seamlessly acquire the card data from the USB swipe reader.
Caution
When in Keyboard Emulation mode, if another keyboard is connected to
the same host as this device and a key is pressed on the other keyboard
while this device is transmitting, then the data transmitted by this device
may get corrupted.
When a card is swiped through the Reader, the track data and MagnePrint information will be
TDEA (Triple Data Encryption Algorithm, aka, Triple DES) encrypted using DUKPT (Derived
Unique Key Per Transaction) key management. This method of key management uses a base
derivation key to encrypt a key serial number that produces an initial encryption key which is
injected into the Reader prior to deployment. After each transaction, the encryption key is
modified per the DUKPT algorithm so that each transaction uses a unique key. Thus, the data
will be encrypted with a different encryption key for each transaction.
1
USB MagnePrint Swipe Reader with Encryption
FEATURES
Major features of the Swipe Reader are as follows:
• Powered through the USB – no external power supply required
• Hardware Compatible with a PC or any computer or terminal having a USB interface
• Bi-directional card reading
• Reads encoded data that meets ANSI/ISO/AAMVA standards and some custom formats such
as ISO track 1 format on track 2 or 3
• Reads up to three tracks of card data
• Red/Green LED for status
• Compatible with USB specification Revision 1.1
• Compatible with HID specification Version 1.1
• Can use standard Windows HID driver for communications; no third party device driver is
required
• Programmable USB serial number descriptor
• Programmable USB Interrupt In Endpoint polling interval
• Programmable Keyboard Table to support alternate languages
• Non-volatile memory for property storage
• Built-in 6 foot USB cable
• Supplies 54 byte MagnePrint™ value
• Includes Device serial number and Sequence counter
• Encrypts all track data and the MagnePrint value
• Provides clear text confirmation data including card holder’s name, expiration date, and a
portion of the PAN
HARDWARE CONFIGURATION
The hardware configuration is as follows:
Part Number Tracks Configuration Cable
21073008 TK 1,2,3
21073023 TK 1,2,3 Black Mini 6’ USB-A
ACCESSORIES
The accessories are as follows:
Part Number Description
21042806 USB MSR Demo Program with Source Code (Diskette)
99510026 USB MSR Demo Program with Source Code (WEB)
2
Gray Full
Size
6’ USB-A
Section 1. Features and Specifications
REFERENCE DOCUMENTS
Axelson, Jan. USB Complete, Everything You Need to Develop Custom USB Peripherals, 1999.
Lakeview Research, 2209 Winnebago St., Madison WI 53704, 396pp., http://www.lvr.com.
ANS X9.24-2004 Retail Financial Services Symmetric Key Management Part 1: Using
Symmetric Techniques
USB Human Interface Device (HID) Class Specification Version 1.1.
Universal Serial Bus (USB): HID Usage Tables Version 1.12 (1/21/2005)
USB (Universal Serial Bus) Specification, Version 1.1, Copyright© 1998 by Compaq Computer
Corporation, Intel Corporation, Microsoft Corporation, NEC Corporation.
USB Implementers Forum, Inc., www.usb.org.
3
USB MagnePrint Swipe Reader with Encryption
SPECIFICATIONS
Table 1-2 lists the specifications for the USB Swipe Reader. Figure 1-2 shows the dimensions
for the Reader.
Table 1-2. Specifications
Reference Standards ISO 7810 and ISO 7811/ AAMVA*
Power Input 5V From USB bus
Recording Method Two-frequency coherent phase (F2F)
Message Format ASCII
Card Speed 4 to 60 ips (10.1 to 152.4 cm/s)
ELECTRICAL
Current
Normal Mode
(including power-up)
Suspend Mode
Dimensions Length 6.50” (165.1mm)
Weight 6.5 oz. (184.3 gr)
Cable length 6 ft.
Connector USB Type A plug
Dimensions
Weight 4.7 oz. (133.2 gr)
Cable length 6 ft.
Connector USB Type A plug
Temperature
Operating 0 °C to 70 °C (32 oF to 158 oF)
Storage -40 oC to 70 oC (-40 oF to 158 oF)
Humidity
Operating 10% to 90% noncondensing
Storage 10% to 90% noncondensing
Altitude
Operating 0-10,000 ft. (0-3048 m.)
Storage 0-50,000 ft. (0-15240 m.)
* ISO (International Standards Organization) and AAMVA (American Association of Motor Vehicle
Administrators).
100mA maximum
500uA maximum
MECHANICAL- Full Size
Width 1.74” (44.2mm)
Height 1.50” (38.1mm)
Length 3.94” (100.0mm)
Width 1.28” (32.5mm)
Height 1.23” (31.3mm)
MECHANICAL – Mini
ENVIRONMENTAL
4
Section 1. Features and Specifications
Figure 1-2. Dimensions
5
USB MagnePrint Swipe Reader with Encryption
6
SECTION 2. INSTALLATION
This section describes the cable connection, the Windows Plug and Play Setup, and the physical
mounting of the unit.
USB CONNECTION
Connect the USB cable to a USB port on the host. The Reader, LED Indicator, and pin numbers for the
4-pin connector are shown in Figure 2-1.
Figure 2-1. Reader Cable and Connector
Pin numbers and signal descriptions for the cable shown in the illustration are listed in Table 2-1.
Table 2-1. 4-Pin Connector
Pin Number Signal Cable Color
1 VBUS Red
2 - Data White
3 +Data Green
4 Ground Black
7
USB MagnePrint Swipe Reader with Encryption
WINDOWS PLUG AND PLAY SETUP
On hosts with the Windows operating system, the first time the device is plugged into a specific USB
port, Windows will pop up a dialog box, which will guide you through the process of installing a device
driver for the device. After this process is completed once, Windows will no longer request this process
as long as the device is plugged into the same USB port. The device driver that Windows will install for
this device is the driver used for HID devices and it is part of the Windows operating system. When the
dialog box pops up, follow the instructions given in the dialog box. Sometimes Windows will find all the
files it needs on its own without giving any prompts. Other times Windows will need to know the
location of the files it needs. If Windows prompts for the file locations, insert the CD that was used to
install Windows on your PC and point Windows to the root directory of the CD. Windows should find
all the files it needs there.
MOUNTING
The Reader may be mounted with screws or fastening tape as described below.
1. The Reader can be mounted on a surface in various ways:
• By two screws through the surface attached to the bottom of the unit and running the cable on
the top of the surface
• By two screws through the surface attached to the bottom of the unit and by drilling a hole in
the surface for the cable and running the cable through the hole
• By attaching the unit to the surface with fastening tape and running the cable on the top of the
surface
Note
The two mounting inserts are 3mm diameter, 0.5mm pitch, 6.4mm deep.
The length of the screws used depends on the mounting surface thickness
and the thickness of washers (if used).
The mounting dimensions are shown in Figure 2-2. Determine the method of mounting required.
8
Section 2. Installation
Figure 2-2. Mounting Hole Dimensions
2. Ensure the Reader is positioned on a flat, accessible surface with at least 4 inches clearance on
either end for room to swipe a card. Orient the Reader so the side with the LED is facing the
direction of intended use.
If fastening tape is to be used, clean the area that the Reader will be mounted on with isopropyl
alcohol. Remove the adhesive protective cover on the fastening tape, and position the Reader and
push down firmly.
3. Mount the Reader.
9
USB MagnePrint Swipe Reader with Encryption
10
SECTION 3. OPERATION
This section describes the LED Indicator and Card Read operation.
LED INDICATOR
The LED indicator will be either off, red, or green. When the device is not powered, the LED
will be off. When the device is first plugged in, the LED will be red. As soon as the device is
plugged in, the host will try to enumerate the device. Once the device is enumerated the LED
will turn green indicating that the device is ready for use. When a card is being swiped, the LED
will turn off temporarily until the swipe is completed. If there are no errors after decoding the
card data then the LED will turn green. If there are any errors after decoding the card data, the
LED will turn red for approximately two seconds to indicate that an error occurred and then turn
green. Anytime the host puts the device into suspend mode, the LED will turn off. Once the
host takes the device out of suspend mode, the LED will return to the state it was in p rior to
entering suspend mode.
The LED will blink green if the MagnePrint circuit is sensing excessive electrical noise in the
environment. If this occurs, the reader will still read cards and send card data to the host until it
is moved away from the noise source at which time the LED will stop blinking and stay green.
When this occurs, re-position the reader away from the noise source. Note that the reader will not
check for noise until after a card swipe occurs. So a card has to be swiped to initiate noise
detection. If noise is detected after the swipe, the reader will continue to check for noise until the
noise is no longer present. If no noise is detected after the swipe, the reader will not check for
noise again until after the next swipe.
CARD READ
A card may be swiped through the Reader slot when the LED is green. The magnetic stripe must
face toward the front (the side with the LED) and may be swiped in either direction. If there is
data encoded on the card, the device will attempt to decode the data and then send the results to
the host via a USB HID input report or, if in Keyboard Emulation mode, as if the data was being
typed on a keyboard. After the results are sent to the host, the device will be ready to read the
next card.
11
USB MagnePrint Swipe Reader with Encryption
12
SECTION 4. USB COMMUNICATIONS
This device conforms to the USB specification revision 1.1. This device also conforms to the
Human Interface Device (HID) class specification version 1.1. The device communicates to the
host either as a vendor-defined HID device or as a HID Keyboard Emulation device. (Refer to
Interface_Type Property
Windows operating system come with standard Windows USB drivers that will support both
modes.
The device has an adjustable endpoint descriptor polling interval value that can be set to any
value in the range of 1ms to 255ms. This property can be used to speed up or slow down the
card data transfer rate. The device also has an adjustable serial number descriptor. More details
about these properties can be found later in this document in the command section.
The device will go into suspend mode when directed to do so by the host. The device will wake
up from suspend mode when directed to do so by the host. The device does not support remote
wakeup.
This is a full speed USB device. It is powered from the USB bus. The vendor ID is 0x0801.
The product ID is 0x000E when in the HID mode and 0x0001 when in the Keyboard Emulation
mode.
Since there are two modes of operation, there are some properties and commands that are
exclusive to one of the two modes. Where a property or command is unique, it will be identified
with either HID or KB. Properties and commands that are common to both modes do not
include any modifier.
HID USAGES
for information on how to change modes.) The latest versions of the
HID devices send data in reports. Elements of data in a report are identified by unique identifiers
called usages. The structure of the device’s reports and the device’s capabilities are reported to
the host in a report descriptor. The host usually gets the report descriptor only once, right after
the device is plugged in. The report descriptor usages identify the devices capabilities and report
structures. For example, a device could be identified as a keyboard by analyzing the device’s
report descriptor. Usages are four byte integers. The most significant two bytes are called the
usage page and the least significant two bytes are called usage IDs. Usages that are related can
share a common usage page. Usages can be standardized or they can be vendor defined.
Standardized usages such as usages for mice and keyboards can be found in the HID Usage
Tables document and can be downloaded free at www.usb.org
. Vendor-defined usages must
have a usage page in the range 0xFF00 – 0xFFFF. All usages for this device use vendor-defined
magnetic stripe reader usage page 0xFF00. The usage IDs for this device are defined in the
following tables. The usage types are also listed. These usage types are defined in the HID
Usage Tables document.
13
USB MagnePrint Swipe Reader with Encryption
MAGNETIC STRIPE READER USAGE PAGE (HID)
Magnetic Stripe Reader usage page 0xFF00:
Usage ID
(Hex)
1 Decoding reader device Collect
20 Track 1 decode status Data Input
21 Track 2 decode status Data Input
22 Track 3 decode status Data Input
23 MagnePrint status Data Input
28 Track 1 data length Data Input
29 Track 2 data length Data Input
2A Track 3 data length Data Input
2B MagnePrint data length Data Input
30 Track 1 data Data Input
31 Track 2 data Data Input
32 Track 3 data Data Input
33 MagnePrint data Data Input
38 Card encode type Data Input
39 Card status Data Input
40 Device serial number Data Input
41 Sequence counter Data Input
42 Reader Encryption Status Data Input
42 Masked PAN Data Input
43 Cardholder Name Data Input
44 Expiration Date Data Input
45 DUKPT serial number/counter Data Input
20 Command message Data Feature
Usage Name Usage
Type
ion
Report
Type
None
REPORT DESCRIPTOR (HID)
The Report Descriptor is structured as follows:
Item
Usage Page (Magnetic Stripe Reader) 06 00 FF
Usage (Decoding reader device) 09 01
Collection (Application) A1 01
Logical Minimum (0) 15 00
Logical Maximum (255) 26 FF 00
Report Size (8) 75 08
Usage (Track 1 decode status) 09 20
Usage (Track 2 decode status) 09 21
Usage (Track 3 decode status) 09 22
Usage (Track 1 data length) 09 28
Usage (Track 2 data length) 09 29
Usage (Track 3 data length) 09 2A
Usage (Card encode type) 09 38
14
Value
(Hex)
Loading...