用STM32CubeMX和HAL库驱动RC522 NFC模块，从零实现一个简易门禁（附完整代码）

基于STM32CubeMX与HAL库的RC522门禁系统开发实战

在智能硬件开发领域，NFC技术因其非接触式交互特性，已成为门禁系统的首选方案。本文将完整呈现如何利用STM32CubeMX图形化工具和HAL库，从零构建一个稳定可靠的RC522门禁系统。不同于传统寄存器级开发，我们采用现代化工具链，让开发者能更专注于业务逻辑而非底层细节。

1. 开发环境搭建与硬件连接

1.1 硬件选型与连接规范

RC522模块与STM32的典型连接方式如下表所示：

注意：RC522工作电压严格限定3.3V，5V供电将导致模块永久损坏。建议使用优质电源模块，电压波动应控制在±0.1V以内。

1.2 CubeMX工程初始化

1. 创建新工程选择对应STM32型号（如STM32F103C8T6）
2. 在Pinout & Configuration界面启用SPI：
   • 模式选择Full-Duplex Master
   • 硬件NSS选择Disable
   • 分频系数设为8分频（对应9MHz时钟）
3. 配置两个GPIO：
   • RC522_RST：推挽输出，无上拉下拉
   • RC522_CS：推挽输出，初始高电平

/* 自动生成的GPIO初始化代码片段 */ static void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; /* SPI CS引脚配置 */ GPIO_InitStruct.Pin = GPIO_PIN_12; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_SET); /* RST引脚配置 */ GPIO_InitStruct.Pin = GPIO_PIN_11; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_11, GPIO_PIN_SET); }

2. RC522驱动层实现

2.1 寄存器操作基础函数

HAL库SPI传输需要特别注意时序控制。以下是经过优化的寄存器读写实现：

#define RC522_CS_LOW() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_RESET) #define RC522_CS_HIGH() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_SET) #define RC522_RST_LOW() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_11, GPIO_PIN_RESET) #define RC522_RST_HIGH() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_11, GPIO_PIN_SET) uint8_t RC522_ReadReg(uint8_t addr) { uint8_t txBuf[2] = {((addr << 1) & 0x7E) | 0x80, 0x00}; uint8_t rxBuf[2] = {0}; RC522_CS_LOW(); HAL_SPI_TransmitReceive(&hspi1, txBuf, rxBuf, 2, 100); RC522_CS_HIGH(); return rxBuf[1]; } void RC522_WriteReg(uint8_t addr, uint8_t val) { uint8_t txBuf[2] = {(addr << 1) & 0x7E, val}; RC522_CS_LOW(); HAL_SPI_Transmit(&hspi1, txBuf, 2, 100); RC522_CS_HIGH(); }

2.2 模块初始化流程

完整的初始化应包含以下步骤：

1. 硬件复位：

   void RC522_HardReset(void) { RC522_RST_LOW(); HAL_Delay(2); RC522_RST_HIGH(); HAL_Delay(50); }

2. 寄存器配置：

   void RC522_Init(void) { RC522_WriteReg(RC522_TModeReg, 0x8D); RC522_WriteReg(RC522_TPrescalerReg, 0x3E); RC522_WriteReg(RC522_TReloadRegL, 30); RC522_WriteReg(RC522_TReloadRegH, 0); RC522_WriteReg(RC522_TxAutoReg, 0x40); RC522_WriteReg(RC522_ModeReg, 0x3D); RC522_AntennaOn(); }

3. 天线控制：

   void RC522_AntennaOn(void) { uint8_t temp = RC522_ReadReg(RC522_TxControlReg); if(!(temp & 0x03)) { RC522_SetBitMask(RC522_TxControlReg, 0x03); } }

3. NFC卡片操作实现

3.1 卡片检测与识别流程

完整的卡片操作应遵循ISO14443-3标准流程：

