用STM32F103C8T6和MFRC522模块DIY一个简易门禁卡读卡器（HAL库+SPI+串口调试）
基于STM32F103C8T6与MFRC522的智能门禁系统开发实战
1. 项目概述与硬件选型
在物联网和智能家居快速发展的今天，RFID技术因其非接触式识别的特性，成为门禁系统的理想选择。本项目将使用STM32F103C8T6微控制器搭配MFRC522射频识别模块，构建一个完整的门禁系统原型。
核心硬件组件对比分析：
| 组件 | 型号 | 关键参数 | 备注 |
|---|---|---|---|
| 主控芯片 | STM32F103C8T6 | ARM Cortex-M3内核，72MHz主频，64KB Flash，20KB RAM | 蓝桥杯/智能车常用 |
| RFID模块 | MFRC522 | 工作频率13.56MHz，支持ISO/IEC 14443A协议 | 最大读卡距离约5cm |
| 通信接口 | SPI | 最高18Mbps传输速率 | 主从模式可选 |
| 电源模块 | AMS1117 | 3.3V输出，最大800mA电流 | 为系统提供稳定电压 |
选择STM32F103C8T6的原因在于其丰富的外设资源和广泛的开发生态，而MFRC522模块则是目前市场上性价比最高的13.56MHz RFID读卡器解决方案之一。
2. 硬件连接与电路设计
正确的硬件连接是项目成功的基础。以下是详细的接线指南：
SPI接口连接方案：
MFRC522模块引脚定义：
- SDA(SS)：片选信号
- SCK：时钟信号
- MOSI：主出从入
- MISO：主入从出
- IRQ：中断信号(本项目未使用)
- RST：复位信号
STM32F103C8T6连接方式：
MFRC522 STM32F103C8T6 -------------------------- SDA → PB8 (SPI2_NSS) SCK → PB13 (SPI2_SCK) MOSI → PB15 (SPI2_MOSI) MISO → PB14 (SPI2_MISO) RST → PB9 (GPIO) GND → GND 3.3V → 3.3V
注意：务必确保电源电压为3.3V，MFRC522模块不支持5V供电，否则可能损坏芯片。
电路设计要点：
- 在电源引脚附近放置0.1μF去耦电容
- SPI信号线长度不宜过长，建议控制在10cm以内
- 若环境电磁干扰较强，可考虑在信号线上串联33Ω电阻
3. 软件开发环境配置
工具链准备：
- STM32CubeMX：图形化配置工具，版本建议≥6.0
- Keil MDK：集成开发环境，需安装STM32F1支持包
- 串口调试助手：如Putty、Tera Term等
CubeMX关键配置步骤：
时钟树配置：
- HSE选择外部晶振(通常8MHz)
- PLL倍频至72MHz系统时钟
- APB1分频设置为2(36MHz)
SPI2配置：
Mode: Full-Duplex Master Hardware NSS Signal: Disable Prescaler: 8 (SPI时钟=9MHz) CPOL: Low CPHA: 1 EdgeUSART1配置：
Mode: Asynchronous Baud Rate: 115200 Word Length: 8 Bits Parity: None Stop Bits: 1GPIO配置：
- PB8设置为GPIO_Output(SPI_NSS)
- PB9设置为GPIO_Output(RESET)
生成代码后，需在Keil中启用MicroLIB库以支持printf重定向：
// 在main.c中添加以下代码 #ifdef __GNUC__ #define PUTCHAR_PROTOTYPE int __io_putchar(int ch) #else #define PUTCHAR_PROTOTYPE int fputc(int ch, FILE *f) #endif PUTCHAR_PROTOTYPE { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; }4. RFID驱动开发与核心算法
MFRC522驱动程序是整个系统的核心，需要实现以下关键功能：
寄存器操作基础函数：
// 写入寄存器 void WriteRawRC(uint8_t addr, uint8_t val) { HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi2, &addr, 1, HAL_MAX_DELAY); HAL_SPI_Transmit(&hspi2, &val, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_SET); } // 读取寄存器 uint8_t ReadRawRC(uint8_t addr) { uint8_t val; addr |= 0x80; // 设置读标志位 HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(&hspi2, &addr, 1, HAL_MAX_DELAY); HAL_SPI_Receive(&hspi2, &val, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(RC522_CS_GPIO_Port, RC522_CS_Pin, GPIO_PIN_SET); return val; }卡片检测流程：
- 发送REQA/WUPA命令(PCD→PICC)
- 接收ATQA响应(PICC→PCD)
- 执行防冲突循环
- 选择卡片并获取SAK
- 进行身份验证(可选)
- 执行数据操作(读/写)
典型操作序列示例：
uint8_t DetectCard(uint8_t *uid) { uint8_t status; uint8_t buffer[MAX_LEN]; uint16_t len; // 1. 寻卡 status = PcdRequest(PICC_REQALL, buffer); if(status != MI_OK) return status; // 2. 防冲突 status = PcdAnticoll(buffer); if(status != MI_OK) return status; // 3. 复制UID memcpy(uid, buffer, 4); // 4. 选择卡片 status = PcdSelect(uid); return status; }5. 系统集成与功能扩展
基础读卡功能实现后，可以考虑以下扩展方向：
门禁控制逻辑实现：
void AccessControl(uint8_t *uid) { if(CheckPermission(uid)) { HAL_GPIO_WritePin(DOOR_GPIO_Port, DOOR_Pin, GPIO_PIN_SET); printf("Access Granted for UID: %02X%02X%02X%02X\n", uid[0], uid[1], uid[2], uid[3]); HAL_Delay(3000); // 保持门锁开启3秒 HAL_GPIO_WritePin(DOOR_GPIO_Port, DOOR_Pin, GPIO_PIN_RESET); } else { printf("Access Denied for UID: %02X%02X%02X%02X\n", uid[0], uid[1], uid[2], uid[3]); } }高级功能扩展建议：
多卡管理：实现白名单/黑名单功能
#define MAX_CARDS 20 uint8_t whiteList[MAX_CARDS][4] = { {0x12, 0x34, 0x56, 0x78}, // 示例卡1 {0x9A, 0xBC, 0xDE, 0xF0} // 示例卡2 };数据记录：通过EEPROM或SD卡存储进出记录
网络连接：添加ESP8266模块实现远程监控
生物识别集成：结合指纹模块增强安全性
性能优化技巧：
- 使用中断代替轮询检测卡片
- 实现低功耗模式，在没有卡片时降低读卡频率
- 对SPI通信进行DMA优化
6. 调试技巧与常见问题解决
典型问题排查指南：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法检测到卡片 | 天线未正确连接 | 检查天线焊接点 |
| 读卡距离短 | 调谐电路不匹配 | 调整天线匹配电容 |
| SPI通信失败 | 相位/极性配置错误 | 检查CPOL/CPHA设置 |
| 数据校验错误 | 电源噪声干扰 | 加强电源滤波 |
调试输出示例：
[RFID] Initializing MFRC522... [RFID] Firmware Version: 0x92 [RFID] Waiting for card... [RFID] Card detected! [RFID] UID: 12 34 56 78 [RFID] Card type: Mifare Classic 1K [ACCESS] Granted for user: 0001天线调谐方法：
- 使用示波器观察TX引脚波形
- 调整匹配电容(通常6.8pF-8.2pF)
- 目标：获得最平滑的正弦波和最大幅值
7. 安全考量与最佳实践
RFID系统安全建议：
数据加密：
void EncryptUID(uint8_t *uid, uint8_t *key, uint8_t *output) { // 实现简单的异或加密 for(int i=0; i<4; i++) { output[i] = uid[i] ^ key[i]; } }防重放攻击：添加时间戳或随机数
物理安全：将读卡器嵌入防护外壳，防止拆卸
EMC设计要点：
- 在电源输入端添加TVS二极管
- 信号线走线避免锐角
- 保持地平面完整
在实际部署中，我们发现读卡器天线周围金属物体会显著影响性能。建议在安装时进行现场测试，确保读卡距离满足要求。对于需要更高安全性的场景，可以考虑升级到支持DESFire EV1协议的卡片，它们提供了更强的加密功能。