简介基于RFID考勤系统设计的单片机程序是一份面向嵌入式入门与课程设计的完整项目资料。项目以RC522射频读卡模块和LCD12864液晶显示为核心涵盖硬件接口、软件编程、IC卡注册与注销、考勤记录存储等模块并涉及ALOHA、时隙ALOHA等防碰撞算法的实际应用从单片机选型、读卡器通信到数据处理均有完整代码示例适合单片机学习者、毕业设计或智能考勤原型开发人员参考。压缩包共34个文件以.c/.h源文件、Keil工程文件(.uvproj)、烧录文件(.hex)为主另含.obj/.lst等编译中间文件便于调试排查整体仅116KB轻量易用。该资源已有1221人学习提供可直接打开的工程与完整源码可帮助理解RC522读卡流程、LCD12864驱动、数据解析与多标签防冲突处理等关键环节为后续扩展存储器、上位机统计等功能打基础。无论是课程设计还是项目预研这套资料都能有效降低开发门槛。1. 先把RFID考勤单片机程序拆开看它到底要解什么题一个能在实验室、办公室或小工厂里真正用起来的RFID考勤系统核心就一件事读卡判断这个卡号是不是白名单里的然后把“谁、几点几分、进了还是出了”这件事记下来。看起来简单真放到单片机上做就完全不是一回事了——你手里往往只有几K的RAM、几十K的Flash没有操作系统没有文件系统连时间都要靠外部时钟芯片去“抠”。我做过的方案里最稳妥的路径是主流单片机STM32或增强型51 最常见的RC522射频模块 一块EEPROM存卡号白名单 外部实时时钟芯片或带RTC的单片机 一个继电器或蜂鸣器做门锁与提示。这套组合不管在成本、采购难度还是代码量上对个人开发者最友好资料也多到能救命。这篇笔记就是照着这条路线往下讲的适用人群是手里已经有点单片机基础想用RFID做考勤但不知道从哪下手的人或者是已经搭了硬件但读卡老不稳定、掉电丢数据、时间乱跳被这些细节折磨的人。我也会把几个最容易让人抓狂的坑放在一个单独的章节里每条都是实际跑项目时踩过的不是书上的标准答案。2. 硬件选型与最小系统搭建先把模块和引脚的地盘划清楚2.1 为什么用RC522而不是其他射频模块选型思路与边界市面上最常见的三种RFID读卡方案是RC522、PN532、以及直接用串口输出的读卡头。PN532功能更强支持NFC交互、手机模拟卡但价格贵一倍还多驱动库也重串口读卡头例如一些成品模块用起来省心但白名单、时序控制、读卡触发全被封装在模块内部你想在单片机里做逻辑反而受限。RC522恰好卡在中间支持13.56MHz的Mifare卡、读写扇区数据价格便宜到可以当耗材SPI通讯足够快代码量在单片机上扛得住。这套考勤系统的读卡需求其实只用了RC522最基础的能力——读卡号UID完全不涉及对卡片扇区的写入。所以那些把扇区加密、钥匙设置、数据读写全写进驱动里的代码对我们来说是过度设计。我一般把驱动裁剪掉这部分只保留下面的能力寻卡、防碰撞、选卡、读UID。这么做的好处是代码可读性高、Bug面小也方便以后换不同厂家的RC522模块。还有一点容易被忽略RC522有不同的PCB天线规格。红板、蓝板、小尺寸圆板读卡距离差别很大。考勤场景要求刷一下就能读建议选天线面积更大的模块常见的是外形类似蓝色或红色的长方形板实测读卡距离能做到3~5厘米比小圆板稳定很多。2.2 最小硬件的引脚分配表照着接线不会翻车我从常用方案里挑了一种兼顾成本与代差的接法STM32F103C8T6SPI1接RC522I2C接口接AT24C02存白名单一个外部DS1302时钟模块一个继电器接电控锁三个按键加一块OLED做交互。下面是引脚分配表照着接就能把硬件地盘先圈出来。功能单片机引脚RC522 / 外部器件引脚备注SPI1_SCKPA5SCK时钟约100kHz~1MHzSPI1_MOSIPA7MOSI单片机发指令给RC522SPI1_MISOPA6MISORC522回报卡片数据SPI1_NSSPA4SDA片选软件控制拉低选中RC522RC522_RSTPA3RST复位引脚I2C_SCLPB6AT24C02 SCL软件I2C或硬件I2CI2C_SDAPB7AT24C02 SDA注意上拉电阻RTC数据PB12~PB14DS1302 三线CLK/DAT/RST分别接继电器PB0IN低电平触发或高电平触发看模块蜂鸣器PB1无源蜂鸣器三极管驱动别直接推接线本身不难真正让人翻车的是供电。RC522模块的3.3V和模拟电路部分对电源纹波敏感如果直接用开发板的LDO输出供电读卡时天线功率拉高电压跌落一点点就会导致卡号读偶发失败。我一般会给RC522单独加一颗小稳压芯片比如低压差线性稳压器或者至少在主电源上并联一个大容量电容。时钟模块的电池座也要提前确认有没有装电池否则每次上电都是1970年。2.3 从零搭起工程引入标准库和RFID驱动时的目录习惯工程结构上我不喜欢把所有代码堆在main.c里。常见的做法是分成驱动层、业务层、配置层三层目录驱动层放RC522的SPI读写、AT24C02的I2C读写、DS1302的时钟读写业务层放考勤的状态机、白名单增删、刷卡记录生成配置层放引脚宏定义和全局常量方便换平台时改一处就行。目录结构大致是这个样子project/ ├── app/ │ ├── main.c │ ├── attendance.c │ └── attendance.h ├── driver/ │ ├── rc522.c / rc522.h │ ├── at24c02.c / at24c02.h │ ├── ds1302.c / ds1302.h │ └── spi_soft.c / i2c_soft.c ├── bsp/ │ ├── bsp_led.c / bsp_key.c / bsp_beep.c └── config/ └── board_config.hmain.c里只放初始化和调度循环业务逻辑放在attendance.c里这样后续要把某个驱动换成别的型号时改动范围能被限制住。很多人觉得几十行的项目不需要结构但实际上考勤系统会越加越多东西按键菜单、背光、心跳指示灯、记录查询没有分层迟早要乱。这个工程框架从第一天起就建好后面省下的不只是改代码的时间还有排查Bug的精力。3. 把RFID底层驱动跑通从RC522初始化到稳定读卡3.1 RC522上电初始化的标准序列参数与顺序都得讲究RC522的初始化顺序是固定的除了复位和开启天线还要写几个关键寄存器来匹配天线的电气参数。很多人的读卡距离短、读卡率低问题就出在这几个寄存器的值上。下面是一个在STM32上跑通的初始化函数逻辑说明放在代码后面。#include rc522.h #include spi_soft.h void RC522_Init(void) { // 复位引脚先拉低再拉高让芯片处于确定状态 RC522_RST_LOW(); delay_ms(10); RC522_RST_HIGH(); delay_ms(10); // 发送软复位命令等待芯片就绪 RC522_WriteReg(CommandReg, PCD_RESETPHASE); delay_ms(10); // 关闭定时器、关掉加密保证SPI收发不受干扰 RC522_WriteReg(TModeReg, 0x00); RC522_WriteReg(TPrescalerReg, 0x00); RC522_WriteReg(TReloadRegH, 0x00); RC522_WriteReg(TReloadRegL, 0x00); // 配置天线发射强度数值越大读卡距离越远 // 但电流也越大电源不好的板子会反效果 RC522_WriteReg(TxASKReg, 0x40); RC522_WriteReg(TxControlReg, 0x83); // 开启天线 RC522_WriteReg(TxControlReg, 0x83); RC522_WriteReg(RFCfgReg, 0x0F); // 设置接收增益默认值0x40通常太弱调大到0x50 RC522_WriteReg(GainReg, 0x50); }这段代码里需要特别注意的是GainReg寄存器地址在多数库中被命名为RFCfgReg附近或单独定义接收机的增益直接决定了读卡灵敏度。调得太高容易把环境噪声一起放大表现为“卡还没放上去程序就误读到随机卡号”调得太低卡片必须贴得很正才读得到。我一般从0x50起步然后根据实际环境上下微调。TxControlReg的0x83表示打开天线发射部分这是RC522能辐射射频场的开关。3.2 向上层提供稳定的读卡函数超时和重试的设计驱动层最终要暴露给上层的不是一个函数式的寄存器操作而是一个稳定的“读卡号”API。这个API要处理两种意外卡片放偏导致防碰撞失败、以及读卡过程中卡被快速拿走导致的超时。下面的代码是我在项目里用的读卡实现核心配合超时重试逻辑来用。uint8_t RC522_ReadCardUID(uint8_t *uid, uint8_t *uid_len) { uint8_t status; uint8_t cmd_buf[8]; uint8_t i; // 第一步寻卡请求所有在射频场内的卡片响应 cmd_buf[0] PCD_REQALL; status RC522_Command(PCD_TRANSCEIVE, cmd_buf, 1, NULL, 0); if (status ! MI_OK) { return STATUS_NO_CARD; } // 第二步防碰撞多张卡同时在场时选出一张 cmd_buf[0] PCD_ANTICOLL; cmd_buf[1] 0x20; // 完整的防碰撞级别 status RC522_Command(PCD_TRANSCEIVE, cmd_buf, 2, uid, uid_len); if (status ! MI_OK) { return STATUS_ANTICOLL_FAIL; } // 第三步选卡让选出的卡进入激活状态 cmd_buf[0] PCD_SELECT; cmd_buf[1] 0x70; for (i 0; i *uid_len; i) { cmd_buf[2 i] uid[i]; } status RC522_Command(PCD_TRANSCEIVE, cmd_buf, 2 *uid_len, NULL, 0); if (status ! MI_OK) { return STATUS_SELECT_FAIL; } return STATUS_OK; }RC522_Command是驱动里封装的收发原语它会控制片选拉低、写命令与数据、然后等待中断标志位。超时处理在RC522_Command内部做启动一个毫秒级计数超过50ms还没收到中断标志就直接返回错误避免程序卡死在等待循环里。这个超时时间并不是随便定的读卡整个过程在几毫秒内完成50ms已经是把天线响应时间和SPI通讯抖动都算进去后的冗余值再大就会让刷卡感觉“粘”。在调用层我再套一层RC522_ReadCardUID的重试循环连续重试3次只有3次都失败才向上层返回失败。这是因为实际使用中卡片快速划过天线时第一、二次往往因为卡片角度不对而失败第三次刚好对准了就读到了。这个“三次重试”的习惯帮我省去了大量“用户明明刷了卡但系统没反应”的投诉。3.3 一个容易忽略的问题SPI通信速率和RC522的兼容RC522的SPI接口最高理论速率可以到10MHz但实际走线、杜邦线长度和模块质量会让高速模式变成玄学。开发板上用杜邦线连接RC522时SPI时钟高于1MHz就可能出现偶发读卡错误而且是那种“十次里失败一两次”的偶发特别难查。我在初始化SPI时会把时钟分频配置得保守一些STM32上选择SPI1预分频设为32或64对应的实际时钟在几百kHz到1MHz之间。这个速率对RC522读卡来说完全够用一次读卡的数据交换只有几十个字节换来的是极高的抗干扰性。如果以后要做PCB板、缩短走线距离再把分频调上去也来得及。这个经验同样适用于软件模拟SPI——GPIO翻转延时建议不少于500ns太快的电平翻转在长线上会产生振铃影响时序判断。4. 考勤逻辑与数据落地白名单、IC卡号存储、时钟与掉电保持4.1 白名单怎么存AT24C02的页写和读写越界陷阱白名单用AT24C02256字节来存够不够用一张卡号是4字节加上一个状态字节启用/禁用就是5字节256字节能存50张左右对小型团队够用。但AT24C02有个特性它的存储阵列分成32页每页8字节页写时如果写入地址跨越页边界数据会绕回本页开头把之前的内容覆盖掉。这是最常见的数据存储翻车点。API层面我做了一个安全的写入函数先检测写入长度是否会导致跨页如果跨了就拆成两次写。AT24C02每写一页还需要一个内部写周期的等待时间约5ms所以写完要加延时或查询应答信号。#include at24c02.h // buf_len必须小于等于PAGE_SIZE避免跨页 uint8_t AT24C02_WriteSafe(uint16_t addr, uint8_t *buf, uint16_t buf_len) { uint16_t offset_in_page; uint8_t first_chunk_len; if (buf_len 0) return 1; offset_in_page addr % AT24C02_PAGE_SIZE; if (offset_in_page buf_len AT24C02_PAGE_SIZE) { // 先写第一部分直到本页末尾 first_chunk_len AT24C02_PAGE_SIZE - offset_in_page; AT24C02_WriteBytes(addr, buf, first_chunk_len); delay_ms(6); // 等待内部写周期完成 // 再写剩余部分新地址从下一页起始 return AT24C02_WriteSafe(addr first_chunk_len, buf first_chunk_len, buf_len - first_chunk_len); } else { AT24C02_WriteBytes(addr, buf, buf_len); delay_ms(6); return 1; } }这个递归写法省掉了循环里的边界计算逻辑看着很直白。真正想提醒的是在添加白名单时先用一个遍历函数确认旧卡号是否已存在否则同一张卡会被重复写入白白消耗EEPROM的擦写寿命。AT24C02的擦写寿命虽然号称一百万次但考勤系统全天候运行每天的增删改操作积累起来也不小省着用有必要。4.2 用状态机管理刷卡流程区分首次刷卡和打卡门禁考勤系统可以只做一个“刷一下记录当前时间”的签到机也可以做成“进门和出门都刷、按卡号区分上下班记录”的门禁考勤机。后者对逻辑复杂度要求高得多这也是为什么我一直强调状态机——只用if嵌套的话功能越多越难改。我在app层定义了一个考勤状态机状态包括空闲、卡已就绪、蜂鸣提示、写入记录。关键处理逻辑如下typedef enum { STATE_IDLE, STATE_CARD_READY, STATE_RECORDING } AttendanceState; void Attendance_Task(void) { uint8_t uid[4]; uint8_t uid_len; CardRecord rec {0}; static AttendanceState state STATE_IDLE; static uint8_t last_card[4] {0xFF, 0xFF, 0xFF, 0xFF}; switch (state) { case STATE_IDLE: if (RC522_ReadCardUID(uid, uid_len) STATUS_OK) { // 连续两次读到同一张卡说明是用户把卡停留在读卡器上 // 此时不做重复记录防止一条刷卡被记成多笔 if (memcmp(uid, last_card, 4) 0) { break; } memcpy(last_card, uid, 4); state STATE_CARD_READY; } break; case STATE_CARD_READY: // 校验卡号是否在白名单内 if (Attendance_CheckWhiteList(uid, 4)) { rec.type ATTENDANCE_TYPE_TOKEN_IN; Attendance_GetNowTime(rec.hour, rec.minute, rec.second); Attendance_SaveRecord(rec); Beep_On(150); } else { // 未授权卡响两声短蜂鸣表示拒绝 Beep_On(60); delay_ms(80); Beep_On(60); } state STATE_IDLE; break; default: state STATE_IDLE; break; } }这个状态机的关键是last_card去重——很多从模块厂商例程改过来的项目没有这一步结果就是卡放在读卡器上不动系统每秒都在写一条考勤记录一天下来几千条垃圾数据。有人会用定时器来做“3秒内不重复读同一张卡”但那会把连续两次有意的快速再刷卡动作也拦住用这里的状态机方案加个去重缓冲是更精细的做法。4.3 时间从哪里来DS1302的读写时序与初始化陷阱考勤记录必须带时间而单片机自身没有可靠的时钟源。外部DS1302是这类项目里最常见的方案它用三线接口CLK、DAT、RST驱动代码简单但坑也明显DS1302的操作必须严格按它的时序来尤其是读数据时的“先写命令字节、再读数据字节”的节奏很多写得不严谨的库会出现“第一次读是对的第二次读全变零”这种鬼畜问题。以下是我的时间读取函数关键在每次读操作的起始位和数据位顺序以及寄存器地址转换。#include ds1302.h uint8_t DS1302_ReadByte(uint8_t addr) { uint8_t i, value 0; DS1302_RST_HIGH(); DS1302_SCLK_LOW(); // 写入命令字节bit7是固定1bit6是RAM/CLOCK选择bit0是读/写 uint8_t cmd 0x81 | (addr 1); // 读操作 for (i 0; i 8; i) { if (cmd 0x01) { DS1302_DAT_HIGH(); } else { DS1302_DAT_LOW(); } DS1302_SCLK_HIGH(); DS1302_SCLK_LOW(); cmd 1; } // 数据读取上升沿采样 DS1302_DAT_INPUT(); // 把数据引脚切换为输入模式 for (i 0; i 8; i) { value 1; if (DS1302_DAT_READ()) { value | 0x80; } DS1302_SCLK_HIGH(); DS1302_SCLK_LOW(); } DS1302_DAT_OUTPUT(); DS1302_RST_LOW(); // 结束访问 return value; }DS1302的寄存器数据采用的是BCD码读出来之后还要做一次(value 4) * 10 (value 0x0F)的转换才是正常的十进制数值。初始化时除了写入当前时间还要注意把“写保护寄存器”设置为允许写入否则时间设置代码执行了但什么都没改。另外我强烈建议在初始化时先读一次秒寄存器判断芯片是否在走这样上电后能区分“时钟芯片没电”和“时钟芯片刚启动但还没开始走”两种情况后者需要初始化时间前者则要提示用户换电池。4.4 掉电保持与恢复从“假记录”到“真数据”的最后一环考勤记录落到EEPROM里需要考虑两块存储区分工白名单区用一整块记录区用环形缓冲。刷一次卡就写一条记录记录区写满后从最旧的开始覆盖。这种设计牺牲了历史记录的保存时长但保证了写入逻辑简单可靠。真正让人头疼的是写记录过程中的掉电——如果正在写EEPROM的第二个字节时断电这个记录可能半新不旧读出来变成乱码。我采用的对抗手段是记录格式里带一个魔法数字magic byte和一个累加校验读取时先检查魔法数字和校验不一致就跳过这条。魔法数字我习惯用0x5A校验用一个简单的CRC8实现。#define RECORD_MAGIC 0x5A typedef struct { uint8_t magic; uint8_t card_uid[4]; uint8_t year; uint8_t month; uint8_t day; uint8_t hour; uint8_t minute; uint8_t second; uint8_t type; // 0签到, 1签退 uint8_t crc8; } CardRecord; uint8_t Record_VerifyCRC(CardRecord *rec) { uint8_t crc 0; uint8_t *p (uint8_t *)rec; uint8_t i; for (i 0; i sizeof(CardRecord) - 1; i) { crc crc8_update(crc, p[i]); } return crc rec-crc8; }有了这个校验就算掉电造成半写状态读取出错也只会丢掉那一条而不会污染整个记录区。这也是我对所有数据落地项目的底线要求任何一条写入都可能被意外中断数据结构必须允许“读到坏数据时安全跳过”。5. 跑项目最容易翻车的五个点从读卡失败到数据错乱的排查指南5.1 刷卡时灵时不灵天线参数和电源纹波的“玄学”组合现象卡片贴上去有时候一秒就读到有时候要反复换角度才能读到偶尔还会提示未授权。原因两层因素叠加。第一层是RC522天线匹配寄存器的值不合当前PCB天线发射场强不稳定第二层是电源纹波大刷卡瞬间天线电流拉高电压跌落导致接收灵敏度下降。很多人在代码里反复调重试次数问题反而在硬件上。解决先给RC522单独供电用万用表观察刷卡瞬间3.3V是否有超过50mV的跌落。然后用示波器看天线波形或者直接在代码里用二分法调整GainReg0x40到0x60之间逐档试。如果调高增益后出现“空气刷卡”无卡时误读到卡号说明噪声被放大了就该往回降直到一个临界值。5.2 掉电重启后白名单全丢AT24C02的写保护和地址越界现象程序烧进去好几天没问题某次断电重启后之前添加的白名单全部消失恢复出厂状态。原因AT24C02的写操作有一个“写使能”步骤如果代码里没有在写之前发送正确指令写入根本没生效。更隐蔽的是有人直接拿地址卡号的写法地址计算超过255后绕回开头把白名单区覆盖了。解决每次写操作前先发“写使能”指令同时给所有读写地址加一个安全检查函数凡是addr len 255的调用直接拒绝并返回错误。调试阶段我会把读取到的白名单条数打印出来和人工数过的卡对一下不然你根本不知道数据什么时候丢的。5.3 时间越走越偏或者重启后回到初始值DS1302的电池与晶振电容现象上电时设置好时间用几天后慢了几分钟或者断电十分钟再开机时间就从上次保存的地方跳到初始值。原因DS1302的时间精度取决于32768kHz晶振的负载电容匹配。很多便宜模块上用的晶振本身就是低精度等级推荐匹配的电容值没贴上实际走时偏差能达到每天数十秒。重启回初始值则是备用电池没装或接触不良掉电后时钟芯片没有电源寄存器内容全部清零。解决换一个带正确负载电容的DS1302模块模块上通常预留了两个焊盘位按晶振数据手册标称负载电容焊接。同时在上电初始化代码里增加判断逻辑读出的年份如果小于等于初始值比如2000就认为时钟芯片从未被初始化或电池耗尽提示用户而不是静默地把1970年刷进来。5.4 同一张卡刷一次记两条重复触发与状态机单薄现象明明只是把卡放上去再拿开系统里却出现了两条几乎同时的记录在门禁模式下一个人进门和出门各刷一下结果被记成了两次签退。原因卡片在射频场里停留期间主循环快速读到了多次相同UID代码没有做去重处理另外考勤类型签到/签退的判定逻辑写成了“每次刷卡取反”而不是根据时间规则去判断导致状态混乱。解决用前面第4章的状态机方案在STATE_CARD_READY里增加去重缓存同一UID必须累计3次不同时间的读取才确认是有效刷卡。签到/签退的判定建议改为“以时间为界限”上午6点到12点记为签到下午13点到18点记为签退跨天边界从凌晨0点切分。这样即便用户连刷两次也不会产生两条同类记录。5.5 继电器乱跳蜂鸣器误响地线回路和共用电源的干扰现象读卡时蜂鸣器该响一下结果继电器跟着动作有时没读卡继电器也偶发抖动。原因继电器线圈是感性负载开关瞬间会产生反向电动势如果不加续流二极管这个尖峰会通过地线或电源线耦合进单片机IO口和RC522的天线电路被误判为读卡成功或触发GPIO中断。解决继电器模块上确认有续流二极管通常是一个标着1N4148或SS14的小元件没有的话在继电器线圈两端并联一个1N4007注意方向同时让继电器的地和单片机的地在电源入口处单点连接减少地线回路面积。要是还不行就把继电器控制信号从GPIO直推改成三极管光耦隔离成本几毛钱但能把这类干扰彻底隔断。6. 交付前留一小时给“假卡测试”验证白名单、存储磨损与时间容错这个项目真正算完成不是程序能编译过而是你能模拟出最恶劣的用户操作还不崩。我每次交付前都会做一轮“假卡测试”和“暴力操作测试”逼着代码把平时不会走的路径都走到。先准备一张没录入白名单的陌生卡连续刷20次确认每次都被拒绝且蜂鸣器提示正确再把这张卡录入白名单刷一次确认记录生成断电重启确认白名单还在、记录还在。然后调出一个异常场景——把卡放在读卡器上不动10秒确认系统只记一条而不是每秒刷一条。最后核对时间人为把DS1302时间改乱确认系统能正常读、不崩溃并且下次重启时不会被乱时间带飞。存储磨损这一项我还会额外做用脚本或按键菜单反复添加和删除卡100次以上然后读取EEPROM里残留数据确认没有出现页写越界造成的相邻数据覆盖。RC522模块出厂后每块的天线参数都有微小差异我通常把第5章里调好的GainReg值固化在board_config.h里并附一行注释说明“此处按模块实测微调”防止以后换模块的人一头雾水。我见过很多做得不错的考勤Demo刷卡能亮灯、能显示卡号但一放到真实环境就露馅——不是卡号偶发读不到就是断电再来电后白名单消失了。这些事看起来都是小概率但在考勤这个场景里每一天都在重复任何小概率都会被放大成用户投诉。所以我会在项目里坚持两个习惯所有存储结构都带校验、所有状态变化都走状态机而非零散的if。这几个习惯救了我很多次时间精力省下来的都值了。如果你打算在现有基础上继续把项目做深我建议下一步把卡片扇区利用起来——在卡上写一条带用户名的记录这样换读卡器也可以读出来相当于把考勤数据从“只认设备”升级成“跟随卡片”。这套方案我已经验证过RC522的扇区读写稳定性够用。做这个方向的关键是把扇区密钥和访问位搞清楚别把卡写坏了那是真的没有后悔药。希望这篇笔记帮你把RFID考勤的单片机程序一次趟平。本文还有配套的精品资源点击获取