/[pcsclite]/tags/ccid/ccid-1.4.5/README
ViewVC logotype

Diff of /tags/ccid/ccid-1.4.5/README

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

revision 2931 by rousseau, Thu May 8 12:31:07 2008 UTC revision 5282 by rousseau, Wed Oct 6 08:48:17 2010 UTC
# Line 5  USB CCID IFD Handler Line 5  USB CCID IFD Handler
5  (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID  (Chip/Smart Card Interface Devices) driver. See [1] for the USB CCID
6  specifications from the USB working group.  specifications from the USB working group.
7    
8    [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf
9    
10  Authors:  Authors:
11  ========  ========
# Line 19  Authors: Line 20  Authors:
20  Supported CCID readers:  Supported CCID readers:
21  =======================  =======================
22    
23  (in alphabetical order)  The list is available at http://pcsclite.alioth.debian.org/supported.html
 - ActivCard USB reader 3.0  
 - ActivCard Activkey Sim [66]  
 - Advanced Card Systems ACR 38U-CCID [16]  
   old versions of this reader have a bug: the reader 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.  
 - Alcor Micro AU9520 [46]  
   Firmware 1.01 is bogus. The time request sent by the card is not  
   forwarded by the reader to the host.  
 - Athena ASE IIIe USB V2 [29]  
 - Athena ASE IIIe KB USB [42]  
 - Blutronics Bludrive II CCID  
 - C3PO LTC31 (new model, USB product id 0x0006) [8]  
 - Cherry XX33 keyboard [?]  
 - Cherry XX44 keyboard (SmartBoard G83-6744) [18]  
 - Cherry SmartTerminal ST2000U [35]  
 - Cherry ST-1044U [27]  
 - Covadis Alya [63]  
 - Dell keyboard SK-3106 [?]  
 - Dell smart card reader keyboard [?]  
 - Eutron CryptoIdentity [26]  
 - Eutron Digipass 860 [59]  
 - Eutron SIM Pocket Combo [25]  
 - Eutron Smart Pocket [58]  
 - Gemalto GemPC 433 SL [2] (old name: GemPC 433 SL)  
 - Gemalto GemPC Card [41]  
 - Gemalto GemPC PinPad [67]  
 - Gemalto GemPC Twin [4]  
 - Gemalto GemCore POS Pro  
 - Gemalto GemCore SIM Pro  
 - Gemalto USB Shell Token V2 [3] (old name GemPC Key)  
 - Kobil KAAN Base [19]  
 - Kobil KAAN Advanced [20]  
 - Kobil KAAN SIM III [21]  
 - OmniKey CardMan 3121 [5]  
 - RSA SecureID SID800 [50]  
 - SCM Micro SCR 331 [6]  
   You shall upgrade the firmware [17] using version 5.18 or later.  
 - SCM Micro SCR 331-DI [11]  
   You shall upgrade the firmware [17] using version 6.22 or later.  
 - SCM Micro SCR 335 [7]  
   The firmware of this reader can't be upgraded so be sure to buy a  
   recent model with firmware 5.14 or later  
 - SCM Micro SCR 355  
 - SCM Micro SCR 3310 [30]  
 - SCM Micro SCR 3311 [31]  
 - SCM Micro SPR 532 [9]  
   You shall contact Torsten Maykranz <tmaykranz@scmmicro.de> to get a  
   firmware upgrade.  
 - SmartEpad (v 2.0) [32]  
   The firmware gives a very strange description of the reader (like a  
   dwDefaultClock: 1024.000 MHz). So do not expect a perfect behavior.  
 - Verisign Secure Storage Token [24]  
 - Verisign Secure Token [?]  
 - Xiring Teo [52]  
24    
25    
26  Should work but untested by me:  Should work but untested by me:
# Line 84  I would like to get these readers to per Line 30  I would like to get these readers to per
30  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
31  manufacturers, please, contact me.  manufacturers, please, contact me.
32    
33  - Advanced Card Systems ACR122 [62]  The list is available at http://pcsclite.alioth.debian.org/shouldwork.html
 - Axalto Reflex USB v3 [38]  
 - C3PO LTC32 [13]  
 - C3PO TLTC2USB  
 - C3PO KBR36  
 - Charismathics token  
 - Cherry SmartBoard, G83-6610 [61]  
 - Covadis Véga [64]  
 - Gemplus GemPC Express  
 - Gemplus Gem e-Seal Pro  
 - Fujitsu Siemens Computers SmartCard USB 2A [53]  
 - Fujitsu Siemens Computers SmartCard Keyboard USB 2A [54]  
 - Giesecke & Devrient StarSign Card Token 350 (ICCD) [57]  
 - Giesecke & Devrient StarSign Card Token 550 (ICCD)  
 - HP USB Smart Card Keyboard [44]  
 - HP USB Smartcard Reader  
 - id3 Semiconductors CL1356D [45] (tested by me but I don't have the  
   reader anymore)  
 - id3 Semiconductors CL1356T [48] (it should be the same firmware as the  
   CL1356D)  
 - Kobil EMV CAP - SecOVID Reader III  
 - Lenovo Integrated Smart Card Reader  
 - Lexar/Gemalto Smart Enterprise Guardian [60]  
 - OmniKey CardMan 1021  
 - OmniKey CardMan 3021 [49]  
 - OmniKey CardMan 3621 [43]  
 - OmniKey CardMan 3821 [37]  
 - OmniKey CardMan 4321 [55]  
 - OmniKey CardMan 5121 [33]  
 - OmniKey CardMan 5125 [51]  
 - OmniKey CardMan 5321 [56]  
 - OmniKey CardMan 6121 [36]  
 - O2Micro Oz776 (0x7762 and 0x7772 versions)  
 - Philips JCOP41V221  
 - SafeNet IKey4000  
 - SCM Micro SCR 331-DI NTTCom [23]  
 - SCM Micro SCR 3310-NTTCOM [28]  
 - SCM Micro SCR 3320 [31b]  
 - SCM Micro SCR 333 [15]  
 - SCM Micro SDI 010 [39]  
 - SCM SCR 3340 ExpressCard54 [34]  
 - SchlumbergerSema Cyberflex Access e-gate ICCD  
 - Silitek SK-3105 keyboard [12] or C3PO TLTC2USB [14]  
 - Sitecom USB simcard reader MD-010  
 - Validy USB Token [65]  
 - Vasco DP905  
 - Winbond Electronics (for OEM only) [40]  
34    
35    
36  Unsupported or partly supported CCID readers:  Unsupported or partly supported CCID readers:
37  =============================================  =============================================
38    
39  - ActivCard USB reader 2.0 [10]  The list is available at http://pcsclite.alioth.debian.org/unsupported.html
     The reader 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.  
 - C3PO LTC31 (old model, USB product id 0x0003) [8]  
     The reader works fine with Linux kernel 2.4 but does not with Linux  
     kernel 2.6. The ioctl() syscall returns EINVAL (Invalid argument)  
 - iDream (THRC2002-2) [47]  
     PPS fails with a Cryptoflex card  
     powerup fails with a Setcos card  
     does work with the belgium eID (the reader is sold for this  
     application)  
 - Kobil mIDentity [22]  
     Time requests are not managed correctly and make the firmware fails.  
     This is not a problem unless you use a time-consuming APDU like RSA  
     key generation.  
     A new firmware will correct the bug.  
 - Reiner-SCT cyberJack pinpad(a)  
     Time requests are not managed and the driver may time out without  
     any response from the reader.  This is not a problem unless you use  
     a time-consuming APDU like RSA key generation.  
40    
41    
42  Supported operating systems:  Supported operating systems:
# Line 220  to unplug all your CCID readers so the t Line 100  to unplug all your CCID readers so the t
100  replug your readers.  You can also restart pcscd.  replug your readers.  You can also restart pcscd.
101    
102    
 Known problems:  
 ===============  
   
 MacOSX libusb  
 """""""""""""  
     There is a bug in libusb that crash the libusb library when you  
     unplug a reader and replug it in another USB socket.  So if you  
     unplug a reader replug it in the same USB socket.  
   
     see http://sourceforge.net/tracker/index.php?func=detail&aid=886778&group_id=1674&atid=101674  
   
   
103  Licence:  Licence:
104  ========  ========
105    
# Line 247  General Public License for more details. Line 115  General Public License for more details.
115    
116    You should have received a copy of the GNU Lesser General Public License    You should have received a copy of the GNU Lesser General Public License
117  along with this library; if not, write to the Free Software Foundation,  along with this library; if not, write to the Free Software Foundation,
118  Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
119    
120    
121  History:  History:
122  ========  ========
123    
124    1.4.0 - 4 August 2010, Ludovic Rousseau
125        - add support of Kingtrust Multi-Reader, Dectel CI692, Todos CX00,
126          C3PO LTC36, ACS AET65, Broadcom 5880, Tianyu Smart Card Reader,
127          Gemalto Hybrid Smartcard Reader
128        - Add support of the SCM SDI 010 again. At least the contact
129          interface can be used.
130        - Use libusb-1.0 instead of libusb-0.1
131        - add support of TAG_IFD_STOP_POLLING_THREAD and use of the
132          asynchronous libusb API to be able to stop a transfer.
133        - Request pcsc-lite 1.6.2 minimum (instead of 1.6.0) to have
134          TAG_IFD_STOP_POLLING_THREAD defined
135        - The O2MICRO OZ776 patch (for OZ776, OZ776_7772, REINER_SCT and
136          BLUDRIVEII_CCID) is no more supported with libusb-1.0
137        - correctly get the IFSC from the ATR (ATR parsing was not always
138          correct)
139        - some minor bugs removed
140    
141    
142    1.3.13 - 4 June 2010, Ludovic Rousseau
143        - much faster warm start (up to 3.8 second gained)
144        - Add support of SCARD_ATTR_VENDOR_IFD_SERIAL_NO to get the serial
145          number of the USB device
146        - some minor bugs removed
147    
148    
149    1.3.12 - 8 May 2010, Ludovic Rousseau
150        - add support of Todos AGM2 CCID, Cherry SmartTerminal XX7X, Smart
151          SBV280, Ask CPL108, German Privacy Foundation Crypto Stick v1.2,
152          id3 CL1356T5, Covadis Auriga, GoldKey PIV Token, Vasco DIGIPASS
153          KEY 860, Vasco DIGIPASS KEY 200, Vasco DP855, Vasco DP865, Atmel
154          AT90SCR100, Atmel AT90SCR050, Atmel VaultIC420, Atmel VaultIC440,
155          Atmel VaultIC460, KOBIL Smart Token, KOBIL mIDentity 4smart, KOBIL
156          mIDentity 4smart AES, KOBIL mIDentity visual, KOBIL mIDentity
157          fullsize, KOBIL mIDentity 4smart fullsize AES, SCM SCR3500
158        - remove support of Smart SBV280 on manufacturer request. They use
159          libusb directly.
160        - remove support of SCM SDI 010 on manufacturer request since not
161          supported by my driver
162        - Enable the Broadcom 5880 reader. It should work after a firmware
163          upgrade.
164        - better support of Dell keyboard
165        - better support of multislot readers (like the GemCore SIM Pro)
166        - better support of SCM SCR3310
167        - better support of ICCD version A devices
168        - The Covadis Véga-Alpha reader is a GemPC pinpad inside. So we use
169          the same code to:
170          . load the strings for the display
171          . avoid limitation of the reader
172        - IFDHControl(): the (proprietary) get firmware version escape
173          command is allowed with a Gemalto reader
174          . the (proprietary) switch interface escape command is allowed on
175          the Gemalto GemProx DU
176          . return IFD_ERROR_NOT_SUPPORTED instead of
177          IFD_COMMUNICATION_ERROR if the dwControlCode value is not
178          supported
179          . return IFD_ERROR_INSUFFICIENT_BUFFER when appropriate
180        - IFDHGetCapabilities(): add support of SCARD_ATTR_ICC_PRESENCE and
181          SCARD_ATTR_ICC_INTERFACE_STATUS
182        - support FEATURE_GET_TLV_PROPERTIES
183        - add support of IOCTL_FEATURE_GET_TLV_PROPERTIES bMinPINSize &
184          bMaxPINSize for Gemalto Pinpad V1 & Covadis Véga-Alpha
185        - support extended APDU of up to 64kB with APDU readers.
186        - get the language selected during Mac OS X installation as language
187          to use for Covadis Véga-Alpha and Gemalto GemPC PinPad pinpad
188          readers
189        - FEATURE_MCT_READER_DIRECT is also supported by the Kobil mIDentity
190          visual
191        - better support of Sun Studio CC
192        - some minor bugs removed
193    
194    
195    1.3.11 - 28 July 2009, Ludovic Rousseau
196        - add support of Raritan D2CIM-DVUSB VM/CCID, Feitian SCR301,
197          Softforum XecureHSM, 2 Neowave Weneo tokens, Synnix STD200, Aktiv
198          Rutoken ECP, Alcor Micro SCR001, ATMEL AT91SC192192CT-USB,
199          Panasonic USB Smart Card Reader 7A-Smart, Gemalto GemProx DU and SU
200        - remove support of Reiner-SCT cyberJack pinpad(a) on request of
201          Reiner-SCT.  You should user the Reiner-SCT driver instead
202        - define CFBundleName to CCIDCLASSDRIVER so that non class drivers
203          have a higher priority. Used by pcsc-lite 1.5.5 and up.
204          Add a --disable-class configure option so that the Info.plist does
205          not define a Class driver. Default is class driver.
206        - do not power up a card with a voltage not supported by the reader
207        - add support of PIN_PROPERTIES_STRUCTURE structure and
208          FEATURE_IFD_PIN_PROPERTIES
209        - adds support of FEATURE_MCT_READERDIRECT. Only the Kobil TriB@nk
210          reader supports this feature for now. This is used for the Secoder
211          functionality in connected mode.
212        - add support of a composite device. No change needed with libhal.
213          use --enable-composite-as-multislot on Mac OS X since libhal is
214          not available on Mac OS X or with libusb on Linux
215        - some minor bugs removed
216    
217    
218    1.3.10 - 7 March 2009, Ludovic Rousseau
219        - add support for MSI StarReader SMART, Noname reader (from
220          Omnikey), Xiring Xi Sign PKI, Realtek 43 in 1 + Sim + Smart Card
221          Reader, Atmel AT98SC032CT, Aktiv Rutoken Magistra, TianYu CCID
222          SmartKey, Precise Biometrics 200 MC and 250 MC
223        - add a patch to support the bogus OpenPGP card (on board key
224          generation sometimes timed out)
225        - disable support of the contactless part of SDI010 and SCR331DI
226          (this code was reverse engineered and hard to maintain)
227        - some minor bugs removed
228    
229    
230    1.3.9 - 18 November 2008, Ludovic Rousseau
231        - add support for Aladdin eToken PRO USB 72K Java, Cherry
232          SmartTerminal ST-1200USB, Atmel AT91SO, SpringCard Prox'N'Roll,
233          CSB6 Basic, EasyFinger Ultimate, CSB6 Ultimate, EasyFinger
234          Standard, CrazyWriter, CSB6 Secure, KONA USB SmartCard, HP MFP
235          Smart Card Reader, ACS ACR122U PICC, Gemalto PDT, VMware Virtual
236          USB CCID
237        - MacOSX/configure: do not overwrite PCSC_CFLAGS, PCSC_LIBS,
238          LIBUSB_CFLAGS and LIBUSB_LIBS if already defined by the user
239        - by default, link statically against libusb on Mac OS X
240        - IFDHPowerICC(): use a very long timeout for PowerUp since the card
241          can be very slow to send the full ATR (up to 30 seconds at 4 MHz)
242        - SecurePINVerify(): correct a bug when using a Case 1 APDU and a
243          SCM SPR532 reader
244        - log the reader name instead of just the pcscd Lun
245        - some minor bugs removed
246    
247    
248    1.3.8 - 27 June 2008, Ludovic Rousseau
249        - add support for Oberthur ID-One Cosmo Card
250        - do not include the release number in the Info.plist to avoid a
251          diff of a configuration file when upgrading the package.
252        - do not fail compilation if libusb is not available
253        - do not crash if the reader firmware is bogus and does not support
254          chaining for extended APDU.  This is the case for Kobil readers
255        - some minor bugs removed
256    
257    
258    1.3.7 - 8 June 2008, Ludovic Rousseau
259        - add support for ActivCard Activkey Sim, Pro-Active CSB6 Ultimate,
260          id3 Semiconductors CL1356A HID
261        - src/parse: do not try to parse devices with bInterfaceClass=0xFF
262          by default (use command line argument -p for proprietary class)
263        - configure.in: check if libusb-0.1 is emulated by libusb-compat +
264          libusb-1.0 to use or not the USB interrupt feature
265        - correct a bug in the serial communication (GemPC twin serial
266          reader)
267        - correct a pthread problem under Solaris
268        - some minor bugs removed
269    
270    
271  1.3.6 - 30 April 2008, Ludovic Rousseau  1.3.6 - 30 April 2008, Ludovic Rousseau
272      - add support for Covadis Alya, Covadis Véga, Precise Biometrics 250      - add support for Covadis Alya, Covadis Véga, Precise Biometrics 250
273        MC, Vasco DP905, Validy TokenA sl vt        MC, Vasco DP905, Validy TokenA sl vt
# Line 609  History: Line 624  History:
624      - First public release      - First public release
625    
626    
 References:  
 ===========  
   
 [1] http://www.usb.org/developers/devclass_docs/ccid_classspec_1_00a.pdf  
 [2] http://www.gemalto.com/products/pc_usb_sl/  
 [3] http://www.gemalto.com/products/usb_shell_token_v2/  
 [4] http://www.gemalto.com/products/pctwin/  
 [5] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=21  
 [6] http://scmmicro.com/security/view_product_en.php?PID=3  
 [7] http://scmmicro.com/security/view_product_en.php?PID=11  
 [8] http://www.c3po.es/ltc31.html  
 [9] http://scmmicro.com/security/view_product_en.php?PID=13  
 [10] http://www.activcard.com/products/usb_reader.html  
 [11] http://www.scmmicro.com/security/SCR331-DI.html  
 [12] http://www.silitek.com/prod/getProduct.do?xml_id=4_2&menu_id=4_2_8&cid=1_8_5  
 [13] http://www.c3po.es/ltc32.html  
 [14] http://www.c3po.es/tltc2usb.html  
 [15] http://scmmicro.com/security/view_product_en.php?PID=10  
 [16] http://www.acs.com.hk/Product_Readers.asp?productID=107&PCate=Products_PC_Linked_SmartCard_Readers  
 [17] http://www.scmmicro.com/support/pcs_downloads.php  
 [18] http://www.cherrycorp.com/english/advanced-line/advanced-line_smartboard_g83-6744.htm  
 [19] http://www.kobil.com/e/products/smartcard/kaan-base.php  
 [20] http://www.kobil.com/e/products/smartcard/kaan-advanced.php  
 [21] http://www.kobil.com/d/products/smartcard/kaansim3.php  
 [22] http://www.kobil.com/e/products/index.php?s=midentity  
 [23] http://www.ntt.com/jpki/SCR331DI.html  
 [24] http://www.verisign.co.uk/products-services/security-services/unified-authentication/usb-tokens/  
 [25] http://www.eutron.com/simpocket.asp  
 [26] http://www.cryptoidentity.eutron.com/eng/home.asp  
 [27] http://www.cherry.de/english/advanced-line/advanced_smartterminal_st-1044u.htm  
 [28] http://www.ntt.com/jpki/scr3310.html  
 [29] http://www.asedrive.com/product.asp?pid=1  
 [30] http://scmmicro.com/security/view_product_en.php?PID=4  
 [31] http://scmmicro.com/security/view_product_en.php?PID=5  
 [31b] http://scmmicro.com/security/view_product_en.php?PID=6  
 [32] http://www.smartepad.com.br/  
 [33] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=37  
 [34] http://scmmicro.com/security/view_product_en.php?PID=7  
 [35] http://www.cherry.de/deutsch/advanced-line/advanced_smart_terminal_st-2000u.htm  
 [36] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=29  
 [37] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=33  
 [38] http://www.reflexreaders.com/Products/reflex_usbnew.html  
 [39] http://scmmicro.com/security/view_product_en.php?PID=19  
 [40] http://www.winbond.com.tw/E-WINBONDHTM/partner/b_2_e_4.htm  
 [41] http://www.gemplus.com/products/gempc_card/  
 [42] http://www.asedrive.com/product.asp?pid=2  
 [43] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=31  
 [44] http://h18000.www1.hp.com/products/quickspecs/12346_na/12346_na.HTML  
 [45] http://www.id3semiconductors.com/produits/cl1356D.htm  
 [46] http://www.alcormicro.com/products_detail.php?main_id=8&p_id=21  
 [47] http://www.tai-hao.com/english/products_detail.php?main_id=4&second_id=13&p_id=53&now_rows=1  
 [48] http://www.id3semiconductors.com/produits/cl1356T.htm  
 [49] http://www.omnikey.com/index.php?id=products&tx_okprod_pi1[product]=48  
 [50] http://www.rsasecurity.com/products/securid/datasheets/SID800_DS_0205.pdf  
 [51] http://www.omnikey.com/?id=products&tx_okprod_pi1[product]=39  
 [52] http://www.teobyxiring.com/  
 [53] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_scr_usbex.html  
 [54] http://www.fujitsu-siemens.com/solutions/business_solutions/security/security_products/smartcase_kbpc_cx.html  
 [55] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=50  
 [56] http://omnikey.aaitg.com/?id=products&tx_okprod_pi1[product]=41  
 [57] http://www.gi-de.com/portal/page?_pageid=42,126834&_dad=portal&_schema=PORTAL  
 [58] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=26&IDFamiglia=3  
 [59] http://www.eutronsec.com/infosecurity/Contents/ProductLine/Details.aspx?IDProd=62&IDFamiglia=39  
 [60] http://www.lexar.com/enterprise/ent_ppsd.html  
 [61] http://www.cherry.de/deutsch/produkte/chipkartentastaturen_g-6610.htm  
 [62] http://acs.com.hk/acr122.php  
 [63] http://covadis.ch/Alya.239.0.html  
 [64] http://covadis.ch/Vega.104.0.html  
 [65] http://www.validy.com/en/products/token/  
 [66] http://www.actividentity.com/products/activkey_usb_tokens__home.php  
 [67] http://www.gemalto.com/products/pc_pinpad/  
   
627  $Id$  $Id$
628    
629   vim:ts=20   vim:ts=20
Legend:
Removed from v.2931  
changed lines
  Added in v.5282
  ViewVC Help
Powered by ViewVC 1.1.5