File: INSTALL.md

package info (click to toggle)
ccid 1.7.1-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,144 kB
  • sloc: ansic: 11,278; sh: 254; lex: 244; makefile: 151; perl: 91; python: 77
file content (105 lines) | stat: -rw-r--r-- 2,657 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
INSTALLATION PROCEDURE
======================

Dependencies:
-------------

You need to install:
- meson
- flex
- libusb-1

Installation from source:
-------------------------

Get the ccid-x.y.z.tar.xz archive from https://ccid.apdu.fr/files/ and do:

```
tar xjvf ccid-*.tar.xz
cd ccid-*
meson setup builddir
cd builddir
meson compile
sudo meson install
```

Installation from git repo:
---------------------------

```
git clone https://salsa.debian.org/rousseau/CCID.git
cd CCID
meson setup builddir
cd builddir
meson compile
sudo meson install
```

building serial reader driver
-----------------------------

A serial CCID reader can also be connected on a serial port. By default
the serial driver is not built. You must explicitly do:

```
meson setup builddir -Dserial=true
cd builddir
meson compile
```

configuring the driver for the serial reader
--------------------------------------------

You have to create a file in the `/etc/reader.conf.d/` directory. The file
should contain something like:

```
# Gemalto reader with serial communication
#  - n is the serial port to use n in [0..3]
#  - reader is the reader name. It is needed for multi-slot readers.
#    Possible reader values are: 
#     GemCorePOSPro
#     GemCoreSIMPro
#     GemCoreSIMPro2
#     GemPCPinPad
#     GemPCTwin (default value)
#     SEC1210UR2 (Dual slot SEC1210 Reader)
#     SEC1210URT (single slot SEC1210 Reader)
# example: /dev/ttyS0:GemPCPinPad
#DEVICENAME        /dev/ttySn[:reader]
#FRIENDLYNAME      "GemPCTwin serial"
#LIBPATH           /usr/lib/pcsc/drivers/serial/libccidtwin.so

FRIENDLYNAME      "GemPC Twin serial"
DEVICENAME        /dev/ttyS0
LIBPATH           /usr/lib/pcsc/drivers/serial/libccidtwin.so
```

You will have to adapt the library path to your configuration.

By default the GemPC Twin serial reader parameters are loaded by the
driver, if you use a GemPC PinPad, a GemCore POS Pro, a GemCore SIM
Pro or GemCore SIM Pro 2 (or IDBridge CR30) you have to indicate it in the
DEVICENAME field. Supported values are:
- GemCorePOSPro for GemCore POS Pro
- GemCoreSIMPro for GemCore SIM Pro
- GemCoreSIMPro2 for IDBridge CR30
- GemPCPinPad for GemPC PinPad
- GemPCTwin for GemPC Twin (default value)
- SEC1210UR2 for Microchip SEC1210 with 2 slots
- SEC1210URT for Microchip SEC1210 with 1 slot

You will then have something like:
```
DEVICENAME /dev/ttyS0:GemPCPinPad
```

`/dev/ttyS0` (DEVICENAME field) is the first serial port under Linux
(known as COM1 under DOS/Windows). Of course if your reader is connected
to another serial port you have to adapt that.


Binary installation:
--------------------

Contact your distribution support.