LibFPrint - CS9711 Driver (Fedora KDE 44+)

This is a fork of libfprint designed to support the Chipsailing CS9711 fingerprint reader. It is maintained to ensure compatibility with Fedora KDE 44 and newer versions.

Overview

This repository provides the libfprint library patched with the CS9711 driver. It is intended for users who need to enable this specific fingerprint reader on Fedora Linux.

Requirements

• OS: Fedora Linux 44 or later (KDE Plasma edition tested, but should work on Workstation).
• Hardware: Chipsailing CS9711 Fingerprint Reader.

Installation

1. Get the Source Code

Start by cloning this repository and navigating into it:

git clone https://github.com/nightcodex7/libfprint-CS9711-fedorakde.git
cd libfprint-CS9711-fedorakde

2. Install Build Dependencies

Open a terminal and install the necessary development packages:

sudo dnf install meson gcc gcc-c++ ninja-build \
    glib2-devel libusb1-devel pixman-devel \
    openssl-devel libgudev-devel libgusb-devel gobject-introspection-devel \
    opencv-devel doctest-devel cmake \
    gtk-doc # (Optional, if you re-enable docs)

3. Build and Install

Run the following commands to compile and install the library:

# Optional: Clean previous build if it exists
rm -rf build

# Setup the build directory
meson setup build --prefix=/usr

# Compile the project
meson compile -C build

# Install to system
sudo meson install -C build

4. Post-Installation

After installation, reload the udev rules and restart the fingerprint daemon:

sudo udevadm control --reload-rules && sudo udevadm trigger
sudo systemctl restart fprintd

Note: The installer automatically compiles and loads a SELinux policy module (fprintd-libfprint) that grants fprintd the permissions it needs to read /proc/sys/vm/nr_hugepages (used by OpenCV at startup). No manual SELinux configuration is required.

You can now register your fingerprint using the KDE System Settings ("Users") or via the command line.

To enroll a specific finger, use the -f flag with the finger name:

# Enroll right index finger (default)
fprintd-enroll -f right-index-finger

# Enroll left index finger
fprintd-enroll -f left-index-finger

Valid finger names:

• right-thumb, right-index-finger, right-middle-finger, right-ring-finger, right-little-finger
• left-thumb, left-index-finger, left-middle-finger, left-ring-finger, left-little-finger

5. Uninstallation

To remove the library from your system:

sudo ninja -C build uninstall

If the build directory no longer exists, manually remove the installed files:

# Remove the shared library
sudo rm -f /usr/lib64/libfprint-2.so* /usr/lib64/libfprint-2.so.2.0.0

# Remove headers
sudo rm -rf /usr/include/libfprint-2

# Remove udev rules
sudo rm -f /usr/lib/udev/rules.d/70-libfprint-2.rules

# Remove udev hwdb entry (if installed)
sudo rm -f /usr/lib/udev/hwdb.d/60-libfprint-autosuspend.hwdb
sudo systemd-hwdb update

# Remove pkg-config and GIR files
sudo rm -f /usr/lib64/pkgconfig/libfprint-2.pc
sudo rm -f /usr/share/gir-1.0/FPrint-2.0.gir
sudo rm -f /usr/lib64/girepository-1.0/FPrint-2.0.typelib

# Remove metainfo
sudo rm -f /usr/share/metainfo/org.freedesktop.libfprint.metainfo.xml

# Remove SELinux policy module
sudo semodule -r fprintd-libfprint 2>/dev/null || true
sudo rm -f /usr/share/libfprint-2/selinux/fprintd-libfprint.pp

# Reload udev and restart fprintd
sudo udevadm control --reload-rules && sudo udevadm trigger
sudo systemctl restart fprintd

License

This project is licensed under the LGPL-2.1+. See the COPYING file for details. LibFPrint includes code from NIST's NBIS software distribution.

Disclaimer

This driver is a community fork. No guarantees are made as to the validity and security of this code. Use at your own risk.

Credits

• Original CS9711 driver by @ddlsmurf.
• LibFPrint project by the freedesktop.org community.