Api Acr1281u C1 1.11
Api Acr1281u C1 1.11
Page 2 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Release Date Revision Description Version Number
• Updated formatting
• Added Memory Card - ATMEL AT88SC15
and Memory Card - AT88SC101 /
AT88SC102 / AT88SC1003 in Contact
Smart Card Protocol Section 5.1
• Added Memory Card - ATMEL
AT88SC1608 in Contact Smart Card
Protocol Section 5.1
o Select Card Type
o Read Memory Card
o Write Memory Card
o Verify Password
o Initialize Authentication
2014-01-09 o Verify Authentication 1.05
• Removed the following commands under
Section 5.3
o Set Auto PPS
o Read Auto PPS
o Set Antenna Field
o Read Antenna Field Status
o Set User Extra Guard Time Setting
o Read User Extra Guard Time Setting
o Set “616C” Auto Handle Option Setting
o Read “616C” Auto Handle Option
Setting
• Refresh Interface Status
• Updated Section 5.3.10: Set Automatic
2015-10-14 1.06
PICC Polling
• Updated Section 2.0: Features
• Added Section 5.3.17 Set Auto PPS and
Section 5.3.18 Read Auto PPS
2017-01-18 1.07
• Added Note in Appendix D. Escape
Command Example
• Removed FIPS201 in Section 2.0 Features
• Updated Section 2.0: Features
o Added CAC, PIV, PPS, and extended
2018-03-20 APDU Support for Contact Interface 1.08
o Added Short Circuit Protection Feature
o Added REACH Compliance
• Updated Section 2.0: Features
• Transferred Appendix B: Accessing Mifare
2020-01-31 1.09
DESFire tags to Section 5.2.6
• Added Section 5.3.19: Read Serial Number
Page 3 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Release Date Revision Description Version Number
• Updated Section 5.2.1.1: ATR Format for
ISO 14443 Part 3 PICCs
2020-05-27 • Updated Section 5.2.3: PICC Commands 1.10
(T=CL Emulation) for MIFARE 1K/4K
Memory Cards
2020-07-03 • Updated Section 5.3 Peripherals Control 1.11
Page 4 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Table of Contents
1.0. Introduction ............................................................................................................... 7
2.0. Features ..................................................................................................................... 8
3.0. ACR1281U-C1 Architecture ...................................................................................... 9
3.1. Reader Block Diagram...........................................................................................................9
3.2. Communication between PC/SC driver and ICC, PICC and SAM ......................................10
4.0. Hardware Design ..................................................................................................... 11
4.1. USB......................................................................................................................................11
4.1.1. Communication Parameters .......................................................................................11
4.1.2. Endpoints ....................................................................................................................11
4.2. Contact Smart Card Interface ..............................................................................................11
4.2.1. Smart Card Power Supply VCC (C1) ..........................................................................11
4.2.2. Card Type Selection....................................................................................................11
4.2.3. Interface for Microcontroller-based Cards ..................................................................12
4.3. Contactless Smart Card Interface .......................................................................................12
4.3.1. Carrier Frequency .......................................................................................................12
4.3.2. Card Polling.................................................................................................................12
4.4. User Interface ......................................................................................................................12
4.4.1. Buzzer .........................................................................................................................12
4.4.2. LED .............................................................................................................................12
5.0. Software Design ...................................................................................................... 13
5.1. Contact Smart Card Protocol ...............................................................................................13
5.1.1. Memory Card – 1/2/4/8/16 kilobits I2C Card ...............................................................13
5.1.2. Memory Card – 32/64/128/256/512/1024 kbits I2C Card ...........................................16
5.1.3. Memory Card – ATMEL AT88SC153..........................................................................19
5.1.4. Memory Card – ATMEL AT88SC1608........................................................................23
5.1.5. Memory Card – SLE4418/SLE4428/SLE5518/SLE5528 ............................................27
5.1.6. Memory Card – SLE4432/SLE4442/SLE5532/SLE5542 ............................................32
5.1.7. Memory Card – SLE4406/SLE4436/SLE5536/SLE6636 ............................................38
5.1.8. Memory Card – SLE4404 ...........................................................................................43
5.1.9. Memory Card – AT88SC101/AT88SC102/AT88SC1003 ...........................................47
5.2. Contactless Smart Card Protocol ........................................................................................55
5.2.1. ATR Generation ..........................................................................................................55
5.2.2. Pseudo APDUs for Contactless Interface ...................................................................58
5.2.3. PICC Commands (T=CL Emulation) for MIFARE 1K/4K Memory Cards ...................59
5.2.4. Accessing PC/SC-compliant tags (ISO 14443-4) .......................................................69
5.2.5. Accessing MIFARE DESFire tags (ISO 14443-4).......................................................70
5.3. Peripherals Control ..............................................................................................................72
5.3.1. Get Firmware Version .................................................................................................72
5.3.2. LED Control.................................................................................................................73
5.3.3. LED Status ..................................................................................................................74
5.3.4. Buzzer Control ............................................................................................................75
5.3.5. Set Default LED and Buzzer Behaviors ......................................................................76
5.3.6. Read Default LED and Buzzer Behaviors ...................................................................77
5.3.7. Initialize Card Insertion Counter..................................................................................78
5.3.8. Read Card Insertion Counter ......................................................................................79
5.3.9. Update Card Insertion Counter ...................................................................................80
5.3.10. Set Automatic PICC Polling ........................................................................................81
5.3.11. Read Automatic PICC Polling .....................................................................................83
5.3.12. Manual PICC Polling ...................................................................................................84
5.3.13. Set PICC Operating Parameter ..................................................................................85
5.3.14. Read PICC Operating Parameter ...............................................................................86
5.3.15. Set Exclusive Mode.....................................................................................................87
5.3.16. Read Exclusive Mode .................................................................................................88
Page 5 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.17. Set Auto PPS ..............................................................................................................89
5.3.18. Read Auto PPS ...........................................................................................................90
5.3.19. Read Serial Number....................................................................................................91
Appendix A. Basic program flow for contactless applications.................................... 92
Appendix B. Extended APDU Command Example ........................................................ 93
Appendix C. Escape Command Example ...................................................................... 95
Appendix D. Supported Card Types ............................................................................... 96
Appendix E. ACR128 Compatibility ................................................................................ 97
List of Figures
Figure 1 : ACR1281U-C1 Reader Block Diagram .................................................................................. 9
Figure 2 : ACR1281U-C1 Architecture ................................................................................................. 10
List of Tables
Table 1 : USB Interface Wiring ............................................................................................................. 11
Table 2 : Buzzer Event ......................................................................................................................... 12
Table 3 : LED Indicator ......................................................................................................................... 12
Table 4 : Blown Fuse Code Values ...................................................................................................... 53
Table 5 : ISO 14443 Part 3 ATR Format .............................................................................................. 55
Table 6 : ISO 14443 Part 4 ATR Format .............................................................................................. 56
Table 7 : MIFARE 1K Memory Map ...................................................................................................... 62
Table 8 : MIFARE 4K Memory Map ...................................................................................................... 62
Table 9 : MIFARE Ultralight Memory Map ............................................................................................ 63
Page 6 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
1.0. Introduction
The ACR1281U-C1 DualBoost II is the second generation of the ACR128 DualBoost Reader. The
ACR1281U-C1 is a powerful and efficient dual interface smart card reader that can be used to access
ISO 7816 MCU cards, MIFARE® cards and ISO 14443 Type A and B contactless cards. It makes use
of the USB CCID class driver and USB interface to connect to a PC and accept card commands from
the computer application.
The ACR1281U-C1 acts as the intermediary device between the computer and the card. The reader,
which communicates with a contactless tag, MCU card, SAM card, or the device peripherals (LED or
buzzer), will carry out commands issued from the computer. It has three interfaces: the PICC, ICC
and SAM interface, which all follow the PC/SC specifications. The contact interface makes use of the
APDU commands as defined in ISO 7816 specifications. For contact MCU card operations, please
refer to the related card documentation and the PC/SC specifications.
This API document details how the PC/SC APDU commands are implemented for the contactless
interface, contact memory card support and device peripherals of the ACR1281U-C1.
Page 7 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
2.0. Features
• USB Full Speed Interface
• CCID-compliant
• Smart Card Reader:
o Contactless Interface:
▪ Read/Write speed of up to 848 Kbps
▪ Built-in antenna for contactless tag access, with card reading distance of up to 50 mm
(depending on tag type)
▪ Supports ISO 14443 Part 4 Type A and B cards and MIFARE series
▪ Built-in anti-collision feature (only one tag is accessed at any time)
▪ Supports extended APDU (max. 64 KB)
o Contact Interface:
▪ Supports ISO 7816 Class A, B and C (5 V, 3 V and 1.8 V)
▪ Supports CAC (Common Access Card)
▪ Supports PIV (Personal Identity Verification Card)
▪ Supports microprocessor cards with T=0 or T=1 protocol
▪ Supports memory cards
▪ Supports PPS (Protocol and Parameters Selection)
▪ Features Short Circuit Protection
▪ Supports extended APDU (max. 64 KBytes for T=1; max. 512+10 Bytes for T=0)
o SAM Interface:
▪ One SAM Slot
▪ Supports ISO 7816 Class A SAM cards
• Application Programming Interface:
o Supports PC/SC
o Supports CT-API (through wrapper on top of PC/SC)
• Built-in Peripherals:
o Two user-controllable LEDs
o User-controllable buzzer
• USB Firmware Upgradability
• Supports Android™ 3.1 and later1
• Compliant with the following standards:
o ISO 14443
o ISO 7816
o PC/SC
o CCID
o CE
o FCC
o RoHS
o REACH
o Microsoft® WHQL
1
Uses an ACS-defined Android Library
Page 8 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
3.0. ACR1281U-C1 Architecture
3.1. Reader Block Diagram
Page 9 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
3.2. Communication between PC/SC driver and ICC, PICC and
SAM
The protocol being used between the ACR1281U-C1 and the PC is CCID. All communications
between ICC, PICC and SAM are PC/SC-compliant.
Page 10 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
4.0. Hardware Design
4.1. USB
The ACR1281U-C1 connects to a computer through USB following the USB standard.
Note: The device driver should be installed for the ACR1281U-C1 to function properly through USB
interface.
4.1.2. Endpoints
The ACR1281U-C1 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 the host to the ACR1281U-C1 (data packet size is 64
bytes).
Bulk-IN – For response to be sent from the ACR1281U-C1 to the host (data packet size is 64 bytes).
Interrupt-IN – For card status message to be sent from the ACR1281U-C1 to the host (data packet
size is 8 bytes).
Page 11 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
4.2.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.8 MHz is applied to the CLK signal (C3).
Events Buzzer
1. The reader is powered up and successfully initialized. Beep
2. Card Insertion Event (ICC or PICC) Beep
3. Card Removal Event (ICC or PICC) Beep
4.4.2. LED
The LEDs are used for showing the state of the contact and contactless interfaces. The Red LED is
used for showing PICC status and Green LED for ICC.
Page 12 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.0. Software Design
5.1. Contact Smart Card Protocol
5.1.1. Memory Card – 1/2/4/8/16 kilobits I2C Card
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Page Size (1 byte)
03h = 8-byte page write
04h = 16-byte page write
05h = 32-byte page write
06h = 64-byte page write
07h = 128-byte page write
Page 13 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte Address
Command Class INS MEM_L
MSB LSB
Read Memory Card FFh B0h
Where:
Byte Address (2 bytes)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 14 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.1.4. Write memory card
This command writes the memory card’s content to a specified address.
Command
Byte Address
Command Class INS MEM_L Byte 1 … … Byte N
MSB LSB
Where:
Byte Address (2 bytes)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 15 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.2. Memory Card – 32/64/128/256/512/1024 kbits I2C Card
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Page Size (1 byte)
03h = 8-byte page write
04h = 16-byte page write
05h = 32-byte page write
06h = 64-byte page write
07h = 128-byte page write
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 16 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.2.3. Read memory card
This command reads the memory card’s content from a specified address.
Command
Byte Address
Command Class INS MEM_L
MSB LSB
Read Memory Card FFh
Where:
INS (1 byte)
B0h = For 32, 64, 128, 256, 512 kbit I2C card
1011 000*b; where * is the MSB of the 17 bit addressing = For 1024
kbit I2C card
Byte Address (2 bytes)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte Address
Command Class INS MEM_L Byte 1 … … Byte N
MSB LSB
Write Memory
FFh
Card
Where:
INS (1 byte)
D0h = For 32, 64, 128, 256, 512 kbit I2C card
1101 000*b; where * is the MSB of the 17 bit addressing = For 1024
kilobit I2C card
Page 17 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Byte Address (2 bytes)
Memory address location of the memory card
MEM_L (1 Byte)
Length of data to be read from the memory card
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 18 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.3. Memory Card – ATMEL AT88SC153
5.1.3.1. Select card type
This command powers down/up the selected card inserted in the card reader and performs a card
reset. It will also select the page size to be an 8-byte page write.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Card Type
Select Card Type FFh A4h 00h 00h 01h 03h
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Pseudo-APDU
Command Class INS P1 Byte Address MEM_L
Read Memory Card FFh 00h
Where:
INS (1 byte)
For reading zone 00b, INS = B0h
For reading zone 01b, INS = B1h
For reading zone 10b, INS = B2h
For reading zone 11b, INS = B3h
For reading fuse, INS = B4h
Byte Address (1 byte)
Memory address location of the memory card.
MEM_L (1 byte)
Length of data to be read from the memory card.
Page 19 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Byte
Command Class INS P1 MEM_L Byte 1 … … Byte N
Address
Write Memory
FFh 00h
Card
Where:
INS (1 byte)
For reading zone 00b, INS = D0h
For reading zone 01b, INS = D1h
For reading zone 10b, INS = D2h
For reading zone 11b, INS = D3h
For reading fuse, INS = D4h
Byte Address (1 byte)
Memory address location of the memory card.
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 20 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.3.4. Verify password
This command verifies whether the memory card’s password matches the user’s entered PIN.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc RP PW (0) PW (1) PW (2)
Verify
FFh 20h 00h 03h
Password
Where:
PW (0), PW (1), PW (2) = Password to be sent to memory card.
P2 (1 Byte)
= 0000 00r pb
Where the two bits “r p” indicates the password to compare
r = 0: Write password,
r = 1: Read password,
p = Password set number
r p = 01b for the secure code.
Response
Where:
SW1 = 90h
ErrorCnt (1 byte)
= Error Counter
FFh indicates the verification is correct. 00h indicates the password is locked
(exceeded maximum number of retries). Other values indicate the current
verification failed.
Page 21 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.3.5. Initialize authentication
This command initializes the memory card’s authentication.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Q (0) Q (1) … Q (7)
Initialize
FFh 84h 00h 00h 08h
Authentication
Where:
Q (0…7) (8 bytes)
= Host random number
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Ch (0) Ch (1) … Ch (7)
Verify
FFh 82h 00h 00h 08h
Authentication
Where:
Ch (0…7) (8 bytes)
= Host challenge
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 22 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.4. Memory Card – ATMEL AT88SC1608
5.1.4.1. Select card type
This command powers down/up the selected card inserted in the card reader and performs a card
reset. It also selects the page size to be a 16-byte page write.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Card Type
Select Card Type FFh A4h 00h 00h 01h 04h
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Command Class INS Zone Address Byte Address MEM_L
Read Memory Card FFh
Where:
INS (1 byte)
For reading user zone, INS = B0h
For reading configuration zone or reading fuse, INS = B1h
Zone Address (1 byte)
= 00000 A10 A9 A8b, where A10 is the MSB of zone address
** don’t care for reading fuse
Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
For reading fuse, Byte Address = 1000 0000b
MEM_L (1 byte)
Length of data to be read from the memory card.
Page 23 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Zone Byte
Command Class INS MEM_L Byte 1 … … Byte N
Address Address
Write Memory
FFh
Card
Where:
INS (1 byte)
For reading user zone, INS = D0h
For reading configuration zone or reading fuse, INS = D1h
Zone Address (1 byte)
= 00000 A10 A9 A8b, where A10 is the MSB of zone address
** don’t care for reading fuse
Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
For reading fuse, Byte Address = 1000 0000b
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 24 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.4.4. Verify password
This command verifies if the memory card’s password matches the user’s entered PIN.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc RP PW (0) PW (1) PW (2)
Verify
FFh 20h 00h 00h 04h
Password
Where:
PW (0), PW (1), PW (2) = Password to be sent to memory card.
RP (1 byte)
= 0000 r p2 p1 p0b
Where the two bits “r p2 p1 p0” indicate the password to compare
r = 0 : Write password,
r = 1: Read password,
p2 p1 p0 = Password set number
r p2 p1 p0 = 0111b for the secure code.
Response
Where:
SW1 = 90h
ErrorCnt (1 byte)
= Error Counter
FFh indicates the verification is correct. 00h indicates the password is locked
(exceeded maximum number of retries). Other values indicate the current
verification failed.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Q (0) Q (1) … Q (7)
Initialize
FFh 84h 00h 00h 08h
Authentication
Where:
Q (0…7) (8 bytes)
= Host random number
Page 25 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Ch (0) Ch (1) … Ch (7)
Verify
FFh 82h 00h 00h 08h
Authentication
Where:
Ch (0…7) (8 bytes)
= Host challenge
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 26 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.5. Memory Card – SLE4418/SLE4428/SLE5518/SLE5528
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte Address
Command Class INS MEM_L
MSB LSB
Read Memory Card FFh B0h
Where:
MSB Byte Address (1 byte)
= 0000 00 A9 A8b is the memory address location of the memory
card
LSB Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 27 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.5.3. Read presentation error counter memory card (for SLE4428 and
SLE5528 only)
This command reads the presentation error counter for the secret code.
Command
Response
Where:
ErrCnt (1 byte)
The value of the presentation error counter
FFh = indicates the verification is correct
00h = indicates the password is locked (exceeding the maximum
number of retries)
Other values indicate the verification failed.
Dummy 1, Dummy 2 (2 bytes)
Dummy data read from the card
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte Address
Command Class INS MEM_L
MSB LSB
Read Protection Bit FFh B2h
Where:
MSB Byte Address (1 byte)
The memory address location of the memory card
= 0000 00 A9 A8b
LSB Byte Address (1 byte)
The memory address location of the memory card
= A7 A6 A5 A4 A3 A2 A1 A0b
Page 28 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
MEM_L (1 byte)
Length of protection bits read from the card, in multiples of 8 bits. The
maximum value is 32.
MEM_L = 1 + INT ((number of bits – 1)/8)
For example, to read 8 protection bits starting from memory 0010h,
the following pseudo-APDU should be issued:
FF B1 00 10 01h
Response
Where:
PROT (1..L) Bytes containing the protection bits.
SW1 SW2 = 90 00h if the operation was completed successfully.
PROT 1 PROT 2 ….
P8 P7 P6 P5 P4 P3 P2 P1 P16 P15 P14 P13 P12 P11 P10 P9 .. .. .. .. .. .. P18 P17
Where:
Px is the protection bit of byte x in response data:
0 = byte is write protected
1 = byte can be written
Command
Byte Address
Command Class INS MEM_L Byte 1 … … Byte N
MSB LSB
Write Memory Card FFh D0h
Where:
MSB Byte Address (1 byte)
= 0000 00 A9 A8b is the memory address location of the memory
card
LSB Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
MEM_L (1 byte)
Length of data to be written to the memory card
Page 29 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte Address
Command Class INS MEM_L Byte 1 … … Byte N
MSB LSB
Write Protection
FFh D1h
Memory Card
Where:
MSB Byte Address (1 byte)
= 0000 00 A9 A8b is the memory address location of the memory
card
LSB Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Byte values compared with the data in the card starting at the 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
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 30 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.5.7. Present code memory card (for SLE44428 and SLE5528 only)
This command submits the secret code to the memory card to enable the write operation with the
SLE4428 and SLE5528 cards. The following actions are executed:
1. Search a ‘1’ bit in the presentation error counter and write the bit ‘0’.
2. Present the specified code to the card.
3. Try to erase the presentation error counter.
Command
Code
Command Class INS P1 P2 MEM_L
Byte 1 Byte 2
Present Code Memory Card FFh 20h 00h 00h 02h
Where:
Code (3 bytes)
Secret code (PIN)
Response
Where:
ErrorCnt (1 byte)
Error Counter
FFh = indicates the verification is correct.
00h = indicates the password is locked (exceeding maximum number of
retries).
Other values indicate the verification failed.
Page 31 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.6. Memory Card – SLE4432/SLE4442/SLE5532/SLE5542
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully
Command
Where:
Byte Address (1 byte)
=A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
PROT (1…4) Bytes containing the protections bits from protection.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 32 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
The arrangement of the protection bits in the PROT bytes is as follows:
PROT 1 PROT 2 ….
P8 P7 P6 P5 P4 P3 P2 P1 P16 P15 P14 P13 P12 P11 P10 P9 .. .. .. .. .. .. P18 P17
Where:
Px is the protection bit of byte x in response data:
0 = byte is write protected
1 = byte can be written
5.1.6.3. Read presentation error counter memory card (for SLE4442 and
SLE5542 only)
This command reads the presentation error counter for the secret code.
Command
Response
Where:
ErrCnt (1 byte)
The value of the presentation error counter
07h = indicates the verification is correct.
00h = indicates the password is locked (exceeded the maximum
number of retries).
Other values indicate the verification failed.
Dummy 1, Dummy 2, Dummy 3 (3 bytes)
Dummy data read from the card
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 33 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.6.4. Read Protection Bit
This command reads the protection bits for the first 32 bytes.
Command
Response
Where:
PROT (1..4) Bytes containing the protection bits.
SW1 SW2 = 90 00h if the operation was completed successfully.
PROT 1 PROT 2 ….
P8 P7 P6 P5 P4 P3 P2 P1 P16 P15 P14 P13 P12 P11 P10 P9 .. .. .. .. .. .. P18 P17
Where:
Px protection bit of bytes in the response data:
0 = byte is write protected
1 = byte can be written
Command
Where:
Byte Address (1 byte)
= A7 A6 A5 A4 A3 A2 A1 A0b is the memory address location of the
memory card
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Data to be written to the memory card.
Page 34 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Byte
Command Class INS P1 MEM_L Byte 1 … … Byte N
Address
Write Protection
FFh D1h 00h
Memory Card
Where:
Byte Address (1 byte)
= 000A4 A3 A2 A1b (00h – 1Fh) is the protection memory address
location of the memory card
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Byte values compared with the data in the card starting at the 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
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 35 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.6.7. Present code memory card (for SLE4442 and SLE5542 only)
This command submits the secret code to the memory card to enable the write operation with the
SLE4442 and SLE5542 card. The following actions are executed:
1. Search a ‘1’ bit in the presentation error counter and write bit ‘0’.
2. Present the specified code to the card.
3. Try to erase the presentation error counter.
Command
Code
Command Class INS P1 P2 MEM_L
Byte 1 Byte 2 Byte 3
Present Code
FFh 20h 00h 00h 03h
Memory Card
Where:
Code (3 bytes)
Secret code (PIN)
Response
Where:
ErrorCnt (1 byte)
Error Counter
07h = indicates the verification is correct.
00h = indicates the password is locked (exceeded the maximum number of
retries).
Other values indicate the verification failed.
Page 36 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.6.8. Change code memory card (for SLE4442 and SLE5542 only)
This command writes the specified data as the new secret code in the card. The existing secret code
must be presented to the card using the “Present Code” command prior to the execution of this
command.
Command
Code
Command Class INS P1 P2 MEM_L
Byte 1 Byte 2 Byte 3
Change Code
FFh D2h 00h 01h 03h
Memory Card
Where:
Code (3 bytes)
Secret code (PIN)
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 37 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.7. Memory Card – SLE4406/SLE4436/SLE5536/SLE6636
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Byte Address (1 byte)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 38 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.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 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
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. This mode can therefore only be used for
updating the counter value in the card.
c. Write with backup enabled (for SLE4436, SLE5536 and SLE6636 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 (SLE4436, SLE5536 and SLE6636 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. This mode can therefore 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 SLE4436 and SLE5536 card can be enabled or disabled in the
write operation.
Command
Where:
Byte Address (1 byte)
Memory address location of the memory card
Mode (1 byte)
Specifies the write mode and backup option
00h = Write.
01h = Write with carry.
02h = Write with backup enabled (for SLE4436, SLE5536 and
SLE6636 only).
03h = Write with carry and with backup enabled (for SLE4436,
SLE5536 and SLE6636 only).
Byte (1 byte)
Byte value to be written to the card
Page 39 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Code
Command Class INS P1 P2 MEM_L
Addr Byte 1 Byte 2 Byte 3
Present Code
FFh 20h 00h 00h 04h 09h
Memory Card
Where:
Addr (1 byte)
Byte address of the presentation counter in the card
Code (3 bytes)
Secret code (PIN)
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 40 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.7.5. Authenticate memory card (for SLE4436, SLE5536 and SLE6636
only)
This command reads the authentication certificate from the card. The following actions are executed:
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 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 is 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.
Code
Command Class INS P1 P2 MEM_L
Key CLK_CNT Byte 1 … Byte 6
Send
Authentication FFh 84h 00h 00h 08h
Certificate
Where:
Key (1 byte)
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 (for SLL5536 and SLE6636
only).
81h = Key 2 with cipher block chaining (for SLL5536 and SLE6636
only).
CLK_CNT (1 byte)
Number of CLK pulses to be supplied to the card for the computation
of each bit of the authentication certificate. Typical value is 160
clocks (A0h).
Byte (1...6) Card challenge data.
Response
Page 41 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Step 2: Get the authentication data (Get Response).
Command
Response
Where:
Cert (2 bytes)
16 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 the operation was completed successfully.
Page 42 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.8. Memory Card – SLE4404
Command
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Byte Address (1 byte)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be read from the memory card
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 43 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.8.3. Write memory card
This command writes the memory card’s content to a specified address. 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
bits can only be programmed from ‘1’ to ‘0’.
Command
Byte
Command Class INS P1 MEM_L Byte 1 … … Byte N
Address
Write Memory Card FFh D0h 00h
Where:
Byte Address (1 byte)
Memory address location of the memory card
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Data to be written to the memory card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Byte Address (1 byte)
Memory byte address location of the scratch pad. Typical value is
02h.
Page 44 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Where:
Error Counter LEN (1 byte)
Length of presentation error counter in bits
Byte Address (1 byte)
Byte address of the key in the card
Code (1 byte)
User Code
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
= 63 00h if there are no more retries left.
Note: After SW1 SW2 = 90 00h has been received, read back the User Error Counter to check
whether the Verify_User_Code is correct. If the User Error Counter is erased and is equal to ‘FFh’, the
previous verification was successful.
Page 45 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.8.6. Verify memory code
This command submits memory code (4 bytes) to the inserted card. The 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.
Note: The Memory Error Counter cannot be erased.
Command
Error Code
Byte
Command Class INS Counter MEM_L
Address
LEN Byte 1 Byte 2 Byte 3 Byte 4
Verify Memory
FFh 20h 40h 28h 04h
Code
Where:
Error Counter LEN (1 byte)
Length of presentation error counter in bits
Byte Address (1 byte)
Byte address of the key in the card
Code (4 bytes)
Memory Code
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
= 63 00h if there are no more retries left.
Note: After SW1 SW2 = 90 00h has been received, read back the User Error Counter to check
whether the Verify Memory Code is correct. If all data in Application Area is erased and is equal to
‘FFh’, the previous verification was successful.
Page 46 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.9. Memory Card – AT88SC101/AT88SC102/AT88SC1003
5.1.9.1. Select card type
This command powers down and up the selected card inserted in the card reader and performs a card
reset.
Command
Pseudo-APDU
Command Class INS P1 P2 Lc Card Type
Select Card Type FFh A4h 00h 00h 01h 09h
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Command Class INS P1 Byte Address MEM_L
Read Memory Card FFh B0h 00h
Where:
Byte Address (1 byte)
Memory address location of the memory card.
MEM_L (1 byte)
Length of data to be read from the memory card.
Response
Where:
Byte (1…N) Data read from memory card.
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 47 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.9.3. Write Memory Card
This command writes 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
bits can only be programmed from '1' to '0'.
Command
Pseudo-APDU
Byte
Command Class INS P1 MEM_L Byte 1 … … Byte N
Address
Write Memory
FFh D0h 00h
Card
Where:
Byte Address (1 byte)
Memory address location of the memory card.
MEM_L (1 byte)
Length of data to be written to the memory card
Byte (1…N) Byte value to be written to the card.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Page 48 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Command
Pseudo-APDU
Command Class INS P1 Byte Address MEM_L
Erase Non-Application Zone FFh D2h 00h 00h
Where:
Byte Address (1 byte)
Memory byte address location of the word to be erased.
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Command
Pseudo-APDU
Error CODE
Byte
Command Class INS Counter MEM_L Byte Byte Byte
Address … …
LEN 1 2 N
Erase
Application
FFh 20h 00h
Zone with
Erase
Where:
Error Counter LEN (1 byte)
= Length of presentation error counter in bits. The value should be
00h always.
Page 49 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Byte Address (1 byte)
= Byte address of the Application Zone Key in the card. Please refer
to the table below for the correct value.
MEM_L (1 byte)
= Length of the Erase Key. Please refer to the table below for the
correct value.
CODE (1…N) = Erase Key
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
Note: After SW1SW2 = 90 00h been received, read back the data in Application Zone can check
whether the Erase Application Zone with Erase is correct. If all data in Application Zone is erased and
equals to “FFh”, the previous verification was successful.
With EC or EC2 Function Enabled (that is, ECEN or EC2EN Fuse is unblown 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.
Page 50 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Command
Pseudo-APDU
Error CODE
Byte
Command Class INS Counter MEM_L Byte Byte Byte Byte
Address
LEN 1 2 3 4
Erase
Application
Zone with FFh 20h 80h 04h
Write and
Erase
Where:
Error Counter LEN (1 byte)
= Length of presentation error counter in bits. The value should be
80h always.
Byte Address (1 byte)
= Byte address of the Application Zone Key in the card. Please refer
to the table below for the correct value.
CODE (4 bytes)
= Erase Key
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
= 63 00 if there are no more retries left.
Note: After SW1SW2 = 90 00 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 equals to “FFh”, the previous verification was successful.
Page 51 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.9.7. Verify Security Code
This command submits the Security Code (2 bytes) to the inserted card. The Security Code enables
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
Pseudo-APDU
Byte CODE
Command Class INS Error Counter LEN MEM_L
Address Byte 1 Byte 2
Verify
Security FFh 20h 08h 0Ah 02h
Code
Where:
Error Counter LEN (1 byte)
= Length of presentation error counter in bits.
Byte Address (1 byte)
= Byte address of the key in the card.
CODE (2 bytes)
= Security Code
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
= 63 00 if there are no more retries left.
Note: After SW1SW2 = 90 00h been received, read back the Security Code Attempts Counter
(SCAC) can check whether the Verify User Code is correct. If SCAC is erased and equals to “FFh”,
the previous verification was successful.
Page 52 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.1.9.8. Blow Fuse
This command blows the fuse of the inserted card. The fuse can be EC_EN Fuse, EC2EN Fuse,
Issuer Fuse or Manufacturer’s Fuse.
Note: Blowing the fuse is an irreversible process.
Command
Pseudo-APDU
CODE
Error Fuse Fuse State State
Byte
Command Class INS Counter MEM_L Bit Bit of of
Address
LEN Addr Addr FUS RST
(High) (Low) Pin Pin
Blown 00h
FFh 05h 00h 00h 04h 01h
Fuse 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 (1 byte)
= State of the FUS pin. Should be 01h always.
State of RST Pin (1 byte)
= State of the RST pin. Please refer to below table for the correct
value.
Page 53 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h if the operation was completed successfully.
= 63 00 if there are no more retries left.
Page 54 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2. Contactless Smart Card Protocol
5.2.1. ATR Generation
If the reader detects a PICC, an ATR will be sent to the PC/SC driver for identifying the PICC.
Example:
ATR for MIFARE 1K = {3B 8F 80 01 80 4F 0C A0 00 00 03 06 03 00 01 00 00 00 00 6Ah}
ATR
Initial Card
T0 TD1 TD2 T1 Tk Length RID Standard RFU TCK
Header Name
A0
00
00
00h 00
3Bh 8Fh 80h 01h 80h 4Fh 0Ch 00 03h 6Ah
01h 00
03
00h
06h
Where:
Length (YY) = 0Ch
Page 55 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
RID = A0 00 00 03 06h (PC/SC Workgroup)
Standard (SS) = 03h (ISO 14443A, Part 3)
Card Name (C0 ... C1) [00 01h] (MIFARE 1K)
[00 02h] (MIFARE 4K)
[00 03h] (MIFARE Ultralight)
[00 26h] (MIFARE Mini)
[FF 28h] JCOP 30
FF SAK undefined tags
[00 36h] (MIFARE PLUS SL1_2K)
[00 37h] (MIFARE PLUS SL1_4K)
[00 38h] (MIFARE PLUS SL2_2K) Additional ATR support for
FW532 and above
[00 39h] (MIFARE PLUS SL2_4K)
[00 3Ah] (MIFARE Ultralight C)
4 to XX ISO 14443B:
3+N XX Tk Byte1-4 Byte5-7 Byte8
XX Application Protocol Info Higher nibble=MBLI
Data from Byte from from ATTRIB
ATQB ATQB command Lower
nibble (RFU)=0
Page 56 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Example 1: Consider the ATR from MIFARE DESFire as follows:
DESFire (ATR) = 3B 81 80 01 80 80h (6 bytes of ATR)
Note: Use the APDU “FF CA 01 00 00h” to distinguish the ISO 14443A-4 and ISO 14443B-4 PICCs
and retrieve the full ATS if available. The ATS is returned for ISO 14443A-3 or ISO 14443B-3/4
PICCs.
APDU Command = FF CA 01 00 00h
APDU Response = 06 75 77 81 02 90 00h
ATS = {06 75 77 81 02 80h}
Example 2: Consider the ATR from EZ-Link as follows:
EZ-Link (ATR) = 3B 88 80 01 1C 2D 94 11 F7 71 85 00 BEh
Application Data of ATQB = 1C 2D 94 11h
Protocol Information of ATQB = F7 71 85h
MBLI of ATTRIB = 00h
Page 57 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.2. Pseudo APDUs for Contactless Interface
Command
Response Code
Page 58 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3. PICC Commands (T=CL Emulation) for MIFARE 1K/4K Memory Cards
5.2.3.1. Load authentication keys
This command loads the authentication keys into the reader. The authentication keys are used to
authenticate the specified sector of the MIFARE 1K/4K Memory Card. Two kinds of authentication key
locations are provided, volatile and non-volatile key locations.
Command
Where:
Key Structure (1 byte)
00h = Key is loaded into the reader’s volatile memory
20h = Key is loaded into the reader’s non-volatile memory
Other = Reserved.
Key Number (1 byte)
00h – 1Fh = Non-volatile memory for storing keys. The keys are
permanently stored in the reader and will not be erased even if the
reader is disconnected from the PC. It can store up to 32 keys inside
the reader non-volatile memory.
20h (Session Key) = Volatile memory for temporarily storing keys.
The keys will be erased when the reader is disconnected from the
PC. Only one volatile memory is provided. The volatile key can be
used as a session key for different sessions. Default value = FF FF
FF FF FF FFh.
Key (6 bytes)
The key value loaded into the reader.
E.g. {FF FF FF FF FF FFh}
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Page 59 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Example1:
Load a key { FF FF FF FF FF FFh } into the non-volatile memory location 05h.
APDU = {FF 82 20 05 06 FF FF FF FF FF FFh}
Page 60 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.2. Authentication for MIFARE 1K/4K
This command is used to authenticate the MIFARE 1K/4K card (PICC) using the keys stored in the
reader. Two types of authentication keys are used: Type_A and Type_B.
Command
Where:
Authenticate Data Bytes (5 bytes)
Where:
Block Number (1 byte)
The memory block to be authenticated.
Note: For MIFARE 1K card, it has a total of 16 sectors and each sector consists of 4
consecutive blocks. For example, Sector 00h consists of Blocks {00h, 01h, 02h and 03h};
Sector 01h consists of Blocks {04h, 05h, 06h and 07h}; the last sector 0Fh consists of Blocks
{3Ch, 3Dh, 3Eh and 3Fh}.
Once the authentication is done successfully, there is no need to do the authentication again
provided that the blocks to be accessed belong to the same sector. Please refer to the
MIFARE 1K/4K specification for more details.
Page 61 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Sectors
Data Blocks
(Total of 16 sectors. Each Trailer Block
(3 blocks, 16 bytes per
sector consists of 4 (1 block, 16 bytes)
block)
consecutive blocks)
Sector 0 00h ~ 02h 03h
Sector 1 04h ~ 06h 07h
..
1 KB
..
Sector 14 38h ~ 0Ah 3Bh
Sector 15 3Ch ~ 3Eh 3Fh
Sectors
Data Blocks
(Total of 32 sectors. Each Trailer Block
(3 blocks, 16 bytes per
sector consists of 4 (1 block, 16 bytes
block)
consecutive blocks)
Sector 0 00h ~ 02h 03h
Sector 1 04h ~ 06h 07h
... 2 KB
...
Sector 30 78h ~ 7Ah 7Bh
Sector 31 7Ch ~ 7Eh 7Fh
Sectors
Data Blocks
(Total of 32 sectors. Each Trailer Block
(3 blocks, 16 bytes per
sector consists of 4 (1 block, 16 bytes
block)
consecutive blocks)
Sector 32 80h ~ 8Eh 8Fh
Sector 33 90h ~ 9Eh 9Fh
... 2 KB
...
Sector 38 E0h ~ EEh EFh
Sector 39 F0h ~ FEh FFh
Page 62 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Example 1:
To authenticate Block 04h with the following characteristics: Key A, key number 00h, from PC/SC
V2.01 (Obsolete).
APDU = { FF 88 00 04 60 00h }
Example 2:
Similar to the previous example, to authenticate Block 04h with the following characteristics: Key A,
key number 00h, from PC/SC V2.07.
APDU = { FF 86 00 00 05 01 00 04 60 00h }
Note: MIFARE® Ultralight does not need authentication since it provides free access to the user data
area.
Page 63 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.3. Read binary blocks
This command retrieves multiple data blocks from the PICC. The data block/trailer must be
authenticated first before executing this command.
Command
Where:
Block Number (1 byte)
Starting Block
Number of Bytes to Read The length of the bytes to be read can be a multiple of 16 bytes
for MIFARE 1K/4K or a multiple of 4 bytes for MIFARE Ultralight
(1 Byte).
Maximum of 16 bytes for MIFARE Ultralight.
Maximum of 48 bytes for MIFARE 1K (Multiple Blocks Mode; 3
consecutive blocks).
Maximum of 240 bytes for MIFARE 4K (Multiple Blocks Mode; 15
consecutive blocks).
Example 1: 10h (16 bytes). Starting block only. (Single Block Mode)
Example 2: 40h (64 bytes). From starting block to starting block +3. (Multiple Blocks Mode)
Note: For security considerations, the Multiple Block Mode is used for accessing data blocks only.
The Trailer Block is not supposed to be accessed in Multiple Blocks Mode. Please use Single Block
Mode to access the Trailer Block.
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Example 1: Read 16 bytes from the binary block 04h (MIFARE 1K or 4K).
APDU = { FF B0 00 04 10h }
Example 2: Read 240 bytes starting from the binary block 80h (MIFARE 4K). Block 80h to Block 8Eh
(15 blocks).
APDU = { FF B0 00 80 F0 }
Page 64 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.4. Update binary blocks
This command writes multiple data blocks into the PICC. The data block/trailer block must be
authenticated first before executing this command.
Command
Where:
Block Number (1 byte)
Starting Block
Block Data Multiple of 16 + 2 Bytes, or 6 Bytes. Data to be written into
the binary blocks.
Number of Bytes to Read The length of the bytes to be read can be a multiple of 16
bytes for MIFARE 1K/4K or a multiple of 4 bytes for MIFARE
Ultralight (1 byte).
Maximum of 16 bytes for MIFARE Ultralight.
Maximum of 48 bytes for MIFARE 1K (Multiple Blocks Mode;
3 consecutive blocks).
Maximum of 240 bytes for MIFARE 4K (Multiple Blocks
Mode; 15 consecutive blocks).
Example 1: 10h (16 bytes). Starting block only. (Single Block Mode)
Example 2: 30h (48 bytes). From starting block to starting block +2. (Multiple Blocks Mode)
Note: For security considerations, the Multiple Block Mode is used for accessing data blocks only.
The Trailer Block is not supposed to be accessed in Multiple Blocks Mode. Please use Single Block
Mode to access the Trailer Block.
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Example 1: Update the binary block 04h of MIFARE 1K/4K with Data {00 01 .. 0Fh}
APDU = { FF D6 00 04 10 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0Fh }
Example 2: Update the binary block 04h of MIFARE Ultralight with Data { 00 01 02 03h }
APDU = {FF D6 00 04 04 00 01 02 03h}
Page 65 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.5. Value block operation (Increment, Decrement, Store)
This command manipulates value-based transactions (e.g., increment a value block, etc.).
Command
Where:
Block Number (1 byte)
Value Block to be manipulated
VB_OP (1 byte)
Value block operation
00h = Store VB_Value into the block. The block will then be
converted to a value block.
01h = Increment the value of the value block by the VB_Value. This
command is only valid for value blocks.
02h = Decrement the value of the value block by the VB_Value. This
command is only valid for value blocks.
VB_Value (4 bytes)
The value used for manipulation. The value is a signed long integer.
VB_Value
MSB LSB
FFh FFh FFh FCh
VB_Value
MSB LSB
00h 00h 00h 01h
Response
Where:
SW1 SW2 = 90 00h means the operation is completed successfully.
= 63 00h means the operation failed.
Page 66 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.6. Read value block
This command retrieves the value from a value block. This command is only valid for value blocks.
Command
Where:
Block Number (1 byte)
The value block to be accessed.
Response
Where:
Value (4 bytes)
The value returned from the cards. The value is a signed long
integer.
VB_Value
MSB LSB
FFh FFh FFh FCh
VB_Value
MSB LSB
00h 00h 00h 01h
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Page 67 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.3.7. Copy value block
This command copies a value from a value block to another value block.
Command
Where:
Source Block Number (1 byte)
Block number where the value will come from and copied to the
target value block.
Target Block Number (1 byte)
Block number where the value from the source block will be copied
to. The source and target value blocks must be in the same sector.
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Example 1: Store a value “1” into block 05h
APDU = {FF D7 00 05 05 00 00 00 00 01h}
Example 2: Read the value block 05h
APDU = {FF B1 00 05 00h}
Example 3: Copy the value from value block 05h to value block 06h
APDU = {FF D7 00 05 02 03 06h}
Example 4: Increment the value block 05h by “5”
APDU = {FF D7 00 05 05 01 00 00 00 05h}
Page 68 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.4. Accessing PC/SC-compliant tags (ISO 14443-4)
All ISO 14443-4-compliant cards (PICCs) understand the ISO 7816-4 APDUs. The ACR1281U-C1
reader only needs to communicate with the ISO 14443-4-compliant cards through exchanging ISO
7816-4 APDUs and responses. ACR1281U-C1 will handle the ISO 14443 Parts 1-4 Protocols
internally.
The MIFARE Classic 1K/4K, MIFARE Mini and MIFARE Ultralight tags are supported through the
T=CL emulation. Simply treat the MIFARE tags as standard ISO 14443-4 tags. For more information,
see PICC Commands (T=CL Emulation) for MIFARE 1K/4K Memory Cards.
Command
Response
Where:
SW1 SW2 = 90 00h means the operation was completed successfully.
= 63 00h means the operation failed.
Typical sequence may be:
1. Present the tag and connect the PICC interface.
2. Read/Update the memory of the tag.
Page 69 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.2.5. Accessing MIFARE DESFire tags (ISO 14443-4)
MIFARE® DESFire supports ISO 7816-4 APDU Wrapping and Native modes. Once the DESFire tag
is activated, the first APDU sent to the DESFire tag will determine the “Command Mode.” If the first
APDU is in “Native Mode,” the rest of the APDUs must also be in “Native Mode” format. Similarly, if
the first APDU is in “ISO 7816-4 APDU Wrapping Mode,” the rest of the APDUs must also be in “ISO
7816-4 APDU Wrapping Mode” format.
Example 2: MIFARE DESFire Frame Level Chaining (ISO 7816 wrapping mode)
In this example, the application has to do the “Frame Level Chaining”.
To get the version of the DESFire card:
Step 1: Send an APDU {90 60 00 00 00h} to get the first frame. INS=60h
Answer: 04 01 01 00 02 18 05 91 AFh [$91AFh]
Step 2: Send an APDU {90 AF 00 00 00h} to get the second frame. INS=AFh
Answer: 04 01 01 00 06 18 05 91 AFh [$91AFh]
Step 3: Send an APDU {90 AF 00 00 00h} to get the last frame. INS=AFh
Answer: 04 52 5A 19 B2 1B 80 8E 36 54 4D 40 26 04 91 00h [$9100h]
To read 8 bytes random number from an ISO 14443-4 Type A PICC (DESFire):
APDU = {0A 00h}
Answer: AF 25 9C 65 0C 87 65 1D D7h [$1DD7h]
In which, the first byte “AF” is the status code returned by the MIFARE DESFire card.
The Data inside the blanket [$1DD7h] can simply be ignored by the application.
Page 70 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Example 4: MIFARE DESFire Frame Level Chaining (Native Mode)
In this example, the application has to do the “Frame Level Chaining”.
To get the version of the DESFire card:
Note: In MIFARE DESFire Native Mode, the status code [90 00h] will not be added to the response if
the response length is greater than 1. If the response length is less than 2, the status code [90 00h]
will be added in order to meet the requirement of PC/SC. The minimum response length is 2.
Page 71 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3. Peripherals Control
The reader’s peripherals control commands are implemented by using PC_to_RDR_Escape.
Note: The driver will add the Class, INS and P1 automatically.
Example:
Response = E1 00 00 00 0F 41 43 52 31 32 38 31 55 5F 56 35 30 33 2E 31
Firmware Version (HEX) = 41 43 52 31 32 38 31 55 5F 56 35 30 33 2E 31
Firmware Version (ASCII) = “ACR1281U_V503.1”
Page 72 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.2. LED Control
This command controls the LED output.
Where:
LED Status (1 byte)
Page 73 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.3. LED Status
This command checks the existing LED status.
Where:
LED Status (1 byte)
Page 74 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.4. Buzzer Control
This command controls the buzzer output.
Where:
Buzzer ON Duration (1 byte)
00h = OFF
01 – FFh = Duration (unit: 10 ms)
Page 75 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.5. Set Default LED and Buzzer Behaviors
This command sets the default behavior of the LEDs and buzzer.
Where:
Default Behaviors (1 byte)
Page 76 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.6. Read Default LED and Buzzer Behaviors
This command reads the current default behaviors of LEDs and buzzer.
Where:
Page 77 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.7. Initialize Card Insertion Counter
This command initializes the cards insertion/detection counter.
Initialize Card ICC Cnt ICC Cnt PICC Cnt PICC Cnt
E0h 00h 00h 09h 04h
Insertion Counter (LSB) (MSB) (LSB) (MSB)
Where:
ICC Cnt (LSB) (1 byte)
ICC Insertion Counter (LSB)
ICC Cnt (MSB) (1 byte)
ICC Insertion Counter (MSB)
PICC Cnt (LSB) (1 byte)
PICC Insertion Counter (LSB)
PICC Cnt (MSB) (1 byte)
PICC Insertion Counter (MSB)
Page 78 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.8. Read Card Insertion Counter
This command checks the cards insertion/detection counter value.
Where:
ICC Cnt (LSB) (1 byte)
ICC Insertion Counter (LSB)
ICC Cnt (MSB) (1 byte)
ICC Insertion Counter (MSB)
PICC Cnt (LSB) (1 byte)
PICC Insertion Counter (LSB)
PICC Cnt (MSB) (1 byte)
PICC Insertion Counter (MSB)
Page 79 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.9. Update Card Insertion Counter
This command updates the cards insertion/detection counter value.
Where:
ICC Cnt (LSB) (1 byte)
ICC Insertion Counter (LSB)
ICC Cnt (MSB) (1 byte)
ICC Insertion Counter (MSB)
PICC Cnt (LSB) (1 byte)
PICC Insertion Counter (LSB)
PICC Cnt (MSB) (1 byte)
PICC Insertion Counter (MSB)
Page 80 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.10. Set Automatic PICC Polling
This command sets the reader’s polling mode.
Whenever the reader is connected to the computer, the PICC polling function will start the PICC
scanning to determine if a PICC is placed on/removed from the built-in antenna.
You can send a command to disable the PICC polling function by sending a command through the
PC/SC Escape Command interface. To meet the energy saving requirement, special modes are
provided for turning off the antenna field whenever the PICC is inactive, or no PICC is found. The
reader will consume less current in power saving mode.
Where:
Polling Setting (1 byte)
Polling
Description Description
Setting
1 = Enable
Bit 0 Auto PICC Polling
0 = Disable
1 = Enable
Bit 1 Turn off Antenna Field if no PICC found
0 = Disable
1 = Enable
Bit 2 Turn off Antenna Field if the PICC is inactive
0 = Disable
Bit 3 RFU RFU
Bit 5 – Bit 4:
0 – 0 = 250 ms
Bit 5 – 4 PICC Polling Interval for PICC 0 – 1 = 500 ms
1 – 0 = 1000 ms
1 – 1 = 2500 ms
Bit 6 RFU RFU
1 = Enable
Bit 7 Enforce ISO 14443A Part 4
0 = Disable
Page 81 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Notes:
1. It is recommended to enable the option “Turn off Antenna Field is the PICC is inactive,” so
that the “Inactive PICC” will not be exposed to the field all the time to prevent the PICC from
warming up.
2. The longer the PICC Poll Interval, the more efficient it is for energy saving. However, the
response time of PICC Polling will become longer. The Idle Current Consumption in Power
Saving Mode is about 60 mA, while the Idle Current Consumption in Non-Power Saving mode
is about 130 mA. Idle Current Consumption = PICC is not activated.
3. The reader will activate the ISO 14443A-4 mode of the “ISO 14443A-4 compliant PICC”
automatically. Type B PICC will not be affected by this option.
4. The JCOP30 card comes with two modes: ISO 14443A-3 (MIFARE 1K) and ISO 14443A-4
modes. The application has to decide which mode should be selected once the PICC is
activated.
Page 82 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.11. Read Automatic PICC Polling
This command checks the current automatic PICC polling.
Where:
Polling Setting (1 byte)
Polling
Description Description
Setting
1 = Enable
Bit 0 Auto PICC Polling
0 = Disable
1 = Enable
Bit 1 Turn off Antenna Field if no PICC found
0 = Disable
1 = Enable
Bit 2 Turn off Antenna Field if the PICC is inactive
0 = Disable
Bit 3 RFU RFU
Bit 5 – Bit 4:
0 – 0 = 250 ms
Bit 5 – 4 PICC Polling Interval for PICC 0 – 1 = 500 ms
1 – 0 = 1000 ms
1 – 1 = 2500 ms
Bit 6 RFU RFU
1 = Enable
Bit 7 Enforce ISO 14443A Part 4
0 = Disable
Note: Default value of Behaviors = 8Fh.
Page 83 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.12. Manual PICC Polling
This command determines if any PICC is within the detection range of the reader. This command can
be used if the automatic PICC polling function is disabled.
Where:
Status (1 byte)
00h = PICC is detected
FFh = No PICC is detected
Page 84 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.13. Set PICC Operating Parameter
The command sets the PICC operating parameter.
Where:
Operating Parameter (1 Byte)
Operating
Parameter Description Option
Parameter
1 = Detect
Bit 0 ISO 14443 Type A The tag types to be 0 = Skip
detected during PICC
Polling 1 = Detect
Bit 1 ISO 14443 Type B
0 = Skip
Bit 2 – 7 RFU RFU RFU
Page 85 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.14. Read PICC Operating Parameter
This command checks the current PICC operating parameter.
Where:
Operating Parameter (1 byte)
Operating
Parameter Description Option
Parameter
1 = Detect
Bit 0 ISO 14443 Type A The tag types to be 0 = Skip
detected during
PICC Polling 1 = Detect
Bit 1 ISO 14443 Type B
0 = Skip
Bit 2 – 7 RFU RFU RFU
Page 86 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.15. Set Exclusive Mode
This command sets the reader in to/out from exclusive mode.
Where:
Mode Configuration (1 byte)
00h = Share Mode: ICC and PICC interfaces can work at the same
time.
01h = Exclusive Mode: PICC is disabled when Auto Polling and
Antenna Power Off when ICC is inserted (Default).
Page 87 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.16. Read Exclusive Mode
This command checks the current exclusive mode setting.
Where:
Mode Configuration (1 byte)
00h = Share Mode: ICC and PICC interfaces can work at the same
time.
01h = Exclusive Mode: PICC is disabled when Auto Polling and
Antenna Power Off when ICC is inserted (Default).
Page 88 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.17. Set Auto PPS
Whenever a PICC is recognized, the reader will try to change the communication speed between the
PCD and PICC as defined by the maximum connection speed. If the card does not support the
proposed connection speed, the reader will try to connect the card with a slower speed setting.
Where:
Max Speed (1 byte)
00h = 106 Kbps; default setting, equal to No Auto PPS
01h = 212 Kbps
02h = 424 Kbps
03h = 848 Kbps
Notes:
1. Normally, the application should know the maximum connection speed of the PICCs being
used. The environment also affects the maximum achievable speed. The reader just uses the
proposed communication speed to talk with the PICC. The PICC will become inaccessible if
the PICC or environment does not meet the requirement of the proposed communication
speed.
2. If the higher speed setting affects the performance of the reader, please switch back to a
lower speed setting.
Page 89 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.18. Read Auto PPS
This command checks the current auto PPS setting.
Where:
Max Speed Maximum Speed (1 byte)
Current Speed Current Speed (1 byte)
00h = 106 Kbps; default setting, equal to No Auto PPS
01h = 212 Kbps
02h = 424 Kbps
03h = 848 Kbps
Page 90 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
5.3.19. Read Serial Number
This command reads the reader serial number.
Note: This is applicable only to firmware version 533.00 and above.
Page 91 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Appendix A. Basic program flow for contactless
applications
Step 0: Start the application. The reader will do the PICC polling and scan for tags continuously. Once
the tag is found and detected, the corresponding ATR will be sent to the computer.
..
Step N: Disconnect the ACR1281U PICC Interface. Shut down the application.
Page 92 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Appendix B. Extended APDU Command Example
Card: ACOS7 (supports Extended APDU, echo response)
Write CMD: 80 D2 00 00 XX XX XXh
CLA = 80h
INS = D2h
P1 = 00h
P2 = 00h
Data Len = XX XX XXh
APDU Command:
80D20000000100000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F
202122232425262728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F40414243444546
4748494A4B4C4D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6
D6E6F707172737475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F90919293
9495969798999A9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B
8B9BABBBCBDBEBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9D
ADBDCDDDEDFE0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFD
FEFFh
Response:
000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F20212223242526
2728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4
D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717273
7475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A
9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDB
EBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE
0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF9000h
Page 93 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
78797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9
E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1
C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3
E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFFh
Response:
000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F20212223242526
2728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4
D4E4F505152535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717273
7475767778797A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A
9B9C9D9E9FA0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDB
EBFC0C1C2C3C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE
0E1E2E3E4E5E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF00010203040
5060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F202122232425262728292A2B2
C2D2E2F303132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4D4E4F505152
535455565758595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F70717273747576777879
7A7B7C7D7E7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9E9FA
0A1A2A3A4A5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1C2C3
C4C5C6C7C8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3E4E5
E6E7E8E9EAEBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF000102030405060708090A
0B0C0D0E0F101112131415161718191A1B1C1D1E1F202122232425262728292A2B2C2D2E2F303
132333435363738393A3B3C3D3E3F404142434445464748494A4B4C4D4E4F50515253545556575
8595A5B5C5D5E5F606162636465666768696A6B6C6D6E6F707172737475767778797A7B7C7D7E
7F808182838485868788898A8B8C8D8E8F909192939495969798999A9B9C9D9E9FA0A1A2A3A4A
5A6A7A8A9AAABACADAEAFB0B1B2B3B4B5B6B7B8B9BABBBCBDBEBFC0C1C2C3C4C5C6C7C
8C9CACBCCCDCECFD0D1D2D3D4D5D6D7D8D9DADBDCDDDEDFE0E1E2E3E4E5E6E7E8E9EA
EBECEDEEEFF0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF9000h
Page 94 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Appendix C. Escape Command Example
Example: Get firmware version (using PCSCDirectCommand.exe).
Step 1: Plug in the ACR1281 Reader to the computer.
Step 3: Connect the reader in Direct mode. The ATR will be displayed (if a card is present) or “No
ATR retrieved (ATRLen = 0)” will be displayed (if no card).
Note: PCSCDirectCommand.exe is not available in the Software Development Kit (SDK). Please
contact ACS for more information.
Page 95 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Appendix D. Supported Card Types
The following table summarizes the card type returned by GET_READER_INFORMATION
corresponding to the respective card type.
Page 96 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Appendix E. ACR128 Compatibility
Below is the list of ACR128 functions that are implemented differently or not supported by the
ACR1281U-C1.
28 01 [Duration]
28 01 [Duration]
Duration:
8. Buzzer Control
00 = Turn Off Duration:
01 – FE = Duration x 10 ms 01 – FF = Duration × 10 ms
FF = Turn On
Page 97 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk
Functions ACR128 ACR1281U-C1
Set: 21 01 [Data: 1 byte] Set: 21 01 [Data: 1 byte]
Read: 21 00 Read: 21 00
Data: Data:
Bit 0 = ICC Activation Status Bit 0 = ICC Activation Status
9. Set/Read Default LED Bit 3 = PICC PPS Status Buzzer Bit 3 = RFU
and Buzzer Behaviors
Data: Data:
Bit 0 = Auto PICC Polling Bit 0 = Auto PICC Polling
Bit 1 = Turn off Antenna Field if no Bit 1 = Turn off Antenna Field if
PICC is found no PICC is found
Bit 2 = Turn off Antenna Field if Bit 2 = Turn off Antenna Field if
10. Set/Read Automatic
the PICC is inactive the PICC is inactive
PICC Polling
MIFARE, MIFARE Classic, MIFARE DESFire, MIFARE Mini and MIFARE Ultralight are registered trademarks of NXP B.V. and are used under license.
Windows and Windows Vista are registered trademarks of Microsoft Corporation in the United States and/or other countries.
Page 98 of 98
www.acs.com
ACR1281U-C1 – Application Programming Interface [email protected]
.hk
Version 1.11 www.acs.com.hk