| 1 |
INSTALATION PROCEDURE
|
| 2 |
=====================
|
| 3 |
|
| 4 |
Installation from source:
|
| 5 |
"""""""""""""""""""""""""
|
| 6 |
|
| 7 |
get the ccid-x.y.z.tar.gz archive and do:
|
| 8 |
|
| 9 |
$ tar xzvf ccid-x.y.z.tar.gz
|
| 10 |
$ cd ccid-x.y.z
|
| 11 |
$ dropdir=$(pkg-config libpcsclite --variable=usbdropdir)
|
| 12 |
$ ./configure --enable-usbdropdir=$dropdir
|
| 13 |
$ make
|
| 14 |
$ sudo make install
|
| 15 |
|
| 16 |
By default pcscd and my ccid driver use /usr/local/pcsc/drivers/ as
|
| 17 |
directory for hotplug drivers. But pcscd store this value in a
|
| 18 |
pkg-config file so you do not have to know where the files are searched
|
| 19 |
for.
|
| 20 |
|
| 21 |
|
| 22 |
libusb not found
|
| 23 |
~~~~~~~~~~~~~~~~
|
| 24 |
|
| 25 |
If the ./configure script says something like:
|
| 26 |
configure: error: usb.h not found, use --enable-libusb=PATH
|
| 27 |
You should use --enable-libusb=PATH to tell ./configure where to find
|
| 28 |
the usb.h and libusb.so files. The ./configure script will use
|
| 29 |
PATH/include/ to search for usb.h and PATH/lib/ to search for libusb.so
|
| 30 |
|
| 31 |
|
| 32 |
serial reader
|
| 33 |
~~~~~~~~~~~~~
|
| 34 |
|
| 35 |
The GemPCTwin reader can also be connected on a serial port. By default
|
| 36 |
the serial driver is built but not installed. You must explicitely do:
|
| 37 |
|
| 38 |
$ dropdir=$(pkg-config libpcsclite --variable=usbdropdir)
|
| 39 |
$ ./configure --enable-ccidtwindir=$dropdir/serial
|
| 40 |
$ make -C src install_ccidtwin
|
| 41 |
|
| 42 |
|
| 43 |
builing serial reader only
|
| 44 |
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
| 45 |
|
| 46 |
It is possible to generate the driver for the GemPC Twin using serial
|
| 47 |
communication only (for example on an embedded system without USB).
|
| 48 |
Just do:
|
| 49 |
$ ./configure --disable-libusb
|
| 50 |
$ cd src ; make libccidtwin.la ; sudo make install_ccidtwin
|
| 51 |
|
| 52 |
You can use --enable-ccidtwindir=DIR to specify the target directory to
|
| 53 |
use. The default is $(prefix)/pcsc/drivers/serial with $(prefix) default
|
| 54 |
value /usr/local.
|
| 55 |
|
| 56 |
|
| 57 |
configuring the driver for the serial reader (GemPC Twin)
|
| 58 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
| 59 |
|
| 60 |
You have to create or edit the file /etc/reader.conf. The file should
|
| 61 |
contain something like:
|
| 62 |
|
| 63 |
FRIENDLYNAME "GemPC Twin"
|
| 64 |
DEVICENAME /dev/ttyS0
|
| 65 |
LIBPATH /usr/local/pcsc/drivers/serial/libccidtwin.so.0.4.2
|
| 66 |
CHANNELID 1
|
| 67 |
|
| 68 |
You may have to adapt the library path to your configuration and library
|
| 69 |
version.
|
| 70 |
|
| 71 |
If you use a recent pcsc-lite (1.2.9 or more)
|
| 72 |
|
| 73 |
/dev/ttyS0 (DEVICENAME field) is the first serial port under Linux
|
| 74 |
(known as COM1 under DOS/Windows). Of course if your reader is
|
| 75 |
connected to another serial port you have to adapt that.
|
| 76 |
|
| 77 |
|
| 78 |
If you use an old pcsc-lite (1.2.0 or less)
|
| 79 |
|
| 80 |
The reader is designated by CHANNELID. 1 is the first serial port
|
| 81 |
(/dev/ttyS0 or COM1), etc.
|
| 82 |
The driver uses the files /dev/pcsc/[1-4] to identify the serial
|
| 83 |
device. These /dev/pcsc/[1-4] files should be symbolic links to the
|
| 84 |
real serial devices.
|
| 85 |
|
| 86 |
To create the /dev/pcsc/[1-4] files do (as root):
|
| 87 |
# mkdir /dev/pcsc
|
| 88 |
# cd /dev/pcsc
|
| 89 |
# ln -s ../ttyS0 /dev/pcsc/1
|
| 90 |
# ln -s ../ttyS1 /dev/pcsc/2
|
| 91 |
# ln -s ../ttyS2 /dev/pcsc/3
|
| 92 |
# ln -s ../ttyS3 /dev/pcsc/4
|
| 93 |
|
| 94 |
|
| 95 |
Binary installation:
|
| 96 |
""""""""""""""""""""
|
| 97 |
|
| 98 |
Contact your distribution support.
|
| 99 |
|
| 100 |
|
| 101 |
Test procedure:
|
| 102 |
"""""""""""""""
|
| 103 |
|
| 104 |
- check the reader is supported by the driver.
|
| 105 |
Get your reader USB identification using the lsusb(1) command:
|
| 106 |
$ lsusb
|
| 107 |
[...]
|
| 108 |
Bus 001 Device 048: ID 08e6:4433 Gemplus
|
| 109 |
|
| 110 |
Look for 08E6 (ifdVendorID) and 4433 (ifdProductID) in
|
| 111 |
/usr/local/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist
|
| 112 |
Of course your numbers will be different.
|
| 113 |
|
| 114 |
If you can't find them add them (if you know what you do) and/or mail me.
|
| 115 |
|
| 116 |
- (re)start pcscd with debug on stdout. Simply do 'pcscd --debug stdout'
|
| 117 |
(you will need to have root priviledges). And look for:
|
| 118 |
[...]
|
| 119 |
readerfactory.c:1319 RFInitializeReader: Attempting startup of ReaderName
|
| 120 |
readerfactory.c:1061 RFBindFunctions: Loading IFD Handler 2.0
|
| 121 |
ifdhandler.c:76 Entering IFDHCreateChannel (lun: 0)
|
| 122 |
ccid_usb.c:131 Manufacturer: Ludovic Rousseau (ludovic.rousseau@free.fr)
|
| 123 |
ccid_usb.c:139 ProductString: Generic CCID reader v0.1.0
|
| 124 |
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.
|
| 125 |
ccid_usb.c:223 Found Vendor/Product: 08E6/4433 (GemPC433 SL)
|
| 126 |
ccid_usb.c:224 Using USB bus/device: 001/047
|
| 127 |
|
| 128 |
If you don't see this the driver is not installed correctly or your
|
| 129 |
reader is not supported.
|
| 130 |
|
| 131 |
$Id$
|
Parent Directory
| 
Revision Log