1. 寻卡（REQA命令）：

   uint8_t RC522_Request(uint8_t reqMode, uint8_t *TagType) { uint8_t status; uint16_t backBits; uint8_t cmd = reqMode == PICC_REQIDL ? 0x26 : 0x52; status = RC522_ToCard(PCD_TRANSCEIVE, &cmd, 1, TagType, &backBits); if(status != MI_OK || backBits != 0x10) { status = MI_ERR; } return status; }

2. 防冲突处理：

   uint8_t RC522_AntiColl(uint8_t *serNum) { uint8_t status, i; RC522_WriteReg(RC522_BitFramingReg, 0x00); uint8_t cmd[2] = {PICC_ANTICOLL, 0x20}; status = RC522_ToCard(PCD_TRANSCEIVE, cmd, 2, serNum, NULL); if(status == MI_OK) { for(i=0; i<4; i++) { serNum[i] = cmd[i]; } } return status; }

3.2 数据块读写操作

实现Mifare Classic 1K卡的块操作：

读块函数：

uint8_t RC522_ReadBlock(uint8_t blockAddr, uint8_t *recvData) { uint8_t status; uint16_t recvBits; uint8_t cmd[2] = {PICC_READ, blockAddr}; status = RC522_ToCard(PCD_TRANSCEIVE, cmd, 2, recvData, &recvBits); if(status != MI_OK || recvBits != 128) { status = MI_ERR; } return status; }

写块函数：

uint8_t RC522_WriteBlock(uint8_t blockAddr, uint8_t *writeData) { uint8_t status; uint16_t recvBits; uint8_t cmd[18] = {PICC_WRITE, blockAddr}; memcpy(&cmd[2], writeData, 16); status = RC522_ToCard(PCD_TRANSCEIVE, cmd, 18, cmd, &recvBits); if(status != MI_OK || recvBits != 4 || (cmd[0] & 0x0F) != 0x0A) { status = MI_ERR; } return status; }

4. 门禁系统业务逻辑实现

4.1 卡片权限验证设计

建议采用白名单机制管理授权卡片：

typedef struct { uint8_t UID[4]; char userName[20]; uint32_t validUntil; } CardRecord; const CardRecord authorizedCards[] = { {{0xB5, 0x9D, 0xFC, 0xAA}, "Admin", 0xFFFFFFFF}, {{0xE1, 0xEF, 0xF3, 0xCC}, "UserA", 0xFFFFFFFF} }; uint8_t CheckCardPermission(uint8_t *uid) { for(int i=0; i<sizeof(authorizedCards)/sizeof(CardRecord); i++) { if(memcmp(uid, authorizedCards[i].UID, 4) == 0) { if(HAL_GetTick() < authorizedCards[i].validUntil) { return 1; } } } return 0; }

4.2 完整门禁控制流程

结合硬件外设实现完整控制：

void DoorControlSystem(void) { uint8_t status, uid[4], key[6] = {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; while(1) { status = RC522_Request(PICC_REQIDL, NULL); if(status == MI_OK) { status = RC522_AntiColl(uid); if(status == MI_OK && CheckCardPermission(uid)) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_SET); // 开门 HAL_Delay(3000); // 保持3秒 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_8, GPIO_PIN_RESET); } } HAL_Delay(100); } }

安全提示：实际项目中应将密钥存储在安全区域，避免硬编码在源码中。建议使用STM32的Flash保护功能或专用加密芯片。

5. 系统优化与调试技巧

5.1 常见问题排查指南

5.2 性能优化建议

1. 中断驱动设计：

   void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin) { if(GPIO_Pin == RC522_IRQ_Pin) { // 处理卡片中断 } }

2. DMA加速SPI传输：

   • 在CubeMX中启用SPI DMA
   • 使用双缓冲技术提升吞吐量

3. 低功耗优化：

   void EnterLowPowerMode(void) { RC522_AntennaOff(); HAL_SPI_DeInit(&hspi1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_SET); HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); }

实际部署中发现，在SPI时钟超过5MHz时，建议缩短总线长度至10cm以内，并使用屏蔽线缆。对于需要长距离布线的场景，可考虑降低时钟至1MHz以下，同时增加信号中继电路。