This repository holds the source of the python package used to drive the LEIA smartcard reader. With it, you will be able to:

- Connect to the LEIA board
- Choose parameters for the PSS/PTS negotiation
- Send APDUs and receive the corresponding responses
- Activate the DFU mode to download new firmware
- Start a [Virtual SmartCard](https://frankmorgner.github.io/vsmartcard/) 
  client to use LEIA as a real smartcard reader (through pcscd)

The smartleia package should be compatible with Python 3.6 and newer.

If you use debian or ubuntu, smartleia should be packaged (in the recent versions of the distros). Simply try:

apt install smartleia

You may need to use the last version of python builtin's setuptools to install smartleia from git:

python -m pip install --upgrade pip setuptools wheel

git clone https://github.com/cw-leia/smartleia
cd smartleia
pip install --user .;

It is possible to use smartleia in a PCSC mode, where it communicates with the PCSC daemon so that you can use your existing tools (such as opensc) to communicate with the smartcard transparently. Using this mode will require the installation of vsmartcard-vpcd and vsmartcard-vpicc, either from the sources in the vsmartcard repository, or from your distro packages (this should be packaged in recent debian and ubuntu distros):

apt install vsmartcard-vpcd vsmartcard-vpicc

Then, you can lauch PCSC daemon in a terminal:

pcscd -fad

And launch smartleia in PCSC relay mode:

python3 -m smartleia

Of course, you should have your LEIA (or equivalent) board plugged in using USB as well as a smart card present in the connector. PCSC should spot a new ATR if everything went fine.