You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

79 lines
2.4 KiB

  1. .TH READER.CONF 5 "August 2005" Muscle "PC/SC Lite"
  2. .SH NAME
  3. reader.conf \- configuration file for pcscd readers' drivers
  4. .
  5. .SH DESCRIPTION
  6. The
  7. .I @confdir_exp@/reader.conf
  8. file contains configuration information for serial and (some) PCMCIA
  9. smart card readers.
  10. .PP
  11. USB readers SHALL NOT be configured using this file.
  12. .B pcscd
  13. uses another mechanism to automatically load USB drivers.
  14. .
  15. .SH SYNTAX
  16. The
  17. .I @confdir_exp@/reader.conf
  18. is a regular text file. Each reader must be defined by four fields:
  19. .PP
  20. FRIENDLYNAME TEXT_STRING
  21. DEVICENAME FILENAME
  22. LIBPATH FILENAME
  23. CHANNELID NUMBER
  24. .PP
  25. The "FRIENDLYNAME" field is an arbitrary text used to identify the
  26. reader. This text is displayed by commands like
  27. .BR pcsc_scan (1)
  28. that prints the names of all the connected and detected readers.
  29. .PP
  30. The "DEVICENAME" field was not used for old drivers (using the IFD
  31. handler version 2.0 or earlier). It is now (IFD handler version 3.0) used
  32. to identify the physical port on which the reader is connected. This
  33. is the device name of this port. It is dependent of the OS kernel. The
  34. first serial port device is called
  35. .I /dev/ttyS0
  36. under Linux and
  37. .I /dev/cuaa0
  38. under FreeBSD.
  39. .PP
  40. The "LIBPATH" field is the filename of the driver code. The driver is
  41. a dynamically loaded piece of code (generally a
  42. .IR drivername.so* file).
  43. .PP
  44. The "CHANNELID" is no more used for recent drivers (IFD handler 3.0) and
  45. has been superseded by "DEVICENAME". If you have an old driver this
  46. field is used to indicate the port to use. You should read your driver
  47. documentation to know what information is needed here. It should be the
  48. serial port number for a serial reader.
  49. .
  50. .SH EXAMPLE
  51. # Gemplus GemPCTwin reader with serial communication
  52. # connected to the first serial port
  53. FRIENDLYNAME "GemPCTwin serial"
  54. DEVICENAME /dev/ttyS0
  55. LIBPATH @usbdropdir@/serial/libccidtwin.so.0.4.1
  56. CHANNELID 1
  57. .
  58. .SH DEBUGGING
  59. In order to set up your
  60. .I @confdir_exp@/reader.conf
  61. file correctly you may want to have debug messages from
  62. .BR pcscd .
  63. I recommend you to start
  64. .B pscsd
  65. in the foreground and debug mode using:
  66. # pcscd \-\-foreground \-\-debug
  67. .PP
  68. If everything seems OK you can use the
  69. .B pcsc_scan
  70. command to print the list of correctly detected readers and try to get
  71. the ATR of your smart cards.
  72. .
  73. .SH AUTHOR
  74. Ludovic Rousseau <ludovic.rousseau@free.fr>
  75. .
  76. .SH SEE ALSO
  77. .BR pcscd (8),
  78. .BR pcsc_scan (1)