简介：基于STM32的指纹签到系统，属于高分毕业设计完整项目资源，适合嵌入式、自动化、电子信息、通信工程等专业学生用于毕业设计、课程设计或大作业。项目以STM32为主控，配合指纹识别模块完成身份采集、签到记录与结果展示，工程代码涵盖了底层驱动、系统业务逻辑以及上位机交互界面等部分。压缩包内共398个文件，以C语言源文件和头文件作为程序主体，同时提供Keil工程配置文件、可直接烧录的HEX文件、AXF调试文件、原理图截图、详细说明文档及若干辅助脚本，整体约14.75MB，目录划分明确，便于按模块学习。目前已有111人学习，代码经过运行验证且答辩评分达到95分，可靠性较高。附带文档可帮助快速构建工程并理解源码流程，也便于扩展考勤统计、权限管理或数据库导出等功能，对嵌入式学习和课设/毕设均有参考价值。

1. 指纹签到系统到底在做什么：一个STM32工程包背后的完整方案

你有没有遇到过这种场景：实验室签到本来用纸笔，老师却总怀疑有人代签；考勤机用指纹，可那台设备几百上千元，还闭源。标题里那个"基于STM32的指纹签到系统"的zip，本质上是把一套可以自制的课堂——把光学指纹模块、OLED屏、EEPROM和RTC组装成一台能录入、能比对、能存记录的低成本签到机。对做毕业设计或第一次上手STM32项目的人来说，这类包真正的价值不是给你一个能烧录的hex，而是让你看懂"传感器数据怎么进MCU、比对结果怎么落盘、异常场景怎么兜底"这一整条链路。这篇笔记就顺着标题拆成六步：选型、协议、初始化、业务逻辑、排障和交付验证，照着做，周末就能把它从原理图变成桌子上的实物。

2. 从硬件选型到通信协议：指纹签到系统的设计骨架

2.1 指纹模块为什么选R307/AS608而不是电容式传感器

指纹模块分两类：一类是手机里那种电容式指纹头，体积小、识别快，但接口多为I2C/SPI，而且特征提取算法要自己在MCU上跑，对新手不友好；另一类是光学指纹模块，市面上最常见的型号就是R307和AS608，模块内部自带DSP，负责采集图像、提取特征点和生成模板，对外只暴露出一个UART串口。你给它发一条"录入图像"的指令，它就把手指按下的图像处理成特征数据；再发一条"搜索模板"的指令，它就在自己的Flash里做1:N比对，然后把ID和匹配分数返回给你。

选R307/AS608的理由很实际：第一，价格低，十几到二十几元一片，学生党负担得起；第二，资料多，几乎每个电赛培训视频都在讲它，代码库随便一搜就是一大把——但源码质量参差不齐，后面章节我们会讲怎么筛掉那些坑人的片段；第三，UART协议简单，任何一个MCU只要有一个串口就能驱动它，不涉及复杂时序。需要注意，这类光学模块对手指干燥、按压角度比较敏感，但签到场景本身容忍你多按两次，所以这点不算缺点。

2.2 UART通信与指纹数据包格式：读ID、比对、录入的命令怎么拼

指纹模块看起来是黑匣子，但它的通信协议其实非常死板。以常见的AS608为例，上位机发送的每帧数据由包头、地址、包标识、包长度、指令码和数据组成。包头固定是0xEF01，默认地址通常是0xFFFFFFFF，包标识区分命令包、数据包和应答包。校验和用的是累加和，不需要加密，也不需要用查表法去算CRC。这套帧格式你只要封装好一个发送函数，后面所有指令都复用同一个函数。

// 发送一个不带指纹数据的命令帧 void fp_send_command(uint8_t cmd, uint16_t data_len, uint8_t *data) { uint8_t frame[64]; int i, idx = 0; uint16_t sum = 0; frame[idx++] = 0xEF; // 包头高字节 frame[idx++] = 0x01; // 包头低字节 frame[idx++] = 0xFF; // 地址高 frame[idx++] = 0xFF; frame[idx++] = 0xFF; frame[idx++] = 0xFF; frame[idx++] = 0x01; // 包标识：命令包 frame[idx++] = data_len >> 8; // 包长度高字节 frame[idx++] = data_len & 0xFF; frame[idx++] = cmd; // 指令码 for (i = 0; i < data_len; i++) { frame[idx++] = data[i]; sum += data[i]; } sum += cmd + (data_len >> 8) + (data_len & 0xFF); frame[idx++] = sum >> 8; frame[idx++] = sum & 0xFF; HAL_UART_Transmit(&huart1, frame, idx, 100); }

