1580 字
8 分钟
0 浏览
用树莓派 Pico 与 PN532 做一个 AIME 读卡器

项目概述#

AimeReaderForPiPico 是一个基于树莓派 Pico(RP2040)与 PN532 模块的 AIME 读卡器。设备枚举为单个 USB CDC 串口。

固件分为三层:pn532.c 负责 I2C 时序与命令收发,nfc.c 负责寻卡与自检,aime.c 负责 AIME 帧编解码与命令处理。读卡部分参照 whowechina/mai_pico 的 aic_pico 模块实现,目前验证过的游戏为 SDEZ 与 SDGA。

硬件与接线#

元件 说明
主控 树莓派 Pico(RP2040)
读卡模块 PN532 V3,I2C 模式
线材 杜邦线 4 根,可传输数据的 USB 线 1 根
Pico PN532
GP16(I2C0 SDA) SDA
GP17(I2C0 SCL) SCL
3V3 (OUT) VCC
GND GND

模块供电接 3V3。PN532 是 3.3V 器件,I2C 电平随 VCC 变化,接 5V 会超出 Pico 的 IO 耐压。

拨码开关#

模块背面标注了模式表:HSU 为 0 0,I2C 为 1 0,SPI 为 0 1。使用 I2C 时开关应拨到 1 0。

拨码错误时 I2C 接口被硬件关闭,Pico 在总线上只能收到 NACK,现象与未接线一致,后面自检的”接线错误”灯效即对应这种情况。

实现#

PN532 通信#

I2C 地址 0x24,速率 400 kHz。一次命令交互分为三步。

写命令帧:

00 00 FF | LEN | LCS | D4 | CMD | DATA... | DCS | 00

LEN 统计 TFI(0xD4)、命令与参数,不包含 DCS;DCS 是这些字节之和的补码。

读取 ACK:模块收到命令后先返回 00 00 FF 00 FF 00。该帧必须读走,否则后续读到的响应实际是 ACK,解析会失败。

读取响应:PN532 的 I2C 读事务第一个字节为状态字节,帧从第二个字节开始,因此读取 n 字节需要一次读 n+1 字节,不能拆分。完整流程为:

  1. 轮询状态字节,直到 bit0 置位;
  2. 读 6 字节,取得 00 00 FF、LEN、LCS;
  3. 发送 NACK,使模块保留整帧;
  4. 再次等待就绪,读取完整帧并校验 LEN + LCS == 0、DCS 累加为 0、结尾为后同步码。

对应实现在 pn532.c。

寻卡#

寻卡使用 InListPassiveTarget(0x4A)。Type A 参数为 {MaxTg=1, BrTy=0x00},对应 106 kbps 的 ISO 14443A;FeliCa 参数为 {1, 0x01, 0xFF, 0xFF, 0x01, 0x00},对应 212 kbps。代码先轮询 Type A,无结果再轮询 FeliCa。

FeliCa 响应固定 22 字节:目标数量、目标编号、响应长度(20)、IDm(8 字节)、PMm(8 字节)、系统码(2 字节)。IDm 即 AIME 卡的身份标识。

AIME 协议#

串口帧格式:

E0 | len | addr | seq | cmd | payload_len | payload | sum

E0 为帧头,len 统计从该字节到 payload 末尾的字节数,不包含校验和。帧体中的 0xE0 与 0xD0 需转义:写入 0xD0 后跟 原值 - 1,解码时遇到 0xD0 将下一字节加一。

已实现的命令:

命令 作用 实现
0x30 / 0x32 读固件、硬件版本 返回固定字符串
0x40 / 0x41 开关射频 配置 PN532 的 RF 字段与 SAM
0x42 寻卡 支持 Type A 与 FeliCa
0x43 / 0x44 选卡、挂起 返回成功
0x50 / 0x54 设置 Key A / Key B 保存到内存
0x51 / 0x55 MIFARE 认证 转发至 PN532
0x52 读 MIFARE 块 转发至 PN532
0x70 / 0x71 FeliCa 透传 返回状态 3
0x81 / 0xF0 灯板命令 返回固定数据

寻卡响应按参考实现的结构返回:卡数量、卡类型、ID 长度,MIFARE 卡后接 UID,FeliCa 卡后接 IDm 与 PMm。

