Skip to content

rshcs/Grow-R503-Finger-Print

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

python

licence_mit licence_mit commits

GROW R503 Fingerprint

Fingerprint_sensor


Features

  • Written in pure python.
  • Provides all the manufacturer specified operations of the module.
  • Can be connected with a computer directly with a USB to TTL converter. (Do not need a microcontroller)
  • Can be used for testing the functionality of the module or creating direct applications without involving a microcontroller.

Interfacing

Wiring connections:

Sensor Side RS232 Converter
Red (power) 3.3v Power
White (touch induction power) 3.3v power
Black (Ground) Ground (0v)
Maroon or Green or Brown (Rx) Tx
Yellow (Tx) Rx
Blue (Wakeup) Not connected

Connections (Ref: Datasheet)

  • Make sure to use 3.3v power supply unless you have the 5v version of the sensor.

  • If you use a separate 3.3v power supply other than the RS232 converters power then make sure to connect grounds together (common ground).

  • The line order is according to the colors, even though the note says it's not.


Usb to TTL

rs232_usb

  • This module can be used to interface with the module since it provides 5v to 3.3v conversion for both logic level and power.
  • However, make sure to switch jumper position to the 3.3v and connect 3.3v power pin of the converter.

Installation

Method 1:

  • Run pip install r503 on terminal

Method 2:

  • Run pip install pyserial on terminal.
  • Download r503.py file.
  • Download confirmation_codes.json file.
  • Place downloaded files in the project directory

Basic usage overview


Registering a fingerprint

from r503 import R503

fp = R503(port=5)
fp.manual_enroll(location=8)
  • you have to place the finger 4 (changeable) times on the sensor during the process

Terminal output:

Fingerprint registering


Search a Fingerprint from the stored data

from r503 import R503
from time import sleep

fp = R503(port=5)

print('Place your finger on the sensor..')
sleep(3) # Not required to add this line
print(fp.search())

Terminal output:

Fingerprint matching status

  • first value = success if 0
  • second value = stored location of the memory
  • third value = match score

Number of fingerprints in the memory

from r503 import R503

fp = R503(port=5)
print('Num of templates: ', fp.read_valid_template_num())

Terminal output:

Number of templates


Read fingerprint stored locations

from r503 import R503

fp = R503(port=5)
print(fp.read_index_table())

Terminal output:

Fingerprint stored locations


Delete a fingerprint

from r503 import R503

fp = R503(port=5)
fp.delete_char(6)

Deletes the fingerprint record at given index


Aura LED Control

from r503 import R503

fp = R503(port=5)
fp.led_control(ctrl=3, color=5)

Output: LED keeps on with a specific color according to the number


Read Product Information

from r503 import R503

fp = R503(port=5)

for k, v in fp.read_prod_info_decode().items():
    print(k, ': ', v)

Terminal output:

Info


For Linux users: if a permission error occurs while opening the serial port, run the following command:

sudo chmod a+rw /dev/ttyUSB{your device port number}

Etc:

sudo chmod a+rw /dev/ttyUSB0

References:

About

Python library for R503 sensor.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages