Skip to content

NFC

进入方式:主菜单 eGrove 4 / n

左侧 Grove 上的 Unit NFC(ST25R3916):读 / 写 13.56 MHz 卡、NDEF / 历史卡模拟、读卡历史。走 Ex_I2C(G2=SDA、G1=SCL),与 Radio / I2C 扫描同一口。

需要 Unit NFC,不是 Unit RFID(U031 / 0x28)。仅 13.56 MHz;受保护块需匹配密钥。

截图

Hub / Reader / Dump

nfc-mainnfc-readnfc-donenfc-dumpnfc-write_waitnfc-write_done

History / Detail / Write / Emulate

nfc-historynfc-detailnfc-writenfc-emu

Write / Emulate setup

nfc-write-setupnfc-write-typenfc-emu-setupnfc-emu-type

Write UID / NDEF

nfc-write-uidnfc-write-ndef

模块与接线

插到机身左侧 Grove(HY2.0-4P),按丝印对 SDA / SCL / VCC / GND

模块左侧 Grove
SDAG2
SCLG1
VCC5V
GNDGND

进入后初始化 Unit;失败显示 unit begin failed。与 GPS 不能同时占 Grove(GPS 会把同脚切成 UART)。

界面

进入 NFC 后先到主界面(Hub)r / w / l / e 分别进入读、写、历史、模拟。写卡与模拟只能从 Hub 进入(向导选历史卡或自定义)。

视图说明
Hub左侧模块状态;右侧四格:r READ / w WRITE / l LIST / e EMU
Reader左侧状态图标;右侧大号 UID、ATQA/SAK、卡型、USR/TOT;blk 点阵与进度条对齐(绿=成功 / 红=失败);翻页仅列出可读块 Hex
History最近最多 12 条(GPS 风格列表 + 滚动条)
Detail单条完整记录
Rename改历史条目名称
Write从 Hub w 进入:选已存卡或自定义(卡型 / UID / 文本)后贴卡写入
Emulation从 Hub e 进入:克隆历史 Type2,或自定义 NDEF 文本标签

快捷键

完整说明见 h Help(多页)。

按键作用
hHelp
Hub r / w / l / e进入 READ / WRITE / LIST / EMU
Reader r扫描直到读到卡
Reader o开关「读卡自动进历史」
History r重命名选中项
History Bksp删除选中项
↑ ↓ 等Reader dump 翻页;History / Detail 选条目或翻页
EnterHistory → Detail
写卡 / 模拟中 w / e结束当前写卡会话 / 退出模拟
ESC子页逐步返回 Hub;Hub 再按回 Grove

默认写卡内容为 Cardputer NFC(NDEF Text)。受保护扇区无正确密钥时读 / 写会失败。

读到 MIFARE Classic 时,会先用默认 KeyA FFFFFFFFFFFF 认证并读 blk 4(第 1 扇区第 0 块),再继续整卡 dump:

结果含义
default key扇区仍是出厂默认密钥
Auth Error密钥已改(常见于物业门禁卡)
n/a (not Classic)非 Classic,跳过探测

状态行与 key 行都会显示该结果,并写入 History。

模拟范围

  • 支持:MIFARE Ultralight 系列、NTAG 2xx(Type 2)。读卡时保存完整页镜像;Hub e 可选历史卡按原 UID + 内存回放。
  • 不支持:MIFARE Classic / Plus / DESFire 等(库只实现 Type2 监听)。此类记录会提示 type not emulatable(可仅模拟 UID 并提示)。

使用说明

  1. Unit NFC 插左侧 Grove,主菜单 en(或 4),进入 NFC 主界面(Hub)
  2. 各子模块只能从 Hub 进入r 读卡、w 写卡、l 历史、e 模拟。
  3. Hub 按 r 进 Reader,自动准备扫描;贴卡后看 UID / 类型 / 密钥探测 / NDEF,箭头翻 dump;o 控制是否自动记入 History。
  4. Hub 按 l 浏览历史,Enter 看详情,r 改名,Bksp 删除;ESC 回到 Hub。
  5. Hub 按 w / e 开写卡或模拟向导(选已存卡或自定义卡型 / UID / 文本);结束后按 w / eESC 回到 Hub。
  6. 退出 App 会停扫描 / 模拟并释放 I2C。

Sparks for M5Stack Cardputer