这个函数的逻辑不复杂：先填固定字段，再把指令码和数据放进缓冲区，最后把累加校验和追加在末尾。参数说明：cmd是操作码，比如0x07录入图像、0x08生成特征、0x09合并特征、0x0A存储模板、0x02搜索指纹；data_len是data数组的长度，如果命令没有附加数据（比如"录入图像"），就传入0，这样整个帧体只有指令码。校验和的计算是从包长度高字节开始，一直到数据区结束的累加和，注意不要漏掉指令码本身，否则模块会回一个校验错误。

2.3 存储与时钟：AT24C02保存员工ID，RTC保证签到时间真实

指纹模板存在指纹模块自己的Flash里，最多能存几百个，但"这个ID对应哪个员工"以及"他在几点几分签的到"，必须由MCU侧记录。常见的低成本方案是用AT24C02 EEPROM，它只有2Kbit，也就是256字节，存不了多少记录，所以我会把它拆成两段：低128字节存员工姓名或编号映射，高128字节循环存放最近的签到记录。每条记录需要时间戳和ID，压缩成4字节（ID占1字节，时间用UNIX时间戳的低3字节），这样一圈能存32条。如果需求是上千条签到记录，那就不该用EEPROM，要外挂SD卡或通过串口上报到上位机。

RTC我一开始直接用STM32F103的内部RTC，省掉外部芯片，结果发现每次断电池再上电，时间就回到2000年。后来换成DS3231，精度高而且带温度补偿，虽然多花十几块钱，但不用再担心"签到时间不准"这种让人头疼的问题。DS3231通过I2C接口连接，配置时只要把SCL和SDA分别接到STM32的PB6和PB7，再用一个普通GPIO接INT脚可选。时间读回来之后，直接拼成字符串显示在OLED上即可。

3. 搭建STM32最小工程：引脚、时钟与UART初始化

3.1 用标准库还是HAL库新建工程

刚开始接触这类项目，纠结最多的问题就是"用标准库还是HAL库"。我的建议是：如果你手里有一个能跑的模板，不管它是什么库，先跑通再说；如果是全新的工程，直接选HAL库，理由很简单——STM32CubeMX可以帮你生成引脚配置和时钟树，不用一页页翻参考手册去算PRESCALER。对于指纹模块这种单纯的UART通信，HAL的抽象层足够薄，不会掩盖关键逻辑。真正需要关心的不是库，而是中断回调、串口接收缓冲和超时处理这三件事。

一个完整的工程至少要有四个文件夹：Core（启动文件和main）、Hardware（自己写的传感器驱动）、Driver（指纹、OLED、EEPROM等外设驱动）、Middlewares（如果有RTC库或者FreeRTOS）。这种分层方式不是为了美观，而是你调试的时候能快速定位：串口收不到数据，先查Driver；签到逻辑不对，直接找Hardware和业务代码。

3.2 GPIO、USART1与定时器的初始化代码

下面用HAL库写最关键的初始化。指纹模块接USART1：PA9做TX发命令，PA10做RX收应答。串口参数为波特率57600（以你的模块说明书为准，有的出厂是9600），8数据位、无校验、1停止位。打开USART1全局中断，使能接收。另外还要配置一个用于IO口控制的GPIO（比如指纹模块的触摸检测脚，可不接）。

