R307指纹模块接Arduino:注册到匹配全流程实操

2026-11-19 07:19:13 42阅读 所属项目:ESP32 开发板

给项目加一个“认人”的功能,指纹模块是最省事的一条路。门禁、工具柜、考勤机这类场景,密码和刷卡都能被代刷代抄,指纹虽然也有被折腾出假指纹的案例,但对创客项目来说,成本和实现难度的平衡点还是它。R307 这类光学指纹模块几十块钱一枚,识别、比对、存模板都在模块内部完成,主控只管发串口指令收结果,对新手非常友好。

这篇把 R307 接 Arduino、装库、注册指纹、匹配识别的完整流程理一遍,再往考勤机的方向指条路。步骤和代码整理自两篇公开可查的实操教程,接线、参数逐条对照过厂家页面,新手会卡住的地方单独标了出来。

指纹考勤机实拍与R307模块

先认识R307:它自己就是一个“小指纹电脑”

R307 不是一颗裸传感器,它把光学采集窗、高速 DSP、比对算法和模板存储集成在一个金属壳里。手指按上去,成像、提特征、建模板、比对全部在模块内完成,主控只需要通过 TTL 串口收发指令包。常见批次内部用的是杭州城章(hzgrow)的 AS608 芯片方案,市售很多不带型号的“指纹识别模块”其实是同源产品,判断方法很简单:串口协议和 R307 一样、Adafruit 库直接能通的,基本都是一族。

几个关键规格值得记住。供电 4.2 到 6.0 伏,工作电流典型值 50mA,峰值 80mA 左右;采集窗口 14×18mm,500 DPI 成像,按压后 0.3 秒上下就能取到图。串口默认波特率 57600(波特率公式是 9600 乘 N,N 默认取 6)。模块上还有跳线可以在 3.3V 和 5V 逻辑之间切换,所以它既能直连 Arduino UNO,也能接 3.3V 的 ESP32 这类板子。

容量方面,厂家页面标称能存 300 枚模板;Adafruit 官方例程把注册 ID 限制在 1 到 127,日常做门锁、考勤原型完全够用。比对支持两种模式:1 比 1 验证,拿现场指纹和指定模板比对;1 比 N 搜索,拿现场指纹和整个模板库比对,后面代码里会分别用到。厂商标称在安全等级 3 下误识率低于 0.001%、拒真率低于 0.1%——这两个数是数据手册口径,实际体验受手指干湿、按压角度影响不小,别拿标称值当承诺。

R307指纹模块引脚图

接线:四根线加一个跳线帽

模块排针引出 5V、GND、TXD、RXD,部分板型还有 Touch 和 3.3V 两根线。接 Arduino UNO 只需要四根线,注意串口必须交叉:模块的 TXD 接 Arduino 的 D2(软串口 RX),模块的 RXD 接 D3(软串口 TX)。第一次接的新手十有八九把 TX 对 TX 直连,现象是串口监视器里连“Found fingerprint sensor”都出不来。

之所以用软串口,是因为 UNO 上唯一的硬件串口被 USB 下载占用了,烧录和串口监视器都要走它。把传感器放到 SoftwareSerial 上,互不打架。供电接 5V 引脚,记得把逻辑跳线帽设到 5V 档;如果你用的是 3.3V 主控,就切到 3.3V 档,别硬扛。

接线关系整理如下:

R307 VCC 接 Arduino 5V
R307 GND 接 Arduino GND
R307 TX 接 Arduino D2(软串口 RX)
R307 RX 接 Arduino D3(软串口 TX)

排线里的 Touch 线本文用不到,它是带触摸感应的板型给出的触摸信号,留给低功耗唤醒这类设计使用。线序在不同批次里可能不同,动手前对照模块引脚图核一遍,别凭颜色记忆接。

装库,然后注册指纹

打开 Arduino IDE 的库管理器(工具 → 包含库 → 管理库),搜 Adafruit Fingerprint Sensor Library 装上,这是这套流程事实上的标准库。装完先上传注册例程:串口监视器波特率设 9600——注意这是 USB 那头的速率,传感器那头仍然是 57600,代码里的 finger.begin(57600) 负责对接。输入一个 1 到 127 的槽位号,按提示把同一根手指按两次,模块会把两次采集合成一个模板写进内部 flash。

#include "Adafruit_Fingerprint.h"
#include "SoftwareSerial.h"
SoftwareSerial mySerial(2, 3); // RX, TX

Adafruit_Fingerprint finger = Adafruit_Fingerprint(&mySerial);

uint8_t id;

