Contents of /trunk/Drivers/ccid/README

USB CCID IFD Handler
====================

  This package provides the source code for a generic USB CCID
(Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID
specifications from the USB working group.


Author:
=======

- Ludovic Rousseau <ludovic.rousseau@free.fr>


Supported CCID readers:
=======================

(in alphabetical order)
- Gemplus GemPC 433 SL [2]
- Gemplus GemPC Key [3]
- Gemplus GemPC Twin [4]
- OmniKey CardMan 3121 [5]
- SCM Micro SCR 331 [6]
- SCM Micro SCR 335 [7]


Unsupported CCID readers:
=========================

- none known


Supported operating systems:
============================

- GNU/Linux (libusb 0.1.7)
- MacOS X/Darwin (libusb 0.1.8beta, CVS snapshot. See "Known problems")
  to libusb)


Known problems:
===============

MacOS X/Darwin
    readers enumeration

      You may have wrong reader identification if you two or more reader
      at the exact same time.
      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 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.
      We don't have this under Linux or *BSD since the USB bus scanning
      method is the same for pcscd and the CCID driver.
      One solution would be to use IFDHCreateChannelByName() instead of
      IFDHCreateChannel() and specify the USB device to use.
      Another solution is to plug readers one after the other and not at
      the same time.

    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


Licence:
========

  This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

  This program 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
General Public License for more details.

  You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software Foundation,
Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA


History:
========

0.1.0 - 13 August 2003, Ludovic Rousseau
    - First public release


Bibliographie:
==============

[1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
[2] http://www.gemplus.com/products/gempc433/
[3] http://www.gemplus.com/products/gempckey/
[4] http://www.gemplus.com/products/gempctwin/
[5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47
[6] http://www.scmmicro.com/security/SCR331.html
[7] http://www.scmmicro.com/security/SCR335.html

$Id$

 vim:ts=20
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			MacOS X/Darwin
45			readers enumeration
46
47			You may have wrong reader identification if you two or more reader
48			at the exact same time.
49			pcscd and the CCID driver do not list connected readers in the same
50			order. The driver has no way to know which reader has been
51			detected as a new reader by pcscd. So if you plug two readers at
52			the same time (for example if you start pcscd with two readers
53			connected or if you plug a USB hub with two readers on the hub)
54			you may have this (with two readers foo and bar):
55			- pcscd scans the USB bus and finds a new CCID reader foo and calls
56			the driver
57			- the CCID driver scan the USB bus and finds a new reader bar
58			- pcscd continues scanning the USB bus and finds the second reader
59			bar and calls the driver
60			- the CCID driver scan the USB bus and finds an unused reader foo.
61			Now the reader foo will be called bar by pcscd and bar will be
62			called foo.
63			We don't have this under Linux or *BSD since the USB bus scanning
64			method is the same for pcscd and the CCID driver.
65			One solution would be to use IFDHCreateChannelByName() instead of
66			IFDHCreateChannel() and specify the USB device to use.
67			Another solution is to plug readers one after the other and not at
68			the same time.
69
70			hotplug
71
72			Due to libusb work in progress the driver may crash on a reader
73			insertion after a few insert/remove actions.
74			So if your reader is always connected you should not have
75			problems.
76			A new version of libusb should fix this bug
77
78
79	rousseau	273	Licence:
80			========
81
82	rousseau	269	This program is free software; you can redistribute it and/or modify
83			it under the terms of the GNU General Public License as published by the
84			Free Software Foundation; either version 2 of the License, or (at your
85			option) any later version.
86
87			This program is distributed in the hope that it will be useful, but
88			WITHOUT ANY WARRANTY; without even the implied warranty of
89			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
90			General Public License for more details.
91
92			You should have received a copy of the GNU General Public License
93			along with this program; if not, write to the Free Software Foundation,
94			Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
95
96
97			History:
98			========
99
100	rousseau	273	0.1.0 - 13 August 2003, Ludovic Rousseau
101			- First public release
102	rousseau	269
103
104			Bibliographie:
105			==============
106
107			[1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
108	rousseau	273	[2] http://www.gemplus.com/products/gempc433/
109			[3] http://www.gemplus.com/products/gempckey/
110	rousseau	269	[4] http://www.gemplus.com/products/gempctwin/
111	rousseau	273	[5] http://www.omnikey.com/en/produkt_details.php3?produkt=1&variante=47
112			[6] http://www.scmmicro.com/security/SCR331.html
113			[7] http://www.scmmicro.com/security/SCR335.html
114	rousseau	269
115			$Id$
116
117			vim:ts=20
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision