background image

 

 

 
 
 
 
 
 
 
 
 
 
 

Application Programming Interface 

Advanced Card Systems Ltd.

 

Website: www.acs.com.hk    
Email: [email protected] 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

A

A

C

C

R

R

1

1

2

2

8

8

 

 

D

D

u

u

a

a

l

l

 

 

I

I

n

n

t

t

e

e

r

r

f

f

a

a

c

c

e

e

 

 

C

C

a

a

r

r

d

d

 

 

R

R

e

e

a

a

d

d

e

e

r

r

 

 

Summary of Contents for ACR128

Page 1: ...Application Programming Interface Advanced Card Systems Ltd Website www acs com hk Email info acs com hk A AC CR R1 12 28 8 D Du ua al l I In nt te er rf fa ac ce e C Ca ar rd d R Re ea ad de er r...

Page 2: ...e Usage 14 5 2 2 Exclusive Mode Setting 14 5 3 Automatic PICC Polling 15 5 4 Manual PICC Polling 17 5 5 Change The Default FWI Polling Timeout And Transmit Frame Size Of The Activated PICC 17 5 6 Ante...

Page 3: ...ICC landing type card acceptor is used to allow the user to perform more R W operations with the contact card A SAM socket is provided for highly secure applications A built in antenna is provided for...

Page 4: ...te at the same time ICC This term stands for Integrated Circuit Card and refers to a plastic card containing an integrated circuit that is compliant with ISO 7816 IFD This term stands for Interface De...

Page 5: ...128 Dual Interface Smart Card Reader 3 0 Architecture of ACR128 3 1 Communication between the PCSC Driver and the ICC PICC SAM Figure 1 0 ACR128 Architecture Page 5 of 36 ACR128 API Version 1 7 May 20...

Page 6: ...Figure 2 0 ACR128 Peripherals and PC SC Drivers 3 3 ACR128 Escape Command To send a direct command to the device the driver uses the PC SC SCardControl API The dwControlCode parameter is defined as d...

Page 7: ...d Read Firmware Version 18 00 Response Response Data E1 00 00 00 01 Firmware Version 14h bytes RFU 0Ah bytes Example Firmware Version HEX 41 43 52 31 32 38 55 5F 56 31 34 00 00 00 00 00 00 00 00 00 Fi...

Page 8: ...ng Blinking Table 2 LED Control CMD Description Description Bit 0 RED LED 1 ON 0 OFF Bit 1 GREEN LED 1 ON 0 OFF Bit 2 RFU RFU Bit 3 RFU RFU Bit 4 RFU RFU Bit 5 RFU RFU Bit 6 RFU RFU Bit 7 RFU RFU To s...

Page 9: ...C is activated 1 beep per second Default Disabled 5 PICC is activated PPS Mode is activated E g 424kps High Speed Mode 2 beeps per second Default Disabled To set the Buzzer duration of the device issu...

Page 10: ...nd PICC 1 Enable 0 Disabled Bit 5 RC531 Reset Indication Buzzer To make a beep when the RC531 is reset 1 Enable 0 Disabled Bit 6 Exclusive Mode Status Buzzer Either ICC or PICC interface can be activa...

Page 11: ...In order for the ACR128U to function properly through USB interface the ACS proprietary device driver has to be installed Please refer to the Device Driver Installation Guide for more details VID 0x0...

Page 12: ...e 1 means T 1 80 T1 Category indicator byte 80 means a status indicator may be present in an optional COMPACT TLV data object 4F Application identifier Presence Indicator 0C Length RID Registered Appl...

Page 13: ...specification 4 N UU TCK Exclusive ORing of all the bytes T0 to Tk Example 1 Consider the ATR from DESFire as follows DESFire ATR 3B 86 80 01 06 75 77 81 02 80 00 ATR ATS Initial Header T0 TD1 TD2 T1...

Page 14: ...is inserted into the contact card acceptor the ACR128U PICC interface will be used Case 2 If a Combi Card that supports both ICC and PICC interfaces is inserted into the contact card acceptor the ACR...

Page 15: ...ode is not activated PICC Interface is available 01 Exclusive Mode is activated now PICC Interface is not available until the ICC interface is deactivated Note Do not insert any card into the contact...

Page 16: ...the following command ACR128 Escape Command Read Existing Polling Status 23 00 Response Response Data E1 00 00 00 01 Status NOTE 1 It is recommended to enable the option Turn Off Antenna Field if the...

