README: update the paragraph about firmware downloading and extracting

This commit is contained in:
Marco Trevisan (Treviño) 2020-06-10 14:22:22 +02:00
parent e011551526
commit 58b80a5dce

View file

@ -3,22 +3,21 @@ Validity fingerprint sensor library.
Originally designed to capture some of my findings for 138a:0097, but if you manage to get it working for some other Validity sensor - pull requests are welcome.
## Setting up
Use Wine to extract [official Lenovo device driver](https://support.lenovo.com/es/es/downloads/DS120491) (also [part of the SCCM package](https://support.lenovo.com/ec/th/downloads/DS112113)). The only reason you need to do this is to find `6_07f_lenovo_mis.xpfwext` and copy it to this project location.
You can just install that .exe and your file will be in `$WINEPREFIX/drive_c/DRIVERS/WIN/FPR/WBF_Drivers/6_07f_Lenovo.xpfwext` in case you use the device driver, or in
`$WINEPREFIX/drive_c/DRIVERS/SCCM/tp_t460s_*/*/Security/MT7FP22W/6_07f_Lenovo.xpfwext` if you used the SCCM package.
Otherwise just use [innounp](https://sourceforge.net/projects/innounp/files/latest/download) and extract the exe file (`n1cgn08w.exe` in the device driver case or `tp_t460s_*.exe` in the SSCM one) with a command such as:
WINEPREFIX=$XDG_RUNTIME_DIR/tmpwine wine ./innounp.exe -x -e n1cgn08w.exe 6_07f_Lenovo.xpfwext
This file contains firmware and without it the pairing wont work. You will not need wine after this.
To install Python dependencies run
```
$ pip3 install -r requirements.txt
```
## Getting the firmware
It's possible to just extract [official Lenovo device driver for vfs0097](https://support.lenovo.com/us/en/downloads/DS121407) or [driver for vfs0090](https://support.lenovo.com/us/en/downloads/DS120491) (also [part of the SCCM package](https://support.lenovo.com/ec/th/downloads/DS112113) using [innoextract](https://constexpr.org/innoextract/) (available for all the distros), or `wine`.
The only reason you need to do this is to find `6_07f_lenovo_mis.xpfwext` (for vfs0097) or `6_07f_Lenovo.xpfwext` (for vfs0090) and copy it to this project location.
innoextract n1mgf03w.exe -e -I 6_07f_lenovo_mis.xpfwext # vfs0097
innoextract n1cgn08w.exe -e -I 6_07f_Lenovo.xpfwext # vfs0090
## Factory reset
If your device was previously paired with another OS or computer, you need to do a factory reset.
This will erase all fingers from the internal database and make the device ready for pairing.