解决 ThinkPad T470p Linux 指纹识别故障

在 Linux Mint 22.3 (Python 3.12) 环境下为 ThinkPad T470p (Sensor ID: 138a:0097) 配置指纹识别时，遇到了典型的固件写入报错及匹配失败问题。经过摸索，确认该方案在 T470s/T470p 系列上通用。

---

1. 背景

大多数 Linux 发行版内置的指纹支持库 libfprint 并不直接支持 T470 系列搭载的型号（如 138a:0097）。
为了让指纹跑起来，我找到了 python-validity 项目。 部署后发现存在指纹可以成功录入（Enroll），但在锁屏验证时永远提示“不匹配（Failed to match）”。

第一步：清理环境

首先屏蔽服务：

# 停止并屏蔽服务
sudo systemctl stop python3-validity
sudo systemctl mask python3-validity

第二步：刷入固件

环境清理后，重新执行固件下载与提取脚本：

sudo validity-sensors-firmware

第三步：芯片工厂重置

即使固件刷入成功，仍会遇到“录入成功但匹配失败”的情况。此时需要清空芯片内部状态：

# 执行重置脚本
sudo python3 /usr/share/python-validity/playground/factory-reset.py

第四步：恢复服务

重启后解除屏蔽并启动指纹服务：

sudo systemctl unmask python3-validity.service
sudo systemctl start --now python3-validity.service

经测试，该方法能够解决 ThinkPad T470p 在Linux下运行的指纹识别问题。

---

参考资料：

• GitHub Issue #219: ThinkPad T470s (138a:0097) - Verification fails to match