ACS Smart Card API for Android
Advanced Card Systems Ltd.



Contents
----------------

   1. Release Notes
   2. Installation
   3. History
   4. File Contents
   5. Limitations
   6. Support



1. Release Notes
----------------

Version: 1.1.1
Release Date: 12/7/2012

Supported Readers

VID  PID  Reader
---- ---- ---------------------------
072F 8300 ACR33U-A1
072F 8302 ACR33U-A2
072F 8307 ACR33U-A3
072F 8301 ACR33U
072F 90CC ACR38U-CCID/ACR100-CCID
072F 90D8 ACR3801
072F B100 ACR39U
072F B101 ACR39K
072F B102 ACR39T
072F B103 ACR39F
072F B104 ACR39U-SAM
072F 90D2 ACR83U-A1
072F 2011 ACR88U
072F 8900 ACR89U-A1
072F 8901 ACR89U-A2
072F 8902 ACR89U-A3
072F 1205 ACR100I
072F 1204 ACR101
072F 1206 ACR102
072F 2200 ACR122U/ACR122U-SAM/ACR122T
072F 2214 ACR1222U-C1
072F 1280 ACR1222U-C3
072F 2207 ACR1222U-C6
072F 222B ACR1222U-C8
072F 2206 ACR1222L-D1
072F 2203 ACR125
072F 221A ACR1251U-A1
072F 2229 ACR1251U-A2
072F 2100 ACR128U
072F 2224 ACR1281U-C1
072F 220F ACR1281U-C2 (qPBOC)
072F 2223 ACR1281U    (qPBOC)
072F 2208 ACR1281U-C3 (qPBOC)
072F 0901 ACR1281U-C4 (BSI)
072F 220A ACR1281U-C5 (BSI)
072F 2215 ACR1281U-C6
072F 2220 ACR1281U-C7
072F 2213 ACR1283L-D1
072F 222C ACR1283L-D2
072F 8201 APG8201-A1
072F 90DB CryptoMate64

System Requirements

Android 3.1 or above
USB host support on Tablet

To build Android Application, you need to install Android SDK and ADT Plugin for
Eclipse. For more information, please refer to http://developer.android.com/.



2. Installation
---------------

1. Copy "acssmc" and "ReaderTest" folder to the workspace of Eclipse.
2. To use the class library, select "Java Build Path" from your project
   properties. Then select "Libraries" tab and click on "Add JARs..." button.
3. Select "acssmc-1.1.1.jar" from file list.



3. History
----------

v1.0.0 (30/12/2011)
1. New Release

v1.1.0 (18/5/2012)
1. Add the following readers support:
   ACR83U-A1
   APG8201-A1
2. Add utility classes Features, PinVerify, PinModify, PinProperties,
   TlvProperties and ReadKeyOption to support PC/SC 2.0 Part 10 and
   ACR83/APG8201 specific controls.
3. Handle PC/SC 2.0 Part 10 and ACR83/APG8201 specific controls in
   Reader.control().

v1.1.1 (12/7/2012)
1. Add the following readers support:
   ACR39U
   ACR39K
   ACR39T
   ACR39F
   ACR39U-SAM
   ACR88U
   ACR89U-A1
   ACR89U-A2
   ACR89U-A3
   ACR125
   ACR1251U-A1
   ACR1251U-A2
   ACR1281U-C2 (qPBOC)
   ACR1281U    (qPBOC)
   ACR1281U-C3 (qPBOC)
   ACR1281U-C4 (BSI)
   ACR1281U-C5 (BSI)
   ACR1281U-C6
   ACR1281U-C7
   ACR1283L-D1
   ACR1283L-D2
   CryptoMate64



4. File Contents
----------------

Class Library:      acssmc\acssmc-1.1.1.jar
API Documentation:  acssmc\doc
Sample Application: ReaderTest

