做刷卡门禁这个想法很多人最初是在公司、学校或者小区门口被那“滴”的一声勾起来的。一张小卡片贴近读卡器门锁就自动弹开看起来总带点未来感。可当你真的把ESP32和RC522模块接好第一次在串口监视器里看到那串十六进制卡号稳定打印出来时那种“魔法被拆穿”的踏实感比拆一台新手机还要满足。这篇文章的目标只有一个零基础跑通RFID无线射频卡读取流程让ESP32获得“刷卡”能力。我会从方案选型、硬件接线讲起把RFID的工作原理掰开说清楚再带你把Arduino IDE里从环境配置到代码烧录全部实现。全程不需要任何电子学基础你需要的就是一块ESP32开发板、一个RC522读卡模块套装一般附带卡片和钥匙扣和一台能连USB的电脑。文末还整理了我实测踩过的坑以及从“能读卡”到“做成门禁雏形”的扩展思路。适合谁看一种是手里有ESP32、却一直不知道能做什么小项目的新手另一种是对门禁、考勤这类应用感兴趣想从硬件侧搞懂背后原理的人。这篇不会只丢给你一份代码而是让你明白每一步为什么要这么接、为什么要这么写。1. 为什么是ESP32加RC522我替你做过的方案权衡1.1 主控选型ESP32赢在“什么都带”做刷卡项目主控的选择其实不止一种。常见的有Arduino Uno、ESP8266、ESP32再往上有树莓派Pico等。如果你只是验证“读一张卡”它们都能做到。但ESP32赢在三件事自带Wi-Fi和蓝牙意味着刷卡记录可以联网上传或者用手机控制硬件SPI接口好用接RC522模块不用自己模拟时序开发环境成熟Arduino和MicroPython都能跑资料多到几乎踩不到没人走过的路。另一个现实因素是价格。ESP32开发板现在的价格已经压得很低在主流电商平台基本和Arduino入门板持平配置却高出一截双核240MHz、520KB SRAM、4MB Flash这个规格在物联网领域完全够用。零基础直接选ESP32等于以后做任何联网项目都不用再换主控。我在实际项目里的体会是如果未来想给这个刷卡器加上“远程开门”“微信通知”这类功能ESP32的Wi-Fi模块能把扩展成本降到零。入门阶段就把主控选对后面扩展会舒服很多。1.2 读卡方案为什么是RC522而不是PN532市场上最常见的HF高频读卡模块是RC522和PN532。RC522对应的芯片是NXP的MFRC522工作在13.56MHz支持读取MIFARE系列IC卡也就是绝大多数门禁卡、校园卡用的那种类型。它最大的优点是便宜模块价格在电商平台大概只有一顿早饭的钱而且读取距离虽然只有几厘米但门禁刷卡本来就是贴近式操作不存在“识别距离焦虑”。PN532的优势是同时支持NFC卡模拟、读写NTAG系列标签还能跟手机做点对点通信。但它的模块价格大概是RC522的数倍而且驱动复杂度明显更高。对零基础来说PN532的学习曲线偏陡仅仅是“让ESP32能刷卡”这个目标RC522是成本最低、资料最全的选择。这个选择背后是一个很朴素的原则先跑通再考虑扩展。RC522能把“刷卡”这件事用最小的代价做扎实等你理解了RFID这套数据交换方式以后换更高级的模块也是顺理成章的事。1.3 整体框架读卡、识别、反馈三件事整个项目可以拆成三个层次最底层是RFID模块与卡片的物理射频通信中间是ESP32通过SPI总线从RC522模块读取卡号最上层是业务逻辑判断卡号是否在允许名单里以及用蜂鸣器、LED、继电器做出对应反馈。这个分层意识在新手阶段特别重要。很多初学者一上来就想把“门禁系统”整个做出来结果卡在接线或者一个库版本问题上就放弃了。正确做法是先把“读卡号”跑通再把“名单判断”加上最后才轮到“开门动作”。每一层互相独立调试任何一层都不需要推翻前面所有工作。1.4 安全提醒RFID不是保险柜必须提前说一句13.56MHz的MIFARE Classic卡片其加密算法是上世纪九十年代的产物存在公开的安全漏洞卡片UID可以被复制。如果只是学习练手或者做一个宿舍里的模拟门禁问题不大但如果是严肃的生产环境门禁需要选用带更强加密逻辑的NFC卡片或者采用手机NFC加服务器验证的流程。这个项目虽然是零基础入门但安全意识从一开始就建立起来比以后返工划算得多。2. 硬件原理与接线实操先搞明白“刷卡”是怎么发生的2.1 RFID原理的大白话版本RFID全称Radio Frequency Identification翻译过来是射频识别。工作过程很像一次“无线点名”读卡器也就是RC522模块不断向外发射13.56MHz的射频载波信号。卡片靠近时内部的天线线圈通过电磁感应获得能量这和无源线圈给芯片供电的原理一样。卡片被“唤醒”后芯片通过改变天线负载的方式把自己的ID数据调制到射频信号上反射回读卡器。于是读卡器就拿到了卡片的UID。你可以把卡片想象成一个没有电池的感应门牌读卡器用类似“无线充电”的方式给它供一下电它就把写在自己芯片里的身份信息报出来。整个读卡过程通常只有几毫秒人根本感觉不到延迟。2.2 元件清单与购买建议这里列一个最小清单ESP32开发板任意带USB串口芯片的款式都可以用RC522 RFID读卡模块很多卖家会搭配两张IC白卡和一个钥匙扣卡杜邦线若干母对母或者公对母都行也可以把模块直接插在面包板上可选有源蜂鸣器、LED、继电器模块、12V电子锁用于组装完整门禁购买RC522时最容易踩的坑是天线缩水。正品MFRC522模块的天线线圈通常呈圆形或矩形走线规整拿在手里有明显厚度。有些仿制模块天线感应面积小读卡距离会明显缩短。另一个注意点是确认附赠的卡是13.56MHz的高频IC卡如果买错成低频的125kHz ID卡RC522完全不读。2.3 电路连接实操一张表搞定RC522模块是3.3V逻辑的ESP32的IO口也是3.3V电平所以两者可以直接互连不需要像Arduino Uno那样再搞电平转换。使用ESP32默认的VSPI引脚接线如下RC522引脚ESP32引脚说明SDA / CSGPIO5片选信号选中RC522SCKGPIO18SPI时钟线MOSIGPIO23主设备发送数据MISOGPIO19从设备回传数据RSTGPIO22硬件复位IRQ不接本教程用轮询方式用不到中断3.3V3.3V模块供电GNDGND共地接线要点是“共地”也就是ESP32的GND必须接RC522的GND。数字电路里信号的高低电平都是相对GND而言的共地接错其他线接得再对也是白搭。我建议接好线之后用万用表的蜂鸣档快速测一遍引脚之间的通断尤其排查有没有把某根信号线短接到3.3V。2.4 关于SPI协议的一点直觉SPI通信协议你可以理解成一个很规矩的“布告栏”MOSI线是主的传令员MISO线是从的应答员SCK是大家跺脚的节拍器CS线决定“我现在在跟谁说话”。SPI总线可以同时挂多个从设备但同一时刻只能有一个从设备被CS拉低选中。RC522模块的数据交换就是通过这套机制完成的。好在Arduino生态里有现成的SPI库我们不需要手动操作底层寄存器。但在排查问题时知道SCK是时钟线、MOSI和MISO是数据线、CS是片选线能让你少走很多弯路。3. 开发环境配置与代码实现把“刷卡能力”装进ESP323.1 Arduino IDE配置ESP32开发环境第一步安装Arduino IDE选2.x版本即可界面比老版舒服很多。打开“文件 → 首选项 → 附加开发板管理器网址”填入ESP32官方维护的开发板索引地址。然后在“工具 → 开发板 → 开发板管理器”里搜索esp32并安装。这一步会下载比较多的文件如果网络状况不太好的话可能要等一会儿。装完之后“开发板”菜单里会出现ESP32系列选择“ESP32 Dev Module”即可。端口选择识别到的USB串口Windows下是COM口macOS或Linux下通常是类似/dev/cu.usbserial-XXX的名字。如果端口列表里什么都没有八成是USB转串口芯片的驱动没装好CP2102或CH340的驱动需要单独安装。3.2 安装MFRC522库并解决引脚定义问题在“库管理器”里搜索“MFRC522”安装最常被引用的那一个版本即可。这个库是目前最通用的资料量大。唯一的问题是它最早为Arduino Uno设计默认引脚定义是SS接数字IO10、RST接数字IO9所以在ESP32上必须在代码开头用宏定义覆盖掉。3.3 主程序读取UID并打印到串口直接上代码。这个程序干的事情很单纯初始化SPI和RC522模块然后不停轮询一旦检测到卡片靠近读取UID以十六进制字符串形式打印到串口。#include SPI.h #include MFRC522.h #define RST_PIN 22 #define SS_PIN 5 MFRC522 mfrc522(SS_PIN, RST_PIN); void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); Serial.println(F(RFID Reader Ready, please scan...)); } void loop() { if (!mfrc522.PICC_IsNewCardPresent()) { return; } if (!mfrc522.PICC_ReadCardSerial()) { return; } Serial.print(F(UID: )); String content ; for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { Serial.print(F( 0)); content 0; } else { Serial.print(F( )); } content String(mfrc522.uid.uidByte[i], HEX); Serial.print(mfrc522.uid.uidByte[i], HEX); } Serial.println(); content.toUpperCase(); Serial.print(F(Card Number: )); Serial.println(content); mfrc522.PICC_HaltA(); mfrc522.PCD_StopCrypto1(); }这里有几个细节需要解释。首先是十六进制格式化UID从模块里读出来是一个byte数组每个字节用大写的HEX打印。如果某个字节小于0x10也就是十进制的16它转换成十六进制只有一位比如7不补零的话打印出来是“7”而我要的是“07”。补前导零之后卡号格式统一为8位十六进制方便后面做名单比对。其次是代码里最关键的两行收尾操作PICC_HaltA()和PCD_StopCrypto1()。它们的作用是让卡片进入HALT状态并停止加密通信这样下一张卡才能正常进入识别流程。如果少了这两行卡片靠近一次之后后续再贴上去就经常没反应了。编译烧录比较简单在工具菜单里选好开发板“ESP32 Dev Module”和对应端口然后点击上传。烧录完成后打开串口监视器波特率设置为115200把卡片贴近模块天线就能看到类似“UID: 3A 1B 4C 2D”的输出。注意串口监视器的波特率必须和程序里Serial.begin(115200)保持一致不一致就会出现一段段乱码。3.4 添加“认卡不认人”的名单校验逻辑读卡号只是第一步真正让项目有实际意义的是名单校验。把已知的授权卡号写进一个字符串数组每次刷卡后循环比对即可。我提供一个示例逻辑串口打印“允许通过”或“拒绝”同时用板载LED做出区分。#include SPI.h #include MFRC522.h #define RST_PIN 22 #define SS_PIN 5 MFRC522 mfrc522(SS_PIN, RST_PIN); String authorizedCards[] {A1B2C3D4, 11AA22BB}; int authorizedCount 2; bool checkUID(String uid) { for (int i 0; i authorizedCount; i) { if (uid authorizedCards[i]) { return true; } } return false; } void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); Serial.println(F(Authorized card check ready)); } void loop() { if (!mfrc522.PICC_IsNewCardPresent()) { return; } if (!mfrc522.PICC_ReadCardSerial()) { return; } String uid ; for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { uid 0; } uid String(mfrc522.uid.uidByte[i], HEX); } uid.toUpperCase(); if (checkUID(uid)) { Serial.println(F(ALLOWED)); } else { Serial.println(F(DENIED)); } mfrc522.PICC_HaltA(); mfrc522.PCD_StopCrypto1(); }名单判断的原理非常简单就是把字符串逐一比对。但这里有一个经验之谈授权卡号不要硬编码在程序里除非你只是做演示用。因为每烧录一次程序就要重新编译哪怕只是加一张卡。更合理的做法是把这个名单放到EEPROM或SD卡里或者通过Wi-Fi从服务器拉取。不过那就是后话了零基础先写死能跑通最重要。4. 让刷卡真正“能用”反馈、联动与硬件扩展4.1 给刷卡一个明确的“滴”门禁刷卡如果没有声音反馈会非常别扭。那种“滴”的一声其实是人判断系统正常工作的信任标志。给ESP32接一个有源蜂鸣器正极接GPIO26负极接GND程序里在通过名单校验时让引脚输出高电平延时200毫秒再拉低就能听到一声干脆的“滴”。这里要注意有源蜂鸣器自带震荡源给直流高电平就会响。无源蜂鸣器需要给PWM方波才发声用起来麻烦一些。新手建议直接买有源蜂鸣器模块省事。另外有些蜂鸣器模块是低电平有效也就是输入低电平时响要看模块丝印判断接反极性就怎么都听不到声音。4.2 LED指示灯与错误提示LED正极通过220欧姆电阻接GPIO27负极接GND。配合蜂鸣器可以做一个简单的状态提示组合刷卡通过时“滴一声加绿灯亮两秒”刷卡被拒绝时“滴滴滴三声加红灯闪烁三次”。蜂鸣器和LED的组合看似简单但它传递的信号很明确用户刷卡之后系统必须在几百毫秒内给出反馈否则人的体验就会变得“心里没底”。这里建议不要用delay()写死全部流程因为delay()会阻塞整个程序刷卡后的连续几秒内模块无法响应下一张卡。更好的方案是用millis()做非阻塞延时不过零基础阶段用delay()理解逻辑没有大问题等后续要加OLED屏幕显示时再改造。4.3 继电器控制电子锁新手先模拟进阶再上强电把继电器模块的输入信号引脚接到GPIO14COM端接12V电子锁的电源正极NO端接锁的电源负极就可以让ESP32用3.3V逻辑控制12V电路的通断。但说实话这个环节我不建议新手一开始就接真实锁具。原因有两条一是电磁锁或电插锁的电流不小ESP32的3.3V稳压器带不动必须用外部12V电源独立供电二是继电器控制的是比逻辑电路高得多的电压接线一旦出错轻则烧模块重则出安全事故。最稳妥的入门路线是先用一个LED模拟“开门”——刷卡通过时LED亮两秒然后熄灭代表门锁打开又自动落锁。等代码逻辑彻底稳定了再考虑上真实继电器的连接。4.4 从延时到状态机实际门禁里不能只想“判断卡号是否在白名单”这一件事。还要考虑多次刷卡重复触发、开锁期间不重复动作、刷卡失败后的冷却时间等问题。这些在软件上就是最简单的状态机空闲状态、开锁状态、冷落状态。比如开锁成功后设置一个2秒的锁定时长。在这2秒内无论刷多少次卡都不再触发。用一个变量记录上次开锁时间每次刷卡时判断当前时间与上次开锁时间的差是否超过2秒。这就是从“演示代码”走向“可用设备”的一个分水岭虽然代码量不大但思考方式已经从线性流程变成了事件驱动的状态管理。5. 常见问题与排查心得实测踩坑实录先把典型问题整理成一张速查表后面再展开聊问题现象可能原因解决办法模块指示灯不亮电源没接好测3.3V和GND是否正常读不到卡接线错误或卡片类型不对核对SPI四线确认卡是13.56MHz IC卡读卡距离特别短天线线圈损坏或附近有金属换模块天线区域悬空串口显示乱码波特率不一致统一为115200初始化报错RST引脚没接对检查GPIO22接线卡片只能读一次缺少收尾操作补上PICC_HaltA和PCD_StopCrypto1蜂鸣器不响有源无源搞混或极性接反换有源蜂鸣器模块核对正负极继电器不动作触发电平不对确认模块是高电平还是低电平触发5.1 读不到卡先查电和线RC522模块上电后模块上的指示灯通常会被点亮。如果灯不亮问题集中在电源上先用万用表量3.3V和GND有没有电压。灯亮了但读不到卡优先怀疑SPI接线。这里有个小技巧把卡片贴在模块天线正面位置要尽量对准线圈中心区域卡片平面和天线平面保持平行不要斜着贴更不要把卡片贴到模块背面因为天线只在正面PCB那一侧。5.2 初始化失败查复位引脚和SPI冲突MFRC522库输出类似“Communication with the MFRC522 might be the problem”的提示说明SPI通信没有建立。第一步检查RST引脚是否确实接到了GPIO22第二步看看GPIO5、18、19、23这几个引脚有没有被其他器件占掉。ESP32的引脚功能复用比较多如果你同时接了其他SPI设备先把它们断开再测RC522。5.3 卡号不稳定可能是天线附近有金属RC522的天线线圈对周围金属非常敏感。模块附近如果有金属外壳、大块铜片或者拧紧的螺丝都会明显缩短读取距离。实测下来把模块放在金属桌面上测试读卡距离能比悬空状态缩一半以上。如果打算把模块嵌入盒子内部外壳要在天线位置开孔或者把天线直接贴在非金属材质的外壳窗口内侧。5.4 供电的隐藏坑ESP32的3.3V稳压器输出能力有限当你同时带RC522、蜂鸣器、LED和继电器模块时总电流可能达到几百毫安。很多莫名其妙的“读卡偶发失败”其实是供电不稳导致的。我遇到过一种诡异现象不接继电器时读卡一切正常接上继电器后偶尔出现模块初始化失败查到最后就是3.3V被拉低。解决方式是给RFID和外设单独接一个3.3V稳压模块或者DC-DC降压模块ESP32和这些外设共地即可。5.5 别忽视串口监视器里的隐藏信息当你调用mfrc522.PICC_GetTypeName(piccType)打印卡类型时常见的输出是“MIFARE 1K”或“MIFARE 4K”这表示卡片的存储容量。如果输出“Unknown”说明模块识别了卡片UID但没有识别出卡型这通常出现在一些非常规品牌的兼容卡上不影响读UID但如果后面要往卡片里写入数据就要额外小心兼容性问题。6. 从练手到落地能刷卡的ESP32还能做什么6.1 门禁与考勤的本地版本把读卡成功事件通过OLED屏幕显示出来就能做成一个小型考勤机。给ESP32加一个实时时钟模块比如常见的DS3231每次刷卡时记录时间和卡号数据可以存到SD卡或者通过Wi-Fi上报到内网服务器。办公场景下这个方案的硬件成本可能不到成品考勤机的零头而且数据完全由自己掌握。6.2 智能储物柜与会员积分系统RFID的本质是一个“身份确认”的输入设备。把它接到任何需要“身份不同则行为不同”的场景中都有发挥空间。比如做一个智能储物柜用户刷卡绑定一个柜号储物柜的电磁锁自动弹开再次刷卡时取出物品系统记录存取时间。这个方案在健身房、餐厅、图书馆都有真实需求。而在会员积分场景里刷卡识别用户屏幕显示积分余额充值或消费后自动更新相比扫码方案更有“专属感”。6.3 手机也能当卡用手机NFC功能允许很多设备被模拟成可读的NFC标签。只要你的手机支持NFC把手机贴近RC522模块模块同样能读到一串卡号。不同手机的NFC模拟方式和安全策略差异很大有的手机在锁屏状态下也能被读取有的必须解锁并打开NFC开关。这相当于在项目里平白加了一个“手机钥匙”的彩蛋虽然不能替代所有门禁卡但作为扩展思路很值得一玩。6.4 更开放的创意场景回到项目本身当你理解了“刷卡”只是一次身份识别之后它就不再局限于门禁了。比如做一张“客户卡”小朋友把卡片放到读卡器上音箱播放一段睡前故事在工作室里给每台设备绑一张RFID钥匙扣刷卡开启对应设备电源在公司给每只宠物猫挂一个RFID钥匙扣就能自动记录“谁在门口”的打卡数据。ESP32的Wi-Fi能力让这些数据可以轻松上报到小程序或简单后端给个人项目加上一点“联网产品”的味道。做这个项目我最大的体会是初学的人很容易在一开始追求“大而全”卡片识别、继电器、OLED屏幕、服务器上报全部堆在一起结果反而连最基础的读卡流程都没跑通。我的建议始终是第一版只做读卡串口打印出卡号就算赢了第一局第二版再加入名单判断和声音反馈等到这些环节都稳定了再考虑门锁或者联网。一个项目能不能做成很多时候不是难在技术点而是难在控制复杂度。RFID刷卡这个入门项目最大的好处就是它足够简单简单到能让你完整地体验到从“听别人说”到“自己会”的整个过程。
做刷卡门禁这个想法很多人最初是在公司、学校或者小区门口被那“滴”的一声勾起来的。一张小卡片贴近读卡器门锁就自动弹开看起来总带点未来感。可当你真的把ESP32和RC522模块接好第一次在串口监视器里看到那串十六进制卡号稳定打印出来时那种“魔法被拆穿”的踏实感比拆一台新手机还要满足。这篇文章的目标只有一个零基础跑通RFID无线射频卡读取流程让ESP32获得“刷卡”能力。我会从方案选型、硬件接线讲起把RFID的工作原理掰开说清楚再带你把Arduino IDE里从环境配置到代码烧录全部实现。全程不需要任何电子学基础你需要的就是一块ESP32开发板、一个RC522读卡模块套装一般附带卡片和钥匙扣和一台能连USB的电脑。文末还整理了我实测踩过的坑以及从“能读卡”到“做成门禁雏形”的扩展思路。适合谁看一种是手里有ESP32、却一直不知道能做什么小项目的新手另一种是对门禁、考勤这类应用感兴趣想从硬件侧搞懂背后原理的人。这篇不会只丢给你一份代码而是让你明白每一步为什么要这么接、为什么要这么写。1. 为什么是ESP32加RC522我替你做过的方案权衡1.1 主控选型ESP32赢在“什么都带”做刷卡项目主控的选择其实不止一种。常见的有Arduino Uno、ESP8266、ESP32再往上有树莓派Pico等。如果你只是验证“读一张卡”它们都能做到。但ESP32赢在三件事自带Wi-Fi和蓝牙意味着刷卡记录可以联网上传或者用手机控制硬件SPI接口好用接RC522模块不用自己模拟时序开发环境成熟Arduino和MicroPython都能跑资料多到几乎踩不到没人走过的路。另一个现实因素是价格。ESP32开发板现在的价格已经压得很低在主流电商平台基本和Arduino入门板持平配置却高出一截双核240MHz、520KB SRAM、4MB Flash这个规格在物联网领域完全够用。零基础直接选ESP32等于以后做任何联网项目都不用再换主控。我在实际项目里的体会是如果未来想给这个刷卡器加上“远程开门”“微信通知”这类功能ESP32的Wi-Fi模块能把扩展成本降到零。入门阶段就把主控选对后面扩展会舒服很多。1.2 读卡方案为什么是RC522而不是PN532市场上最常见的HF高频读卡模块是RC522和PN532。RC522对应的芯片是NXP的MFRC522工作在13.56MHz支持读取MIFARE系列IC卡也就是绝大多数门禁卡、校园卡用的那种类型。它最大的优点是便宜模块价格在电商平台大概只有一顿早饭的钱而且读取距离虽然只有几厘米但门禁刷卡本来就是贴近式操作不存在“识别距离焦虑”。PN532的优势是同时支持NFC卡模拟、读写NTAG系列标签还能跟手机做点对点通信。但它的模块价格大概是RC522的数倍而且驱动复杂度明显更高。对零基础来说PN532的学习曲线偏陡仅仅是“让ESP32能刷卡”这个目标RC522是成本最低、资料最全的选择。这个选择背后是一个很朴素的原则先跑通再考虑扩展。RC522能把“刷卡”这件事用最小的代价做扎实等你理解了RFID这套数据交换方式以后换更高级的模块也是顺理成章的事。1.3 整体框架读卡、识别、反馈三件事整个项目可以拆成三个层次最底层是RFID模块与卡片的物理射频通信中间是ESP32通过SPI总线从RC522模块读取卡号最上层是业务逻辑判断卡号是否在允许名单里以及用蜂鸣器、LED、继电器做出对应反馈。这个分层意识在新手阶段特别重要。很多初学者一上来就想把“门禁系统”整个做出来结果卡在接线或者一个库版本问题上就放弃了。正确做法是先把“读卡号”跑通再把“名单判断”加上最后才轮到“开门动作”。每一层互相独立调试任何一层都不需要推翻前面所有工作。1.4 安全提醒RFID不是保险柜必须提前说一句13.56MHz的MIFARE Classic卡片其加密算法是上世纪九十年代的产物存在公开的安全漏洞卡片UID可以被复制。如果只是学习练手或者做一个宿舍里的模拟门禁问题不大但如果是严肃的生产环境门禁需要选用带更强加密逻辑的NFC卡片或者采用手机NFC加服务器验证的流程。这个项目虽然是零基础入门但安全意识从一开始就建立起来比以后返工划算得多。2. 硬件原理与接线实操先搞明白“刷卡”是怎么发生的2.1 RFID原理的大白话版本RFID全称Radio Frequency Identification翻译过来是射频识别。工作过程很像一次“无线点名”读卡器也就是RC522模块不断向外发射13.56MHz的射频载波信号。卡片靠近时内部的天线线圈通过电磁感应获得能量这和无源线圈给芯片供电的原理一样。卡片被“唤醒”后芯片通过改变天线负载的方式把自己的ID数据调制到射频信号上反射回读卡器。于是读卡器就拿到了卡片的UID。你可以把卡片想象成一个没有电池的感应门牌读卡器用类似“无线充电”的方式给它供一下电它就把写在自己芯片里的身份信息报出来。整个读卡过程通常只有几毫秒人根本感觉不到延迟。2.2 元件清单与购买建议这里列一个最小清单ESP32开发板任意带USB串口芯片的款式都可以用RC522 RFID读卡模块很多卖家会搭配两张IC白卡和一个钥匙扣卡杜邦线若干母对母或者公对母都行也可以把模块直接插在面包板上可选有源蜂鸣器、LED、继电器模块、12V电子锁用于组装完整门禁购买RC522时最容易踩的坑是天线缩水。正品MFRC522模块的天线线圈通常呈圆形或矩形走线规整拿在手里有明显厚度。有些仿制模块天线感应面积小读卡距离会明显缩短。另一个注意点是确认附赠的卡是13.56MHz的高频IC卡如果买错成低频的125kHz ID卡RC522完全不读。2.3 电路连接实操一张表搞定RC522模块是3.3V逻辑的ESP32的IO口也是3.3V电平所以两者可以直接互连不需要像Arduino Uno那样再搞电平转换。使用ESP32默认的VSPI引脚接线如下RC522引脚ESP32引脚说明SDA / CSGPIO5片选信号选中RC522SCKGPIO18SPI时钟线MOSIGPIO23主设备发送数据MISOGPIO19从设备回传数据RSTGPIO22硬件复位IRQ不接本教程用轮询方式用不到中断3.3V3.3V模块供电GNDGND共地接线要点是“共地”也就是ESP32的GND必须接RC522的GND。数字电路里信号的高低电平都是相对GND而言的共地接错其他线接得再对也是白搭。我建议接好线之后用万用表的蜂鸣档快速测一遍引脚之间的通断尤其排查有没有把某根信号线短接到3.3V。2.4 关于SPI协议的一点直觉SPI通信协议你可以理解成一个很规矩的“布告栏”MOSI线是主的传令员MISO线是从的应答员SCK是大家跺脚的节拍器CS线决定“我现在在跟谁说话”。SPI总线可以同时挂多个从设备但同一时刻只能有一个从设备被CS拉低选中。RC522模块的数据交换就是通过这套机制完成的。好在Arduino生态里有现成的SPI库我们不需要手动操作底层寄存器。但在排查问题时知道SCK是时钟线、MOSI和MISO是数据线、CS是片选线能让你少走很多弯路。3. 开发环境配置与代码实现把“刷卡能力”装进ESP323.1 Arduino IDE配置ESP32开发环境第一步安装Arduino IDE选2.x版本即可界面比老版舒服很多。打开“文件 → 首选项 → 附加开发板管理器网址”填入ESP32官方维护的开发板索引地址。然后在“工具 → 开发板 → 开发板管理器”里搜索esp32并安装。这一步会下载比较多的文件如果网络状况不太好的话可能要等一会儿。装完之后“开发板”菜单里会出现ESP32系列选择“ESP32 Dev Module”即可。端口选择识别到的USB串口Windows下是COM口macOS或Linux下通常是类似/dev/cu.usbserial-XXX的名字。如果端口列表里什么都没有八成是USB转串口芯片的驱动没装好CP2102或CH340的驱动需要单独安装。3.2 安装MFRC522库并解决引脚定义问题在“库管理器”里搜索“MFRC522”安装最常被引用的那一个版本即可。这个库是目前最通用的资料量大。唯一的问题是它最早为Arduino Uno设计默认引脚定义是SS接数字IO10、RST接数字IO9所以在ESP32上必须在代码开头用宏定义覆盖掉。3.3 主程序读取UID并打印到串口直接上代码。这个程序干的事情很单纯初始化SPI和RC522模块然后不停轮询一旦检测到卡片靠近读取UID以十六进制字符串形式打印到串口。#include SPI.h #include MFRC522.h #define RST_PIN 22 #define SS_PIN 5 MFRC522 mfrc522(SS_PIN, RST_PIN); void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); Serial.println(F(RFID Reader Ready, please scan...)); } void loop() { if (!mfrc522.PICC_IsNewCardPresent()) { return; } if (!mfrc522.PICC_ReadCardSerial()) { return; } Serial.print(F(UID: )); String content ; for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { Serial.print(F( 0)); content 0; } else { Serial.print(F( )); } content String(mfrc522.uid.uidByte[i], HEX); Serial.print(mfrc522.uid.uidByte[i], HEX); } Serial.println(); content.toUpperCase(); Serial.print(F(Card Number: )); Serial.println(content); mfrc522.PICC_HaltA(); mfrc522.PCD_StopCrypto1(); }这里有几个细节需要解释。首先是十六进制格式化UID从模块里读出来是一个byte数组每个字节用大写的HEX打印。如果某个字节小于0x10也就是十进制的16它转换成十六进制只有一位比如7不补零的话打印出来是“7”而我要的是“07”。补前导零之后卡号格式统一为8位十六进制方便后面做名单比对。其次是代码里最关键的两行收尾操作PICC_HaltA()和PCD_StopCrypto1()。它们的作用是让卡片进入HALT状态并停止加密通信这样下一张卡才能正常进入识别流程。如果少了这两行卡片靠近一次之后后续再贴上去就经常没反应了。编译烧录比较简单在工具菜单里选好开发板“ESP32 Dev Module”和对应端口然后点击上传。烧录完成后打开串口监视器波特率设置为115200把卡片贴近模块天线就能看到类似“UID: 3A 1B 4C 2D”的输出。注意串口监视器的波特率必须和程序里Serial.begin(115200)保持一致不一致就会出现一段段乱码。3.4 添加“认卡不认人”的名单校验逻辑读卡号只是第一步真正让项目有实际意义的是名单校验。把已知的授权卡号写进一个字符串数组每次刷卡后循环比对即可。我提供一个示例逻辑串口打印“允许通过”或“拒绝”同时用板载LED做出区分。#include SPI.h #include MFRC522.h #define RST_PIN 22 #define SS_PIN 5 MFRC522 mfrc522(SS_PIN, RST_PIN); String authorizedCards[] {A1B2C3D4, 11AA22BB}; int authorizedCount 2; bool checkUID(String uid) { for (int i 0; i authorizedCount; i) { if (uid authorizedCards[i]) { return true; } } return false; } void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); Serial.println(F(Authorized card check ready)); } void loop() { if (!mfrc522.PICC_IsNewCardPresent()) { return; } if (!mfrc522.PICC_ReadCardSerial()) { return; } String uid ; for (byte i 0; i mfrc522.uid.size; i) { if (mfrc522.uid.uidByte[i] 0x10) { uid 0; } uid String(mfrc522.uid.uidByte[i], HEX); } uid.toUpperCase(); if (checkUID(uid)) { Serial.println(F(ALLOWED)); } else { Serial.println(F(DENIED)); } mfrc522.PICC_HaltA(); mfrc522.PCD_StopCrypto1(); }名单判断的原理非常简单就是把字符串逐一比对。但这里有一个经验之谈授权卡号不要硬编码在程序里除非你只是做演示用。因为每烧录一次程序就要重新编译哪怕只是加一张卡。更合理的做法是把这个名单放到EEPROM或SD卡里或者通过Wi-Fi从服务器拉取。不过那就是后话了零基础先写死能跑通最重要。4. 让刷卡真正“能用”反馈、联动与硬件扩展4.1 给刷卡一个明确的“滴”门禁刷卡如果没有声音反馈会非常别扭。那种“滴”的一声其实是人判断系统正常工作的信任标志。给ESP32接一个有源蜂鸣器正极接GPIO26负极接GND程序里在通过名单校验时让引脚输出高电平延时200毫秒再拉低就能听到一声干脆的“滴”。这里要注意有源蜂鸣器自带震荡源给直流高电平就会响。无源蜂鸣器需要给PWM方波才发声用起来麻烦一些。新手建议直接买有源蜂鸣器模块省事。另外有些蜂鸣器模块是低电平有效也就是输入低电平时响要看模块丝印判断接反极性就怎么都听不到声音。4.2 LED指示灯与错误提示LED正极通过220欧姆电阻接GPIO27负极接GND。配合蜂鸣器可以做一个简单的状态提示组合刷卡通过时“滴一声加绿灯亮两秒”刷卡被拒绝时“滴滴滴三声加红灯闪烁三次”。蜂鸣器和LED的组合看似简单但它传递的信号很明确用户刷卡之后系统必须在几百毫秒内给出反馈否则人的体验就会变得“心里没底”。这里建议不要用delay()写死全部流程因为delay()会阻塞整个程序刷卡后的连续几秒内模块无法响应下一张卡。更好的方案是用millis()做非阻塞延时不过零基础阶段用delay()理解逻辑没有大问题等后续要加OLED屏幕显示时再改造。4.3 继电器控制电子锁新手先模拟进阶再上强电把继电器模块的输入信号引脚接到GPIO14COM端接12V电子锁的电源正极NO端接锁的电源负极就可以让ESP32用3.3V逻辑控制12V电路的通断。但说实话这个环节我不建议新手一开始就接真实锁具。原因有两条一是电磁锁或电插锁的电流不小ESP32的3.3V稳压器带不动必须用外部12V电源独立供电二是继电器控制的是比逻辑电路高得多的电压接线一旦出错轻则烧模块重则出安全事故。最稳妥的入门路线是先用一个LED模拟“开门”——刷卡通过时LED亮两秒然后熄灭代表门锁打开又自动落锁。等代码逻辑彻底稳定了再考虑上真实继电器的连接。4.4 从延时到状态机实际门禁里不能只想“判断卡号是否在白名单”这一件事。还要考虑多次刷卡重复触发、开锁期间不重复动作、刷卡失败后的冷却时间等问题。这些在软件上就是最简单的状态机空闲状态、开锁状态、冷落状态。比如开锁成功后设置一个2秒的锁定时长。在这2秒内无论刷多少次卡都不再触发。用一个变量记录上次开锁时间每次刷卡时判断当前时间与上次开锁时间的差是否超过2秒。这就是从“演示代码”走向“可用设备”的一个分水岭虽然代码量不大但思考方式已经从线性流程变成了事件驱动的状态管理。5. 常见问题与排查心得实测踩坑实录先把典型问题整理成一张速查表后面再展开聊问题现象可能原因解决办法模块指示灯不亮电源没接好测3.3V和GND是否正常读不到卡接线错误或卡片类型不对核对SPI四线确认卡是13.56MHz IC卡读卡距离特别短天线线圈损坏或附近有金属换模块天线区域悬空串口显示乱码波特率不一致统一为115200初始化报错RST引脚没接对检查GPIO22接线卡片只能读一次缺少收尾操作补上PICC_HaltA和PCD_StopCrypto1蜂鸣器不响有源无源搞混或极性接反换有源蜂鸣器模块核对正负极继电器不动作触发电平不对确认模块是高电平还是低电平触发5.1 读不到卡先查电和线RC522模块上电后模块上的指示灯通常会被点亮。如果灯不亮问题集中在电源上先用万用表量3.3V和GND有没有电压。灯亮了但读不到卡优先怀疑SPI接线。这里有个小技巧把卡片贴在模块天线正面位置要尽量对准线圈中心区域卡片平面和天线平面保持平行不要斜着贴更不要把卡片贴到模块背面因为天线只在正面PCB那一侧。5.2 初始化失败查复位引脚和SPI冲突MFRC522库输出类似“Communication with the MFRC522 might be the problem”的提示说明SPI通信没有建立。第一步检查RST引脚是否确实接到了GPIO22第二步看看GPIO5、18、19、23这几个引脚有没有被其他器件占掉。ESP32的引脚功能复用比较多如果你同时接了其他SPI设备先把它们断开再测RC522。5.3 卡号不稳定可能是天线附近有金属RC522的天线线圈对周围金属非常敏感。模块附近如果有金属外壳、大块铜片或者拧紧的螺丝都会明显缩短读取距离。实测下来把模块放在金属桌面上测试读卡距离能比悬空状态缩一半以上。如果打算把模块嵌入盒子内部外壳要在天线位置开孔或者把天线直接贴在非金属材质的外壳窗口内侧。5.4 供电的隐藏坑ESP32的3.3V稳压器输出能力有限当你同时带RC522、蜂鸣器、LED和继电器模块时总电流可能达到几百毫安。很多莫名其妙的“读卡偶发失败”其实是供电不稳导致的。我遇到过一种诡异现象不接继电器时读卡一切正常接上继电器后偶尔出现模块初始化失败查到最后就是3.3V被拉低。解决方式是给RFID和外设单独接一个3.3V稳压模块或者DC-DC降压模块ESP32和这些外设共地即可。5.5 别忽视串口监视器里的隐藏信息当你调用mfrc522.PICC_GetTypeName(piccType)打印卡类型时常见的输出是“MIFARE 1K”或“MIFARE 4K”这表示卡片的存储容量。如果输出“Unknown”说明模块识别了卡片UID但没有识别出卡型这通常出现在一些非常规品牌的兼容卡上不影响读UID但如果后面要往卡片里写入数据就要额外小心兼容性问题。6. 从练手到落地能刷卡的ESP32还能做什么6.1 门禁与考勤的本地版本把读卡成功事件通过OLED屏幕显示出来就能做成一个小型考勤机。给ESP32加一个实时时钟模块比如常见的DS3231每次刷卡时记录时间和卡号数据可以存到SD卡或者通过Wi-Fi上报到内网服务器。办公场景下这个方案的硬件成本可能不到成品考勤机的零头而且数据完全由自己掌握。6.2 智能储物柜与会员积分系统RFID的本质是一个“身份确认”的输入设备。把它接到任何需要“身份不同则行为不同”的场景中都有发挥空间。比如做一个智能储物柜用户刷卡绑定一个柜号储物柜的电磁锁自动弹开再次刷卡时取出物品系统记录存取时间。这个方案在健身房、餐厅、图书馆都有真实需求。而在会员积分场景里刷卡识别用户屏幕显示积分余额充值或消费后自动更新相比扫码方案更有“专属感”。6.3 手机也能当卡用手机NFC功能允许很多设备被模拟成可读的NFC标签。只要你的手机支持NFC把手机贴近RC522模块模块同样能读到一串卡号。不同手机的NFC模拟方式和安全策略差异很大有的手机在锁屏状态下也能被读取有的必须解锁并打开NFC开关。这相当于在项目里平白加了一个“手机钥匙”的彩蛋虽然不能替代所有门禁卡但作为扩展思路很值得一玩。6.4 更开放的创意场景回到项目本身当你理解了“刷卡”只是一次身份识别之后它就不再局限于门禁了。比如做一张“客户卡”小朋友把卡片放到读卡器上音箱播放一段睡前故事在工作室里给每台设备绑一张RFID钥匙扣刷卡开启对应设备电源在公司给每只宠物猫挂一个RFID钥匙扣就能自动记录“谁在门口”的打卡数据。ESP32的Wi-Fi能力让这些数据可以轻松上报到小程序或简单后端给个人项目加上一点“联网产品”的味道。做这个项目我最大的体会是初学的人很容易在一开始追求“大而全”卡片识别、继电器、OLED屏幕、服务器上报全部堆在一起结果反而连最基础的读卡流程都没跑通。我的建议始终是第一版只做读卡串口打印出卡号就算赢了第一局第二版再加入名单判断和声音反馈等到这些环节都稳定了再考虑门锁或者联网。一个项目能不能做成很多时候不是难在技术点而是难在控制复杂度。RFID刷卡这个入门项目最大的好处就是它足够简单简单到能让你完整地体验到从“听别人说”到“自己会”的整个过程。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
