/[pcsclite]/trunk/Drivers/ccid/README
ViewVC logotype

Diff of /trunk/Drivers/ccid/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1015 by rousseau, Thu Jul 1 07:46:28 2004 UTC revision 1400 by rousseau, Mon Mar 14 19:36:21 2005 UTC
# Line 20  Supported CCID readers: Line 20  Supported CCID readers:
20  =======================  =======================
21    
22  (in alphabetical order)  (in alphabetical order)
23    - Advanced Card Systems ACR 38 [16]
24      old versions of this reader have a bug: the reader do timeout when a
25      special USB frame is sent from the reader. If the frame size if a
26      multiple of wMaxPacketSize the communication is stopped.
27  - Cherry XX33 keyboard [?]  - Cherry XX33 keyboard [?]
28  - Dell keyboard SK-3106 [?]  - Dell keyboard SK-3106 [?]
29  - Dell smart card reader keyboard [?]  - Dell smart card reader keyboard [?]
30  - Gemplus GemPC 433 SL [2]  - Gemplus GemPC 433 SL [2]
31  - Gemplus GemPC Key [3]  - Gemplus GemPC Key [3]
32  - Gemplus GemPC Twin [4]  - Gemplus GemPC Twin [4]
33    - Kobil KAAN Base [19]
34    - Kobil KAAN Advanced [20]
35    - Kobil KAAN SIM III [21]
36    - Kobil KAAN mIDentity [22]
37  - OmniKey CardMan 3121 [5]  - OmniKey CardMan 3121 [5]
38    - SCM Micro SCR 331 [6]
39      You shall upgrade the firmware [17] using version 5.18 or later.
40    - SCM Micro SCR 331-DI [11]
41      You shall upgrade the firmware [17] using version 6.22 or later.
42    - SCM Micro SCR 335 [7]
43      The firmware of this reader can't be upgraded so be sure to buy a
44      recent model with firmware 5.14 or later
45    - SCM Micro SCR 3310
46    - SCM Micro SPR 532 [9]
47      You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a
48      firmware upgrade.
49    
50    
51  Should work but untested by me:  Should work but untested by me:
# Line 36  I would like to get these readers to per Line 55  I would like to get these readers to per
55  move them in the supported list above. If you are one of the  move them in the supported list above. If you are one of the
56  manufacturers, please, contact me.  manufacturers, please, contact me.
57    
58    - Cherry XX44 keyboard (SmartBoard G83-6744) [18]
59  - ActivCard USB reader 2.0 [10]  - ActivCard USB reader 2.0 [10]
60  - C3PO LTC32 [13]  - C3PO LTC32 [13]
 - SCM Micro SCR 331-DI [11]  
61  - SCM Micro SCR 333 [15]  - SCM Micro SCR 333 [15]
62  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]
63    
# Line 46  manufacturers, please, contact me. Line 65  manufacturers, please, contact me.
65  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
66  =============================================  =============================================
67    
68  - Advanced Card Systems ACR 38 [16] (see Known problems n°1)  - C3PO LTC31 [8]
69  - C3PO LTC31 [8] (see Known problems n°2)      The reader works fine with Linux kernel 2.4 but does not with Linux
70  - SCM Micro SCR 335 [7] (see Known problems n°1)      kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)
 - SCM Micro SCR 331 [6] (see Known problems n°1)  
 - SCM Micro SPR 532 [9] (see Known problems n°1)  
71    
72    
73  Supported operating systems:  Supported operating systems:
# Line 94  replug your readers. You can also restar Line 111  replug your readers. You can also restar
111  Known problems:  Known problems:
112  ===============  ===============
113    
114  1. USB timeout  MacOSX libusb
 """"""""""""""  
     Some readers do timeout when a special USB frame is sent from the  
     reader. If the frame size if a multiple of wMaxPacketSize the  
     communication is stopped. You should contact the reader vendor to  
     upgrade the firmware of the reader or replace the reader.  
   
 2. Kernel 2.6  
