Repository navigation
Releases
v1.1.1 - Goodix GM168 Driver: Reboot Detection & USB Autosuspend Fix
What's Changed in v1.1.1:
- Persistent Reboot Detection: Fixed an issue where the Goodix GM168 sensor was not detected or failed to initialize after system restart due to Linux kernel USB autosuspend (
power/control='auto', 2-second timeout). - Persistent Udev Rule: Added
TEST=="power/control", ATTR{power/control}="on", TEST=="power/autosuspend", ATTR{power/autosuspend}="-1", TEST=="power/persist", ATTR{power/persist}="1"to keep the USB controller awake across system reboots and hotplugs. - Dynamic Self-Healing: Added
heal_usb_power_state()inpam_goodix_verify.py,goodix_daemon.py, andfingerprint_gui.pyto automatically correct sysfs power states and retry on transient USB glitches. - Debian Package Postinst: Added dynamic sysfs power initialization to
.debpackage installer.
Verification:
Tested and verified on Xiaomi RedmiBook Pro 14S (27c6:581a) running Ubuntu 26.04.
v1.1.0 - Goodix GM168 Linux Biometric Suite (Stable Release)
Goodix GM168 Linux Biometric Driver & DRFM Suite — Release v1.1.0 (Stable)
Production-ready Linux biometric driver, PAM authentication stack, and modern GTK4 management suite for Goodix GM168 (27c6:581a / 27c6:589a) fingerprint sensors found in Xiaomi RedmiBook Pro 14S / 15 and Mi NoteBook Ultra.
🌟 What's New in v1.1.0
- Zero-FAR Windows Hello Enclave Parity: Implements our reverse-engineered Dense Ridge-Flow Matcher (DRFM) and Adaptive Template Learning (
gx_templateStudy) to completely replace the broken standard LinuxfprintdBozorth3 algorithm. - 16-Stage Multi-Zone Guided Enrollment:
- Full support for 4 anatomical finger zones: Center Pad, Fingertip, Left Edge, and Right Edge.
- Built-in 1.8-second finger-lift reset interval with intuitive visual cues, ensuring clean capacitive baseline calibration between stages.
- Robust Hardware Concurrency: Cross-process hardware mutex locking (
/run/goodix_sensor.lock) to eliminate USB bus resets anderrno=16 (Device or resource busy)contention. - Seamless System PAM Integration: Fast, reliable biometric unlock for
sudoterminal commands, lock screen (Super + L), and GDM / system login. - Multi-Ubuntu ABI Compatibility: Seamless out-of-the-box compatibility across Ubuntu 22.04 LTS, 24.04 LTS, 24.10, and 26.04 (Resolute).
- User Convenience: Added terminal CLI command
goodix-enrolland Desktop application launcher.
📦 Quick Installation
Method 1: Automated One-Liner (Recommended)
curl -fsSL https://raw.githubusercontent.com/shohagranasuvo/linux-fingerprint-sensor-solution/main/install.sh | sudo bashMethod 2: Install via Debian (.deb) Package
Download goodix-gm168-linux-driver_1.1.0_amd64.deb below and run:
sudo dpkg -i goodix-gm168-linux-driver_1.1.0_amd64.deb
sudo apt-get install -f🚀 Getting Started
Launch the application by running:
goodix-enrollOr click Goodix Fingerprint Suite in your application launcher menu.
v1.0.0 - Linux Fingerprint Sensor Solution
🚀 Linux Fingerprint Sensor Solution v1.0.0
First official release of the Linux Fingerprint Sensor Solution, a native driver, PAM biometric authentication module, and GTK3 management suite for Goodix GM168 (27c6:581a, 27c6:589a) capacitive fingerprint sensors found in Xiaomi RedmiBook Pro 14S / 15 and Xiaomi Mi NoteBook Ultra laptops.
✨ Key Features
- Dense Ridge-Flow Matcher (DRFM): Replaces broken Bozorth3 with a 2D affine RANSAC ridge-flow matcher tailored for compact 80x64 sensor matrices.
- Windows Hello Enclave Parity: Reverse-engineered from official Goodix Windows 11 drivers (
GoodixEngineAdapter.dll&AdapterEnclave.signed.dll). - Zero-FAR Security Verification Gates: Multi-octave physical spatial deduplication,
valid_areabounding spread (>= 12%), rigid skin scale bounds (0.92 - 1.08), and dense ridge patch Normalized Cross-Correlation (NCC >= 0.28). - Linux PAM System Authentication: Passwordless
sudo, lock screen (Super + L), and desktop login. - Adaptive Template Study (
gx_templateStudy): Dynamically refines enrolled templates over time for changes in skin moisture and seasonal variations. - Modern GTK3 Biometric Suite GUI: Real-time sensor preview, 16-stage multi-angle enrollment wizard, and live telemetry monitor.
📦 Installation
Quick One-Line Install:
curl -fsSL https://raw.githubusercontent.com/shohagranasuvo/linux-fingerprint-sensor-solution/main/install.sh | sudo bashDebian / Ubuntu Package:
Download goodix-gm168-linux-driver_1.0.0_amd64.deb below and run:
sudo dpkg -i goodix-gm168-linux-driver_1.0.0_amd64.deb
sudo apt-get install -f