IDENTIVE TECHNOLOGIES AMID2US00 User Manual
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
Muullttii--IISS
M
UUsseerr M
O HHFF RReeaaddeerr –– UUSSBB
O
Maannuuaall
Erthalstrasse 1
Version: 1.6 Page 1 of 48
D - 55118 Mainz
Germany
Phone +49 (0) 61 31-30476-0
Fax +49 (0) 61 31-30 47 6-20
info@arygon.com • http://www.arygon.com
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
CONTENTS
1
GETTING STARTED...................................................................................................................................5
1.1 DRIVER INSTALLATION ................................................................................................ ...........................5
1.2 TROUBLE SHOOTING DRIVER INSTALLATION.........................................................................................8
2 DIAGNOSTICS......................................................................................................... .....................................9
2.1 DRIVER VERSION DETECTION............................................................................... ..................................9
2.2 FIRMWARE VERSION DETECTION.......... ................................................................................................11
3 CARD READER SUITE – TEST APPLICATION ........................... ... .... ... .. ... .... ... .. ..... .. .. ..... .. ... .... ... .. ..13
3.1 FIRMWARE DOWNLOAD ........................................................................................................................13
3.2 PCSC DIAGNOSTICS ...............................................................................................................................13
3.3 BINARY CONFIGURATION ......................................................................................................................14
4 PCSC 2.0...................................................... .. .. ..... .. ... .... ... .. ... .... ... .. ..... .. .. ... .... ... .. ..... .. ............................... ....15
4.1 HOW TO ACCESS CONTACTLESS CARDS VIA PCSC?......................................... ...................................15
4.1.1 Establish Context............................................. ............................. ............................ .......................15
4.1.2 List Readers ..................................... ................................................................................................15
4.1.3 Connect ................................................................................................................... .........................16
4.1.4 Data and Command transfer with Card..........................................................................................16
4.1.5 Disconnect........................................................................................................................................16
4.1.6 Release.............................................................................................................................................16
4.2 ATR GENERATION ................................................................................................................................17
4.2.1 CPU Cards.......................................................................................................................................17
4.2.2 Storage Cards ..................................................................................................................................17
5 ACCESSING READER THROUGH PCSC.............................. ..... .. .. ... .... ... .. ..... .. .. ... ..... .. .. ..... .. ... .. ..... .. ..18
5.1 READER CONTROL COMMANDS............................................................................................................18
5.1.1 Get Static RF Parameters.......................... .... ... .. .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... ... .. .. ..... .. ... .. ..... ...........18
5.1.2 Set Static RF Parameters......................................... .. .. ... .. ..... .. .. ... .... ... .. ... .... ... .. .. ... .... ... .. .. ..............19
5.1.3 Get Dynamic RF Parameters ..........................................................................................................19
5.1.4 Set Dynamic RF Parameters ........................................................ ...................................................19
5.1.5 RF Parameters Data Structure........................... ...................................................... .......................20
5.2 KEY MANAGEMENT ............................................................... ...............................................................23
5.2.1 Reader Authentication.............. ........................................................ ............................. ..................23
5.2.2 Load Keys................................................................................. ........................................................24
6 ACCESSING CARDS THROUGH PCSC.............................................................................................. ..26
6.1 MIFARE CARDS......................................................... .............................................................................26
6.1.1 Authenticate ............................ .........................................................................................................26
6.1.2 Write Binary............................................ ... .. .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... .. ... .. ..... .. ... .. .......................27
6.1.3 Read Binary ..................................... .. ..... ... .. .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... .. ... .. ..... .. ... .. ..... ..................27
6.1.4 Value Increment............................. .. .. ..... .. ... .. ... .... ... .. .. ..... .. ... .. ..... .. .. ... .. ..... .. ... .. ..... .. .. ... .. ................27
6.1.5 Value Decrement.............................. .. ... .. ..... .. ... .... ... .. .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... ... .. ..... .. ................28
6.2 ISO 15693 CARDS ................. ................................................................................................................29
6.2.1 Read Single Block................................................. ... .... ... .. .. ..... .. ... .. ..... .. ... .. .. ..... .. ... .. ..... .. ................29
6.2.2 Write Single Block .................................. ... .. ..... .. .. ... .. ..... .. .. ... .... ... .. .. ..... ... .. .. ... .... ... .. .. ..... .. ..............29
6.2.3 Lock Block...................................... .... ... .. .. ..... .. ... .. ..... .. ... .. ..... .. .. ... .... ... .. .. ... .... ... .. ... .... .....................29
6.2.4 Read Multiple Blocks.......................... .... ... .. .. ..... .. ... .. .. ..... .. ... .. .. ..... .. ... .. ... .... ... .. .. ..... .. ... .. .. ..............30
6.2.5 Write AFI .............................................. .. .. ..... ... .. .. ..... .. ... .. ..... .. .. ... .... ... .. ..... .. .. ... ..... .. .. .....................31
6.2.6 Write DSFID.................................................. ... .. .. ..... .. ... .... ... .. .. ..... .. ... .. ..... .. ... .. ..... .. .. ..... ................31
6.2.7 Get System Information:................................... .. .. ..... .. ... .. .. ..... .. ... .. ..... .. .. ... .. ..... .. .. ... ..... .. .. ... ...........31
6.2.8 Get Multiple Block Security Status:................................................................................................32
6.3 CRYPTO RF CARDS ...............................................................................................................................33
6.3.1 Set User Zone.............................. ... .. .. ..... .. ... .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... .. ... .. ..... .. ... .. ..... ..................33
6.3.2 Read User Zone ........................................ ... .. ... .. ..... .. .. ... .... ... .. .. ..... .. ... .. .. ..... ... .. .. ..... .. ... .. .. ..............33
Version: 1.6 Page 3 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
6.3.3 Write User Zone.......................... ... .... ... .. .. ..... ... .. ..... .. .. ... .... ... .. .. ..... .. ... .. ..... .. ... .... ... .. .. ..... ................33
6.3.4 Read System Zone............................................. .. .. ..... .. ... .. .. ..... .. ... .. ..... .. ... .. .. ..... .. ... .. ..... .. .. ..... .........34
6.3.5 Write System Zone ..................................... .. .. ..... .. ... .. ..... .. .. ... .... ... .. .. ..... ... .. .. ... .... ... .. .. ..... .. ..............34
6.3.6 Check Password.................................... ....................................................................................... ....34
6.4 DESFIRE CARDS .......................... .........................................................................................................35
6.5 GENERIC APDUS ..................................... .............................................................................................35
6.5.1 Get UID............................ .. .. ..... .. ... ..... .. .. ..... .. ... .. ..... .. .. ..... .. ... .... ... .. ..... .. ... .. ..... .. .. ..... .. ... ..................35
6.5.2 Traverse .................................... ..................................................................................... ..................35
6.6 STATUS WORD ......................................................................................................................................37
7 APDU SAMPLES TO ACCESS CARDS............ .......................................................... ............................38
7.1 HOW TO ACCESS MIFARE CLASSIC CARDS? ........................................................................................38
7.2 HOW TO ACCESS MIFARE UL CARDS? ............................ ....................................................................39
7.3 HOW TO ACCESS DESFIRE CARDS? .....................................................................................................40
7.3.1 DESFIRE EV1 Specific commands:...................................... ............................ ............................ ..43
7.4 HOW TO ACCESS ISO15693 CARDS? ............................. ........................................................................44
7.5 HOW TO ACCESS CRYPTO RF CARDS?.................................................. .................................................45
7.6 HOW TO ACCESS ICODE-SLI CARDS?..................................................................................................46
APPENDIX A TERMS AND ABBREVIATIONS.....................................................................................47
APPENDIX B REFERENCES........................................ .............................................................................48
Version: 1.6 Page 4 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
1 Getting Started
The Multi-IS O HF USB Reader /Writer i s a Desktop co ntactles s smart card/ tag reader an d writer
for accessing MIFARE, ISO14443-4 TypeA, ISO14443-4 TypeB, Mifare DESFire, Mifare DESFire EV1,
NFC tags and ISO 15693 tags. This document is intended for application developers who want to
access contactless cards using the Multi-ISO HF USB Reader/Writer.
Following sections explain how to install drivers for the Multi-ISO HF USB Reader/Writer in
Windows operating system (illustrations are taken from Windows XP, same being applicable for other
Windows versions).
1.1 Driver Installation
Drivers are necessary to access Multi-ISO HF USB Reader/Writer. The following steps illustrate
the installation procedure.
1. Plug in the reader in USB port
2. “Found New Hardware Wizard” will appear. Select “No, not this time” and c lick “Next” to
continue driver installation.
Version: 1.6 Page 5 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
3. In the next appearing dialog box, select “Install from a list or specific location (Advanced)”
and click on “ Next”
4. In next dialog box select “Search for the best driver in these locations” and “Search
removable media (floppy, CD-ROM…)” sub option. Insert the installation CD that is given
along with the reader kit and click “Next”.
Version: 1.6 Page 6 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
5. Wait until the driver installation is completed by the operating system and the installation
success dialog is displayed as shown below. Click “Finish”. Now the drivers are installed
successfully.
Version: 1.6 Page 7 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
1.2 Trouble Shooting Driver Installation
Device will not function properly if wrong driver is installed or if there is a version incompatibility
between the firmware and driver. In these cases, the installed driver must be uninstalled and proper
driver must be installed as explained below
Un-installation procedure is as follows.
1. Open the device manager -> Smart card readers and select “Multi-ISO HF Reader – USB”
2. Right click on “Multi-ISO HF Reader – USB” and select “Uninstall”
3. In the following dialog click “OK”.
4. The device will now disappear from the device manager
5. Un-plug and re-plug the device
6. System will prompt for drivers. Install the drivers as described in the driver installation
procedure section 1.1.
Version: 1.6 Page 8 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
2 Diagnostics
Version of the driver and firmware plays an important role in the proper working of the device.
Device may malfunction if incompatible drivers are installed for particular version of firmware. The
compatibility of the driver and firmware can be found in the “Document history” section of this
document.
2.1 Driver Version Detection
Driver version detectio n is described in the foll owing proce dure.
1. Right click on the “My Computer” icon and click on “Manage”
2. In following dialog, select “Device Manager” under “System Tools” menu in the left pane.
3. Double click on “Smart card readers ” in the right pane. Right click on “Multi-ISO HF Reader
- USB”, and select “Properties”.
Version: 1.6 Page 9 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
4. In the dialog box which appears, select the “Driver” tab, driver version can be found in the tab
window. For example, the driver version will appear as
“Driver Version: 1.0.2.0” for driver version 1.02
Version: 1.6 Page 10 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
2.2 Firmware Version Detection
To detect the current version of the firmware in the device, follow the same procedures as in the
Driver version detection up to step 3.
1. In the dialog box which appears, select “Details” tab. And in the drop down list box select
“Firmware Revision” as shown below.
Version: 1.6 Page 11 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
2. In the dialog box, the version of the firmware currently in the device will be displayed as
shown below
Version: 1.6 Page 12 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
3 Card Reader Suite – Test Application
CardRdrSuite is a test application that is provided along with Multi-ISO HF USB Reader/Writer
for customer use. CardRdrSuite consists of several sub-applications covering the following functions
3.1 Firmware Download
Reader firmware can be downloaded into the reader/writer using this sub-application. Salient
features are
• Auto reader detection
• User friendly GUI
• Provision to view device’s current firmware version and the version of the firmware to be
downloaded
The application operates in two modes
• DFU class mode
o Disaster recovery mode to recover reader if the reader is plugged out
accidentally during firmware download
o Individual DFU driver to handle this mode
• Proprietary mode
o Firmware download support without using the DFU driver
Refer to section “Firmware Download” of Card Reader Suite help file for detailed description.
Help file can be launched using the “Help” button in the main window of the Card Reader Suite
application.
3.2 Pcsc Diagnostics
Any Card APDU or Pseudo APD U can be issued and tested using this sub -application.
Salient features are
• APDU execution from script file (.APDU)
• Easy to edit script files
• Error status logging in a file
• Working sample scripts for each card type supported
Refer to section “Pcsc Diagnostics” of the Card Reader Suite help file for detailed description
Version: 1.6 Page 13 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
3.3 Binary configuration
All configurable parameters of the reader can be modified using these sub-applications. These
applications will configure the firmware binary file only.
Configure Binary
• Configures
o USB Chapter 09 parameters
o Firmware Version parameters
o Hardware Version parameters
o Other firmware configurations
• Provides option to make the parameters non-modifiable after config uring
Refer to section “Configure binary” of Card Reader Suite help file for detailed description
Edit Binary
• Configures
o RF parameters
o Mifare keys stored in the non-volatile memory of the reader
o DESFire keys stored in the non-volatile memory of the reader
• Provides option to make the parameters non-modifiable after config uring
Refer to section “Edit Binary” of Card Reader Suite help file for detailed description
Version: 1.6 Page 14 of 48
User_Manual - Multi-ISO_HF_Reader - USB_Ver1.6.doc- Confidential
4 PCSC 2.0
“Multi-ISO HF USB Reader/Writer” can be accessed using the standard PCSC architecture for
communicating with cards. This makes card access easy, as it uses the same communication
procedure for all the cards.
The Microsoft Developer Network (MSDN) library gives valuable information and a detailed
description of all SCard APIs for communicating with the reader, through the Windows PCSC
framework (WINSCARD APIs – Refer [R4]).
4.1 How to Access Contactless Cards via PCSC?
Contactless cards can be easily accessed through PCSC using standard WINSCARD smart
card API’s for card access. The following steps provide guidelines for using the PCSC compliant
WINSCARD API’s to access cards using the Multi-ISO HF USB Reader/Writer.
4.1.1 Establish Context
This is the first step. This API will initialize all other PCSC APIs and allocate all resources
necessary for a smart card session. The SCardEstablishContext function establishes the resource
manager context (the scope) within which database operations is performed.
LONG SCardEstablishContext ( IN DWORD dwScope,
IN LPCVOID pvReserved1,
IN LPCVOID pvReserved2,
OUT LPSCARDCONTEXT phContext);
4.1.2 List Readers
The next step is to get a list of all PCSC readers connected to the system using the
SCardListReaders function. Look for “Multi-ISO HF Reader – USB - 0000000000000001 0”, in the list
returned. If multiple Multi-ISO HF USB Reader/Writers are connected to your system, they will be
enumerated with different serial numbers.
Example: “Arygon Multi-ISO 0000000000000001 0”, “Arygon Multi-ISO 0000000000000002 0”, could
be the list returned when the following function is executed.
LONG SCardListReaders (IN SCARDCONTEXT *phContext,
IN LPCTSTR mszGroups,
OUT LPTSTR mszReaders,
IN OUT LPDWORD pcchReaders);
Note: The OUT parameter phContext of SCardEstablishContext is used as in parameter for this API.
Version: 1.6 Page 15 of 48
Loading...