Card format¶
Player cards are MIFARE Classic 1K (4K works the same). The firmware uses sector 1 with the factory default key A (FF FF FF FF FF FF). The sector trailer is never written, so every reader can still rewrite the card.
Identity = UID
The card stores only the nickname, for display and for older tools. The player's identity is the card's UID, which NestrisLTM links to the player. If someone renames a card with a phone app, games do not move to another player.
Blocks in sector 1¶
| Block | Content |
|---|---|
| 4 | Name: ASCII, 1โ15 bytes, padded with 0x00 |
| 5 | Retroverse marker (below) |
| 6 | Reserved, zeros |
| 7 | Sector trailer, never written |
Block 5: marker¶
| Bytes | Content |
|---|---|
| 0โ3 | Magic 52 56 52 53 ("RVRS") |
| 4 | Format version 0x01 |
| 5 | Name length (1โ15) |
| 6โ7 | CRC-16/CCITT-FALSE (poly 0x1021, init 0xFFFF) over all 16 bytes of block 4, big endian |
| 8โ15 | Reserved, zeros |
How a card is classified¶
flowchart TD
A["<span style='color:#f8fafc'>Card detected</span>"]:::hw --> B{"MIFARE Classic?"}
B -- no --> U1["<span style='color:#ffffff'>unsupported</span>"]:::ext
B -- yes --> C{"Sector 1 readable?"}
C -- no --> U2["<span style='color:#ffffff'>unreadable</span>"]:::ext
C -- yes --> D{"Block 5 starts<br/>with RVRS?"}
D -- yes --> E{"Version, length,<br/>CRC, ASCII OK?"}
E -- yes --> OK["<span style='color:#111111'>retroverse โ</span>"]:::rfid
E -- no --> CO["<span style='color:#ffffff'>corrupt</span>"]:::ext
D -- no --> F{"Block 4 printable<br/>ASCII?"}
F -- yes --> LG["<span style='color:#ffffff'>legacy<br/>(first-generation card)</span>"]:::ext
F -- no --> BL["<span style='color:#ffffff'>blank</span>"]:::ext
classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3
Safe writing¶
A write command writes block 4 (name + padding), then block 5 (marker with the CRC of the new block 4), then reads both back and compares. If a write is interrupted, the card is left either with a CRC mismatch (corrupt) or with its old content, never as a valid card with half a name. Legacy cards become retroverse cards the first time they are written.