用STM32CubeMX+RC522模块，5分钟搞定RFID门禁卡识别（附完整SPI配置流程）

5分钟极速上手STM32CubeMXRC522实现RFID卡号读取全攻略从零开始的硬件连接指南RC522模块与STM32的SPI连接看似简单但细节决定成败。我们先来看引脚对应关系RC522引脚STM32引脚类型功能说明SDASPI_NSS片选信号低电平有效SCKSPI_SCK时钟信号MOSISPI_MOSI主设备输出从设备输入MISOSPI_MISO主设备输入从设备输出GNDGND接地RSTGPIO输出复位信号高电平有效3.3V3.3V电源模块供电常见坑点警示切勿将3.3V接至5V电源RC522模块仅支持3.3V供电IRQ引脚保持悬空即可无需连接建议使用10cm以内的短导线连接过长可能导致信号衰减提示若使用F103系列开发板SPI1的默认引脚为PA4(NSS)、PA5(SCK)、PA6(MISO)、PA7(MOSI)CubeMX配置三步走1. SPI接口配置在Pinout Configuration界面中搜索SPI1并设置为Full-Duplex Master参数保持默认Prescaler选择2分频确保时钟≤10MHzCPOLLowCPHA1Edge数据宽度8bitMSB先行2. GPIO设置为RST引脚分配一个GPIO输出// 在main.h中定义方便调用 #define RC522_RST_Pin GPIO_PIN_0 #define RC522_RST_GPIO_Port GPIOA3. 时钟树调整确保SPI时钟不超过模块限制// 对于72MHz主频的STM32F103 HCLK 72MHz PCLK2 72MHz SPI1_CLK PCLK2/2 36MHz精简代码实战核心驱动函数// rc522.c void MFRC_WriteReg(uint8_t addr, uint8_t val) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); // 拉低NSS uint8_t txBuf[2] {(addr1)0x7E, val}; HAL_SPI_Transmit(hspi1, txBuf, 2, 100); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); // 拉高NSS } uint8_t MFRC_ReadReg(uint8_t addr) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); uint8_t txBuf[2] {((addr1)0x7E)|0x80, 0xFF}; uint8_t rxBuf[2]; HAL_SPI_TransmitReceive(hspi1, txBuf, rxBuf, 2, 100); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); return rxBuf[1]; }初始化序列优化版void RC522_Init(void) { // 硬件复位 HAL_GPIO_WritePin(RC522_RST_GPIO_Port, RC522_RST_Pin, GPIO_PIN_SET); HAL_Delay(2); HAL_GPIO_WritePin(RC522_RST_GPIO_Port, RC522_RST_Pin, GPIO_PIN_RESET); HAL_Delay(2); HAL_GPIO_WritePin(RC522_RST_GPIO_Port, RC522_RST_Pin, GPIO_PIN_SET); // 关键寄存器配置 MFRC_WriteReg(MFRC_CommandReg, 0x0F); // 软复位 MFRC_WriteReg(MFRC_ModeReg, 0x3D); // 发送接收模式 MFRC_WriteReg(MFRC_TReloadRegL, 30); // 定时器设置 MFRC_WriteReg(MFRC_TReloadRegH, 0); MFRC_WriteReg(MFRC_TxASKReg, 0x40); // 100%调制 MFRC_WriteReg(MFRC_RxGainReg, 0x70); // 接收增益 }卡号读取流程精解1. 寻卡阶段uint8_t PCD_Request(uint8_t req_code, uint8_t *card_type) { uint8_t status; MFRC_WriteReg(MFRC_BitFramingReg, 0x07); // 最后一位设为1 status MFRC_Comm(PCD_TRANSCEIVE, req_code, 1, card_type, 1); if ((status ! 0) || (*card_type ! 0x10 *card_type ! 0x26)) { return 1; // 失败 } return 0; }2. 防冲突处理uint8_t PCD_Anticoll(uint8_t *serial) { uint8_t status, i; MFRC_WriteReg(MFRC_BitFramingReg, 0x00); // 清除防冲突标志 uint8_t cmd PCD_ANTICOLL; uint8_t buf[5]; status MFRC_Comm(PCD_TRANSCEIVE, cmd, 1, buf, 5); if (status 0) { // 校验序列号 uint8_t check 0; for (i0; i4; i) { check ^ buf[i]; } if (check ! buf[4]) return 1; memcpy(serial, buf, 4); } return status; }3. 主循环实现while (1) { uint8_t card_type; if (PCD_Request(0x26, card_type) 0) { // 寻卡 uint8_t uid[4]; if (PCD_Anticoll(uid) 0) { // 防冲突 printf(检测到卡片 UID: %02X%02X%02X%02X\n, uid[0], uid[1], uid[2], uid[3]); // 简单权限验证示例 const uint8_t masterUID[4] {0x12, 0x34, 0x56, 0x78}; if (memcmp(uid, masterUID, 4) 0) { HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET); } } } HAL_Delay(100); }性能优化技巧SPI时序调优// 在CubeMX中调整SPI参数 hspi1.Init.CLKPolarity SPI_POLARITY_LOW; hspi1.Init.CLKPhase SPI_PHASE_1EDGE; hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_8; // 9MHz for F72 hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.NSS SPI_NSS_SOFT;天线参数调整// 优化读写距离单位cm void AdjustAntenna(uint8_t distance) { uint8_t value (distance 5) ? 0x60 : (distance 10) ? 0x70 : 0x7F; MFRC_WriteReg(MFRC_RxGainReg, value); }低功耗模式集成void EnterLowPowerMode(void) { MFRC_WriteReg(MFRC_CommandReg, PCD_IDLE); MFRC_WriteReg(MFRC_TModeReg, 0x80); // 定时器自动唤醒 MFRC_WriteReg(MFRC_TPrescalerReg, 0xA0); MFRC_WriteReg(MFRC_TReloadRegH, 0x03); MFRC_WriteReg(MFRC_TReloadRegL, 0xE8); }常见问题速查表现象可能原因解决方案无法检测到卡片天线未正确初始化检查PCD_AntennaOn()调用读取距离过短RxGain寄存器设置不当调整MFRC_RxGainReg值为0x70~0x7FSPI通信失败NSS引脚未正确控制确保每次传输前后有NSS电平变化卡号读取不稳定电源干扰在3.3V和GND之间添加100uF电容多卡冲突防冲突算法未启用确保调用PCD_Anticoll()函数进阶开发方向多卡管理系统typedef struct { uint8_t uid[4]; char user_name[16]; uint32_t valid_until; } CardRecord; CardRecord database[] { {{0x12,0x34,0x56,0x78}, Admin, 0xFFFFFFFF}, {{0x23,0x45,0x67,0x89}, Guest, 0x20241231} }; uint8_t CheckCardPrivilege(uint8_t *uid) { for (int i0; isizeof(database)/sizeof(CardRecord); i) { if (memcmp(uid, database[i].uid, 4) 0) { return (HAL_GetTick() database[i].valid_until) ? 1 : 0; } } return 0; }数据块读写示例uint8_t ReadBlock(uint8_t blockAddr, uint8_t *data) { uint8_t cmd[2] {PCD_AUTHENT, 0x60}; // 验证密钥A uint8_t uid[4]; PCD_Anticoll(uid); if (MFRC_Comm(PCD_TRANSCEIVE, cmd, 2, NULL, 0) ! 0) return 1; uint8_t readCmd[4] {PCD_READ, blockAddr, 0, 0}; return MFRC_Comm(PCD_TRANSCEIVE, readCmd, 4, data, 16); }实际测试中发现当环境存在多个RFID读卡器时适当调整MFRC_WriteReg(MFRC_CWGsPReg, 0x20)可以显著降低干扰