Biometric FingerPrint Authentication for BSD/Linux

Languages

[en] [ru]

BFPSDK: Biometric FingerPrint Software Development Kit

Biometric FingerPrint Software Development Kit (BFPSDK) was developed to provide the missing biometric fingerprint authentication for the Unix/Linux world. The BFPSDK package was designed and implemented using the classic Unix paradigm to make things as more simple and effective to use. Unlike extremely complex packages that available on Microsoft Windows platform or like something, BFPSDK package is enabled the application developer to use the biometric technologies in the very simple and effective manner: simple input/output channels that are masked the very complex filters and algorithms because real application developer or user want to get the useful and simple things but not the Babylon's towers.

Hardware Requirements

Hardware Platform: Intel x86-based
Processor: Intel Pentium 166 MHz (minimum), Intel Pentium II (recommended)
Memory: 32 MB (minimum)
Interface Bus: USB (Universal Serial Bus v1.1 or higher) for local scanner
Notes: BFPSDK or other biometric software are compiled for platform with Intel Pentium or higher

Software Requirements (Operating Systems)

FreeBSD 4.7 or higher, OpenBSD 3.0 or higher, NetBSD 1.5.2 or higher, Linux (kernels 2.2.x, 2.4.x, 2.6.x), Mac OS X 10.4.5 or higher

Software Requirements (Application Libraries)

BFPSDK package is required the application library libusb-0.1.7

Hardware Installation

Attach hardware (scanner) to the USB interface (sometimes you must reboot that the scanner will be detected during the system loading).
This scanner don't supported by any standard system modules or drivers therefore you must see the following messages or like something from system (using dmesg).
All messages are taken from my development machines:

On FreeBSD 4.10
ugen0: vendor 0x1491 product 0x0020, rev 1.00/0.01,addr2

On OpenBSD 3.0
ugen0 at uhub0 port 2
ugen0: vendor 0x1491 product 0x0020, rev 1.00/0.01, addr 2

On NetBSD 1.5.2
ugen0 at uhub0 port 1
ugen0: vendor 0x1491 product 0x0020, rev 1.00/0.01, addr 2

On RedHat Linux 6.2 (kernel 2.2.22)
hub.c: USB new device connect on bus1/2, assigned device number 2
usb.c: USB new device connect, assigned device number 2
usb.c: USB device 2 (vend/prod 0x1491/0x20) is not claimed by any active driver.

On RedHat Linux 9.0 (kernel 2.4.20)
hub.c: new USB device 00:07.2-2.1, assigned address 4
usb.c: USB device 4 (vend/prod 0x1491/0x20) is not claimed by any active driver.

On Suse Linux 6.3 (kernel 2.2.25)
usb.c: USB new device connect, assigned device number 2
usb.c: USB device 2 (vend/prod 0x1491/0x20) is not claimed by any active driver.

On Suse Linux 7.3 (kernel 2.4.10)
hub.c: USB new device connect on bus1/2/1, assigned device number 4
usb.c: USB device 4 (vend/prod 0x1491/0x20) is not claimed by any active driver.

On Debian Linux 2.2 (kernel 2.4.14)
hub.c: USB new device connect on bus1/1, assigned device number 2
usb.c: USB device 2 (vend/prod 0x1491/0x20) is not claimed by any active driver.

Software Installation

In the supplied documentation you will find a more detail instructions, but following steps will be enough to run BFPSDK package.

1. Download and install library libusb-0.1.7 (binary package for your platfrom or build from sources)
    Notes for OpenBSD 3.0. You don't need libusb, at least, for bfpsdk-1.3.0
2. Download BFPSDK package for your platfrom, for example, into directoty /usr/local/src: cd /usr/local/src
    Unarchive tarball package: tar xzf bfpsdk-<os>-<ver>-<hdw>-x.y.z.tar.gz
3. Goto to this new directory: cd bfpsdk-<os>-<ver>-<hdw>-x.y.z
4. Install BFPSDK package: make -f bfpsdk.mak install
5. Configuration file for BFPSDK package must be found here: /usr/local/etc/bfpsdk.conf
    Notes for OpenBSD 3.0. Use this file: /usr/local/etc/bfpsdk.conf and use ls -l /dev/ugen* to find the active device for the scanner.
6. Run demo programs in text mode: sample, or text-demo or ncurses-demo
7. Download ImageMagick and gtk2 packages (need for graphical demo)
8. Run demo programs in graphic mode: gtk-scan, or gtk-demo