Documentation

// R307S Fingerprint Sensor - Arduino Example
// Sensor TXD -> D2, Sensor RXD -> D3 (via divider), +5V -> 5V, GND -> GND
// Library: "Adafruit Fingerprint Sensor Library" (Library Manager)

#include <Adafruit_Fingerprint.h>
#include <SoftwareSerial.h>

SoftwareSerial mySerial(2, 3);  // RX = D2 (from TXD), TX = D3 (to RXD)
Adafruit_Fingerprint finger = Adafruit_Fingerprint(&mySerial);

void setup() {
  Serial.begin(9600);
  finger.begin(57600);  // R307S default baud rate

  if (finger.verifyPassword()) {
    Serial.println("Fingerprint sensor found!");
  } else {
    Serial.println("Sensor not found - check wiring and baud rate.");
    while (1) delay(1);
  }

  finger.getTemplateCount();
  Serial.print("Templates stored: ");
  Serial.println(finger.templateCount);
  Serial.println("Place an enrolled finger on the window...");
}

void loop() {
  // Step 1: capture an image of the finger
  if (finger.getImage() != FINGERPRINT_OK) return;

  // Step 2: convert the image to a search template
  if (finger.image2Tz() != FINGERPRINT_OK) return;

  // Step 3: search the stored library for a match
  if (finger.fingerFastSearch() == FINGERPRINT_OK) {
    Serial.print("Match! ID #");
    Serial.print(finger.fingerID);
    Serial.print(" (confidence ");
    Serial.print(finger.confidence);
    Serial.println(")");
    delay(1000);  // Debounce so one touch prints once
  } else {
    Serial.println("No match for this finger.");
    delay(500);
  }
}

// R307S Fingerprint Sensor - ESP32 Example
// Sensor TXD -> GPIO 16 (RX2), Sensor RXD -> GPIO 17 (TX2), +5V -> VIN
// Library: "Adafruit Fingerprint Sensor Library" (Library Manager)

#include <Adafruit_Fingerprint.h>

// Use the ESP32's second hardware UART - no SoftwareSerial needed
HardwareSerial sensorSerial(2);  // UART2
Adafruit_Fingerprint finger = Adafruit_Fingerprint(&sensorSerial);

void setup() {
  Serial.begin(115200);

  // begin(baud, config, RX pin, TX pin)
  sensorSerial.begin(57600, SERIAL_8N1, 16, 17);
  finger.begin(57600);

  if (finger.verifyPassword()) {
    Serial.println("Fingerprint sensor found!");
  } else {
    Serial.println("Sensor not found - check wiring.");
    while (1) delay(1);
  }

  Serial.println("Place an enrolled finger on the window...");
}

void loop() {
  if (finger.getImage() != FINGERPRINT_OK) return;
  if (finger.image2Tz() != FINGERPRINT_OK) return;

  if (finger.fingerFastSearch() == FINGERPRINT_OK) {
    Serial.printf("Match! ID #%d (confidence %d)\n",
                  finger.fingerID, finger.confidence);
    delay(1000);
  } else {
    Serial.println("No match for this finger.");
    delay(500);
  }
}

#!/usr/bin/env python3
# R307S Fingerprint Sensor - Raspberry Pi Example
# Sensor TXD -> GPIO 15 (pin 10), Sensor RXD -> GPIO 14 (pin 8)
# Setup: sudo raspi-config (disable serial console, enable serial port)
#        pip3 install pyfingerprint

import time
from pyfingerprint.pyfingerprint import PyFingerprint

# Open the Pi's GPIO UART at the sensor's default settings
f = PyFingerprint('/dev/serial0', 57600, 0xFFFFFFFF, 0x00000000)

if not f.verifyPassword():
    raise ValueError('Sensor password check failed - check wiring/baud')

print('Sensor found. Templates used: {}/{}'.format(
    f.getTemplateCount(), f.getStorageCapacity()))
print('Place an enrolled finger on the window (Ctrl+C to stop)...')

try:
    while True:
        # Wait for a finger and capture the image
        if f.readImage():
            # Convert to characteristics in char buffer 1
            f.convertImage(0x01)

            # Search the template library
            position, accuracy = f.searchTemplate()

            if position >= 0:
                print('Match! Template #{} (accuracy {})'.format(
                    position, accuracy))
                time.sleep(1)
            else:
                print('No match for this finger.')
                time.sleep(0.5)
        time.sleep(0.05)

except KeyboardInterrupt:
    print('Stopped by user')

# R307S Fingerprint Sensor - Pico MicroPython Example
# Sensor TXD -> GP1 (UART0 RX), Sensor RXD -> GP0 (UART0 TX), +5V -> VBUS
# Talks the raw protocol - no library needed.

from machine import UART, Pin
import time

uart = UART(0, baudrate=57600, tx=Pin(0), rx=Pin(1), timeout=500)

HEADER = b'\xef\x01'
ADDRESS = b'\xff\xff\xff\xff'

def send_cmd(payload):
    # payload = instruction + parameters (without length/checksum)
    length = len(payload) + 2
    packet = b'\x01' + bytes([length >> 8, length & 0xFF]) + payload
    checksum = sum(packet)
    frame = HEADER + ADDRESS + packet + bytes(
        [(checksum >> 8) & 0xFF, checksum & 0xFF])
    uart.write(frame)

def read_ack():
    time.sleep_ms(100)
    resp = uart.read()
    if resp and len(resp) >= 12 and resp[:2] == HEADER:
        return resp[9]  # confirmation code: 0x00 = success
    return None

# --- Check the sensor answers (VfyPwd with default password 0x00000000)
send_cmd(b'\x13\x00\x00\x00\x00')
if read_ack() == 0x00:
    print('Fingerprint sensor found!')
else:
    raise RuntimeError('Sensor not responding - check wiring and baud')

print('Touch the sensor window...')

while True:
    # GenImg: capture a fingerprint image if a finger is present
    send_cmd(b'\x01')
    code = read_ack()

    if code == 0x00:
        print('Finger detected and image captured!')
        time.sleep(1)   # Debounce so one touch prints once
    # 0x02 means "no finger on the window" - keep polling quietly
    time.sleep_ms(200)