void setup() {
  Serial.begin(9600);
  while (!Serial);
  delay(100);
  Serial.println("\n\nFingerprint sensor enrollment");
  finger.begin(57600);
  if (finger.verifyPassword()) {
    Serial.println("Found fingerprint sensor!");
  } else {
    Serial.println("Did not find fingerprint sensor :(");
    while (1) { delay(1); }
  }
}

uint8_t readnumber(void) {
  uint8_t num = 0;
  while (num == 0) {
    while (! Serial.available());
    num = Serial.parseInt();
  }
  return num;
}

void loop() {
  Serial.println("Ready to enroll a fingerprint!");
  Serial.println("Please type in the ID # (from 1 to 127) you want to save this finger as...");
  id = readnumber();
  if (id == 0) return; // ID #0 not allowed
  Serial.print("Enrolling ID #");
  Serial.println(id);
  while (! getFingerprintEnroll() );
}

uint8_t getFingerprintEnroll() {
  int p = -1;
  Serial.print("Waiting for valid finger to enroll as #"); Serial.println(id);
  while (p != FINGERPRINT_OK) {
    p = finger.getImage();
    switch (p) {
      case FINGERPRINT_OK: Serial.println("Image taken"); break;
      case FINGERPRINT_NOFINGER: Serial.println("."); break;
      case FINGERPRINT_PACKETRECIEVEERR: Serial.println("Communication error"); break;
      case FINGERPRINT_IMAGEFAIL: Serial.println("Imaging error"); break;
      default: Serial.println("Unknown error"); break;
    }
  }
  p = finger.image2Tz(1);
  if (p != FINGERPRINT_OK) { Serial.println("Could not process image"); return p; }
  Serial.println("Remove finger");
  delay(2000);
  p = 0;
  while (p != FINGERPRINT_NOFINGER) { p = finger.getImage(); }
  Serial.print("ID "); Serial.println(id);
  p = -1;
  Serial.println("Place same finger again");
  while (p != FINGERPRINT_OK) {
    p = finger.getImage();
    if (p == FINGERPRINT_OK) Serial.println("Image taken");
    else if (p == FINGERPRINT_NOFINGER) Serial.print(".");
  }
  p = finger.image2Tz(2);
  if (p != FINGERPRINT_OK) { Serial.println("Could not process image"); return p; }
  Serial.print("Creating model for #"); Serial.println(id);
  p = finger.createModel();
  if (p == FINGERPRINT_OK) {
    Serial.println("Prints matched!");
  } else {
    Serial.println("Fingerprints did not match");
    return p;
  }
  p = finger.storeModel(id);
  if (p == FINGERPRINT_OK) {
    Serial.println("Stored!");
  } else {
    Serial.println("Could not store");
    return p;
  }
}

流程在 getFingerprintEnroll 里一步不落:getImage 取图、image2Tz(1) 生成第一次特征、等手指离开、再按一次走 image2Tz(2)、createModel 合成模板、storeModel 写入槽位。串口监视器里每一步都有反馈,哪一步卡住一目了然。

注册最容易翻车的是第二次按压:手指挪开得太慢,模块还没等到 NOFINGER 状态就开始第二次成像,模板合成会报“Fingerprints did not match”。按“移开手指、再放同一根手指”的节奏来,基本一次过。注册失败不用慌,换一个槽位号重录即可,原来那个槽位不覆盖也不会被读到。

匹配代码:识别并读出置信度

注册好的指纹怎么认出来?下面这段例程常驻 loop,检测到按压就取图、提特征、fingerFastSearch 全库搜索,命中后把 ID 和置信度打到串口,同时拉高 D12 点亮 LED 当反馈。

#include "Adafruit_Fingerprint.h"
#include "SoftwareSerial.h"

SoftwareSerial mySerial(2, 3);
Adafruit_Fingerprint finger = Adafruit_Fingerprint(&mySerial);

void setup() {
  Serial.begin(9600);
  while (!Serial);
  delay(100);
  Serial.println("fingertest");
  pinMode(12, OUTPUT);
  pinMode(11, OUTPUT);
  finger.begin(57600);
  if (finger.verifyPassword()) {
    Serial.println("Found fingerprint sensor!");
  } else {
    Serial.println("Did not find fingerprint sensor :(");
    while (1) { delay(1); }
  }
  finger.getTemplateCount();
  Serial.print("Sensor contains "); Serial.print(finger.templateCount); Serial.println(" templates");
  Serial.println("Waiting for valid finger...");
}

