Secure Flash Card PC/SC driver for Linux 

Version 1.42

Copyright © 2015 Swissbit AG.
security@swissbit.com


About

The Secure Flash Card PC/SC driver is an IFD Handler v3.0 implementation for the Swissbit Secure Flash Card for Linux to be supported under the MUSCLE PC/SC resource manager (PC/SC Lite server deamon: pcscd).
For more detailed information about the IFD Handler and the API, please see here.
 

Supported Operating Systems

Other distributions might work as well, but use at your own risk.
 

Package Content

    - ifd-sfc.bundle (the IFD bundle as required by USB readers)
        - Contents
            - Linux
                - libifdsfc.so (the driver shared library)
            - Info.plist (configuration y file, see Installation instructions)
    - reader.conf (the configuration file as required for serial readers)


Installation

The Swissbit Secure Flash Card can be connected to the computer via a USB microSD reader (USB reader) or (if available) via a SD card slot and a microSD to SD adapter (serial reader). Depending how you will connect your Secure Flash Card to your computer, different setup configuration for the Linux OS is necessary.

Serial readers

Serial drivers must be configured to operate on a particular port and respond to a particular name. The reader.conf file is used for this purpose.
The Secure Flash Card driver does not make use of the DEVICENAME entry in the reader.conf file (therefore it is set to /dev/null) because the driver will check all the mount points to find the Secure Flash Card in a connected SD card reader.

USB readers

USB readers use the bundle approach so that the reader can be loaded and unloaded upon automatic detection of the device. The bundle approach is simple: the actual library is just embedded in a directory (ifd-sfc.bundle) so additional information can be gathered about the device. To be able to find the correct driver for a USB reader connected to the computer, the PID and VID of a USB reader must be added in the Info.plist file of the driver bundle (can be found in ifd-sfc.bundle\Contents). Currently only the Genesys Logic, Inc. USB 2.0 microSD Reader (a.k.a. Swissbit Card Reader) is configured to be used for the Secure Flash Card IFD Handler. If you wish to use another USB reader, please add PID and VID of your USB reader in Info.plist.

  1. If you have not installed the PC/SC Lite server deamon (pcscd), install it by executing: sudo apt-get install pcscd
  2. (Only if you connect your Secure Flash Card to your computer via the SD card slot): copy the file reader.conf to the directory /etc/reader.conf.d
  3. Copy the folder (containing the driver) ifd-sfc.bundle to the folder /usr/lib/pcsc/drivers
  4. Start pcscd (to see pcscd debug output, start it with: pcscd --foreground --debug)
  5. (optional) You can install the pcsc-tools to check if your Secure Flash Card was recognized correctly by PC/SC and to send APDUs to the card:
    1. Install pcsc-tools: sudo apt-get install pcsc-tools
    2. Run pcsc_scan to check if the card reader / Secure Flash Card was found
    3. Run gscriptor, connect to the reader and send APDUs to the Secure Flash Card. For more information, please visit: http://ludovic.rousseau.free.fr/softwares/pcsc-tools
 

Change History