1. 为什么我要在ESP32上折腾RFID刷卡
第一次接触RFID是在公司楼下的门禁系统上。那会儿我就在想，这玩意儿到底是怎么做到隔空识别身份的？后来自己开始玩ESP32，发现给它加一个RFID读卡模块，成本不到二十块钱，就能让一块十几块钱的开发板拥有“刷卡”能力。这个诱惑对我来说太大了。
这篇文章要聊的，就是怎么从零开始，用ESP32搭配常见的RFID模块，实现读卡、写卡、串口输出卡号、控制继电器等一系列操作。不管你是刚拿到ESP32开发板的新手，还是已经玩过GPIO和串口通信的老玩家，只要对RFID这个方向感兴趣，都能从下面这些内容里找到可以直接上手的东西。
我踩过的坑包括：SPI接线接反导致读不到卡、卡片类型选错导致写卡失败、天线距离没调好导致识别率极低。这些我都会在对应的章节里详细展开，让你少走弯路。
核心关键词先摆出来：ESP32、RFID、无线射频卡、刷卡、RC522、SPI通信、读卡器、门禁模拟。这些词会贯穿全文，你如果是在搜相关内容找到这里的，说明方向对了。
2. RFID到底是什么：从原理到选型
2.1 用生活化类比理解RFID的工作方式
RFID的全称是Radio Frequency Identification，翻译过来就是无线射频识别。你可以把它想象成两个人用手电筒打信号：读卡器这边不停地发问“有人吗？”，卡片那边如果听到了，就用自己的方式回一句“我在，我的编号是XXX”。整个过程不需要接触，也不需要卡片自己有电池。
这里的关键在于，无源卡片本身没有电源，它靠的是读卡器发出的电磁场来获取能量。读卡器天线周围会形成一个交变磁场，卡片靠近这个磁场时，内部的线圈会感应出电流，给芯片供电，芯片再把存储的卡号通过调制反射的方式发回去。这个过程非常快，通常几十毫秒就完成了。
有源卡片则自带电池，通信距离更远，但成本高、体积大，日常门禁和公交卡基本都是无源的。我们这次要玩的RC522模块，配套的卡片就是典型的无源卡，工作频率是13.56MHz，属于高频RFID。
2.2 常见RFID模块对比与RC522的定位
市面上能跟ESP32搭配的RFID模块不少，我整理了一个对比表，方便你根据自己手头的需求和预算做选择。
| 模块型号 | 工作频率 | 通信接口 | 读卡距离 | 价格区间 | 适用场景 |
|---|---|---|---|---|---|
| RC522 | 13.56MHz | SPI | 0-3cm | 5-15元 | 门禁模拟、读卡实验 |
| PN532 | 13.56MHz | SPI/I2C/UART | 0-5cm | 30-60元 | 需要NFC功能的项目 |
| RDM6300 | 125kHz | UART | 0-5cm | 15-25元 | 低频卡读取 |
| MFRC522（同RC522） | 13.56MHz | SPI | 0-3cm | 5-15元 | 入门首选 |
RC522之所以成为入门首选，原因很简单：便宜、资料多、SPI接口跟ESP32天然匹配。它的核心芯片是NXP的MFRC522，支持ISO 14443A协议，能读写Mifare Classic 1K卡、Mifare Ultralight卡等常见卡片。你手里的门禁卡、公交卡、电梯卡，大概率就是这类。
注意：RC522只支持13.56MHz的高频卡，如果你手里是125kHz的低频卡（比如老式ID卡），RC522是读不了的，需要换RDM6300这类模块。
2.3 为什么选SPI而不是I2C或UART
RC522支持SPI、I2C、UART三种接口，但市面上卖得最多的还是SPI版本。原因有几个：SPI速度最快，ESP32的硬件SPI控制器用起来很顺手，而且Arduino社区里RC522的SPI库最成熟。
I2C版本虽然接线少，但RC522的I2C地址固定，总线上只能挂一个，扩展性差。UART版本占用串口资源，调试时容易和日志输出冲突。所以除非你有特殊需求，否则直接选SPI版本就行。
ESP32的SPI引脚是可以重映射的，这意味着你不需要死记硬背某个固定引脚，可以在代码里灵活指定。这一点比Arduino UNO方便很多，UNO的SPI引脚是固定的，接错了就得改硬件。
3. 硬件准备与接线：别让一根线毁掉整个项目
3.1 物料清单与采购建议
先列一下我这次用到的全部物料，你可以照着买，也可以根据手头现有的东西调整。
- ESP32开发板一块（我用的是ESP32 DevKit V1，三十块钱左右）
- RC522 RFID模块一个（带配套卡片和钥匙扣）
- 杜邦线若干（母对母或公对母，看你的开发板接口）
- 面包板一块（可选，但强烈建议用，接线更稳）
- 继电器模块一个（如果想做门禁控制）
- USB数据线一根（注意要是数据线，不是纯充电线）
采购的时候有个小技巧：RC522模块尽量选带金属屏蔽罩的版本，抗干扰能力更好，读卡距离也更稳定。我买过不带屏蔽罩的便宜版本，放在电脑旁边读卡距离直接缩水一半。
卡片方面，RC522套装里通常会带一张白卡和一个蓝色钥匙扣。白卡一般是Mifare Classic 1K，钥匙扣是Mifare Ultralight。两种卡都能读，但写卡时要注意容量不同。
3.2 SPI引脚分配与接线表
ESP32的SPI引脚可以自定义，但为了代码简洁，我建议用默认的VSPI引脚。下面是我实际使用的接线方案，经过多次验证，稳定可靠。
| RC522引脚 | ESP32引脚 | 说明 |
|---|---|---|
| SDA（SS） | GPIO 5 | 片选信号 |
| SCK | GPIO 18 | 时钟信号 |
| MOSI | GPIO 23 | 主出从入 |
| MISO | GPIO 19 | 主入从出 |
| IRQ | 不接 | 中断引脚，本次不用 |
| GND | GND | 共地 |
| RST | GPIO 22 | 复位引脚 |
| 3.3V | 3.3V | 供电 |
这里要特别强调：RC522的工作电压是3.3V，绝对不能接5V。我亲眼见过有人接5V之后模块直接冒烟。ESP32的GPIO输出也是3.3V电平，跟RC522完美匹配，不需要电平转换。
提示：如果你用的是ESP32-S3或其他型号，SPI引脚可能不同，但都可以在代码里重新定义。关键是SDA、SCK、MOSI、MISO这四根线要对应上。
3.3 接线检查清单与常见错误
接完线之后，别急着上电。先对照下面这个清单检查一遍：
- 3.3V和GND有没有接反？接反必烧模块。
- SDA是否接到了GPIO 5？如果接到别的引脚，代码里要改。
- SCK、MOSI、MISO是否一一对应？这三根线接错任何一根，都读不到卡。
- RST是否接到了GPIO 22？不接的话模块可能一直处于复位状态。
- 杜邦线是否插紧？面包板上的线松动是读卡失败的头号原因。
我遇到过最诡异的一次问题是：模块能通电，但就是读不到卡。查了半天发现是MISO线内部断了，万用表测通断才发现。所以如果你确认代码没问题但就是读不到，拿万用表量一下每根线的通断，别嫌麻烦。
4. 软件开发环境搭建与库的选择
4.1 Arduino IDE配置ESP32开发环境
如果你还没装Arduino IDE，先去官网下载安装。装好之后，打开“文件”->“首选项”，在“附加开发板管理器网址”里填入ESP32的板管理地址。然后打开“工具”->“开发板”->“开发板管理器”，搜索“esp32”，安装最新版本。
安装过程可能需要几分钟，取决于网络速度。装完之后，在“工具”->“开发板”里选择“ESP32 Dev Module”。端口选择你实际连接的COM口。
注意：有些ESP32开发板需要按住BOOT键才能上传代码，上传完成后按一下EN键重启。如果你上传失败，试试这个操作。
4.2 RC522库的安装与版本选择
Arduino社区里RC522的库有好几个，我推荐用MFRC522这个库，作者是Github上的miguelbalboa。在Arduino IDE的“库管理器”里搜索“MFRC522”，安装最新版本即可。
这个库的好处是封装得很完整，读卡、写卡、扇区操作都有现成的函数。而且它支持SPI接口的引脚重映射，跟ESP32配合得很好。
安装完之后，你可以在“文件”->“示例”->“MFRC522”里找到官方示例。我建议先跑一遍“DumpInfo”示例，确认硬件和库都正常工作，再开始写自己的代码。
4.3 第一个测试程序：读取卡号并打印
下面是我写的第一个测试程序，功能很简单：初始化RC522，循环检测是否有卡片靠近，如果有就打印卡号到串口。
#include <SPI.h> #include <MFRC522.h> #define SS_PIN 5 #define RST_PIN 22 MFRC522 rfid(SS_PIN, RST_PIN); void setup() { Serial.begin(115200); SPI.begin(18, 19, 23, 5); // SCK, MISO, MOSI, SS rfid.PCD_Init(); Serial.println("RFID reader ready"); } void loop() { if (!rfid.PICC_IsNewCardPresent()) { return; } if (!rfid.PICC_ReadCardSerial()) { return; } Serial.print("Card UID: "); for (byte i = 0; i < rfid.uid.size; i++) { Serial.print(rfid.uid.uidByte[i] < 0x10 ? " 0" : " "); Serial.print(rfid.uid.uidByte[i], HEX); } Serial.println(); rfid.PICC_HaltA(); rfid.PCD_StopCrypto1(); }这段代码里，SPI.begin(18, 19, 23, 5)这一行是关键，它把ESP32的SPI引脚重新映射到了我们接线的位置。如果你用的是其他引脚，改这一行就行。
上传代码后，打开串口监视器，波特率设为115200。把卡片靠近RC522天线，你应该能看到类似“Card UID: 0x12 0x34 0x56 0x78”的输出。如果没反应，先检查接线，再检查卡片类型是否匹配。
5. 核心功能实现：从读卡到写卡再到控制
5.1 读取卡号并做本地比对
读卡号只是第一步，真正有用的是把读到的卡号和预设的白名单做比对，决定是否放行。下面这段代码演示了如何实现一个简单的门禁逻辑。
byte authorizedUID[4] = {0x12, 0x34, 0x56, 0x78}; bool isAuthorized(byte *uid, byte size) { if (size != 4) return false; for (byte i = 0; i < 4; i++) { if (uid[i] != authorizedUID[i]) return false; } return true; }在loop函数里，读到卡号后调用isAuthorized，如果返回true就点亮板载LED或触发继电器，否则串口打印“Access denied”。
这里有个细节：不同卡片的UID长度可能不同。Mifare Classic 1K通常是4字节，Ultralight可能是7字节。所以比对之前要先判断长度，否则可能误判。
5.2 向卡片写入数据
RC522不仅能读卡，还能写卡。Mifare Classic 1K卡有16个扇区，每个扇区4个块，每块16字节。第0扇区的第0块是厂商信息，只读。其他块可以读写，但要注意每个扇区的第3块是密钥块，用来存储访问密钥。
写卡之前，你需要先用密钥认证。默认密钥通常是FF FF FF FF FF FF。下面是一个写数据的示例：
byte key[6] = {0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF}; byte data[16] = "Hello RFID!"; if (rfid.PCD_Authenticate(MFRC522::PICC_CMD_MF_AUTH_KEY_A, 4, &key, &(rfid.uid)) == MFRC522::STATUS_OK) { rfid.MIFARE_Write(4, data, 16); }这段代码向第4块写入了“Hello RFID!”这个字符串。写完之后你可以用读卡程序验证一下。
注意：写卡操作有次数限制，Mifare Classic卡的擦写寿命大约是10万次。如果你要频繁写数据，建议用带FRAM或EEPROM的卡片，或者把数据存在ESP32的Flash里，卡片只存一个ID。
5.3 用刷卡控制继电器模拟门禁
把读卡和继电器结合起来，就是一个完整的门禁模拟系统。继电器模块的IN引脚接到ESP32的某个GPIO上，比如GPIO 13。当授权卡靠近时，拉高GPIO 13，继电器吸合，电磁锁通电打开。
#define RELAY_PIN 13 void setup() { pinMode(RELAY_PIN, OUTPUT); digitalWrite(RELAY_PIN, LOW); // ... 其他初始化 } void loop() { // ... 读卡逻辑 if (isAuthorized(rfid.uid.uidByte, rfid.uid.size)) { digitalWrite(RELAY_PIN, HIGH); delay(3000); digitalWrite(RELAY_PIN, LOW); } }这个delay(3000)表示门锁打开3秒后自动关闭。实际项目中你可能需要用millis()来做非阻塞延时，避免在延时期间无法响应其他卡片。
5.4 多卡管理与EEPROM存储
如果你需要管理多张卡，可以把授权卡号存在ESP32的EEPROM里。ESP32的EEPROM模拟容量是512字节，足够存几十个卡号。每次读到卡时，遍历EEPROM里的卡号列表做比对。
#include <EEPROM.h> void saveUID(byte *uid, int slot) { int addr = slot * 4; for (int i = 0; i < 4; i++) { EEPROM.write(addr + i, uid[i]); } EEPROM.commit(); }这样你就不需要每次改代码重新上传了，可以通过串口命令动态添加或删除授权卡。
6. 常见问题排查与实操避坑指南
6.1 读不到卡的排查流程
读不到卡是最常见的问题，我整理了一个排查表，按顺序检查，基本能覆盖90%的情况。
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 串口无任何输出 | 供电问题 | 检查3.3V和GND，用万用表量电压 |
| 串口有输出但无卡号 | SPI通信失败 | 检查SCK、MOSI、MISO接线 |
| 偶尔读到偶尔读不到 | 天线干扰或距离太远 | 卡片紧贴天线，远离金属和电源 |
| 读到卡号但全是0 | 卡片类型不匹配 | 确认卡片是13.56MHz高频卡 |
| 上传代码失败 | 开发板未进入下载模式 | 按住BOOT键再点上传 |
我遇到最多的情况是杜邦线接触不良。尤其是面包板上用的那种细线，插几次就松了。后来我改用杜邦线直接插开发板，问题少了很多。
6.2 天线调谐与读卡距离优化
RC522的读卡距离跟天线匹配电路有关。模块上通常有两个可调电容，但出厂时已经调好了，不建议自己动。如果你觉得读卡距离太短，可以尝试以下方法：
- 把模块远离金属物体，金属会吸收电磁场。
- 把卡片正对天线中心，边缘位置场强较弱。
- 降低SPI时钟频率，有时候高速通信反而影响稳定性。
- 给模块单独供电，不要跟大功率设备共用电源。
我实测下来，标准RC522模块读Mifare Classic卡的距离大约是2-3厘米。如果超过5厘米还能读，那可能是模块质量特别好或者卡片特别灵敏。
6.3 多卡片冲突与防冲突机制
当多张卡片同时靠近天线时，RC522会自动执行防冲突算法，只选一张卡进行通信。但如果你发现读到的卡号跳来跳去，可能是防冲突没处理好。
MFRC522库里的PICC_IsNewCardPresent和PICC_ReadCardSerial已经处理了防冲突。你只需要在每次读完卡后调用PICC_HaltA让卡片进入休眠状态，避免重复读取同一张卡。
提示：如果你要做排队刷卡场景，建议在读完一张卡后加一个短延时，等卡片移开后再检测下一张。
6.4 电源噪声与稳定性问题
ESP32和RC522共用USB供电时，如果电脑USB口质量不好，可能会出现读卡不稳定的情况。我试过用充电宝供电，反而比某些电脑USB口更稳定。
如果你要做长时间运行的项目，建议给ESP32单独供电，或者加一个100uF的电解电容在RC522的3.3V和GND之间，滤除电源纹波。这个电容我加了之后，连续刷几百次卡都没出现过掉线。
7. 进阶玩法：从门禁到更多场景
7.1 结合WiFi上传刷卡记录
ESP32自带WiFi，这是它比Arduino UNO强的地方。你可以在刷卡时把卡号和 timestamp 通过HTTP POST上传到服务器，实现考勤记录或访问日志。
#include <WiFi.h> #include <HTTPClient.h> void uploadRecord(String uid) { HTTPClient http; http.begin("http://your-server.com/api/record"); http.addHeader("Content-Type", "application/json"); String payload = "{\"uid\":\"" + uid + "\"}"; http.POST(payload); http.end(); }这样你就能在后台看到谁在什么时候刷了卡。如果配合一个简单的Web页面，就是一个完整的考勤系统。
7.2 用手机NFC模拟卡片
有些手机的NFC功能可以模拟Mifare Classic卡。你可以用手机读取卡片信息，然后模拟一张卡去刷RC522。不过要注意，手机NFC模拟的卡UID可能跟原卡不同，需要重新授权。
这个玩法适合做演示，实际门禁场景还是用实体卡更靠谱。
7.3 低功耗读卡模式
如果你用电池供电，可以让ESP32在空闲时进入深度睡眠，RC522也断电。当有卡片靠近时，通过外部中断唤醒ESP32。不过RC522本身没有低功耗唤醒功能，需要额外的电路设计，比如用霍尔传感器检测磁场变化。
这个方向我还在折腾，目前还没找到特别完美的方案。如果你有经验，欢迎交流。
8. 我个人在实际操作中的几点体会
从第一次点亮RC522到现在，我大概做了七八个跟RFID相关的项目。最大的感受是：硬件项目的坑，八成都在接线上。代码可以慢慢调，但线接错了，调多久都没用。
另一个体会是，不要一上来就追求复杂功能。先把读卡跑通，再加写卡，再加继电器，再加WiFi。每一步都验证通过再往下走，这样出问题的时候你知道是哪一步引入的。
最后分享一个小技巧：如果你手头没有RC522，但想先试试代码逻辑，可以用ESP32的串口模拟输入卡号，把读卡部分抽象成一个函数，这样不接硬件也能调试上层逻辑。等硬件到了，只需要替换读卡函数就行。
这个项目后续还可以扩展成：带LCD显示屏的读卡终端、支持二维码和RFID双模识别的门禁、通过MQTT接入智能家居系统。方向很多，关键是先把基础打牢。
