GTR9 Pro fingerprint reader now works on Linux (open driver)

OMGrant · 2026-07-16T03:16:55+00:00

The GTR9 Pro ships an EgisTec EH577 fingerprint reader (1c7a:0577) that, until now, only worked with Windows Hello. I wrote an open Linux driver for it. It enrolls, verifies, and unlocks KDE on the real sensor. Why it needed a custom driver: the sensor is tiny, 70×57 pixels. libfprint’s built-in matcher does a poor job on an image that small, and generic approaches (phase correlation, SIFT-based matching) hit a false-accept wall at that scale. So instead of matching in the open-source stack, the driver reuses EgisTec’s own matching engine, the one from their signed Windows driver, and runs it natively on Linux. A couple of things people usually ask about: It runs under fprintd’s normal hardening. No disabling MemoryDenyWriteExecute, and it stays inside SELinux confinement (no execmem). You don’t have to loosen anything. It contains no proprietary binaries. You fetch EgisTec’s engine DLL from the Microsoft Update Catalog through the build script and the build adapts it locally, same idea as the ttf-mscorefonts-installer package. The driver code is LGPL-2.1. Setup is one script, bash setup.sh, which clones and builds everything; uninstall is fully reversible. Repo: github.com/OMGrant/eh577-libfprint

Achimd1

Beelink CS-Ian Chan
Hello Ian,
now it stucks here…
a never ending story

❯ rm -rf ~/eh577-libfprint

~
❯ git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
Klone nach ‘/home/achimd/eh577-libfprint’…
remote: Enumerating objects: 114, done.
remote: Counting objects: 100% (114/114), done.
remote: Compressing objects: 100% (85/85), done.
remote: Total 114 (delta 56), reused 83 (delta 28), pack-reused 0 (from 0)
Empfange Objekte: 100% (114/114), 622.73 KiB | 8.90 MiB/s, fertig.
Löse Unterschiede auf: 100% (56/56), fertig.

~
❯ cd ~/eh577-libfprint

~/eh577-libfprint main

❯ bash setup.sh clean

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

Do you own an EH577 (1c7a:0577) device and want to proceed? [y/N] y
==> checking prerequisites
==> [¼] downloading the vendor matcher from Microsoft Update Catalog
==> resolving download URL from Microsoft Update Catalog (updateID 3b1a2465-bcea-430a-9da5-88f690ff39b1)
https://catalog.s.download.windowsupdate.com/c/msdownload/update/driver/drvs/2019/01/e87e1b0b-7dbc-4414-bfc0-e943862c7164_dd784a9bddcf1302c6a73b11e56f6b7449fc48d8.cab
==> downloading the driver package (.cab) from Microsoft
==> extracting EgisTouchFPEngine0577.dll
==> verifying checksum (must match the pinned official copy)
OK: wrote windows-driver/EgisTouchFPEngine0577.dll (411112 bytes, sha256 verified against the pinned official package)
==> [2/4] building the matcher engine (.so) from your downloaded copy
[gen] WARN patch rva 0×1a80e: unexpected bytes 00 90
[gen] WARN patch rva 0×1a821: unexpected bytes 89 4c
[gen] wrote egimage.bin: 442368 bytes (sizeofimage), hdrsize=1024 nsec=6
built eh577-engine.so (556560 bytes)

INSTALL (root): place the .so where fprintd can reach it and LABEL it a shared library
install -Dm0755 eh577-engine.so /usr/lib/libfprint-2/eh577-engine.so
semanage fcontext -a -t textrel_shlib_t ‘/usr/lib/libfprint-2/eh577-engine.so’
restorecon -v /usr/lib/libfprint-2/eh577-engine.so
The eh577 libfprint driver dlopen()s this .so instead of memfd-loading the PE.
==> [¾] building libfprint + the eh577 driver (side-by-side; distro libfprint untouched)
==> cloning upstream libfprint @ v1.94.10
Klone nach ‘libfprint’…
remote: Enumerating objects: 389, done.
remote: Counting objects: 100% (389/389), done.
remote: Compressing objects: 100% (347/347), done.
remote: Total 389 (delta 73), reused 202 (delta 35), pack-reused 0 (from 0)
Empfange Objekte: 100% (389/389), 8.46 MiB | 29.06 MiB/s, fertig.
Löse Unterschiede auf: 100% (73/73), fertig.
Warnung: refs/tags/v1.94.10 5e081645390be9265af660d2454f7f40a2cea183 ist kein Commit!
Hinweis: Wechsle zu ‘0c97a47d8ef405cd577b87058c1e89cae9d242e7’.

