hf mfdes sim: host driven test hook with injectable randomness

The DESFire simulation could only be reached over the air. A conformance
suite that has recorded a genuine card's session needs to replay it byte
for byte, which takes two things the simulation did not have: a way in
over USB, and control of the card's random draws.

CMD_HF_DESFIRE_SIM_TEST carries one operation per packet into the same
state machine the RF loop drives: BEGIN, SCAN, APDU, RANDOM, FIELDOFF,
STATE, END. SCAN runs the RF-reset path (init, reset, random id, FSD) and
APDU goes through desfire_sim_apdu(), so native and ISO 7816 wrapped
commands answer exactly as they do on air. No FPGA involvement.

Randomness goes through a small host-fed byte queue: RndB and the random
id draw from it first and fall back to the existing fixed value or tick
counter when it is short, raising a sticky underflow flag. With nothing
queued the RF simulation is byte-identical to before; SimulateDesfireTag()
clears the queue so a host session cannot leak into a reader session.

Co-Authored-By: Claude Fable 5.1 (claude-fable-5-1) <noreply@anthropic.com>
This commit is contained in:
Mistial DeveloperandClaude Fable 5.1 authored and Philippe Teuwen committed 2026-09-16 22:04:01 +02:00
1 parent 71b558d6be
commit e588085c10
5 files changed
+211 -7

No files matched your search

+29
View File
@@ -43,4 +43,33 @@ typedef struct {
uint8_t keys[DESFIRE_MAX_ALGO_COUNT][DESFIRE_MAX_KEY_COUNT][DESFIRE_MAX_KEY_SIZE + 1];
} desfire_app_keys_t;
// `hf mfdes etest`: one CMD_HF_DESFIRE_SIM_TEST packet carries one operation.
typedef enum {
DESFIRE_SIM_TEST_BEGIN = 0, // check the image, clear the random queue -> no data
DESFIRE_SIM_TEST_END, // drop the state and the random queue -> no data
DESFIRE_SIM_TEST_SCAN, // RF reset and activation -> iso14a_card_select_t
DESFIRE_SIM_TEST_APDU, // data: one command, native or ISO 7816 wrapped -> the answer
DESFIRE_SIM_TEST_RANDOM, // data: bytes the next RndB / random id draws use
DESFIRE_SIM_TEST_FIELDOFF, // RF reset: session dropped, image re-read -> no data
DESFIRE_SIM_TEST_STATE, // -> desfire_sim_test_state_t
} desfire_sim_test_op_t;
// bytes the random queue holds, RANDOM answers PM3_EOVFLOW past this
#define DESFIRE_SIM_TEST_RANDOM_MAX 64
typedef struct {
uint8_t op; // desfire_sim_test_op_t
uint16_t len;
uint8_t data[];
} PACKED desfire_sim_test_cmd_t;
typedef struct {
uint8_t ready; // activated and answering
uint8_t authenticated;
uint8_t auth_keyno;
uint8_t aid[3]; // selected application, wire order
uint8_t random_remaining; // queued bytes not yet drawn
uint8_t random_underflow; // a draw wanted more than was queued, sticky
} PACKED desfire_sim_test_state_t;
#endif
+1
View File
@@ -1192,6 +1192,7 @@ typedef struct {
#define CMD_HF_MIFARE_NACK_DETECT 0x0730
#define CMD_HF_MIFARE_STATIC_NONCE 0x0731
#define CMD_HF_MIFARE_STATIC_ENCRYPTED_NONCE 0x0732
#define CMD_HF_DESFIRE_SIM_TEST 0x0733
// MFU OTP TearOff
#define CMD_HF_MFU_OTP_TEAROFF 0x0740