Skip to main content

Interface with the adafruit fingerprint r305 module from upper computer over serial connection

Project description


Documentation Status

This library enables you communicate and with the r305 Fingerprint Identification Module via serial connection with upper computer.

The library enables you to to communicate with the r305 fingerprint module from upper computer (your laptop, a raspberry pi etc), rather than the arduino which it was built for by default. The module communicates via TTL, therefore, to communicate you need a USB - TTL converter connected to the module.

It provides a class that exposes methods you can call to perform serial read/write actions with the module, these methods are implemented according to the datasheet specification, which you can download from the repo here.


pip install adafruit-fingerprint

Usage example

There is a section on the docs - hardware section with pictures and explanations on how to setup the hardware needed for these examples to work.

Visit the Examples Codes section on the docs to view all examples.

Development setup


Get started

pip install -r requirements.txt

Running tests

python -m unittest discover tests

Release History

  • 1.0.0
    • Good enough for most use cases


This package is heavily inspired by the finger_sphinx project, found during our search for a way to get the fingerprint template to upper computer, rather than have it stored in flash library. A very big kudos and acknowledgement to the owners.

Faith Odonghanro – @toritsejuFO (twitter), toritsejuFO (github)

Nwanozie Promise – @PNwanozie (twitter), iotstudent (github)

Adegoke Joshua – @iAmCodedebugger (twitter), Ade-Joshe (github)

Distributed under the MIT license. See LICENSE for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adafruit-fingerprint-1.0.0.tar.gz (8.0 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page