Case study
OMS fingerprint module: reconstructing USB communication for a Linux driver
The OMS fingerprint module investigation reconstructs USB communication with the 33a7:2388 match-on-chip sensor and implements it as a libfprint driver. Its notes describe USBC transport acknowledgements, EF01 frames, checksums and enrollment and identification responses; the author reports successful hardware enrollment and verification.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 2
- Last commit
- 2026-09-12
- Language
- C
- License (GitHub)
- LGPL-2.1
GitHub data as of 2026-11-10
Evidence
- Observed
- Code and documentation observed; no download method or demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: OMS fingerprint module with USB ID 33a7:2388; libfprint 1.94.100 and the listed Meson, Ninja, GCC and library dependencies for the documented build.
- Limits: Keep USB autosuspend disabled for this device.
- Limits: The upstream patch was prepared but had not been submitted.
- License: LGPL-2.1-or-later license.
Cite
BibTeX
@misc{oms-fingerprint-linux-case,
title = {{OMS fingerprint module: reconstructing USB communication for a Linux driver}},
howpublished = {\url{https://github.com/BlueApple233/OMS-fingerprint-linux}},
url = {https://github.com/BlueApple233/OMS-fingerprint-linux},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/oms-fingerprint-linux-case/}}
}Plain text
OMS fingerprint module: reconstructing USB communication for a Linux driver. https://github.com/BlueApple233/OMS-fingerprint-linux (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/oms-fingerprint-linux-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · BlueApple233/OMS-fingerprint-linux · Revision fc0d55b
- driver/README.md GitHub · BlueApple233/OMS-fingerprint-linux · Revision fc0d55b
More in Protocols
- zwift-api: mapping Zwift's private data endpoints · Case study
- Gear VR Controller: decoding Samsung's BLE remote protocol · Case study
- Acer Predator Helios 16: reconstructing Linux lighting control · Case study
- Powerology AM8268N: reconstructing a USB display protocol for Linux · Case study
- SuperCam Thermal Viewer: reconstructing QuanLi camera streaming · Case study
- ktctl: reconstructing FiiO JA11 USB equalizer control · Case study