从SPI到串口在STM32CubeIDE中重构RC522驱动打造更灵活的低成本门禁系统最近在帮一个学弟折腾他的毕业设计他想用STM32F103C8T6做个宿舍门禁。方案很经典RC522读卡模块加上一个电磁锁。但问题来了他手头那块“蓝色小药丸”最小系统板SPI引脚已经被其他外设占用了只剩下串口还闲着。网上找了一圈清一色的SPI驱动几乎没人提怎么用串口操作RC522。这让我想起以前做项目时也常遇到类似窘境——硬件资源紧张但标准驱动库又绑死在特定通信接口上。于是我决定重新梳理一下思路把RC522的串口驱动从头实现一遍顺便把过程中的坑和心得记录下来。对于很多电子爱好者、创客或者做课程设计的学生来说STM32F103C8T6这类核心板几乎是入门标配成本低、资源够用。而RC522作为13.56MHz射频读卡芯片价格亲民资料也多。但当这两者结合如果拘泥于最常见的SPI连接方式可能会在布线、引脚分配上遇到意想不到的限制。实际上RC522芯片本身支持SPI、I2C和UART三种通信模式通过配置芯片上的控制引脚即可切换。利用串口UART来驱动不仅能解放宝贵的SPI资源有时在布线、调试和模块化设计上反而更有优势。这篇文章我就带你一步步在STM32CubeIDE环境下用HAL库实现RC522的串口驱动并构建一个可实际运行的低成本门禁原型。1. 理解RC522的通信接口为何要选择串口在动手写代码之前我们得先搞清楚一个根本问题RC522明明有更“标准”的SPI接口为什么还要费劲去用串口这不仅仅是引脚不够时的权宜之计更是一种设计思路的拓展。SPI与UART的硬件连接对比先直观地看看两种方式的硬件连接差异连接方式STM32F103C8T6引脚需求RC522模块侧引脚布线复杂度通信特点SPI (模式0/3)SCK, MOSI, MISO, NSS (CS) 至少4个GPIOSCK, MOSI, MISO, SDA (NSS)较高需注意时钟线等长全双工高速有专用时钟线UARTTX, RX 仅需2个GPIOTXD, RXD低仅两根交叉线全双工异步无需时钟线从表格可以看出串口方案在引脚占用上优势明显。对于STM32F103C8T6这种只有48个引脚甚至更少的芯片每一个GPIO都弥足珍贵。省下两个引脚可能就意味着能多接一个状态指示灯、一个按键或者为未来的功能扩展留出余地。串口驱动的核心挑战与优势挑战在于RC522的串口模式并非像操作AT指令的Wi-Fi模块那样简单。它需要模拟SPI的读写时序通过特定的字节帧来访问其内部寄存器。这听起来有点“绕远路”但带来的好处是实实在在的硬件连接极简只需要交叉连接TX和RX甚至可以利用STM32的多个USART中的任意一个灵活性大增。调试极其方便你可以直接用USB转TTL串口工具在电脑上通过串口调试助手手动发送字节来测试RC522无需逻辑分析仪就能初步验证硬件和底层通信。模块化与隔离串口通信距离相对SPI更长抗干扰能力在某些场景下更好方便你将读卡头与主控板物理分离。代码可移植性一旦封装好底层的字节读写函数上层的寻卡、防冲撞、认证、读写等逻辑与SPI驱动完全一致知识可以复用。注意RC522模块通常默认是SPI模式。要启用串口模式需要根据模块手册在硬件上将其MODE引脚或类似功能引脚设置为高电平或低电平。购买模块时务必确认其支持模式切换并查找正确的设置方法。所以选择串口驱动RC522不是退而求其次的“凑合”而是在特定约束下引脚紧张、调试便利性要求高、需要物理隔离的一种积极、优雅的解决方案。接下来我们就在STM32CubeIDE中搭建这个环境。2. 工程创建与CubeMX配置为USART3做好准备我们选择STM32F103C8T6的USART3作为与RC522通信的端口原因是它的引脚PB10, PB11通常比较“清净”被其他功能占用的几率小。当然你也可以根据你的板子情况选择USART1或USART2。使用STM32CubeMX初始化项目新建工程打开STM32CubeIDE选择File - New - STM32 Project。在芯片选择器中输入STM32F103C8选中STM32F103C8Tx点击Next为工程命名例如RC522_UART_Demo然后完成创建。配置时钟在Pinout Configuration视图的System Core - RCC中将High Speed Clock (HSE)设置为Crystal/Ceramic Resonator为外部高速晶振。配置USART3在左侧Connectivity中找到USART3。将Mode设置为Asynchronous异步通信。参数设置Baud Rate设为9600RC522串口模式常用波特率Word Length为8 BitsParity为NoneStop Bits为1。硬件流控制Hardware Flow Control选择Disable。此时引脚PB10和PB11会自动被配置为USART3_TX和USART3_RX。你可以在芯片图形界面确认这一点。配置一个调试用串口可选但强烈推荐为了能看到程序运行日志我们再启用USART1连接USB转串口到电脑。在Connectivity - USART1中同样设置为异步模式波特率可以设为115200。引脚PA9和PA10会被自动分配。生成代码点击右上方的GENERATE CODE选择你的工具链和工程路径让CubeMX生成初始化代码。工程结构初览代码生成后你的工程目录会包含HAL库、启动文件以及Core/Src和Core/Inc下的用户代码区域。我们重点关注以下几个文件Core/Src/main.c: 程序入口。Core/Src/usart.c: 包含了USART1和USART3的初始化代码MX_USART1_UART_Init和MX_USART3_UART_Init。Core/Inc/main.h: 主要头文件。Core/Src/rc522.c和Core/Inc/rc522.h这是我们接下来要创建的核心驱动文件。现在硬件抽象层已经为我们准备好了USART3的发送和接收功能接下来就是实现与RC522“对话”的协议层。3. 构建串口驱动层模拟SPI的读写时序这是整个项目的核心也是最需要理解的部分。RC522在串口模式下其通信帧格式是模仿SPI的。简单来说每一次寄存器操作都由一个“地址/命令字节”和一个“数据字节”组成并且主机STM32发送后RC522会立刻回传一个字节。定义基础通信函数首先在rc522.c中我们需要实现最底层的字节读写函数。这里我们利用HAL库的阻塞式发送接收函数因为它简单可靠适合初学者理解。/** * brief 通过USART3向RC522读写一个字节 * param TxData: 要发送的字节对于写操作是寄存器地址对于读操作是地址|0x80 * retval 接收到的字节RC522的回复 */ uint8_t RC522_UART_ReadWriteByte(uint8_t TxData) { uint8_t RxData 0; // 等待发送数据寄存器为空然后发送数据 HAL_UART_Transmit(huart3, TxData, 1, HAL_MAX_DELAY); // 等待并接收一个字节。RC522会在主机发送后立即回送数据。 HAL_UART_Receive(huart3, RxData, 1, HAL_MAX_DELAY); // 加入一个微小延时确保时序稳定特别是波特率较高时 // HAL_Delay(1); // 通常9600波特率下可以不加但若不稳定可尝试 return RxData; }这个函数是整个驱动的基石。无论是读寄存器还是写寄存器最终都通过调用它来完成一次完整的“请求-响应”交互。实现寄存器读写封装基于上面的字节读写函数我们可以封装出寄存器读写函数这与SPI驱动中的函数几乎一一对应。/** * brief 向RC522指定寄存器写入一个值 * param addr: 寄存器地址低6位有效最高位为0表示写 * param value: 要写入的值 * retval 无 */ void RC522_WriteReg(uint8_t addr, uint8_t value) { /* RC522串口模式帧格式先发送地址字节再发送数据字节 */ RC522_UART_ReadWriteByte(addr 0x3F); // 地址字节最高位清0 RC522_UART_ReadWriteByte(value); // 数据字节 } /** * brief 从RC522指定寄存器读取一个值 * param addr: 寄存器地址低6位有效最高位置1表示读 * retval 读取到的寄存器值 */ uint8_t RC522_ReadReg(uint8_t addr) { /* 读操作先发送地址字节最高位置1再发送一个哑元字节通常为0x00并接收返回值 */ RC522_UART_ReadWriteByte(addr | 0x80); // 地址字节最高位置1 return RC522_UART_ReadWriteByte(0x00); // 发送任意数据这里用0x00并接收返回的寄存器值 }这里的关键点在于地址字节的格式写操作地址字节的最高位bit7为0所以是addr 0x3F。读操作地址字节的最高位bit7为1所以是addr | 0x80。提示你可以写一个简单的测试函数循环读取RC522的VersionReg版本寄存器地址0x37。如果通信正常读出的值应该是0x92对应FM17522/FM17520等克隆芯片或0x91原装NXP MFRC522。这是验证硬件连接和底层驱动是否成功的第一步。有了这两个函数我们就拥有了操控RC522所有寄存器的能力。接下来我们需要用它们来实现RC522的初始化、寻卡、认证等高级功能而这一部分代码与标准的SPI驱动可以做到高度一致。4. 驱动层整合与功能实现寻卡、读卡与写卡在实现了寄存器读写之后上层的驱动函数就与通信接口解耦了。我们可以参考任何一份成熟的RC522 SPI驱动代码将其中的WriteRawRC和ReadRawRC函数替换成我们刚实现的RC522_WriteReg和RC522_ReadReg其余部分几乎可以原封不动地复用。RC522初始化流程初始化不仅仅是打开天线更需要配置一系列寄存器让芯片进入正确的工作模式这里以ISO14443 Type A为例。void RC522_Init(void) { HAL_Delay(50); // 上电延时等待RC522稳定 RC522_Reset(); // 软复位RC522 // 关闭天线防止初始化期间意外辐射 RC522_ClearBitMask(TxControlReg, 0x03); // 配置定时器用于设定通信超时 RC522_WriteReg(TModeReg, 0x8D); // 定时器自动重启 RC522_WriteReg(TPrescalerReg, 0x3E); // 分频系数与定时器重载值共同决定超时时间 RC522_WriteReg(TReloadRegL, 30); RC522_WriteReg(TReloadRegH, 0); // 设置调制深度为100% ASK RC522_WriteReg(TxAutoReg, 0x40); // 设置接收器增益 RC522_WriteReg(RFCfgReg, 0x7F); // 设置工作模式为ISO14443-A RC522_WriteReg(ModeReg, 0x3D); // 开启天线 RC522_SetBitMask(TxControlReg, 0x03); printf([RC522] Initialized (UART Mode).\r\n); }核心操作函数封装接下来我们需要实现几个最关键的函数它们构成了门禁系统的基础寻卡 (PcdRequest)发送寻卡指令检测天线范围内是否有符合标准的卡片。防冲撞 (PcdAnticoll)当有多张卡时获取其中一张卡的唯一序列号UID。选卡 (PcdSelect)通过UID选择特定的卡片进行后续操作。验证密钥 (PcdAuthState)使用密钥如默认的0xFF 0xFF 0xFF 0xFF 0xFF 0xFF验证卡片指定扇区的访问权限。读块 (PcdRead)与写块 (PcdWrite)对卡片数据进行读写。由于这些函数的实现逻辑较长且与SPI版本大同小异其核心都是通过调用一个统一的PcdComMF522函数来发送命令和数据帧并解析响应。这里以PcdRequest寻卡函数为例展示其结构char PcdRequest(uint8_t req_code, uint8_t *pTagType) { char status; uint8_t buffer[MAXRLEN]; uint32_t len; // 1. 配置寄存器准备寻卡 RC522_ClearBitMask(Status2Reg, 0x08); RC522_WriteReg(BitFramingReg, 0x07); RC522_SetBitMask(TxControlReg, 0x03); // 2. 构建命令帧这里就是寻卡命令字 buffer[0] req_code; // 例如 PICC_REQALL (0x52) // 3. 通过底层通信函数发送命令并接收响应 status PcdComMF522(PCD_TRANSCEIVE, buffer, 1, buffer, len); // 4. 解析响应 if ((status MI_OK) (len 0x10)) { pTagType[0] buffer[0]; pTagType[1] buffer[1]; } else { status MI_ERR; } return status; }而PcdComMF522是这个驱动中最复杂的函数它负责处理RC522命令的发送、FIFO操作、中断等待和响应接收。在串口驱动中它的实现与SPI驱动完全一致因为寄存器操作已经被我们抽象了。你需要确保这个函数正确地处理了CommandReg、FIFODataReg、ComIrqReg等关键寄存器。封装上层应用接口为了方便主程序调用我们可以再封装一层更简单的函数例如RC522_FindCard包含寻卡和防冲撞返回UID和RC522_ReadBlock包含选卡、验证、读数据。/** * brief 寻找一张卡片并获取其UID * param uid: 用于存储卡片UID的数组至少4字节 * retval 成功返回MI_OK失败返回错误码 */ int8_t RC522_FindCard(uint8_t *uid) { uint8_t tagType[2]; int8_t status; status PcdRequest(PICC_REQALL, tagType); // 寻卡 if (status ! MI_OK) { return status; } status PcdAnticoll(uid); // 防冲撞获取UID return status; }至此RC522的串口驱动库就基本构建完成了。你可以将rc522.c和rc522.h文件移植到任何基于HAL库的STM32工程中只需修改RC522_UART_ReadWriteByte函数里对应的UART句柄比如从huart3改为huart2即可。5. 系统集成与调试构建门禁原型与问题排查驱动写好了接下来就是把它用起来构建一个完整的门禁演示系统。主程序逻辑设计在main.c中我们可以实现一个简单的轮询式读卡逻辑并通过串口打印信息。int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_USART1_UART_Init(); // 调试串口 MX_USART3_UART_Init(); // RC522通信串口 // 初始化自己的延时函数和printf重定向到USART1 // ... printf(System Boot...\r\n); RC522_Init(); uint8_t cardUID[4] {0}; uint8_t key[6] {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; // 默认密钥 uint8_t readData[16] {0}; while (1) { // 1. 寻卡 if (RC522_FindCard(cardUID) MI_OK) { printf(Card Detected! UID: %02X %02X %02X %02X\r\n, cardUID[0], cardUID[1], cardUID[2], cardUID[3]); // 2. 选卡 if (PcdSelect(cardUID) MI_OK) { // 3. 验证第1扇区、第0块的密钥A (块地址为0x04) if (PcdAuthState(PICC_AUTHENT1A, 0x04, key, cardUID) MI_OK) { // 4. 读块数据 (块地址0x04) if (PcdRead(0x04, readData) MI_OK) { printf(Block Data: ); for (int i 0; i 16; i) { printf(%02X , readData[i]); } printf(\r\n); // 这里可以添加UID比对逻辑实现门禁控制 // if (memcmp(cardUID, authorizedUID, 4) 0) { // HAL_GPIO_WritePin(LOCK_GPIO_Port, LOCK_Pin, GPIO_PIN_SET); // 开锁 // HAL_Delay(3000); // HAL_GPIO_WritePin(LOCK_GPIO_Port, LOCK_Pin, GPIO_PIN_RESET); // 关锁 // } } } } HAL_Delay(1000); // 读卡成功后延时防止连续读 } HAL_Delay(200); // 寻卡间隔 } }利用串口调试助手进行底层通信验证这是串口方案独有的调试优势。在集成完整驱动之前你可以先不写任何RC522驱动代码直接用串口调试助手手动与模块“对话”。将RC522模块的TX、RX分别连接到USB转TTL工具的RX、TX。打开串口调试助手如SecureCRT、Putty、或者各种国产工具设置波特率96008N1。发送一个字节例如0x37 | 0x80 0xB7读取版本寄存器。如果连接正确你会立刻收到一个字节的回复。对于原装MFRC522回复应该是0x91或0x92。这个过程能最直接地验证硬件连接、波特率设置和RC522模块的串口模式是否启用成功。如果收不到回复或回复错误就需要检查接线、模块模式跳线、电源等硬件问题。常见问题与排查思路在开发过程中你可能会遇到以下问题完全读不到卡检查天线确保RC522的天线线圈连接良好没有短路或断路。可以尝试用手靠近天线看是否有反应有时能触发。检查初始化序列特别是PcdReset()和天线开关PcdAntennaOn()的调用是否成功。可以通过读取VersionReg来确认芯片是否就绪。检查定时器配置TModeReg、TPrescalerReg、TReloadReg的配置直接影响通信超时时间配置不当会导致寻卡过程提前超时失败。寻卡不稳定时好时坏电源问题RC522对电源噪声比较敏感。确保使用稳定的3.3V供电并在电源引脚附近并联一个100uF的电解电容和一个0.1uF的瓷片电容。波特率偏差虽然9600波特率不高但也要确保STM32和RC522的时钟源相对准确。如果使用内部RC振荡器可能会有轻微偏差尝试稍微调整波特率如9500或9700看是否有改善。软件延时在RC522_UART_ReadWriteByte函数中发送和接收之间如果完全没有延时在有些硬件上可能因为响应不及时而出错。可以尝试加入HAL_Delay(1)或几个微秒的忙等待延时。能寻到卡但验证失败密钥错误确认你使用的密钥与卡片扇区控制块中存储的密钥A或密钥B一致。对于全新的M1卡默认密钥通常是6个0xFF。块地址错误M1卡的16个扇区中每个扇区的块3是控制块不能直接用PcdRead读取。确保你读写的块地址是数据块如扇区0的块0、块1但注意块0通常存放厂商信息只读。整个调试过程就是不断利用串口打印信息printf进行逻辑追踪结合手动串口测试验证底层通信逐步缩小问题范围的过程。当你的程序终于稳定地读出卡片UID时那种成就感是无可替代的。最后将读到的UID与你预设的白名单进行比较控制一个GPIO引脚输出高低电平来模拟电磁锁的开关一个最基础的门禁系统原型就诞生了。