| 6 |
specifications from the USB working group. |
specifications from the USB working group. |
| 7 |
|
|
| 8 |
|
|
| 9 |
Author: |
Authors: |
| 10 |
======= |
======== |
| 11 |
|
|
| 12 |
- Ludovic Rousseau <ludovic.rousseau@free.fr> |
- Ludovic Rousseau <ludovic.rousseau@free.fr> |
| 13 |
|
- Carlos Prados for the PPS and ATR parsing code (taken from his |
| 14 |
|
towitoto driver) in towitoko/ directory. |
| 15 |
|
- Olaf Kirch for the T=1 TPDU code (from the OpenCT package) in openct/ |
| 16 |
|
directory. I (Ludovic Rousseau) greatly improved this code. |
| 17 |
|
|
| 18 |
|
|
| 19 |
Supported CCID readers: |
Supported CCID readers: |
| 20 |
======================= |
======================= |
| 21 |
|
|
| 22 |
(in alphabetical order) |
(in alphabetical order) |
| 23 |
|
- ActivCard USB reader 3.0 |
| 24 |
|
- Advanced Card Systems ACR 38U-CCID [16] |
| 25 |
|
old versions of this reader have a bug: the reader do timeout when a |
| 26 |
|
special USB frame is sent from the reader. If the frame size if a |
| 27 |
|
multiple of wMaxPacketSize the communication is stopped. |
| 28 |
|
- Alcor Micro AU9520 [46] |
| 29 |
|
Firmware 1.01 is bogus. The time request sent by the card is not |
| 30 |
|
forwarded by the reader to the host. |
| 31 |
|
- Athena ASE IIIe USB V2 [29] |
| 32 |
|
- Athena ASE IIIe KB USB [42] |
| 33 |
|
- C3PO LTC31 (new model, USB product id 0x0006) [8] |
| 34 |
|
- Cherry XX33 keyboard [?] |
| 35 |
|
- Cherry XX44 keyboard (SmartBoard G83-6744) [18] |
| 36 |
|
- Cherry SmartTerminal ST2000U [35] |
| 37 |
|
- Cherry ST-1044U [27] |
| 38 |
|
- Dell keyboard SK-3106 [?] |
| 39 |
|
- Dell smart card reader keyboard [?] |
| 40 |
|
- Eutron SIM Pocket Combo [25] |
| 41 |
|
- Eutron CryptoIdentity [26] |
| 42 |
- Gemplus GemPC 433 SL [2] |
- Gemplus GemPC 433 SL [2] |
| 43 |
|
- Gemplus GemPC Card [41] |
| 44 |
- Gemplus GemPC Key [3] |
- Gemplus GemPC Key [3] |
| 45 |
|
- Gemplus GemPC PinPad |
| 46 |
- Gemplus GemPC Twin [4] |
- Gemplus GemPC Twin [4] |
| 47 |
- LTC31 from C3PO [8] |
- Gemplus GemCore POS Pro |
| 48 |
|
- Gemplus GemCore SIM Pro |
| 49 |
|
- Kobil KAAN Base [19] |
| 50 |
|
- Kobil KAAN Advanced [20] |
| 51 |
|
- Kobil KAAN SIM III [21] |
| 52 |
- OmniKey CardMan 3121 [5] |
- OmniKey CardMan 3121 [5] |
| 53 |
|
- RSA SecureID SID800 [50] |
| 54 |
- SCM Micro SCR 331 [6] |
- SCM Micro SCR 331 [6] |
| 55 |
|
You shall upgrade the firmware [17] using version 5.18 or later. |
| 56 |
|
- SCM Micro SCR 331-DI [11] |
| 57 |
|
You shall upgrade the firmware [17] using version 6.22 or later. |
| 58 |
- SCM Micro SCR 335 [7] |
- SCM Micro SCR 335 [7] |
| 59 |
|
The firmware of this reader can't be upgraded so be sure to buy a |
| 60 |
|
recent model with firmware 5.14 or later |
| 61 |
Unsupported CCID readers: |
- SCM Micro SCR 355 |
| 62 |
========================= |
- SCM Micro SCR 3310 [30] |
| 63 |
|
- SCM Micro SCR 3311 [31] |
| 64 |
None known. |
- SCM Micro SPR 532 [9] |
| 65 |
|
You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a |
| 66 |
|
firmware upgrade. |
| 67 |
|
- SmartEpad (v 2.0) [32] |
| 68 |
|
The firmware gives a very strange description of the reader (like a |
| 69 |
|
dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior. |
| 70 |
|
- Verisign Secure Storage Token [24] |
| 71 |
|
- Verisign Secure Token [?] |
| 72 |
|
- Xiring Teo [52] |
| 73 |
|
|
| 74 |
|
|
| 75 |
|
Should work but untested by me: |
| 76 |
|
=============================== |
| 77 |
|
|
| 78 |
|
I would like to get these readers to perform test and validation and |
| 79 |
|
move them in the supported list above. If you are one of the |
| 80 |
|
manufacturers, please, contact me. |
| 81 |
|
|
| 82 |
|
- Axalto Reflex USB v3 [38] |
| 83 |
|
- C3PO LTC32 [13] |
| 84 |
|
- C3PO TLTC2USB |
| 85 |
|
- C3PO KBR36 |
| 86 |
|
- Gemplus GemPC Express |
| 87 |
|
- Fujitsu Siemens Computers SmartCard USB 2A [53] |
| 88 |
|
- Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54] |
| 89 |
|
- HP USB Smart Card Keyboard [44] |
| 90 |
|
- HP USB Smartcard Reader |
| 91 |
|
- id3 Semiconductors CL1356D [45] (tested by me but I don't have the |
| 92 |
|
reader anymore) |
| 93 |
|
- id3 Semiconductors CL1356T [48] (it should be the same firmware as the |
| 94 |
|
CL1356D) |
| 95 |
|
- OmniKey CardMan 1021 |
| 96 |
|
- OmniKey CardMan 3021 [49] |
| 97 |
|
- OmniKey CardMan 3621 [43] |
| 98 |
|
- OmniKey CardMan 3821 [37] |
| 99 |
|
- OmniKey CardMan 5121 [33] |
| 100 |
|
- OmniKey CardMan 5125 [51] |
| 101 |
|
- OmniKey CardMan 6121 [36] |
| 102 |
|
- O2Micro Oz7762 |
| 103 |
|
- SCM Micro SCR 331-DI NTTCom [23] |
| 104 |
|
- SCM Micro SCR 3310-NTTCOM [28] |
| 105 |
|
- SCM Micro SCR 3320 [32] |
| 106 |
|
- SCM Micro SCR 333 [15] |
| 107 |
|
- SCM Micro SDI 010 [39] |
| 108 |
|
- SCM SCR 3340 ExpressCard54 [34] |
| 109 |
|
- Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14] |
| 110 |
|
- Winbond Electronics (for OEM only) [40] |
| 111 |
|
|
| 112 |
|
|
| 113 |
|
Unsupported or partly supported CCID readers: |
| 114 |
|
============================================= |
| 115 |
|
|
| 116 |
|
- ActivCard USB reader 2.0 [10] |
| 117 |
|
The reader do timeout when a special USB frame is sent from the |
| 118 |
|
reader. If the frame size if a multiple of wMaxPacketSize the |
| 119 |
|
communication is stopped. |
| 120 |
|
- C3PO LTC31 (old model, USB product id 0x0003) [8] |
| 121 |
|
The reader works fine with Linux kernel 2.4 but does not with Linux |
| 122 |
|
kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument) |
| 123 |
|
- iDream (THRC2002-2) [47] |
| 124 |
|
PPS fails with a Cryptoflex card |
| 125 |
|
powerup fails with a Setcos card |
| 126 |
|
does work with the belgium eID (the reader is sold for this |
| 127 |
|
application) |
| 128 |
|
- Kobil mIDentity [22] |
| 129 |
|
Time requests are not managed correctly and make the firmware fails. |
| 130 |
|
This is not a problem unless you use a time-consuming APDU like RSA |
| 131 |
|
key generation. |
| 132 |
|
A new firmware will correct the bug. |
| 133 |
|
|
| 134 |
|
|
| 135 |
Supported operating systems: |
Supported operating systems: |
| 140 |
to libusb) |
to libusb) |
| 141 |
|
|
| 142 |
|
|
| 143 |
|
Debug informations: |
| 144 |
|
=================== |
| 145 |
|
|
| 146 |
|
The driver uses the debug function provided by pcscd. So if pcscd sends |
| 147 |
|
its debug to stderr (pcscd --foreground) then the CCID will also send |
| 148 |
|
its debug to stderr. If pcscd sends its debug to syslog (by default) |
| 149 |
|
then the CCID will also send its debug to syslog. |
| 150 |
|
|
| 151 |
|
You can change the debug level using the Info.plist configuration file. |
| 152 |
|
The Info.plist is installed, by default, in |
| 153 |
|
/usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist |
| 154 |
|
|
| 155 |
|
The debug level is set in the ifdLogLevel field. It is a binary OR |
| 156 |
|
combinaison of 4 different levels. |
| 157 |
|
- 1: critical: important error messages |
| 158 |
|
- 2: info: informative messages like what reader was detected |
| 159 |
|
- 4: comm: a dump of all the bytes exchanged between the host and the |
| 160 |
|
reader |
| 161 |
|
- 8: periodic: periodic info when pcscd test if a card is present (every |
| 162 |
|
1/10 of a second) |
| 163 |
|
|
| 164 |
|
By default the debug level is set to 3 (1 + 2) and correspond to the |
| 165 |
|
critical and info levels. |
| 166 |
|
|
| 167 |
|
You have to restart the driver so it read the configuration file again |
| 168 |
|
and use the new debug level value. To restart the driver you just need |
| 169 |
|
to unplug all your CCID readers so the the driver is unloaded and then |
| 170 |
|
replug your readers. You can also restart pcscd. |
| 171 |
|
|
| 172 |
|
|
| 173 |
Known problems: |
Known problems: |
| 174 |
=============== |
=============== |
| 175 |
|
|
| 176 |
All platforms |
MacOSX libusb |
| 177 |
T=1 and TPDU |
""""""""""""" |
| 178 |
"""""""""""" |
There is a bug in libusb that crash the libusb library when you |
| 179 |
I do not yet included support of T=1 cards when the reader is in |
unplug a reader and replug it in another USB socket. So if you |
| 180 |
TPDU mode. |
unplug a reader replug it in the same USB socket. |
| 181 |
If you have a T=1 card I recommand you to use a reader working in |
|
| 182 |
APDU mode. T=1 and TPDU will be supported in a future version of |
see http://sourceforge.net/tracker/index.php?func=detail&aid=886778&group_id=1674&atid=101674 |
|
the driver. |
|
|
|
|
|
readers enumeration |
|
|
""""""""""""""""""" |
|
|
You may have wrong reader identification if you connect two or |
|
|
more reader at the exact same time. |
|
|
|
|
|
The daemon pcscd and the CCID driver do not list connected readers |
|
|
in the same order. The driver has no way to know which reader has |
|
|
been detected as a new reader by pcscd. |
|
|
|
|
|
So if you plug two readers at the same time (for example if you |
|
|
start pcscd with two readers connected or if you plug a USB hub |
|
|
with two readers on the hub) you may have this (with two readers |
|
|
foo and bar): |
|
|
- pcscd scans the USB bus and finds a new CCID reader foo and |
|
|
calls the driver |
|
|
- the CCID driver scan the USB bus and finds a new different |
|
|
reader bar |
|
|
- pcscd continues scanning the USB bus and finds the second reader |
|
|
bar and calls the driver |
|
|
- the CCID driver scan the USB bus and finds an unused reader foo. |
|
|
|
|
|
Now the reader foo will be called bar by pcscd and bar will be |
|
|
called foo. This may not be a problem if the two readers have |
|
|
the same name. But it is strange to insert a card in the |
|
|
physical reader foo and see pcscd detect the card insertion in |
|
|
the reader he calls bar. |
|
|
|
|
|
The solution is to use IFDHCreateChannelByName() instead of |
|
|
IFDHCreateChannel() and specify the USB device to use. But pcscd |
|
|
does not implement IFDHCreateChannelByName() yet. Maybe in the |
|
|
future. |
|
|
|
|
|
Another solution is to plug readers one after the other and not |
|
|
at the same time. |
|
|
|
|
|
MacOS X/Darwin |
|
|
hotplug |
|
|
""""""" |
|
|
Due to libusb work in progress the driver may crash on a reader |
|
|
insertion after a few insert/remove actions. |
|
|
So if your reader is always connected you should not have |
|
|
problems. |
|
|
A new version of libusb should fix this bug |
|
|
|
|
|
*BSD |
|
|
libusb |
|
|
"""""" |
|
|
The libusb does not yet support USB interrupt endpoints. You will |
|
|
notice that the driver will stop working as soon as you insert a |
|
|
card in the reader. |
|
|
A new version of libusb should fix this bug. |
|
| 183 |
|
|
| 184 |
|
|
| 185 |
Licence: |
Licence: |
| 186 |
======== |
======== |
| 187 |
|
|
| 188 |
This program is free software; you can redistribute it and/or modify |
This library is free software; you can redistribute it and/or modify it |
| 189 |
it under the terms of the GNU General Public License as published by the |
under the terms of the GNU Lesser General Public License as published by |
| 190 |
Free Software Foundation; either version 2 of the License, or (at your |
the Free Software Foundation; either version 2.1 of the License, or (at |
| 191 |
option) any later version. |
your option) any later version. |
| 192 |
|
|
| 193 |
This program is distributed in the hope that it will be useful, but |
This library is distributed in the hope that it will be useful, but |
| 194 |
WITHOUT ANY WARRANTY; without even the implied warranty of |
WITHOUT ANY WARRANTY; without even the implied warranty of |
| 195 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser |
| 196 |
General Public License for more details. |
General Public License for more details. |
| 197 |
|
|
| 198 |
You should have received a copy of the GNU General Public License |
You should have received a copy of the GNU Lesser General Public License |
| 199 |
along with this program; if not, write to the Free Software Foundation, |
along with this library; if not, write to the Free Software Foundation, |
| 200 |
Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 201 |
|
|
| 202 |
|
|
| 203 |
History: |
History: |
| 204 |
======== |
======== |
| 205 |
|
|
| 206 |
|
1.2.1 - 27 January 2007, Ludovic Rousseau |
| 207 |
|
- pcscd_ccid.rules: add non CCID generic (InterfaceClass: 0xFF) |
| 208 |
|
readers |
| 209 |
|
- INSTALL: document how to use --enable-udev on FreeBSD |
| 210 |
|
- move the O2Micro Oz7762 from the unsupported to the supported list |
| 211 |
|
since patches to support it are applied by default |
| 212 |
|
(O2MICRO_OZ776_PATCH) |
| 213 |
|
|
| 214 |
|
|
| 215 |
|
1.2.0 - 19 January 2007, Ludovic Rousseau |
| 216 |
|
- add support for SCARD_ATTR_VENDOR_IFD_VERSION, |
| 217 |
|
SCARD_ATTR_VENDOR_NAME and SCARD_ATTR_MAXINPUT tags used by |
| 218 |
|
SCardGetAttrib(). Read SCARDGETATTRIB.txt for more documentation |
| 219 |
|
- add support for OmniKey CardMan 5125, CardMan 1021, C3PO LTC32, |
| 220 |
|
Teo by Xiring, HP USB Smartcard Reader |
| 221 |
|
- use --enable-twinserial to build the serial reader driver |
| 222 |
|
- use --enable-udev to configure for a use with Linux udev hotplug |
| 223 |
|
mechanism. This will allow pcscd to avoid polling the USB bus |
| 224 |
|
every 1 second |
| 225 |
|
- some minor bugs removed |
| 226 |
|
|
| 227 |
|
|
| 228 |
|
1.1.0 - 11 August 2006, Ludovic Rousseau |
| 229 |
|
- support Extended APDU (up to 64KB) for readers in TPDU mode (many |
| 230 |
|
readers) or Extended APDU mode (very rare). This only works for |
| 231 |
|
T=1 cards. |
| 232 |
|
- add support for C3PO LTC31 (new version), OmniKey CardMan 3021, HP |
| 233 |
|
USB Smart Card Keyboard, Actividentity (ActiveCard) Activkey Sim, |
| 234 |
|
id3 Semiconductors CL1356D and CL1356T, Alcor Micro AU9520 |
| 235 |
|
- support the contactless interface of the SCR331-DI-NTTCOM |
| 236 |
|
- add support of FreeBSD |
| 237 |
|
- increase the USB timeout used for PIN verify/modify to not timeout |
| 238 |
|
before the reader |
| 239 |
|
- the 4-bytes value returned by CM_IOCTL_GET_FEATURE_REQUEST shall |
| 240 |
|
be encoded in big endian as documented in PCSC v2 part 10 ch 2.2 |
| 241 |
|
page 2. The applications using this feature shall be updated (to |
| 242 |
|
respect the PCSC specification). |
| 243 |
|
- use ./configure --enable-twinserial to compile and install the the |
| 244 |
|
driver for the GemPC Twin serial |
| 245 |
|
- some minor bugs removed |
| 246 |
|
|
| 247 |
|
|
| 248 |
|
1.0.1 - 22 April 2006, Ludovic Rousseau |
| 249 |
|
- add support for Axalto Reflex USB v3, SCM Micro SDI 010, Winbond |
| 250 |
|
Electronics W81E381 chipset, Gemplus GemPC Card, Athena ASE IIIe |
| 251 |
|
KB USB, OmniKey CardMan 3621 |
| 252 |
|
- support Solaris (Solaris uses a different libusb) |
| 253 |
|
- better documentation for ./configure arguments |
| 254 |
|
- improve support of Cherry XX44 keyboard for PIN verify and change |
| 255 |
|
(circumvent firmware bugs) |
| 256 |
|
- do not use LTPBundleFindValueWithKey() from pcscd since this |
| 257 |
|
function has been removed from pcscd API |
| 258 |
|
- use -fvisibility=hidden is available to limit the number of |
| 259 |
|
exported symbols |
| 260 |
|
|
| 261 |
|
|
| 262 |
|
1.0.0 - 3 March 2006, Ludovic Rousseau |
| 263 |
|
- add support for ActivCard USB Reader 3.0, Athena ASE IIIe USB V2, |
| 264 |
|
SCM Micro SCR 355, SCR 3311, SCR 3320, SCR 3340 ExpressCard54, |
| 265 |
|
Gemplus GemCore SIM Pro, GemCore POS Pro (serial and USB), GemPC |
| 266 |
|
Express (ExpressCard/54 interface), SmartEpad (v 2.0), OmniKey |
| 267 |
|
CardMan 5121 |
| 268 |
|
- greatly improve support of PIN PAD readers. We now support TPDU |
| 269 |
|
readers with T=1 cards |
| 270 |
|
- use l10n strings for the Gemplus GemPC PIN PAD (it has a screen). |
| 271 |
|
Supported languages are: de, en, es, fr, it |
| 272 |
|
- rename ACS ACR 38 in ACR 38U-CCID since the ACR 38 is a different |
| 273 |
|
reader and is not CCID compatible |
| 274 |
|
- allow to select the Power On voltage using Info.plist instead of |
| 275 |
|
recompiling the source code |
| 276 |
|
- correct bugs in the support of multi-slots readers |
| 277 |
|
- if the card is faster than the reader (TA1=97 for example) we try |
| 278 |
|
to use a not-so-bad speed (corresponding to TA1=96, 95 or 94) |
| 279 |
|
instead of the default speed of TA1=11 |
| 280 |
|
- the src/parse tool do not use the driver anymore. No need to |
| 281 |
|
update the Info.plist file first. |
| 282 |
|
- some minor bugs removed |
| 283 |
|
|
| 284 |
|
|
| 285 |
|
0.9.4 - 27 November 2005, Ludovic Rousseau |
| 286 |
|
- add support for Eutron SIM Pocket Combo, Eutron CryptoIdentity, |
| 287 |
|
Verisign Secure Token and VeriSign Secure Storage Token, GemPC |
| 288 |
|
Card (PCMCIA), SCM SCR331-DI NTTCom, SCM Micro SCR 3310-NTTCom, |
| 289 |
|
Cherry ST-1044U, Cherry SmartTerminal ST-2XXX |
| 290 |
|
- add support of PC/SC v2 part 10 CM_IOCTL_GET_FEATURE_REQUEST add |
| 291 |
|
support of FEATURE_VERIFY_PIN_DIRECT and FEATURE_MODIFY_PIN_DIRECT |
| 292 |
|
remove support of IOCTL_SMARTCARD_VENDOR_VERIFY_PIN (now |
| 293 |
|
obsoleted). A sample code is available in examples/scardcontrol.c |
| 294 |
|
- we need pcsc-lite 1.2.9-beta9 since some structures used for PIN |
| 295 |
|
pad readers are defined by pcsc-lite |
| 296 |
|
- some (bogus) cards require an extra EGT but the ATR does not say |
| 297 |
|
so. We try to detect the bogus cards and set TC1=2 |
| 298 |
|
- IFDHSetProtocolParameters(): only use a data rate supported by the |
| 299 |
|
reader in the PPS negociation, otherwise we stay at the default |
| 300 |
|
speed. |
| 301 |
|
- calculate and store the read timeout according to the card ATR |
| 302 |
|
instead of using a fixed value of 60 seconds |
| 303 |
|
- increase the read timeout if the card sends and WTX request |
| 304 |
|
- improve support of GemPC Twin and GemPC Card (serial protocol) |
| 305 |
|
- reset the device on close only if DRIVER_OPTION_RESET_ON_CLOSE is |
| 306 |
|
set. The problem was that a device reset also disconnects the |
| 307 |
|
keyboard on a keyboard + reader device. |
| 308 |
|
- use color logs |
| 309 |
|
- some minor bugs removed |
| 310 |
|
|
| 311 |
|
|
| 312 |
|
0.9.3 - 14 March 2005, Ludovic Rousseau |
| 313 |
|
- change the licence from GNU GPL to GNU Lesser GPL (LGPL) |
| 314 |
|
- add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced, |
| 315 |
|
Kobil KAAN SIM III, Kobil KAAN mIDentity, SCM Micro SCR 331, |
| 316 |
|
SCM Micro SCR 331-DI, SCM Micro SCR 335, SCM Micro SCR 3310, |
| 317 |
|
SCM Micro SCR 532, Cherry XX44 readers |
| 318 |
|
- improve communication speed with readers featuring "Automatic PPS |
| 319 |
|
made by the CCID" |
| 320 |
|
- switch the Cherry xx33 reader in ISO mode if power up in EMV mode |
| 321 |
|
fails. |
| 322 |
|
- add support of character level readers. Thanks to O2Micro for the |
| 323 |
|
patch |
| 324 |
|
- add support for the O2Micro OZ776S reader but the reader firmware |
| 325 |
|
is still bogus |
| 326 |
|
- check firmware version to avoid firmwares with bugs. You can still |
| 327 |
|
use a bogus firmware by setting DRIVER_OPTION_USE_BOGUS_FIRMWARE |
| 328 |
|
in Info.plist |
| 329 |
|
- some minor bugs removed |
| 330 |
|
|
| 331 |
|
0.9.2 - 15 August 2004, Ludovic Rousseau |
| 332 |
|
- T=1 TPDU code: |
| 333 |
|
. the work on T=1 TPDU code was possible thanks to Gemplus |
| 334 |
|
validation team who helped me test, debug and bring the code to |
| 335 |
|
an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and |
| 336 |
|
the Gemplus readers department |
| 337 |
|
. error code was not checked correctly |
| 338 |
|
. avoid a (nearly) infinite loop when resynch are needed. |
| 339 |
|
. correctly initialise an internal value to allow more than one |
| 340 |
|
reader to work |
| 341 |
|
- multi-slots readers |
| 342 |
|
. add support for multi-slots readers. The only one I have is a |
| 343 |
|
SCM Micro SCR 331-DI with a contact and a contactless interface. |
| 344 |
|
The contactless interface may or may not work for you since the |
| 345 |
|
reader uses proprietary (undocumented) commands. |
| 346 |
|
- GemPC Twin serial reader |
| 347 |
|
. perform a command (get the reader firmware) to be sure a GemPC |
| 348 |
|
Twin (serial or pcmcia) reader is connected |
| 349 |
|
. use a dynamic timeout when reading the serial port. |
| 350 |
|
The first timeout used when detecting the reader is 2 seconds to |
| 351 |
|
not wait too long if no reader is connected. Later timeouts are |
| 352 |
|
set to 1 minute to allow long time APDU. |
| 353 |
|
- use `pkg-config libpcsclite --cflags` to locate the pcsc-lite |
| 354 |
|
header files |
| 355 |
|
- use `pkg-config --print-errors --atleast-version=1.2.9-beta5 libpcsclite` |
| 356 |
|
to test the pcsc-lite version |
| 357 |
|
- code improvements thanks to the splint tool (http://www.splint.org/) |
| 358 |
|
|
| 359 |
|
0.9.1 - 1 July 2004, Ludovic Rousseau |
| 360 |
|
- I forgot to define IFD_PARITY_ERROR in a .h file |
| 361 |
|
|
| 362 |
|
0.9.0 - 1 July 2004, Ludovic Rousseau |
| 363 |
|
- The T=1 TPDU automata from Carlos Prados' Towitoko driver is very |
| 364 |
|
limited and do not support error management mechanisms. |
| 365 |
|
I then used the T=1 TPDU automata from OpenCT (OpenSC project). |
| 366 |
|
This automata is much more powerful but still lacks a lot of error |
| 367 |
|
management code. |
| 368 |
|
I then added all the needed code to reach the quality level |
| 369 |
|
requested by the EMV standard. |
| 370 |
|
- add support for new readers: |
| 371 |
|
. Advanced Card Systems ACR 38 |
| 372 |
|
. Cherry XX33 |
| 373 |
|
. Dell keyboard SK-3106 |
| 374 |
|
. Dell smart card reader keyboard |
| 375 |
|
. SCR 333 |
| 376 |
|
- add support of multi procotol cards (T=0 and T=1) |
| 377 |
|
- the debug level is now dynamic and set in the Info.plist file (no |
| 378 |
|
need to recompile the driver any more) |
| 379 |
|
- add support for the libusb naming scheme: usb:%04x/%04x:libusb:%s |
| 380 |
|
- INSTALL: add a "configuring the driver for the serial reader |
| 381 |
|
(GemPC Twin)" part |
| 382 |
|
- use `pkg-config libpcsclite --variable=usbdropdir` so you do not |
| 383 |
|
have to use --enable-usbdropdir=DIR or --enable-ccidtwindir=DIR |
| 384 |
|
even if pcscd does not use the default /usr/local/pcsc/drivers |
| 385 |
|
- add support of IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and |
| 386 |
|
IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in IFDHControl() |
| 387 |
|
- read ifdDriverOptions from Info.plist to limit the use of |
| 388 |
|
IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE (idea from Peter Williams) |
| 389 |
|
- provide an example of use of SCardControl() |
| 390 |
|
IOCTL_SMARTCARD_VENDOR_IFD_EXCHANGE and |
| 391 |
|
IOCTL_SMARTCARD_VENDOR_VERIFY_PIN in example/ |
| 392 |
|
- add a --enable-pcsclite option (default to yes) so that the driver |
| 393 |
|
can be compiled for a different framework (one needing |
| 394 |
|
tokenparser.l like Solaris) |
| 395 |
|
- Reset action is power off and power on, not just power on |
| 396 |
|
- use the include files from pcsc-lite |
| 397 |
|
- add a mechanism to allow power on at 1.8V, 3V and then 5V as |
| 398 |
|
specified by ISO 7816. We still use 5V for now to avoid problems |
| 399 |
|
with non ISO compliant cards |
| 400 |
|
|
| 401 |
|
0.4.1 - 14 February 2004, Ludovic Rousseau |
| 402 |
|
- distribute missing files readers/supported_readers.txt and |
| 403 |
|
src/create_Info_plist.pl |
| 404 |
|
'make install' failed because of this. |
| 405 |
|
|
| 406 |
|
0.4.0 - 13 February 2004, Ludovic Rousseau |
| 407 |
|
- support of T=1 with TPDU readers. A lot of the T=1 code comes from |
| 408 |
|
Carlos Prados towitoko driver. |
| 409 |
|
My code is GNU GPL, his code is GNU LGPL so the global driver is |
| 410 |
|
GNU GPL |
| 411 |
|
- PPS negotiation if the reader does not do it automatically |
| 412 |
|
- add support for the Silitek SK-3105 keyboard. It's a USB device |
| 413 |
|
with multiple interfaces |
| 414 |
|
- use the create_Info_plist.pl script to generate the installed |
| 415 |
|
Info.plist from an Info.plist template and a list of supported |
| 416 |
|
readers. The Info.plist was too "complex" to maintain by hand |
| 417 |
|
since it now contains 11 entries |
| 418 |
|
- add support of IFDHCreateChannelByName to avoid wrong reader |
| 419 |
|
enumeration. This is not complete if you have multiple _identical_ |
| 420 |
|
readers. You need to use a > 1.2.0 pcsc-lite version (not yet |
| 421 |
|
released at that time) |
| 422 |
|
- build but do not install the serial ccidtwin driver by default |
| 423 |
|
since it is useless on computers without a serial port or without |
| 424 |
|
this reader for example. |
| 425 |
|
- read and write timeouts are not symmetric. write timout can be |
| 426 |
|
shorter since the reader and card is not supposed to do anything |
| 427 |
|
before receiving (write) a command |
| 428 |
|
- do not try to find usb.h and other libusb files if |
| 429 |
|
--disable-libusb is used. Needed if you only want to build the |
| 430 |
|
serial driver. Thanks to Niki Waibel for the patch |
| 431 |
|
- add a --enable-ccidtwindir argument to ./configure to specify the |
| 432 |
|
serial GemPC Twin installation directory |
| 433 |
|
- debug and code improvements and simplifications |
| 434 |
|
|
| 435 |
|
0.3.2 - 4 November 2003, Ludovic Rousseau |
| 436 |
|
- src/commands.c: correct a stupid bug that occurs with an APDU with |
| 437 |
|
2 bytes response. |
| 438 |
|
- Info.plist: add SPR 532 in list of supported readers |
| 439 |
|
- parse.c: do not exit if the InterfaceClass is 0xFF (proprietary). |
| 440 |
|
It is the case with old readers manufactured before the final |
| 441 |
|
release of the CCID specs. |
| 442 |
|
- move LTC31 reader from unsupported to supported reader list. It |
| 443 |
|
was my f ault since in used odd INS byte in my test applet and odd |
| 444 |
|
INS bytes are forbidden by ISO 7816-4 ch. 5.4.2 Instruction byte. |
| 445 |
|
Thanks to Josep Moné s Teixidor for pointing the problem. |
| 446 |
|
- src/commands.c: comment out the automatic GET RESPONSE part. I |
| 447 |
|
don't think it should be in the driver. Maybe in pcscd instead? |
| 448 |
|
|
| 449 |
0.3.1 - 23 September 2003, Ludovic Rouseau |
0.3.1 - 23 September 2003, Ludovic Rouseau |
| 450 |
- add --enable-multi-thread (enabled by default) for thread safe |
- add --enable-multi-thread (enabled by default) for thread safe |
| 451 |
support an APDU multiplexing. You will need pcsc-lite-1.2.0-rc3 or |
support an APDU multiplexing. You will need pcsc-lite-1.2.0-rc3 or |
| 453 |
- add --enable-libusb=PATH option is your libusb is not installed in |
- add --enable-libusb=PATH option is your libusb is not installed in |
| 454 |
/usr or /usr/local |
/usr or /usr/local |
| 455 |
- honor DESTDIR in install rules (closes [ #300110 ]). Thanks to |
- honor DESTDIR in install rules (closes [ #300110 ]). Thanks to |
| 456 |
Ville Skyttä for the patch. |
Ville Skyttä for the patch. |
| 457 |
- src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU |
- src/ccid.c: do not switch the GemPC Key and GemPC Twin in APDU |
| 458 |
mode since it also swicth in EMV mode and may not work with non |
mode since it also swicth in EMV mode and may not work with non |
| 459 |
EMV cards |
EMV cards |
| 483 |
- First public release |
- First public release |
| 484 |
|
|
| 485 |
|
|
| 486 |
Bibliography: |
References: |
| 487 |
============= |
=========== |
| 488 |
|
|
| 489 |
[1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf |
[1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf |
| 490 |
[2] http://www.gemplus.com/products/gempc433/ |
[2] http://www.gemplus.com/products/gempc433/ |
| 491 |
[3] http://www.gemplus.com/products/gempckey/ |
[3] http://www.gemplus.com/products/gempckey/ |
| 492 |
[4] http://www.gemplus.com/products/gempctwin/ |
[4] http://www.gemplus.com/products/gempctwin/ |
| 493 |
[5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47 |
[5] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=21 |
| 494 |
[6] http://www.scmmicro.com/security/SCR331.html |
[6] http://www.scmmicro.com/security/SCR331.html |
| 495 |
[7] http://www.scmmicro.com/security/SCR335.html |
[7] http://www.scmmicro.com/security/SCR335.html |
| 496 |
[8] http://www.c3po.es/pcsc.htm |
[8] http://www.c3po.es/ltc31.html |
| 497 |
|
[9] http://www.scmmicro.com/security/SPR532.html |
| 498 |
|
[10] http://www.activcard.com/products/usb_reader.html |
| 499 |
|
[11] http://www.scmmicro.com/security/SCR331-DI.html |
| 500 |
|
[12] http://www.silitek.com/prod/getProduct.do?xml_id=4_2&menu_id=4_2_8&cid=1_8_5 |
| 501 |
|
[13] http://www.c3po.es/ltc32.html |
| 502 |
|
[14] http://www.c3po.es/tltc2usb.html |
| 503 |
|
[15] http://www.scmmicro.com/security/SCR333.html |
| 504 |
|
[16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers |
| 505 |
|
[17] http://www.scmmicro.com/support/pcs_product_drivers.html |
| 506 |
|
[18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm |
| 507 |
|
[19] http://www.kobil.com/e/products/smartcard/kaan-base.php |
| 508 |
|
[20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php |
| 509 |
|
[21] http://www.kobil.com/d/products/smartcard/kaansim3.php |
| 510 |
|
[22] http://www.kobil.com/e/products/index.php?s=midentity |
| 511 |
|
[23] http://www.ntt.com/jpki/SCR331DI.html |
| 512 |
|
[24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/ |
| 513 |
|
[25] http://www.eutron.com/simpocket.asp |
| 514 |
|
[26] http://www.cryptoidentity.eutron.com/eng/home.asp |
| 515 |
|
[27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm |
| 516 |
|
[28] http://www.ntt.com/jpki/scr3310.html |
| 517 |
|
[29] http://www.asedrive.com/product.asp?pid=1 |
| 518 |
|
[30] http://www.scmmicro.com/security/SCR3310.html |
| 519 |
|
[31] http://scmmicro.com/security/SCR3311.html |
| 520 |
|
[31] http://scmmicro.com/security/SCR3320.html |
| 521 |
|
[32] http://www.smartepad.com.br/ |
| 522 |
|
[33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37 |
| 523 |
|
[34] http://www.scmmicro.com/security/SCR3340.html |
| 524 |
|
[35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm |
| 525 |
|
[36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29 |
| 526 |
|
[37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33 |
| 527 |
|
[38] http://www.reflexreaders.com/Products/reflex_usbnew.html |
| 528 |
|
[39] http://www.scmmicro.com/security/SDI_010.html |
| 529 |
|
[40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm |
| 530 |
|
[41] http://www.gemplus.com/products/gempc_card/ |
| 531 |
|
[42] http://www.asedrive.com/product.asp?pid=2 |
| 532 |
|
[43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31 |
| 533 |
|
[44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML |
| 534 |
|
[45] http://www.id3semiconductors.com/produits/cl1356D.htm |
| 535 |
|
[46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21 |
| 536 |
|
[47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1 |
| 537 |
|
[48] http://www.id3semiconductors.com/produits/cl1356T.htm |
| 538 |
|
[49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48 |
| 539 |
|
[50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf |
| 540 |
|
[51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39 |
| 541 |
|
[52] http://www.teobyxiring.com/ |
| 542 |
|
[53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html |
| 543 |
|
[54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html |
| 544 |
|
|
| 545 |
$Id$ |
$Id$ |
| 546 |
|
|
Parent Directory
| 
Revision Log
| 
Patch