STM32指纹考勤机开发实战：从硬件选型到数据存储与串口通信

简介：这是一份基于STM32的指纹考勤机完整设计方案PDF文档，面向嵌入式系统开发者、电子类专业学生及准备毕业设计/课程设计的读者，解决从硬件选型到设备端与上位机联调的整套设计问题。文档共1个PDF文件，整体38.25MB，内容以图文形式完整呈现系统架构、原理图、实物图及代码设计。目前已获得81人学习浏览。文档不仅涵盖AS608指纹模块、ESP8266 WIFI、OLED显示、蜂鸣器等硬件选型与接线说明，还详细给出STM32寄存器级代码设计、指纹录入/识别/删除、考勤时间段判断及SQLite数据管理逻辑；同时包含Qt开发环境搭建、上位机界面设计与考勤数据查询导出等功能实现，可直接作为实际项目开发或教学参考。

1. 低成本指纹考勤机从 0 到 1：为什么选 STM32 而不是移动方案

提到考勤机，很多人的第一反应是买台现成的成品设备，或者直接用手机打卡 App。但在实验室门禁、小团队考勤、课程设计这类场景里，一套基于 STM32 的指纹考勤机仍然有明确的生存空间：它不依赖网络、不依赖手机电量、不需要二次收费，本质上是一个“离线、本地、可验证”的身份识别终端。更重要的一点是，它的技术栈是完整的——从指纹传感器驱动、UART 通信协议、Flash 存储，到 RTC 时间管理和按键交互，全部落在单片机这一层，正好是嵌入式开发者能独立闭环的题目。

这套方案的核心思路并不复杂：主控用 STM32F103 系列，指纹模块通过串口收发指令，识别成功后把考勤记录（员工 ID + 时间戳）写入外部 EEPROM 或 SPI Flash，配合 OLED 屏和按键完成用户交互。全文围绕“识别链路”和“数据落盘”两条线展开，先讲硬件选型和通信协议，再写存储与时间管理，最后给出调试时最容易踩的坑。文中代码基于 STM32 标准外设库书写，使用的指纹模块型号以 AS608 为参考，如果你手里的模块是 R30X 或 ZFM 系列，指令集基本兼容，可以对照手册微调。

2. STM32 指纹考勤机的硬件选型：主控、传感器与存储方案

2.1 主控选型：STM32F103C8T6 的 IO 资源和性价比边界

做考勤机不需要跑系统，也不需要复杂的 DSP 运算，核心诉求是“UART 够用、Flash 够存、功耗可控”。STM32F103C8T6 属于中等容量产品线，72 MHz 主频、64 KB Flash、20 KB SRAM，外部资源包括 3 个 USART、2 个 I2C、2 个 SPI、37 个 GPIO，在这个场景里 IO 资源非常宽裕。更重要的是，它的 LQFP48 封装可以直接手工焊接，打样成本低，网上可参考的开源资料密度也远超 G030 等新系列。

如果你把手头的 MCU 换成 GD32F103 或 APM32F103，引脚兼容但寄存器和启动文件有差异，尽量不要直接在 Keil 里替换 Device，建议新建工程再迁移代码。另外，如果用 STM32F103ZET6 做开发板做原型验证，后面转 C8T6 时需要检查串口引脚是否有冲突，因为 ZET6 的板载 LED 和按键占用的端口和 C8T6 的默认配置不一致。

2.2 指纹传感器：AS608 的光学传感器与 UART 通信方式

AS608 是市面上最常见的电容/光学两用指纹模块之一，工作电压 3.3V，内部集成了 DSP 处理单元，指纹图像的采集、特征提取和比对都在模块内部完成，MCU 只需要通过串口发送命令帧并解析返回帧。这一点非常关键：指纹算法（比如 minutiae 特征点匹配）的复杂度在资源受限的 MCU 上跑起来效率很低，AS608 把这块封装好了，STM32 的工作量就从“算法实现”变成了“协议解析”。

模块默认通信参数是 115200/8/N/1，有 6 根引脚：VCC、GND、TXD、RXD、TOUCH（触摸感应输出，有人按传感器时拉高）、WAKEUP（唤醒输出）。实际项目中 TOUCH 引脚可以做低功耗唤醒：F103 进入 STOP 模式后，通过外部中断唤醒，再启动串口通信。不过要注意，AS608 的 TOUCH 输出电平是 3.3V，在 5V 供电系统中必须做电平匹配，否则长时间使用有烧引脚风险。

