别再只会复制粘贴了！用STM32F103C8T6和RC522，从零手撸一个门禁卡读写器（附完整源码）
从零构建STM32+RC522门禁卡读写器的实战指南
项目背景与核心价值
在智能门禁系统日益普及的今天，理解RFID技术底层原理并掌握实际开发能力显得尤为重要。市面上大多数教程停留在模块驱动层面，而本教程将带您完整实现一个具备实用价值的门禁卡读写系统。不同于简单的技术演示，我们将从硬件选型、电路设计、底层驱动、协议解析到应用逻辑，构建一个真正可用的解决方案。
选择STM32F103C8T6作为主控，不仅因为其性价比突出（市场价约15元），更因其丰富的外设资源足以应对大多数嵌入式场景。搭配RC522读卡模块（约25元），整套硬件成本可控制在50元以内，却能达到商业读卡器的同等性能。这个项目特别适合需要定制门禁系统的创客、物联网开发者，以及希望深入理解RFID协议的学生群体。
1. 硬件架构设计与关键元件选型
1.1 核心元件功能解析
STM32F103C8T6最小系统：
- 72MHz Cortex-M3内核提供充足的处理能力
- 64KB Flash + 20KB RAM满足复杂逻辑需求
- 内置SPI接口确保与RC522的高速通信
- 多达37个GPIO可扩展其他外设
RC522模块技术参数：
| 参数 | 数值/特性 | |---------------|-------------------------| | 工作频率 | 13.56MHz ±7kHz | | 通信接口 | SPI/I2C/UART | | 读写距离 | 0~60mm（典型50mm） | | 支持协议 | ISO14443A/MIFARE | | 供电电压 | 2.5V~3.3V | | 峰值电流 | 30mA |1.2 电路连接方案
推荐使用硬件SPI连接，相比软件模拟可提升5倍以上的通信效率：
/* STM32与RC522引脚对应关系 */ #define RC522_SPI_PORT SPI1 #define RC522_CS_PIN PA4 // 片选 #define RC522_SCK_PIN PA5 // 时钟 #define RC522_MOSI_PIN PA7 // 主出从入 #define RC522_MISO_PIN PA6 // 主入从出 #define RC522_RST_PIN PB0 // 复位 #define RC522_IRQ_PIN PB1 // 中断(可选)注意：RC522模块必须使用3.3V供电，5V电压会导致芯片永久损坏。建议在电源输入端加入100μF电容滤波，可显著降低读卡失败概率。
2. 底层驱动开发与协议解析
2.1 SPI通信初始化
通过CubeMX配置SPI1参数：
hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hsp1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_32; // 2.25MHz hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; HAL_SPI_Init(&hspi1);2.2 RC522寄存器配置关键步骤
软复位序列：
void RC522_Reset(void) { HAL_GPIO_WritePin(RC522_RST_GPIO, RC522_RST_PIN, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(RC522_RST_GPIO, RC522_RST_PIN, GPIO_PIN_SET); HAL_Delay(50); }初始化关键寄存器：
// 设置定时器 RC522_WriteReg(TModeReg, 0x80); RC522_WriteReg(TPrescalerReg, 0xA9); RC522_WriteReg(TReloadRegH, 0x03); RC522_WriteReg(TReloadRegL, 0xE8); // 配置RF参数 RC522_WriteReg(TxASKReg, 0x40); RC522_WriteReg(ModeReg, 0x3D); RC522_AntennaOn(); // 开启天线
2.3 M1卡通信协议实现
卡片操作基本流程：
sequenceDiagram participant MCU participant RC522 participant M1Card MCU->>RC522: 寻卡命令(0x26) RC522->>M1Card: REQA M1Card-->>RC522: ATQA响应 RC522-->>MCU: 返回卡类型 MCU->>RC522: 防冲突命令(0x93) RC522->>M1Card: ANTICOLL M1Card-->>RC522: UID+校验 RC522-->>MCU: 返回4字节UID MCU->>RC522: 选卡命令(0x70) RC522->>M1Card: SELECT M1Card-->>RC522: SAK响应 RC522-->>MCU: 返回容量代码 MCU->>RC522: 验证密钥(0x60) RC522->>M1Card: AUTH M1Card-->>RC522: 随机数挑战 RC522->>M1Card: 加密响应 M1Card-->>RC522: 验证成功 MCU->>RC522: 读块命令(0x30) RC522->>M1Card: READ M1Card-->>RC522: 16字节数据3. 门禁系统核心功能实现
3.1 卡片UID读取与验证
典型门禁系统验证逻辑：
uint8_t CheckAccess(uint8_t* uid) { // 比对白名单 for(int i=0; i<WHITELIST_SIZE; i++) { if(memcmp(uid, WhiteList[i], 4) == 0) { return 1; // 验证通过 } } return 0; // 验证失败 } void ProcessCard(void) { uint8_t uid[4]; if(RC522_ReadUID(uid) == MI_OK) { if(CheckAccess(uid)) { OpenDoor(); // 驱动继电器开门 Buzzer_Beep(1000); // 提示音 } else { Buzzer_Beep(3000); // 错误音 } } }3.2 扇区数据读写实战
以修改第1扇区块1数据为例：
uint8_t WriteCardData(uint8_t sector, uint8_t block, uint8_t* data) { uint8_t status; uint8_t keyA[6] = {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; // 默认密钥 // 验证扇区密钥 status = RC522_Auth(PICC_AUTHENT1A, block, keyA, uid); if(status != MI_OK) return status; // 写入数据块 status = RC522_Write(block, data); RC522_Halt(); // 休眠卡片 return status; } // 使用示例 uint8_t newData[16] = "MyAccessControl"; WriteCardData(1, 1, newData);警告：修改控制块(块3)需格外谨慎，错误的存取控制设置可能导致扇区永久锁定！
4. 典型问题排查与性能优化
4.1 常见故障处理指南
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法检测到卡片 | 天线匹配电路异常 | 检查L0、C0谐振回路(典型值1.8μH+27pF) |
| 读卡距离过短 | 电源噪声大 | 增加电源滤波电容(100μF+0.1μF组合) |
| 数据校验错误 | SPI时钟不稳定 | 降低SPI速率至<4MHz |
| 特定扇区读取失败 | 密钥不匹配 | 尝试默认密钥FF-FF-FF-FF-FF-FF |
| 卡片响应超时 | 卡片类型不兼容 | 确认卡片为MIFARE Classic系列 |
4.2 通信稳定性优化技巧
天线调谐方法：
- 使用示波器观察TX1/TX2引脚波形
- 调整匹配电容使13.56MHz载波幅度最大
- 典型值：L0=1.8μH，C0=27pF（需根据实际PCB调整）
软件容错机制：
uint8_t ReadWithRetry(uint8_t block, uint8_t* buf, uint8_t retry) { uint8_t status; while(retry--) { status = RC522_Read(block, buf); if(status == MI_OK) break; HAL_Delay(10); } return status; }功耗优化策略：
void EnterLowPowerMode(void) { RC522_WriteReg(CommandReg, PCD_IDLE); RC522_AntennaOff(); HAL_SPI_DeInit(&hspi1); __HAL_RCC_SPI1_CLK_DISABLE(); }
5. 系统扩展与高级应用
5.1 多卡片管理系统实现
通过扩展EEPROM存储白名单：
#define MAX_CARDS 100 typedef struct { uint8_t uid[4]; uint32_t valid_time; } CardRecord; void AddToWhiteList(uint8_t* uid) { CardRecord new_card; memcpy(new_card.uid, uid, 4); new_card.valid_time = HAL_GetTick() + 30*24*3600*1000; // 30天有效期 EEPROM_Write(WHITELIST_ADDR + card_count*sizeof(CardRecord), (uint8_t*)&new_card, sizeof(CardRecord)); card_count++; }5.2 无线升级与远程管理
利用STM32内置Bootloader实现OTA：
# PC端固件推送脚本示例 import serial import time ser = serial.Serial('COM3', 115200, timeout=1) ser.write(b"BOOT") # 进入Bootloader time.sleep(0.1) with open('firmware.bin', 'rb') as f: while True: chunk = f.read(256) if not chunk: break ser.write(chunk) ack = ser.read(1) # 等待ACK5.3 安全增强方案
动态密钥生成算法：
void GenerateDynamicKey(uint8_t* uid, uint8_t* key) { uint32_t hash = 5381; for(int i=0; i<4; i++) { hash = ((hash << 5) + hash) + uid[i]; // DJB2哈希 } memcpy(key, &hash, 4); key[4] = hash >> 8; key[5] = hash >> 16; }双向认证流程：
sequenceDiagram participant Server participant Reader participant Card Reader->>Card: 请求随机数A Card-->>Reader: 返回随机数A Reader->>Server: 发送随机数A Server-->>Reader: 返回加密挑战{E(K, A⊕B)} Reader->>Card: 转发加密挑战 Card->>Card: 解密验证 Card-->>Reader: 返回随机数B Reader->>Server: 验证B完成认证
项目成果与后续优化
完成后的系统可实现以下功能指标：
- 读卡响应时间 < 200ms
- 支持同时存储100张卡白名单
- 典型工作电流 < 50mA
- 有效读卡距离 3-5cm
实际部署时可考虑添加以下扩展：
- 增加LCD显示屏实时显示刷卡信息
- 集成WiFi模块实现远程授权管理
- 添加指纹模块实现多因素认证
- 采用太阳能电池板供电实现无线安装
遇到天线调谐问题时，建议使用网络分析仪测量谐振频率。曾有个案例，通过将匹配电容从22pF调整为27pF，使读卡距离从1cm提升到5cm，这充分说明硬件调优的重要性。