ACS ACR33U-A1 User Manual

ACR33U-A1

SmartDuo

Smart Card Reader

Reference Manual V1.02

Subject to change without prior notice [e-mail]

www.acs.com.hk

Table of Contents

1.0. Introduction ............................................................................................................. 4

1.1. Reference Documents ........................................................................................................... 4

1.2. Symbols and Abbreviations ................................................................................................... 4

2.0. Features ................................................................................................................... 5

3.0. Smart Card Support ................................................................................................ 6

3.1. MCU Cards ............................................................................................................................ 6

3.2. Memory-based Smart Cards.................................................................................................. 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

5.1. Status LED ............................................................................................................................. 8

6.0. USB Interface ........................................................................................................... 9

6.1. Communication Parameters .................................................................................................. 9

6.2. Endpoints ............................................................................................................................... 9

7.0. Communication Protocol ...................................................................................... 10

8.0. Commands ............................................................................................................. 12

8.1. CCID Command Pipe Bulk-OUT Messages ........................................................................ 12

8.1.1. PC_to_RDR_IccPowerOn ........................................................................................... 12

8.1.2. PC_to_RDR_IccPowerOff ........................................................................................... 13

8.1.3. PC_to_RDR_GetSlotStatus ........................................................................................ 14

8.1.4. PC_to_RDR_XfrBlock ................................................................................................. 15

8.1.5. PC_to_RDR_GetParameters ...................................................................................... 16

8.1.6. PC_to_RDR_SetParameters ...................................................................................... 17

8.1.7. PC_to_RDR_Escape .................................................................................................. 19

8.2. CCID Bulk-IN Messages ...................................................................................................... 21

8.2.1. RDR_to_PC_DataBlock .............................................................................................. 21

8.2.2. RDR_to_PC_SlotStatus .............................................................................................. 21

8.2.3. RDR_to_PC_Parameters ............................................................................................ 22

8.2.4. RDR_to_PC_Escape .................................................................................................. 24

8.3. Memory Card Access via PC_to_RDR_XfrBlock ................................................................ 26

8.3.1. Memory Card – 1, 2, 4, 8, 16 kbit I2C Card ................................................................ 26

8.3.2. Memory Card – 32, 64, 128, 256, 512, 1024 kbit I2C Card ........................................ 29

8.3.3. Memory Card – ATMEL AT88SC153.......................................................................... 32

8.3.4. Memory Card – ATMEL AT88SC1608........................................................................ 36

8.3.5. Memory Card – SLE4418/SLE4428/SLE5518/SLE5528 ............................................ 40

8.3.6. Memory Card – SLE4432/SLE4442/SLE5532/SLE5542 ............................................ 45

8.3.7. Memory Card – SLE4406/SLE4436/SLE5536/SLE6636 ............................................ 50

8.3.8. Memory Card – AT88SC101 / AT88SC102 / AT88SC1003 ....................................... 54

Appendix A. CCID Response Error Codes .................................................................... 60

Page 2 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

Tables

Table 1 : Symbols and Abbreviations ..................................................................................................... 4

Table 2 : USB Interface Wiring ............................................................................................................... 9

Table 3 : CCID Response Error Codes ................................................................................................ 60

Page 3 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

1.0. Introduction

The ACR33U-A1 SmartDuo PC-linked Smart Card Reader acts as an interface for the communication
between a computer and a smart card. Different types of smart cards have different commands and
different communication protocols, which, in most cases, prevent direct communication between a
smart card and a computer. The ACR33U-A1 SmartDuo Smart Card Reader establishes a uniform
interface from the computer to the smart card for a wide variety of cards. By taking care of the card’s
particulars, it releases the computer software programmer from being responsible with smart card
operations’ technical details, which in many cases, are not relevant to the implementation of a smart
card system.

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

Abbreviation Description

ATR Answer-to-reset

CCID Chip/Smart Card Interface Device

ICC Integrated Circuit Cards

IFSC Information Field Sized for ICC for protocol T=1

IFSD Information Field Sized for CCID for protocol T=1

NAD Node Address

PPS Protocol and Parameters Selection

RFU Reserved for future use*

TPDU Transport Protocol Data Unit

USB Universal Serial Bus

Table 1: Symbols and Abbreviations

*Note: Must be set to zero unless stated differently.

Page 4 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

2.0. Features

• USB Full Speed Interface

• Plug-and-Play – CCID support brings utmost compatibility

• Dual Slots for Full-Sized Smart Cards

• Three SAM (Secure Access Module) Card Slots

• Smart Card Reader:

o Supports ISO 7816 Class A (5 V) smart cards

o Supports microprocessor cards with T=0 and T=1 protocol

