vitasnay-droid/ft9201-linux
GitHub: vitasnay-droid/ft9201-linux
一个基于 libusb 的 Linux 用户空间 PoC,实现对 FocalTech FT9201 指纹读取器的原始图像帧捕获与协议逆向。
Stars: 0 | Forks: 0
# FT9201 Linux 启动笔记
## 状态
**当前正在工作**
- 设备通过 `libusb` 在 Linux 上打开
- 手指存在轮询正常
- 可以捕获真实的 **64x80 灰度图像帧**
- 捕获协议序列已部分记录
**已确认设备**
- 厂商 ID:`2808`
- 产品 ID:`9338`
- 设备:**FocalTech FT9201 指纹读取器**
**当前范围**
- 仅限用户空间 PoC
- 未集成到 `libfprint`
- 未集成到 PAM / 登录
- 暂无内核驱动
**隐私**
- 本仓库不包含真实的指纹图像
- 本仓库不包含原始的 USB 生物识别捕获数据
## 快速开始
```
sudo systemctl stop fprintd
gcc -O2 -Wall -o ft9201_poc ft9201_poc.c -lusb-1.0
sudo ./ft9201_poc
```
预期行为:
- 空闲状态:`00 43 00 00`
- 检测到手指:`01 43 00 00`
输出文件:
- `frame.raw`
- `frame.pgm`
## 设备
- 厂商 ID:2808
- 产品 ID:9338
- 名称:FocalTech FT9201 指纹读取器
## 当前状态
- Linux 用户空间 PoC 通过 libusb 运行正常
- 成功捕获真实的 64x80 灰度帧
- 观察到的手指检测状态:
- 空闲:00 43 00 00
- 手指存在:01 43 00 00
## 包含内容
- ft9201_poc.c — 最小的用户空间读取器 PoC
- docs/protocol.md — 反向工程的协议笔记
- docs/linux-session.md — 精确的 Linux 测试会话
- docs/windows-capture.md — Windows USB 捕获笔记
## 未包含内容
- 无原始指纹图像
- 无包含生物识别图像负载的公共 USB 捕获
## 目标
将 PoC 转化为可用于上游 libfprint 支持的有用内容。
## 项目跟踪
- [TODO](TODO.md)
- [贡献指南](CONTRIBUTING.md)
标签:64x80, C2日志可视化, FocalTech, frame.pgm, frame.raw, FT9201, gcc编译, grayscale, libusb, PoC, sudo, USB通信, 协议逆向, 命令控制, 图像采集, 客户端加密, 嵌入式, 开发调试, 开源硬件, 指纹设备, 指纹识别, 数据采集, 暴力破解, 生物识别, 用户态驱动, 硬件驱动, 系统服务管理, 设备通信