void loop() {
  getFingerprintIDez();
  delay(50);
  digitalWrite(12, LOW);
  digitalWrite(11, LOW);
}

// returns -1 if failed, otherwise returns ID #
int getFingerprintIDez() {
  uint8_t p = finger.getImage();
  if (p != FINGERPRINT_OK) return -1;
  p = finger.image2Tz();
  if (p != FINGERPRINT_OK) return -1;
  p = finger.fingerFastSearch();
  if (p != FINGERPRINT_OK) return -1;
  // found a match!
  digitalWrite(12, HIGH);
  delay(3000);
  digitalWrite(12, LOW);
  Serial.print("Found ID #"); Serial.print(finger.fingerID);
  Serial.print(" with confidence of "); Serial.println(finger.confidence);
}

fingerFastSearch 走的就是 1 比 N 模式,整个库搜一遍在亚秒级返回。串口里会打印形如“Found ID #3 with confidence of 325”的输出,confidence 是两份特征的匹配得分,值越高越可信。如果你只要“是不是某一个人”的答案,那就是 1 比 1 验证的用法,比对范围缩到一个槽位,速度和抗误识都会更好。

模板管理也有现成路子:清空整个模板库、删除单个槽位,Adafruit 库的示例里都有对应例程,例程名直接能看出来。做了增删之后建议重启一轮验证,确认 flash 里的状态和预期一致。

往考勤机方向延伸

指纹认人只是地基,往上叠一层记录就能变成考勤机。CircuitDigest 上的那套方案就是这个思路:主控换成 ESP32,R307 负责认人,DS1307 RTC 掉电走时保证时间不乱,SSD1306 OLED 显示状态,本地跑一个 SQLite 库存员工和打卡记录,再通过一个带密码的网页后台完成员工注册和设备配置(IP 或 MDNS 地址都能访问),数据同步到 Google Sheets,考勤表直接在表格里看。

这个架构对本地化部署很友好:断网时记录先落本地库,联网后补同步;断电时 RTC 顶住时间轴。想把上面 UNO 的两段例程搬过去,主要改动是把 SoftwareSerial 换成 ESP32 的硬件串口 Serial2——ESP32 的 GPIO16 是 RX2、GPIO17 是 TX2,接线照样要交叉(模块 TXD 接 GPIO16,模块 RXD 接 GPIO17),其余流程一模一样。

指纹考勤机电路图

指纹考勤机实机与Google表格记录

踩坑提醒

供电别图省事从 3.3V 引脚取:50mA 的典型电流看着不大,峰值能到 80mA,不少板子的 3.3V 稳压器余量很紧,会出现识别时随机重启这种玄学问题。杜邦线也别用太长的,57600 波特率虽然不高,劣质长线照样丢包,表现为连 verifyPassword 都过不了。

最后说句实在的:这套东西门槛不高,一下午能跑通,但要做“能用”的产品,误识率、活体检测、模板管理这些才是真正的坑。先用官方例程把每一帧串口输出看懂,再动手改,比一上来就自己造轮子稳得多。


作者:固件烧录仔
链接:https://www.aiddithome.com/p/1d503c6df0e235.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
5条评论
拆开看看再说
1楼 · 2026-11-19 07:19:52

请教一下,现在库管理器里Adafruit Fingerprint是2.x的版本,例程接口和文中代码有出入吗?还是能直接编译?手头模块是某宝买的没印型号,按57600波特率verifyPassword能通,是不是就可以确定是同协议的?

修啥都行二哥
2楼 · 2026-11-19 07:19:52

ESP32迁移那段有用,Serial2的RX是GPIO16、TX是GPIO17,接线一样交叉。我的做法是再加一个D12的LED做识别成功提示,串口监视器基本可以不用开着,看灯就知道有没有认出来。confidence低于100左右的样本建议重录,实测这种指纹后面容易误报。

深圳打工人Alan
3楼 · 2026-11-19 07:19:52

收藏了,等模块到货照着做一遍。

触底反弹的Tony
4楼 · 2026-11-19 07:19:51

上周刚好折腾过这个模块,文中说的供电坑是真的。我从开发板3.3V引脚取的电,识别一次重启一次,换了5V供电立马稳了。补充一点:峰值电流80mA是按住不放、连续采集的情况,平时待机没那么大,但稳压余量还是要留够。另外建议接线前先拿万用表量一下排线通断,我那条排线有一根是虚的,白白查了两小时。

第三次终于亮了
5楼 · 2026-11-19 07:19:51

TX接TX那个坑,我第一次玩软串口也踩过,卡了一晚上,最后看例程注释才反应过来要交叉接。