ESP32 实战教程：用 RC522 做一套可管理的刷卡门禁原型

这是一篇按实际学习过程整理的教程。建议先准备对应硬件，再逐段运行代码；不同开发板、库版本和外设批次可能存在差异，最终以串口日志和实测波形为准。

一、这次要做什么

RC522 很适合学习 RFID 读卡和 SPI 通信，但一个 UID 白名单只能算门禁原型，不能等同于高安全门锁。教程重点是稳定读取、格式化 UID、抑制重复事件，并让授权数据和运行日志能够管理。这类项目的价值不在于把模块接上就结束，而在于把输入、处理、输出和异常情况都写成可以验证的步骤。先做最小闭环，再加网页、存储和远程上报，排错会比一次堆满所有功能轻松很多。

二、硬件准备与接线

准备 ESP32、RC522、卡片或钥匙扣、蜂鸣器和 LED。RC522 通常使用 3.3 V 供电，SCK、MOSI、MISO 共用 SPI，总线上的每个设备使用独立 CS。先用 LED 模拟开锁，不要在学习阶段直接连接真实门锁或高功率负载连接前先断电，确认电压、电平和公共地。对于带电机、继电器、射频或长线的项目，电源和保护器件往往比代码更先决定系统是否稳定。第一次实验建议使用短线和独立供电，把每个变量控制在自己能观察的范围内。

三、工作原理

系统可以分成四层：硬件接口负责产生原始数据；驱动库负责把数据变成可读数值；应用层完成换算、状态机和限幅；展示层再通过串口、屏幕或网络输出。出现问题时按这四层排查，不要看到页面没数据显示就直接怀疑传感器。

四、最小代码骨架

下面代码用于验证最短路径，先确认硬件和库能工作，再把它放进正式任务。示例中的引脚和型号需要按手里的板卡修改：

#include <SPI.h>
#include <MFRC522.h>

MFRC522 rfid(5, 22);
const String allowed = "A1B2C3D4";

void setup() {
  Serial.begin(115200);
  SPI.begin();
  rfid.PCD_Init();
}

void loop() {
  if (!rfid.PICC_IsNewCardPresent() || !rfid.PICC_ReadCardSerial()) return;
  String uid;
  for (byte i = 0; i < rfid.uid.size; ++i) {
    if (rfid.uid.uidByte[i] < 0x10) uid += "0";
    uid += String(rfid.uid.uidByte[i], HEX);
  }
  uid.toUpperCase();
  Serial.printf("UID=%s result=%s\n", uid.c_str(), uid == allowed ? "ALLOW" : "DENY");
  rfid.PICC_HaltA();
}

代码跑通后，建议打开串口日志，记录启动、初始化失败、第一次有效数据和异常值。不要一开始就把日志全部关闭；没有观测点的程序，出了问题只能靠猜。

五、数据处理和状态机

真实设备的数据不会永远干净。传感器可能暂时无效，网络可能断开，用户可能连续点击，外设也可能在刷新期间保持忙状态。应用层至少应该有“初始化、工作、异常、恢复”四种状态，并为每种状态规定超时和下一步动作。

对于数值类数据，可以加入范围检查和简单滤波，但不要用滤波掩盖线路问题。对于控制类动作，要设置最大持续时间和默认安全态；对于无线数据，要加入节点编号、序号和校验。这样远程日志里看到一行错误时，才知道它对应哪个设备和哪一轮数据。

六、常见问题与排错

卡片一直贴在天线上时会被连续读取，因此要记录上次 UID 和时间，并设置重复抑制窗口。UID 可以被复制，不能把它当成强身份凭据。共享 SPI 总线时，SD 卡和 RC522 必须有独立 CS，多任务访问同一设备还需要统一调度或互斥保护

推荐采用“三步排错法”：第一步只读原始信号，确认传感器真的有变化；第二步打印换算前后的数值，确认单位和范围；第三步再接入网页、MQTT 或自动控制。每次只改一个变量，并把板型、供电、库版本和接线记录下来，成功以后也能复现。

七、扩展为可用项目

把白名单放入 NVS 或 LittleFS，增加网页增删卡、管理员模式、开门超时和离线事件队列。真实门禁还要考虑防拆、掉电状态、机械应急、权限撤销和更强的凭证认证，不能只靠一串 UID 撑起全部安全感扩展时不要把所有逻辑塞进 loop()。采样、业务计算、显示和联网可以拆成任务或事件处理器；配置放 NVS，日志放 LittleFS，大数据放 SD 卡。这样某一个外设暂时离线时，其他功能仍能保持可用。

八、测试清单

冷启动和复位后是否进入明确的安全状态；
拔掉外设、断网或输入越界时是否能恢复；
连续运行一小时后内存和日志是否稳定；
更换同型号模块后，地址和校准是否仍然正确；
断电重启后配置、编号和历史状态是否符合预期。

九、建议记录一张实验表

建议把实验日期、开发板型号、Arduino-ESP32 版本、供电方式、外设地址、关键引脚和测试结果记录在一张表里。数值类项目还要记录原始值、换算值、单位、滤波参数和校准物；通信类项目要记录包长度、间隔、重试次数和异常响应；控制类项目则记录默认态、最大持续时间和断电后的行为。这样下一次更换模块或升级库版本时，可以直接比较差异，而不是重新凭印象猜一遍。

第一次实验建议只接一个外设，并把串口输出保持在 115200。确认初始化成功后，再加入第二个模块、显示屏和网络。每增加一层功能，都先做一次冷启动、拔插和断网测试。很多看似“偶发”的问题，实际上是多个任务同时启动、供电瞬间跌落或旧配置没有清理造成的。

十、工程化注意事项

把示例代码变成长期运行的设备时，可以把引脚、阈值、设备地址和采样周期集中放进配置结构，使用 NVS 保存；把启动、异常、恢复和版本号写进远程日志；对网络请求使用超时和退避；对外部输入做长度与范围校验。涉及电机、继电器、射频和电池时，要把硬件保护、保险和外壳一起纳入设计，不能只验证“程序能运行”。

如果最终要放进盒子里，建议在文章中补充实际接线照片、模块背面丝印、串口原始输出和一次失败排错过程。读者最需要的往往不是漂亮的最终效果，而是当自己的板子没有按预期工作时，应该先测哪根线、看哪个数值、确认哪一个前提。把这些现场信息记录下来，教程才真正具备复用价值。

十一、总结

这篇教程的重点是建立一个可以测量、可以排错、可以扩展的 ESP32 小系统。先跑通最小闭环，再补齐边界条件，最后才做漂亮的网页和外壳。后续实际测试时，建议把串口输出、硬件照片和关键参数一起记录，这些内容会比一句“运行正常”更有复用价值。

参考资料

打赏

如果这篇学习记录对你有帮助，欢迎扫码支持后续整理。

打赏支持：王庆岩

posted on 2026-10-06 00:11 潇洒石头阅读(18) 评论(0) 收藏举报

刷新页面返回顶部