o Supports memory cards

o Supports PPS (Protocol and Parameters Selection)

o Features Short Circuit Protection

• User controllable peripherals:

o Tri-Color LED (Green, Red, Blue)

o Buzzer

• Application Programming Interface:

o Supports PC/SC

o Supports CT-API (through wrapper on top of PC/SC)

• Supports Android™ OS 3.1 and above

• Compliant with the following international standards:

o ISO 7816

o CE

o FCC

o VCCI

o PC/SC

o CCID

o Microsoft WHQL

o RoHS

Page 5 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

3.0. Smart Card Support

3.1. MCU Cards

The ACR33U-A1 is a PC/SC compliant smart card reader that supports ISO 7816 Class A (5 V) smart
card. It also works with MCU cards following either the T=0 and 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 ACR33U-A1; 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 ACR33U-A1 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.

3.2. Memory-based Smart Cards

The ACR33U-A1 works with several memory-based smart cards such as:

• Cards following the I2Cbus protocol (free memory cards) with maximum 128 bytes page with
capability, including:

o Atmel: AT24C01/02/04/08/16/32/64/128/256/512/1024

• Cards with secure memory IC with password and authentication, including:

o Atmel: AT88SC153 and AT88SC1608

• Cards with intelligent 1k bytes EEPROM with write-protect function, including:

o Infineon: SLE4418, SLE4428, SLE5518 and SLE5528

• Cards with intelligent 256 bytes EEPROM with write-protect function, including:

o Infineon: SLE4432, SLE4442, SLE5532 and SLE5542

• Cards with ‘104’ type EEPROM non-reloadable token counter cards, including:

o Infineon: SLE4406, SLE4436, SLE5536 and SLE6636

• Cards with Security Logic with Application Zone(s), including:

o Atmel: AT88SC101, AT88SC102 and AT88SC1003

Note: Memory card is supported in ICC Slot 0 only of ACR33U-A1 SmartDuo Smart Card Reader.

Page 6 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

4.0. Smart Card Interface

The interface between the ACR33U-A1 and the inserted smart card follows the specifications of ISO
7816-3 with certain restrictions or enhancements to increase the practical functionality of the
ACR33U-A1.

4.1. Smart Card Power Supply VCC (C1)

The current consumption of the inserted card must not be higher than 50 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 ACR33U-A1. 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 must always select the card type through the proper command sent to the
ACR33U-A1 prior to activating the inserted card. This includes both the memory cards and MCU­based cards.

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 ACR33U-A1 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 ACR33U-A1
and the card is immediately deactivated when the card is removed. However, as a rule to avoid any
electrical damage, a card should only be removed from the reader while it is powered down.

Note: ACR33U-A1 does not switch on the power supply to the inserted card by itself. This can be
done by the controlling computer through the proper command sent to the reader.

Page 7 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

5.0. Power Supply

The ACR33U-A1 requires a voltage of 5 V DC, 100 mA, regulated, power supply. The ACR33U-A1
gets the power supply from the computer (through the cable supplied along with each type of reader).

5.1. Status LED

The LED indicates the activation status of the smart card interface:

• Flashing slowly (turns on 200 ms every 2 seconds)
Indicates ACR33U-A1 is powered up and in the standby state. Either the smart card has not
been inserted or the smart card has not been powered up (if it is inserted).

• Lighting up
Indicates power supply to the smart card is switched on, i.e., the smart card is activated.

• Flashing quickly
Indicates there are communications between ACR33U-A1 and smart card.

The different LED colors indicate the different states of the ACR33U-A1, where:

• Red LED
Power status

• Green LED
Main card slot status (ICC Slot 0)

• Blue LED
Slave card slot status (ICC Slot 1)

Page 8 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

6.0. USB Interface

6.1. Communication Parameters

The ACR33U-A1 is connected to a computer through USB as specified in the USB Specification 2.0.
The ACR33U-A1 is 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 ACR33U-A1 and PC

3 D+ Differential signal transmits data between ACR33U-A1 and PC

4 GND Reference voltage level for power supply

Table 2: USB Interface Wiring

Note: In order for the ACR33U-A1 to function properly through USB interface, either ACS proprietary
device driver or ACS PC/SC device driver has to be installed.

6.2. Endpoints

The ACR33U-A1 uses the following endpoints to communicate with the host computer:

Control Endpoint

Bulk OUT

Bulk IN

Interrupt IN

For setup and control purpose

For command to be sent from host to ACR33U-A1
(data packet size is 64 bytes)

For response to be sent from ACR33U-A1 to host
(data packet size is 64 bytes)

For card status message to sent from ACR33U-A1 to host
(data packet size is 8 bytes)

Page 9 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

7.0. Communication Protocol

ACR33U-A1 shall interface with the host through the 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.

The configurations and usage of USB endpoints on ACR33U-A1 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 ACR33U-A1 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 ACR33U-A1 have to
be sent synchronously (e.g., bMaxCCIDBusySlots is equal to 01h for ACR33U-A1).

The ACR33U-A1 supported CCID features are indicated in its Class Descriptor:

Offset Field Size Value Description

0

1

2

4

5

6

10

14

18

19

23

27

bLength

bDescriptorType

bcdCCID

bMaxSlotIndex

bVoltageSupport

dwProtocols

dwDefaultClock

dwMaximumClock

bNumClockSupported

dwDataRate

dwMaxDataRate

bNumDataRatesSupported

1 36h Size of this descriptor, in bytes

1 21h CCID Functional Descriptor type

2 0100h

1 05h

1 01h ACR33U-A1 can supply 5 V to its slot

4 00000003h

4 00000FA0h Default ICC clock frequency is 4 MHz

4 00000FA0h

1 00h

4 00002A00h Default ICC I/O data rate is 10752 bps

4 00054024h

1 00h

CCID Specification Release Number in
Binary-Coded decimal

2 big slots and 3 SAM slots are available
on ACR33U-A1

ACR33U-A1 supports T=0 and T=1
protocol

Maximum supported ICC clock
frequency is 4 MHz

Does not support manual setting of
clock frequency

Maximum supported ICC I/O data rate is
344100 bps

Does not support manual setting of data
rates

28

32

36

dwMaxIFSD

dwSynchProtocols

dwMechanical

4 00000FEh

4 00000000h

4 00000000h

Maximum IFSD supported by ACR33U­A1 for protocol T=1 is 254

ACR33U-A1 does not support
synchronous card

ACR33U-A1 does not support special
mechanical characteristics

Page 10 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

Offset Field Size Value Description

ACR33U-A1 supports the following
features:

Automatic ICC clock frequency change
according to parameters

Automatic baud rate change according

40

dwFeatures

4 000204B0h

to frequency and FI,DI parameters
Automatic PPS made by the CCID

according to the active parameters
Automatic IFSD exchange as first

exchange (T=1 protocol in use)
Short APDU level exchange with CCID

44

48

49

50

52

53

dwMaxCCIDMessageLength

bClassGetResponse

bClassEnvelope

wLCDLayout

bPINSupport

bMaxCCIDBusySlots

4 0000010Fh

1 00h Insignificant for TPDU level exchanges

1 00h Insignificant for TPDU level exchanges

2 0000h No LCD

1 03h With PIN Verification and Modification

1 01h Only 1 slot can be simultaneously busy

Maximum message length accepted by
ACR33U-A1 is 271 bytes

Page 11 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.0. Commands

8.1. CCID Command Pipe Bulk-OUT Messages

ACR33U-A1 shall follow the CCID Bulk-OUT Messages as specified in CCID Section 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 ACR33U-A1.

8.1.1. PC_to_RDR_IccPowerOn

Activates the card slot and return ATR from the card.

Offset Field Size Value Description

0

1

2

5

6

7

The response to this command message is the RDR_to_PC_DataBlock response message and the
data returned is the Answer-to-Reset (ATR) data.

bMessageType

dwLength

bSlot

bSeq

bPowerSelect

abRFU

1 62h -

4 00000000h Size of extra bytes of this message

1 00-05h

1 00-FFh Sequence number for command

1 01h

2 - Reserved for future use

Identifies the slot number for this
command

Voltage that is applied to the ICC:
01h – 5 volts

Page 12 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.1.2. PC_to_RDR_IccPowerOff

Deactivates the card slot.

Offset Field Size Value Description

0

1

5

6

7

The response to this message is the RDR_to_PC_SlotStatus message.

bMessageType

dwLength

bSlot

bSeq

abRFU

1 63h -

4 00000000h Size of extra bytes of this message

1 00-05h

1 00-FFh Sequence number for command

3 - Reserved for future use

Identifies the slot number for this
command

Page 13 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.1.3. PC_to_RDR_GetSlotStatus

Gets current status of the slot.

Offset Field Size Value Description

0

1

5

6

7

The response to this message is the RDR_to_PC_SlotStatus message.

bMessageType

dwLength

bSlot

bSeq

abRFU

1 65h -

4 00000000h Size of extra bytes of this message

1 00-05h

1 00-FFh Sequence number for command

3 - Reserved for future use

Identifies the slot number for this
command

Page 14 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.1.4. PC_to_RDR_XfrBlock

Transfers data block to the ICC.

Offset Field Size Value Description

