ESP32零基础玩转RFID：从原理到刷卡门禁实战教程

先说个我自己的起点。很多人第一次对RFID产生兴趣都是因为手里那张旧门禁卡不插电、不接触靠近门锁“嘀”一声就开了。表面上看是个再普通不过的动作背后却是射频识别这套在门禁、食堂、图书馆、打卡机里跑了快二十年的成熟技术。如果你零基础想学ESP32又不想一上来就啃蓝牙协议栈或者WiFi配网那一堆抽象概念那“RFID刷卡”这个项目几乎是最好的起点硬件便宜、代码量小、效果直观做完你手里就多了一个能认卡的小设备成就感来得非常快。这篇文章会从RFID的原理讲起再到模块选型、接线、代码最后带你完整做一个“白名单刷卡放行”的模拟门禁装置。内容不需要你有任何嵌入式基础Arduino IDE装好跟着步骤走大概一个下午就能跑通。如果你是那种“看教程觉得都会一动手就翻车”的类型这篇文章里那些排查经验正好就是为你在第N次踩坑时准备的。1. 项目方案与整体设计思路为什么零基础先做RFID1.1 RFID到底是什么从一张门禁卡说起先花两分钟把RFID的原理讲明白这部分理解了后面调代码你就不会总觉得是在变魔术。射频识别Radio Frequency Identification的本质是读卡器通过天线发射一定频率的电磁波卡片进入这个电磁场以后内部的线圈会感应出电流也就是“隔空取电”。有了电卡里的芯片就能工作再把存储在里面的数据通过调制电磁波的方式回传给读卡器完成一次识别。整个过程不需要电池也不需要物理接触所以叫“射频识别”。这套技术按频率分了三档125kHz低频段常见的ID卡只存一个固定编号基本无加密便宜13.56MHz高频段常见的IC卡也就是M1卡有存储分区能够读写数据门禁卡、校园卡、公交卡大多属于这一类再往上还有超高频用于仓储物流这种需要远距离批量读取的场景。我们用的MFRC522模块就是工作在13.56MHz这一档符合ISO14443A标准直接对标市面上最常见的IC卡。顺便说一句天天听人说的NFC其实就是RFID技术的一个子集工作频率同样是13.56MHz额外支持了点对点双向通信。手机上的公交卡、门禁模拟底层和RFID是同一套逻辑只是规范细节有差异。所以学RFID并不落后你学的东西在NFC世界里依然通用。1.2 为什么选ESP32 RFID这个组合我见过不少零基础爱好者一上来就想搞STM32裸机开发买回来发现连寄存器配置都看不懂热情在一周内耗尽板子吃灰。做入门项目选型的第一原则不是“功能最强”而是“阻力最小”。ESP32走Arduino这条路有三点好处。第一代码生态极其友好读RFID卡这种活库已经把SPI时序、寄存器操作全部封装好了你需要写的只是业务逻辑也就是“读到卡了干什么”。第二ESP32自带WiFi和蓝牙这意味着你做完离线刷卡之后随时可以升级成联网上报刷卡记录、远程开门这些进阶功能项目天花板很高。第三成本低得离谱ESP32开发板十几块钱MFRC522模块几块钱卡片一两块钱配件加一起不超过三十块。RFID本身的协议复杂度也比较温和它不像蓝牙那样需要处理配对、广播、服务发现核心思路就是“读卡号做判断”。选它作为第一个ESP32项目你能在一两天内体验完“看原理图—接线—写代码—调通—外设联动”的完整流程这个项目心智比具体知识点还值钱。类比一下学做饭不应该从种地开始而是从番茄炒蛋开始。1.3 硬件选型读卡模块和卡片到底怎么买模块方面市面上常见三种MFRC522、RC522、PN532。MFRC522和RC522本质上核心芯片兼容很多模块虽然丝印不同用法几乎一样。PN532功能更强支持ISO14443B、Felica这些协议I2C/SPI/UART接口齐全能模拟NFC卡片但价格贵一倍以上库调用也更繁琐。对于零基础项目我的建议很直接选MFRC522十几行代码就能出结果等以后要做卡模拟再上PN532不迟。卡片方面常见的M1卡叫S50容量1KB分16个扇区每个扇区4个块块0存放UID和厂商数据块3存放密钥和访问控制位。也有S70容量更大。还有一种叫UID卡特殊之处在于0扇区0块可写也就是能够修改UID这卡在复制门禁卡的圈子里很有名但作为学习用途你只需要知道存在即可。买卡片时注意一点MFRC522只能读13.56MHz的IC卡如果你手头那张卡是125kHz的ID卡模块是读不出来的别拿它背锅。下单时还有个细节同一款MFRC522模块有的带独立天线板有的是一体板。我建议买天线板分离的那种读卡距离稍微远一点稳定性和一致性也更好。一体板不是不能用只是当天线附近有干扰时差别就会显现出来。2. 环境准备与接线ESP32接MFRC522要避开的坑2.1 Arduino IDE环境搭建先把开发环境搞定。零基础用户首选Arduino IDE理由是图形化界面、库管理器一键安装、串口监视器内置这些对新手友好度远超命令行工具链。步骤拆开看就三步。下载安装Arduino IDE版本选2.x即可界面更现代编译速度也比老版本快。然后在“文件—首选项—附加开发板管理器网址”里填入ESP32的官方开发板索引地址。这个地址很多教程都会直接贴出来我建议你认准来源尽量从芯片厂商官方文档或知名教程站点获取别从乱七八糟的第三方博客复制来历不明的链接。填好之后打开“工具—开发板—开发板管理器”搜索esp32找到官方包直接安装这个过程会下载不少文件耐心等一会儿。安装完以后插上ESP32开发板在“工具—开发板”里选择“ESP32 Dev Module”再在“工具—端口”里选择对应的COM口。如果你在端口列表里找不到设备大概率是USB转串口芯片驱动没装好。ESP32开发板上常见的两种串口芯片是CH340和CP210xCH340在Windows下偶尔需要手动装驱动CP210x一般即插即用。设备管理器里看一眼有感叹号就装对应驱动这一步卡住的人最多。2.2 MFRC522接线一张表讲清楚接线是整个项目里最容易劝退零基础朋友的地方。但其实只要理解了SPI这事情就简单了。MFRC522走SPI通信SPI一共需要四根信号线SCK时钟、MOSI主机发从机收、MISO从机发主机收、SS片选告诉从机“轮到你了”。MFRC522模块上还有一个RST脚用来复位读卡芯片也需要接上。下面是ESP32与MFRC522的引脚对应关系直接按这个表接MFRC522引脚ESP32引脚说明SDAGPIO5片选信号SS注意不是I2C数据线SCKGPIO18SPI时钟MOSIGPIO23主机发送从机接收MISOGPIO19从机发送主机接收RSTGPIO22复位信号3.3V3.3V模块供电GNDGND共地IRQ不接中断输出本例不用接完以后别急着上电先检查一遍。这里有两个高频翻车点。一个是电源MFRC522模块的VCC我强烈建议接ESP32的3.3V而不是5V。有些模块板上做了稳压接5V也能用但也有很多模块没有做5V兼容设计直接接5V轻则模块发烫重则烧毁芯片——听我一句劝没必要为这点供电余量赌一把。另一个是接线顺序养成先接GND和电源、再接信号线的习惯最后上电前用肉眼逐条核对一遍这能避免大部分低级错误。2.3 安装MFRC522库打开Arduino IDE的“库管理器”搜索MFRC522会有好几个同名库装那个下载量最高、维护时间最长的即可。这个库做的事情是把SPI通信、寄存器读写、卡片防冲突循环这些底层细节全部封装成函数。你调用一个PICC_IsNewCardPresent()它就去检测有没有卡靠近调用PICC_ReadCardSerial()它就帮你完成和卡片之间的完整握手并取出UID。你不需要知道它具体操作了哪些寄存器就像你不需要知道自来水厂怎么净水拧开水龙头水就来了这就够了。装完库以后建议先用库自带的示例程序做一次测试。文件—示例—MFRC522—ReadAndWrite或DumpInfo烧录进去打开串口监视器把卡靠近模块如果能看到卡片UID说明硬件链路全部正常可以从接线问题的泥潭里解脱出来了。3. 核心代码实现从读UID到刷卡放行3.1 读取UID不到50行代码跑通基础先写一个最简程序目标只有一个把卡片靠近模块串口打印出UID。代码不长但每一步都有讲究我加了不少注释。#include SPI.h #include MFRC522.h #define SS_PIN 5 #define RST_PIN 22 MFRC522 mfrc522(SS_PIN, RST_PIN); void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); mfrc522.PCD_DumpVersionToSerial(); Serial.println(请将卡片靠近读卡器...); } void loop() { // 检测是否有新卡片进入天线范围 if (!mfrc522.PICC_IsNewCardPresent()) { return; } // 与卡片建立通信读取UID if (!mfrc522.PICC_ReadCardSerial()) { return; } Serial.print(卡号 UID: ); for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { Serial.print(0); } Serial.print(mfrc522.uid.uidByte[i], HEX); } Serial.println(); // 终止当前卡片的通信会话否则容易重复读到同一张卡 mfrc522.PICC_HaltA(); }烧录完以后把串口监视器波特率设为115200卡片贴近天线板就能看到一长串十六进制数字。比如说A1B2C3D4这就是这张卡的UID。每张卡出厂时UID都不同它就是你这张卡的“身份证号”。这里解释一下为什么读卡过程要分两步。PICC_IsNewCardPresent()只是检测到有物体进入射频场但还没完成握手相当于有人按了门铃。PICC_ReadCardSerial()才真正执行防冲突循环并与卡片交换数据拿到UID相当于主人开门确认来者身份。最后那行PICC_HaltA()很关键它是让卡片从激活状态转为休眠状态结束整个通信过程。不写这行程序可能在同一张卡上反复执行读取逻辑导致连续打印或者功能错乱。3.2 从“读卡”到“刷卡放行”加入白名单判断拿到UID只是第一步要做到“刷卡放行”的体验核心在于白名单比较。逻辑很简单预先把允许通过的UID列表存在代码里每次读到卡就和这张表逐条比对匹配成功就执行放行动作否则执行拒绝动作。白名单定义成二维数组行为一张卡列为UID字节以最常见的4字节UID为例byte allowedUID[][4] { {0xA1, 0xB2, 0xC3, 0xD4}, {0x11, 0x22, 0x33, 0x44}, {0xAB, 0xCD, 0xEF, 0x12} };判断函数用一个嵌套循环遍历所有白名单条目bool checkUID(byte *uid, byte size) { int count sizeof(allowedUID) / sizeof(allowedUID[0]); for (int i 0; i count; i) { bool match true; for (byte j 0; j size; j) { if (allowedUID[i][j] ! uid[j]) { match false; break; } } if (match) { return true; } } return false; }这段代码的逻辑是外层循环遍历每一张白名单卡内层循环逐字节比对当前卡与白名单卡的UID只要有一个字节不同就判定不匹配跳到下一张卡继续比。全字节相同才返回true。为什么白名单用数组而不是用EEPROM或SD卡零基础阶段数组写死在代码里最直观改卡号只需重新编译烧录不需要引入额外的存储概念。等以后项目做大了自然就知道该把白名单挪到EEPROM或者服务器上那都属于后话。3.3 一个必须知道的边界UID不是密码这块内容我想单独拎出来说因为很多人在做门禁项目时对安全性存在严重误解。MFRC522读到的那串UID本质上是卡片出厂时烧录的一个序列号它对M1卡而言是明文裸露的没有任何加密保证。更麻烦的是市面上有一种UID卡专门允许改写0扇区0块也就是说你只要拿到一张卡的UID就能用UID卡照着复制出一张完全一样的卡门禁系统根本无法区分。所以只是比对UID的白名单方案做入门演示、做宿舍模拟门禁、做实验室打卡这种非敏感场景完全够用但如果你要把这套东西用在真实门禁上就要知道这个方案能被一张十几块钱的UID卡轻松绕过。正儿八经的解决方案是读取M1卡的加密扇区数据用密钥A或密钥B认证后校验扇区内容或者直接升级为CPU卡从硬件层面防止复制。这是整个项目里最需要你留个心眼的地方也是我在实际项目中踩过坑后才彻底想明白的道理。4. 完整实操搭建一个能用的刷卡打卡装置4.1 功能定义与器件清单前面都是单点验证现在我们把所有东西组装起来做一个完整的“白名单刷卡放行”模拟装置。功能定义如下刷白名单卡绿灯亮蜂鸣器短响一声串口打印欢迎信息。刷陌生卡红灯亮蜂鸣器长响一声串口打印拒绝信息。除了已有的ESP32开发板、MFRC522模块和卡片你还需要准备两个LED红、绿各一、两枚220Ω限流电阻、一个5V有源蜂鸣器模块、一块面包板和若干公母杜邦线。蜂鸣器用有源的即可有源蜂鸣器内部自带振荡源通电就响用GPIO直接拉高拉低就能控制声音开关比无源蜂鸣器需要PWM驱动省事得多。如果你手里有继电器模块还可以把“放行”动作从亮灯升级为“控制电锁开锁”那就真的接近一个迷你门禁系统了。但建议先把LED验证完再接继电器降低排查难度。4.2 完整接线与代码在原有MFRC522接线基础上增加外设的接法如下绿灯正极接GPIO33通过220Ω限流电阻到GND。红灯正极接GPIO32通过220Ω限流电阻到GND。蜂鸣器模块的I/O脚接GPIO26VCC接3.3VGND接GND。选GPIO33、GPIO32、GPIO26的原因很简单它们都是普通的数字输出脚不和MFRC522使用的SPI引脚冲突。如果你手头板子引脚布局不同换其他空闲GPIO也完全可以只要记得在代码里同步改宏定义。完整代码如下#include SPI.h #include MFRC522.h #define SS_PIN 5 #define RST_PIN 22 #define GREEN_LED 33 #define RED_LED 32 #define BUZZER 26 MFRC522 mfrc522(SS_PIN, RST_PIN); byte allowedUID[][4] { {0xA1, 0xB2, 0xC3, 0xD4}, {0x11, 0x22, 0x33, 0x44} }; bool checkUID(byte *uid, byte size) { int count sizeof(allowedUID) / sizeof(allowedUID[0]); for (int i 0; i count; i) { bool match true; for (byte j 0; j size; j) { if (allowedUID[i][j] ! uid[j]) { match false; break; } } if (match) { return true; } } return false; } void allowAccess() { digitalWrite(GREEN_LED, HIGH); digitalWrite(BUZZER, HIGH); delay(200); digitalWrite(BUZZER, LOW); delay(1500); digitalWrite(GREEN_LED, LOW); } void denyAccess() { digitalWrite(RED_LED, HIGH); digitalWrite(BUZZER, HIGH); delay(800); digitalWrite(BUZZER, LOW); delay(500); digitalWrite(RED_LED, LOW); } void setup() { Serial.begin(115200); pinMode(GREEN_LED, OUTPUT); pinMode(RED_LED, OUTPUT); pinMode(BUZZER, OUTPUT); SPI.begin(); mfrc522.PCD_Init(); Serial.println(门禁系统已启动请刷卡); } void loop() { if (!mfrc522.PICC_IsNewCardPresent()) { return; } if (!mfrc522.PICC_ReadCardSerial()) { return; } // 打印卡号便于后续将新卡加入白名单 Serial.print(卡号: ); String uidStr ; for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { Serial.print(0); } Serial.print(mfrc522.uid.uidByte[i], HEX); uidStr String(mfrc522.uid.uidByte[i], HEX); } Serial.println(); if (checkUID(mfrc522.uid.uidByte, mfrc522.uid.size)) { Serial.println(欢迎进入); allowAccess(); } else { Serial.println(拒绝访问); denyAccess(); } mfrc522.PICC_HaltA(); }代码里我把放行和拒绝各自封装成函数逻辑非常清晰读卡、打印卡号、白名单判断、执行对应动作、终止通信。如果你想加入第三张白名单卡只需要在allowedUID数组里加一行把串口打印出来的卡号填进去重新烧录即可。4.3 调试过程实录从烧录到能“刷开门”这一步是我最想和你分享的部分因为项目的真实价值不在代码本身而在从“烧录完没反应”到“稳定刷卡”之间走过的那些弯路。我第一次上电时串口监视器什么输出都没有。排查完发现是端口没选对。这个错很蠢但真的太常见了Arduino IDE顶部那个端口下拉框里可能列了好几个COM口有的是蓝牙虚拟串口有的是USB转串口设备选错一个程序根本烧不进去。解决办法是烧录前先拔掉开发板看哪个COM口消失剩下的那个才是目标板。烧录成功后又遇到第二个问题卡片贴在模块上串口没有反应。先怀疑接线用万用表测了所有杜邦线的通断没问题。后来发现是卡片靠得太偏MFRC522的天线板有效读取区域就在线圈正上方卡片斜着放或者放在线圈边缘以外都可能读不到。把卡片摆正、贴近马上就有反应了。所以读不到卡先别怀疑硬件坏把卡在模块天线区上方平移、旋转排除位置问题再动线路。第三个问题比较隐蔽程序烧录后第一次放卡能读第二次就完全没动静。这个其实就是前面强调的PICC_HaltA()缺失导致的。卡片在第一次通信后没有进入休眠状态读卡器每次轮询都觉得这张卡还在但又无法重新建立会话表现就是“一次成功后失灵”。加上这行代码问题消失。这三个问题里有一个你能提前避开调试时间就能省一半以上。再补充一个回合蜂鸣器有源模块的VCC接5V还是3.3V很多有源蜂鸣器模块用5V驱动声音更大但ESP32引脚输出只有3.3V直接驱动会偏弱。我的做法就是把模块VCC接5VI/O引脚接GPIO26靠ESP32的GPIO拉高去控制三极管导通这样既不影响模块供电又能正常发声。如果你手头的蜂鸣器模块没有三极管驱动只是单纯的蜂鸣器元件那就要串电阻再接GPIO避免灌入电流过大。5. 常见问题排查刷卡失败与不稳定问题速查这个项目做完之后我陆陆续续在多个场景下重复搭过这套东西也帮不少人排查过同样的问题。把最高频的问题整理成一张速查表你遇到现象时先对照这个表比盲试有效得多。现象可能原因处理方法串口监视器完全无输出端口选错、驱动未装、TX/RX接线问题拔插USB确认端口设备管理器检查驱动编译报错找不到MFRC522库库未安装或安装的是同名冲突库打开库管理器卸载多余的重新安装标准库上电后模块发烫VCC接了5V模块无5V稳压电路断电立即改为3.3V供电卡片靠近无任何反应卡类型不是13.56MHz IC卡卡位置偏天线受金属干扰换IC卡测试调整卡片位置移开附近金属物体有时能读有时不能读杜邦线接触不良、面包板虚接按压接线端测试换新杜邦线考虑焊接到模块排针重复读到同一张卡缺少PICC_HaltA()调用在读取完成后调用PICC_HaltA()终止会话串口打印乱码代码波特率与监视器波特率不一致统一为115200或9600读卡距离只有1厘米天线板离金属太近模块质量差天线远离金属面板更换天线分离版模块除了速查表再分享几条实践经验。接线顺序永远先接电源线再接信号线全部接完后对照表检查一遍再上电。别嫌啰嗦这一步能救下至少一块ESP32开发板。模块供电用3.3V这句话我在这篇文章里说了三次不是凑字数而是因为烧板子的人太多了。有的模块板上明明写了5V兼容我仍然建议3.3V因为争议存在本身就说明风险存在没必要用学习成本去赌兼容性。卡片贴着天线板读不到很多时候不是硬件坏了而是卡是ID卡125kHz而不是IC卡13.56MHz。如果你手头没有M1卡我建议直接买几张空白S50卡一两块钱一张也可以找找有没有支持NFC的手机用手机模拟门禁卡功能做一个测试卡但要留意手机模拟出的可能是7字节UID代码里白名单数组要做相应扩展。导线长度也值得留意SPI信号线在面包板上短距离没问题但如果用长杜邦线接到十几厘米之外的模块信号质量就可能下降表现就是偶发读卡失败。我的经验是信号线总长控制在20厘米以内越短越稳。最后说说我对这个项目的整体感受。零基础做ESP32项目最忌讳的就是一开始就想做全功能。我见过太多人写代码前先规划了OLED显示、云端上报、远程开门、语音播报结果卡在第一步读卡上就放弃了。正确姿势是先跑通最简单的读UID串口打印出来然后加白名单判断再亮灯响铃最后才考虑接入WiFi和云端。每一步都有一个可验证的小成果信心就是这样一步步攒出来的。RFID刷卡这个项目做完以后你已经掌握了传感器读取、SPI通信、GPIO控制、串口调试这一整套嵌入式开发的基本功。接下来不管是往卡片数据读写方向深入还是把刷卡记录通过WiFi传到服务器或者做一个真正的智能门禁联动你都有了一个结实的起点。现在去把你那张卡靠近模块听那一声“嘀”吧。