readme

小程序,但是有点用出处的.进攻参考.请多多提意见.

	       This is the non-official driver for the
		Veridicom's FPS200 Fingerprint sensor

Copyright (c) 2002, 2003 Cristiano Rodrigues de Carvalho <[e-mail]>
		    www.cefala.org/fps200usbdriver

   Developed at the Federal University of Minas Gerais (www.ufm.br)
      Laboratory of the Center for Research in Speech, Acoustics,
		 Language and Music (www.cefala.org)

  		        start: january - 2003
			    
  		  last updated: december 4th - 2003


Introduction:
------------
This is a driver for the USB operation of the FPS200 Fingerprint sensor
made by Veridicom (www.veridicom.com).


Requirements:
------------
* kernel 2.4.2 or a newer one (it probably compiles too in 2.2.x but
  the usb support for that kernel is a little bit poor. It works fine
  for the 2.4.18);

* gcc 2.95.4 (I didn't tested in older ones);

* kernel sources;

* usb support.


Quick install and test:
----------------------
 > make
 > gcc capture.c -o capture
* as root
 > mknod -m 0644 /dev/fps200 c 180 240
 > ./tstmod

* connect the sensor and put your finger on it. Then, as a normal user, type:
 > ./capture tst.pgm
 > display tst.pgm


Compiling & Install:
-------------------
to compile just type the command:
  make
in the driver directory. If everything is ok you will end up with a
file named fps200.o.

You can, optionally, compile the driver with some useful debug information
typing the command:
  make DEBUG=1
instead of the command shown previously.

The options for the compilation process are:
 DEBUG=1 : compile the driver with debug information support. You can see the
	debug messages in the console or with the command dmesg.
 INTERRUPT=1: compile the driver with interrupt handling support (for the
	Finger Detect Circuit).
 LOCKDEVICE=1: if compiled this way the driver will remain installed even
	if the user try to remove it issuing the command rmmod as long there
	is a fingerprint sensor installed in the USB. Without this option
	the driver can be removed anytime as long the device is not being
	used by any process.
 ENABLEDIRECTACCESS=1: if compiled with this option the authorized users
	will be able to access the device registers directly through the
	ioctl's FPS200_IOCTL_WRITEREG and FPS200_IOCTL_READREG. Without
	this option only the FPS200_IOCTL_READREG will be available. Note
	that this can be dangerous because if you allow anyone to use
	the sensor this way the system can become unstable. The default
	is to disable this ioctl.

As root type the command:
  insmod ./fps200.o minor=240 dtr=10 dcr=6 pgc=8 thr=0
  (optionally you can use the script ./tstmod that do the same thing).

The showned parameters values are the default so you can just type:
  insmod ./fps200.o
to get the same result.

You can also copy this command line to your boot scripts so the device
is available automatically after system boot. In this case think in moving
the file fps200.o to a directory owned by the root and restrict the access
to it.

the parameters are:
 minor = the minor number for the driver. It must be an unused minor number
         in your system. The major number is fixed at 180.
 dtr = Discharge Time Register
 dcr = Discharge Current Register
 pgc = Programmable Gain Control
 thr = Threshold Register (not used yet because the support for the
	Finger Detect Circuit is not functional)

 The default values works fine as a quick start but should be fine 
tunned by you.

You can modify theese parameters observing the ranges:
 minor : 0 to 255 (default = 240)
 dtr : 0 to 127 (default = 10)
 dcr : 0 to 31 (default = 6)
 pgc : 0 to 15 (default = 8)
 thr : bits 0-3 specifyes the sharing capacitor size
       bits 6-4 specifyes the threshold voltage level
       (default = 0)

As root you must create a special file using the command mknod:
  mknod -m 0644 /dev/fps200 c 180 240

This should give acces for the drivers to anyone. Change the mode 
if you want to be more restrict.

If you install more than one sensor you can specify additional devices,
with a maximum of 4, incrementing the minor number as follows:
  mknod -m 0644 /dev/fps200_1 c 180 240
  mknod -m 0644 /dev/fps200_2 c 180 241
  mknod -m 0644 /dev/fps200_3 c 180 242
  mknod -m 0644 /dev/fps200_4 c 180 243

in this case the minor number used started with 240 that is the default
minor number for the first device.

If you have problems with minor number conflict you can change it in the
file fps200usb.h and compile the driver again.

To remove the module you can type the command:
 rmmod fps200


Usage:
-----
 I am developing an application to use this driver and I will release
it under GPL 2.0 too. You can check this project at www.cefala.org/fingerlab.

 For those who wants a fast approach I post a file named capture.c in
the driver tree that do the job. To use it compile with the command:
 gcc capture.c -o capture

 You can check the options with:
  ./capture --help
 but, for a quick start, you can try with the command line:
  ./capture tst.pgm
 Ohh...you forgot to put you finger on...try again with your finger
 on the sensor this time. :)
 
 you can display the grabbed image with some image viewer like display,
 xview, gimp, etc.

 for instance, you can view this image typing the command:
  display tst.pgm


Features:
--------
 * provides an easy interface to the FPS200 Veridicom's fingerprint sensor
   device;
 * access, by ioctl, to the parameters registers on the fly;
 * GETSUB, GETIMG and GETROW modes implemented;
 * up to 11 frames per second for GETIMG operations and up to 125 frames per
   second for GETROW operations.
 * output images at PGM (Portable Graymap File Format), BMP (Microsoft(TM) 
   Bitmap File Format) or RAW format;
 * direct access for the sensor registers (write access restricted at
   compile time);
 * read access to the Analog Input of the sensor;
 * control of the general purpose output pins;
  


Comments:
--------
 Feel free to send me comments about the driver. 


Bugs ans issues:
---------------
 1) it seems to be some problem when using the sensor with the PC-CHIPs 
   M800LMR motherboard (the one I own in my home). The image gets
   with noise when the finger is not completely on the sensor. I don't 
   know if it is a problem in the power supply of my sensor board. I'll
   test it later measuring with a multimeter (mine is without battery :);
 2) the image appear with little noise in my sensor. It can be due to 
   noise in the power supply. Anyway I think it's not a software problem;

Todo:
----
 please, see the todo list in the top of the fps200usb.c file.

Thanks:
------
 * The Author thanks CNPq - Brazil for the financial support.
 * Thanks to luzhengmao for the observations about a bug in the compilation
   with gcc 3.x