SEGAy/Arduino-Aime-Reader
1
0
Fork 0
mirror of synced 2024-11-23 23:50:56 +01:00
Code Releases Activity
abea29824c
Arduino-Aime-Reader/README.md
Sucareto e09b376eb1 更新开发板适配情况
2024-03-05 04:02:13 +08:00

4.6 KiB
Raw Blame History

Arduino-Aime-Reader

使用 Arduino + PN532 制作的 Aime 兼容读卡器。

  • 支持卡片类型： FeliCa（Amusement IC、Suica、八达通等）和 MIFARE（Aime，Banapassport）
  • 逻辑实现是通过对官方读卡器串口数据进行分析猜测出来的，并非逆向，不保证正确实现
  • 通信数据格式参考了 Segatools 和官方读卡器抓包数据，可在 Example.txt 和 nfc.txt 查看
  • 定制使用例（主要的开发测试环境）：ESP32-CardReader

使用方法：

  1. 按照 PN532 或 Aime_Reader_PN532 的提示安装库
  2. 按照使用方式，在 Arduino 和 PN532 接好连接线（I2C 或 SPI 或 HSU），并调整 PN532 上的拨码开关
  3. 接上 WS2812B 灯条（可选，不会影响正常读卡功能）
  4. 上传 ReaderTest 测试硬件是否工作正常
  5. 若读卡正常，可按照游戏支持列表打开设备管理器设置 COM 端口号
  6. 按照游戏的波特率设置代码的high_baudrate选项，115200是true，38400是false
  7. 如果有使用 Segatools，参考 segatools.ini 设置教程 关闭 Aime 模拟功能
  8. 上传程序打开游戏测试

如果需要自定义 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 未实际测试，据反馈不可用

已知问题：

  • 在 NDA_08 命令的写入 Felica 操作没有实现，因为未确认是否会影响卡片后续使用
  • 未确定res.status错误码的定义，因此res.status的值可能是错误的
  • 因为 PN532 库不支持同时读取多张卡片，所以未实现mifare_select_tag，只会读到最先识别的卡片
  • 默认仅允许 SAK=0x08 的卡片，如果需要解除限制，可以自行修改源码
  • 如果遇到问题可以回滚到稳定的 v1.0 版本

引用库：