ACS CCID PC/SC Driver for Linux/Mac OS X
Advanced Card Systems Ltd.
Introduction
------------
acsccid is a PC/SC driver for Linux/Mac OS X and it supports ACS CCID smart card
readers. This library provides a PC/SC IFD handler implementation and
communicates with the readers through the PC/SC Lite resource manager (pcscd).
acsccid is based on ccid 1.3.11. See CCID free software driver [1] for more
information.
To build acsccid, you need pcsc-lite 1.3.3 or above and libusb 0.1.12. For more
information, see the INSTALL file.
[1] http://pcsclite.alioth.debian.org/ccid.html
System Requirements
-------------------
Linux
Mac OS X 10.5/10.6/10.7
Supported Readers
-----------------
CCID Readers
VID PID Reader Reader Name
---- ---- ------------------- -----------------------------
072F 8300 ACR33U-A1 ACS ACR33U-A1 3SAM ICC Reader
072F 8302 ACR33U-A2 ACS ACR33U-A2 3SAM ICC Reader
072F 8307 ACR33U-A3 ACS ACR33U-A3 3SAM ICC Reader
072F 8301 ACR33U ACS ACR33U 4SAM ICC Reader
072F 90CC ACR38U-CCID ACS ACR38U-CCID
072F 90CC ACR100-CCID ACS ACR38U-CCID
072F 90D8 ACR3801 ACS ACR3801
072F B100 ACR39U ACS ACR39U ICC Reader
072F B101 ACR39K ACS ACR39K ICC Reader
072F B102 ACR39T ACS ACR39T ICC Reader
072F B103 ACR39F ACS ACR39F ICC Reader
072F B104 ACR39U-SAM ACS ACR39U-SAM ICC Reader
072F 90D2 ACR83U-A1 ACS ACR83U
072F 8306 ACR85 ACS ACR85 PINPad Reader
072F 2011 ACR88U ACS ACR88U
072F 8900 ACR89U-A1 ACS ACR89 ICC Reader
072F 8901 ACR89U-A2 ACS ACR89 Dual Reader
072F 8902 ACR89U-A3 ACS ACR89 FP Reader
072F 1205 ACR100I ACS ACR100 ICC Reader
072F 1204 ACR101 ACS ACR101 ICC Reader
072F 1206 ACR102 ACS ACR102 ICC Reader
072F 2200 ACR122U ACS ACR122U
072F 2200 ACR122U-SAM ACS ACR122U
072F 2200 ACR122T ACS ACR122U
072F 2214 ACR1222U-C1 ACS ACR1222 1SAM PICC Reader
072F 1280 ACR1222U-C3 ACS ACR1222 1SAM Dual Reader
072F 2207 ACR1222U-C6 ACS ACR1222 Dual Reader
072F 222B ACR1222U-C8 ACS ACR1222 1SAM PICC Reader
072F 2206 ACR1222L-D1 ACS ACR1222 3S PICC Reader
072F 2203 ACR125 ACS ACR125 nPA plus
072F 221A ACR1251U-A1 ACS ACR1251 1S CL Reader
072F 2229 ACR1251U-A2 ACS ACR1251 CL Reader
072F 222D [OEM Reader] [OEM Reader Name]
072F 2100 ACR128U ACS ACR128U
072F 2224 ACR1281U-C1 ACS ACR1281 1S Dual Reader
072F 220F ACR1281U-C2 (qPBOC) ACS ACR1281 CL Reader
072F 2223 ACR1281U (qPBOC) ACS ACR1281 PICC Reader
072F 2208 ACR1281U-C3 (qPBOC) ACS ACR1281 Dual Reader
072F 0901 ACR1281U-C4 (BSI) ACS ACR1281 PICC Reader
072F 220A ACR1281U-C5 (BSI) ACS ACR1281 Dual Reader
072F 2215 ACR1281U-C6 ACS ACR1281 2S CL Reader
072F 2220 ACR1281U-C7 ACS ACR1281 1S PICC Reader
072F 2213 ACR1283L-D1 ACS ACR1283 4S CL Reader
072F 222C ACR1283L-D2 ACS ACR1283 CL Reader
072F 220C ACR1283 Bootloader ACS ACR1283U FW Upgrade
072F 0102 AET62 ACS AET62 PICC Reader
072F 0103 AET62 ACS AET62 1SAM PICC Reader
072F 0100 AET65 ACS AET65 ICC Reader
072F 8201 APG8201-A1 ACS APG8201
072F 8202 [OEM Reader] [OEM Reader Name]
072F 90DB CryptoMate64 ACS CryptoMate64
non-CCID Readers
VID PID Reader Reader Name
---- ---- ------------------- -----------------------------
072F 9000 ACR38U ACS ACR38U
072F 90CF ACR38U-SAM ACS ACR38U-SAM
072F 90CE [OEM Reader] [OEM Reader Name]
072F 0101 AET65 ACS AET65 1SAM ICC Reader
072F 9006 CryptoMate ACS CryptoMate
History
-------
v1.0.4 (15/6/2012)
- Add the following readers support:
ACR39U ICC Reader
ACR39K ICC Reader
ACR39T ICC Reader
ACR39F ICC Reader
ACR39U-SAM ICC Reader
ACR1251 1S CL Reader
ACR1251 CL Reader
OEM Reader (VID: 072F, PID: 222D)
ACR1283 4S CL Reader
ACR1283 CL Reader
ACR1283U FW Upgrade
- Fix a bug that only the first slot of reader (composite device) can be used if
pcsc-lite is compiled with libudev support.
- Fix a bug that APG8201 causes segmentation fault with pcsc-lite 1.8.2.
- Fix a bug that the SAM slot support is not enabled for ACR1281 1S PICC Reader
if the configure option "--enable-composite-as-multislot" is not used.
- Enable silent build and disable static library creation.
- Remove symbolic link creation.
- Fix a bug that pcscd causes segmentation fault on Mac OS X after unloading the
driver.
- Display default message for ACR83U.
v1.0.3 (13/1/2012)
- Add the following readers support:
ACR1281 PICC Reader (qPBOC)
ACR1281 1S Dual Reader
ACR1281 2S CL Reader
ACR33 ICC Reader
ACR1281 1S PICC Reader
ACR38U
ACR38U-SAM
OEM Reader (VID: 072F, PID: 90CE)
CryptoMate
OEM Reader (VID: 072F, PID: 8202)
ACR1222 1SAM PICC Reader (ACR1222U-C1)
ACR1222 1SAM PICC Reader (ACR1222U-C8)
ACR89 ICC Reader
ACR89 Dual Reader
ACR89 FP Reader
AET62 PICC Reader
AET62 1SAM PICC Reader
AET65 ICC Reader
AET65 1SAM ICC Reader
CryptoMate64
- Import udev rules from ccid-1.4.3 to support pcscd auto-start.
- Fix reader hang problem by checking card status of ACR85 PICC before
exchanging APDU.
- Correct the code that enabling polling mode is applied to ACR122U only and
not all ACS readers.
- Fix a problem that the optimal baud rate is not selected properly in
IFDHSetProtocolParameters().
- Perform cold reset and try default Fl/Dl (0x11) if PPS_Exchange() or
SetParameters() is failed in IFDHSetProtocolParameters().
- Protocol parameters will not be set in IFDHSetProtocolParameters() if card is
specific mode.
- Correct the value of CCID features and maximum data rate of ACR88U and
ACR128U.
- Add BSI miscellaneous command to return driver version for ACR1281 BSI
readers.
- Correct the value of CCID features and maximum data rate of ACR1281 1S Dual
Reader.
- Fix problem using pcsc-lite 1.7.3 or later header files.
- Add SCARD_CTL_CODE(2079) support for sending escape command to ACR1222,
ACR128 and ACR1281 readers.
- Add firmware version check for ACR85.
- Change PID of ACR33 ICC reader from 0x8306 to 0x8307 because 0x8306 is used
by ACR85 ICC.
- Check if the card supports the selected protocol before setting protocol in
IFDHSetProtocolParameters() and return IFD_ERROR_PTS_FAILURE if the card does
not support the selected protocol. On Mac OS X 10.6, pcscd will select wrong
protocol if Starcos 3.2 card is inserted.
- Rename "ACR1222L 3S CL Reader" to "ACR1222 3S PICC Reader".
- Rename "ACR33 ICC Reader" to "ACS ACR33U-A1 3SAM ICC Reader",
"ACS ACR33U-A2 3SAM ICC Reader", "ACS ACR33U-A3 3SAM ICC Reader" and
"ACS ACR33U 4SAM ICC Reader".
- Fix incorrect max slot index for ACR1222U-C1.
- Enable SAM slot support.
- Fix connection problem by setting default supported protocol to T=0 in
IFDHSetProtocolParameters() if the card does not support any protocol.
- Add SCARD_ATTR_ICC_INTERFACE_STATUS and SCARD_ATTR_ICC_PRESENCE support in
IFDHGetCapabilities() (import from ccid-1.4.5).
- Fix problem on getting IFSC from ATR (import from ccid-1.4.5).
- Support extended APDU of up to 64kB with APDU readers
(import from ccid-1.4.5).
- Change CmdPowerOn() read timeout in IFDHPowerICC() from 4 seconds to 10
seconds.
v1.0.2 (16/3/2011)
- Add the following readers support:
ACR125 nPA plus
ACR1281 PICC Reader (BSI)
ACR1281 Dual Reader (qPBOC)
ACR1222 Dual Reader
ACR1222 1SAM Dual Reader
ACR83U
ACR85 PINPad Reader
APG8201
ACR100 ICC Reader
ACR101 ICC Reader
ACR102 ICC Reader
ACR1222L 3S CL Reader
ACR1281 CL Reader (qPBOC)
ACR1281 Dual Reader (BSI)
ACR3801
- Do not use separate thread to poll the slot ICC status due to poor
performance of libusb v0.1.12.
- Enable polling mode automatically for ACR122U v2.06.
- Import Mac OS X 10.6 configure script from ccid-1.3.12.
- Secure PIN Entry (SPE) support for ACR83U requires firmware version 4500 or
later.
- Add SCARD_CTL_CODE(3500) support for sending CCID escape command.
- Add the following readers support:
- Fix a bug that APG8201 and ACR85 cannot receive command properly if command
length is greater than 64 bytes.
- Set infinite timeout in T=0, Short APDU and Extended APDU exchange.
- Simulate ACR1281 Dual Reader (composite device) as multi-slot reader.
- Improve performance and stability for ACR122U v2.00 - v2.04.
- Replace acx_pthread.m4 with ax_pthread.m4 from autoconf archive.
- Add the following driver options and these options are enabled by default:
DRIVER_OPTION_REMOVE_PUPI_FROM_ATR
Remove PUPI from ATR if ISO 14443-B card is detected (ACR1222).
DRIVER_OPTION_DISABLE_PICC
Disable PICC if ICC is inserted (ACR1222).
- Add DRIVER_OPTION_REMOVE_PUPI_FROM_ATR and DRIVER_OPTION_DISABLE_PICC driver
options to ACR85.
- Simulate ACR85 as multi-slot reader. The first slot is ICC and the second
slot is PICC.
- Add firmware version check for ACR1222. The driver options are for ACR1222
v401 only.
- Fix reader hang problem by checking card status of ACR85 PICC if SW1SW2
"63 00" is received.
v1.0.1 (9/11/2009)
- Remove firmware version check.
- Modify the driver to use separate thread to poll the slot ICC states from
interrupt endpoint.
v1.0.0 (14/10/2009)
- New release.
- Based on ccid-1.3.11 (http://pcsclite.alioth.debian.org/ccid.html).
- Change CmdPowerOn() read timeout in IFDHPowerICC() from 60 seconds to 4
seconds.
- Import Mac OS X 10.5 configure script from ccid-1.3.11.
- Update AUTHORS and COPYING files.
- Disable interrupt read in ccid_open_hack_pre() for all readers. It will cause
the driver hang in ACR88U and ACR128U readers on Mac OS X.
- There is a pcscd problem supporting multi-slot readers on Mac OS X. It will
create duplicate reader name for each slot. ACR88U and ACR128U readers are
affected by this bug. For more information, please refer to
http://www.opensc-project.org/sca/wiki/LeopardBugs.
- Test the driver on Mac OS X 10.6.
Support
-------
In case of problem, please contact ACS through:
Web Site: http://www.acs.com.hk/
E-mail: info@acs.com.hk
Tel: +852 2796 7873
Fax: +852 2796 1286
-------------------------------------------------------------------------------
Copyright (C) 2009-2012 Advanced Card Systems Ltd.
Copyright (C) 2003-2009 Ludovic Rousseau
Copyright (C) 2000-2001 Carlos Prados
Copyright (C) 2003 Olaf Kirch
Copyright (C) 1999-2002 Matthias Bruestle
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
