ACS ACR1255U-J1 User manual

Subject to change without prior notice [email protected]k
www.acs.com.hk
Reference Manual V1.07
ACR1255U-J1
Secure Bluetooth®
NFC Reader

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 2 of 77
Revision History
Release Date Revision Description Version Number
2015-09-07 ●Initial Release 1.00
2016-02-02
●Updated Section 2.0 Features
●Updated Section 4.1.2 Battery Life
●Updated Section 4.5.1 Keys
●Updated Section 4.5.3 Status LED
●Updated Section 4.5.4 Buzzer
●Updated Section 5.3 Authentication
●Updated Section 6.7.2 Get Serial Number
●Updated Section 6.7.16 Sleep Mode Option
●Updated Section 6.6.18 Read Tx Power
Value
1.01
2016-06-06
●Updated Section 5.6.5 Notify Card Status
Command
●Updated Section 6.2.1 ATR Generation
●Updated Section 6.4.1 Load Authentication
Keys
●Updated Section 6.7.6 Set LED and Buzzer
Status Indicator Behavior
●Updated Section 6.7.7 Read LED and
Buzzer Status Indicator Behavior
●Updated Section 6.7.8 Set Automatic PICC
Polling
●Updated Section 6.7.10 Set PICC Operating
Parameter
●Updated Section 6.7.11 Read PICC
Operating Parameter
●Updated Section 6.7.12 Set Auto PPS
●Updated Section 6.7.13 Read Auto PPS
●Updated Section 6.7.16 Sleep Mode Option
●Updated Section 6.7.17 Change Tx Power
Command
●Updated Section 6.7.18 Read Tx Power
Value
●Added Section 6.7.19 Customer Master Key
Rewrite
1.02
2016-09-16 ●Updated Product Marketing Name 1.03

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 3 of 77
Release Date Revision Description Version Number
2017-01-10
●Updated format of commands and
examples
●Added Example of a Mutual Authentication
Communication (section 5.7.1)
●Updated Table 5 value
●Deleted the PIN passcode description
●Updated Section 2.0 Features
●Updated Section 4.1.2 Battery Life
●Updated Section 5.6.5 Notify Card Status
Command
●Added Section 6.4 APDU Commands for
PCSC 2.0 Part 3
●Updated Section 6.7.4 LED Color
●Updated Section 6.7.17 Change Tx Power
Command
●Updated Section 6.7.18 Read Tx Power
Value
1.04
2017-10-02
●Updated Table 5: Service Handles and
UUID Information List
●Updated Section 5.3 Authentication
●Updated Section 5.7 Mutual Authentication
●Added Section 6.7 Accessing FeliCa Tags
1.05
2017-12-28 ●Updated Product Photo 1.06
2018-05-24
●Updated Section 5.2 Profile Selection
●Updated Section 5.6 Bluetooth
Communication Protocol
1.07

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 4 of 77
Table of Contents
1.0. Introduction ............................................................................................................... 7
1.1. Symbols and Abbreviations ...................................................................................................7
2.0. Features ..................................................................................................................... 8
3.0. System Block Diagram ............................................................................................. 9
4.0. Hardware Design..................................................................................................... 12
4.1. Battery..................................................................................................................................12
4.1.1. Battery Charging .........................................................................................................12
4.1.2. Battery Life ..................................................................................................................12
4.2. Bluetooth Interface...............................................................................................................12
4.3. USB Interface ......................................................................................................................12
4.3.1. Communication Parameters .......................................................................................12
4.3.2. Endpoints ....................................................................................................................13
4.4. NFC Interface ......................................................................................................................14
4.4.1. Carrier Frequency .......................................................................................................14
4.4.2. Card Polling.................................................................................................................14
4.5. User Interface ......................................................................................................................14
4.5.1. Keys ............................................................................................................................14
4.5.2. Mode Selection Switch................................................................................................15
4.5.3. Status LED ..................................................................................................................15
4.5.4. Buzzer .........................................................................................................................16
5.0. Software Design ...................................................................................................... 17
5.1. Bluetooth Connection Flow..................................................................................................17
5.2. Profile Selection...................................................................................................................18
5.3. Authentication ......................................................................................................................19
5.4. Communication Profile.........................................................................................................20
5.5. Frame Format ......................................................................................................................20
5.5.1. Data Frame Format.....................................................................................................20
5.6. Bluetooth Communication Protocol .....................................................................................21
5.6.1. Card Power On ...........................................................................................................21
5.6.2. Card Power Off ...........................................................................................................22
5.6.3. Get Slot Status ............................................................................................................23
5.6.4. APDU Command.........................................................................................................24
5.6.5. Notify Card Status Command .....................................................................................26
5.6.6. Hardware Error Response ..........................................................................................26
5.6.7. Escape Command.......................................................................................................27
5.7. Mutual Authentication and Encryption Protocol...................................................................28
5.7.1. Bluetooth Authentication Program Flow .....................................................................28
5.7.2. SPH_to_RDR_ReqAuth..............................................................................................29
5.7.3. RDR_to_SPH_AuthRsp1 ............................................................................................30
5.7.4. SPH_to_RDR_AuthRsp ..............................................................................................31
5.7.5. RDR_to_SPH_AuthRsp2 ............................................................................................32
5.7.6. RDR_to_SPH_ACK (Error handling) ..........................................................................32
6.0. Host Programming (PC-linked) API....................................................................... 34
6.1. PC/SC API ...........................................................................................................................34
6.1.1. SCardEstablishContext...............................................................................................34
6.1.2. SCardListReaders.......................................................................................................34
6.1.3. SCardConnect.............................................................................................................34
6.1.4. SCardControl ..............................................................................................................34
6.1.5. SCardTransmit ............................................................................................................34
6.1.6. ScardDisconnect.........................................................................................................34
6.1.7. APDU Flow..................................................................................................................35
6.1.8. Escape Command Flow..............................................................................................36

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 5 of 77
6.2. Contactless Smart Card Protocol ........................................................................................37
6.2.1. ATR Generation ..........................................................................................................37
6.3. Pseudo APDU for Contactless Interface .............................................................................39
6.3.1. Get Data......................................................................................................................39
6.4. APDU commands for PC/SC 2.0 Part 3 (version 2.02 or later)...........................................40
6.4.1. Command and Response APDU Format....................................................................40
6.4.2. Manage Session Command........................................................................................41
6.4.3. Transparent Exchange Command..............................................................................45
6.4.4. Switch Protocol Command..........................................................................................48
6.4.5. PC/SC 2.0 Part 3 Example .........................................................................................49
6.5. PICC Commands for MIFARE Classic® (1K/4K) memory cards ........................................52
6.5.1. Load Authentication Keys ...........................................................................................52
6.5.2. Authentication for MIFARE Classic (1K/4K) ...............................................................53
6.5.3. Read Binary Blocks.....................................................................................................55
6.5.4. Update Binary Blocks..................................................................................................56
6.5.5. Value Block Operation (INC, DEC, STORE) ..............................................................57
6.5.6. Read Value Block........................................................................................................58
6.5.7. Copy Value Block........................................................................................................59
6.6. Accessing PC/SC-compliant tags (ISO 14443-4)................................................................60
6.7. Accessing FeliCa tags .........................................................................................................62
6.8. Peripherals Control ..............................................................................................................62
6.8.1. Get Firmware Version .................................................................................................63
6.8.2. Get Serial Number ......................................................................................................64
6.8.3. LED Control.................................................................................................................64
6.8.4. LED Status ..................................................................................................................65
6.8.5. Buzzer Control ............................................................................................................65
6.8.6. Set LED and Buzzer Status Indicator Behavior ..........................................................66
6.8.7. Read LED and Buzzer Status Indicator Behavior.......................................................67
6.8.8. Set Automatic PICC Polling ........................................................................................67
6.8.9. Read Automatic PICC Polling .....................................................................................69
6.8.10. Set PICC Operating Parameter ..................................................................................69
6.8.11. Read PICC Operating Parameter ...............................................................................70
6.8.12. Set Auto PPS ..............................................................................................................71
6.8.13. Read Auto PPS ...........................................................................................................72
6.8.14. Antenna Field Control .................................................................................................72
6.8.15. Read Antenna Field Status .........................................................................................73
6.8.16. Sleep Mode Option .....................................................................................................73
6.8.17. Change Tx Power command ......................................................................................74
6.8.18. Read Tx Power Value .................................................................................................74
6.8.19. Customer Master Key Rewrite ....................................................................................75
Appendix A. Access MIFARE DESFire tags (ISO 14443-3) ........................................... 77
List of Figures
Figure 1 : ACR1255U-J1 Architecture.................................................................................................... 9
Figure 2 : ACR1255U-J1 USB Communication Architecture............................................................... 10
Figure 3 : Bluetooth Protocol Stack ...................................................................................................... 11
Figure 4 : Keys on ACR1255U-J1........................................................................................................ 14
Figure 5 : LED Operation Status .......................................................................................................... 15
Figure 6 : Bluetooth Connection Flow .................................................................................................. 17
Figure 7 : Authentication Procedure..................................................................................................... 19
Figure 8 : ACR1255U-J1 APDU Flow .................................................................................................. 35
Figure 9 : ACR1255U-J1 Escape Command Flow .............................................................................. 36

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 6 of 77
List of Tables
Table 1 : Symbols and Abbreviations ..................................................................................................... 7
Table 2 : Estimated Battery Lifespan.................................................................................................... 12
Table 3 : USB Interface Wiring ............................................................................................................. 12
Table 4 : ACR1255U-J1’s Bluetooth Service........................................................................................ 18
Table 5 : ACR1255U-J1 Service Handles and UUID Information List ................................................. 18
Table 6 : Command Code Summary .................................................................................................... 21
Table 7 : Response Code Summary .................................................................................................... 21
Table 8 : Summary of Mutual Authentication Commands.................................................................... 28
Table 9 : Mutual Authentication Error codes ........................................................................................ 33
Table 10 : MIFARE Classic® 1K Memory Map .................................................................................... 54
Table 11 : MIFARE Classic® 4K Memory Map .................................................................................... 54
Table 12 : MIFARE Ultralight® Memory Map ....................................................................................... 55

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 7 of 77
1.0.Introduction
ACR1255U-J1 Secure Bluetooth® NFC Reader acts as an interface for the communication between a
computer/mobile device and a contactless smart card or NFC-enabled device. It establishes a uniform
interface from the computer/mobile device to the smart card for a wide variety of cards. By taking care
of the card’s particulars, it releases the computer software programmer from being responsible with
smart card operations’ technical details, which in many cases, are not relevant to the implementation
of a smart card system.
1.1. Symbols and Abbreviations
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
Table 1: Symbols and Abbreviations

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 8 of 77
2.0.Features
•USB Full Speed Interface
•Bluetooth® Interface
•Plug and Play – CCID support brings utmost mobility
•Smart Card Reader:
oContactless Interface:
Read/Write speed of up to 424 Kbps
Built-in antenna for contactless tag access, with reading distance of up to 60 mm
(depending on tag type)
Supports ISO 14443 Part 4 Type A and B cards, MIFARE, FeliCa, and all 4 types of
NFC (ISO/IEC 18092) tags
Built-in anti-collision feature (only one tag is accessed at any time)
Supports AES-128 encryption algorithm (CBC ciphering mode)
NFC Mode Supported:
▫Card reader/writer mode
•Application Programming Interface:
oSupports PC/SC
oSupports CT-API (through wrapper on top of PC/SC)
•Built-in Peripherals:
oTwo user-controllable bi-color LEDs
oUser-controllable buzzer
•USB Firmware Upgradeability1
•Supports Android™ 4.3 and later2
•Supports iOS 5.0 and later3
•Compliant with the following standards:
oEN 60950/IEC 60950
oISO 14443
oISO 18092
oUSB Full Speed
oBluetooth
oPC/SC
oCCID
oCE
oFCC
oRoHS 2
oREACH
oVCCI (Japan)
oTELEC (Japan)
oMicrosoft® WHQL
1Applicable under PC-linked mode
2Uses an ACS-defined Android Library
3Uses an ACS-defined iOS Library

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 9 of 77
3.0.System Block Diagram
Figure 1: ACR1255U-J1 Architecture
ACR1255U-J1
NFC
Antenna
MCU
Bluetooth
Mobile
device or
Computer
LEDs Buzzer
Bluetooth
Module
Switch
Rechargeable Battery
USB
Computer
NFC

ACR1255U-J1 – Reference Manual [email protected]
Version V1.07 www.acs.com.hk
Page 10 of 77
For USB communication architecture, the protocol between ACR1255U-J1 and other devices follow
the CCID protocol. All communications for NFC are PC/SC-compliant.
Figure 2: ACR1255U-J1 USB Communication Architecture
ACR1255U-J1 PC/SC
NFC Interface
USB Interface
(CCID)
PC/SC Layer
T=CL and T=1
Emulation
ISO 14443/ISO 18092
Interface
NFC
(Built-in Antenna)
Physical
Interface