AS608 的指令帧格式统一为：包头（0xEF 0xAB）+ 芯片地址（默认 0x00000000 + 2 字节命令），后面跟命令字、参数和校验和。以“采集指纹图像并生成特征值”为例，命令字为 0x01，参数为缓冲区 ID（0x01 或 0x02），也就是把第一次按压的指纹特征存入 ImageBuffer，然后命令字 0x02 把特征值从 ImageBuffer 生成到 CharBuffer1。完整的通信过程需要三次交互：按手指采集图像、生成特征、合成模板并存入模块 Flash。

2.3 存储方案：AT24C02 与外部 SPI Flash 的分工

当指纹模板本身就存在模块内部 Flash（AS608 最多存 300 个指纹模板）时，考勤机主控要存的是另一个维度的数据：员工 ID、打卡时间、打卡类型（上班/下班）。这类记录的特点是连续写入、单条数据小、需要掉电保存，且具备一定的顺序性。

AT24C02 是 256 字节的 I2C EEPROM，在考勤机里适合存“系统配置”：设备编号、当前指纹表索引、最近一次时间校准值。它的写入速度慢（单页写约 5ms），循环擦写寿命约 100 万次，不适合做频繁写入的日志。考勤记录建议外挂 SPI Flash，比如 W25Q32，容量 4 MB，可以存约 2 万条“4 字节员工ID + 4 字节时间戳 + 1 字节记录类型”的记录。W25Q32 的擦写寿命也是 10 万次左右，按一天 4 条记录计算，理论寿命接近 68 年，足够覆盖设备生命周期。

如果为了简化布线，也可以把考勤记录直接存到 STM32 的内部 Flash。F103C8T6 的 64 KB Flash，用最后 4 KB 模拟一个小型记录区，能存大约 470 条记录，适合原型验证。但要注意：内部 Flash 和外部 SPI Flash 使用的驱动完全不同，代码里要有统一的“记录读写”抽象层，避免上层逻辑在切换存储介质时大面积改动。

3. 指纹考勤机核心链路：STM32 与指纹模块的串口指令交互

3.1 UART 初始化与指令帧封装：从字节流到有效指令

STM32 与 AS608 之间的通信是典型的“查询-应答”模式，MCU 发指令帧，模块回响应帧。初始化串口时注意三个细节：开启 GPIO 时钟和 USART 时钟、设置 TX 为复用推挽输出、RX 为浮空输入。指纹模块的 RXD 和 STM32 的 TX 直连，VCC 用 3.3V 供电，不能直接接 5V。

void Finger_USART_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); // TX=PA9, RX=PA10 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); USART_InitStructure.USART_BaudRate = 115200; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE); }

这里的波特率必须和指纹模块匹配，AS608 出厂默认 115200，如果之前被改过，需要先发 0xEF 0xAB 0x00 0x00 0x00 0x00 0x03 0x01 0x00 0x05 之类的波特率设置指令恢复。另一个容易忽略的点是 DMA：串口接收用中断逐字节接收时，在 115200 波特率下每个字节间隔约 87 微秒，如果主循环里有较长的 Flash 写入操作，可能来不及接收完整帧。建议用 IDLE 中断 + DMA 收包，或者至少把接收缓冲做到 128 字节以上。

3.2 核心命令：录入指纹、搜索比对、删除模板的帧格式

指纹考勤机最常用的命令集中在“录入模板”“1:N 搜索比对”“删除模板”三个操作。下面是一段完整的录入指纹代码，分成采集图像、生成特征、合成模板到模块 Flash 三步执行。