自检与指示灯#

上电后立即执行一次自检,此后每 5 秒执行一次。自检先读取 PN532 状态寄存器确认总线应答,再发送读固件版本命令确认协议层正常。

结果 灯效 含义
正常 常亮 1 秒,随后闪 2 下 总线有应答且固件版本帧合法
接线错误 闪 3 下,随后常亮 1 秒 0x24 地址无应答
协议错误 闪 2 下,常亮 1 秒,再闪 2 下 有应答但返回帧不合法

检测为周期性执行,运行中拔出模块会进入错误灯效,重新插入后 5 秒内自动重新初始化。检测到卡片时 LED 点亮 300 毫秒。

构建与烧录#

环境要求#

  • Pico SDK 2.2.0,需包含子模块,编译依赖 tinyusb
  • Arm GNU Toolchain 13.3(arm-none-eabi-gcc)
  • CMake 3.13 及以上,Ninja
  • Windows 下需要宿主编译器编译 picotool,可使用 MinGW-w64
  • PowerShell 5.1 及以上,仅使用打包脚本时需要

构建#

项目提供 build.ps1,会将工具链目录加入 PATH 并调用 CMake:

Terminal window
.\build.ps1 # Release 构建,并将 uf2 复制到项目根目录
.\build.ps1 -Clean # 清理后重新构建
.\build.ps1 -BuildType Debug

脚本通过 %PICO_TOOLS_PATH% 查找工具链,通过 %PICO_SDK_PATH% 查找 SDK,默认值分别为 D:\pico-tools 与 D:\pico-sdk,未找到时回退到系统 PATH。

手动构建:

Terminal window
cmake -S . -B build -G Ninja -DPICO_BOARD=pico -DCMAKE_BUILD_TYPE=Release
cmake --build build

产物位于 build/,烧录文件为 build/AimeReaderForPiPico.uf2。

烧录#

按住 BOOTSEL 后接入 USB,出现 RPI-RP2 磁盘,将 uf2 文件复制进去,板卡自动重启。

首次运行后设备管理器会新增一个 USB 串行设备。

游戏侧配置#

读卡器在游戏中表现为串口设备,需要设为 COM1,波特率 115200:

若 COM1 已被占用,需先释放该端口。

segatools 默认启用虚拟 AIME 读卡器,需将 segatools.ini 中 [aime] 段的 enable 改为 0,否则游戏读取的是虚拟卡:

游戏内 CARD READER TEST 显示硬件版本、固件版本与检测结果,出现 RESULT GOOD 表示链路正常:

可修改项#

参数 位置
SDA / SCL 引脚 src/main.cpp 的 SDA_PIN、SCL_PIN
I2C 速率 src/main.cpp 中 nfc_init() 最后一个参数,默认 400000
自检间隔 src/main.cpp 的 NFC_TEST_INTERVAL_US,默认 5 秒
灯效 src/main.cpp 的 PATTERN_OK、PATTERN_WIRING、PATTERN_PROTOCOL
VID / PID、设备名 src/usb_descriptors.c
板型 build.ps1 -Board <board> 或 CMake 的 -DPICO_BOARD=

常见问题#

闪 3 下后常亮 1 秒:总线无设备应答。依次检查模块供电、SDA 与 SCL 是否接反、是否共地、拨码是否为 1 0。线材较长或接触不良时,可将 I2C 速率降至 100000。

闪 2 下、常亮 1 秒、再闪 2 下:地址有应答但返回帧不合法,通常由供电不足、总线干扰或上次通信残留半帧数据引起,重新插拔模块可恢复。

灯效正常但游戏无响应:检查串口号是否为 COM1,以及 segatools.ini 的 [aime] enable 是否已置 0。

FeliCa 透传返回状态 3:与参考实现一致。AIME 协议下的寻卡与读卡不依赖 0x70 / 0x71;如需透传,可在 aime.c 中转发 InDataExchange 的结果。

MIFARE 写卡:未实现,0x53 仅返回成功状态,读卡与认证功能完整。

用树莓派 Pico 与 PN532 做一个 AIME 读卡器
https://blog.yufurry.cn/posts/00000025/
作者
蓝影Shadow
发布于
2026-11-05
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取