基于 Arduino 与 Google Sheets 的实时 RFID 考勤系统

组件与物料

软件与云服务

• Arduino IDE
• Google Sheets（在线表格）
• Google Apps Script（云端脚本）
• Pushingbox（中转服务，用 Google 账号登录）

项目背景

室内空气污染往往比室外严重 2~5 倍，灰尘、过敏原引发打喷嚏、眼睛痒甚至哮喘。本项目利用 RFID 刷卡考勤，配合 Ethernet Shield 通过 Pushingbox 将 UID 实时推送至 Google Sheets，实现零成本云端考勤记录，适合中小团队、教室、实验室等场景。

软件准备

1. Arduino IDE

从 官网 下载最新版。

2. Google Drive 侧配置

1. 新建 Google 表格，表头建议：Timestamp, UID, Name, Status。
2. 打开“扩展程序 → Apps Script”，粘贴接收 HTTP GET 请求并追加行的脚本，部署为“Web 应用”，权限选“任何人”，复制生成的 URL。

3. Pushingbox 配置

1. 登录 Pushingbox，创建 Scenario，Action 选择“HTTP Request”，URL 填入 Apps Script 部署链接，Method 选 GET，参数如 uid=$UID$。
2. 记下生成的 DeviceID（形如 vXXXXXXXXXXXXXX）。

硬件接线

Ethernet Shield

直接插在 UNO 顶部，RJ45 接路由器 LAN 口。

RFID-RC522 (SPI)

注意：Ethernet Shield 已占用引脚 10 (UNO) / 53 (Mega) 作为 SS，因此 RC522 的 SDA 必须改接别的引脚（如 UNO 的 4），并在代码中修改 SS_PIN 定义，避免 SPI 总线冲突。

库安装

• 库管理器搜索安装 MFRC522（作者 GithubCommunity）
• Ethernet Shield 2 使用 Arduino 自带 Ethernet2 或 Ethernet（新版 IDE 已整合）

核心代码逻辑

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

#define SS_PIN 4   // 避开 Ethernet Shield 的 10
#define RST_PIN 9
MFRC522 mfrc522(SS_PIN, RST_PIN);

byte mac[] = {0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED};
char server[] = "api.pushingbox.com";
EthernetClient client;

void setup() {
  Serial.begin(115200);
  SPI.begin();
  mfrc522.PCD_Init();
  Ethernet.begin(mac);
  delay(1000);
}

void loop() {
  if (!mfrc522.PICC_IsNewCardPresent() || !mfrc522.PICC_ReadCardSerial()) return;
  String uid = "";
  for (byte i = 0; i < mfrc522.uid.size; i++) {
    uid += String(mfrc522.uid.uidByte[i] < 0x10 ? " 0" : " ");
    uid += String(mfrc522.uid.uidByte[i], HEX);
  }
  uid.toUpperCase();
  sendToPushingbox(uid);
  delay(1000); // 防重复触发
}

void sendToPushingbox(String uid) {
  if (client.connect(server, 80)) {
    String url = "/pushingbox?devid=YOUR_DEVICEID&uid=" + uid;
    client.print("GET " + url + " HTTP/1.1\r\nHost: " + String(server) + "\r\nConnection: close\r\n\r\n");
  }
  client.stop();
}