115  """""""""""""  """""""""""""
     The reader works fine with Linux kernel 2.4 but does not with Linux  
     kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)  
   
 3. MacOSX libusb  
 """"""""""""""""  
116      There is a bug in libusb that crash the libusb library when you      There is a bug in libusb that crash the libusb library when you
117      unplug a reader and replug it in another USB socket.  So if you      unplug a reader and replug it in another USB socket.  So if you
118      unplug a reader replug it in the same USB socket.      unplug a reader replug it in the same USB socket.
# Line 118  Known problems: Line 123  Known problems:
123  Licence:  Licence:
124  ========  ========
125    
126    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
127  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
128  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
129  option) any later version.  your option) any later version.
130    
131    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
132  WITHOUT ANY WARRANTY; without even the implied warranty of  WITHOUT ANY WARRANTY; without even the implied warranty of
133  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
134  General Public License for more details.  General Public License for more details.
135    
136    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
137  along with this program; if not, write to the Free Software Foundation,  along with this library; if not, write to the Free Software Foundation,
138  Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA  Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
139    
140    
141  History:  History:
142  ========  ========
143    
144    0.9.3 - 14 March 2005, Ludovic Rousseau
145        - change the licence from GNU GPL to GNU Lesser GPL (LGPL)
146        - add support for ACS ACR 38, Kobil KAAN Base, Kobil KAAN Advanced,
147          Kobil KAAN SIM III, Kobil KAAN mIDentity, SCM Micro SCR 331,
148          SCM Micro SCR 331-DI, SCM Micro SCR 335, SCM Micro SCR 3310,
149          SCM Micro SCR 532, Cherry XX44 readers
150        - improve communication speed with readers featuring "Automatic PPS
151          made by the CCID"
152        - switch the Cherry xx33 reader in ISO mode if power up in EMV mode
153          fails.
154        - add support of character level readers. Thanks to O2Micro for the
155          patch
156        - add support for the O2Micro OZ776S reader but the reader firmware
157          is still bogus
158        - check firmware version to avoid firmwares with bugs. You can still
159          use a bogus firmware by setting DRIVER_OPTION_USE_BOGUS_FIRMWARE
160          in Info.plist
161        - some minor bugs removed
162    
163    0.9.2 - 15 August 2004, Ludovic Rousseau
164        - T=1 TPDU code:
165          . the work on T=1 TPDU code was possible thanks to Gemplus
166            validation team who helped me test, debug and bring the code to
167            an EMV validation level. Thanks to Jérôme, Jean-Yves, Xavier and
168            the Gemplus readers department
169          . error code was not checked correctly
170          . avoid a (nearly) infinite loop when resynch are needed.
171          . correctly initialise an internal value to allow more than one
172            reader to work
173        - multi-slots readers
174          . add support for multi-slots readers. The only one I have is a
175            SCM Micro SCR 331-DI with a contact and a contactless interface.
176            The contactless interface may or may not work for you since the
177            reader uses proprietary (undocumented) commands.
178        - GemPC Twin serial reader
179          . perform a command (get the reader firmware) to be sure a GemPC
180            Twin (serial or pcmcia) reader is connected
181          . use a dynamic timeout when reading the serial port.
182            The first timeout used when detecting the reader is 2 seconds to
183            not wait too long if no reader is connected. Later timeouts are
184            set to 1 minute to allow long time APDU.
185        - use `pkg-config libpcsclite --cflags` to locate the pcsc-lite
186          header files
187        - use `pkg-config --print-errors --atleast-version=1.2.9-beta5 libpcsclite`
188          to test the pcsc-lite version
189        - code improvements thanks to the splint tool (http://www.splint.org/)
190    
191    0.9.1 - 1 July 2004, Ludovic Rousseau
192        - I forgot to define IFD_PARITY_ERROR in a .h file
193    
194  0.9.0 - 1 July 2004, Ludovic Rousseau  0.9.0 - 1 July 2004, Ludovic Rousseau
195      - The T=1 TPDU automata from Carlos Prados' Towitoko driver is very      - The T=1 TPDU automata from Carlos Prados' Towitoko driver is very
196        limited and do not support error management mechanisms.        limited and do not support error management mechanisms.
# Line 175  History: Line 230  History:
230        specified by ISO 7816. We still use 5V for now to avoid problems        specified by ISO 7816. We still use 5V for now to avoid problems
231        with non ISO compliant cards        with non ISO compliant cards
232    
   
233  0.4.1 - 14 February 2004, Ludovic Rousseau  0.4.1 - 14 February 2004, Ludovic Rousseau
234      - distribute missing files readers/supported_readers.txt and      - distribute missing files readers/supported_readers.txt and
235        src/create_Info_plist.pl        src/create_Info_plist.pl
# Line 279  Bibliography: Line 333  Bibliography:
333  [13] http://www.c3po.es/ltc32.html  [13] http://www.c3po.es/ltc32.html
334  [14] http://www.c3po.es/tltc2usb.html  [14] http://www.c3po.es/tltc2usb.html
335  [15] http://www.scmmicro.com/security/SCR333.html  [15] http://www.scmmicro.com/security/SCR333.html
336  [16] http://www.acs.com.hk/products_readers_acr38.asp  [16] http://www.acs.com.hk/Product_Readers.asp?productID=59&PCate=Products_PC_Linked_SmartCard_Readers
337    [17] http://www.scmmicro.com/support/pcs_product_drivers.html
338    [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm
339    [19] http://www.kobil.com/e/products/smartcard/kaan-base.php
340    [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php
341    [21] http://www.kobil.com/d/products/smartcard/kaansim3.php
342    [22] http://www.kobil.com/e/products/index.php?s=midentity
343    
344  $Id$  $Id$
345    
Legend:
Removed from v.1015  
changed lines
  Added in v.1400
  ViewVC Help
Powered by ViewVC 1.1.5