我花了两个周末用 STM32 和一块串口指纹模块攒出了一台能录入指纹、打卡签到、自动记录考勤时间的考勤机。今天这篇文章就把从原理到实现的过程完整记录下来包括硬件选型、指纹模块通信、软件状态机设计以及我在调试中踩过的几个比较典型的坑。如果你也想做一台自己的指纹考勤机或者单纯想练一下嵌入式从零到一的综合能力这篇应该能给你省下不少时间。做这种项目有一个很大的好处它不是单纯的跑马灯或者点个屏而是把传感器采集、串口协议、RTC 时钟、数据存储、状态机逻辑全部串在了一起麻雀虽小五脏俱全。而且完成后放在工作室门口实测打卡那种成就感跟用开发板点灯完全不是一个量级。下面我按自己实际做项目的顺序来写从需求拆解开始到最后的稳定性和扩展性经验尽量把每个环节背后的理由也讲清楚。1. 从零搭一台考勤机需求、选型与系统总览考勤机这种东西市售产品很多几十块钱到几百块钱都有但大多数人买回来都会遇到几个问题数据导不出来、只支持固定几个人、不能改班次规则、UI 老旧。自己动手做的核心动机不是省钱而是完全掌控功能——比如我希望打卡后能立刻显示工号和打卡时间能方便地导出 CSV 到电脑还能把指纹库容量做到一个指纹模块本身能容纳的上限。1.1 考勤机到底需要哪些核心功能先别急着焊板子把需求清单列出来这是整个项目最重要的一步。我的目标功能是录入新指纹给一个工号按三次手指生成指纹模板。打卡识别手指按上去识别出是哪个人记录当前时间。时间记录必须有可靠的实时时钟断电后时间不能丢。数据存储考勤记录要存到文件里能拔出来直接当电子表格用。简单交互OLED 显示当前时间、提示信息两个按键控制录入/删除等操作。这些功能并不复杂但每一项背后都牵扯到具体的硬件和协议。比如时间不能丢就要求外挂 RTC 芯片和备份电池数据能导出最方便的做法是 SD 卡加文件系统而不是单片机内部 Flash。1.2 技术选型为什么是 STM32 和串口指纹模块主控我选的是 STM32F103C8T6原因很直白便宜、资料多、性能足够。72MHz 主频跑一个考勤机富余得很外设接口丰富——USART 可以跟指纹模块通信SPI 接 SD 卡I2C 接 RTCGPIO 接按键和蜂鸣器基本上一个芯片全包了。有人会问用 Arduino 不更简单Arduino 确实开发快但 STM32 的控制粒度、中断响应、低功耗管理都要强一截而且 CubeMX 生成初始化代码后实际写的业务逻辑也不算多。指纹模块我选了市面上最常见的 AS608 型光学指纹模块。这类模块内置了 DSP 芯片自己完成指纹图像的采集、特征提取和匹配计算对外只提供一串串口指令。这大大降低了开发门槛——我们不需要懂什么脊线、谷线、FAR/FRR 这些底层的图像处理算法只需要按照模块协议发指令包接收返回结果就行。其他部件也顺便列一下0.96 寸 OLED 屏I2C 接口DS3231 RTC 模块带电池座SPI 接口的 Micro SD 卡模块两个按键加一个蜂鸣器。整套下来成本不超过一百块比自己买个成品还便宜还能享受定制乐趣。2. 指纹模块通信与 RTC 时间基准让硬件先说上话选好了件下一步不是直接接三根线而是先把两块核心硬件的工作原理搞清楚指纹模块怎么返回识别结果RTC 怎么提供准确时间。这两块决定了整个软件架构。2.1 指纹识别的本质模块替你做完了重活指纹识别的底层原理说复杂很复杂说简单也简单。手指按在光学传感器上表面凹凸不平的脊线谷线会形成明暗条纹传感器把这些条纹拍成图像然后算法从图像里提取出特征点——就是纹路的分岔点、端点这些东西。每次录入指纹时会生成一个若干个特征点的模板之后识别就是拿新采集到的特征和库里所有模板比对算相似度超过阈值就认为匹配成功。AS608 模块之所以好用是因为它把上述过程全部封装了。模块内部有一个小指纹库最多能存 200 到 1000 枚指纹具体看模块容量。我们发给它的指令不外乎这几类采集图像、生成特征、存储模板、搜索匹配、删除模板。模块执行完返回一个确认码我们只需要解析确认码就行。拿搜索匹配来举例模块先把手指图像生成特征放入缓冲区然后执行搜索指令指定从哪个编号搜到哪个编号找到后返回匹配到的编号和分数。这样主控端的逻辑就变得很单纯——发指令收结果处理结果。2.2 串口指令包的构成和校验这类模块的串口协议一般是自定义帧格式。以 AS608 为例每个指令包由以下几个部分组成帧头固定为 0xEF01 两个字节。芯片地址默认 4 字节通常全 FF。包标识字节01 表示指令包07 表示应答包。包长度包括包标识、指令码、参数和校验和在内的字节总数。指令码和参数。校验和从包标识开始到内容最后一个字节的累加和。这里最容易出错的就是校验和。我第一次直接拿上位机软件发指令没问题换成单片机写就总是返回 FF无应答后来发现是校验和算重了把帧头也加进去了。正确做法是只累加帧头以后的内容。下面是我自己封装的指令包发送函数骨架思路其实比细节更重要// 指令包发送函数简化版 // pkg: 指向除帧头(0xEF01)之外的数据起始位置 void sendPacket(uint8_t *body, uint8_t len) { uint8_t packet[len 7]; packet[0] 0xEF; packet[1] 0x01; packet[2] 0xFF; packet[3] 0xFF; packet[4] 0xFF; packet[5] 0xFF; packet[6] 0x01; // 包标识指令包 memcpy(packet 7, body, len); uint16_t sum 0; for (uint8_t i 6; i len 7; i) // 从包标识开始累加 sum packet[i]; packet[len 7] (sum 8) 0xFF; packet[len 8] sum 0xFF; HAL_UART_Transmit(huart2, packet, len 9, 1000); }你在写自己的代码时具体的指令码和包结构要对着模块手册核对我这个只是示意结构。重点是要理解校验和从哪里开始算到啊这个细节掉坑率极高。2.3 RTC 模块考勤数据的时间戳来源考勤记录如果没有准确时间那整个项目就没有意义。STM32 内部虽然有一个 RTC但掉电后需要备用电源维持而常见的 F103 芯片内部 RTC 精度一般月误差可能以分钟计。我选了 DS3231 外部 RTC它内置温度补偿晶振年误差可以做到几分钟内而且自带电池座断电之后靠一颗 CR2032 就能继续走时。DS3231 是 I2C 接口跟 STM32 连接只需要两根数据线加上地。CubeMX 里把 I2C1 使能然后在初始化时把当前时间写进去之后随时用读取函数拿时分秒。你需要注意一点第一次烧录程序时设置时间以后如果电池有电重启后不需要重复设置我是在程序里读了一个时间已设置标志存在 RTC 芯片内部另一个寄存器里避免每次开机都重置时间。代码上时间和日期的读取可以封装成两个结构体写入记录时直接塞进格式化字符串后面会用到。3. 搭建硬件平台引脚、电源与电平匹配的关键细节原理图看懂了面包板上手时会发现一堆问题接线松了、电平不对、供电不够、串口发乱码。这个阶段我花了大概一个晚上虽然没什么高深技术但细节决定成败。3.1 硬件清单与引脚分配表我把自己的引脚分配贴出来做成表格方便照着抄外设引脚说明指纹模块 TXPA3USART2_RX接 STM32 的 RX 引脚注意交叉指纹模块 RXPA2USART2_TX接 STM32 的 TX 引脚OLED SDAPB7I2C1_SDAOLED SCLPB6I2C1_SCLDS3231 SDAPB7同一 I2C 总线不同地址DS3231 SCLPB6同一 I2C 总线SD 卡 CSPA4SPI1_NSSSD 卡 SCKPA5SPI1_SCKSD 卡 MISOPA6SPI1_MISOSD 卡 MOSIPA7SPI1_MOSI按键 S1PB0下拉输入单击进入菜单按键 S2PB1下拉输入确认/删除蜂鸣器PB10推挽输出驱动三极管OLED 和 DS3231 挂同一条 I2C 总线没问题它们的设备地址不同不会冲突。这两个模块都是 3.3V 和 5V 兼容的我统一用了 3.3V 供电省去电平转换。3.2 电源与串口电平匹配这是最容易翻车的地方。STM32F103 的供电和引脚电平是 3.3V但很多指纹模块虽然逻辑电平也是 3.3V却要求 5V 供电才能让光学传感器和 DSP 正常工作。所以我的用法是指纹模块接 5V 电源但它的 TX 引脚输出的是 3.3V 逻辑电平很多模块内部带了电平转换可以兼容 3.3V MCU这时就可以直连 STM32 的 RX 引脚。如果你买的模块明确写着 TTL 电平 5V那就不能直连了否则一插上去单片机引脚就可能烧掉。稳妥的办法是加一个电平转换小板或者在 RX 线上串 1k 电阻分压。我建议买模块时就看清楚参数优先选5V 供电3.3V 通信的版本省事很多。另外指纹模块的峰值电流不小尤其按下手指采集图像时如果整块板都用电脑 USB 口供电可能出现电流不够导致模块重启或者录取失败。我后来给系统加了一个 5V 2A 的独立电源才彻底解决了按下手指单片机重启的诡异问题。这个小现象值得记下来任何瞬时功耗大的外设都要预留电源余量。3.3 通电测试先让每个模块单独站起来我建议你不要一上来就把所有模块接好然后整体跑否则出问题都不知道在哪。我的顺序是先只接 STM32 最小系统烧一个点灯程序确认主控工作正常。接 OLED显示一个字确认 I2C 通不通。接指纹模块用串口调试助手连模块发一个查询系统参数指令确认模块应答正常。接 DS3231读取时间确认数据能读出来。最后接 SD 卡挂载文件系统创建文件成功后再整合。每加一个模块就测一项这样就算出问题也能锁定在新增的环节上。不要嫌麻烦这比整体调试快太多了。4. 软件架构与实现状态机、指纹指令和考勤记录落盘硬件跑通后剩下的工作就是写软件把各个模块串起来。这是最体现从原理到实现的部分也是整个项目里代码量最大的地方。我没有把它写成一个大 while 循环里堆 if而是用一个简单状态机来组织这样后续加功能、修 Bug 都清晰得多。4.1 时钟、显示和按键的基本驱动项目在 STM32CubeIDE 里搭建用 CubeMX 生成基础工程。我同时开了两个串口USART1 接调试终端USART2 接指纹模块。调试串口打印日志非常有用比如每次串口收到原始数据时打印十六进制内容可以快速判断协议解析哪里出了问题。这里分享一个习惯任何串口接收都定义成环形缓冲 空闲中断的结构不要在中断里做耗时的协议解析只把字节放进缓冲主循环去读。OLED 驱动的代码网上有很多成熟库我直接选用现有驱动只改了 I2C 底层。显示逻辑也简单主界面显示当前日期时间加一个请按手指提示打卡成功后显示工号 010 打卡成功加时间录入时显示请放置手指(1/3)这样的步骤。这里不细写显示驱动代码重点说业务逻辑。每次从 RTC 读取时间时注意DS3231 返回的是 BCD 码需要转换。比如寄存器里读到 0x09其实是 9 点。很多新手不看手册直接拿来用结果显示乱码。4.2 指纹录入和搜索的流程设计录入指纹是考勤机的基础功能。我的录入流程如下按键进入录入模式输入一个指纹 ID直接用整数作为工号。模块执行采集图像指令。采集成功后再执行生成特征指令。重复采集两次模块内部会合并生成一个更稳定的模板。执行存储模板指令把这个 ID 存到模块指定编号。这里有个细节指纹模板不是一次按下就存一般要按三次每次生成一个特征模块会把多次特征组合以后存储这样同一个手指再用时识别率更高。如果手指太干或者太湿模块返回质量低错误屏幕上提示用户重新按压。我把这个提示写得很友好换个姿势按别太快。搜索识别流程更简单手指按下后模块先采集图像生成特征然后让模块在指纹库 0 到 N 范围内搜索返回找到的编号和相似度。主控拿到编号后把它当成工号再配上当前时间写入考勤记录。代码骨架大致如下uint8_t enrollFinger(uint16_t userID) { // 三次采集 for (uint8_t i 0; i 3; i) { delay(1200); uint8_t r ps_getImage(); // 采集图像 if (r ! 0) continue; r ps_genChar(0x01); // 生成特征缓冲1 if (r ! 0) continue; } // 合并特征 2/3生成模板 // 存储模板指定ID uint8_t r ps_store(0x06, userID, true); return r; }这里用的ps_getImage、ps_genChar、ps_store等函数名是我从底层驱动封装出来的别名真实对应模块手册里的指令码。封装这类函数时要把返回的确认码统一处理成枚举值比如 0 表示成功其他错误码分别映射到撮失败图像质量低库满等这样上层的 UI 提示就非常直观。4.3 考勤记录存储选 SD 卡还是按内部 Flash这是我在项目里思考了很久的一个点。考勤记录本质是一堆时间 工号的数据存到哪儿直接决定了后期导出的便利性。三个方案摆出来对比存储方案优点缺点STM32 内部 Flash无需额外硬件代码简单容量有限频繁擦写伤寿命外部 SPI Flash W25Q32成本低擦写速度快适合存原始记录导出数据需要额外读逻辑不方便电脑直接使用SD 卡 FATFS容量几乎无限拔卡直读 CSV调试麻烦初始化可能踩坑文件系统占用代码空间最终还是选了 SD 卡。因为我就想在电脑上直接用 Excel 打开考勤表不想再做一套上位机导出工具。STM32F103 的 SPI 接口跑 SD 卡最高也就是 18MHz 左右写一条十几字节的记录耗时在几十毫秒量级对打卡这种低频操作完全能接受。FatFs 文件系统的移植不难CubeMX 里把 SD 卡的 SPI 模式启用然后在中间层实现disk_initialize、disk_read、disk_write几个函数即可。新版本 CubeMX 甚至可以直接生成 FatFs 的移植代码省了很多事。写入记录的代码我这样写FRESULT saveAttendance(uint16_t userID, RTC_DateTime_t dt) { FIL f; char line[64]; if (f_open(f, record.csv, FA_OPEN_APPEND) ! FR_OK) { // 如果文件不存在先创建并写表头 f_open(f, record.csv, FA_CREATE_NEW | FA_WRITE); f_printf(f, time,user_id\r\n); f_close(f); f_open(f, record.csv, FA_OPEN_APPEND); } f_printf(f, %04d-%02d-%02d %02d:%02d:%02d,%d\r\n, dt.year, dt.month, dt.day, dt.hour, dt.minute, dt.second, userID); f_close(f); return FR_OK; }注意f_printf是 FatFs 的可选函数需要在配置里把FF_FS_SUSTAINABLE之类的宏打开实际上要开FF_USE_STRFUNC否则不编译进去。打开以后格式化字符串就要用 ASCII 模式注意中文要转成 UTF-8 或者 GBK 编码不然在电脑上看可能是乱码。我为了避免麻烦CSV 全部用 ASCII时间数字和逗号分隔不存在中文Excel 打开一点问题没有。4.4 主循环状态机考勤机的大脑怎么运转整个程序的主循环不是从上到下一遍一遍跑而是用一个枚举状态变量控制在几个状态之间跳转。我的简化状态定义如下typedef enum { STATE_IDLE, // 空闲等待操作 STATE_MENU, // 菜单录入/清除/设置时间 STATE_ENROLL, // 录入指纹 STATE_DELETE, // 删除指纹 STATE_VERIFY, // 验证打卡 } AppState_t;主循环的逻辑可以概括为扫描按键根据当前状态调用对应的处理函数。比如空闲状态下如果检测到有手指按下通过指纹模块的检测到手指指令或者直接尝试采集就切换到STATE_VERIFY执行搜索搜索结果如果成功蜂鸣器响一声保存记录回到空闲。状态机里最容易忽略的是超时返回空闲机制。比如用户按了录入键但半天不按手指程序不能永远卡在录入状态。我在每个需要用户操作的状态里加了一个超时计数器比如 30 秒无操作自动回到STATE_IDLE并放弃当前未完成的录入。另一个要点是事件触发而非轮询扫描的原则问题。对按键我是这样处理的在主循环里每 20 毫秒扫描一次按键引脚检测到下降沿后做软件消抖连续读两个周期电平一致然后产生一个按键事件这个事件只在状态机的适当分支里消费。如果某些动作耗时较长比如 SD 卡写操作不要放在中断或事件回调里同步执行否则手指按下去后要卡几十毫秒才显示结果体感很差。我推荐的做法是把要写入的数据放进一个队列主循环空闲时消费队列这样打卡显示几乎零延迟。整体主循环的伪代码如下while (1) { handle_button_event(); // 处理按键消抖和事件分发 handle_timeout(); // 状态超时检查 handle_finger_logic(); // 状态机指纹操作 handle_display(); // 根据状态更新 OLED process_log_queue(); // 消费考勤记录写入 SD 卡 }写完之后整个项目的结构非常清楚按键事件产生、状态机响应、业务逻辑执行、数据落盘、结果反馈。后续想加一个打卡语音播报只要在状态机出入口加调用即可。5. 实测与掉坑记录稳定性问题和优化思路硬件软件都跑通不等于稳定。我连续测试了三天把日常使用中遇到的坑一个个记录下来这里挑几个影响最大的展开说。5.1 指纹模块识别不出和乱识别的排查第一天测试时自己录的指纹经常认不出来偶尔还出现认错到别人的情况。我先是怀疑模块坏了后来发现是指纹录入的质量太差。原因是录入阶段我没有强制采集三次指纹偶尔按到第二次就存储了。指纹按压位置、力度不一样特征模板覆盖不全识别时找不到足够匹配的特征点。后来改成三次采集、合并模板拒真率明显下降。还有一次奇怪的现象录入时明明是一个手指同一个手再按却返回另一个 ID 的匹配。排查后发现是录入时 ID 分配错误我在ps_store传的参数把指纹编号和用户 ID混用了。每枚指纹在模块里有一个存储位置0~N而用户 ID 是我自定义的工号。我原来设想工号就是指纹编号一个 ID 只能录一根指头。如果一个人需要录双手就会冲突。这算不上硬件 Bug但提醒我设计时要区分存储槽位和业务工号。后来我做了个改进在 MCU 里维护一张映射表一人分配多个槽位映射到同一个用户 ID。也就是录左手录到槽位 5录右手录到槽位 6两个槽位都对应工号 010。这样就能多人多指了。虽然代码多了一百多行但实用性好很多也把 D 个模块自带的槽位用活了。5.2 严重影响稳定性的 SD 卡写入问题前面说到打卡后要写入 CSV我用的是同步写。第一次测试时发现每写一条记录系统大概要卡 200 毫秒如果刚好这时候有下一个手指按下来指纹模块的采集就会超时导致打卡失败。这很致命。排查后发现两个原因一是 SD 卡在 SPI 模式下初始化后没有把时钟降下来我用的是 18MHz虽然理论上可行但实际卡与卡兼容性差有的卡就是会超时二是写文件后调用f_sync强制回写盘中做了一次长期的物理写操作。解决办法有三个初始化时用低速400kHz挂载成功后切到 12MHz读写时如果出错自动降频重试。打卡时先放进内存队列主循环空闲时批量写入写之前把状态机保持在空闲态。如果对可靠性要求高可以在写入前检查 SD 卡是否插好拔卡时直接把记录暂存在外部 Flash等下次插卡再补写。我最终采用了队列 批量刷写的方式。屏幕上提示打卡成功是即时的实际上数据还在内存队列里200 毫秒后悄悄落到 SD 卡。如果拔卡了就弹个警告音提示数据可能丢失。这个方案既保证体验又避免频繁摩擦 SD 卡。5.3 时间丢失和电池耗尽因为用了 DS3231断电倒是不掉时间但如果纽扣电池没电上电后时间会恢复到底部默认值考勤记录就会出现一堆奇怪的时间。我在程序里加了一个时间合法性检查开机时读出的年份小于某个值就认为 RTC 没有有效备份OLED 上就会闪烁请设置时间并要求按键设置。这算是一个典型的用户引导兜底逻辑。另外 DS3231 内部还有一个温度寄存器可以读出来显示在待机界面上。这个功能很受同事欢迎反正都是顺手。5.4 防指纹套等作弊场景的扩展思考做考勤机很多人会问能不能防别人拿一个指纹套替你打卡坦率讲纯光学指纹模块很容易被硅胶指套骗过因为模块只采集二维图像不做活体检测。几百块的模块都这样除非上电容指纹带心率检测的型号但成本就上去了。我的做法是在产品层面弥补旁边加一个人体红外感应模块打卡时红外必须先感应到人体才允许指纹模块采集。这样就算有人拿指纹套去按红外没检测到热释电信号直接提示未感应到活体。这个方案成本低很多防住了常见的物理替代作弊当然如果对方把指纹套贴在手指上一起按红外也能感应到人那就没法了。这个扩展再次说明做自己的项目的优势想要什么功能顺手就加不用求厂商开放接口。5.5 从原型到成品化的几点经验原型在面包板上能跑但要放到门口长期用有几点必须改进。第一把所有松动的地方换成杜邦线再加扎线带或者干脆打一块 PCB我用了一个周末画板发出去打样回来焊好后稳定性提升明显。第二供电要稳压指纹模块瞬间电流大用 AMS1117 线性稳压可能扛不住压降最好用 DC-DC 降压或者 USB 5V 直供。第三外壳要注意防静电和防潮指纹识别窗口如果不干净识别率会明显下降定期用酒精擦拭最好。还有一点经验程序里所有魔法数字都定义为宏或者枚举比如超时时间、蜂鸣器音调、按键防抖次数。因为你这个项目做完以后多半会想改如果没有集中定义改一个超时结果要翻好几个文件才能找全。自己做考勤机到后来最大的收获不是那台机器而是对整个系统的理解。单看每个模块的示例都觉得简单但把它们组合在一起的时候问题到处都是供电、时序、协议解析、文件系统、状态管理。这些问题每一个都不可怕可怕的是没有条理地乱调。如果你也想动手做我的建议是先按最简方案跑通 打卡 存记录 这个主链路再慢慢加花哨功能。主链路通了这台考勤机就真的能用了后面加的菜单、多人多指、活体检测、温度显示都是锦上添花。最后分享一个小技巧把调试串口的日志级别分成错误/警告/信息三档发布版本里关掉信息档保留错误档以后出问题能快速定位又不至于被日志淹没。
我花了两个周末用 STM32 和一块串口指纹模块攒出了一台能录入指纹、打卡签到、自动记录考勤时间的考勤机。今天这篇文章就把从原理到实现的过程完整记录下来包括硬件选型、指纹模块通信、软件状态机设计以及我在调试中踩过的几个比较典型的坑。如果你也想做一台自己的指纹考勤机或者单纯想练一下嵌入式从零到一的综合能力这篇应该能给你省下不少时间。做这种项目有一个很大的好处它不是单纯的跑马灯或者点个屏而是把传感器采集、串口协议、RTC 时钟、数据存储、状态机逻辑全部串在了一起麻雀虽小五脏俱全。而且完成后放在工作室门口实测打卡那种成就感跟用开发板点灯完全不是一个量级。下面我按自己实际做项目的顺序来写从需求拆解开始到最后的稳定性和扩展性经验尽量把每个环节背后的理由也讲清楚。1. 从零搭一台考勤机需求、选型与系统总览考勤机这种东西市售产品很多几十块钱到几百块钱都有但大多数人买回来都会遇到几个问题数据导不出来、只支持固定几个人、不能改班次规则、UI 老旧。自己动手做的核心动机不是省钱而是完全掌控功能——比如我希望打卡后能立刻显示工号和打卡时间能方便地导出 CSV 到电脑还能把指纹库容量做到一个指纹模块本身能容纳的上限。1.1 考勤机到底需要哪些核心功能先别急着焊板子把需求清单列出来这是整个项目最重要的一步。我的目标功能是录入新指纹给一个工号按三次手指生成指纹模板。打卡识别手指按上去识别出是哪个人记录当前时间。时间记录必须有可靠的实时时钟断电后时间不能丢。数据存储考勤记录要存到文件里能拔出来直接当电子表格用。简单交互OLED 显示当前时间、提示信息两个按键控制录入/删除等操作。这些功能并不复杂但每一项背后都牵扯到具体的硬件和协议。比如时间不能丢就要求外挂 RTC 芯片和备份电池数据能导出最方便的做法是 SD 卡加文件系统而不是单片机内部 Flash。1.2 技术选型为什么是 STM32 和串口指纹模块主控我选的是 STM32F103C8T6原因很直白便宜、资料多、性能足够。72MHz 主频跑一个考勤机富余得很外设接口丰富——USART 可以跟指纹模块通信SPI 接 SD 卡I2C 接 RTCGPIO 接按键和蜂鸣器基本上一个芯片全包了。有人会问用 Arduino 不更简单Arduino 确实开发快但 STM32 的控制粒度、中断响应、低功耗管理都要强一截而且 CubeMX 生成初始化代码后实际写的业务逻辑也不算多。指纹模块我选了市面上最常见的 AS608 型光学指纹模块。这类模块内置了 DSP 芯片自己完成指纹图像的采集、特征提取和匹配计算对外只提供一串串口指令。这大大降低了开发门槛——我们不需要懂什么脊线、谷线、FAR/FRR 这些底层的图像处理算法只需要按照模块协议发指令包接收返回结果就行。其他部件也顺便列一下0.96 寸 OLED 屏I2C 接口DS3231 RTC 模块带电池座SPI 接口的 Micro SD 卡模块两个按键加一个蜂鸣器。整套下来成本不超过一百块比自己买个成品还便宜还能享受定制乐趣。2. 指纹模块通信与 RTC 时间基准让硬件先说上话选好了件下一步不是直接接三根线而是先把两块核心硬件的工作原理搞清楚指纹模块怎么返回识别结果RTC 怎么提供准确时间。这两块决定了整个软件架构。2.1 指纹识别的本质模块替你做完了重活指纹识别的底层原理说复杂很复杂说简单也简单。手指按在光学传感器上表面凹凸不平的脊线谷线会形成明暗条纹传感器把这些条纹拍成图像然后算法从图像里提取出特征点——就是纹路的分岔点、端点这些东西。每次录入指纹时会生成一个若干个特征点的模板之后识别就是拿新采集到的特征和库里所有模板比对算相似度超过阈值就认为匹配成功。AS608 模块之所以好用是因为它把上述过程全部封装了。模块内部有一个小指纹库最多能存 200 到 1000 枚指纹具体看模块容量。我们发给它的指令不外乎这几类采集图像、生成特征、存储模板、搜索匹配、删除模板。模块执行完返回一个确认码我们只需要解析确认码就行。拿搜索匹配来举例模块先把手指图像生成特征放入缓冲区然后执行搜索指令指定从哪个编号搜到哪个编号找到后返回匹配到的编号和分数。这样主控端的逻辑就变得很单纯——发指令收结果处理结果。2.2 串口指令包的构成和校验这类模块的串口协议一般是自定义帧格式。以 AS608 为例每个指令包由以下几个部分组成帧头固定为 0xEF01 两个字节。芯片地址默认 4 字节通常全 FF。包标识字节01 表示指令包07 表示应答包。包长度包括包标识、指令码、参数和校验和在内的字节总数。指令码和参数。校验和从包标识开始到内容最后一个字节的累加和。这里最容易出错的就是校验和。我第一次直接拿上位机软件发指令没问题换成单片机写就总是返回 FF无应答后来发现是校验和算重了把帧头也加进去了。正确做法是只累加帧头以后的内容。下面是我自己封装的指令包发送函数骨架思路其实比细节更重要// 指令包发送函数简化版 // pkg: 指向除帧头(0xEF01)之外的数据起始位置 void sendPacket(uint8_t *body, uint8_t len) { uint8_t packet[len 7]; packet[0] 0xEF; packet[1] 0x01; packet[2] 0xFF; packet[3] 0xFF; packet[4] 0xFF; packet[5] 0xFF; packet[6] 0x01; // 包标识指令包 memcpy(packet 7, body, len); uint16_t sum 0; for (uint8_t i 6; i len 7; i) // 从包标识开始累加 sum packet[i]; packet[len 7] (sum 8) 0xFF; packet[len 8] sum 0xFF; HAL_UART_Transmit(huart2, packet, len 9, 1000); }你在写自己的代码时具体的指令码和包结构要对着模块手册核对我这个只是示意结构。重点是要理解校验和从哪里开始算到啊这个细节掉坑率极高。2.3 RTC 模块考勤数据的时间戳来源考勤记录如果没有准确时间那整个项目就没有意义。STM32 内部虽然有一个 RTC但掉电后需要备用电源维持而常见的 F103 芯片内部 RTC 精度一般月误差可能以分钟计。我选了 DS3231 外部 RTC它内置温度补偿晶振年误差可以做到几分钟内而且自带电池座断电之后靠一颗 CR2032 就能继续走时。DS3231 是 I2C 接口跟 STM32 连接只需要两根数据线加上地。CubeMX 里把 I2C1 使能然后在初始化时把当前时间写进去之后随时用读取函数拿时分秒。你需要注意一点第一次烧录程序时设置时间以后如果电池有电重启后不需要重复设置我是在程序里读了一个时间已设置标志存在 RTC 芯片内部另一个寄存器里避免每次开机都重置时间。代码上时间和日期的读取可以封装成两个结构体写入记录时直接塞进格式化字符串后面会用到。3. 搭建硬件平台引脚、电源与电平匹配的关键细节原理图看懂了面包板上手时会发现一堆问题接线松了、电平不对、供电不够、串口发乱码。这个阶段我花了大概一个晚上虽然没什么高深技术但细节决定成败。3.1 硬件清单与引脚分配表我把自己的引脚分配贴出来做成表格方便照着抄外设引脚说明指纹模块 TXPA3USART2_RX接 STM32 的 RX 引脚注意交叉指纹模块 RXPA2USART2_TX接 STM32 的 TX 引脚OLED SDAPB7I2C1_SDAOLED SCLPB6I2C1_SCLDS3231 SDAPB7同一 I2C 总线不同地址DS3231 SCLPB6同一 I2C 总线SD 卡 CSPA4SPI1_NSSSD 卡 SCKPA5SPI1_SCKSD 卡 MISOPA6SPI1_MISOSD 卡 MOSIPA7SPI1_MOSI按键 S1PB0下拉输入单击进入菜单按键 S2PB1下拉输入确认/删除蜂鸣器PB10推挽输出驱动三极管OLED 和 DS3231 挂同一条 I2C 总线没问题它们的设备地址不同不会冲突。这两个模块都是 3.3V 和 5V 兼容的我统一用了 3.3V 供电省去电平转换。3.2 电源与串口电平匹配这是最容易翻车的地方。STM32F103 的供电和引脚电平是 3.3V但很多指纹模块虽然逻辑电平也是 3.3V却要求 5V 供电才能让光学传感器和 DSP 正常工作。所以我的用法是指纹模块接 5V 电源但它的 TX 引脚输出的是 3.3V 逻辑电平很多模块内部带了电平转换可以兼容 3.3V MCU这时就可以直连 STM32 的 RX 引脚。如果你买的模块明确写着 TTL 电平 5V那就不能直连了否则一插上去单片机引脚就可能烧掉。稳妥的办法是加一个电平转换小板或者在 RX 线上串 1k 电阻分压。我建议买模块时就看清楚参数优先选5V 供电3.3V 通信的版本省事很多。另外指纹模块的峰值电流不小尤其按下手指采集图像时如果整块板都用电脑 USB 口供电可能出现电流不够导致模块重启或者录取失败。我后来给系统加了一个 5V 2A 的独立电源才彻底解决了按下手指单片机重启的诡异问题。这个小现象值得记下来任何瞬时功耗大的外设都要预留电源余量。3.3 通电测试先让每个模块单独站起来我建议你不要一上来就把所有模块接好然后整体跑否则出问题都不知道在哪。我的顺序是先只接 STM32 最小系统烧一个点灯程序确认主控工作正常。接 OLED显示一个字确认 I2C 通不通。接指纹模块用串口调试助手连模块发一个查询系统参数指令确认模块应答正常。接 DS3231读取时间确认数据能读出来。最后接 SD 卡挂载文件系统创建文件成功后再整合。每加一个模块就测一项这样就算出问题也能锁定在新增的环节上。不要嫌麻烦这比整体调试快太多了。4. 软件架构与实现状态机、指纹指令和考勤记录落盘硬件跑通后剩下的工作就是写软件把各个模块串起来。这是最体现从原理到实现的部分也是整个项目里代码量最大的地方。我没有把它写成一个大 while 循环里堆 if而是用一个简单状态机来组织这样后续加功能、修 Bug 都清晰得多。4.1 时钟、显示和按键的基本驱动项目在 STM32CubeIDE 里搭建用 CubeMX 生成基础工程。我同时开了两个串口USART1 接调试终端USART2 接指纹模块。调试串口打印日志非常有用比如每次串口收到原始数据时打印十六进制内容可以快速判断协议解析哪里出了问题。这里分享一个习惯任何串口接收都定义成环形缓冲 空闲中断的结构不要在中断里做耗时的协议解析只把字节放进缓冲主循环去读。OLED 驱动的代码网上有很多成熟库我直接选用现有驱动只改了 I2C 底层。显示逻辑也简单主界面显示当前日期时间加一个请按手指提示打卡成功后显示工号 010 打卡成功加时间录入时显示请放置手指(1/3)这样的步骤。这里不细写显示驱动代码重点说业务逻辑。每次从 RTC 读取时间时注意DS3231 返回的是 BCD 码需要转换。比如寄存器里读到 0x09其实是 9 点。很多新手不看手册直接拿来用结果显示乱码。4.2 指纹录入和搜索的流程设计录入指纹是考勤机的基础功能。我的录入流程如下按键进入录入模式输入一个指纹 ID直接用整数作为工号。模块执行采集图像指令。采集成功后再执行生成特征指令。重复采集两次模块内部会合并生成一个更稳定的模板。执行存储模板指令把这个 ID 存到模块指定编号。这里有个细节指纹模板不是一次按下就存一般要按三次每次生成一个特征模块会把多次特征组合以后存储这样同一个手指再用时识别率更高。如果手指太干或者太湿模块返回质量低错误屏幕上提示用户重新按压。我把这个提示写得很友好换个姿势按别太快。搜索识别流程更简单手指按下后模块先采集图像生成特征然后让模块在指纹库 0 到 N 范围内搜索返回找到的编号和相似度。主控拿到编号后把它当成工号再配上当前时间写入考勤记录。代码骨架大致如下uint8_t enrollFinger(uint16_t userID) { // 三次采集 for (uint8_t i 0; i 3; i) { delay(1200); uint8_t r ps_getImage(); // 采集图像 if (r ! 0) continue; r ps_genChar(0x01); // 生成特征缓冲1 if (r ! 0) continue; } // 合并特征 2/3生成模板 // 存储模板指定ID uint8_t r ps_store(0x06, userID, true); return r; }这里用的ps_getImage、ps_genChar、ps_store等函数名是我从底层驱动封装出来的别名真实对应模块手册里的指令码。封装这类函数时要把返回的确认码统一处理成枚举值比如 0 表示成功其他错误码分别映射到撮失败图像质量低库满等这样上层的 UI 提示就非常直观。4.3 考勤记录存储选 SD 卡还是按内部 Flash这是我在项目里思考了很久的一个点。考勤记录本质是一堆时间 工号的数据存到哪儿直接决定了后期导出的便利性。三个方案摆出来对比存储方案优点缺点STM32 内部 Flash无需额外硬件代码简单容量有限频繁擦写伤寿命外部 SPI Flash W25Q32成本低擦写速度快适合存原始记录导出数据需要额外读逻辑不方便电脑直接使用SD 卡 FATFS容量几乎无限拔卡直读 CSV调试麻烦初始化可能踩坑文件系统占用代码空间最终还是选了 SD 卡。因为我就想在电脑上直接用 Excel 打开考勤表不想再做一套上位机导出工具。STM32F103 的 SPI 接口跑 SD 卡最高也就是 18MHz 左右写一条十几字节的记录耗时在几十毫秒量级对打卡这种低频操作完全能接受。FatFs 文件系统的移植不难CubeMX 里把 SD 卡的 SPI 模式启用然后在中间层实现disk_initialize、disk_read、disk_write几个函数即可。新版本 CubeMX 甚至可以直接生成 FatFs 的移植代码省了很多事。写入记录的代码我这样写FRESULT saveAttendance(uint16_t userID, RTC_DateTime_t dt) { FIL f; char line[64]; if (f_open(f, record.csv, FA_OPEN_APPEND) ! FR_OK) { // 如果文件不存在先创建并写表头 f_open(f, record.csv, FA_CREATE_NEW | FA_WRITE); f_printf(f, time,user_id\r\n); f_close(f); f_open(f, record.csv, FA_OPEN_APPEND); } f_printf(f, %04d-%02d-%02d %02d:%02d:%02d,%d\r\n, dt.year, dt.month, dt.day, dt.hour, dt.minute, dt.second, userID); f_close(f); return FR_OK; }注意f_printf是 FatFs 的可选函数需要在配置里把FF_FS_SUSTAINABLE之类的宏打开实际上要开FF_USE_STRFUNC否则不编译进去。打开以后格式化字符串就要用 ASCII 模式注意中文要转成 UTF-8 或者 GBK 编码不然在电脑上看可能是乱码。我为了避免麻烦CSV 全部用 ASCII时间数字和逗号分隔不存在中文Excel 打开一点问题没有。4.4 主循环状态机考勤机的大脑怎么运转整个程序的主循环不是从上到下一遍一遍跑而是用一个枚举状态变量控制在几个状态之间跳转。我的简化状态定义如下typedef enum { STATE_IDLE, // 空闲等待操作 STATE_MENU, // 菜单录入/清除/设置时间 STATE_ENROLL, // 录入指纹 STATE_DELETE, // 删除指纹 STATE_VERIFY, // 验证打卡 } AppState_t;主循环的逻辑可以概括为扫描按键根据当前状态调用对应的处理函数。比如空闲状态下如果检测到有手指按下通过指纹模块的检测到手指指令或者直接尝试采集就切换到STATE_VERIFY执行搜索搜索结果如果成功蜂鸣器响一声保存记录回到空闲。状态机里最容易忽略的是超时返回空闲机制。比如用户按了录入键但半天不按手指程序不能永远卡在录入状态。我在每个需要用户操作的状态里加了一个超时计数器比如 30 秒无操作自动回到STATE_IDLE并放弃当前未完成的录入。另一个要点是事件触发而非轮询扫描的原则问题。对按键我是这样处理的在主循环里每 20 毫秒扫描一次按键引脚检测到下降沿后做软件消抖连续读两个周期电平一致然后产生一个按键事件这个事件只在状态机的适当分支里消费。如果某些动作耗时较长比如 SD 卡写操作不要放在中断或事件回调里同步执行否则手指按下去后要卡几十毫秒才显示结果体感很差。我推荐的做法是把要写入的数据放进一个队列主循环空闲时消费队列这样打卡显示几乎零延迟。整体主循环的伪代码如下while (1) { handle_button_event(); // 处理按键消抖和事件分发 handle_timeout(); // 状态超时检查 handle_finger_logic(); // 状态机指纹操作 handle_display(); // 根据状态更新 OLED process_log_queue(); // 消费考勤记录写入 SD 卡 }写完之后整个项目的结构非常清楚按键事件产生、状态机响应、业务逻辑执行、数据落盘、结果反馈。后续想加一个打卡语音播报只要在状态机出入口加调用即可。5. 实测与掉坑记录稳定性问题和优化思路硬件软件都跑通不等于稳定。我连续测试了三天把日常使用中遇到的坑一个个记录下来这里挑几个影响最大的展开说。5.1 指纹模块识别不出和乱识别的排查第一天测试时自己录的指纹经常认不出来偶尔还出现认错到别人的情况。我先是怀疑模块坏了后来发现是指纹录入的质量太差。原因是录入阶段我没有强制采集三次指纹偶尔按到第二次就存储了。指纹按压位置、力度不一样特征模板覆盖不全识别时找不到足够匹配的特征点。后来改成三次采集、合并模板拒真率明显下降。还有一次奇怪的现象录入时明明是一个手指同一个手再按却返回另一个 ID 的匹配。排查后发现是录入时 ID 分配错误我在ps_store传的参数把指纹编号和用户 ID混用了。每枚指纹在模块里有一个存储位置0~N而用户 ID 是我自定义的工号。我原来设想工号就是指纹编号一个 ID 只能录一根指头。如果一个人需要录双手就会冲突。这算不上硬件 Bug但提醒我设计时要区分存储槽位和业务工号。后来我做了个改进在 MCU 里维护一张映射表一人分配多个槽位映射到同一个用户 ID。也就是录左手录到槽位 5录右手录到槽位 6两个槽位都对应工号 010。这样就能多人多指了。虽然代码多了一百多行但实用性好很多也把 D 个模块自带的槽位用活了。5.2 严重影响稳定性的 SD 卡写入问题前面说到打卡后要写入 CSV我用的是同步写。第一次测试时发现每写一条记录系统大概要卡 200 毫秒如果刚好这时候有下一个手指按下来指纹模块的采集就会超时导致打卡失败。这很致命。排查后发现两个原因一是 SD 卡在 SPI 模式下初始化后没有把时钟降下来我用的是 18MHz虽然理论上可行但实际卡与卡兼容性差有的卡就是会超时二是写文件后调用f_sync强制回写盘中做了一次长期的物理写操作。解决办法有三个初始化时用低速400kHz挂载成功后切到 12MHz读写时如果出错自动降频重试。打卡时先放进内存队列主循环空闲时批量写入写之前把状态机保持在空闲态。如果对可靠性要求高可以在写入前检查 SD 卡是否插好拔卡时直接把记录暂存在外部 Flash等下次插卡再补写。我最终采用了队列 批量刷写的方式。屏幕上提示打卡成功是即时的实际上数据还在内存队列里200 毫秒后悄悄落到 SD 卡。如果拔卡了就弹个警告音提示数据可能丢失。这个方案既保证体验又避免频繁摩擦 SD 卡。5.3 时间丢失和电池耗尽因为用了 DS3231断电倒是不掉时间但如果纽扣电池没电上电后时间会恢复到底部默认值考勤记录就会出现一堆奇怪的时间。我在程序里加了一个时间合法性检查开机时读出的年份小于某个值就认为 RTC 没有有效备份OLED 上就会闪烁请设置时间并要求按键设置。这算是一个典型的用户引导兜底逻辑。另外 DS3231 内部还有一个温度寄存器可以读出来显示在待机界面上。这个功能很受同事欢迎反正都是顺手。5.4 防指纹套等作弊场景的扩展思考做考勤机很多人会问能不能防别人拿一个指纹套替你打卡坦率讲纯光学指纹模块很容易被硅胶指套骗过因为模块只采集二维图像不做活体检测。几百块的模块都这样除非上电容指纹带心率检测的型号但成本就上去了。我的做法是在产品层面弥补旁边加一个人体红外感应模块打卡时红外必须先感应到人体才允许指纹模块采集。这样就算有人拿指纹套去按红外没检测到热释电信号直接提示未感应到活体。这个方案成本低很多防住了常见的物理替代作弊当然如果对方把指纹套贴在手指上一起按红外也能感应到人那就没法了。这个扩展再次说明做自己的项目的优势想要什么功能顺手就加不用求厂商开放接口。5.5 从原型到成品化的几点经验原型在面包板上能跑但要放到门口长期用有几点必须改进。第一把所有松动的地方换成杜邦线再加扎线带或者干脆打一块 PCB我用了一个周末画板发出去打样回来焊好后稳定性提升明显。第二供电要稳压指纹模块瞬间电流大用 AMS1117 线性稳压可能扛不住压降最好用 DC-DC 降压或者 USB 5V 直供。第三外壳要注意防静电和防潮指纹识别窗口如果不干净识别率会明显下降定期用酒精擦拭最好。还有一点经验程序里所有魔法数字都定义为宏或者枚举比如超时时间、蜂鸣器音调、按键防抖次数。因为你这个项目做完以后多半会想改如果没有集中定义改一个超时结果要翻好几个文件才能找全。自己做考勤机到后来最大的收获不是那台机器而是对整个系统的理解。单看每个模块的示例都觉得简单但把它们组合在一起的时候问题到处都是供电、时序、协议解析、文件系统、状态管理。这些问题每一个都不可怕可怕的是没有条理地乱调。如果你也想动手做我的建议是先按最简方案跑通 打卡 存记录 这个主链路再慢慢加花哨功能。主链路通了这台考勤机就真的能用了后面加的菜单、多人多指、活体检测、温度显示都是锦上添花。最后分享一个小技巧把调试串口的日志级别分成错误/警告/信息三档发布版本里关掉信息档保留错误档以后出问题能快速定位又不至于被日志淹没。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
