用STM32F103C8T6和MFRC522模块DIY一个简易门禁系统（附完整HAL库代码）-平芜编程栈

基于STM32F103C8T6与MFRC522的智能门禁系统实战开发

在物联网技术快速发展的今天，智能门禁系统已经从商业领域逐步走进个人创客和嵌入式爱好者的视野。本文将带你从零开始构建一个完整的RFID智能门禁系统，使用STM32F103C8T6作为主控芯片，搭配MFRC522射频识别模块，实现卡片识别、权限验证和门锁控制等功能。

1. 项目规划与硬件选型

1.1 核心硬件选择依据

选择STM32F103C8T6作为主控芯片主要基于以下考量：

性价比突出：作为STM32F1系列的经典型号，C8T6在性能和价格之间取得了完美平衡
丰富外设：具备多个SPI、USART接口，满足与RFID模块、串口调试等需求
开发便捷：完善的HAL库支持和丰富的社区资源，降低开发门槛
处理能力：72MHz主频的Cortex-M3内核，足以应对门禁系统的实时性要求

MFRC522模块的选择则考虑了：

广泛兼容性：支持Mifare系列卡片，包括常见的S50、S70等
稳定通信：SPI接口确保数据传输的可靠性
合理距离：3-5cm的识别距离适合门禁场景
成本优势：相比其他RFID方案更具价格竞争力

1.2 系统整体架构设计

完整的门禁系统包含以下功能模块：

[系统框图] 主控芯片(STM32F103C8T6) ├─ RFID读卡模块(MFRC522) ├─ 电控锁驱动电路 ├─ 状态指示LED ├─ 蜂鸣器反馈 └─ 电源管理模块

硬件连接关系如下表所示：

模块	STM32引脚	连接方式	备注
MFRC522 SDA	PB8	SPI_NSS	片选信号
MFRC522 SCK	PB13	SPI2_SCK	时钟信号
MFRC522 MOSI	PB15	SPI2_MOSI	主出从入
MFRC522 MISO	PB14	SPI2_MISO	主入从出
MFRC522 RST	PB9	GPIO	复位信号
继电器控制	PC13	GPIO	控制电控锁开关
绿色LED	PA1	GPIO	验证通过指示
红色LED	PA2	GPIO	验证失败指示
蜂鸣器	PA3	GPIO	操作反馈

2. 开发环境搭建与基础配置

2.1 工具链准备

开发本系统需要以下软件工具：

STM32CubeMX：用于初始化代码生成和引脚配置
Keil MDK-ARM：主要开发IDE，提供编译调试环境
串口调试助手：如Putty或Tera Term，用于调试信息输出
ST-Link Utility：用于程序烧录和调试

2.2 CubeMX关键配置步骤

在CubeMX中需要进行以下核心配置：

时钟树配置：
- 设置HSE为外部晶振模式
- 系统时钟配置为72MHz
- APB1总线时钟设为36MHz
- APB2总线时钟设为72MHz
SPI2接口配置：
- 模式选择为Full-Duplex Master
- 硬件NSS选择Disable
- 时钟分频设为8分频(SPI时钟=9MHz)
- 数据大小8bit，MSB first
- CPOL=Low，CPHA=1Edge
GPIO配置：
- 配置RFID模块的RST引脚为输出模式
- 配置继电器控制、LED和蜂鸣器引脚为输出模式
- 配置USART1为异步模式，波特率115200

提示：生成代码前务必检查每个引脚的功能分配是否正确，特别是复用功能引脚。

2.3 工程基础代码结构

生成的工程应包含以下关键文件：

Project/ ├─ Core/ │ ├─ Inc/ │ │ ├─ rc522.h │ │ └─ doorlock.h │ ├─ Src/ │ │ ├─ rc522.c │ │ └─ doorlock.c ├─ Drivers/ ├─ MDK-ARM/ └─ STM32CubeMX/

3. RFID功能模块实现

3.1 MFRC522驱动开发

MFRC522驱动程序需要实现以下核心功能：

