ACS ACR83 PINeasy User manual

Subject to change without prior notice [e-mail]
www.acs.com.hk
Reference Manual V1.06
ACR83PINeasy

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 2 of 61
Table of Contents
1.0. Introduction .............................................................................................................4
1.1. Reference Documents...........................................................................................................4
1.2. Symbols and Abbreviations...................................................................................................4
2.0. Features ...................................................................................................................5
3.0. Supported Card Types............................................................................................6
4.0. Smart Card Interface...............................................................................................7
4.1. Smart Card Power Supply VCC (C1) ....................................................................................7
4.2. Programming Voltage VPP C6..............................................................................................7
4.3. Card Type Selection ..............................................................................................................7
4.4. Interface for Microcontroller-based Cards.............................................................................7
4.5. Card Tearing Protection.........................................................................................................7
5.0. Power Supply...........................................................................................................8
6.0. USB Interface...........................................................................................................9
6.1. Communication Parameters..................................................................................................9
6.2. Endpoints...............................................................................................................................9
7.0. Communication Protocol......................................................................................10
8.0. PC/SC SCardControl Application Programming Interface .................................12
8.1. Specific ScardControl ..........................................................................................................12
8.2. Smart Card Device IOCTLs.................................................................................................13
8.2.1. CM_IOCTL_GET_FEATURE_REQUEST..................................................................13
8.2.2. FEATURE_VERIFY_PIN_DIRECT.............................................................................14
8.2.3. FEATURE_MODIFY_PIN_DIRECT............................................................................16
8.2.4. FEATURE_IFD_PIN_PROP .......................................................................................18
8.2.5. IOCTL_SMARTCARD_GET_FIRMWARE_VERSION ...............................................19
8.2.6. IOCTL_SMARTCARD_DISPLAY_LCD_MESSAGE..................................................20
8.2.7. IOCTL_SMARTCARD_READ_KEY ...........................................................................20
9.0. Operation Flow for PIN Verification and Modification (PC/SC 2.0 Part 10)........22
10.0. CCID SPE Data Structure......................................................................................23
11.0. PIN Verification Data Structure.............................................................................24
11.1. Error Checking (Bit) .............................................................................................................25
11.2. Error Checking (Byte) ..........................................................................................................25
11.3. Verification Example 1.........................................................................................................26
11.4. Verification Example 2.........................................................................................................28
11.5. Verification Example 3.........................................................................................................29
12.0. PIN Modification Data Structure...........................................................................32
12.1. Modification (Bit) bConfirmPIN Bit1=0.................................................................................33
12.2. Modification (Bit) bConfirmPIN Bit1=0 Data Structure Error Checking ...............................34
12.3. Modification (Byte) bConfirmPIN Bit1=0..............................................................................34
12.4. Modification (Byte) bConfirmPIN Bit1=0 Data Structure Error Checking ............................34
12.5. Modification (Bit) bConfirmPIN Bit1=1.................................................................................34
12.6. Modification (Bit) bConfirmPIN Bit1=1 Data Structure Error Checking ...............................35
12.7. Modification (Byte) bConfirmPIN Bit1=1..............................................................................35
12.8. Modification (Byte) bConfirmPIN Bit1=1 Data Structure Error Checking ............................36
12.9. Modification Example 1........................................................................................................36
12.10. Modification Example 2........................................................................................................38
12.11. Modification Example 3........................................................................................................40
12.12. Modification Example 4........................................................................................................42
12.13. Modification Example 5........................................................................................................45

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 3 of 61
Appendix A. bmFormatString Description....................................................................49
Appendix B. bmPINBlockString Description................................................................50
Appendix C. bmPINLengthFormat ................................................................................51
Appendix D. Sample Code (PC/SC 2.0 Part 10) ............................................................52
Appendix E. Set bKeyReturnCondition.........................................................................60
Appendix F. Response Error Codes..............................................................................61
List of Figures
Figure 1 : PIN Verification and Modification Operation Flowchart .......................................................22

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 4 of 61
1.0.Introduction
The ACR83, a cost-effective PC-linked PIN-pad reader, serves as an interface for the communication
between a computer (for example, a PC) and a smart card. Different types of smart cards have
different commands and communication protocols, and the ACR83 PINeasy establishes a uniform
interface from the computer to the smart card for a wide variety of cards.
The ACR83 is connected to the computer through a USB interface and uses the CCID interface to
communicate with the USB port. CCID is the Device Class Specification for USB chip/Smart Card
Interface Devices, and defines the communication protocol and commands for the USB chip-card
interface devices.
Furthermore, the ACR83 supports CCID Secure PIN Entry (SPE) functionality which provides a
secure user interface for PIN entry without the danger of the PIN being observed by a third party.
ACR83 is a specific smart card reader which can do the PIN verification and modification in the card
reader.
This Reference Manual will provide the PC/SC APDU commands that are used to control the built-in
peripherals of the ACR83 device, and the data structures for secure PIN verification and modification.
1.1. Reference Documents
The following related documents are available from WWW.USB.ORG
•Universal Serial Bus Specification 2.0 (also referred to as the USB specification), April 27,
2000
•Universal Serial Bus Common Class Specification 1.0, December 16, 1997
•Universal Serial Bus Device Class: Smart Card CCID Specification for Integrated Circuit(s)
Cards Interface Devices, Revision 1.1, April 22, 2005
The following related documents can be ordered through WWW.ANSI.ORG
•ISO/IEC 7816-1; Identification Cards – Integrated circuit(s) cards with contacts - Part 1:
Physical Characteristics
•ISO/IEC 7816-2; Identification Cards – Integrated circuit(s) cards with contacts - Part 2:
Dimensions and Locations of the contacts
•ISO/IEC 7816-3; Identification Cards – Integrated circuit(s) cards with contacts - Part 3:
Electronic signals and transmission protocols
1.2. Symbols and Abbreviations
Symbol Abbreviation
ATR Answer-to-Reset
EMV Europay MasterCard VISA
PPS Protocol and Parameters Selection
SPE Secure PIN Entry
USB Universal Serial Bus

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 5 of 61
2.0.Features
•14-key keypad
•2 rows x 16 characters dot matrix LCD, each character has 5x8 dots
•Supports ISO 7816 Microprocessor Smart Cards with the following features:
oClass A, B, C (5 V, 3 V and 1.8 V respectively)
oT=0 and/or T=1 protocol
•Supports Secure PIN Entry (SPE)
•EMV Level 1 Certified
•Full-speed USB Interface (12 Mbps)
•Compliant to the following standards:
oPC/SC
oMicrosoft® WHQL
oCCID
oCE/FCC
oRoHS 2

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 6 of 61
3.0.Supported Card Types
The ACR83 supports MCU cards with either T=0 or T=1 protocol. The card ATR indicates the specific
operation mode (TA2 present; bit b5 of TA2 must be 0) and when that the particular mode is not
supported by the ACR83 PINeasy, the reader will reset the card to a negotiable mode. If the card
cannot be set to negotiable mode, the reader will then reject the card.
When the card ATR indicates the negotiable mode (TA2 not present) and communication parameters
other than the default parameters, the ACR83 will execute the PPS and try to use the communication
parameters that the card suggested in its ATR. If the card does not accept the PPS, the reader will
use the default parameters (F=372, D=1).
For the meaning of the aforementioned parameters, please refer to ISO 7816 Part 3.

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 7 of 61
4.0.Smart Card Interface
ACR83 PINeasy Smart Card Reader has a 14-key keypad and LCD display consisting of 2 rows with
16 characters dot matrix.
4.1. Smart Card Power Supply VCC (C1)
The current consumption of the inserted card must not be higher than 100 mA.
4.2. Programming Voltage VPP C6
According to ISO 7816-3, the smart card contact C6 (VPP) supplies the programming voltage to the
smart card. Since all common smart cards in the market are EEPROM-based and do not require the
provision of an external programming voltage, the contact C6 (VPP) has been implemented as a
normal control signal in the ACR83 (CCID). The electrical specifications of this contact are identical to
those of the signal RST (at contact C2).
4.3. Card Type Selection
The controlling PC always has to select the card type through the proper command sent to the ACR83
prior to activation the inserted card.
For MCU-based cards the reader allows to select the preferred protocol, T=0 or T=1. However, this
selection is only accepted and carried out by the reader through the PPS when the card inserted in
the reader supports both protocol types. Whenever an MCU-based card supports only one protocol
type, T=0 or T=1, the reader automatically uses that protocol type, regardless of the protocol type
selected by the application.
4.4. Interface for Microcontroller-based Cards
For microcontroller-based smart cards only the contacts C1 (VCC), C2 (RST), C3 (CLK), C5 (GND)
and C7 (I/O) are used. A frequency of 4 MHz is applied to the CLK signal (C3).
4.5. Card Tearing Protection
The ACR83 (CCID) provides a mechanism to protect the inserted card when it is suddenly withdrawn
while it is powered up. The power supply to the card and the signal lines between the ACR83 (CCID)
and the card are immediately deactivated when the card is being removed. As a general rule,
however, to avoid any electrical damage, a card should only be removed from the reader while it is
powered down.
Note: The ACR83 (CCID) does never, by itself, switch on the power supply to the inserted card. This
must be explicitly done by the controlling computer through the proper command sent to the reader.

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 8 of 61
5.0.Power Supply
The ACR83 (CCID) requires a voltage of 5 V DC, 100 mA regulated power supply. The ACR83
(CCID) gets the power from PC through the cable supplied along with each type of reader.

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 9 of 61
6.0.USB Interface
The ACR83 (CCID) is connected to a computer through a USB port following the USB standard.
6.1. Communication Parameters
The ACR83 (CCID) is connected to a computer through USB as specified in the USB Specification
1.1. The ACR83 (CCID) is working in full-speed mode, i.e. 12 Mbps.
Pin Signal Function
1VBUS +5 V power supply for the reader
2D- Differential signal transmits data between ACR83 and PC
3D+ Differential signal transmits data between ACR83 and PC
4GND Reference voltage level for power supply
Table 1: USB Interface Wiring
Note:ACR83 PINeasy is a PC/SC Device. In order for the ACR83 (CCID) to function properly
through USB interface, an ACS PC/SC driver has to be installed. Please refer to the Device Driver
Installation Guide for more details.
6.2. Endpoints
The ACR83 (CCID) uses the following endpoints to communicate with the host computer:
Control Endpoint For setup and control purpose
Bulk OUT For command to sent from host to ACR83 (CCID) (data packet size is 64
bytes)
Bulk IN For response to sent from ACR83 (CCID) to host (data packet size is 64
bytes)
Interrupt IN For card status message to sent from ACR83 (CCID) to host (data packet
size is 8 bytes)

