Updated Known issues (markdown)

sp2xdev
2025-01-10 00:34:57 -08:00
parent 2790bb8655
commit 760749cf66
+3 -1
@@ -275,10 +275,12 @@ Note that SpiceCompanion apps are not part of the spice2x project (not forked).
`HID Smartcard` option is intended for NFC readers with ACR112U chipset; it's coded to [their specifications](https://www.acs.com.hk/en/download-manual/419/API-ACR122U-2.04.pdf).
The official ACR112U product line from ACS has been discontinued years ago. Most of them being sold today online are poor knock-offs of ACS ACR122U. Unfortunately, some of these knock-offs are unable to properly read FeliCa cards. Please only purchase from well known resellers. You may instead want to look into DIY solutions based on cardIO HID protocol: https://rhythm-cons.wiki/other-hardware/card-readers/
The official ACR112U product line from ACS has been discontinued years ago. Most of them being sold today online are poor knock-offs of ACS ACR122U. Unfortunately, some of these knock-offs are unable to properly read FeliCa cards. Please only purchase from well known resellers.
Official driver is [here](https://www.acs.com.hk/en/driver/3/acr122u-usb-nfc-reader/); however, Windows default driver is usually sufficient.
If you have trouble finding a good ACR112U unit, you may instead want to look into DIY solutions based on cardIO HID protocol: https://rhythm-cons.wiki/other-hardware/card-readers/
There is also a known bug in ACR122U logic (`scard.cpp`) when reading UID values from cards. It interprets the "success" header `90 00` as part of the UID. If your card has UID of `1234 5678` then it's read as `1234 5678 9000 0000`. This is not an issue for FeliCa as they already have full 8 bytes of UID, it's only a problem for cards with UID < 8 bytes. It's recommended that you set `-scardfix fix` for more correct behavior for non-FeliCa cards.
## Other issues