| 1 |
rousseau |
269 |
USB CCID IFD Handler |
| 2 |
|
|
==================== |
| 3 |
|
|
|
| 4 |
|
|
This package provides the source code for a generic USB CCID |
| 5 |
|
|
(Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID |
| 6 |
rousseau |
273 |
specifications from the USB working group. |
| 7 |
rousseau |
269 |
|
| 8 |
|
|
|
| 9 |
|
|
Author: |
| 10 |
|
|
======= |
| 11 |
|
|
|
| 12 |
|
|
- Ludovic Rousseau <ludovic.rousseau@free.fr> |
| 13 |
|
|
|
| 14 |
|
|
|
| 15 |
|
|
Supported CCID readers: |
| 16 |
|
|
======================= |
| 17 |
|
|
|
| 18 |
rousseau |
273 |
(in alphabetical order) |
| 19 |
|
|
- Gemplus GemPC 433 SL [2] |
| 20 |
|
|
- Gemplus GemPC Key [3] |
| 21 |
|
|
- Gemplus GemPC Twin [4] |
| 22 |
|
|
- OmniKey CardMan 3121 [5] |
| 23 |
|
|
- SCM Micro SCR 331 [6] |
| 24 |
|
|
- SCM Micro SCR 335 [7] |
| 25 |
rousseau |
269 |
|
| 26 |
|
|
|
| 27 |
|
|
Unsupported CCID readers: |
| 28 |
|
|
========================= |
| 29 |
|
|
|
| 30 |
|
|
- none known |
| 31 |
|
|
|
| 32 |
|
|
|
| 33 |
rousseau |
321 |
Supported operating systems: |
| 34 |
|
|
============================ |
| 35 |
|
|
|
| 36 |
|
|
- GNU/Linux (libusb 0.1.7) |
| 37 |
|
|
- MacOS X/Darwin (libusb 0.1.8beta, CVS snapshot. See "Known problems") |
| 38 |
|
|
to libusb) |
| 39 |
|
|
|
| 40 |
|
|
|
| 41 |
|
|
Known problems: |
| 42 |
|
|
=============== |
| 43 |
|
|
|
| 44 |
rousseau |
326 |
All platforms |
| 45 |
rousseau |
321 |
readers enumeration |
| 46 |
rousseau |
326 |
""""""""""""""""""" |
| 47 |
|
|
You may have wrong reader identification if you connect two or |
| 48 |
|
|
more reader at the exact same time. |
| 49 |
rousseau |
321 |
|
| 50 |
rousseau |
326 |
The daemon pcscd and the CCID driver do not list connected readers |
| 51 |
|
|
in the same order. The driver has no way to know which reader has |
| 52 |
|
|
been detected as a new reader by pcscd. |
| 53 |
|
|
|
| 54 |
|
|
So if you plug two readers at the same time (for example if you |
| 55 |
|
|
start pcscd with two readers connected or if you plug a USB hub |
| 56 |
|
|
with two readers on the hub) you may have this (with two readers |
| 57 |
|
|
foo and bar): |
| 58 |
|
|
- pcscd scans the USB bus and finds a new CCID reader foo and |
| 59 |
|
|
calls the driver |
| 60 |
|
|
- the CCID driver scan the USB bus and finds a new different |
| 61 |
|
|
reader bar |
| 62 |
rousseau |
321 |
- pcscd continues scanning the USB bus and finds the second reader |
| 63 |
|
|
bar and calls the driver |
| 64 |
|
|
- the CCID driver scan the USB bus and finds an unused reader foo. |
| 65 |
|
|
|
| 66 |
rousseau |
326 |
Now the reader foo will be called bar by pcscd and bar will be |
| 67 |
|
|
called foo. This may not be a problem if the two readers have |
| 68 |
|
|
the same name. But it is strange to insert a card in the |
| 69 |
|
|
physical reader foo and see pcscd detect the card insertion in |
| 70 |
|
|
the reader he calls bar. |
| 71 |
|
|
|
| 72 |
|
|
The solution is to use IFDHCreateChannelByName() instead of |
| 73 |
|
|
IFDHCreateChannel() and specify the USB device to use. But pcscd |
| 74 |
|
|
does not implement IFDHCreateChannelByName() yet. Maybe in the |
| 75 |
|
|
future. |
| 76 |
|
|
|
| 77 |
|
|
Another solution is to plug readers one after the other and not |
| 78 |
|
|
at the same time. |
| 79 |
|
|
|
| 80 |
|
|
MacOS X/Darwin |
| 81 |
rousseau |
321 |
hotplug |
| 82 |
rousseau |
326 |
""""""" |
| 83 |
rousseau |
321 |
Due to libusb work in progress the driver may crash on a reader |
| 84 |
|
|
insertion after a few insert/remove actions. |
| 85 |
|
|
So if your reader is always connected you should not have |
| 86 |
|
|
problems. |
| 87 |
rousseau |
340 |
A new version of libusb should fix this bug. |
| 88 |
rousseau |
321 |
|
| 89 |
rousseau |
340 |
*BSD |
| 90 |
|
|
libusb |
| 91 |
|
|
"""""" |
| 92 |
|
|
The libusb does not yet support USB interrupt endpoints. You will |
| 93 |
|
|
notice that the driver will stop working as soon as you insert a |
| 94 |
|
|
card in the reader. |
| 95 |
|
|
A new version of libusb should fix this bug. |
| 96 |
rousseau |
321 |
|
| 97 |
rousseau |
340 |
|
| 98 |
rousseau |
273 |
Licence: |
| 99 |
|
|
======== |
| 100 |
|
|
|
| 101 |
rousseau |
269 |
This program is free software; you can redistribute it and/or modify |
| 102 |
|
|
it under the terms of the GNU General Public License as published by the |
| 103 |
|
|
Free Software Foundation; either version 2 of the License, or (at your |
| 104 |
|
|
option) any later version. |
| 105 |
|
|
|
| 106 |
|
|
This program is distributed in the hope that it will be useful, but |
| 107 |
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of |
| 108 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 109 |
|
|
General Public License for more details. |
| 110 |
|
|
|
| 111 |
|
|
You should have received a copy of the GNU General Public License |
| 112 |
|
|
along with this program; if not, write to the Free Software Foundation, |
| 113 |
|
|
Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 114 |
|
|
|
| 115 |
|
|
|
| 116 |
|
|
History: |
| 117 |
|
|
======== |
| 118 |
|
|
|
| 119 |
rousseau |
273 |
0.1.0 - 13 August 2003, Ludovic Rousseau |
| 120 |
|
|
- First public release |
| 121 |
rousseau |
269 |
|
| 122 |
|
|
|
| 123 |
|
|
Bibliographie: |
| 124 |
|
|
============== |
| 125 |
|
|
|
| 126 |
|
|
[1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf |
| 127 |
rousseau |
273 |
[2] http://www.gemplus.com/products/gempc433/ |
| 128 |
|
|
[3] http://www.gemplus.com/products/gempckey/ |
| 129 |
rousseau |
269 |
[4] http://www.gemplus.com/products/gempctwin/ |
| 130 |
rousseau |
273 |
[5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47 |
| 131 |
|
|
[6] http://www.scmmicro.com/security/SCR331.html |
| 132 |
|
|
[7] http://www.scmmicro.com/security/SCR335.html |
| 133 |
rousseau |
269 |
|
| 134 |
|
|
$Id$ |
| 135 |
|
|
|
| 136 |
|
|
vim:ts=20 |
Parent Directory
| 
Revision Log