ACS ACR1255U-J1 User manual

Subject to change without prior notice [e-mail]
www.acs.com.hk
Reference Manual V1.01
ACR1255U-J1
Bluetooth®
NFCReader

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 2 of 73
Table of Contents
1.0. Introduction .............................................................................................................5
1.1. Symbols and Abbreviations...................................................................................................5
2.0. Features ...................................................................................................................6
3.0. System Block Diagram............................................................................................7
4.0. Hardware Design...................................................................................................10
4.1. Battery..................................................................................................................................10
4.1.1. Battery charging..........................................................................................................10
4.1.2. Battery life ...................................................................................................................10
4.2. Bluetooth Interface...............................................................................................................10
4.3. USB Interface ......................................................................................................................10
4.3.1. Communication Parameters .......................................................................................10
4.3.2. Endpoints ....................................................................................................................11
4.4. NFC Interface ......................................................................................................................11
4.4.1. Carrier Frequency.......................................................................................................11
4.4.2. Card Polling.................................................................................................................11
4.5. User Interface ......................................................................................................................11
4.5.1. Keys ............................................................................................................................11
4.5.2. Mode Selection Switch................................................................................................12
4.5.3. Status LED..................................................................................................................13
4.5.4. Buzzer.........................................................................................................................14
5.0. Software Design ....................................................................................................15
5.1. Bluetooth Connection Flow..................................................................................................15
5.2. Profile Selection...................................................................................................................16
5.3. Authentication......................................................................................................................17
5.4. Communication Profile.........................................................................................................19
5.5. Frame Format......................................................................................................................19
5.5.1. Data Frame Format.....................................................................................................19
5.6. Bluetooth Communication Protocol .....................................................................................20
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.....................................................................................25
5.6.6. Hardware Error Response ..........................................................................................26
5.6.7. Escape Command.......................................................................................................27
5.7. Mutual Authentication and Encryption Protocol...................................................................29
5.7.1. Bluetooth Authentication Program Flow......................................................................29
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) ..........................................................................33
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
6.2. Contactless Smart Card Protocol ........................................................................................37

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 3 of 73
6.2.1. ATR Generation..........................................................................................................37
6.3. Pseudo APDU for Contactless Interface .............................................................................40
6.3.1. Get Data......................................................................................................................40
6.4. PICC Commands for MIFARE® Classic (1K/4K) memory cards ........................................41
6.4.1. Load Authentication Keys ...........................................................................................41
6.4.2. Authentication for MIFARE® Classic (1K/4K).............................................................42
6.4.3. Read Binary Blocks.....................................................................................................45
6.4.4. Update Binary Blocks..................................................................................................46
6.4.5. Value Block Operation (INC, DEC, STORE) ..............................................................47
6.4.6. Read Value Block........................................................................................................48
6.4.7. Copy Value Block........................................................................................................49
6.5. Accessing PC/SC-compliant tags (ISO 14443-4)................................................................50
6.6. Peripherals Control..............................................................................................................52
6.6.1. Get Firmware Version.................................................................................................53
6.6.2. Get Serial Number ......................................................................................................54
6.6.3. LED Control (in USB Mode only)................................................................................55
6.6.4. LED Status..................................................................................................................56
6.6.5. Buzzer Control ............................................................................................................57
6.6.6. Set LED and Buzzer Status Indicator Behavior..........................................................58
6.6.7. Read LED and Buzzer Status Indicator Behavior.......................................................59
6.6.8. Set Automatic PICC Polling ........................................................................................60
6.6.9. Read Automatic PICC Polling.....................................................................................62
6.6.10. Set PICC Operating Parameter ..................................................................................63
6.6.11. Read PICC Operating Parameter...............................................................................64
6.6.12. Set Auto PPS..............................................................................................................65
6.6.13. Read Auto PPS...........................................................................................................66
6.6.14. Antenna Field Control .................................................................................................67
6.6.15. Read Antenna Field Status.........................................................................................68
6.6.16. Card Emulation Mode Conversion..............................................................................69
6.6.17. Sleep Mode Option .....................................................................................................70
6.6.18. Change Tx Power command ......................................................................................71
6.6.19. Read Tx Power Value.................................................................................................72
List of Figures
Figure 1 : ACR1255U-J1 Architecture....................................................................................................7
Figure 2 : ACR1255U-J1 USB Communication Architecture.................................................................8
Figure 3 : BluetoothSmart Protocol Stack .............................................................................................9
Figure 4 : Keys on ACR1255U-J1........................................................................................................12
Figure 5 : LED Operation Status..........................................................................................................13
Figure 6 : Bluetooth Connection Flow..................................................................................................15
Figure 7 : Authentication Procedure.....................................................................................................18
Figure 8 : ACR1255U-J1 APDU Flow ..................................................................................................35
Figure 9 : ACR1255U-J1 Escape Command Flow ..............................................................................36
List of Tables
Table 1 : Symbols and Abbreviations.....................................................................................................5
Table 2 : Estimated Battery Lifespan....................................................................................................10
Table 3 : USB Interface Wiring.............................................................................................................10
Table 4 : ACR1255U-J1’s Bluetooth Service........................................................................................16
Table 5 : ACR1255U-J1 Service Handles and UUID Information List .................................................16
Table 6 : Command Code Summary....................................................................................................20
Table 7 : Response Code Summary ....................................................................................................20

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 4 of 73
Table 8 : Summary of Mutual Authentication Commands....................................................................29
Table 9 : Mutual Authentication Error codes ........................................................................................33
Table 10 : MIFARE® Classic 1K Memory Map ....................................................................................43
Table 11 : MIFARE® Classic 4K Memory Map ....................................................................................44
Table 12 : MIFARE Ultralight® Memory Map.......................................................................................44

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 5 of 73
1.0.Introduction
ACR1255U-J1 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 [e-mail]
Version V1.01 www.acs.com.hk
Page 6 of 73
2.0.Features
•USB 2.0 Full Speed Interface
•Bluetooth Smart Interface
•Plug and Play – CCID support brings utmost mobility
•USB Firmware Upgradeability1
•Smart Card Reader:
oBuilt-in antenna for contactless tag access, with reading distance of up to 60 mm
(depending on tag type)
oSupports ISO 14443 Part 4 Type A and B cards
oSupports MIFARE® and MIFARE® DESFire®
oSupports FeliCa
oSupports ISO 18092 Tags (NFC Tags)
oBuilt-in anti-collision feature (only one tag is accessed at any time)
oNFC Support:
Card reader/writer mode
Card emulation mode
oSupports AES-128 encryption algorithm
•Application Programming Interface:
oSupports PC/SC
oSupports CT-API (through wrapper on top of PC/SC)
•Supports Android™ 4.3 and later2
•Supports iOS 5.0 and later3
•Built-in Peripherals:
oTwo user-controllable bi-color LEDs
oUser-controllable buzzer
•Compliant with the following standards:
oEN60950/IEC 60950
oISO 18092
oISO 14443
oBluetooth® Smart
oPC/SC
oCCID
oCE
oFCC
oRoHS 2
oREACH
oVCCI (Japan)
oMicrosoft® WHQL
1Applicable under PC-linked mode
2Uses an ACS-defined Android Library
3Uses an ACS-defined iOS Library

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 7 of 73
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
Re-chargeable battery
USB
Computer
NFC

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 8 of 73
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 PCSC
NFC Interface
USB Interface
(CCID)
PCSC Layer
T=CL & T=1
Emulation
ISO 14443/ISO 18092
Interface
NFC
(Built-in Antenna)
Physical
Interface

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 9 of 73
Bluetooth Smart protocol stack architecture is as follows:
GAP Peripheral
Role Profile SIM Access Profile GAP Peripheral Bond Manager
GAP GATT
SMP ATT
L2CAP
HCI
Link Layer
Physical Layer
Figure 3: BluetoothSmart Protocol Stack

