ACS APG8201-B2 User manual

Subject to change without prior notice [email protected].hk
www.acs.com.hk
Reference Manual v1.00
APG8201-B2

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 2 of 48
www.acs.com
.hk
Revision History
Release Date
Revision Description
Version Number
2018-06-25
●Initial Release
1.00

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 3 of 48
www.acs.com
.hk
Table of Contents
1.0. Introduction .............................................................................................................5
2.0. Features...................................................................................................................6
3.0. Supported Card Types............................................................................................7
4.0. Smart Card Interface...............................................................................................8
5.0. Card Type Selection................................................................................................9
6.0. USB Interface.........................................................................................................10
7.0. USB Communication Protocol (CCID)..................................................................11
7.1. PC to Reader.......................................................................................................................11
7.1.1. PC_to_RDR_IccPowerOn...........................................................................................11
7.1.2. PC_to_RDR_IccPowerOff...........................................................................................11
7.1.3. PC_to_RDR_XfrBlock.................................................................................................12
7.1.4. PC_to_RDR_GetParameters......................................................................................12
7.1.5. PC_to_RDR_ResetParameters..................................................................................12
7.1.6. PC_to_RDR_SetParameters ......................................................................................13
7.1.7. PC_to_RDR_Escape ..................................................................................................15
7.1.8. PC_to_RDR_Secure...................................................................................................19
7.2. Reader to PC.......................................................................................................................23
7.2.1. RDR_to_PC_DataBlock..............................................................................................23
7.2.2. RDR_to_PC_SlotStatus..............................................................................................23
7.2.3. RDR_to_PC_Parameters............................................................................................24
7.2.4. RDR_to_PC_Escape ..................................................................................................25
7.2.5. RDR_to_PC_NotifySlotChange ..................................................................................29
7.2.6. RDR_to_PC_HardwareError.......................................................................................29
8.0. PC-linked Operation Mode....................................................................................30
8.1. SCardConnect API ..............................................................................................................30
8.2. SCardTransmit API..............................................................................................................30
8.3. SCardControl API ................................................................................................................30
8.4. SECURE PIN VERIFY.........................................................................................................30
8.5. SECURE PIN MODIFY........................................................................................................31
8.6. Escape Commands .............................................................................................................32
8.7. Get Firmware Version..........................................................................................................32
8.8. Display LCD Message .........................................................................................................32
8.9. Read Key.............................................................................................................................32
8.10. Write Display........................................................................................................................32
8.11.Buzzer Beep ........................................................................................................................32
8.12. Get Key................................................................................................................................32
9.0. Device Control.......................................................................................................33
9.1. Operation Flow (PC/SC 2.0 Part 10) ...................................................................................33
9.2. Specific ScardControl ..........................................................................................................34
9.3. Smart Card Device IOCTLs.................................................................................................34
9.3.1. CM_IOCTL_GET_FEATURE_REQUEST..................................................................34
9.3.2. FEATURE_VERIFY_PIN_DIRECT.............................................................................35
9.3.3. FEATURE_MODIFY_PIN_DIRECT............................................................................36
9.3.4. FEATURE_IFD_PIN_PROP .......................................................................................38
9.3.5. IOCTL_SMARTCARD_GET_FIRMWARE_VERSION ...............................................39
9.3.6. IOCTL_SMARTCARD_DISPLAY_LCD_MESSAGE ..................................................40
9.3.7. IOCTL_SMARTCARD_READ_KEY ...........................................................................41
9.3.8. FEATURE_IFD_DISPLAY_PROPERTIES.................................................................42
9.3.9. FEATURE_WRITE_DISPLAY ....................................................................................42
9.3.10. FEATURE_GET_KEY.................................................................................................43

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 4 of 48
www.acs.com
.hk
Appendix A. Set bKeyReturnCondition ........................................................................44
Appendix B. Response Error Codes.............................................................................45
Appendix C. bmFormatString Description....................................................................46
Appendix D. bmPINBlockString Description................................................................47
Appendix E. bmPINLength Format................................................................................48
List of Figures
Figure 1 : Operation Flowchart.............................................................................................................33
List of Tables
Table 1 : ReaderOptions Bit Structure..................................................................................................19

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 5 of 48
www.acs.com
.hk
1.0.Introduction
The APG8201-B2 is a portable and hand-held smart card
device which supports PC-linked and standalone mode to
perform various authentication applications. It features a built-
in PIN-pad and a graphical LCD that supports multiple
languages and alpha-numeric characters. APG8201-B2
supports Secure PIN Entry (SPE) that protects every PIN code
from security attacks by using an authentication process within
the device.

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 6 of 48
www.acs.com
.hk
2.0.Features
●USB Full Speed Interface
●Plug and Play –CCID support brings utmost mobility
●USB Type A Connector
●Smart Card Reader:
oSupports full-sized microprocessor cards (T=0, T=1 Protocols)
oSupports ISO 7816 Class A cards
oAllows semi-insertion of cards
oShort Circuit Protection
●Application Programming Interface:
oSupports PC/SC
oSupports SPE
oSupports PPS (Protocols and Parameters Selection)
●Built-in Peripherals:
oDot Matrix LCD
oLCD Resolution: 96 × 16 pixels
oLCD Number of characters: 16 characters × 2 lines
oMonotone buzzer
oDurable tactile keypad with 20 silicone rubber keys
oKey symbol on LCD to recognize SPE mode
●Supports Android™3.1 and later
1
●Compliant with the following standards:
oISO 7816
oPC/SC
oPC/SC 2.0 Part 10 –Secure PIN Entry
oCCID
oCE
oFCC
oRoHS 2
oMicrosoft® WHQL
1
Uses an ACS-defined Android Library

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 7 of 48
www.acs.com
.hk
3.0.Supported Card Types
The APG8201-B2 operates on MCU cards Class A (5 V) with T=0 and T=1 protocol in its main card
slot. It also supports EEPROM microcontroller-based cards with internal programming voltage (VPP)
generation and the following programming parameters transmitted in the ATR:
PI1= 0 or 5
I = 25 or 50
The APG8201-B2 can automatically perform the Protocol and Parameters Selection (PPS) in
standalone mode or can manually perform PPS in USB connected mode.
When the card ATR indicates the specific operation mode (TA2 present; bit b5 of TA2 must be 0) and
when that particular mode is not supported by the APG8201-B2, the reader will reset the card to set it
to negotiable mode. If the card cannot be set to negotiable mode, the reader will reject the card.
When the card ATR indicates the negotiable mode (TA2 not present) and communication parameters
other than the default parameters, the APG8201-B2 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-3.

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 8 of 48
www.acs.com
.hk
4.0.Smart Card Interface
The interface between the APG8201-B2 and the inserted smart card follows the specification of ISO
7816 Part 2 and 3 with certain restrictions and enhancements to increase the practical functionality of
the APG8201-B2:
Smart Card Power Supply VCC (C1)
oThe current consumption of the inserted card must not be larger than 54 mA
Programming Voltage VPP(C6)
oThe VPP pin is left unconnected
Reset Signal (C2)
oRefer to EMV Version 2000 Book1
Clock Signal (C3)
oRefer to EMV Version 2000 Book1
Ground (C5)
oRefer to EMV Version 2000 Book1
I/O Data Input and output (C7)
oRefer to EMV Version 2000 Book1

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 9 of 48
www.acs.com
.hk
5.0.Card Type Selection
The controlling computer always needs to select the card type through the proper command sent to
the APG8201-B2 prior to activating 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.

APG8201-B2 –Reference Manual [email protected].hk
Version 1.00 www.acs.com.hk
Page 10 of 48
www.acs.com
.hk
6.0.USB Interface
The APG8201-B2 is connected to a computer through a USB, as specified in the USB Specification
2.0, working in full speed mode, i.e. 12 Mbps. In order for the APG8201-B2 to function properly
through USB interface, either ACS proprietary device driver or ACS PC/SC device driver has to be
installed.