| 1 |
INSTALATION PROCEDURE
|
| 2 |
=====================
|
| 3 |
|
| 4 |
Installation from source:
|
| 5 |
"""""""""""""""""""""""""
|
| 6 |
|
| 7 |
get the ccid-x.y.z.tar.gz archive
|
| 8 |
$ tar xzvf ccid-x.y.z.tar.gz
|
| 9 |
$ cd ccid-x.y.z
|
| 10 |
$ ./configure
|
| 11 |
$ make
|
| 12 |
$ sudo make install
|
| 13 |
|
| 14 |
By default pcscd and my ccid driver use /usr/local/pcsc/drivers/ as
|
| 15 |
directory for hotplug drivers. If pcscd uses a different directory
|
| 16 |
(Debian pcscd uses /usr/lib/pcsc/drivers/) do:
|
| 17 |
|
| 18 |
$ ./configure --enable-usbdropdir=/usr/lib/pcsc/drivers/
|
| 19 |
|
| 20 |
|
| 21 |
more (or less) debug messages
|
| 22 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
| 23 |
|
| 24 |
You can also enable/disable some debug messages. The driver provides 4
|
| 25 |
levels of debug:
|
| 26 |
- critical: important error messages
|
| 27 |
- info: informative messages like what reader was detected
|
| 28 |
- periodic: periodic info when pcscd test if a card is present (ever
|
| 29 |
1/10 of a second)
|
| 30 |
- comm: a dump of all the bytes exchanged between the host and the
|
| 31 |
reader
|
| 32 |
|
| 33 |
By default messages of level "critical" and "info" are enabled and
|
| 34 |
messages of level "periodic" abd "comm" are off.
|
| 35 |
|
| 36 |
For example use --enable-debugcomm to enable communication debug and
|
| 37 |
--disable-debuginfo to disable info debug messages for example.
|
| 38 |
|
| 39 |
|
| 40 |
libusb not found
|
| 41 |
~~~~~~~~~~~~~~~~
|
| 42 |
|
| 43 |
If the ./configure script says something like:
|
| 44 |
configure: error: usb.h not found, use --enable-libusb=PATH
|
| 45 |
You should use --enable-libusb=PATH to tell ./configure where to find
|
| 46 |
the usb.h and libusb.so files. The ./configure script will use
|
| 47 |
PATH/include/ to search for usb.h and PATH/lib/ to search for libusb.so
|
| 48 |
|
| 49 |
|
| 50 |
serial reader
|
| 51 |
~~~~~~~~~~~~~
|
| 52 |
|
| 53 |
The GemPCTwin reader can also be connected on a serial port. By default
|
| 54 |
the serial driver is built but not installed. You must explicitely do:
|
| 55 |
$ ./configure
|
| 56 |
$ make -C src install_ccidtwin
|
| 57 |
|
| 58 |
|
| 59 |
builing serial reader only
|
| 60 |
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
| 61 |
|
| 62 |
It is possible to generate the driver for the GemPC Twin using serial
|
| 63 |
communication only (for example on an embedded system without USB).
|
| 64 |
Just do:
|
| 65 |
$ ./configure --disable-libusb
|
| 66 |
$ cd src ; make libccidtwin.la ; sudo make install_ccidtwin
|
| 67 |
|
| 68 |
You can use --enable-ccidtwindir=DIR to specify the target directory to
|
| 69 |
use. The default is $(prefix)/pcsc/drivers/serial with $(prefix) default
|
| 70 |
value /usr/local.
|
| 71 |
|
| 72 |
|
| 73 |
Binary installation:
|
| 74 |
""""""""""""""""""""
|
| 75 |
|
| 76 |
Contact your distribution support.
|
| 77 |
|
| 78 |
|
| 79 |
Test procedure:
|
| 80 |
"""""""""""""""
|
| 81 |
|
| 82 |
- check the reader is supported by the driver.
|
| 83 |
Get your reader USB identification using the lsusb(1) command:
|
| 84 |
$ lsusb
|
| 85 |
[...]
|
| 86 |
Bus 001 Device 048: ID 08e6:4433 Gemplus
|
| 87 |
|
| 88 |
Look for 08E6 (ifdVendorID) and 4433 (ifdProductID) in
|
| 89 |
/usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
|
| 90 |
Of course your numbers will be different.
|
| 91 |
|
| 92 |
If you can't find them add them (if you know what you do) and/or mail me.
|
| 93 |
|
| 94 |
- (re)start pcscd with debug on stdout. Simply do 'pcscd --debug stdout'
|
| 95 |
(you will need to have root priviledges). And look for:
|
| 96 |
[...]
|
| 97 |
readerfactory.c:1319 RFInitializeReader: Attempting startup of ReaderName
|
| 98 |
readerfactory.c:1061 RFBindFunctions: Loading IFD Handler 2.0
|
| 99 |
ifdhandler.c:76 Entering IFDHCreateChannel (lun: 0)
|
| 100 |
ccid_usb.c:131 Manufacturer: Ludovic Rousseau (ludovic.rousseau@free.fr)
|
| 101 |
ccid_usb.c:139 ProductString: Generic CCID reader v0.1.0
|
| 102 |
ccid_usb.c:143 Copyright: This driver is protected by terms of the GNU General Public License version 2, or (at your option) any later version.
|
| 103 |
ccid_usb.c:223 Found Vendor/Product: 08E6/4433 (GemPC433 SL)
|
| 104 |
ccid_usb.c:224 Using USB bus/device: 001/047
|
| 105 |
|
| 106 |
If you don't see this the driver is not installed correctly or your
|
| 107 |
reader is not supported.
|
| 108 |
|
| 109 |
$Id$
|
Parent Directory
| 
Revision Log