ACS ACR89U-A1, Reference Manual

Page: 2 / 57

ACR89U-A1 – Reference Manual
info@acs.com.hk
Version 1.04
www.acs.com.hk
Page 2 of 57
Table of Contents
1.0. Introduction ............................................................................................................... 4
1.1. Document Overview .............................................................................................................. 4
2.0. Hardware Design ....................................................................................................... 5
2.1. Architecture ............................................................................................................................ 5
2.2. USB Interface ........................................................................................................................ 5
2.3. Communication Parameters .................................................................................................. 5
2.4. Endpoints ............................................................................................................................... 5
2.5. Contact Smart Card Interface ................................................................................................ 6
2.5.1. Smart Card Power Supply VCC (C1) ............................................................................ 6
2.5.2. Card Type Selection...................................................................................................... 6
2.5.3. Interface for Microcontroller-based Cards .................................................................... 6
3.0. ACR89U-A1 USB Communication Protocol ............................................................ 7
3.1. Device Configuration ............................................................................................................. 7
3.2. CCID Class-Specific Requests .............................................................................................. 8
3.2.1. Command Summary ..................................................................................................... 8
3.3. CCID Command Pipe BulK-Out Message ............................................................................. 8
3.3.1. Command Summary ..................................................................................................... 9
3.4. CCID Command Pipe Bulk-In Message .............................................................................. 14
3.4.1. Message Summary ..................................................................................................... 15
3.5. Extended Command Pipe Message Compatible with ACR89 ............................................. 17
3.5.1. Extended Command Pipe Bulk-OUT Message .......................................................... 18
3.5.2. Commands Detail ........................................................................................................ 18
3.5.3. Extended Command Pipe Bulk-IN Message .............................................................. 25
3.5.4. Messages Detail .......................................................................................................... 26
3.5.5. Extended Command Response Codes and Return States ........................................ 28
3.6. CCID Interrupt-IN Message ................................................................................................. 29
3.6.1. Message Summary ..................................................................................................... 29
3.7. CCID Error and Status Code ............................................................................................... 30
4.0. Dynamic Link Library (DLL) ................................................................................... 32
4.1. ACR89 DLL API Declarations .............................................................................................. 32
4.1.1. Enumerators ................................................................................................................ 32
4.1.2. Reader Command Data Structures ............................................................................. 33
4.1.3. Reader Response Data .............................................................................................. 38
4.1.4. Reader Shared Command/Response Data Structures ............................................... 39
4.2. ACR89 DLL API Functions .................................................................................................. 41
4.2.1. General Description .................................................................................................... 41
4.2.2. Port Functions ............................................................................................................. 41
4.2.3. Device Functions ......................................................................................................... 43
4.2.4. LCD Functions ............................................................................................................ 45
4.2.5. Keypad Functions ....................................................................................................... 50
4.2.6. Real-time Clock Functions .......................................................................................... 53
4.2.7. Other Functions ........................................................................................................... 55
Appendix A. Error Codes (DLL Errors) .......................................................................... 57
List of Figures
Figure 1
: ACR89U-A1 Architecture ....................................................................................................... 5
Figure 2 : CCID PC_to_RDR_Escape Message .................................................................................. 18
Figure 3 : PC_to_ACR89_DisplayGraphic – Bitmap Format ............................................................... 21
Figure 4 : CCID RDR_to_PC_Escape Message .................................................................................. 26
Figure 5 : Bitmap Format for ACR89 Reader ....................................................................................... 47