Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
READER.CONF(5)			   PC/SC Lite			  READER.CONF(5)

NAME
     reader.conf - configuration file for pcscd readers' drivers

DESCRIPTION
     The /etc/reader.conf.d/* files contain configuration information for serial
     and (some) PCMCIA smart card readers.

     USB  readers SHALL NOT be configured using these files.  pcscd uses another
     mechanism to automatically load USB drivers.

SYNTAX
     The /etc/reader.conf.d/* files are regular text file. Each reader	must  be
     defined by four fields:

      FRIENDLYNAME     TEXT_STRING
      DEVICENAME       FILENAME
      LIBPATH	       FILENAME
      CHANNELID        NUMBER

     The  "FRIENDLYNAME" field is an arbitrary text used to identify the reader.
     This text is displayed by commands like pcsc_scan(1) that prints the  names
     of all the connected and detected readers.

     The  "DEVICENAME" field was not used for old drivers (using the IFD handler
     version 2.0 or earlier). It is now (IFD handler version 3.0) used to  iden-
     tify the physical port on which the reader is connected. This is the device
     name  of this port. It is dependent of the OS kernel. The first serial port
     device is called /dev/ttyS0 under Linux and /dev/cuaa0 under FreeBSD.

     The "LIBPATH" field is the filename of the driver code. The driver is a dy-
     namically loaded piece of code (generally a drivername.so.*  file).

     The "CHANNELID" is no more used for recent drivers (IFD  handler  3.0)  and
     has  been	superseded by "DEVICENAME". If you have an old driver this field
     is used to indicate the port to use. You should read your driver documenta-
     tion to know what information is needed here. It should be the serial  port
     number for a serial reader.

EXAMPLE
      # Gemplus GemPCTwin reader with serial communication
      # connected to the first serial port
      FRIENDLYNAME	"GemPCTwin serial"
      DEVICENAME	/dev/ttyS0
      LIBPATH		/usr/local/lib/pcsc/drivers//serial/libccidtwin.so.0.4.1
      CHANNELID 	1

DEBUGGING
     In  order	to  set up your /etc/reader.conf.d/my_reader.conf file correctly
     you may want to have debug messages from pcscd.  I recommend you  to  start
     pscsd in the foreground and debug mode using:
      # pcscd --foreground --debug

     If  everything seems OK you can use the pcsc_scan command to print the list
     of correctly detected readers and try to get the ATR of your smart cards.

AUTHOR
     Ludovic Rousseau <ludovic.rousseau@free.fr>

SEE ALSO
     pcscd(8), pcsc_scan(1)

Muscle				  December 2021 		  READER.CONF(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=reader.conf&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help