ACR83 – Reference Manual [e-mail]
Version 1.06 www.acs.com.hk
Page 10 of 61
7.0.Communication Protocol
ACR83 (CCID) shall interface with the host with USB connection. A specification, namely CCID, has
been released within the industry defining such a protocol for the USB chip-card interface devices.
CCID covers all the protocols required for operating smart cards and PIN.
The configurations and usage of USB endpoints on ACR83 (CCID) shall follow CCID Section 3. An
overview is summarized below:
•Control Commands are sent on control pipe (default pipe). These include class-specific
requests and USB standard requests. Commands that are sent on the default pipe report
information back to the host on the default pipe.
•CCID Events are sent on the interrupt pipe.
•CCID Commands are sent on BULK-OUT endpoint. Each command sent to ACR83 (CCID)
has an associated ending response. Some commands can also have intermediate responses.
•CCID Responses are sent on BULK-IN endpoint. All commands sent to ACR83 (CCID) have
to be sent synchronously. (i.e. bMaxCCIDBusySlots is equal to 1 for ACR83 (CCID)).
The supported CCID features by ACR83 (CCID) are indicated in its Class Descriptor:
Offset Field Size Value Description
0 bLength 1 36h Size of this descriptor (in bytes)
1 bDescriptorType 1 21h CCID Functional Descriptor type
2 bcdCCID 2 0100h CCID Specification Release
Number in Binary-coded decimal
4 bMaxSlotIndex 1 00h One slot is available on ACR83
(CCID)
5 bVoltageSupport 1 07h ACR83 (CCID) can supply 1.8 V,
3.0 V and 5.0 V to its slot
6 dwProtocols 4 00000003h ACR83 (CCID) supports T=0 and
T=1 Protocol
10 dwDefaultClock 4 00000FA0h Default ICC clock frequency is 4
MHz
14 dwMaximumClock 4 00000FA0h Maximum supported ICC clock
frequency is 4 MHz
18 bNumClockSupported 1 00h Does not support manual setting
of clock frequency
19 dwDataRate 4 00002A00h Default ICC I/O data rate is
10752 bps
23 dwMaxDataRate 4 0001F808h Maximum supported ICC I/O
data rate is 250000 bps
27 bNumDataRatesSupported 1 00h Does not support manual setting
of data rates
28 dwMaxIFSD 4 00000Feh Maximum IFSD supported by ACR83 (CCID) for protocol T=1
is 254
32 dwSynchProtocols 4 00000000h ACR83 (CCID) does not support
synchronous card