***************************************************************

 Installation instructions for 
 the OMNIKEY CardMan CCID Smartcard reader series.
	    
 Version 3.5.1
 Omnikey
 http://www.omnikey.com/
 
***************************************************************

------------------------------
 Products supported
------------------------------
OMNIKEY CardMan 3x21
OMNIKEY CardMan 1021
OMNIKEY CardMan 6121
OMNIKEY CardMan 3621
OMNIKEY CardMan 3821
OMNIKEY CardMan 4321
USB CCID Smart Card Reader
FSC SCR Keyboard USB 2A
FSC SCR USB 2A
Cherry SmartBoard XX44
Cherry SmartTerminal XX44

------------------------------
 What you need
------------------------------

[1] Kernel with USB support either compiled in or as modules

[2] Mounted /usbfs (/usbdevfs)
    For more detailed informations see http://www.linux-usb.org/

[3] libusb >= Version 0.1.12 available at
    http://libusb.sourceforge.net/

[4] PCSCLite >= Version 1.4.102 available at 
    http://www.linuxnet.com/ 
      and/or 
    http://alioth.debian.org/projects/pcsclite/

[5] In order to use new SCardControl-API use PCSCLite > 1.3.2

[6] This driver supports our CT-API and our Synchronous API.
    So, if you like to use one of them, you must download
    the API in question from www.omnikey.com.
    
------------------------------
 Special Features
------------------------------

[1] Supports extended APDUs

[2] Support for non ISO compliant cards.

[3] Support for PCSCLite hotplug notification
   
------------------------------
 Driver Installation
------------------------------

After you have downloaded the tarball extract it in any directory
 
  # tar -xzvf ifd<driver-package-name>.tar.gz

change to this directory  and run as root user
  
  # ./install

This script checks if PCSCLite is installed and then copies 
the CCID driver bundle to /usr/local/pcsc/drivers directory,
 which is the default PCSCLite USB driver dropdir. 
You can change the dropdir by providing another install path 
to the install script using the option '-d':

  # ./install -d /path/to/my/dropdir

------------------------------
 Note
------------------------------

1. Ensure that PCSC-Lite < 1.4.100 is configured with the options
   --enable-libusb and --enable-extendedapdu.
   Moreover it is also necessary to install libusb
   AND its corresponding development sources package that
   is e.g. for DEBIAN libusb-dev or for MANDRIVA libusb-devel

2. Using pcsc-lite < 1.3.2 without --enable-extendedapdu,
   could cause a segmentation fault at pcscd, because 
   there is a bug passing the receive length correctly. This
   only occurs if the receive buffer (passed by SCardTransmit)
   is bigger than PCSC defines in MAX_BUFFER_SIZE.
   
-----------------------------
 Support
-----------------------------

Q: What driver version am I using at the moment?

A: You can determine the driver version number by having a look at the PCSCLite
   bundle directory (usually /usr/local/pcsc/drivers): The bundle name of our 
   devices drivers contain the driver version number. 
   The driver is also printing a version string every time a reader is activated 
   by PCSCLite: This string can be found either in the system log
   or on the console you started PCSCLite daemon from.


Q: I am experiencing problems using smartcard XYZ !

A: Please send an email to our support address support@omnikey.com containing
   a description of the chain of events which lead to the misbehavior (reader plug-in/-off, 
   SC insertion/removal, commands sent to the SC or at least the program used to talk to the SC), 
   also include the name and ATR of the smartcard, and add the PCSCLite log events (should be written to
   your system log /var/log/messages or similar). Your systems kernel version and kind of distribution
   may also be helpful.