void MX_USART1_UART_Init(void) { huart1.Instance = USART1; huart1.Init.BaudRate = 57600; // 务必与指纹模块实际波特率一致 huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; HAL_UART_Init(&huart1); HAL_UART_Receive_IT(&huart1, (uint8_t *)rx_buf, 1); // 单字节接收中断 }

初始化里有两个关键点。第一，HAL_UART_Receive_IT每次只接收1个字节，接收完会进回调函数，必须在回调里重新调用这个函数，形成持续接收的效果——很多人忘了这一点，结果只收到第一个字节。第二，波特率错了是串口通信里最隐蔽的坑，模块没有返回任何数据时，先拿示波器或者串口助手去量量模块的TX脚，看波形频率是不是符合预期。

3.3 串口中断接收指纹模块7500波特率的应答帧

指纹模块的应答帧长度不固定，最短的命令应答是10字节，录入图像时会有数据包返回，搜索时返回的内容更长。所以我在中断回调里用一个状态机：先接收包头0xEF和0x01，确认后用缓存拼装帧，等收满"包标识+包长度"字段后，通过包长度算出还需要接收多少字节。这样避免固定缓冲每次都要解析偏移量。

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart->Instance == USART1) { static uint8_t rx_state = 0; static uint8_t rx_index = 0; static uint16_t expect_len = 0; // 处理当前接收的字节 rx_buf[0] if (rx_state == 0) { // 等待包头第1字节 if (rx_buf[0] == 0xEF) rx_state = 1; else rx_state = 0; } else if (rx_state == 1) { // 等待包头第2字节 if (rx_buf[0] == 0x01) { rx_state = 2; rx_index = 0; frame_buf[rx_index++] = 0xEF; frame_buf[rx_index++] = 0x01; } else { rx_state = 0; } } else if (rx_state == 2) { frame_buf[rx_index++] = rx_buf[0]; if (rx_index == 4) { // 收到第4字节后，后面是包长度 rx_state = 3; } } else if (rx_state == 3) { frame_buf[rx_index++] = rx_buf[0]; if (rx_index == 6) { expect_len = (frame_buf[4] << 8) | frame_buf[5]; // 包长度字段 rx_state = 4; } } else if (rx_state == 4) { frame_buf[rx_index++] = rx_buf[0]; // 6字节起始，加上2字节校验，总长 = 6 + expect_len + 2 if (rx_index >= 6 + expect_len + 2) { rx_state = 0; fp_frame_done(frame_buf, rx_index); // 交给上层解析 } } HAL_UART_Receive_IT(&huart1, (uint8_t *)rx_buf, 1); // 继续接收 } }

这个状态机里，frame_buf是全局缓冲区，fp_frame_done是协议解析函数。参数说明：expect_len来自帧里的包长度字段，表示后面要跟随的数据字节数，不包含校验和。我跳过了对包头、地址、包标识的合法性校验，实际项目里建议至少校验一下地址和校验和，否则噪声干扰很容易把假应答当成真数据。

4. 实现录入与签到核心逻辑：源码级拆解

4.1 指纹录入流程：三次按压与合并特征

指纹录入不是"按一次就完事"。模块在录入图像，必须连续采集三次按压，每次提取出一个特征模板，最后合并这三个模板，生成的综合模板才更抗噪。流程通常是这样：先发0x07命令让用户按手指，返回成功后再发0x08生成特征，三次之后发0x09合并特征，最后发0x0A把合并后的模板存入指定ID号。

uint8_t fp_enroll(uint16_t id) { int ret; uint8_t i; for (i = 1; i <= 3; i++) { // 第i次按压，等待模块返回确认 ret = fp_CMD(0x07, 0, NULL, 3000); // 超时3秒，等待用户按压 if (ret != 0x00) { return ret; // 失败，比如超时、错误 } // 生成特征模板，模板号用0x01 ret = fp_CMD(0x08, 1, (uint8_t[1]){0x01}, 3000); if (ret != 0x00) { return ret; } } // 合并特征：模板号1和2合并到3 uint8_t merge_param[2] = {0x01, 0x02}; // 源模1、源模2合并到目标模3 ret = fp_CMD(0x09, 2, merge_param, 3000); if (ret != 0x00) return ret; // 存储模板到ID uint8_t store_param[2] = {(id >> 8) & 0xFF, id & 0xFF}; ret = fp_CMD(0x0A, 2, store_param, 3000); return ret; }

这段代码里的fp_CMD是封装了"发指令+等应答"的函数，它会阻塞等待模块应答，超时返回错误码。参数说明：0x07命令没有附带数据，所以数据长度0；0x08后面跟一个字节的缓冲号，范围一般是0x01到0x04；0x09后面跟两个字节，第一个是源模板号，第二个是内定目标模板号；0x0A后面跟一个2字节的ID，高字节在前。实际调试时，如果第一次按压失败，模块会直接返回错误码，这时不要继续发第二次按压命令，必须重新发0x07。

4.2 签到比对流程：1:N搜索与超时重试

签到比对就是让用户按一下手指，模块在库中搜索匹配的ID。我用的是0x02命令，从页码0开始搜索所有模板。模块返回的数据里包含匹配ID和得分，得分越高说明越可靠。如果返回"未找到"或超时，就提示用户重新按压，最多重试3次，避免有人手指脱皮导致连续失败。

uint8_t fp_search(uint16_t *matched_id, uint16_t *score) { uint8_t params[4] = {0x00, 0x00, 0xFF, 0xFF}; // 起始页0，搜索最后两页（通常全库） uint8_t resp[32]; int ret = fp_CMD_with_data(0x02, 4, params, resp, 5000); if (ret != 0x00) return ret; // 应答数据的最后一个ID字段位于固定偏移位置，前导字节是确认码 *matched_id = (resp[2] << 8) | resp[3]; *score = (resp[4] << 8) | resp[5]; return 0x00; }

这里有个很关键的细节：fp_CMD_with_data返回给resp的是完整应答帧里的数据区，不同模块的应答偏移量可能差一个字节，所以你在移植别人的源码时，必须先用串口打印原始帧，数清楚ID到底在第几位，再写解析。我曾经图省事直接按教程的偏移量解析，结果模块返回的分数一直是0，最后才发现厂商对数据区的封装差了2个字节。

4.3 签到记录落地：EEPROM地址分配与RTC时间戳写入

比对成功之后，要把"ID+时间"存入AT24C02。为了不频繁擦写，我定义了一个结构体，每次写入前先读当前记录计数，写入后把计数加1。如果计数到达最大值，就把它清零并从头覆盖，形成一个环形缓冲区。

typedef struct { uint8_t year; uint8_t month; uint8_t day; uint8_t hour; uint8_t min; } time_record_t; typedef struct { uint16_t id; time_record_t time; } log_entry_t; #define LOG_START_ADDR 0x80 #define LOG_ENTRY_SIZE 6 // 2字节ID + 4字节BCD时间 #define LOG_MAX_ENTRY 32 void log_store_records(uint16_t id, RTC_TimeTypeDef *time, RTC_DateTypeDef *date) { log_entry_t entry; uint8_t record_count = 0; EEPROM_ReadBytes(0, &record_count, 1); entry.id = id; entry.time.year = date->Year; // 注意HAL里的Year是2位数 entry.time.month = date->Month; entry.time.day = date->Date; entry.time.hour = time->Hours; entry.time.min = time->Minutes; if (record_count < LOG_MAX_ENTRY) { EEPROM_WriteBytes(LOG_START_ADDR + record_count * LOG_ENTRY_SIZE, (uint8_t *)&entry, sizeof(log_entry_t)); record_count++; EEPROM_WriteBytes(0, &record_count, 1); } else { // 环形覆盖最老的一条 EEPROM_WriteBytes(LOG_START_ADDR, (uint8_t *)&entry, sizeof(log_entry_t)); } }

这段代码把记录写入放在EEPROM的前半段，后半段留给指纹ID和姓名映射。参数说明：LOG_START_ADDR定义在EEPROM地址0x80，前0x00-0x0F用来存记录计数，0x10-0x7F留给用户表。EEPROM单次写页最多8字节，如果结构体超过8字节，要拆成多次写，否则会出错。注意：AT24C02写入需要至少5ms的写周期，写完不要马上读，建议加个3-5ms延时。

5. 避坑指南：指纹签到系统最常见的5个翻车点

5.1 现象：录入时返回0x07（指纹质量差）

录入指纹时，前面几个步骤都正常，但到了0x07就返回错误码0x07，模块说明书把它解释为"图像模糊，质量太差"。你连续按了五六次还不行，就开始怀疑模块坏了。

原因：最常见是手指按压时用力不均匀，或者传感器表面有残留的油脂、灰尘。光学模块需要一个相对平整的接触面，手指干燥脱皮也会导致特征点无法提取。另外，有些模块对按压时间有要求，按得太快（小于0.5秒）也会报错。

解决：先用干净软布擦拭传感器玻璃片，让手指保持微湿（哈口气或洗手后擦干），按下去时稍微用力并使指尖全面覆盖窗口。如果是干燥季节，建议用护手霜或指纹润湿剂辅助，这在实验室里属于常规操作。

5.2 现象：模块发数据但STM32收不到

在调通信时，用逻辑分析仪能看到指纹模块TX脚有波形，但STM32的接收缓冲区一直是0，HAL_UART_Receive_IT好像没生效。

原因：第一个原因是模块和STM32没有共地。很多新手只接了TX、RX和VCC，忘接GND，结果模块输出高电平参考电压和MCU不一致，产生不了有效的串口电平。第二个原因是波特率不匹配，模块默认57600，而你在CubeMX里选了9600，两边波形宽窄不同，解出来的全是被丢弃的噪声。

解决：先检查模块的GND是否和STM32的GND连在一起；再打开串口助手，把模块的TX直接接到USB转TTL，手动测出模块实际波特率。如果模块的TX拔掉后接到STM32收到的还是乱码，考虑换一个IO口，或者检查USART复用映射是否写对。

5.3 现象：AT24C02存储的签到记录读出来是乱码

EEPROM里写进去的是正常字符，但读出来有的是0xFF，有的是错位数据，尤其写入多条后越错越严重。

原因：多半是I2C地址线被上拉电阻和多个设备冲突了。比如OLED的I2C地址也是0x50，AT24C02的地址也是0x50（A0/A1/A2都接地），同一个I2C总线上两个设备争抢，自然互相覆盖。另一个原因是写时序问题:AT24C02每写一个字节，需要等待内部写周期完成，很多代码在读EEPROM时没有加延时，立即读取导致数据错乱。

解决：把AT24C02的A0/A1/A2脚电平区分开，比如AT24C02地址设成0xA0，OLED设成0x78，并在初始化时分别扫描设备地址。每写一字节后，调用HAL_Delay(5)再继续写。如果你用的是软件I2C，还要检查GPIO开漏配置和时钟频率，超过400kHz会不稳定。

5.4 现象：RTC时间每次复位都归零

代码里明明初始化了RTC，也设置了正确的时间，但一按复位键或者断电重启，时间就回到默认值例如2000年1月1日。

原因：STM32内部RTC需要靠VBAT引脚外接3V电池供电，当主电源断电后，RTC才能继续走。如果你没接电池，每次断电时钟就会停止；主电源恢复后，RTC所有寄存器被重置成默认值。如果是外部DS3231，则是它的后备电池没装或电池耗尽。

解决：若用内部RTC，VBAT接一个CR2032电池座；若用DS3231，检查它的BAT+引脚是否接了电池，没有就补上。同时还要检查CubeMX里RTC的"Backup Domain"相关选项，确保开启了备份域访问和报警中断。

5.5 现象：写入EEPROM时系统卡死，进不了主循环

在签到主流程里调用EEPROM写入函数后，OLED不再刷新，按键也没反应，像是死机了。

原因：这是因为EEPROM写入函数里用了长阻塞延时（比如HAL_Delay(5)），而且延时期间串口中断被高优先级抢占。更严重的是，如果I2C在NACK时会一直重试，你的写入函数没有做错误处理，陷入无限循环。

解决：把I2C操作移到独立的任务或前台循环里，用非阻塞状态机；或者给I2C中断设置低于串口中断的优先级。最简单的做法是：写入前关掉全局中断（__disable_irq()），写完后恢复（__enable_irq()），这样至少不会中断嵌套炸栈。另外，EEPROM成功写入后要清除I2C错误标志，避免反复NACK。

6. 从能签到到能交付：功能验证与产品化优化

6.1 用上位机串口助手验证全流程

做完整机后，不要直接拿去演示。我习惯把STM32的USART2接到一个串口助手，在代码里加上调试打印功能：每次发指纹指令前打印指令码，每收到一帧应答就打印原始十六进制字节。然后用Excel列一张表，按"录入-签到-断电-重新签到"的顺序测试20遍，记录失败次数和错误码。低于95%的通过率说明算法或硬件还有问题，不要急着打包。

void debug_printf(const char *fmt, ...) { // 在USART2上输出调试信息，方便看每一帧原始数据 }

6.2 增加掉电保存与防重复签到

签到系统最怕用户退出后再偷偷重新签到同一ID。我加了一个HashMap：在RAM里存一个ID签到状态数组，签到成功后置1，当检测到二次按压同一ID时，直接拒绝并显示"already checked"。这个状态在关机后要清零，所以每次上电从EEPROM读最近的记录，把今天已签到的ID恢复出来。掉电保存靠EEPROM已经覆盖，但要注意签到时间必须先从RTC读，在正式上时间戳时要防止时间跳变。

6.3 把签到记录通过蓝牙/WiFi上传

如果要做成考勤系统，需要在电脑上看到出勤统计，常见做法是给STM32加一个HC05蓝牙模块或ESP8266 WiFi模块，把签到记录以JSON格式发送给上位机或服务器。这里有个经验：不要在主循环里每签一个到就发一次，因为蓝牙/WiFi的握手很慢，有时模块没准备好你就发，丢包概率很大。我通常的做法是签到记录先存在EEPROM，等系统空闲或者按下"上传"键时，再把整个缓冲区的记录一次性发送。如果上位机只收不答，重发逻辑就失效了，所以一定要设计应答包，上位机收到一条就回一个OK。这个方向做好后，你手里的工程就不再是课程作业，而是真正能交差的项目作品。我当年做这个功能时，栽过最大的跟头是在串口发送和指纹接收共用同一个中断优先级，导致偶尔死锁，后来把所有串口接收都改成非阻塞状态机才解决。希望这份笔记能帮你避开这些坑，早点把东西跑起来。

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