~ubuntu-branches/ubuntu/utopic/acsccid/utopic-backports

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
ACS CCID PC/SC Driver for Linux/Mac OS X
Advanced Card Systems Ltd.



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

   1. Release Notes
   2. Installation
   3. History
   4. File Contents
   5. Limitations
   6. Support
   7. Authors
   8. Copyright
   9. License



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

Version: 1.0.2
Release Date: 16/3/2011

Supported Readers
ACR38U-CCID
ACR3801
ACR83U
ACR85 PINPad Reader
ACR88U
ACR100-CCID
ACR100 ICC Reader
ACR101 ICC Reader
ACR102 ICC Reader
ACR122U
ACR122T
ACR122U-SAM
ACR1222 Dual Reader
ACR1222 1SAM Dual Reader
ACR1222L 3S CL Reader
ACR125 nPA plus
ACR128U
ACR1281 CL Reader (qPBOC)
ACR1281 Dual Reader (qPBOC)
ACR1281 PICC Reader (BSI)
ACR1281 Dual Reader (BSI)
APG8201

Operating Systems
Linux
Mac OS X 10.5/10.6



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

1. Login as root.

2. Enter the following commands to unpack the driver source code.

# tar -jxvf acsccid-1.0.2.tar.bz2
# cd acsccid-1.0.2

3. Enter the following commands to install the driver. If you want to use udev,
   please enter "./configure --enable-udev". For more information, please refer
   to the file "acsccid-1.0.2/INSTALL".

# ./configure
# make
# make install

4. To build the driver in Mac OS X, please install development tools from
   Apple and install libusb-0.1. Enter the following commands to install the
   driver.

# ./MacOSX/configure
# make
# make install



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

v1.0.0 (26/8/2009)
1. New release
2. Based on ccid-1.3.11 (http://pcsclite.alioth.debian.org/ccid.html).
3. Change CmdPowerOn() read timeout in IFDHPowerICC() from 60 seconds to 4
   seconds.

v1.0.0 (18/9/2009)
1. Import Mac OS X 10.5 configure script from ccid-1.3.11.
2. Update AUTHORS and COPYING files.
3. 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.
4. 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.

v1.0.0 (14/10/2009)
1. Test the driver on Mac OS X 10.6.

v1.0.1 (9/11/2009)
1. Remove firmware version check.
2. Modify the driver to use separate thread to poll the slot ICC states from
   interrupt endpoint.
   
v1.0.2 (2/2/2010)
1. Do not use separate thread to poll the slot ICC status due to poor
   performance of libusb v0.1.12.
2. Enable polling mode automatically for ACR122U v2.06.

v1.0.2 (17/6/2010)
1. Add ACR125 nPA plus support.

v1.0.2 (22/11/2010)
1. Add ACR1281 PICC Reader (BSI) support.
2. Import Mac OS X 10.6 configure script from ccid-1.3.12.

v1.0.2 (17/12/2010)
1. Add the following readers support:
   ACR1281 Dual Reader (qPBOC)
   ACR1222 Dual Reader
   ACR1222 1SAM Dual Reader
   ACR83U
   ACR85 PINPad Reader
   APG8201
2. Secure PIN Entry (SPE) support for ACR83U requires firmware version 4500 or
   later.
3. Add SCARD_CTL_CODE(3500) support for sending CCID escape command.

v1.0.2 (28/1/2011)
1. Add the following readers support:
   ACR100 ICC Reader
   ACR101 ICC Reader
   ACR102 ICC Reader
   ACR1222L 3S CL Reader
   ACR1281 CL Reader (qPBOC)
   ACR1281 Dual Reader (BSI)
2. Fix a bug that APG8201 and ACR85 cannot receive command properly if command
   length is greater than 64 bytes.
3. Set infinite timeout in T=0, Short APDU and Extended APDU exchange.
4. Simulate ACR1281 Dual Reader (composite device) as multi-slot reader.
5. Improve performance and stability for ACR122U v2.00 - v2.04.
6. Replace acx_pthread.m4 with ax_pthread.m4 from autoconf archive.

v1.0.2 (14/2/2011)
1. 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).

v1.0.2 (21/2/2011)
1. Add DRIVER_OPTION_REMOVE_PUPI_FROM_ATR and DRIVER_OPTION_DISABLE_PICC driver
   options to ACR85.
2. Simulate ACR85 as multi-slot reader. The first slot is ICC and the second
   slot is PICC.
3. Add firmware version check for ACR1222. The driver options are for ACR1222
   v401 only.

v1.0.2 (16/3/2011)
1. Fix reader hang problem by checking card status of ACR85 PICC if SW1SW2
   "63 00" is received.
2. Add ACR3801 support.



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

.
|-- AUTHORS
|-- COPYING
|-- ChangeLog
|-- INSTALL
|-- MacOSX
|   |-- configure
|   |-- convert_reader_h.pl
|   |-- debuglog.h
|   |-- ifdhandler.h
|   |-- pcsclite.h
|   |-- reader.h.in
|   |-- winscard.h
|   `-- wintypes.h
|-- Makefile.am
|-- Makefile.in
|-- NEWS
|-- README
|-- aclocal.m4
|-- bootstrap
|-- config
|   |-- compile
|   |-- config.guess
|   |-- config.sub
|   |-- depcomp
|   |-- install-sh
|   |-- ltmain.sh
|   |-- missing
|   `-- ylwrap
|-- config.h.in
|-- configure
|-- configure.ac
|-- m4
|   |-- Makefile.am
|   |-- Makefile.in
|   `-- ax_pthread.m4
`-- src
    |-- Info.plist.src
    |-- Makefile.am
    |-- Makefile.in
    |-- ccid.c
    |-- ccid.h
    |-- ccid_ifdhandler.h
    |-- ccid_usb.c
    |-- ccid_usb.h
    |-- commands.c
    |-- commands.h
    |-- convert_version.pl
    |-- create_Info_plist.pl
    |-- debug.c
    |-- debug.h
    |-- defs.h
    |-- ifdhandler.c
    |-- misc.h
    |-- openct
    |   |-- LICENSE
    |   |-- buffer.c
    |   |-- buffer.h
    |   |-- checksum.c
    |   |-- checksum.h
    |   |-- proto-t1.c
    |   `-- proto-t1.h
    |-- parser.h
    |-- pcscd_acsccid.rules
    |-- strlcpy.c
    |-- strlcpycat.h
    |-- supported_readers.txt
    |-- tokenparser.l
    |-- towitoko
    |   |-- COPYING
    |   |-- README
    |   |-- atr.c
    |   |-- atr.h
    |   |-- defines.h
    |   |-- pps.c
    |   `-- pps.h
    |-- utils.c
    `-- utils.h



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



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



7. Authors
----------

Advanced Card Systems Ltd. <info@acs.com.hk>
Ludovic Rousseau <ludovic.rousseau@free.fr>
Carlos Prados <cprados@yahoo.com>
Olaf Kirch <okir@suse.de>
Matthias Bruestle



8. Copyright
------------

Copyright (C) 2009-2011 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



9. License
----------

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