danvics/python-validity
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #50 from Tomcat-42/master

Browse source 
Add waking up from suspend error instructions on README
This commit is contained in:
uunicorn 2021-06-11 15:35:55 +12:00 committed by GitHub
commit 969f56f2a8
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 32 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
README.md
View file

@ -1,6 +1,26 @@
# python-validity
Validity fingerprint sensor driver.
Table of Contents
=================
* [python-validity](#python-validity)
* [Setting up](#setting-up)
* [Error situations](#error-situations)
* [list devices failed ](#list-devices-failed)
* [Errors on startup](#errors-on-startup)
* [Fingerprint not working after waking up from suspend](#fingerprint-not-working-after-waking-up-from-suspend)
* [Enabling fingerprint for system authentication](#enabling-fingerprint-for-system-authentication)
* [The actual change from pam-auth-update](#the-actual-change-from-pam-auth-update)
* [Windows interoperability](#windows-interoperability)
* [Playground](#playground)
* [Initialize a session](#initialize-a-session)
* [Enroll a new user](#enroll-a-new-user)
* [Delete database record (user/finger/whatever)](#delete-database-record-userfingerwhatever)
* [Identify a finger (scan)](#identify-a-finger-scan)
* [DBus service](#dbus-service)
* [Debugging](#debugging)
## Setting up
On Ubuntu system:
@ -31,10 +51,15 @@ $ fprintd-enroll
```
### Error situations
#### List devices failed
If `fprintd-enroll` returns with `list_devices failed:`, you can check
the logs of the `python3-validity` daemon using `$ sudo systemctl status python3-validity`.
If it's not running, you can enable and/or start it by substituting `status` with `enable` or `start`.
#### Errors on startup
It `systemctl status python3-validity` complains about errors on startup, you may need to factory-reset the fingerprint chip. Do that like so:
```
$ sudo systemctl stop python3-validity
@ -51,6 +76,13 @@ $ sudo systemctl start python3-validity
$ fprintd-enroll
```
#### Fingerprint not working after waking up from suspend
Enable *open-fprintd-resume* and *open-fprintd-suspend* services:
```
$ sudo systemctl enable open-fprintd-resume open-fprintd-suspend
```
For even more error procedures, check [this Arch comment thread](https://aur.archlinux.org/packages/python-validity/#comment-755904) or [this python-validity bug comment thread](https://github.com/uunicorn/python-validity/issues/3).
## Enabling fingerprint for system authentication