ACS ACR89U-A2 User manual

Subject to change without prior notice [e-mail]
www.acs.com.hk
Reference Manual V1.00
ACR89U-A2
Handheld
Smart Card Reader

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 2 of 80
Table of Contents
1.0. Introduction .............................................................................................................4
2.0. Hardware Design .....................................................................................................5
2.1. Architecture............................................................................................................................5
2.2. USB Interface ........................................................................................................................5
2.3. Communication Parameters ..................................................................................................5
2.4. Endpoints ...............................................................................................................................5
2.5. Contact Smart Card Interface ................................................................................................6
2.5.1. Smart Card Power Supply VCC (C1)............................................................................6
2.5.2. Card Type Selection......................................................................................................6
2.5.3. Interface for Microcontroller-based Cards.....................................................................6
2.6. Contactless Smart Card Interface .........................................................................................6
2.6.1. Carrier Frequency .........................................................................................................6
2.6.2. Card Polling...................................................................................................................6
3.0. ACR89 USB Communication Protocol ...................................................................7
3.1. Device Configuration .............................................................................................................7
3.2. CCID Class-Specific Requests ..............................................................................................9
3.2.1. Command Summary .....................................................................................................9
3.3. CCID Command Pipe Bulk-Out Message ...........................................................................10
3.3.1. Command Summary ...................................................................................................10
3.4. CCID Command Pipe Bulk-IN Message..............................................................................21
3.4.1. Message Summary .....................................................................................................21
3.5. Extended Command Pipe Message Compatible with ACR89.............................................25
3.5.1. Extended Command Pipe Bulk-OUT Message ..........................................................26
3.5.2. Commands Detail........................................................................................................27
3.5.3. Extended Command Pipe Bulk-IN Message ..............................................................44
3.5.4. Messages Detail..........................................................................................................45
3.5.5. Extended Command Response Codes and Return States ........................................53
3.6. CCID Interrupt-IN Message .................................................................................................54
3.6.1. Message Summary .....................................................................................................54
3.7. CCID Error and Status Code ...............................................................................................55
4.0. Software Design ....................................................................................................56
4.1. Contactless Smart Card Protocol ........................................................................................56
4.1.1. ATR Generation ..........................................................................................................56
4.1.2. Pseudo APDUs for Contactless Interface ...................................................................59
Appendix A. Basic Program Flow for Contactless Applications.................................75
Appendix B. Access DESFire Tags (ISO 14443-4)........................................................76
Appendix C. Access FeliCa Tags (ISO 18092) ..............................................................
78
Appendix D. Access NFC Forum Type 1 Tags (ISO 18092) .........................................79
List of Figures
Figure 1 : ACR89U-A2 Architecture ....................................................................................................... 5
Figure 2 : CCID PC_to_RDR_Escape Message.................................................................................. 26
Figure 3 : PC_to_ACR89_DisplayGraphic – Bitmap Format ............................................................... 31
Figure 4 : CCID RDR_to_PC_Escape Message.................................................................................. 44
Figure 5 : Topaz Memory Map ............................................................................................................. 80

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 3 of 80
List of Tables
Table 1 : USB Interface Wiring ............................................................................................................... 5
Table 2 : ACR89 Supported CCID Features Class Descriptor............................................................... 8
Table 3 : PC_to_RDR_Escape Extended Response ........................................................................... 18
Table 4 : ACR89 Extended Command Pipe Messages ....................................................................... 25
Table 5 : Extended Command Response Codes ................................................................................. 53
Table 6 : Extended Command Return States....................................................................................... 53
Table 7 : Extended Command Error Codes ......................................................................................... 53
Table 8 : CCID Error and Status Code ................................................................................................. 55
Table 9 : ISO 14443 Part 3 ATR Format .............................................................................................. 56
Table 10 : ISO 14443 Part 4 ATR Format ............................................................................................ 58
Table 11 : Direct Transmit Response Codes........................................................................................ 62
Table 12 : Mifare 1K Memory Map ....................................................................................................... 66
Table 13 : Mifare 4K Memory Map ....................................................................................................... 66
Table 14 : Mifare Ultralight Memory Map ............................................................................................. 67

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 4 of 80
1.0. Introduction
The ACR89U-A2 Handheld Smart Card Reader with NFC tag support is a versatile dual interface
smart card reader with PINpad, which can be used to access ISO 7816 MCU cards, ISO 14443 Type
A and B, Mifare, FeliCa and ISO 18092 or NFC tags. It can operate in both office and field-based
environments using it PC-linked and standalone modes, respectively.
For PC-linked Mode, ACR89U-A2 acts as the intermediary device between the PC and the card. The
reader, specifically to communicate with a contactless tag, MCU card, SAM card or device
peripherals, will carry out a command issued from the PC.
This manual describes the use of ACR89 software programming interface to control the built-in
accessories of the ACR89 multi-functional card reader. Built-in accessories are defined to be the
keypad, LCD display, LEDs, buzzer and real-time clock, embedded in ACR89. Such components are
not controlled through the smart card reader library. In addition, this document provides a guide on
implementing PC/SC APDU commands for device contactless tags.

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 5 of 80
2.0.Hardware Design
2.1. Architecture
The architecture of the ACR89U-A2 library can be visualized as the following diagram:
Figure 1: ACR89U-A2 Architecture
2.2. USB Interface
The ACR89U-A2 is connected to a computer through USB following the USB standard.
2.3. Communication Parameters
The ACR89U-A2 is connected to a computer through USB as specified in the USB Specification 2.0.,
working in full speed mode, i.e. 12 Mbps.
Pin Signal Function
1 VBUS +5 V power supply for the reader
2 D- Differential signal transmits data between ACR89U-A2 and PC
3 D+ Differential signal transmits data between ACR89U-A2 and PC
4 GND Reference voltage level for power supply
Table 1: USB Interface Wiring
Note
: In order for the ACR89U-A2 to function properly through USB interface, the device driver should
be installed.
2.4. Endpoints
The ACR89U-A2 uses the following endpoints to communicate with the host computer:
Control Endpoint – For setup and control purposes
Bulk OUT – For commands to be sent from host to ACR89U-A2 (data packet size is 64
bytes)
Application
acr89.dll
acr89fnc.sys
acr89bus.sys
CCID Layer
USB
Reader PC
PC/SC
DLL Program
Driver Program
Driver Program
Application
Program
OS
OS

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 6 of 80
Bulk IN – For commands to be sent from ACR89U-A2 to host (data packet size is 64
bytes)
Interrupt IN – For card status message to be sent from ACR89U-A2 to host (data packet size
is 8 bytes)
2.5. Contact Smart Card Interface
The interface between the ACR89U-A2 and the inserted smart card follows the specifications of ISO
7816-3 with certain restrictions or enhancements to increase the practical functionality of the
ACR89U-A2.
2.5.1. Smart Card Power Supply VCC (C1)
The current consumption of the inserted card must not be higher than 50 mA.
2.5.2. Card Type Selection
Before activating the inserted card, the controlling PC always needs to select the card type through
the proper command sent to the ACR89U-A2.
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.
2.5.3. 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).
2.6. Contactless Smart Card Interface
The interface between the ACR89U-A2 and the contactless card follows the specifications of ISO
14443 with certain restrictions or enhancements to increase the practical functionality of the ACR89U-
A2.
2.6.1. Carrier Frequency
The carrier frequency for ACR89U-A2 is 13.56 MHz.
2.6.2. Card Polling
The ACR89U-A2 automatically polls the contactless tags that are within the field. ISO 14443-4 Type A,
ISO 14443-4 Type B, Mifare, FeliCa and NFC tags are supported.

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 7 of 80
3.0.ACR89 USB Communication Protocol
ACR89 interfaces with host (in PC-linked mode) with USB connection. CCID specifications have been
released within the industry defining such protocol for the USB chip-card interface devices. CCID
covers all the protocols required for operating smart cards and PIN. However, it does not define the
protocol for operating other peripheral features that ACR89 also has. Communication protocol for
ACR89 reader shall follow the CCID specifications and extend it to support the rest of the reader’s
features.
3.1. Device Configuration
The configurations and usage of USB end-points on ACR89 shall follow CCID Section 3. An overview
is summarized below:
1. 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.
2. CCID Events are sent on the interrupt pipe.
3. CCID Commands are sent on BULK-OUT endpoint. Each command sent to ACR89 has an
associated ending response. Some commands can also have intermediate responses.
4. CCID Responses are sent on BULK-IN endpoint. All commands sent to ACR89 have to be
sent synchronously. (i.e. bMaxCCIDBusySlots is equal to 1 for ACR89).
The supported CCID features by ACR89 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 04h Five slots are available on ACR89.
5 bVoltageSupport 1 07h ACR89 can supply 1.8V, 3.0V and
5.0V to its slots
6 dwProtocols 4 00000003h ACR89 supports T=0 and T=1
Protocol
10 dwDefaultClock 4 000012C0h Default ICC clock frequency is 4.8
MHz
14 dwMaximumClock 4 000012C0h Maximum supported ICC clock
frequency is 4.8 MHz
18 bNumClockSupported 1 00h Does not support manual setting of
clock frequency
19 dwDataRate 4 003267h Default ICC I/O data rate is 12,903
bps
23 dwMaxDataRate 4 00032673h Maximum supported ICC I/O data
rate is 206,451 bps
27 bNumDataRatesSupported 1 00h Does not support manual setting of
data rates
28 dwMaxIFSD 4 00000FEh Maximum IFSD supported by
ACR89 for protocol T=1 is 254

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 8 of 80
Offset Field Size Value Description
32 dwSynchProtocols 4 00000000h ACR89 does not support
synchronous card
36 dwMechanical 4 00000000h ACR89 does not support special
mechanical characteristics
40 dwFeatures 4 000204B2h
ACR89 supports the following
features:
- Automatic parameter configuration
based on ATR data
- Automatic ICC clock frequency
change according to parameters
- Automatic baud rate change
according to frequency and FI, DI
parameters
- Automatic PPS made by the
ACR89 according to the current
parameters
- Automatic IFSD
- Short APDU level exchange with
ACR89
44 dwMaxCCIDMessageLength 4 00000110h Maximum message length accepted
by ACR89 is 272 bytes
48 bClassGetResponse 1 FFh Echo class of APDU in Get
Response command
49 bClassEnvelope 1 FFh Insignificant (Short APDU exchange
level)
50 wLCDLayout 2 0815h 8 lines x 21 characters LCD
52 bPINSupport 1 03h ACR89 supports PIN Verification
and PIN Modification
53 bMaxCCIDBusySlots 1 01h Only 1 slot can be simultaneously
busy
Table 2: ACR89 Supported CCID Features Class Descriptor
Note: Standard CCID adopts little endian mode.

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 9 of 80
3.2. CCID Class-Specific Requests
ACR89’s USB communication with PC is based on command message format standard of ACR89
reader. This device shall support one CCID Class-specific Request. Class-specific requests are sent
via Control Pipe.
3.2.1. Command Summary
Stop any current processing command and return to a state where ACR89 is ready to accept a new
command:
bmRequestType bRequest wValue wIndex wLength Data
00100001b ABORT
(01h) bSeq, bSlot Interface 0000h None

ACR89U-A2 – Reference Manual [e-mail]
Version 1.00 www.acs.com.hk
Page 10 of 80
3.3. CCID Command Pipe Bulk-Out Message
ACR89 reader follows the CCID Bulk-OUT Messages as standard CCID Session 4. In addition, this
specification defines some extended commands for operating additional features. This section lists
the CCID Bulk-OUT Messages to be supported by ACR89. The extended commands will be
introduced in Section 3.5.
3.3.1. Command Summary
3.3.1.1. PC_to_RDR_IccPowerOn
Activates the card slot and returns ATR from the card.
Offset Field Size Value Description
0 bMessageType 1 62h -
1 dwLength 4 00000000h Size of extra bytes of this message
2 bSlot 1 - Identifies the slot number for this
command.
5 bSeq 1 - Sequence number for command
6 bPowerSelect 1 -
Voltage that is applied to the ICC:
00h = Automatic Voltage Selection
01h = 5 volts
02h = 3 volts
03h = 1.8 volts
7 abRFU 2 - Reserved for future use
The response to this message is the RDR_to_PC_DataBlock message and the data returned is the
Answer To Reset (ATR) data.