Sie befinden sich im Zustand eines ‘losgelösten HEAD’. Sie können sich
umschauen, experimentelle Änderungen vornehmen und diese committen, und
Sie können alle möglichen Commits, die Sie in diesem Zustand machen,
ohne Auswirkungen auf irgendeinen Branch verwerfen, indem Sie zu einem
anderen Branch wechseln.

Wenn Sie einen neuen Branch erstellen möchten, um Ihre erstellten Commits
zu behalten, können Sie das (jetzt oder später) durch Nutzung von
‘switch’ mit der Option -c tun. Beispiel:

git switch -c <neuer-Branchname>

Oder um diese Operation rückgängig zu machen:
git switch -

Sie können diesen Hinweis ausschalten, indem Sie die Konfigurationsvariable
‘advice.detachedHead’ auf ‘false’ setzen.

==> installing driver files into the tree
==> registering the driver in meson
injected eh577 into driver_sources
==> configuring + building (only the eh577 driver)

~/eh577-libfprint main 6s

❯ bash setup.sh

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

~/eh577-libfprint main
❯ sudo pacman -S –needed git base-devel meson ninja pkgconf glib2 libgusb opencv openssl fprintd imagemagick
[sudo] Passwort für achimd:
Warnung: git-2.55.0-1.1 ist aktuell – Überspringe
Warnung: base-devel-1-2 ist aktuell – Überspringe
Warnung: meson-1.12.0-1 ist aktuell – Überspringe
Warnung: ninja-1.13.2-3.1 ist aktuell – Überspringe
Warnung: pkgconf-3.0.5-1.1 ist aktuell – Überspringe
Warnung: glib2-2.88.3-1.1 ist aktuell – Überspringe
Warnung: libgusb-0.4.9-2.1 ist aktuell – Überspringe
Warnung: opencv-5.0.0-9.1 ist aktuell – Überspringe
Warnung: openssl-3.6.3-1.1 ist aktuell – Überspringe
Warnung: fprintd-1.94.5-2.1 ist aktuell – Überspringe
Warnung: imagemagick-7.1.2.30-1.1 ist aktuell – Überspringe
Es gibt nichts zu tun

~/eh577-libfprint main
❯ rm -rf ~/eh577-libfprint

~/eh577-libfprint
❯ git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
Klone nach ‘/home/achimd/eh577-libfprint’…
Schwerwiegend: Konnte aktuelles Arbeitsverzeichnis nicht lesen.: Datei oder Verzeichnis nicht gefunden
Schwerwiegend: remote helper ‘https’ aborted session

~/eh577-libfprint
❯ cd ..

~
❯ git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
Klone nach ‘/home/achimd/eh577-libfprint’…
remote: Enumerating objects: 114, done.
remote: Counting objects: 100% (114/114), done.
remote: Compressing objects: 100% (85/85), done.
remote: Total 114 (delta 56), reused 83 (delta 28), pack-reused 0 (from 0)
Empfange Objekte: 100% (114/114), 622.73 KiB | 11.12 MiB/s, fertig.
Löse Unterschiede auf: 100% (56/56), fertig.

~
❯ cd ~/eh577-libfprint

~/eh577-libfprint main

❯ bash setup.sh clean

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

INSTALL (root): place the .so where fprintd can reach it and LABEL it a shared library
install -Dm0755 eh577-engine.so /usr/lib/libfprint-2/eh577-engine.so
semanage fcontext -a -t textrel_shlib_t ‘/usr/lib/libfprint-2/eh577-engine.so’
restorecon -v /usr/lib/libfprint-2/eh577-engine.so
The eh577 libfprint driver dlopen()s this .so instead of memfd-loading the PE.
==> [¾] building libfprint + the eh577 driver (side-by-side; distro libfprint untouched)
==> cloning upstream libfprint @ v1.94.10
Klone nach ‘libfprint’…
remote: Enumerating objects: 389, done.
remote: Counting objects: 100% (389/389), done.
remote: Compressing objects: 100% (347/347), done.
remote: Total 389 (delta 73), reused 202 (delta 35), pack-reused 0 (from 0)
Empfange Objekte: 100% (389/389), 8.46 MiB | 33.18 MiB/s, fertig.
Löse Unterschiede auf: 100% (73/73), fertig.
Warnung: refs/tags/v1.94.10 5e081645390be9265af660d2454f7f40a2cea183 ist kein Commit!
Hinweis: Wechsle zu ‘0c97a47d8ef405cd577b87058c1e89cae9d242e7’.