// RC522.h中的关键定义 #define MAXRLEN 18 #define MI_OK 0 #define MI_ERR 0xFF typedef enum { CARD_MIFARE_S50 = 0x0400, CARD_MIFARE_S70 = 0x0200, CARD_MIFARE_ULTRALIGHT = 0x4400, CARD_MIFARE_PRO = 0x0800, CARD_MIFARE_DESFIRE = 0x4403 } CardType;

3.1.1 初始化流程

RC522初始化包含以下步骤：

硬件复位（拉低RST引脚至少1μs）
软件复位（发送PCD_RESETPHASE命令）
配置定时器参数（TReloadReg、TModeReg等）
设置RF通信参数（TxASKReg、ModeReg等）
开启天线发射

关键初始化代码：

void RC522_Init(void) { // 硬件复位 RC522_RST_LOW; HAL_Delay(1); RC522_RST_HIGH; HAL_Delay(50); // 软件复位 PcdReset(); HAL_Delay(10); // 配置定时器 WriteRawRC(TReloadRegL, 30); WriteRawRC(TReloadRegH, 0); WriteRawRC(TModeReg, 0x8D); WriteRawRC(TPrescalerReg, 0x3E); // 设置RF参数 WriteRawRC(TxASKReg, 0x40); WriteRawRC(ModeReg, 0x3D); // 开启天线 PcdAntennaOn(); printf("MFRC522 Initialized\r\n"); }

3.1.2 卡片检测与识别

卡片识别流程采用ISO14443-A标准的三步法：

寻卡请求（PCD_REQUEST）
防冲突处理（PCD_ANTICOLL）
选择卡片（PCD_SELECT）

实现代码示例：

uint8_t RC522_FindCard(uint8_t* uid) { uint8_t status; uint8_t temp[2]; // 1. 寻卡请求 status = PcdRequest(PICC_REQALL, temp); if(status != MI_OK) return status; // 2. 防冲突处理 status = PcdAnticoll(uid); if(status != MI_OK) return status; // 3. 选择卡片 status = PcdSelect(uid); return status; }

3.2 卡片权限管理系统

3.2.1 授权卡片存储结构

采用数组存储授权卡片UID，实际项目中可扩展为EEPROM存储：

#define MAX_AUTH_CARDS 10 typedef struct { uint8_t uid[4]; char name[16]; } AuthCard; AuthCard authorizedCards[MAX_AUTH_CARDS] = { {{0x12, 0x34, 0x56, 0x78}, "Admin"}, {{0x9A, 0xBC, 0xDE, 0xF0}, "User1"} }; uint8_t numAuthCards = 2;

3.2.2 权限验证逻辑

验证流程包含UID比对和权限级别检查：

uint8_t CheckCardAuthorization(uint8_t* uid) { for(uint8_t i=0; i<numAuthCards; i++) { if(memcmp(uid, authorizedCards[i].uid, 4) == 0) { return i+1; // 返回索引+1作为权限级别 } } return 0; // 未授权 }

4. 门禁控制功能实现

4.1 电控锁驱动电路

继电器驱动电路设计要点：

使用NPN三极管（如S8050）驱动继电器线圈
继电器线圈两端并联续流二极管
控制信号通过光耦隔离（推荐PC817）
电控锁电源与MCU电源完全隔离

典型电路连接方式：

STM32 GPIO -> 1k电阻 -> NPN基极 | 继电器线圈 | +12V电源

4.2 门锁控制逻辑

实现安全的门锁控制时序：

检测到有效卡片
验证卡片权限
激活继电器（保持500ms）
状态反馈（LED和蜂鸣器）
记录开锁事件

代码实现：

void ControlDoorLock(uint8_t accessLevel) { // 激活继电器 HAL_GPIO_WritePin(RELAY_GPIO_Port, RELAY_Pin, GPIO_PIN_SET); // 根据权限级别设置不同反馈 if(accessLevel == 1) { // 管理员 GreenLED_Blink(3); Beep(200, 3); } else { // 普通用户 GreenLED_Blink(1); Beep(100, 1); } // 保持500ms后释放 HAL_Delay(500); HAL_GPIO_WritePin(RELAY_GPIO_Port, RELAY_Pin, GPIO_PIN_RESET); // 记录开锁事件 LogAccessEvent(accessLevel); }

4.3 状态指示与用户反馈

设计直观的多模式反馈系统：

视觉反馈：
- 绿色LED：验证成功
- 红色LED：验证失败
- 蓝色LED：系统待机
听觉反馈：
- 短促"滴"声：普通用户验证成功
- 三声"滴"：管理员验证成功
- 长"滴"声：验证失败

LED控制函数示例：

void LED_Feedback(uint8_t type) { switch(type) { case FEEDBACK_SUCCESS: HAL_GPIO_WritePin(GREEN_LED_GPIO_Port, GREEN_LED_Pin, GPIO_PIN_SET); HAL_Delay(300); HAL_GPIO_WritePin(GREEN_LED_GPIO_Port, GREEN_LED_Pin, GPIO_PIN_RESET); break; case FEEDBACK_FAIL: HAL_GPIO_WritePin(RED_LED_GPIO_Port, RED_LED_Pin, GPIO_PIN_SET); HAL_Delay(1000); HAL_GPIO_WritePin(RED_LED_GPIO_Port, RED_LED_Pin, GPIO_PIN_RESET); break; case FEEDBACK_STANDBY: // 呼吸灯效果 for(int i=0; i<3; i++) { HAL_GPIO_WritePin(BLUE_LED_GPIO_Port, BLUE_LED_Pin, GPIO_PIN_SET); HAL_Delay(100); HAL_GPIO_WritePin(BLUE_LED_GPIO_Port, BLUE_LED_Pin, GPIO_PIN_RESET); HAL_Delay(900); } break; } }

5. 系统集成与功能测试

5.1 主程序逻辑流程

主循环采用状态机设计，提高系统响应效率：

typedef enum { STATE_IDLE, STATE_CARD_DETECTED, STATE_AUTH_CHECK, STATE_ACCESS_GRANTED, STATE_ACCESS_DENIED } SystemState; SystemState currentState = STATE_IDLE; void main(void) { // 硬件初始化 System_Init(); while(1) { switch(currentState) { case STATE_IDLE: if(RC522_CheckCard() == MI_OK) { currentState = STATE_CARD_DETECTED; } LED_Feedback(FEEDBACK_STANDBY); break; case STATE_CARD_DETECTED: if(RC522_ReadUID(currentUID) == MI_OK) { currentState = STATE_AUTH_CHECK; } else { currentState = STATE_IDLE; } break; case STATE_AUTH_CHECK: if(CheckCardAuthorization(currentUID)) { currentState = STATE_ACCESS_GRANTED; } else { currentState = STATE_ACCESS_DENIED; } break; case STATE_ACCESS_GRANTED: ControlDoorLock(GetAccessLevel(currentUID)); currentState = STATE_IDLE; break; case STATE_ACCESS_DENIED: LED_Feedback(FEEDBACK_FAIL); Beep(1000, 1); currentState = STATE_IDLE; break; } HAL_Delay(50); } }

5.2 常见问题排查指南

开发过程中可能遇到的问题及解决方案：

问题现象	可能原因	解决方案
无法检测到卡片	天线未正确连接	检查天线焊接和匹配电路
SPI通信失败	用逻辑分析仪检查SPI信号
识别距离过近	天线匹配不佳	调整匹配电路的电容值(通常18-22pF)
电源不稳定	增加电源滤波电容
继电器不动作	驱动电路问题	检查三极管和续流二极管
GPIO配置错误	确认GPIO初始化为输出模式
系统频繁复位	电源电流不足	确保电源能提供至少500mA电流
复位电路不稳定	检查复位引脚电容(通常0.1μF)

5.3 性能优化建议

提升系统稳定性和响应速度的技巧：

SPI通信优化：
- 将SPI时钟提升到最大允许频率（通常18MHz）
- 使用DMA传输减少CPU开销
电源管理改进：
- 为MFRC522模块增加100nF去耦电容
- 使用LDO稳压器而非开关电源为RFID模块供电
软件优化：
- 将卡片检测改为中断驱动模式
- 实现卡片UID的哈希查找加速验证过程
- 添加看门狗定时器增强系统稳定性
安全性增强：
- 实现卡片防重放攻击机制
- 添加操作日志存储功能
- 支持动态修改授权卡片列表

// 示例：使用CRC32实现简单防重放 uint32_t CalculateCRC32(uint8_t* data, uint8_t len) { uint32_t crc = 0xFFFFFFFF; for(uint8_t i=0; i<len; i++) { crc ^= data[i]; for(uint8_t j=0; j<8; j++) { crc = (crc >> 1) ^ (crc & 1 ? 0xEDB88320 : 0); } } return ~crc; }

6. 功能扩展与进阶应用

6.1 无线通信模块集成

通过ESP8266或HC-05模块增加无线功能：

蓝牙控制：使用手机APP进行门禁管理
Wi-Fi联网：实现远程授权和状态监控
数据同步：将开锁记录上传至云服务器

典型AT指令交互流程：

void ESP8266_SendCommand(const char* cmd, uint32_t timeout) { HAL_UART_Transmit(&huart2, (uint8_t*)cmd, strlen(cmd), timeout); HAL_UART_Transmit(&huart2, (uint8_t*)"\r\n", 2, timeout); } void ConnectToWiFi(const char* ssid, const char* pass) { ESP8266_SendCommand("AT+CWMODE=1", 1000); // Station模式 char cmd[128]; sprintf(cmd, "AT+CWJAP=\"%s\",\"%s\"", ssid, pass); ESP8266_SendCommand(cmd, 5000); }

6.2 生物识别功能融合

结合指纹模块实现多因素认证：

硬件选择：R307或FPM10A光学指纹模块
集成方式：通过UART接口通信
工作流程：
- 先刷卡验证身份
- 再验证指纹确认
- 双因素通过后开门

指纹验证代码结构：

uint8_t VerifyFingerprint() { uint8_t ret = PS_GetImage(); if(ret != 0x00) return 0; ret = PS_GenChar(1); if(ret != 0x00) return 0; ret = PS_Match(); if(ret == 0x00) return 1; return 0; }

6.3 数据记录与分析

实现开锁记录存储与查询功能：

存储方案选择：
- 内部Flash（容量有限）
- 外部EEPROM（如24C256）
- SD卡（大容量存储）
记录数据结构：

typedef struct { uint32_t timestamp; uint8_t uid[4]; uint8_t result; // 0失败，1成功 } AccessRecord;

记录查询接口：

void PrintAccessLog(uint16_t numEntries) { AccessRecord record; for(uint16_t i=0; i<numEntries; i++) { if(EEPROM_Read(i, &record, sizeof(record))) { printf("[%lu] UID:%02X%02X%02X%02X %s\r\n", record.timestamp, record.uid[0], record.uid[1], record.uid[2], record.uid[3], record.result ? "Granted" : "Denied"); } } }

7. 项目总结与实用建议

在实际部署智能门禁系统时，有几个关键点需要特别注意。首先是电源稳定性，建议为STM32和MFRC522模块分别配置独立的LDO稳压器，避免射频电路噪声影响MCU正常工作。其次是天线布局，MFRC522的天线应尽量远离金属物体，并且天线线圈平面与可能的卡片插入方向保持平行以获得最佳识别效果。

调试过程中，我发现使用逻辑分析仪监测SPI总线通信极为有用，可以直观地看到MCU与RFID模块之间的数据交换情况。另外，在门锁控制电路中添加光耦隔离能显著提高系统抗干扰能力，特别是在控制大电流电磁锁时。

对于希望进一步扩展功能的开发者，可以考虑添加电池备份电路，使系统在断电情况下仍能保持基本功能运行数小时。同时，将授权卡片信息存储在外部EEPROM而非代码中，可以方便地通过管理卡动态更新权限列表，而无需重新烧录固件。

用STM32F103C8T6和MFRC522模块DIY一个简易门禁系统（附完整HAL库代码）