使用 Arduino 制作的 Aime 兼容读卡器。
doc | ||
tools | ||
Aime_Reader.h | ||
Arduino-Aime-Reader.ino | ||
README.md |
Arduino-Aime-Reader
使用 Arduino + PN532 制作的 Aime 兼容读卡器。
- 支持卡片类型: FeliCa(Amusement IC、Suica、八达通等)和 MIFARE(Aime,Banapassport)
- 逻辑实现是通过对官方读卡器串口数据进行分析猜测出来的,并非逆向,不保证正确实现
- 通信数据格式参考了 Segatools 和官方读卡器抓包数据,可在 Example.txt 和 nfc.txt 查看
- 定制使用例(主要的开发测试环境):ESP32-CardReader
使用方法:
- 按照 PN532 或 Aime_Reader_PN532 的提示安装库
- 按照使用方式,在 Arduino 和 PN532 接好连接线(I2C 或 SPI 或 HSU),并调整 PN532 上的拨码开关
- 接上 WS2812B 灯条(可选,不会影响正常读卡功能)
- 上传 ReaderTest 测试硬件是否工作正常
- 若读卡正常,可按照游戏支持列表打开设备管理器设置 COM 端口号
- 按照游戏的波特率设置代码的
high_baudrate
选项,115200
是true
,38400
是false
- 如果有使用 Segatools,参考 segatools.ini 设置教程 关闭 Aime 模拟功能
- 上传程序打开游戏测试
如果需要自定义 Aime 卡,安装 MifareClassicTool 或其他同样效果的软件,修改 Aime 卡示例 后写入空白 MIFARE UID/CUID 卡,即可刷卡使用。
关于自定义 Aime 卡的写入和读取问题,请参考 SAK(88->08) 的讨论。
某些 Arduino 可能需要在游戏主程序连接前,给串口以正确的波特率发送 DTR/RTS;可以先打开一次 Arduino 串口监视器再启动游戏程序。
支持游戏列表:
代号 | 默认 COM 号 | 支持的卡 | 默认波特率 |
---|---|---|---|
SDDT/SDEZ | COM1 | FeliCa,MIFARE | 115200 |
SDEY | COM2 | MIFARE | 38400 |
SDHD | COM4 | FeliCa,MIFARE | cvt=38400,sp=115200 |
SBZV/SDDF | COM10 | FeliCa,MIFARE | 38400 |
SDBT | COM12 | FeliCa,MIFARE | 38400 |
- 如果读卡器没有正常工作,可以切换波特率试下
- 有使用 amdaemon 的,可以参考 config_common.json 内 aime > unit > port 确认端口号
如果"high_baudrate" : true
则波特率是115200
,否则就是38400
- 在游戏和服务器支持的情况下,本读卡器程序可正常使用 emoney 端末认证和刷卡支付功能
开发板适配情况:
开发板名 | 主控 | 备注 |
---|---|---|
SparkFun Pro Micro | ATmega32U4 | 需要发送 DTR/RTS |
NodeMCU 1.0 | ESP-12E + CH340 | |
NodeMCU-32S | ESP32-S + CH340 | 主要适配环境 |
Arduino Uno | ATmega328P + CH340 | 未实际测试,据反馈不可用 |
已知问题:
- 默认未启用 FeliCa 读写功能,仅在
CMD_CARD_DETECT
时读取 IDm 和 PMm,该设置可以通过SKIP_FeliCa_THROUGH
控制 - 如果启用 FeliCa 读写功能,某些游戏可能不支持所有 FeliCa 卡种类,和官方读卡器 837-15286 行为一致
- 因为 PN532 库支持的问题,未实现多卡同时读取,只会读到最先识别的卡片;刷不正确的 MIFARE 卡片(如交通卡、模拟卡)会导致游戏状态异常
- 对于未适配的命令,默认回复
STATUS_INVALID_COMMAND
,可能会导致游戏认为读卡器不可用 - 如果遇到问题可以回滚到稳定的 v1.0 版本
引用库:
- 驱动 WS2812B:FastLED
- 驱动 PN532:PN532 或 Aime_Reader_PN532
- 读取 FeliCa 参考:PN532を使ってArduinoでFeliCa学生証を読む方法
- 读取 FeliCa 数据的程序:NFC TagInfo,NFC TagInfo by NXP
- MIFARE 读写卡,数据分析:MifareClassicTool,MifareOneTool