MagTek USB MagnePrint Swipe Reader with Encryption - Manual (Page 26)

USB MagnePrint Swipe Reader with Encryption
18
CARD DATA (HID)
The details about how the card data and commands are structured into HID reports follow later in
this section. Windows applications that communicate to this device can be easily developed.
These applications can communicate to the device using standard windows API calls that
communicate to the device using the standard Windows USB HID driver. These applications
can be easily developed using compilers such as Microsoft’s Visual Basic or Visual C++. A
demonstration program and its source code, written in Visual Basic, that communicates with this
device is available. This demo program can be used to test the device and it can be used as a
guide for developing other applications. More details about the demo program follow later in
this document.
It is recommended that application software developers become familiar with the HID
specification the USB specification before attempting to communicate with this device. This
document assumes that the reader is familiar with these specifications. These specifications can
be downloaded free from
www.usb.org .
Card data is only sent to the host on the Interrupt In pipe using an Input Report. The device will
send only one Input Report per card swipe. If the host requests data from the device when no
data is available, the device will send a NAK to the host to indicate that it has nothing to send.
When a card is swiped, the Input Report will be sent even if the data is not decodable. The
following table shows how the input report is structured.
Offset Usage Name
0 Track 1 decode status
1 Track 2 decode status
2 Track 3 decode status
3 Track 1 data length
4 Track 2 data length
5 Track 3 data length
6 Card encode type
7 – 118 Track 1 data
119 – 230 Track 2 data
231 - 342 Track 3 data
343 Card status
344 – 347 MagnePrint status
348 MagnePrint data length
349 - 476 MagnePrint data
477 – 492 Device serial number
493 – 500 Sequence counter
501-502 Reader Encryption Status
503-522 Masked PAN
523-549 Cardholder Name
550-554 Expiration Date
555-564 DUKPT serial number/counter