Wenn Sie einen neuen Branch erstellen möchten, um Ihre erstellten Commits
zu behalten, können Sie das (jetzt oder später) durch Nutzung von
‘switch’ mit der Option -c tun. Beispiel:

git switch -c <neuer-Branchname>

Oder um diese Operation rückgängig zu machen:
git switch -

Sie können diesen Hinweis ausschalten, indem Sie die Konfigurationsvariable
‘advice.detachedHead’ auf ‘false’ setzen.

==> installing driver files into the tree
==> registering the driver in meson
injected eh577 into driver_sources
==> configuring + building (only the eh577 driver)

~/eh577-libfprint main 6s

❯ bash setup.sh

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

~/eh577-libfprint main
❯ sudo tee /etc/udev/rules.d/60-egis-eh577.rules <<‘EOF’
SUBSYSTEM==“usb”, ATTRS{idVendor}==“1c7a”, ATTRS{idProduct}==“0577”, MODE=“0664”, GROUP=“input”, TAG+=“systemd”
EOF
fish: Erwartete a string, aber fand a redirection
sudo tee /etc/udev/rules.d/60-egis-eh577.rules <<‘EOF’
^
~/eh577-libfprint main
❯ sudo tee /etc/udev/rules.d/60-egis-eh577.rules <<‘EOF’
SUBSYSTEM==“usb”, ATTRS{idVendor}==“1c7a”, ATTRS{idProduct}==“0577”, MODE=“0664”, GROUP=“input”, TAG+=“systemd”
EOF
fish: Erwartete a string, aber fand a redirection
sudo tee /etc/udev/rules.d/60-egis-eh577.rules <<‘EOF’
^
~/eh577-libfprint main
❯ sudo tee /etc/udev/rules.d/60-egis-eh577.rules <<‘EOF’
SUBSYSTEM==“usb”, ATTRS{idVendor}==“1c7a”, ATTRS{idProduct}==“0577”, MODE=“0664”, GROUP=“input”, TAG+=“systemd”
EOF

Beelink CS-Ian Chan

Achimd1
Hi Achim,

Sorry for the matter , i am trying to fix it for you .

The build/compilation part has succeeded. The error you see fish: Expected a string, but found a redirection happens because you are using the Fish shell. The <<'EOF' here‑document syntax is bash‑specific and will not work inside Fish terminal

Please use one of these two methods to create the udev rule file:

Option 1: Use nano editor (recommended, simplest)

sudo nano /etc/udev/rules.d/60-egis-eh577.rules

Paste exactly this one single line into nano:

SUBSYSTEM=="usb", ATTRS{idVendor}=="1c7a", ATTRS{idProduct}=="0577", MODE="0664", GROUP="input", TAG+="systemd"

Save file: press Ctrl+O, press Enter, then Ctrl+X to exit nano.

Then continue run these commands:

sudo udevadm control --reload-rules
sudo udevadm trigger
sudo usermod -aG input $USER
sudo systemctl enable --now fprintd
sudo systemctl restart fprintd

Option 2: Wrap command inside bash‑c (run directly in Fish)

sudo bash -c 'echo SUBSYSTEM=="usb", ATTRS{idVendor}=="1c7a", ATTRS{idProduct}=="0577", MODE="0664", GROUP="input", TAG+="systemd" > /etc/udev/rules.d/60‑egis‑eh577.rules'

After finishing above steps:

Log out your user account and log back in (full reboot is also okay).
Run check command:

lsusb | grep 1c7a:0577
fprintd-list $USER

If fprintd‑list still reports no devices available, stop service and collect debug log:

sudo systemctl stop fprintd
sudo fprintd -v

Share the full verbose output with me.

Achimd1

Beelink CS-Ian Chan
Hi Ian,
here my last results:

❯ sudo udevadm control –reload-rules
[sudo] Passwort für achimd:

~
❯ sudo udevadm trigger

~
❯ sudo usermod -aG input achimd

