# GROW R503 Fingerprint
---
### 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|
(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
* 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
* `pip install r503` on terminal.
or
* Run `pip install pyserial` on terminal.
* Download **r503.py** file.
### 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:
---
#### 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:
* 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:
---
#### Read fingerprint stored locations
from r503 import R503
fp = R503(port=5)
print(fp.read_index_table())
Terminal output:
---
#### 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:
---
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`
Raw data
{
"_id": null,
"home_page": "https://github.com/rshcs/Grow-R503-Finger-Print",
"name": "r503",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,fingerprint,security,grow,r503,password",
"author": "RoshanCS",
"author_email": "<roshan.cs790@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/88/af/038cd5cd9abce6a64019f7f00f920426b28c95ababc2dd5ef8f6ce7bed27/r503-0.0.4.tar.gz",
"platform": null,
"description": "\r\n\r\n\r\n\r\n\r\n\r\n\r\n# GROW R503 Fingerprint \r\n\r\n\r\n\r\n---\r\n\r\n### Features\r\n\r\n* Written in pure python.\r\n* Provides all the manufacturer specified operations of the module.\r\n* Can be connected with a computer directly with a USB to TTL converter. (Do not need a microcontroller)\r\n* Can be used for testing the functionality of the module or creating direct applications without involving a microcontroller.\r\n\r\n---\r\n\r\n### Interfacing\r\n#### Wiring connections:\r\n\r\n|Sensor Side|RS232 Converter|\r\n|---|---|\r\n|Red (power)|3.3v Power|\r\n|White (touch induction power)|3.3v power|\r\n|Black (Ground)|Ground (0v)|\r\n|Maroon or Green or Brown (Rx)|Tx|\r\n|Yellow (Tx)|Rx|\r\n|Blue (Wakeup)|Not connected|\r\n\r\n\r\n(Ref: Datasheet)\r\n\r\n* **Make sure to use 3.3v power supply unless you have the 5v version of the sensor.**\r\n\r\n* If you use a separate 3.3v power supply other than the RS232 converters power then make sure to connect grounds together (common ground).\r\n\r\n* The line order is according to the colors, even though the note says it's not.\r\n\r\n--- \r\n\r\n#### Usb to TTL\r\n\r\n* This module can be used to interface with the module since it provides 5v to 3.3v conversion for both logic level and power.\r\n* However, make sure to switch jumper position to the 3.3v and connect 3.3v power pin of the converter.\r\n\r\n---\r\n\r\n### Installation\r\n* `pip install r503` on terminal.\r\n\r\nor\r\n\r\n* Run `pip install pyserial` on terminal.\r\n\r\n* Download **r503.py** file.\r\n\r\n### Basic usage overview\r\n\r\n---\r\n#### Registering a fingerprint\r\n\r\n from r503 import R503\r\n\r\n fp = R503(port=5)\r\n fp.manual_enroll(location=8)\r\n\r\n* you have to place the finger 4 (changeable) times on the sensor during the process\r\n\r\nTerminal output:\r\n\r\n\r\n\r\n---\r\n\r\n#### Search a Fingerprint from the stored data\r\n\r\n from r503 import R503\r\n from time import sleep\r\n \r\n fp = R503(port=5)\r\n \r\n print('Place your finger on the sensor..')\r\n sleep(3) # Not required to add this line\r\n print(fp.search())\r\n\r\nTerminal output:\r\n\r\n\r\n\r\n* first value = success if 0\r\n* second value = stored location of the memory\r\n* third value = match score\r\n\r\n---\r\n\r\nNumber of fingerprints in the memory\r\n\r\n from r503 import R503\r\n \r\n fp = R503(port=5)\r\n print('Num of templates: ', fp.read_valid_template_num())\r\n\r\nTerminal output:\r\n\r\n\r\n\r\n---\r\n#### Read fingerprint stored locations\r\n\r\n from r503 import R503\r\n \r\n fp = R503(port=5)\r\n print(fp.read_index_table())\r\n\r\nTerminal output:\r\n\r\n\r\n\r\n---\r\n\r\n#### Aura LED Control\r\n\r\n from r503 import R503\r\n \r\n fp = R503(port=5)\r\n fp.led_control(ctrl=3, color=5)\r\n\r\nOutput: LED keeps on with a specific color according to the number\r\n\r\n---\r\n#### Read Product Information\r\n\r\n from r503 import R503\r\n \r\n fp = R503(port=5)\r\n\r\n for k, v in fp.read_prod_info_decode().items():\r\n print(k, ': ', v)\r\n\r\nTerminal output:\r\n\r\n\r\n\r\n---\r\n\r\nFor Linux users: if a permission error occurs while opening the serial port, run the following command:\r\n\r\n`sudo chmod a+rw /dev/ttyUSB{your device port number}`\r\n\r\nEtc:\r\n\r\n`sudo chmod a+rw /dev/ttyUSB0`\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Fingerprint reader R503",
"version": "0.0.4",
"project_urls": {
"Homepage": "https://github.com/rshcs/Grow-R503-Finger-Print",
"Tracker": "https://github.com/rshcs/Grow-R503-Finger-Print/issues"
},
"split_keywords": [
"python",
"fingerprint",
"security",
"grow",
"r503",
"password"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "88af038cd5cd9abce6a64019f7f00f920426b28c95ababc2dd5ef8f6ce7bed27",
"md5": "d3d0d4614cb38b20d2bcebf3abbf2ff1",
"sha256": "f3b73b72dfcb52a680afac79d915d9da7b47435cab834d51c6e7f731f081cc8c"
},
"downloads": -1,
"filename": "r503-0.0.4.tar.gz",
"has_sig": false,
"md5_digest": "d3d0d4614cb38b20d2bcebf3abbf2ff1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 12741,
"upload_time": "2023-09-28T19:20:43",
"upload_time_iso_8601": "2023-09-28T19:20:43.486735Z",
"url": "https://files.pythonhosted.org/packages/88/af/038cd5cd9abce6a64019f7f00f920426b28c95ababc2dd5ef8f6ce7bed27/r503-0.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-28 19:20:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rshcs",
"github_project": "Grow-R503-Finger-Print",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "r503"
}
JSON