0

1

5

6

7

8

10

The response to this message is the RDR_to_PC_DataBlock message.

bMessageType

dwLength

bSlot

bSeq

bBWI

wLevelParameter

abData

1 6Fh -

4 -

1 00-05h

1 00-FFh Sequence number for command

1 00-FFh

2 0000h RFU (TPDU exchange level)

Byte

array

Size of abData field of this message

Identifies the slot number for this
command

Used to extend the CCIDs Block
Waiting Timeout for this current
transfer. The CCID will timeout the
block after “this number multiplied by
the Block Waiting Time” has expired.

Data block sent to the CCID. Data is

-

sent “as is” to the ICC (TPDU
exchange level).

Page 15 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.1.5. PC_to_RDR_GetParameters

Gets slot parameters.

Offset Field Size Value Description

0

1

5

6

7

The response to this message is the RDR_to_PC_Parameters message.

bMessageType

DwLength

BSlot

BSeq

AbRFU

1 6CH -

4 00000000H Size of extra bytes of this message

1 00-05H

1 00-FFH Sequence number for command

3 - Reserved for future use

Identifies the slot number for this
command

Page 16 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

8.1.6. PC_to_RDR_SetParameters

Sets slot parameters.

Offset Field Size Value Description

0

1

5

6

7

8

10

The response to this message is the RDR_to_PC_Parameters message.

bMessageType

dwLength

bSlot

bSeq

bProtocolNum

abRFU

abProtocolDataStructure

1 61h -

4 - Size of extra bytes of this message

1 00-05h

1 00-FFh Sequence number for command

1

2 -

Byte

array

00h,

01h

Identifies the slot number for this
command

Specifies what protocol data structure
follows.

00h = Structure for protocol T=0
01h = Structure for protocol T=1
The following values are reserved for

future use:
80h = Structure for 2-wire protocol
81h = Structure for 3-wire protocol
82h = Structure for I2C protocol

Reserved for future use

- Protocol Data Structure

Protocol Data Structure for Protocol T=0 (dwLength=00000005h)

Offset Field Size Value Description

B7-4 – FI – Index into the Table 7 in
ISO/IEC 7816-3:1997 selecting a clock

10

11

12

13

bmFindexDindex

bmTCCKST0

bGuardTimeT0

bWaitingIntegerT0

1 -

1 -

1 00-FFh

1 00-FFh WI for T=0 used to define WWT

rate conversion factor
B3-0 – DI - Index into the Table 8 in
ISO/IEC 7816-3:1997 selecting a baud

rate conversion factor

B0 – 0b, B7-2 – 000000b
B1 – Convention used (b1=0 for direct,

b1=1 for inverse) Note: The CCID
ignores this bit.

Extra guard time between two
characters. Add 0 to 254etu to the
normal guard time of 12etu. FFh is the
same as 00h.

Page 17 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk

Offset Field Size Value Description

ICC Clock Stop Support:
00h = Stopping the Clock is not allowed

14

The response to this message is the RDR_to_PC_Parameters message.

Protocol Data Structure for Protocol T=1 (dwLength=00000007h)

Offset Field Size Value Description

10

bClockStop

bmFindexDindex

1 00-03h

1 -

01h = Stop with Clock signal Low
02h = Stop with Clock signal High
03h = Stop with Clock either High or

Low

B7-4 – FI – Index into the Table 7 in
ISO/IEC 7816-3:1997 selecting a
clock rate conversion factor

B3-0 – DI - Index into the Table 8 in
ISO/IEC 7816-3:1997 selecting a

baud rate conversion factor

11

12

13

14

15

16

BmTCCKST1

BGuardTimeT1

BwaitingIntegerT1

bClockStop

bIFSC

bNadValue

B7-2 – 000100b
B0 – Checksum type (b0=0 for LRC,

1 -

1 00-FFh

1 00-9Fh

1 00-03h

1 00-FFh Size of negotiated IFSC

1 00h Only support NAD = 00h

b0=1 for CRC
B1 – Convention used (b1=0 for

direct, b1=1 for inverse) Note: The
CCID ignores this bit.

Extra guard time (0 to 254etu
between two characters). If value is
FFh, then guard time is reduced by
1etu.

B7-4 = BWI values 0-9 valid
B3-0 = CWI values 0-Fh valid

ICC Clock Stop Support:
00h = Stopping the Clock is not

allowed
01h = Stop with Clock signal Low
02h = Stop with Clock signal High
03h = Stop with Clock either High or

Low

The response to this message is the RDR_to_PC_Parameters message.

Page 18 of 60

ACR33U-A1 – Reference Manual [e-mail]

Version 1.02

www.acs.com.hk