~
❯ sudo systemctl enable –now fprintd
The unit files have no installation config (WantedBy=, RequiredBy=, UpheldBy=,
Also=, or Alias= settings in the [Install] section, and DefaultInstance= for
template units). This means they are not meant to be enabled or disabled using systemctl.

Possible reasons for having these kinds of units are:
• A unit may be statically enabled by being symlinked from another unit’s
.wants/, .requires/, or .upholds/ directory.
• A unit’s purpose may be to act as a helper for some other unit which has
a requirement dependency on it.
• A unit may be started when needed via activation (socket, path, timer,
D-Bus, udev, scripted systemctl call, …).
• In case of template units, the unit is meant to be enabled with some
instance name specified.

~
❯ systemctl status fprintd
○ fprintd.service - Fingerprint Authentication Daemon
Loaded: loaded (/usr/lib/systemd/system/fprintd.service; static)
Active: inactive (dead)
Docs: man:fprintd(1)

Aug 26 21:53:16 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 21:53:46 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.
Aug 26 22:01:50 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:01:50 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 22:02:08 cachyos-x8664 systemd[1]: Stopping Fingerprint Authentication Daemon…
Aug 26 22:02:08 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.
Aug 26 22:02:08 cachyos-x8664 systemd[1]: Stopped Fingerprint Authentication Daemon.
Aug 26 22:07:27 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:07:27 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 22:07:58 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.

~
❯ sudo systemctl start fprintd

~
❯ systemctl status fprintd
● fprintd.service - Fingerprint Authentication Daemon
Loaded: loaded (/usr/lib/systemd/system/fprintd.service; static)
Active: active (running) since Wed 2026-08-26 22:11:12 CEST; 10s ago
Invocation: 0a4bfff0b25140179c82cb5ca1966382
Docs: man:fprintd(1)
Main PID: 14161 (fprintd)
Tasks: 6 (limit: 76641)
Memory: 5.4M (peak: 5.7M)
CPU: 46ms
CGroup: /system.slice/fprintd.service
└─14161 /usr/lib/fprintd

Aug 26 22:11:12 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:11:12 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.

~
❯ sudo systemctl restart fprintd

~
❯ systemctl status fprintd
● fprintd.service - Fingerprint Authentication Daemon
Loaded: loaded (/usr/lib/systemd/system/fprintd.service; static)
Active: active (running) since Wed 2026-08-26 22:11:57 CEST; 11s ago
Invocation: 07380aa836ec4d08bac43032eefe8a72
Docs: man:fprintd(1)
Main PID: 14216 (fprintd)
Tasks: 6 (limit: 76641)
Memory: 4.9M (peak: 5.4M)
CPU: 45ms
CGroup: /system.slice/fprintd.service
└─14216 /usr/lib/fprintd

Aug 26 22:11:57 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:11:57 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.

~
then i make a reboot

Achimd1

Then i execute the next Steps:

❯ lsusb | grep 1c7a:0577
Bus 003 Device 003: ID 1c7a:0577 LighTuning Technology Inc. Fingerprint Sensor

~
❯ fprintd-list achimd
No devices available

~
❯ sudo systemctl stop fprintd
[sudo] Passwort für achimd:

~
❯ systemctl status fprintd
○ fprintd.service - Fingerprint Authentication Daemon
Loaded: loaded (/usr/lib/systemd/system/fprintd.service; static)
Active: inactive (dead)
Docs: man:fprintd(1)

Aug 26 22:20:28 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 22:20:58 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.
Aug 26 22:22:04 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:22:04 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 22:22:34 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.
Aug 26 22:22:38 cachyos-x8664 systemd[1]: Starting Fingerprint Authentication Daemon…
Aug 26 22:22:38 cachyos-x8664 systemd[1]: Started Fingerprint Authentication Daemon.
Aug 26 22:23:02 cachyos-x8664 systemd[1]: Stopping Fingerprint Authentication Daemon…
Aug 26 22:23:02 cachyos-x8664 systemd[1]: fprintd.service: Deactivated successfully.
Aug 26 22:23:02 cachyos-x8664 systemd[1]: Stopped Fingerprint Authentication Daemon.

~
❯ sudo fprintd -v
sudo: fprintd: Befehl nicht gefunden

Beelink CS-Ian Chan

Achimd1 Hi , There