Page 17: ...with a longer time interval e g 30 sec 5 5 Change The Default FWI Polling Timeout And Transmit Frame Size Of The Activated PICC For some special cases the applications may have to change the FWI and T...

Page 18: ...equirement but the Polling Timeout will not be changed 5 6 Antenna Field ON OFF The antenna field used to detect the PICC within range can be turned on or off programmatically at any given time To tur...

Page 19: ...mmand Modify Transceiver Setting 20 04 06 Antenna Setting RX Gain TX Mode Use Tables 13 14 and 15 to format Antenna Setting RX Gain and TX Mode values Table 13 Antenna Setting Values CMD Description B...

Page 20: ...ion Default Value Byte 0 MOD_B1 08 Byte 1 COND_B1 3F Byte 2 RX_B1 FF Byte 3 MOD_B2 08 Byte 4 COND_B2 34 Byte 5 RX_B2 FF Byte 6 MOD_A1 06 Byte 7 COND_A1 3F Byte 8 RX_A1 9F Byte 9 MOD_A2 06 Byte 10 COND...

Page 21: ...CCs Only 02 ISO 14443 Type B PICCs Only 03 Both ISO 14443 Type A and B PICCs Use Table 17 to determine the Card Type value To read the device signal output on the card detection process issue the foll...

Page 22: ...ognized 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...

Page 23: ...communicate with the PICC The PICC will become inaccessible if the PICC or environment does not meet the requirement of the proposed communication speed 5 12 Read and Update the RC531 Register To rea...

Page 24: ...nterpret the reader interface values NOTE This command is useful for refreshing the SAM status after a new SAM is inserted Example 1 Refresh the SAM status after a new SAM is inserted Step 1 Connect t...

Page 25: ...Out Result UID LSB UID MSB SW1 SW2 Table 21 c Get ATS of an ISO 14443 A card ATS 2 Bytes if P1 0x01 Response Data Out Result ATS SW1 SW2 Table 21 d Response Codes Results SW1 SW2 Meaning Success 90 00...

Page 26: ...s non volatile memory Other Reserved Key Number 1 Byte 0x00 0x1F Non volatile memory for storing keys The keys are permanently stored in the reader and will not be erased even when the reader is disco...

Page 27: ...tly stored in the reader and will not be erased even when the reader is disconnected from the PC It can store up to 32 keys 0x20 Volatile memory for storing keys The keys will be erased when the reade...

Page 28: ...or 31 0x7C 0x7E 0x7F Sectors Total of 8 sectors Each sector consists of 16 consecutive blocks Data Blocks 15 blocks 16 bytes per block Trailer Block 1 block 16 bytes Sector 32 0x80 0x8E 0x8F Sector 33...

Page 29: ...ple Blocks Mode 15 consecutive blocks Example 1 0x10 16 bytes The starting block only Single Block Mode Example 2 0x40 64 bytes From the starting block to starting block 3 Multiple Blocks Mode NOTE Fo...

Page 30: ...FARE 4K Multiple Blocks Mode 15 consecutive blocks Block Data Multiple of 16 2 Bytes or 6 bytes The data to be written into the binary blocks Example 1 0x10 16 bytes The starting block only Single Blo...

Page 31: ...block will then be converted to a value block 0x01 Increment the value of the value block by the VB_Value This command is only valid for value block 0x02 Decrement the value of the value block by the...

Page 32: ...cessed Table 27 b Read Value Block Response Format 4 2 Bytes Response Data Out Result Value MSB LSB SW1 SW2 where Value This is 4 Bytes long This is the value returned from the card The value is a sig...

Page 33: ...e and target value blocks must be in the same sector Table 28 b Restore Value Block Response Format 2 Bytes Response Data Out Result SW1 SW2 Table 28 c Restore Value Block Response Codes Results SW1 S...

Page 34: ...le 29 c Common ISO 7816 4 Response Codes Results SW1 SW2 Meaning Success 90 00 The operation is completed successfully Error 63 00 The operation failed Example 1 ISO7816 4 APDU To read 8 bytes from an...

Page 35: ...number from an ISO 14443 4 Type A PICC DESFIRE APDU 0A 00 Answer AF 25 9C 65 0C 87 65 1D D7 1DD7 In which the first byte AF is the status code returned by the DESFire Card The Data inside the blanket...

Page 36: ...t accessible try to place the E Passport by 5 10mm above the reader 3 In case the E Passport is still not accessible please change operating speed to 106kbps Set the Connection Speed to default 106k b...

Reviews: