STM32F103RCT6(HAL库)驱动RC522：从零构建RFID门禁系统核心模块-开发者社区

1. 项目背景与硬件准备

最近在做一个智能门禁系统的原型开发，选择了STM32F103RCT6作为主控芯片，搭配RC522 RFID读写模块。这种组合在门禁考勤系统中非常常见，成本低且性能稳定。先说说为什么选这两个器件：

STM32F103RCT6是ST的经典款，72MHz主频够用，自带SPI接口正好驱动RC522。RC522模块更是个好东西，13.56MHz工作频率，支持ISO14443A标准的M1卡，淘宝上十块钱就能买到，还带天线板。我用的这块开发板是正点原子的MiniSTM32，引脚排布规整，调试起来特别方便。

硬件连接其实很简单，七根杜邦线就能搞定：

PA4(SPI1_NSS) -> SDA
PA5(SPI1_SCK) -> SCK
PA7(SPI1_MOSI) -> MOSI
PA6(SPI1_MISO) <- MISO
PA3 -> RST
3.3V -> 3.3V
GND -> GND

这里有个坑要注意：RC522的IQ引脚不用接，悬空就行。第一次做的时候我傻乎乎地把所有引脚都接了，结果模块死活不工作，查了半天手册才发现这个细节。

2. CubeMX配置要点

用STM32CubeMX配置SPI接口时，建议这样设置：

SPI模式选全双工主模式
时钟分频设到PCLK2的8分频（9MHz）
时钟极性低电平，相位第一个边沿
数据宽度8bit，MSB先行
NSS信号选软件控制

GPIO配置要注意：

NSS引脚（PA4）要手动设为GPIO输出
RST引脚（PA3）同样设为GPIO输出
SPI的SCK/MOSI/MISO记得配置复用功能

我遇到过SPI时钟速率过高导致通信失败的情况。RC522官方手册说最高支持10MHz，但实测发现当STM32超频到128MHz时，即使分频后SPI时钟在规格内也会出问题。后来把系统时钟调回72MHz就稳定了。

3. RC522驱动开发详解

3.1 寄存器操作基础

RC522的所有功能都是通过寄存器控制的，底层驱动要封装好读写函数。这里分享我的实现：

// 写寄存器 void MFRC_WriteReg(uint8_t addr, uint8_t data) { uint8_t AddrByte = (addr << 1) & 0x7E; // 地址格式转换 RS522_NSS(0); // 片选使能 HAL_SPI_TransmitReceive(&hspi1, &AddrByte, &ret, 1, 10); HAL_SPI_TransmitReceive(&hspi1, &data, &ret, 1, 10); RS522_NSS(1); // 片选禁用 } // 读寄存器 uint8_t MFRC_ReadReg(uint8_t addr) { uint8_t AddrByte = ((addr << 1) & 0x7E) | 0x80; // 读操作位 uint8_t data = 0; RS522_NSS(0); HAL_SPI_TransmitReceive(&hspi1, &AddrByte, &ret, 1, 10); HAL_SPI_TransmitReceive(&hspi1, &dummy, &data, 1, 10); RS522_NSS(1); return data; }

调试时发现个有趣现象：如果连续快速读写寄存器，必须保证NSS信号有足够的高低电平保持时间。我有次在for循环里连续写配置，结果只有第一个字节生效了，后来在每次操作后加了1us延时就正常了。

3.2 模块初始化流程

完整的初始化应该包括：

硬件复位（拉低RST引脚至少2us）
软复位（写CommandReg）
配置定时器参数
开启天线