uint8_t Finger_Enroll(uint8_t slot_id) { uint8_t buf[16]; uint16_t recv_len; // Step1: 采集指纹图像, 命令 0x01 buf[0] = 0xEF; buf[1] = 0xAB; buf[2] = 0x00; buf[3] = 0x00; buf[4] = 0x00; buf[5] = 0x00; buf[6] = 0x01; buf[7] = 0x01; // 命令字 buf[8] = 0x00; // 参数: 无 uint8_t sum = 0; for (int i = 6; i < 9; i++) sum += buf[i]; buf[9] = sum; USART_SendBytes(buf, 10); // 等待 0x01 响应, 确认按压成功 // Step2: 生成特征存 CharBuffer1, 命令 0x02, 参数=0x01 buf[6] = 0x02; buf[7] = 0x01; buf[8] = 0x00; sum = 0; for (int i = 6; i < 9; i++) sum += buf[i]; buf[9] = sum; USART_SendBytes(buf, 10); // 响应后提示"抬起手指", 再按第二次 // Step3: 合成模板写入模块 Flash, 命令 0x05, 参数: 缓冲ID(0x01)+缓冲ID(0x01)+slot_id buf[6] = 0x05; buf[7] = 0x01; buf[8] = 0x01; buf[9] = slot_id; sum = 0; for (int i = 6; i < 10; i++) sum += buf[i]; buf[10] = sum; USART_SendBytes(buf, 11); // 根据响应的高位确认是否成功 return 1; }

代码里要注意校验和的计算范围：从命令字开始到参数最后一个字节，包头的 6 个字节不参与校验。AS608 的响应帧同样遵循这一规则，所以解析响应时先验证校验和再处理数据，避免通信干扰导致误判。搜指纹的命令是 0x04，参数为缓冲 ID（0x01）、起始页（0x00）、页数（0x00 0xA0，即搜索 160 页），返回的页码就是员工 ID。这一步是考勤机识别链路的核心：页码对应到员工，时间戳写进记录区。

3.3 串口数据粘包与超时处理：为什么你的考勤机偶尔不识别

实践中遇到最多的问题是“指纹录入了，但识别时经常超时”。这往往不是指纹模块的问题，而是 STM32 的串口接收处理不够健壮。AS608 返回的帧长度不固定，比如搜索成功返回 16 字节，失败返回 12 字节；如果 MCU 用简单的“收到就处理”逻辑，可能只收到半包数据就进入解析状态。

一个可靠的收包方式是使用状态机：等待包头 0xEF 0xAB，然后接收地址、命令、长度和数据，全部收满后再整体解析。下面给出最小实现思路：

typedef enum { WAIT_HEAD1, WAIT_HEAD2, WAIT_REST, WAIT_DATA } RECV_STATE; uint8_t rx_buf[64]; uint8_t rx_len = 0; RECV_STATE state = WAIT_HEAD1; void USART1_IRQHandler(void) { uint8_t byte = USART_ReceiveData(USART1); switch (state) { case WAIT_HEAD1: if (byte == 0xEF) state = WAIT_HEAD2; break; case WAIT_HEAD2: if (byte == 0xAB) { state = WAIT_REST; rx_len = 0; } else state = WAIT_HEAD1; break; case WAIT_REST: rx_buf[rx_len++] = byte; if (rx_len >= 6) { // 地址(4) + 命令(1) + 校验(1) uint8_t len = 0; // 根据命令字判断后续包体长度, 简化写法直接从 buf[6]解析 state = WAIT_DATA; } break; case WAIT_DATA: rx_buf[rx_len++] = byte; if (rx_len >= expect_len) { // 整帧收完整, 置标志位 frame_ready = 1; state = WAIT_HEAD1; } break; } }

除了解析状态机，超时机制同样必要。指纹按压后模块响应时间在 200ms 到 1s 之间波动（取决于图像质量），如果超过 2s 没收到完整帧，必须复位接收状态，否则下一帧数据会错位。建议在 SysTick 中断里维护一个 100ms 的计数变量，超时清空缓冲区重新等待包头。

4. 考勤数据管理：从指纹 ID 到本地存储和时间戳的完整链路

4.1 RTC 时间管理：STM32 内部 RTC 的精度、备份域与掉电保持

考勤记录的“时间戳”依赖 RTC，但 STM32F103 的内部 RTC 基于 32.768kHz 外部低速晶振（LSE）驱动，如果硬件上没有焊接这个晶振，RTC 只能在 HSE 分频下跑，断电即丢失。设计时最好在 PCB 上预留 LSE 晶振位置（两个引脚 + 两个 6~9pF 负载电容），这样才能在系统掉电时依靠 VBAT 的纽扣电池维持计时。

软件层面，RTC 设定时间后要检查备份域寄存器（BKP_REG）的合法性标志，防止主电源掉电再上电后 RTC 回到 1970 年。常见的处理方式是把校准时间写入 BKP 寄存器作为 flag，每次启动时读取并判断：

void RTC_CheckAndInit(void) { if (BKP_ReadBackupRegister(BKP_DR1) != 0xA5A5) { // 首次启动或备份域掉电, 需要重新设置时间 RTC_SetTime(2025, 1, 1, 8, 0, 0); // 默认时间 BKP_WriteBackupRegister(BKP_DR1, 0xA5A5); } // 否则 RTC 直接使用备份域中的计数值, 无需重新配置 }

RTC 初始化必须在 PWR 和 BKP 时钟使能之后执行，而且对备份域的写操作要先开启写保护（PWR_BackupAccessCmd(ENABLE)）。如果发现设备每次重启都回到默认时间，首先检查 LSE 是否起振，用RCC_GetFlagStatus(RCC_FLAG_LSERDY)验证。

4.2 考勤记录的存储结构：定长记录与环形缓冲设计

在考勤机这种嵌入式场景，记录的存储结构越简单越可靠。我倾向于使用定长记录，而不是 CSV 或 JSON 这类可变长格式，因为定长记录在擦写、查找和删除时都只需要简单的偏移量计算。下面定义一个 16 字节的考勤记录结构：

typedef struct { uint32_t timestamp; // Unix 时间戳, 占 4 字节 uint16_t emp_id; // 员工 ID, 占 2 字节 uint8_t type; // 0=上班, 1=下班 uint8_t reserved[9]; // 预留字段, 可用于存储校验值 } AttendRecord;

用 W25Q32 存储时，将 Flash 从地址 0 开始划分为固定大小的记录区：每条记录 16 字节，记录总数 = 4MB / 16 = 262144 条。实际使用中不需要这么深，按整个 Flash 只存 4096 条记录来设计（占用 64KB），剩余空间留给将来的 OTA 固件或指纹模板备份。

写入时维护一个记录指针变量，每次写入后指针 +1，指针位置同样存到 AT24C02 里。当指针到达末尾时回卷到 0，覆盖最早记录——这就是环形缓冲的做法。这样做的好处是存储区写入磨损被均匀分摊，而且不需要每次开机扫全盘找空位。代码里对 W25Q32 的操作先要擦除扇区（4KB 对齐），不能像 EEPROM 那样逐字节改写，所以写入记录的逻辑是：如果当前记录号是 256 的倍数（即到达扇区边界），先擦除对应扇区再写。

4.3 指纹考勤机导出考勤记录：串口从机协议与 PC 端解析

考勤机本地存储的数据最终要导出来处理，这一步通常是串口上位机完成。STM32 工作在从机模式，收到 PC 发送的命令后，从 Flash 读记录并分批发送。为了避免一次发送数据量太大导致缓冲区溢出，建议每帧最多打包 8 条记录，逻辑如下：

void Export_Records(void) { uint32_t total = Get_Record_Count(); // 从 AT24C02 中读取 uint16_t offset = 0; while (offset < total) { AttendRecord rec; W25Q32_Read(offset * sizeof(AttendRecord), &rec, sizeof(rec)); USART_SendBytes((uint8_t*)&rec, sizeof(rec)); offset++; Delay_ms(5); // 给上位机留出处理时间 } }

上位机这边用 Python 的 pyserial 接收，解析 16 字节定长结构即可。PC 端需要注意的问题是串口缓冲区的读入速度远快于 USB 虚拟串口的刷新速度，建议用serial.read(16)循环读取，保证每条记录对齐。时间戳如果存的是 Unix 时间，解析时用本地时区做偏移转换；如果直接存的是“年/月/日/时/分/秒”的 BCD 码，就不存在时区问题，但排序和比较时要转成整数再做。

5. 实战调参：指纹考勤机的 3 个核心参数与 4 个常见故障排除

5.1 三个必调参数：安全等级、波特率和识别超时时间

AS608 模块有一个可配置的安全等级参数（从 1 到 5，等级越高误识率越低，拒识率也越高），默认值是 3，在考勤场景建议调到 3 或 4。安全等级为 5 时，同一个手指多次按压可能因为按压角度和力度差异而验证失败，反而把真正的考勤人员挡在外面。等级为 1 时安全度不足，一个人的指纹可能匹配多个模板，造成代刷或错刷。

波特率参数在批量部署时也要统一确认。有些模组出厂是 9600，有些是 115200，如果代码里写死 115200，上电后不做握手，模块不响应，设备就无法录入指纹。建议上电后先发一条“读系统参数”指令（0x0F），尝试从响应帧中解析模块的当前波特率和容量，解析失败时轮询切换到 9600 再试一次。这样做的成本很低，但能显著提高设备对“二手模块”或“不同批次模块”的兼容性。

识别超时时间从用户体验角度建议设为 2 秒：低于 1 秒，用户手指放上去还没稳就触发拍照，导致图像模糊；大于 3 秒，排队打卡时效率明显下降。这个超时是指“从 TOUCH 引脚触发到比对结果返回”的完整时间，如果经常在接近超时阈值时才识别成功，优先检查按压姿势和传感器表面清洁度，而不是盲目调高安全等级。

5.2 指纹考勤机电路设计的常见错误：电平匹配、电源纹波、复位电路

硬件层面最容易被忽视的是指纹模块的电源质量。AS608 内部有光学传感器和 DSP，工作时电流峰值约 50mA，如果和 STM32 共用一根细长的杜邦线接 3.3V，线阻会造成瞬间压降，模块表现为“有时候能录入，有时候搜不到指纹”。正确做法是模块电源单独走线，在模块 VCC 引脚就近放一个 10uF 钽电容和 0.1uF 陶瓷电容滤波。如果系统只有 5V 供电，使用 AMS1117-3.3 时要注意输入输出压差在低负载下只有约 1V，5V 输入尚可，但纹波大的开关电源会导致 3.3V 输出飘动，严重时指纹模块直接重启。

复位电路方面，STM32 的 NRST 引脚接 10kΩ 上拉电阻、0.1uF 电容到地是标准配置。少数开发板上省略了这两个元件，用下载器仿真时一切正常，但独立供电上电时偶尔启动失败。如果考勤机批量出现“上电白屏/无响应，按一下复位就好”的现象，优先查 NRST 引脚波形，正常情况下上电期间应该能看到一个由低到高的斜坡信号。

5.3 已发现问题的快速定位方法：串口日志分级与关键节点打印

调试考勤机时，不要一上来就用仿真器单步跟踪，效率太低了。我在代码里加一套极简的串口日志分级函数，按模块划分输出开关：

#define LOG_FINGER 1 // 指纹模块状态 #define LOG_RECORD 2 // 考勤记录写入 #define LOG_RTC 3 // RTC 时间同步 #define LOG_APP 4 // 主循环状态转移 void Log_Print(uint8_t module, char *fmt, ...) { if (!(log_mask & (1 << module))) return; // 通过 USART2 输出, 如下是伪代码 printf("[%s]", module_name[module]); // va_list 处理格式化参数 }

调试串口和指纹串口分开用，推荐 STM32 的 USART2 接一个 USB 转 TTL 模块做日志输出，不占用和 AS608 通信的 USART1。这样在部署现场也能接笔记本实时观察“指纹识别成功 - 正在写 Flash - 写入完成”的完整链路，哪一步卡住，日志里一目了然。另一个技巧是在每次识别流程结束后，把模块返回的状态码原样打出来——比如 0x01 表示接收数据出错，0x0C 表示指纹库已满，这些信息远比“识别失败”四个字更有诊断价值。

6. 进阶优化：给 STM32 指纹考勤机加一个低功耗模式

考勤机在非使用时段是空闲的，如果一直让 STM32 和指纹模块保持全速运行，整体功耗在 80mA 左右，对电池供电场景是不够的。把设备改造成“有人按指纹才工作”的低功耗模式，思路是让 STM32 进入 STOP 模式，用外部中断唤醒。具体实现包括三个动作：进入 STOP 前关闭不需要的外设时钟，把指纹模块的 TOUCH 输出接在 STM32 的一个 EXTI 引脚上，唤醒后在中断服务函数中恢复系统时钟并重新初始化串口。

void Enter_LowPower_Mode(void) { // 关闭不需要的 USART 和 SPI USART_Cmd(USART1, DISABLE); SPI_Cmd(SPI1, DISABLE); // 配置 TOUCH 引脚为 EXTI 下降沿中断唤醒 EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); // 进入 STOP 模式 PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI); SystemInit(); // 唤醒后重新设置系统时钟 }

代码里有一个值得注意的细节：唤醒后必须调用SystemInit()重新配置时钟树，否则系统会停留在原始 HSI 频率下运行，串口波特率计算全部错误，和指纹模块的通信直接失败。另外，指纹模块本身的功耗也需要管理，AS608 在待机时仍有 10mA 左右的电流，更强的做法是给模块电源加一个 MOS 管开关，STM32 休眠前关闭模块供电，只有检测到触摸信号后才恢复供电。不过触发电平本身来自模块的 TOUCH 引脚，如果断电后该引脚失去输出能力，需要改用一个轻触按键作为唤醒源，或使用 AS608 的 WAKEUP 引脚接一个 PNP 三极管来控制电源路径。这个设计取舍没有标准答案，取决于外壳上是否允许开孔装按键，认识清楚了，低功耗改造不过是系统设计里另一个待解的闭环而已。

本文还有配套的精品资源，点击获取