1. 项目缘起为什么用ESP32-C3和RFID做考勤最近在折腾一个办公室的小项目想搞个简单、低成本但又足够可靠的考勤打卡机。市面上现成的考勤机要么功能臃肿、价格不菲要么数据导出麻烦还得依赖厂商的云服务总感觉数据不在自己手里不踏实。正好手头有几片DFRobot出的Beetle ESP32-C3和一堆MFRC522的RFID模块就琢磨着自己动手搭一个。这个组合听起来有点“复古”——ESP32-C3是乐鑫较新的RISC-V架构芯片而MFRC522算是RFID读卡器里的“老将”了。但恰恰是这种“新核心成熟外设”的搭配在小型物联网项目里特别有搞头。ESP32-C3提供了Wi-Fi和蓝牙连接能力自带低功耗模式而MFRC522经过多年市场检验驱动成熟、价格低廉读取13.56MHz的非接触式IC卡比如常见的M1卡稳定得很。用它们来做一个网络考勤机数据直接上报到你自己搭建的服务器或者云平台完全自主可控成本可以压到百元以内对于小型团队、创客空间或者个人工作室来说是个非常实用的解决方案。2. 核心硬件选型与电路设计要点整个系统的硬件核心就两块主控板DFRobot Beetle ESP32-C3和读卡模块RC522。选它们不是随便抓的背后有具体的考量。2.1 主控为什么是Beetle ESP32-C3DFRobot的Beetle ESP32-C3是一个极小尺寸的开发板核心是乐鑫ESP32-C3芯片。这颗芯片采用32位RISC-V单核处理器主频高达160MHz集成4MB Flash和400KB SRAM。对于考勤系统来说性能完全过剩。我选它主要看中三点第一是极小的尺寸。Beetle ESP32-C3的板子只有25.4mm x 22.86mm比一枚硬币大不了多少这为最终产品的小型化设计提供了可能你可以很方便地把它塞进一个3D打印的精致外壳里。第二是完整的无线能力与低功耗。它支持2.4GHz Wi-Fi (802.11 b/g/n)和蓝牙5 (BLE)。考勤机通常需要常电但低功耗特性在备用电池或移动场景下仍有价值。更重要的是其Wi-Fi连接非常稳定这对于需要7x24小时在线的设备至关重要。第三是丰富的IO与开发便利性。它通过边缘的焊盘引出了所有的GPIO虽然需要自己焊接排针或导线但灵活性极高。同时它完美兼容Arduino IDE和ESP-IDF社区资源丰富遇到问题容易找到解决方案。2.2 读卡器经典MFRC522的再评估MFRC522是一个高度集成的13.56MHz射频读写芯片支持ISO/IEC 14443 A/MIFARE模式。说白了就是能读我们常见的门禁卡、电梯卡、校园卡M1卡。选择它原因很简单便宜、稳定、资料多。一片RC522模块在某宝上不到10块钱驱动程序在Arduino社区里是“祖传”的经过无数项目验证。但是用RC522也有几个必须注意的坑。首先是通信距离。它的典型读写距离是3-5厘米这决定了你的考勤机外壳设计必须让卡片贴近感应区别指望隔空刷卡。其次是多卡冲突。当感应区内同时出现多张卡时读卡会失败或错乱。这在考勤场景下意味着需要设计明确的刷卡引导比如一个凹槽一次只能放入一张卡。最后是卡片类型。它只能读MIFARE Classic 1K (S50)等常见卡对于CPU卡或者更高安全等级的卡片无能为力。不过对于内部考勤使用廉价的UID卡或普通M1卡完全足够。2.3 电路连接与“天线”的玄学硬件连接很简单采用SPI通信这是RC522最稳定快速的方式。Beetle ESP32-C3的默认SPI引脚是SCK (GPIO4)- RC522的SCKMOSI (GPIO6)- RC522的MOSIMISO (GPIO5)- RC522的MISOSDA (GPIO10 即SS/CS)- RC522的SDA (片选)RST (GPIO3)- RC522的RST3.3V- RC522的3.3VGND- RC522的GND这里要特别提一下ESP32-C3天线阻抗匹配这个热词。Beetle ESP32-C3板载的PCB天线已经做好了50欧姆的阻抗匹配用户通常无需关心。但如果你发现设备的Wi-Fi信号强度明显弱于手机或其他ESP32设备在排除软件配置问题后可能需要考虑硬件问题。不过对于固定位置的考勤机只要离路由器不是特别远信号问题一般不大。更值得关注的是RC522模块的天线。它是一个方形线圈周围不要放置金属物体否则会严重影响读卡距离和稳定性。在设计外壳时读卡区域下方最好留出至少5mm的非金属空间。3. 固件开发从读卡到数据上报的全流程软件部分是项目的灵魂我们需要让ESP32-C3完成三件事初始化硬件、读取卡片ID、通过网络上报数据。3.1 开发环境与库的搭建我使用Arduino IDE进行开发因为它快速且库管理方便。首先需要在开发板管理器中安装“ESP32 by Espressif Systems”开发板包并选择“DFRobot Beetle ESP32-C3”板型。核心库有两个MFRC522 by GithubCommunity这是最常用的RC522驱动库。ArduinoHttpClient或HTTPClient(ESP32内置)用于发送HTTP请求。安装好库后一个常见的坑是引脚定义冲突。ESP32-C3的某些GPIO有默认功能比如GPIO8、GPIO9通常用于内部Flash不能用作普通IO。我们前面选择的GPIO3、4、5、6、10都是安全的GPIO。3.2 核心代码逻辑拆解程序的主逻辑是一个状态机核心代码如下框架#include SPI.h #include MFRC522.h #include WiFi.h #include HTTPClient.h // 引脚定义 #define SS_PIN 10 #define RST_PIN 3 MFRC522 mfrc522(SS_PIN, RST_PIN); // WiFi信息 const char* ssid Your_SSID; const char* password Your_PASSWORD; // 服务器地址 const char* serverUrl http://your-server.com/api/attendance; void setup() { Serial.begin(115200); SPI.begin(); mfrc522.PCD_Init(); connectToWiFi(); Serial.println(System Ready. Please tap your card.); } void loop() { // 1. 检测是否有新卡片 if (!mfrc522.PICC_IsNewCardPresent() || !mfrc522.PICC_ReadCardSerial()) { delay(50); // 短暂延迟降低CPU占用 return; } // 2. 读取卡片UID并转换为字符串 String cardUID ; for (byte i 0; i mfrc522.uid.size; i) { cardUID String(mfrc522.uid.uidByte[i], HEX); } cardUID.toUpperCase(); // 统一为大写便于比较 Serial.print(Card UID: ); Serial.println(cardUID); // 3. 上报数据到服务器 sendAttendanceData(cardUID); // 4. 让卡片进入休眠状态避免连续读取 mfrc522.PICC_HaltA(); delay(1000); // 刷卡后防抖延迟防止一次刷卡触发多次读取 } void connectToWiFi() { WiFi.begin(ssid, password); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(WiFi Connected!); } void sendAttendanceData(String uid) { if (WiFi.status() ! WL_CONNECTED) { Serial.println(WiFi Disconnected!); return; } HTTPClient http; http.begin(serverUrl); http.addHeader(Content-Type, application/x-www-form-urlencoded); // 构建POST数据例如card_uidABC123device_idESP32C3_01 String postData card_uid uid device_idESP32C3_01timestamp String(millis()); int httpResponseCode http.POST(postData); if (httpResponseCode 0) { String response http.getString(); Serial.println(Server Response: response); } else { Serial.print(HTTP Error: ); Serial.println(httpResponseCode); } http.end(); }这段代码的关键点在于防抖处理delay(1000)和网络请求的健壮性。在实际部署中你还需要考虑Wi-Fi断开重连、服务器无响应时的重试机制以及可能的数据本地缓存如果使用SPIFFS或EEPROM。3.3 数据处理UID的奥秘与安全性探讨mfrc522.uid.uidByte数组读取到的是卡片的唯一标识符UID。对于M1卡前4个字节4字节UID或7个字节7字节UID是唯一的。我们通常将其转换为十六进制字符串作为用户的身份标识。但这里有一个重要的安全提醒MIFARE Classic卡M1卡的UID在卡片出厂时设定但可以被某些读写器修改即“UID复制卡”。因此仅依赖UID进行身份验证是不安全的容易被复制。对于内部考勤等安全要求不高的场景可以接受。如果对安全性有要求应该使用卡的认证机制通过密钥读取卡内扇区数据甚至使用MIFARE Plus或DESFire等更安全的卡片。在代码中我们可以通过mfrc522.PCD_Authenticate()函数尝试用默认密钥如0xFF 0xFF 0xFF 0xFF 0xFF 0xFF去认证某个扇区成功后再读取数据这样能一定程度上确认卡片不是最廉价的UID复制卡。不过这增加了代码复杂度和刷卡时间需要权衡。4. 服务器端与数据呈现的简易方案考勤数据上报需要有个地方接收和展示。这里提供几个从简到繁的方案。4.1 方案一使用现成的物联网平台最快上手对于想快速看到效果的朋友可以使用免费的物联网平台比如ThingsBoard可自建开源版、Blynk或者Easy IoT。以Blynk为例你可以在App里创建一个项目获取一个Auth Token然后在ESP32代码中集成Blynk库将刷卡事件和UID作为虚拟引脚Virtual Pin的值发送出去。Blynk的App端可以轻松地设置数据流图表、日志窗口甚至发推送通知。这是原型验证阶段最快的方式。4.2 方案二自建轻量级HTTP服务器自主可控如果你有一点后端基础自己写个简单的HTTP服务是最灵活的方式。可以用Python Flask、Node.js Express等框架快速搭建。一个Flask示例的端点可能长这样from flask import Flask, request import sqlite3 from datetime import datetime app Flask(__name__) app.route(/api/attendance, methods[POST]) def record_attendance(): card_uid request.form.get(card_uid) device_id request.form.get(device_id) # 使用服务器时间更可靠 timestamp datetime.now().isoformat() # 存入SQLite数据库 conn sqlite3.connect(attendance.db) c conn.cursor() c.execute(CREATE TABLE IF NOT EXISTS records (id INTEGER PRIMARY KEY, card_uid TEXT, device_id TEXT, time TEXT)) c.execute(INSERT INTO records (card_uid, device_id, time) VALUES (?, ?, ?), (card_uid, device_id, timestamp)) conn.commit() conn.close() return {status: success, message: Record saved.}, 200 if __name__ __main__: app.run(host0.0.0.0, port5000)这个服务运行在你的局域网电脑或树莓派上。ESP32-C3的代码中的serverUrl就需要改成http://你的电脑IP:5000/api/attendance。你需要处理内网穿透如使用frp、ngrok以便在外网访问或者就让服务器运行在内网。4.3 方案三直接对接数据库或云数据库更进阶一点ESP32-C3可以直接连接数据库比如MySQL或PostgreSQL但通常不推荐因为数据库连接协议复杂且不安全。更好的做法是连接云数据库服务如Supabase或Firebase Realtime Database。它们提供了简单的REST API或专门的SDK。以Supabase为例它提供了一个类似PostgreSQL的数据库并生成自动的API。你可以在ESP32代码中直接向它的REST端点发送POST请求插入数据安全性由API密钥管理。5. 系统集成、调试与外壳设计当硬件连好、固件烧录、服务器跑通后就进入了集成调试阶段。这里最容易出问题。5.1 常见故障排查清单读不到卡检查电源确保RC522模块接的是3.3V接5V可能损坏模块。检查接线SPI的线序SCK MOSI MISO是否接反SDA和RST引脚是否与代码定义一致检查天线RC522模块的天线线圈是否完好附近是否有金属物体遮挡检查卡片确认卡片是13.56MHz的MIFARE卡。Wi-Fi连接不稳定或无法连接检查凭证SSID和密码是否正确特别是密码中的特殊字符。检查信号强度可以通过WiFi.RSSI()打印信号强度如果低于-70dBm考虑调整设备位置或增加Wi-Fi中继。检查路由器设置有些路由器可能禁用了老旧协议如802.11b确保路由器兼容802.11n。HTTP请求失败检查网络连通性在setup()里用ping命令测试是否能通服务器IP或域名。检查URL和端口服务器地址是否正确防火墙是否开放了对应端口如5000。查看服务器日志在服务器端查看是否有请求进来以及错误信息是什么。5.2 外壳设计与用户体验一个实用的考勤机离不开好用的外壳。使用3D建模软件如Fusion 360 Tinkercad设计一个外壳需要考虑以下几点读卡区域在顶部或侧面开一个方形孔大小略大于RC522天线线圈。孔的下方预留至少3-5mm的非金属空间作为感应区。可以在孔周围设计一个凹槽或倾斜面引导卡片放置位置。固定与散热设计螺丝柱固定主板和RC522模块。ESP32-C3工作时会有微热外壳应有一些透气孔。状态指示留出位置安装LED电源、Wi-Fi状态、刷卡成功/失败。可以在代码中通过GPIO控制这些LED提供直观反馈。电源接口为Micro-USB或Type-C电源线留出开口。你可以将设计好的模型发送到3D打印服务商打印或者自己如果有3D打印机就更方便了。材质选择PLA或ABS即可。5.3 供电与长期运行考虑考勤机通常需要7x24小时运行。建议使用5V 1A以上的USB电源适配器供电通过Beetle ESP32-C3的USB口输入。避免使用电脑USB口或移动电源因为它们可能在不活动时断电。对于代码要加入看门狗Watchdog和异常重启机制。ESP32-C3内置硬件看门狗可以在代码初始化时启用以防程序跑飞。同时在网络操作中设置合理的超时时间避免因服务器无响应导致整个循环卡死。// 启用硬件看门狗超时时间5秒 esp_task_wdt_init(5, true); esp_task_wdt_add(NULL);在loop()中定期喂狗esp_task_wdt_reset();经过以上步骤一个完全自主可控、成本低廉、基于RFID和ESP32-C3的考勤系统就搭建完成了。它不仅解决了基本的打卡需求更是一个深入了解物联网硬件开发、嵌入式编程、前后端通信的绝佳实践项目。你可以在此基础上扩展更多功能比如增加LCD屏幕显示姓名、接入企业微信/钉钉机器人发送打卡通知、甚至结合人脸识别模块做多模态认证。