Skip to content

Commit

Permalink
INSTALL.md: reformat in Markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
LudovicRousseau committed Jun 1, 2024
1 parent 2bea336 commit 0bdd86b
Showing 1 changed file with 33 additions and 23 deletions.
56 changes: 33 additions & 23 deletions INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,51 +2,58 @@ 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
```
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
```
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
```
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
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.
Expand All @@ -64,6 +71,7 @@ should contain something like:
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.

Expand All @@ -79,14 +87,16 @@ DEVICENAME field. Supported values are:
- SEC1210 for Microchip SEC1210

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

/dev/ttyS0 (DEVICENAME field) is the first serial port under Linux
`/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.

0 comments on commit 0bdd86b

Please sign in to comment.