|   ReadMe.txt
|
+---acssmc
|   |   acssmc-1.1.1.jar
|   |
|   \---doc
|       |   allclasses-frame.html
|       |   allclasses-noframe.html
|       |   constant-values.html
|       |   deprecated-list.html
|       |   help-doc.html
|       |   index.html
|       |   overview-tree.html
|       |   package-list
|       |   serialized-form.html
|       |   stylesheet.css
|       |
|       +---com
|       |   \---acs
|       |       \---smartcard
|       |           |   BufferOverflowException.html
|       |           |   CommunicationErrorException.html
|       |           |   DevicePowerFailureException.html
|       |           |   DeviceProtocolErrorException.html
|       |           |   Features.html
|       |           |   InsufficientBufferException.html
|       |           |   InternalErrorException.html
|       |           |   InvalidDeviceStateException.html
|       |           |   package-frame.html
|       |           |   package-summary.html
|       |           |   package-tree.html
|       |           |   package-use.html
|       |           |   PinModify.html
|       |           |   PinProperties.html
|       |           |   PinVerify.html
|       |           |   ProtocolMismatchException.html
|       |           |   Reader.html
|       |           |   Reader.OnStateChangeListener.html
|       |           |   ReaderException.html
|       |           |   ReaderFeatures.html
|       |           |   ReaderProperties.html
|       |           |   ReadKeyOption.html
|       |           |   RemovedCardException.html
|       |           |   TlvProperties.html
|       |           |   UnpoweredCardException.html
|       |           |   UnresponsiveCardException.html
|       |           |   UnsupportedCardException.html
|       |           |
|       |           \---class-use
|       |                   BufferOverflowException.html
|       |                   CommunicationErrorException.html
|       |                   DevicePowerFailureException.html
|       |                   DeviceProtocolErrorException.html
|       |                   Features.html
|       |                   InsufficientBufferException.html
|       |                   InternalErrorException.html
|       |                   InvalidDeviceStateException.html
|       |                   PinModify.html
|       |                   PinProperties.html
|       |                   PinVerify.html
|       |                   ProtocolMismatchException.html
|       |                   Reader.html
|       |                   Reader.OnStateChangeListener.html
|       |                   ReaderException.html
|       |                   ReaderFeatures.html
|       |                   ReaderProperties.html
|       |                   ReadKeyOption.html
|       |                   RemovedCardException.html
|       |                   TlvProperties.html
|       |                   UnpoweredCardException.html
|       |                   UnresponsiveCardException.html
|       |                   UnsupportedCardException.html
|       |
|       +---index-files
|       |       index-1.html
|       |       index-10.html
|       |       index-11.html
|       |       index-12.html
|       |       index-2.html
|       |       index-3.html
|       |       index-4.html
|       |       index-5.html
|       |       index-6.html
|       |       index-7.html
|       |       index-8.html
|       |       index-9.html
|       |
|       \---resources
|               inherit.gif
|
\---ReaderTest
    |   .classpath
    |   .project
    |   AndroidManifest.xml
    |   default.properties
    |   proguard.cfg
    |
    +---assets
    +---bin
    |   |   classes.dex
    |   |   ReaderTest.apk
    |   |   resources.ap_
    |   |
    |   \---com
    |       \---acs
    |           \---readertest
    |                   R$attr.class
    |                   R$drawable.class
    |                   R$id.class
    |                   R$layout.class
    |                   R$string.class
    |                   R.class
    |                   ReaderTestActivity$1.class
    |                   ReaderTestActivity$10.class
    |                   ReaderTestActivity$11.class
    |                   ReaderTestActivity$12.class
    |                   ReaderTestActivity$13.class
    |                   ReaderTestActivity$14.class
    |                   ReaderTestActivity$15.class
    |                   ReaderTestActivity$16.class
    |                   ReaderTestActivity$17.class
    |                   ReaderTestActivity$18.class
    |                   ReaderTestActivity$19.class
    |                   ReaderTestActivity$2$1.class
    |                   ReaderTestActivity$2.class
    |                   ReaderTestActivity$20.class
    |                   ReaderTestActivity$21.class
    |                   ReaderTestActivity$22.class
    |                   ReaderTestActivity$23.class
    |                   ReaderTestActivity$24.class
    |                   ReaderTestActivity$25.class
    |                   ReaderTestActivity$3.class
    |                   ReaderTestActivity$4.class
    |                   ReaderTestActivity$5.class
    |                   ReaderTestActivity$6.class
    |                   ReaderTestActivity$7.class
    |                   ReaderTestActivity$8.class
    |                   ReaderTestActivity$9.class
    |                   ReaderTestActivity$CloseTask.class
    |                   ReaderTestActivity$OpenTask.class
    |                   ReaderTestActivity$PowerParams.class
    |                   ReaderTestActivity$PowerResult.class
    |                   ReaderTestActivity$PowerTask.class
    |                   ReaderTestActivity$SetProtocolParams.class
    |                   ReaderTestActivity$SetProtocolResult.class
    |                   ReaderTestActivity$SetProtocolTask.class
    |                   ReaderTestActivity$TransmitParams.class
    |                   ReaderTestActivity$TransmitProgress.class
    |                   ReaderTestActivity$TransmitTask.class
    |                   ReaderTestActivity.class
    |
    +---gen
    |   \---com
    |       \---acs
    |           \---readertest
    |                   R.java
    |
    +---res
    |   +---drawable-hdpi
    |   |       icon.png
    |   |
    |   +---drawable-ldpi
    |   |       icon.png
    |   |
    |   +---drawable-mdpi
    |   |       icon.png
    |   |
    |   +---layout
    |   |       display_lcd_message_dialog.xml
    |   |       main.xml
    |   |       modify_pin_dialog.xml
    |   |       read_key_dialog.xml
    |   |       verify_pin_dialog.xml
    |   |
    |   \---values
    |           strings.xml
    |
    \---src
        \---com
            \---acs
                \---readertest
                        ReaderTestActivity.java



5. Limitations
--------------




