ACS TS760A User manual

Subject to change without prior notice [e-mail]
www.acs.com.hk
Application Programming Interface V1.09
ACR1252U
NFCForumCertified
Reader

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 2 of 80
Table of Contents
1.0. Introduction .............................................................................................................4
2.0. Features ...................................................................................................................5
3.0. Acronyms and Abbreviations.................................................................................6
4.0. Architecture.............................................................................................................7
5.0. Host Programming (PC-linked) API........................................................................8
5.1. PCSC API..............................................................................................................................8
5.1.1. SCardEstablishContext.................................................................................................8
5.1.2. SCardListReaders.........................................................................................................8
5.1.3. SCardConnect...............................................................................................................8
5.1.4. SCardControl ................................................................................................................8
5.1.5. ScardTransmit...............................................................................................................8
5.1.6. ScardDisconnect...........................................................................................................8
5.1.7. APDU Flow....................................................................................................................9
5.1.8. Escape Command Flow..............................................................................................10
5.2. Contactless Smart Card Protocol ........................................................................................11
5.2.1. ATR Generation..........................................................................................................11
5.3. Pseudo APDU for Contactless Interface .............................................................................14
5.3.1. Get Data......................................................................................................................14
5.4. APDU commands for PCSC 2.0 Part 3 (version 2.02 or above).........................................15
5.4.1. Command and Response APDU Format....................................................................15
5.4.2. Manage Session Command........................................................................................17
5.4.3. Transparent Exchange Command..............................................................................21
5.4.4. Switch Protocol Command..........................................................................................25
5.4.5. PCSC 2.0 Part 3 Example ..........................................................................................26
5.5. PICC Commands for MIFARE® Classic (1K/4K) Memory Cards........................................29
5.5.1. Load Authentication Keys ...........................................................................................29
5.5.2. Authentication for MIFARE® Classic (1K/4K).............................................................30
5.5.3. Read Binary Blocks.....................................................................................................33
5.5.4. Update Binary Blocks..................................................................................................34
5.5.5. Value Block Operation (INC, DEC, STORE) ..............................................................35
5.5.6. Read Value Block........................................................................................................36
5.5.7. Copy Value Block........................................................................................................37
5.6. Accessing PCSC-compliant tags (ISO 14443-4).................................................................38
5.7. Accessing FeliCa tags .........................................................................................................40
5.8. Peripherals Control..............................................................................................................41
5.8.1. Get Firmware Version.................................................................................................41
5.8.2. LED Control.................................................................................................................42
5.8.3. LED Status..................................................................................................................43
5.8.4. Buzzer Control ............................................................................................................44
5.8.5. Buzzer Status..............................................................................................................45
5.8.6. Set LED and Buzzer Status Indicator Behavior for PICC Interface............................46
5.8.7. Read LED and Buzzer Status Indicator Behavior for PICC Interface.........................47
5.8.8. Set Automatic PICC Polling ........................................................................................48
5.8.9. Read Automatic PICC Polling.....................................................................................50
5.8.10. Set PICC Operating Parameter ..................................................................................51
5.8.11. Read PICC Operating Parameter...............................................................................52
5.8.12. Set Auto PPS..............................................................................................................53
5.8.13. Read Auto PPS...........................................................................................................54
5.8.14. Set Serial Number.......................................................................................................55
5.8.15. Set and lock Serial Number ........................................................................................56
5.8.16. Read Serial Number....................................................................................................57
5.8.17. Unlock Serial Number.................................................................................................58
5.9. NFC Peer-to-Peer Mode-related Commands......................................................................59
5.9.1. Initiator Mode-related Commands...............................................................................59
5.9.2. Target Mode-related Commands................................................................................63

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 3 of 80
5.10. NFC Card Emulation Mode-related Commands..................................................................69
5.10.1. Enter Card Emulation Mode........................................................................................69
5.10.2. Read Card Emulation Data (MIFARE® Ultralight® or FeliCa)....................................71
5.10.3. Write Card Emulation Data (MIFARE® Ultralight® or FeliCa)....................................72
5.10.4. Set Card Emulation of MIFARE® Ultralight® UID ......................................................72
5.10.5. Set Card Emulation FeliCa IDm..................................................................................73
5.10.6. Set Card Emulation Lock Data in NFC .......................................................................73
5.11. ACR122U Compatible Commands......................................................................................74
5.11.1. Bi-color LED and Buzzer Control................................................................................74
5.11.2. Get Firmware Version.................................................................................................76
5.11.3. Get the PICC Operating Parameter............................................................................77
5.11.4. Set the PICC Operating Parameter ............................................................................78
Appendix A. SNEP Message..........................................................................................79
Appendix B. Escape Command Example .....................................................................80
List of Figures
Figure 1 : ACR1252U Architecture.........................................................................................................7
Figure 2 : ACR1252U APDU Flow .........................................................................................................9
Figure 3 : ACR1252U Escape Command Flow....................................................................................10
Figure 4 : Peer-to-Peer Flow for Initiator Mode....................................................................................59
Figure 5 : Peer-to-Peer Flow for Target Mode.....................................................................................63
List of Tables
Table 1 : Acronyms and Abbreviations...................................................................................................6
Table 2 : MIFARE® Classic 1K Memory Map ......................................................................................31
Table 3 : MIFARE® Classic 4K Memory Map ......................................................................................31
Table 4 : MIFARE® Ultralight® Memory Map ......................................................................................32
Table 5 : MIFARE® Ultralight® Memory Map (52 bytes) .....................................................................70
Table 6 : FeliCa Memory Map (160 bytes) ...........................................................................................71

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 4 of 80
1.0.Introduction
The ACR1252U NFC Forum Certified reader is a USB PC-linked contactless card reader/writer with a
SAM (Secure Access Module) slot, which can be used together with a SAM card for high level
security in contactless transactions. It is an NFC card reader/writer, and capable to support card
emulation and peer-to-peer communication modes. The ACR1252U reader is also NFC library
compliant to support Bluetooth and Wi-Fi NFC pairing/log-in.
ACR1252U is compliant to ISO 14443 Parts 1 to 4 supporting contactless card, MIFARE® cards,
FeliCa cards and ISO 18092 NFC tags.
ACR1252U has two reader interfaces, namely the PICC and SAM interface. Both interfaces follow the
PC/SC specifications. This API document will discuss in detail how the PC/SC APDU commands were
implemented for the contactless interface and device peripherals of ACR1252U.

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 5 of 80
2.0.Features
•USB 2.0 Full Speed (12 Mbps)
•Microsoft® CCID Compliant for both SAM and PICC interface
•Smart Card Reader:
oRead/Write speed of up to 424 Kbps
oBuilt-in antenna for contactless tag access, with card reading distance of up to 50 mm
(depending on tag type)
oSupport for ISO 14443 Part 4 Type A and B Cards, MIFARE® Classic, MIFARE® Mini,
MIFARE® Ultralight®, FeliCa, Topaz, and all four types of NFC (ISO/IEC 18092 tags)
oBuilt-in anti-collision feature (only one tag is accessed at a time)
oNFC Support
Card reader/writer mode
Peer-to-Peer mode
Card emulation mode
oISO 7816-compliant SAM slot (Class A)
•Application Programming Interface:
oSupports PC/SC
oSupports CT-API (through wrapper on top of PC/SC)
•Built-in peripherals
oUser-controllable bi-color LED
oUser-controllable buzzer
•USB Firmware Upgradability
•Supports Android™3.1 and later
•Compliant with the following standards:
oISO 18092 (NFCIP-1)
oISO 14443 Parts 1-4
oISO 7816 Class A (for SAM slot)
oNFC Forum
oFeliCa Performance Certification
oPC/SC
oCCID
oCE
oFCC
oRoHS 2
oREACH
oJ-LIS (Japan)
oVCCI (Japan)
oMIC (Japan)
oKC (Korea)
oMicrosoft® WHQL

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 6 of 80
3.0.Acronyms and Abbreviations
Acronym/Abbreviation Description
ATR Attribute Request and Attribute Response
DEP Data Exchange Protocol Request and Data Exchange Protocol
Response
DSL Deselect Request and Deselect Response
PSL Parameter Selection Request and Parameter Selection Response
RLS Release Request and Release Response
WUP Wakeup Request and Wakeup Response
DID Device ID
BS Sending bit duration
BR Receiving bit duration
PP Protocol Parameters
Gi Optional information field for Initiator
PFB Control information for transaction
FSL maximum value for the Frame Length
LLCP Logical Link Control Protocol
Table 1: Acronyms and Abbreviations

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 7 of 80
4.0.Architecture
For communication architecture, the protocol used between ACR1252U and the computer is CCID
protocol. All communications between PICC and SAM are PC/SC compliant.
Figure 1: ACR1252U Architecture
ACR1252 PCSC
SAM Interface
PCSC Layer
ISO 7816 Parts 1-4
SAM Interface
ISO 14443 Parts 1-4 /
ISO 18092
PICC Interface
SAM (Socket) PICC
(Built-in Antenna)
USB
Interface
(CCID)
Physical
Interface
ACR1252U
ACR1252 PCSC
PICC Interface
T=CL & T=1
Emulation

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 8 of 80
5.0.Host Programming (PC-linked) API
5.1. PCSC API
This section will describe some of the PCSC API for application programming usage. For more
details, please refer to Microsoft MSDN Library or PCSC workgroup.
5.1.1. SCardEstablishContext
The SCardEstablishContext function establishes the resource manager context within which database
operations are performed.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379479%28v=vs.85%29.aspx
5.1.2. SCardListReaders
The SCardListReaders function provides the list of readers within a set of named reader groups,
eliminating duplicates.
The caller supplies a list of reader groups, and receives the list of readers within the named groups.
Unrecognized group names are ignored. This function only returns readers within the named groups
that are currently attached to the system and available for use.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379793%28v=vs.85%29.aspx
5.1.3. SCardConnect
The SCardConnect function establishes a connection (using a specific resource manager context)
between the calling application and a smart card contained by a specific reader. If no card exists in
the specified reader, an error is returned.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379473%28v=vs.85%29.aspx
5.1.4. SCardControl
The SCardControl function gives you direct control of the reader. You can call it any time after a
successful call to SCardConnect and before a successful call to SCardDisconnect. The effect on the
state of the reader depends on the control code.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379474%28v=vs.85%29.aspx
Note: Commands from Peripherals Control are using this API for sending.
5.1.5. ScardTransmit
The SCardTransmit function sends a service request to the smart card and expects to receive data
back from the card.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379804%28v=vs.85%29.aspx
Note:APDU Commands (i.e. the commands sent to connected card and Pseudo APDU for
Contactless Interface) are using this API for sending.
5.1.6. ScardDisconnect
The SCardDisconnect function terminates a connection previously opened between the calling
application and a smart card in the target reader.
Refer to: http://msdn.microsoft.com/en-us/library/windows/desktop/aa379475%28v=vs.85%29.aspx

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 9 of 80
5.1.7. APDU Flow
Figure 2: ACR1252U APDU Flow
SCardEstablishContext
SCardListReaders
Reader
present?
SCardConnect
Connection
successful?
SCardTransmit
SCardDisconnect
Start
End
Yes
No
Yes
No

ACR1252U – Application Programming Interface [e-mail]
Version 1.09 www.acs.com.hk
Page 10 of 80
5.1.8. Escape Command Flow
Figure 3: ACR1252U Escape Command Flow
SCardEstablishContext
SCardListReaders
Reader
present?
SCardConnect
SCardControl
SCardDisconnect
Start
End
Yes
No