This is for the issue: lsusb can detect 1c7a:0577, but fprintd-list returns “No devices available”, and fprintd is located at /usr/libexec/fprintd instead of /usr/bin/fprintd.
The core problem: the official system libfprint package remains installed and takes priority; it does not support the EH577 sensor. Also, Fish shell cannot handle <<'EOF' syntax, so we use nano to create the udev rule.

#1. Remove the system libfprint package
sudo pacman -R libfprint

#2. Create udev rule via nano
sudo nano /etc/udev/rules.d/60-egis-eh577.rules

Paste this line into the file:

SUBSYSTEM=="usb", ATTRS{idVendor}=="1c7a", ATTRS{idProduct}=="0577", MODE="0664", GROUP="input", TAG+="systemd"

Ctrl+O to save, Ctrl+X to exit nano.

#3. Reload udev rules and add user to input group
sudo udevadm control --reload-rules
sudo udevadm trigger
sudo usermod -aG input $USER

#4. Clean rebuild eh577-libfprint driver
rm -rf ~/eh577-libfprint
git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
cd ~/eh577-libfprint
bash setup.sh clean
bash setup.sh

#5. Refresh system library cache (critical step)
sudo ldconfig

#6. Restart fprintd service (it is static, do NOT enable it)
sudo systemctl stop fprintd
sudo systemctl start fprintd

#7. Reboot
reboot

After reboot, test:

lsusb | grep 1c7a:0577
fprintd-list $USER

If it still shows no device, run debug with full path and share output:

sudo systemctl stop fprintd
sudo /usr/libexec/fprintd -v
journalctl -u fprintd -b --no-pager

Important notes:

Do not run systemctl enable fprintd, the service is static.
Avoid <<'EOF' syntax in Fish shell, use nano for rule files.
Uninstalling distro libfprint is mandatory.
Run sudo ldconfig after compiling the custom driver.

Achimd1

Hell Ian,
it stucks again, because no fprintd service not found!

/etc/udev/rules.d
❯ sudo nano /etc/udev/rules.d/60-egis-eh577.rules

/etc/udev/rules.d 28s
❯ sudo udevadm control –reload-rules

/etc/udev/rules.d
❯ sudo udevadm trigger

/etc/udev/rules.d
❯ sudo usermod -aG input achimd

/etc/udev/rules.d
❯ rm -rf ~/eh577-libfprint

/etc/udev/rules.d
❯ git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
Klone nach ‘/home/achimd/eh577-libfprint’…
remote: Enumerating objects: 114, done.
remote: Counting objects: 100% (114/114), done.
remote: Compressing objects: 100% (85/85), done.
remote: Total 114 (delta 56), reused 83 (delta 28), pack-reused 0 (from 0)
Empfange Objekte: 100% (114/114), 622.73 KiB | 10.04 MiB/s, fertig.
Löse Unterschiede auf: 100% (56/56), fertig.

/etc/udev/rules.d
❯ cd ..

/etc/udev
❯ cd ..

/etc
❯ cd ..

/
❯ cd ~/eh577-libfprint

~/eh577-libfprint main

❯ bash setup.sh clean

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

INSTALL (root): place the .so where fprintd can reach it and LABEL it a shared library
install -Dm0755 eh577-engine.so /usr/lib/libfprint-2/eh577-engine.so
semanage fcontext -a -t textrel_shlib_t ‘/usr/lib/libfprint-2/eh577-engine.so’
restorecon -v /usr/lib/libfprint-2/eh577-engine.so
The eh577 libfprint driver dlopen()s this .so instead of memfd-loading the PE.
==> [¾] building libfprint + the eh577 driver (side-by-side; distro libfprint untouched)
==> cloning upstream libfprint @ v1.94.10
Klone nach ‘libfprint’…
remote: Enumerating objects: 389, done.
remote: Counting objects: 100% (389/389), done.
remote: Compressing objects: 100% (347/347), done.
remote: Total 389 (delta 73), reused 202 (delta 35), pack-reused 0 (from 0)
Empfange Objekte: 100% (389/389), 8.46 MiB | 37.48 MiB/s, fertig.
Löse Unterschiede auf: 100% (73/73), fertig.
Warnung: refs/tags/v1.94.10 5e081645390be9265af660d2454f7f40a2cea183 ist kein Commit!
Hinweis: Wechsle zu ‘0c97a47d8ef405cd577b87058c1e89cae9d242e7’.

