readme 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. ================================= DESCRIPTION ===================================
  2. Linux Fingerprint Reader Driver for Sony Vaio VGN-UX Series.
  3. 0483:2016
  4. STMicroelectronics Fingerprint Reader
  5. STMicroelectronics Biometric Coprocessor
  6. The name of the project "upekux" comes from "upek" - the manufacturer of the fingerprint
  7. scanner and "ux" - part of the UMPC model name in which this scanner is installed.
  8. The driver is a daemon that runs in user space. The development of this driver was
  9. carried out by reverse engineering using Wireshark to intercept traffic on the USB bus.
  10. Key features:
  11. > User authorization with a fingerprint
  12. > Work as an input device (as a touchpad)
  13. > Run the program as a user when a finger is detected
  14. The driver uses libusb[1] to connect to the device and nbis[2] to compare fingerprints.
  15. [1] https://libusb.info
  16. [2] https://www.nist.gov/services-resources/software/nist-biometric-image-software-nbis
  17. ======================= DEPENDENCIES, BUILD AND INSTALL =========================
  18. The "libusb" package is required to build and run. "make" and "gcc" is used to build.
  19. You may also need the "libusb-devel" package to build.
  20. Build:
  21. > Go to project root directory
  22. > Type "make"
  23. Install:
  24. > Copy "upekux" and "upekuxd" to the appropriate directory ( e.g. /bin or /usr/bin )
  25. > Create "/var/db/upekux" directory (used as fingerprint storage)
  26. > Set up autoloading of the "uinput" module
  27. > Set up "upekuxd" to start automatically as root using the init system.
  28. ===================================== USAGE =====================================
  29. "upekux" is used to interact with the daemon and control modes of operation. To get
  30. started and get help, run "upekux" with no options. User commands can be executed by
  31. any user in the system. Admin commands can only be performed by root.