ACR1255U-J1 – Reference Manual [e-mail]
Version V1.01 www.acs.com.hk
Page 10 of 73
4.0.Hardware Design
4.1. Battery
ACR1255U-J1 uses a rechargeable Lithium-ion battery, which has a capacity of 320 mAh.
4.1.1. Battery charging
Once the battery of ACR1255U-J1 runs out, it may be charged in any of the following modes: OFF,
USB, Bluetooth; as long as it is connected to a power outlet.
4.1.2. Battery life
The battery life is dependent on the usage of the device. Below is an estimate of the battery life
depending on the various work conditions:
Mode Estimated Battery Life
Working Mode 10 hours
Standby Mode 21 hours
OFF Mode 8 years
Table 2: Estimated Battery Lifespan
4.2. Bluetooth Interface
ACR1255U-J1 uses Bluetooth Smart as the medium to pair the device with computers and mobile
devices.
4.3. USB Interface
The micro USB port is used to connect the ACR1255U-J1 to the computer as battery charging port.
This port is also used in order for the ACR1255U-J1 to operate in PC-linked mode.
4.3.1. Communication Parameters
ACR1255U-J1 is connected to a computer through USB as specified in the USB Specification 2.0.
The ACR1255U-J1 is working in full speed mode, i.e. 12 Mbps.
Pin Signal Function
1 VBUS +5 V power supply for the reader
2 D- Differential signal transmits data between ACR1255U-J1 and computer
3 D+ Differential signal transmits data between ACR1255U-J1 and computer
4 GND Reference voltage level for power supply
Table 3: USB Interface Wiring