Wenn Sie einen neuen Branch erstellen möchten, um Ihre erstellten Commits
zu behalten, können Sie das (jetzt oder später) durch Nutzung von
‘switch’ mit der Option -c tun. Beispiel:

git switch -c <neuer-Branchname>

Oder um diese Operation rückgängig zu machen:
git switch -

Sie können diesen Hinweis ausschalten, indem Sie die Konfigurationsvariable
‘advice.detachedHead’ auf ‘false’ setzen.

==> installing driver files into the tree
==> registering the driver in meson
injected eh577 into driver_sources
==> configuring + building (only the eh577 driver)

~/eh577-libfprint main 7s

❯ bash setup.sh

EH577 fingerprint driver — build & install
Fetches the EgisTec EH577 driver from Microsoft’s official Update Catalog
(your own licensed copy) and builds a native Linux driver around its matcher.

No EgisTec code is bundled or redistributed by this project.

~/eh577-libfprint main
❯ sudo ldconfig

~/eh577-libfprint main
❯ sudo systemctl stop fprintd
Failed to stop fprintd.service: Unit fprintd.service not loaded.

~/eh577-libfprint main
❯ sudo systemctl start fprintd
Failed to start fprintd.service: Unit fprintd.service not found.

~/eh577-libfprint main
❯

Beelink CS-Ian Chan

Achimd1 Hi Achim,

Got it, I can see what went wrong. On Arch/CachyOS, fprintd package depends on libfprint. When you ran sudo pacman -R libfprint, it removed the official fprintd package together with its systemd unit file — that is why you get Unit fprintd.service not foundGitHub Gis….

Our setup.sh only builds and installs the custom libfprint‑2 driver plugin (eh577-engine.so). It does NOT build or supply the fprintd daemon binary nor the systemd service file. So we still need the distro fprintd package, but we must keep its stock libfprint library out of the picture.

Let’s revert and fix step‑by‑step (run these inside Fish shell):

# 1. Re‑install official fprintd (brings back the systemd service unit)
sudo pacman -S --needed fprintd

# 2. Keep libfprint package removed! Do NOT install distro libfprint, it conflicts.
# Check: this should return exit non‑zero
pacman -Q libfprint

# 3. Verify our custom engine plugin is present
ls -la /usr/lib/libfprint-2/eh577-engine.so

If /usr/lib/libfprint-2/eh577-engine.so is missing, rebuild the driver:

rm -rf ~/eh577-libfprint
git clone https://github.com/OMGrant/eh577-libfprint.git ~/eh577-libfprint
cd ~/eh577-libfprint
bash setup.sh clean
bash setup.sh
sudo ldconfig

Confirm your udev rule is correct:

cat /etc/udev/rules.d/60-egis-eh577.rules

Content must be exactly:

SUBSYSTEM=="usb", ATTRS{idVendor}=="1c7a", ATTRS{idProduct}=="0577", MODE="0664", GROUP="input", TAG+="systemd"

Reload udev:

sudo udevadm control --reload-rules
sudo udevadm trigger
sudo usermod -aG input $USER

Important: log out completely and log back in for group permission change to take effect. Reboot is fine too.

After logout/login:

# fprintd is static service; just start it, do not enable it
sudo systemctl start fprintd

# Check hardware is detected
lsusb | grep 1c7a:0577

# Test device enumeration
fprintd-list $USER

If you still get No devices available, stop service and capture full debug output:

sudo systemctl stop fprintd
sudo /usr/libexec/fprintd -v

Please paste all verbose output from sudo /usr/libexec/fprintd -v.

Also double‑check:

DO NOT install libfprint from official repos.
The eh577-engine.so must exist under /usr/lib/libfprint-2/.
Fish shell: avoid bash‑style <<'EOF' heredocs, always use nano to write udev rules.

Let me know how it goes.

Achimd1

Hi Ian,
I think we’re going in circles here; one time de-staling the system-side libfprint, then reinstalling it, there’s no progress here, in my opinion at the moment; even with an embedded .dll file (EgisTouchFP0577.dll) from 2022 it doesn’t work! Perhaps someone has already successfully got the fingerprint reader working? Perhaps with a simpler solution? Then he or she should announce it here. For my part, I’m giving up for now. Sorry about that.

Beelink CS-Ian Chan

Achimd1
Hi , There
Sorry for the matter again .
I will need to confirm with my colleague for further solution.
Will get back to you soon.

« Previous Page