void PCD_Reset(void) { // 硬复位 RS522_RST(0); HAL_Delay(2); RS522_RST(1); HAL_Delay(2); // 软复位 MFRC_WriteReg(MFRC_CommandReg, MFRC_RESETPHASE); // 定时器配置 MFRC_WriteReg(MFRC_ModeReg, 0x3D); MFRC_WriteReg(MFRC_TReloadRegL, 30); MFRC_WriteReg(MFRC_TModeReg, 0x8D); MFRC_WriteReg(MFRC_TPrescalerReg, 0x3E); }

天线控制也有讲究，开关间隔至少要1ms：

void PCD_AntennaOn(void) { uint8_t temp = MFRC_ReadReg(MFRC_TxControlReg); if (!(temp & 0x03)) { MFRC_SetBitMask(MFRC_TxControlReg, 0x03); } }

4. RFID卡片操作实战

4.1 寻卡与防冲突

寻卡使用PCD_Request命令，有两种模式：

PICC_REQIDL：只寻找未进入休眠的卡
PICC_REQALL：寻找所有卡

char PCD_Request(uint8_t RequestMode, uint8_t *pCardType) { uint8_t CmdFrameBuf[MFRC_MAXRLEN]; CmdFrameBuf[0] = RequestMode; // 发送寻卡命令 char status = MFRC_CmdFrame(MFRC_TRANSCEIVE, CmdFrameBuf, 1, CmdFrameBuf, &unLen); if(status == PCD_OK && unLen == 0x10) { pCardType[0] = CmdFrameBuf[0]; pCardType[1] = CmdFrameBuf[1]; } return status; }

防冲突算法是重点，RC522内置了防冲突机制，我们只需要调用PCD_Anticoll函数就能获得卡片UID：

char PCD_Anticoll(uint8_t *pSnr) { uint8_t CmdFrameBuf[MFRC_MAXRLEN] = {PICC_ANTICOLL1, 0x20}; char status = MFRC_CmdFrame(MFRC_TRANSCEIVE, CmdFrameBuf, 2, CmdFrameBuf, &unLen); if(status == PCD_OK) { for(int i=0; i<4; i++) { pSnr[i] = CmdFrameBuf[i]; } } return status; }

4.2 密钥认证流程

M1卡的每个扇区都有独立的密钥，进行读写前必须先认证。典型流程如下：

char PCD_AuthState(uint8_t AuthMode, uint8_t BlockAddr, uint8_t *pKey, uint8_t *pSnr) { uint8_t CmdFrameBuf[12]; CmdFrameBuf[0] = AuthMode; CmdFrameBuf[1] = BlockAddr; memcpy(&CmdFrameBuf[2], pKey, 6); // 密钥 memcpy(&CmdFrameBuf[8], pSnr, 4); // UID char status = MFRC_CmdFrame(MFRC_AUTHENT, CmdFrameBuf, 12, CmdFrameBuf, &unLen); return status; }

注意BlockAddr参数：虽然认证是以扇区为单位，但参数可以是扇区内的任意块地址。比如要操作第2扇区（块8-11），传入8、9、10或11都可以。

5. 数据读写实现

5.1 读块数据

读操作使用PICC_READ命令，每次读取16字节：

char PCD_ReadBlock(uint8_t BlockAddr, uint8_t *pData) { uint8_t CmdFrameBuf[4] = {PICC_READ, BlockAddr}; MFRC_CalulateCRC(CmdFrameBuf, 2, &CmdFrameBuf[2]); char status = MFRC_CmdFrame(MFRC_TRANSCEIVE, CmdFrameBuf, 4, CmdFrameBuf, &unLen); if(status == PCD_OK && unLen == 0x90) { memcpy(pData, CmdFrameBuf, 16); } return status; }

有个易错点：块地址范围是0-63，但：

每个扇区的最后一块（如块3、7、11...）是控制块，存储密钥和访问权限
块地址不能越界，否则会返回错误

5.2 写块数据

写操作相对复杂，需要先发送写命令，再发送数据：

char PCD_WriteBlock(uint8_t BlockAddr, uint8_t *pData) { uint8_t CmdFrameBuf[18]; CmdFrameBuf[0] = PICC_WRITE; CmdFrameBuf[1] = BlockAddr; MFRC_CalulateCRC(CmdFrameBuf, 2, &CmdFrameBuf[2]); // 发送写命令 char status = MFRC_CmdFrame(MFRC_TRANSCEIVE, CmdFrameBuf, 4, CmdFrameBuf, &unLen); if(status == PCD_OK) { memcpy(CmdFrameBuf, pData, 16); MFRC_CalulateCRC(CmdFrameBuf, 16, &CmdFrameBuf[16]); // 发送数据 status = MFRC_CmdFrame(MFRC_TRANSCEIVE, CmdFrameBuf, 18, CmdFrameBuf, &unLen); } return status; }

重要安全提示：写操作前一定要先验证密钥，否则会触发芯片的保护机制。我有次忘记验证直接写卡，导致一张M1卡被锁死，只能报废处理。

6. 门禁系统逻辑整合

6.1 串口指令控制

通过串口可以动态修改写入卡的数据，我设计了简单协议：

指令格式："Set_CardData:数据内容;"
最大支持16字节数据

void USART_Handl(void) { if(memcmp(UartData, "Set_CardData:", 13) == 0) { if(UartRxLen-14 <= 16) { RFID_WritFlag = 1; memcpy(RFID_WriteData, &UartData[13], UartRxLen-14); printf("准备写入数据:%s\n", RFID_WriteData); } } }

6.2 LED状态指示

增加两个LED作为状态指示：

LED0：系统运行指示灯（1Hz闪烁）
LED1：刷卡状态指示灯（刷卡时亮200ms）

// 在main循环中添加 HAL_GPIO_TogglePin(LED0_GPIO_Port, LED0_Pin); HAL_Delay(500); if(cardDetected) { HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_SET); HAL_Delay(200); HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET); cardDetected = 0; }