ACR3801 Smart Card Reader acts as a communication interface between a computer and a smart
card. Different types of smart cards have different commands and different communication protocols,
which prevents in most cases, the direct communication between a smart card and a computer. The
ACR3801 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 specifics, it liberates the computer software
programmer of getting involved with the technical details of the smart card operation, which are in
many cases irrelevant 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 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 5
2.0. Features
• USB 2.0 Full Speed Interface
• Plug-and-Play – CCID support brings utmost mobility
• Smart Card Reader:
o Supports ISO 7816 Class A, B and C (5 V, 3 V, 1.8 V) cards
o Supports CAC (Common Access Card)
o Supports microprocessor cards with T=0 or T=1 protocol
o Supports memory cards
o Supports PPS (Protocol and Parameters Selection)
o Features Short Circuit Protection
• 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 standards:
o FIPS 201
o TAA
o EN60950/IEC 60950
o ISO 7816
o CE
o FCC
o PC/SC
o CCID
o Microsoft WHQL
o RoHS
Page 5 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 6
3.0. Supported Card Types
3.1. MCU Cards
ACR3801 is a PC/SC compliant smart card reader that supports ISO 7816 Class A, B and C (5 V, 3 V,
and 1.8 V) smart cards. 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 particular mode is not supported by ACR3801, 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 ACR3801 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
ACR3801 works with several memory-based smart cards such as:
•Cards following the I2C bus 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
o SGS-Thomson: ST14C02C/4C
o Gemplus: GFM1K to 8K
• 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 Intelligent 416-Bit EEPROM with internal PIN check, including:
o Infineon: SLE4404
• Cards with Security Logic with Application Zone(s), including:
o Atmel: AT88SC101, AT88SC102, AT88SC1003
Page 6 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 7
4.0. Smart Card Interface
The interface between the ACR3801 and the inserted smart card follows the specification of ISO
7816-3 with certain restrictions or enhancements to increase the practical functionality of ACR3801.
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 ACR3801. 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
ACR3801 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
selected by the application.
T=1, the reader automatically uses that protocol type, regardless of the protocol type
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
ACR3801 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 ACR3801 and the card is
immediately deactivated when the card is being 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: ACR3801 never switches on the power supply to the inserted card by itself. The controlling
computer through the proper command sent to the reader must explicitly do this.
Page 7 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 8
5.0. Power Supply
ACR3801 requires a voltage of 5 V DC, 100 mA, regulated, power supply. ACR3801 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 for every 2 seconds)
Indicates ACR3801 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 ACR3801 and smart card.
Page 8 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 9
6.0. USB Interface
6.1. Communication Parameters
ACR3801 is connected to a computer through USB as specified in the USB Specification 2.0.
ACR3801 is working in full speed more, i.e. 12 Mbps.
Pin Signal Function
1 VBUS +5 V power supply for the reader
2 D- Differential signal transmits data between ACR3801 and PC
3 D+ Differential signal transmits data between ACR3801 and PC
4 GND Reference voltage level for power supply
Table 2: USB Interface Wiring
Note: In order for the ACR3801 to function properly through USB interface, either ACS proprietary
device driver or the ACS PC/SC device driver has to be installed.
6.2. Endpoints
ACR3801 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 ACR3801
(data packet size is 64 bytes)
For response to be sent from ACR3801 to host
(data packet size is 64 bytes)
For card status message to sent from ACR3801 to host
(data packet size is 8 bytes)
Page 9 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 10
7.0. Communication Protocol
ACR3801 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 ACR3801 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 ACR3801 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 ACR3801 have to be
sent synchronously (e.g., bMaxCCIDBusySlots is equal to 01h for ACR3801).
ACR3801 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 00h One slot is available on ACR3801
1 07h
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 0001F808h
1 00h
CCID Specification Release Number in
Binary-Coded decimal
ACR3801 can supply 1.8 V, 3 V, and
5 V to its slot
ACR3801 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
344 kbps
Does not support manual setting of data
rates
28
32
36
dwMaxIFSD
dwSynchProtocols
dwMechanical
4 00000FEh
4 00000000h
4 00000000h
Maximum IFSD supported by ACR3801
for protocol T=1 is 254
ACR3801 does not support synchronous
card
ACR3801 does not support special
mechanical characteristics
Page 10 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 11
Offset Field Size Value Description
ACR3801 supports the following
features:
Automatic ICC clock frequency change
40
dwFeatures
4 00010030h
according to parameters
Automatic baud rate change according
to frequency and FI,DI parameters
TPDU level change with ACR3801
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 00h No PIN Verification
1 01h Only 1 slot can be simultaneously busy
Maximum message length accepted by
ACR3801 is 271 bytes
Page 11 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 12
8.0. Commands
8.1. CCID Command Pipe Bulk-OUT Messages
ACR3801 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 ACR3801.
8.1.1. PC_to_RDR_IccPowerOn
Activates the card slot and returns 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 -
1 - Sequence number for command
1 -
2 - Reserved for future use
Identifies the slot number for this
command
Voltage that is applied to the ICC:
00h = Automatic Voltage Selection
01h = 5 volts
02h = 3 volts
Page 12 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 13
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 -
1 - Sequence number for command
3 - Reserved for future use
Identifies the slot number for this
command
Page 13 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 14
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 -
1 - Sequence number for command
3 - Reserved for future use
Identifies the slot number for this
command
Page 14 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 15
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 -
1 - Sequence number for command
1 -
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 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 16
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 -
1 - Sequence number for command
3 - Reserved for future use
Identifies the slot number for this
command
Page 16 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 17
8.1.6. PC_to_RDR_ResetParameters
Resets slot parameters to default value.
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 6Dh -
4 00000000h Size of extra bytes of this message
1 -
1 - Sequence number for command
3 - Reserved for future use
Identifies the slot number for this
command
Page 17 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 18
8.1.7. PC_to_RDR_SetParameters
Sets slot parameters.
Offset Field Size Value Description
0
1
5
6
7
8
10
Protocol Data Structure for Protocol T=0 (dwLength=00000005h)
bMessageType
dwLength
bSlot
bSeq
bProtocolNum
abRFU
abProtocolDataStructure
1 61h -
4 - Size of extra bytes of this message
1 -
1 - Sequence number for command
1 -
2 - Reserved for future use
Byte
array
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
- Protocol Data Structure
Offset Field Size Value Description
B7-4 – FI – Index into the table 7 in
ISO/IEC 7816-3:1997 selecting a
10
11
12
13
14
bmFindexDindex
bmTCCKST0
bGuardTimeT0
bWaitingIntegerT0
bClockStop
1 -
1 -
1 -
1 - WI for T=0 used to define WWT
1 -
clock 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 Guardtime between two
characters. Add 0 to 254 etu to the
normal guardtime of 12etu. FFh is the
same as 00h.
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
Page 18 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 19
Protocol Data Structure for Protocol T=1 (dwLength=00000007h)
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
bmFindexDindex
BmTCCKST1
BGuardTimeT1
1 -
1 -
1 -
rate conversion factor
B3-0 – DI - Index into the table 8 in
ISO/IEC 7816-3:1997 selecting a baud
rate conversion factor
B7-2 – 000100b
B0 – Checksum type (b0=0 for LRC,
b0=1 for CRC
B1 – Convention used (b1=0 for direct,
b1=1 for inverse) Note: The CCID
ignores this bit.
Extra Guardtime (0 to 254 etu between
two characters). If value is FFh, then
guardtime is reduced by 1 etu.
13
14
15
16
The response to this message is the RDR_to_PC_Parameters message.
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
Page 19 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 20
8.2. CCID Bulk-IN Messages
The Bulk-IN messages are used in response to the Bulk-OUT messages. ACR3801 shall follow the
CCID Bulk-IN Messages as specified in CCID Section 4.
This section lists the CCID Bulk-IN Messages to be supported by ACR3801.
8.2.1. RDR_to_PC_DataBlock
This message is sent by ACR3801 in response to PC_to_RDR_IccPowerOn, PC_to_RDR_XfrBlock
and PC_to_RDR_Secure messages.
Offset Field Size Value Description
0
1
5
6
7
8
9
10
bMessageType
dwLength
bSlot
bSeq
bStatus
bError
bChainParameter
abData
1 80h
4 - Size of extra bytes of this message
1 - Same value as in Bulk-OUT message
1 - Same value as in Bulk-OUT message
1 -
1 -
1 00h RFU (TPDU exchange level)
Byte
array
-
Indicates that a data block is being sent
from the CCID
Slot status register as defined in CCID
Section 4.2.1
Slot error register as defined in CCID
Section 4.2.1 and this specification
Section 5.2.8
This field contains the data returned
by the CCID
Page 20 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 21
8.2.2. RDR_to_PC_SlotStatus
This message is sent by ACR3801 in response to PC_to_RDR_IccPowerOff,
PC_to_RDR_GetSlotStatus, PC_to_RDR_Abort messages and Class specific ABORT request.
Offset Field Size Value Description
0
1
5
6
7
8
9
bMessageType
dwLength
bSlot
bSeq
bStatus
bError
bClockStatus
1 81h -
4 00000000h Size of extra bytes of this message
1 - Same value as in Bulk-OUT message
1 - Same value as in Bulk-OUT message
1 -
1 -
1 -
Slot status register as defined in CCID
Section 4.2.1
Slot error register as defined in CCID
Section 4.2.1 and this specification
Section 5.2.8
Value:
00h = Clock running
01h = Clock stopped in state L
02h = Clock stopped in state H
03h = Clock stopped in an unknown state
All other values are RFU
Page 21 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 22
4.2.1 and this specification
8.2.3. RDR_to_PC_Parameters
This message is sent by ACR3801 in response to PC_to_RDR_GetParameters,
PC_to_RDR_ResetParameters and PC_to_RDR_SetParameters messages.
Offset Field Size Value Description
0
1
5
6
7
8
9
bMessageType
dwLength
bSlot
bSeq
bStatus
bError
bProtocolNum
1 82h -
4 - Size of extra bytes of this message
1 - Same value as in Bulk-OUT message
1 - Same value as in Bulk-OUT message
1 -
1 -
1 -
Slot status register as defined in CCID
Section 4.2.1
Slot error register as defined in CCID
Section
Section 5.2.8
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
10
abProtocolDataStructure
Byte
array
Protocol Data Structure as
summarized in CCID Section 5.2.3
Page 22 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 23
8.3. Memory Card Command Set
This section contains the Memory Card Command Set for ACR3801.
This command powers down and up the selected card inserted in the card reader and performs a card
reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specification.
Command format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 01h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.1.2. SELECT_PAGE_SIZE
This command chooses the page size to read the smart card. The default value is 8-byte page write. It
will reset to default value whenever the card is removed or the reader is powered off.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Page Size
FFh 01h 00h 00h 01h
Where:
Page size= 03h for 8-byte page write
= 04h for 16-byte page write
= 05h for 32-byte page write
= 06h for 64-byte page write
= 07h for 128-byte page write
Page 23 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 24
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.1.3. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh B0h
Where:
Byte Address Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
Byte Address
MEM_L
MSB LSB
8.3.1.4. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh D0h
Where:
Byte Address Memory address location of the memory card
MEM_L Length of data to be written to the memory card
Byte x Data to be written to the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 02h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.2.2. SELECT_PAGE_SIZE
This command chooses the page size to read the smart card. The default value is 8-byte page write. It
will reset to default value whenever the card is removed or the reader is powered off.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Page size
FFh 01h 00h 00h 01h
Where:
Data TPDU to be sent to the card
Page size = 03h for 8-byte page write
= 04h for 16-byte page write
= 05h for 32-byte page write
= 06h for 64-byte page write
= 07h for 128-byte page write
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Page 26 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 27
Where:
SW1 SW2 = 90 00h if no error
8.3.2.3. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh
Where:
INS = B0h for 32, 64, 128, 256, 512kbit iic card
Byte Address Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
Byte Address
MEM_L
MSB LSB
= 1011 000*b for 1024kbit iic card,
where * is the MSB of the 17 bit addressing
8.3.2.4. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FF
Where:
INS = D0h for 32, 64, 128, 256, 512kbit iic card
Byte Address Memory address location of the memory card
MEM_L Length of data to be written to the memory card
Byte x Data to be written to the memory card
Byte Address
MEM_L Byte 1 .... .... Byte n
MSB LSB
= 1101 000*b for 1024kbit iic card,
where * is the MSB of the 17 bit addressing
Page 27 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 28
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
Page 28 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 29
8.3.3. Memory Card – ATMEL AT88SC153
8.3.3.1. SELECT_CARD_TYPE
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset. It will also select the page size to be 8-byte page write.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 03h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.3.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh 00h
Where:
INS = B0h for reading zone 00b
= B1h for reading zone 01b
= B2h for reading zone 10b
= B3h for reading zone 11b
= B4h for reading fuse
Byte Address Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
Page 29 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 30
8.3.3.3. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L Byte 1 .... .... Byte n
FFh 00h
Where:
INS= D0h for writing zone 00b
= D1h for writing zone 01b
= D2h for writing zone 10b
= D3h for writing zone 11b
= D4h for writing fuse
Byte Address Memory address location of the memory card
MEM_L Length of data to be written to the memory card
MEM_D Data to be written to the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.3.4. VERIFY_PASSWORD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Pw(0) Pw(1) Pw(2)
FFh 20h 00h 03h
Where:
Pw(0),Pw(1),Pw(2) Passwords to be sent to memory card
P2 = 0000 00rpb
where the two bits “rp” indicate the password to compare
r = 0: Write password,
r = 1: Read password,
p : Password set number,
rp = 01 for the secure code.
Page 30 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 31
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1
90h
Where:
SW1 =90h
SW2 (ErrorCnt) = Error Counter. FFh indicates the verification is correct. 00h indicates
SW2
ErrorCnt
the password is locked (or exceeded the maximum number of retries).
Other values indicate the current verification has failed.
8.3.3.5. INITIALIZE_AUTHENTICATION
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Q(0) Q(1) … Q(7)
FFh 84h 00h 00h 08h
Where:
Q(0),Q(1)…Q(7) Host random number, 8 bytes
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.3.6. VERIFY_AUTHENTICATION
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Ch(0) Ch(1) … Ch(7)
FFh 82h 00h 00h 08h
Where:
Ch(0),Ch(1)…Ch(7) Host challenge, 8 bytes
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
Page 31 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 32
8.3.4. Memory Card – ATMEL AT88C1608
8.3.4.1. SELECT_CARD_TYPE
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset. It will also select the page size to be 16-byte page write.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 04h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.4.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS Zone Address Byte Address MEM_L
FFh
Where:
INS= B0h for reading user zone
= B1h for reading configuration zone or reading fuse
Zone Address= 0000 0A
= Don’t care for reading fuse
Byte Address= A
= 1000 0000b for reading fuse
MEM_LLength of data to be read from the memory card
7A6A5A4
card
b where A10 is the MSB of zone address
10A9A8
A3A2A1A0b is the memory address location of the memory
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE xData read from memory card
Page 32 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 33
SW1 SW2 = 90 00h if no error
8.3.4.3. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS Zone Address Byte Address MEM_L Byte 1 … … Byte n
FFh
Where:
INS= D0h for writing user zone
= D1h for writing configuration zone or writing fuse
Zone Address= 0000 0A
b where A10 is the MSB of zone address
10A9A8
= Don’t care for writing fuse
Byte Address= A
7A6A5A4
A3A2A1A0b is the memory address location of the memory
card
= 1000 0000b for writing fuse
MEM_L Length of data to be written to the memory card
Byte x Data to be written to the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.4.4. VERIFY_PASSWORD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Data
FFh 20h 00h 00h 04h RP Pw(0) Pw(1) Pw(2)
Where:
Pw(0),Pw(1),Pw(2) Passwords to be sent to memory card
RP = 0000 rp
where the four bits “rp
2p1p0
b
” indicate the password to compare:
2p1p0
r = 0 : Write password,
r = 1 : Read password,
p
: Password set number.
2p1p0
(rp
= 0111 for the secure code)
2p1p0
Page 33 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 34
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1
90h
Where:
SW1 = 90h
SW2 (ErrorCnt) = Error Counter. FFh indicates the verification is correct. 00h indicates
SW2
ErrorCnt
the password is locked (or exceeded the maximum number of retries).
Other values indicate the current verification has failed.
8.3.4.5. INITIALIZE_AUTHENTICATION
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Q(0) Q(1) … Q(7)
FFh 84h 00h 00h 08h
Where:
Byte Address Memory address location of the memory card
Q(0),Q(1)…Q(7) Host random number, 8 bytes
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.4.6. VERIFY_AUTHENTICATION
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Q1(0) Q1(1) … Q1(7)
FFh 82h 00h 00h 08h
Where:
Byte Address Memory address location of the memory card
Q1(0),Q1(1)…Q1(7) Host challenge, 8 bytes
Page 34 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 35
Response Data Format (abData field in the RDR_to_PC_DataBlock)
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 05h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.5.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh B0h
Where:
MSB Byte Address = 0000 00A
LSB Byte Address = A
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
Byte Address
MSB LSB
7A6A5A4 A3A2A1A0
card
MEM_L
b is the memory address location of the memory card
9A8
b is the memory address location of the memory
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
Page 36 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 37
8.3.5.3. READ_PRESENTATION_ERROR_COUNTER_MEMORY_CARD (SLE
4428 and SLE 5528)
This command is used to read the presentation error counter for the secret code.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh B1h 00h 00h 03h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
ERRCNT DUMMY 1 DUMMY 2 SW1 SW2
Where:
ERRCNTError Counter. FFh indicates that the last verification is correct. 00h indicates
that the password is locked (exceeded the maximum number of retries).
Other values indicate that the last verification has failed.
DUMMY Two bytes dummy data read from the card
SW1 SW2 = 90 00h if no error
8.3.5.4. READ_PROTECTION_BIT
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh B2h
Where:
MSB Byte Address = 0000 00A
LSB Byte Address = A
MEM_L Length of protection bits to be read from the card, in multiples of 8
Byte Address
MSB LSB
7A6A5A4 A3A2A1A0
card
bits. Maximum value is 32.
MEM_L = 1 + INT( (number of bits - 1)/8 )
MEM_L
b is the memory address location of the memory card
9A8
b is the memory address location of the memory
For example, to read 8 protection bits starting from memory 0x0010h, the following pseudo-APDU
should be issued:
0xFFh 0xB2h 0x00h 0x10h 0x01h
Page 37 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 38
Response Data Format (abData field in the RDR_to_PC_DataBlock)
PROT 1 … … PROT L SW1 SW2
Where:
PROT y Bytes containing the protection bits
SW1 SW2 = 90 00h if no error
The arrangement of the protection bits in the PROT bytes is as follows:
Px is the protection bit of BYTE x in the response data
‘0’ byte is write protected
‘1’ byte can be written
8.3.5.5. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
Byte Address
CLA INS
MEM_L Byte 1 .... .... Byte N
MSB LSB
FFh D0h
Where:
MSB Byte Address = 0000 00A
LSB Byte Address = A
7A6A5A4 A3A2A1A0
b is the memory address location of the memory card
9A8
b is the memory address location of the memory
card
MEM_L Length of data to be written to the memory card
Byte x Data to be written to the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90
00h if no error
8.3.5.6. WRITE_PROTECTION_MEMORY_CARD
Each byte specified in the command is used in the card to compare the byte stored in a specified
address location. If the data match, the corresponding protection bit is irreversibly programmed to ‘0’.
Page 38 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 39
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
MEM_L Byte 1 .... .... Byte N
MSB LSB
FFh D1h
Where:
Byte Address
MSB Byte Address = 0000 00A
LSB Byte Address = A
7A6A5A4 A3A2A1A0
b is the memory address location of the memory card
9A8
b is the memory address location of the memory
card
MEM_L Length of data to be written to the memory card
Byte x Byte values to be compared with the data in the card starting at Byte
Address. BYTE 1 is compared with the data at Byte Address; BYTE
N is compared with the data at (Byte Address+N-1).
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.5.7. PRESENT_CODE_MEMORY_CARD (SLE 4428 and SLE 5528)
This command is used to submit the secret code to the memory card to enable the write operation
with the SLE 4428 and SLE 5528 card, the following actions are executed:
1. Search a ‘1’ bit in the presentation error counter and write the bit to ‘0’.
2. Present the specified code to the card.
3. Try to erase the presentation error counter.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh 20h 00h 00h 02h
Where:
CODETwo bytes secret code (PIN)
Response Data Format (abData field in the RDR_to_PC_DataBlock)
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 06h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.6.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh B0h 00h
Where:
Byte Address = A
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
7A6A5A4 A3A2A1A0b
is the memory address location of the memory card
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
Page 41 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 42
8.3.6.3. READ_PRESENTATION_ERROR_COUNTER_MEMORY_CARD (SLE
4442 and SLE 5542)
This command is used to read the presentation error counter for the secret code.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh B1h 00h 00h 04h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
ERRCNT DUMMY 1 DUMMY 2 DUMMY 3 SW1 SW2
Where:
ERRCNTError counter. 07h indicates that the last verification is correct. 00h indicates
that the password is locked (exceeded the maximum number of retries).
Other values indicate that the last verification has failed.
DUMMY Three bytes dummy data read from the card
SW1 SW2 = 90 00h if no error
8.3.6.4. READ_PROTECTION_BITS
To read the protection bits for the first 32 bytes.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh B2h 00h 00h 04h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
PROT 1 PROT 2 PROT 3 PROT 4 SW1 SW2
Where:
PROT y Bytes containing the protection bits from protection memory
SW1 SW2 = 90 00h if no error
The arrangement of the protection bits in the PROT bytes is as follows:
Px is the protection bit of BYTE x in the response data
Page 42 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 43
‘0’ byte is write protected
‘1’ byte can be written
8.3.6.5. WRITE_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L Byte 1 .... .... Byte N
FFh D0h 00h
Where:
Byte Address= A
7A6A5A4 A3A2A1A0
b is the memory address location of the memory
card
MEM_L Length of data to be written to the memory card
Byte x Data to be written to the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.6.6. WRITE_PROTECTION_MEMORY_CARD
Each byte specified in the command is internally in the card compared with the byte stored at the
specified address and if the data match, the corresponding protection bit is irreversibly programmed to
‘0’.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L Byte 1 .... .... Byte N
FFh D1h 00h
Where:
Byte Address = 000A
A3A2A1A0b (00h to 1Fh) is the protection memory address
4
location of the memory card
MEM_L Length of data to be written to the memory card
Byte x Byte values to be compared with the data in the card starting at Byte
Address. BYTE 1 is compared with the data at Byte Address; BYTE N is
compared with the data at (Byte Address+N-1).
Page 43 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 44
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.6.7. PRESENT_CODE_MEMORY_CARD (SLE 4442 and SLE 5542)
To submit the secret code to the memory card to enable the write operation with the SLE 4442 and
SLE 5542 card, the following actions are executed:
1. Search a ‘1’ bit in the presentation error counter and write the bit to ‘0’.
2. Present the specified code to the card.
3. Try to erase the presentation error counter.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh 20h 00h 00h 03h
Where:
CODEThree bytes secret code (PIN)
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1
90h
Where:
SW1 = 90h
SW2 (ErrorCnt) = Error Counter. 07h indicates that the verification is correct. 00h
SW2
ErrorCnt
indicates the password is locked (exceeded the maximum number of
retries). Other values indicate that the current verification has failed.
Byte 1 Byte 2 Byte 3
CODE
8.3.6.8. CHANGE_CODE_MEMORY_CARD (SLE 4442 and SLE 5542)
This command is used to write the specified data as new secret code in the card.
The current secret code must be presented to the card with the PRESENT_CODE command prior to
the execution of this command.
Page 44 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 45
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CODE
CLA INS P1 P2 MEM_L
FFh D2h 00h 01h 03h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 07h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.7.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh B0h 00h
Where:
Byte Address = Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
8.3.7.3. WRITE_ONE_BYTE_MEMORY_CARD
This command is used to write one byte to the specified address of the inserted card. The byte is
written to the card with LSB first, i.e., the bit at card address 0 is regarded as the LSB of byte 0.
Four different WRITE modes are available for this card type, which are distinguished by a flag in the
Page 46 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 47
command data field:
a) Write
The byte value specified in the command is written to the specified address. This command
can be used for writing personalization data and counter values to the card.
b) Write with carry
The byte value specified in the command is written to the specified address and the command
is sent to the card to erase the next lower counter stage. Thus, this write mode can only be
used for updating the counter value in the card.
c) Write with backup enabled (SLE 4436, SLE 5536 and SLE 6636 only)
The byte value specified in the command is written to the specified address. This command
can be used for writing personalization data and counter values to the card. Backup bit is
enabled to prevent data loss when card tearing occurs.
d) Write with carry and backup enabled (SLE 4436, SLE 5536 and SLE 6636 only)
The byte value specified in the command is written to the specified address and the command
is sent to the card to erase the next lower counter stage. Thus, this write mode can only be
used for updating the counter value in the card. Backup bit is enabled to prevent data loss
when card tearing occurs.
With all write modes, the byte at the specified card address is not erased prior to the write operation
and, hence, memory bits can only be programmed from '1' to '0'.
The backup mode available in the SLE 4436 and SLE 5536 card can be enabled or disabled in the
write operation.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L MODE BYTE
FFh D0h 00h 02h
Where:
Byte Address = Memory address location of the memory card
MODE Specifies the write mode and backup option
00h: Write
01h: Write with carry
02h: Write with backup enabled (SLE 4436, SLE 5536 and SLE 6636
only)
03h: Write with carry and with backup enabled (SLE 4436, SLE 5536 and
SLE 6636 only)
BYTE Byte value to be written to the card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
Page 47 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 48
8.3.7.4. PRESENT_CODE_MEMORY_CARD
To submit the secret code to the memory card to enable the card personalization mode, the following
actions are executed:
1. Search a '1' bit in the presentation counter and write the bit to '0'.
2. Present the specified code to the card.
ACR3801 does not try to erase the presentation counter after the code submission. This must be
done by the application software through a separate ‘Write with carry' command.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
ADDR Byte 1 Byte 2 Byte 3
FFh 20h 00h 00h 04h 09h
Where:
ADDR Byte address of the presentation counter in the card
CODE Three bytes secret code (PIN)
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
CODE
8.3.7.5. AUTHENTICATE_MEMORY_CARD (SLE 4436, SLE 5536 and SLE
6636)
To read a card authentication certificate from a SLE 5536 or SLE 6636 card, the ACR3801 executes
the following actions:
1. Select Key 1 or Key 2 in the card as specified in the command.
2. Present the challenge data specified in the command to the card.
3. Generate the specified number of CLK pulses for each bit of authentication data computed by
the card.
4. Read 16 bits of authentication data from the card.
5. Reset the card to normal operation mode.
The authentication has to be performed in two steps. The first step is to send the Authentication
Certificate to the card. The second step is to get back two bytes of authentication data calculated by
the card.
Page 48 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 49
Step 1: Send Authentication Certificate to the Card
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
KEY CLK_CNT Byte 1 Byte 2 …… Byte 5 Byte 6
FFh 84h 00h 00h 08h
Where:
KEY Key to be used for the computation of the authentication certificate:
00h: Key 1 with no cipher block chaining
01h: Key 2 with no cipher block chaining
80h: Key 1 with cipher block chaining (SLE 5536 and SLE 6636 only)
81h: Key 2 with cipher block chaining (SLE 5536 and SLE 6636 only)
CLK_CNTNumber of CLK pulses to be supplied to the card for the computation of each
bit of the authentication certificate. Typical value is 160 clocks (A0)
BYTE 1...6Card challenge data
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
61h 02h
Where:
CODE
SW1 SW2 = 61 02h if no error, meaning two bytes of authentication data are ready. The
authentication data can be retrieved by Get_Response command.
Step 2: Get back the Authentication Data (Get_Response)
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 MEM_L
FFh C0h 00h 00h 02h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
CERT SW1 SW2
Where:
CERT16 bits of authentication data computed by the card. The LSB of BYTE 1 is
the first authentication bit read from the card.
SW1 SW2= 90 00h if no error
Page 49 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 50
8.3.8. Memory Card – SLE 4404
8.3.8.1. SELECT_CARD_TYPE
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 08h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.8.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh B0h 00h
Where:
Byte Address = Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
8.3.8.3. WRITE_MEMORY_CARD
This command is used to write data to the specified address of the inserted card. The byte is written
to the card with LSB first, i.e., the bit at card address 0 is regarded as the LSB of byte 0.
The byte at the specified card address is not erased prior to the write operation and, hence, memory
Page 50 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 51
bits can only be programmed from '1' to '0'.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L Byte 1 … … Byte N
FFh D0h 00h
Where:
Byte Address = Memory address location of the memory card
MEM_L Length of data to be written to the memory card
BYTE Byte value to be written to the card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.8.4. ERASE_SCRATCH_PAD_MEMORY_CARD
This command is used to erase the data of the scratch pad memory of the inserted card. All memory
bits inside the scratch pad memory will be programmed to the state of ‘1’.
To erase error counter or user area, please use the VERIFY_USER_CODE command as specified in
the Section 4.8.5.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh D2h 00h 00h
Where:
Byte Address = Memory byte address location of the scratch pad
Typical value is 0x02h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
Page 51 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 52
8.3.8.5. VERIFY_USER_CODE
This command is used to submit User Code (2 bytes) to the inserted card. User Code is to enable the
memory access of the card.
The following actions are executed:
1. Present the specified code to the card.
2. Search a '1' bit in the presentation error counter and write the bit to '0'.
3. Erase the presentation error counter. The User Error Counter can be erased when the
submitted code is correct.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS Error Counter LEN Byte Address MEM_L
FFh 20h 04h 08h 02h
Where:
Error Counter LEN Length of presentation error counter in bits
Byte Address Byte address of the key in the card
CODE 2 bytes User Code
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2= 90 00h if no error
= 63 00h if there are no more retries
Note: After SW1SW2 = 0x9000h has been received, read back the User Error Counter to check
if the VERIFY_USER_CODE is correct. If User Error Counter is erased and is equal to “0xFFh,”
the previous verification is successful.
CODE
Byte 1 Byte 2
8.3.8.6. VERIFY_MEMORY_CODE
This command is used to submit Memory Code (4 bytes) to the inserted card. Memory Code is used
to authorize the reloading of the user memory, together with the User Code.
The following actions are executed:
1. Present the specified code to the card.
2. Search a '1' bit in the presentation error counter and write the bit to '0'.
3. Erase the presentation error counter. Please note that Memory Error Counter cannot be
erased.
Page 52 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 53
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CODE
CLA INS Error Counter LEN Byte Address MEM_L
FFh 20h 40h 28h 04h
Where:
Error Counter LEN Length of presentation error counter in bits
Byte Address Byte address of the key in the card
CODE 4 bytes Memory Code
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
Byte
1
Byte 2 Byte 3 Byte 4
SW1 SW2 = 90 00h if no error
= 63 00h if there are no more retries
Note: After SW1SW2 = 0x9000h has been received, read back the Application Area can check
if the VERIFY_MEMORY_CODE is correct. If all data in Application Area is erased and is equal
to “0xFFh,” the previous verification is successful.
This command powers down and up the selected card that is inserted in the card reader and performs
a card reset.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc Card Type
FFh A4h 00h 00h 01h 09h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.9.2. READ_MEMORY_CARD
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh B0h 00h
Where:
Byte Address = Memory address location of the memory card
MEM_L Length of data to be read from the memory card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
BYTE 1 … … BYTE N SW1 SW2
Where:
BYTE x Data read from memory card
SW1 SW2 = 90 00h if no error
8.3.9.3. WRITE_MEMORY_CARD
This command is used to write data to the specified address of the inserted card. The byte is written
to the card with LSB first, i.e., the bit at card address 0 is regarded as the LSB of byte 0.
The byte at the specified card address is not erased prior to the write operation and, hence, memory
Page 54 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 55
bits can only be programmed from '1' to '0'.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L Byte 1 .... .... Byte N
FFh D0h 00h
Where:
Byte Address Memory address location of the memory card
MEM_L Length of data to be written to the memory card
BYTE Byte value to be written to the card
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
8.3.9.4. ERASE_NON_APPLICATION_ZONE
This command is used to erase the data in Non-Application Zones. The EEPROM memory is
organized into 16-bit words. Although erases are performed on single bit, the ERASE operation clears
an entire word in the memory. Therefore, performing an ERASE on any bit in the word will clear ALL
16 bits of that word to the state of ‘1’.
To erase Error Counter or the data in Application Zones, please refer to the following:
1. ERASE_APPLICATION_ZONE_WITH_ERASE command as specified in Section 8.3.9.5.
2. ERASE_APPLICATION_ZONE_WITH_WRITE_AND_ERASE command as specified in
Section 8.3.9.6.
3. VERIFY_SECURITY_CODE commands as specified in Section 8.3.9.7.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 Byte Address MEM_L
FFh D2h 00h 00h
Where:
Byte Address Memory byte address location of the word to be erased.
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Page 55 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 56
Where:
SW1 SW2 = 90 00h if no error
8.3.9.5. ERASE_APPLICATION_ZONE_WITH_ERASE
This command can be used in the following cases:
1. AT88SC101: To erase the data in Application Zone with EC Function Disabled.
2. AT88SC102: To erase the data in Application Zone 1.
3. AT88SC102: To erase the data in Application Zone 2 with EC2 Function Disabled.
4. AT88SC1003: To erase the data in Application Zone 1.
5. AT88SC1003: To erase the data in Application Zone 2 with EC2 Function Disabled.
6. AT88SC1003: To erase the data in Application Zone 3.
The following actions are executed for this command:
1. Present the specified code to the card
a. Erase the presentation error counter. The data in corresponding Application Zone can be
erased when the submitted code is correct.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh 20h 00h
Where:
Error Counter LEN Length of presentation error counter in bits. The value should be
Byte Address Byte address of the Application Zone Key in the card. Please refer to
Error
Counter LEN
0x00h always.
the table below for the correct value.
AT88SC101: Erase Application Zone with EC function
disabled
AT88SC102: Erase Application Zone 1 56h 06h
AT88SC102: Erase Application Zone 2 with EC2 function
disabled
Byte
Address
MEM_L
CODE
Byte 1 Byte 2 … … Byte N
Byte
Address
96h 04h
9Ch 04h
LEN
AT88SC1003: Erase Application Zone 1 36h 06h
AT88SC1003: Erase Application Zone 2 with EC2
function disabled
AT88SC1003: Erase Application Zone 3 C0h 06h
5Ch 04h
Page 56 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 57
MEM_L Length of the Erase Key. Please refer to the table above for the
correct value.
CODE N bytes of Erase Key
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
Note: After SW1SW2 = 0x9000h has been received, read back the data in Application Zone to
check if the ERASE_APPLICATION_ZONE_WITH_ERASE is correct. If all data in Application
Zone is erased and is equal to “0xFFh,” the previous verification is successful.
1. AT88SC101: To erase the data in Application Zone with EC Function Enabled.
2. AT88SC102: To erase the data in Application Zone 2 with EC2 Function Enabled.
3. AT88SC1003: To erase the data in Application Zone 2 with EC2 Function Enabled.
With EC or EC2 Function Enabled (that is, ECEN or EC2EN Fuse is undamaged and in “1” state), the
following actions are executed:
1. Present the specified code to the card.
2. Search a '1' bit in the presentation error counter and write the bit to '0'.
3. Erase the presentation error counter. The data in corresponding Application Zone can be
erased when the submitted code is correct.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh 20h 80h 04h
Where:
Error Counter LEN Length of presentation error counter in bits. The value should be
Byte Address Byte address of the Application Zone Key in the card
Error
Counter LEN
0x80h always.
Byte
Address
MEM_L
Byte 1 Byte 2 Byte 3 Byte 4
CODE
AT88SC101 96h
AT88SC102 9Ch
AT88SC1003 5Ch
Byte Address
Page 57 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 58
CODE 4 bytes Erase Key
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2= 90 00h if no error
= 63 00h if there are no more retries
Note: After SW1SW2 = 0x9000h has been received, read back the data in Application Zone can
check whether the ERASE_APPLICATION_ZONE_WITH_WRITE_AND_ERASE is correct. If all
data in Application Zone is erased and is equal to “0xFFh,” the previous verification is successful.
8.3.9.7. VERIFY_SECURITY_CODE
This command is used to submit Security Code (2 bytes) to the inserted card. Security Code is to
enable the memory access of the card.
The following actions are executed:
1. Present the specified code to the card.
2. Search a '1' bit in the presentation error counter and write the bit to '0'.
3. Erase the presentation error counter. The Security Code Attempts Counter can be erased
when the submitted code is correct.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS
FFh 20h 08h 0Ah 02h
Where:
Error Counter LEN Length of presentation error counter in bits
Byte Address Byte address of the key in the card
CODE 2 bytes Security Code
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Error
Counter LEN
Byte
Address
MEM_L
CODE
Byte 1 Byte 2
Where:
SW1 SW2= 90 00h if no error
= 63 00h if there are no more retries
Note: After SW1SW2 = 0x9000h has been received, read back the Security Code Attempts
Counter (SCAC) to check whether the VERIFY_USER_CODE is correct. If SCAC is erased
and is equal to “0xFFh,” the previous verification is successful.
Page 58 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 59
8.3.9.8. BLOWN_FUSE
This command is used to blow the fuse of the inserted card. The fuse can be EC_EN Fuse, EC2EN
Fuse, Issuer Fuse or Manufacturer’s Fuse.
Note: The blowing of fuse is an irreversible process.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CODE
CLA INS
Error
Counter LEN
Byte
Address
MEM_L
Fuse Bit
Addr
(High)
Fuse Bit
Addr
(Low)
State of
FUS Pin
State of
RST Pin
FFh 05h 00h 00h 04h 01h
Where:
Fuse Bit Addr (2 bytes)Bit address of the fuse. Please refer to the table below for the
correct value.
State of FUS Pin State of the FUS pin. Should always be 0x01h.
State of RST Pin State of the RST pin. Please refer to below table for the correct
value.
AT88SC101
AT88SC102
Fuse Bit
Addr
(High)
Manufacturer Fuse 05h 80h 01h
EC_EN Fuse 05h C9h 01h
Issuer Fuse 05h E0h 01h
Manufacturer Fuse 05h B0h 01h
EC2EN Fuse 05h F9h 01h
Issuer Fuse 06h 10h 01h
Fuse Bit
Addr
(Low)
State of
RST Pin
00h or
01h
Manufacturer Fuse 03h F8h 00h
AT88SC1003
Response Data Format (abData field in the RDR_to_PC_DataBlock)
SW1 SW2
Where:
SW1 SW2 = 90 00h if no error
EC2EN Fuse 03h FCh 00h
Issuer Fuse 03h E0h 00h
Page 59 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 60
Byte
card type
8.4. Other Commands Access via PC_to_RDR_XfrBlock
8.4.1. GET_READER_INFORMATION
This command returns relevant information about ACR3801 and the current operating status, such as,
the firmware revision number, the maximum data length of a command and response, the supported
card types, and whether a card is inserted and powered up or not.
Note: This command can only be used after the logical smart card reader communication has been
established using the SCardConnect( ) API. For details of SCardConnect( ) API, please refer to
PC/SC specifications.
Command Format (abData field in the PC_to_RDR_XfrBlock)
Pseudo-APDU
CLA INS P1 P2 Lc
FFh 09h 00h 00h 10h
Response Data Format (abData field in the RDR_to_PC_DataBlock)
FIRMWARE MAX_C MAX_R C_TYPE C_SEL C_STAT
Where:
FIRMWARE 10 bytes data for firmware version
MAX_C The maximum number of command data bytes
MAX_R The maximum number of data bytes that can be requested to be
transmitted in a response
C_TYPE The card types supported by the ACR3801. This data field is a bitmap
with each bit representing a particular card type. A bit set to '1' means the
corresponding card type is supported by the reader and can be selected
with the SELECT_CARD_TYPE command. The bit assignment is as
follows:
F E D C B A 9 8 7 6 5 4 3 2 1 0
Refer to the next section for the correspondence between these bits and the respective card types.
C_SELThe currently selected card type. A value of 00h means that no card type
has been selected.
C_STAT Indicates whether a card is physically inserted in the reader and whether the
card is powered up:
1 2
00h: No card inserted
01h: Card inserted, not powered up
03h: Card powered up
Page 60 of 62
ACR3801 – Reference Manual info@acs.com.hk
Version 2.01
www.acs.com.hk
Page 61
Appendix A. Supported Card Types
The following table summarizes the card type returned by GET_READER_INFORMATION
correspond with the respective card type.