Skip to content

Releases

v1.1.1 - Goodix GM168 Driver: Reboot Detection & USB Autosuspend Fix

Choose a tag to compare

@shohagranasuvo shohagranasuvo released this 07 Nov 15:14

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() in pam_goodix_verify.py, goodix_daemon.py, and fingerprint_gui.py to automatically correct sysfs power states and retry on transient USB glitches.
  • Debian Package Postinst: Added dynamic sysfs power initialization to .deb package 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)

Choose a tag to compare

@shohagranasuvo shohagranasuvo released this 07 Nov 11:19

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 Linux fprintd Bozorth3 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 and errno=16 (Device or resource busy) contention.
  • Seamless System PAM Integration: Fast, reliable biometric unlock for sudo terminal 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-enroll and 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 bash

Method 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-enroll

Or click Goodix Fingerprint Suite in your application launcher menu.

v1.0.0 - Linux Fingerprint Sensor Solution

Choose a tag to compare

@shohagranasuvo shohagranasuvo released this 05 Nov 22:16

🚀 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_area bounding 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 bash

Debian / 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