fdo-mirrors/libfprint
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/libfprint/libfprint.git synced 2026-05-14 09:58:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
read-only mirror of https://gitlab.freedesktop.org/libfprint/libfprint
1850 commits 31 branches 33 tags 35 MiB
C 95.7%
Python 3.1%
Meson 0.9%
Shell 0.2%
Find a file
Leonardo Francisco 4ade76ea90 validity: Add firmware extension upload (Iteration 3) 
Implement the firmware extension (fwext) upload module for
Validity/Synaptics VCSFW sensors. When the sensor reports no
firmware loaded (GET_FW_INFO returns status 0xB004), the driver
uploads the .xpfwext firmware file using the following sequence:

  1. WRITE_HW_REG32 (0x08) to prepare hardware register
  2. READ_HW_REG32 (0x07) to verify register state
  3. Load .xpfwext file from filesystem search paths
  4. For each 4KB chunk:
     a. Send db_write_enable blob (encrypted auth token)
     b. WRITE_FLASH (0x41) with chunk payload
     c. CLEANUP (0x1A) to commit chunk
  5. WRITE_FW_SIG (0x42) to upload RSA signature
  6. GET_FW_INFO (0x43) to verify successful upload
  7. REBOOT (0x05 0x02 0x00) to activate new firmware

Architecture: Uses the NULL-callback subsm pattern where SEND
states call vcsfw_cmd_send(self, ssm, cmd, len, NULL) and RECV
states read self->cmd_response_status/data directly. This avoids
the double-advance bug with fpi_ssm_start_subsm auto-advancing
the parent.

New files:
  - validity_fwext.h: Structures, SSM state enum, API declarations
  - validity_fwext.c: Upload SSM, file parser, command builders
  - validity_blob_dbe_009a.inc: db_write_enable blob for 06cb:009a
  - test-validity-fwext.c: 19 unit tests covering all pure functions

Modified files:
  - validity.h: Add cmd_response_status field to FpiDeviceValidity
  - validity.c: Add OPEN_UPLOAD_FWEXT state to open sequence
  - vcsfw_protocol.c: Save status in cmd_receive_cb for RECV states
  - meson.build: Add validity_fwext.c to driver sources

Test results: 34 OK, 0 Fail, 2 Skipped
2026-04-10 22:18:43 +00:00
.ci ci: Add ABI check 2019-08-05 20:05:13 +02:00
.gitlab-ci ci: Add PyGObject symbols 2026-02-10 06:33:00 +01:00
data validity: Add new driver for Validity/Synaptics VCSFW sensors 2026-04-10 22:18:43 +00:00
demo scripts/uncrustify: Use 2-spaces indentation for defines too 2025-02-20 15:50:46 +00:00
doc build: Stop using deprecated dep.get_pkgconfig_variable() method 2024-02-20 01:02:00 +01:00
examples examples/clear-storage: Remove local storage for devices without storage 2025-02-20 16:37:11 +01:00
libfprint validity: Add firmware extension upload (Iteration 3) 2026-04-10 22:18:43 +00:00
scripts scripts/uncrustify: Use 2-spaces indentation for defines too 2025-02-20 15:50:46 +00:00
tests validity: Add firmware extension upload (Iteration 3) 2026-04-10 22:18:43 +00:00
.git-blame-ignore-revs .git-blame-ignore-revs: Ignore formatting commit and add hint how to use it 2020-12-07 19:01:10 +01:00
.gitignore gitignore: Remove autotools ignores, add _build 2020-02-10 11:41:40 +01:00
.gitlab-ci.yml ci: Make jobs interrumpible 2026-02-10 06:35:26 +01:00
AUTHORS AUTHORS: Update 2012-12-14 13:17:24 +01:00
code-of-conduct.md Add code of conduct document 2019-07-25 12:04:39 +02:00
COPYING upekts relicensing 2007-11-15 09:54:35 +00:00
gcovr.cfg gcovr: Add gcovr project configuration 2025-08-01 01:42:01 +02:00
HACKING.md HACKING: Clarify the intent of the license 2019-08-05 13:37:28 +02:00
INSTALL INSTALL: Update for Meson 2018-05-18 01:16:30 +02:00
MAINTAINERS Add MAINTAINERS file 2020-05-22 15:00:11 +02:00
meson.build validity: Add TLS session management (Iteration 2) 2026-04-10 22:18:43 +00:00
meson_options.txt tests: Add support for installed tests 2023-06-28 16:35:16 +02:00
NEWS Release 1.94.10 2026-02-10 03:18:14 +01:00
README.md README: Add contact information 2024-05-03 15:35:11 +02:00
THANKS Thanks to Greg and Martin from AuthenTec 2012-11-29 09:51:55 +01:00

README.md

LibFPrint

LibFPrint is part of the FPrint project.


Button Website Button Documentation

Button Supported Button Unsupported

Button Contribute Button Contributors

History

LibFPrint was originally developed as part of an academic project at the University Of Manchester.

It aimed to hide the differences between consumer fingerprint scanners and provide a single uniform API to application developers.

Goal

The ultimate goal of the FPrint project is to make fingerprint scanners widely and easily usable under common Linux environments.

License

Section 6 of the license states that for compiled works that use this library, such works must include LibFPrint copyright notices alongside the copyright notices for the other parts of the work.

LibFPrint includes code from NIST's NBIS software distribution.

We include Bozorth3 from the US Export Controlled distribution, which we have determined to be fine being shipped in an open source project.

Get in touch

  • IRC - #fprint @ irc.oftc.net
  • Matrix - #fprint:matrix.org bridged to the IRC channel
  • MailingList - low traffic, not much used these days

Badge License