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
- Ubuntu Linux 14.04 (32/64-bit)
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.
- If you have not installed the PC/SC Lite server deamon
(pcscd), install it by executing: sudo apt-get install pcscd
- (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
- Copy the folder (containing the driver) ifd-sfc.bundle
to
the folder /usr/lib/pcsc/drivers
- Start pcscd (to see pcscd debug output, start it with: pcscd --foreground --debug)
- (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:
- Install pcsc-tools: sudo apt-get install
pcsc-tools
- Run pcsc_scan
to check if the card reader / Secure Flash Card was found
- 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
- Version 1.42: ATR length corrected to support OpenSC
- Version 1.41: performance improved for short running APDUs by stepped polling
- Version 1.4: fixed bug in long running APDUs
- Version 1.3: performance improvement in APDU communication, SFC files are cleaned on all non SFC devices
- Version 1.2: smarter search and presence detection avoiding permanent polling, fixed bug in getattributes method
- Version 1.1: added support for Secure Flash Card connected
to the computer via SD card slot
- Version 1.0: initial version, only USB readers supported