unleashed-firmware/lib/nfc/protocols/iso14443_3a/iso14443_3a.h
gornekich d92b0a82cc
NFC refactoring (#3050)
"A long time ago in a galaxy far, far away...." we started NFC subsystem refactoring.

Starring:

- @gornekich - NFC refactoring project lead, architect, senior developer
- @gsurkov - architect, senior developer
- @RebornedBrain - senior developer

Supporting roles:

- @skotopes, @DrZlo13, @hedger - general architecture advisors, code review
- @Astrrra, @doomwastaken, @Hellitron, @ImagineVagon333 - quality assurance

Special thanks:

@bettse, @pcunning, @nxv, @noproto, @AloneLiberty and everyone else who has been helping us all this time and contributing valuable knowledges, ideas and source code.
2023-10-24 12:08:09 +09:00

108 lines
2.7 KiB
C

#pragma once
#include <toolbox/bit_buffer.h>
#include <nfc/protocols/nfc_device_base_i.h>
#ifdef __cplusplus
extern "C" {
#endif
#define ISO14443_3A_UID_4_BYTES (4U)
#define ISO14443_3A_UID_7_BYTES (7U)
#define ISO14443_3A_UID_10_BYTES (10U)
#define ISO14443_3A_MAX_UID_SIZE ISO14443_3A_UID_10_BYTES
#define ISO14443_3A_GUARD_TIME_US (5000)
#define ISO14443_3A_FDT_POLL_FC (1620)
#define ISO14443_3A_FDT_LISTEN_FC (1172)
#define ISO14443_3A_POLLER_MASK_RX_FS ((ISO14443_3A_FDT_LISTEN_FC) / 2)
#define ISO14443_3A_POLL_POLL_MIN_US (1100)
typedef enum {
Iso14443_3aErrorNone,
Iso14443_3aErrorNotPresent,
Iso14443_3aErrorColResFailed,
Iso14443_3aErrorBufferOverflow,
Iso14443_3aErrorCommunication,
Iso14443_3aErrorFieldOff,
Iso14443_3aErrorWrongCrc,
Iso14443_3aErrorTimeout,
} Iso14443_3aError;
typedef struct {
uint8_t sens_resp[2];
} Iso14443_3aSensResp;
typedef struct {
uint8_t sel_cmd;
uint8_t sel_par;
uint8_t data[4]; // max data bit is 32
} Iso14443_3aSddReq;
typedef struct {
uint8_t nfcid[4];
uint8_t bss;
} Iso14443_3aSddResp;
typedef struct {
uint8_t sel_cmd;
uint8_t sel_par;
uint8_t nfcid[4];
uint8_t bcc;
} Iso14443_3aSelReq;
typedef struct {
uint8_t sak;
} Iso14443_3aSelResp;
typedef struct {
uint8_t uid[ISO14443_3A_MAX_UID_SIZE];
uint8_t uid_len;
uint8_t atqa[2];
uint8_t sak;
} Iso14443_3aData;
Iso14443_3aData* iso14443_3a_alloc();
void iso14443_3a_free(Iso14443_3aData* data);
void iso14443_3a_reset(Iso14443_3aData* data);
void iso14443_3a_copy(Iso14443_3aData* data, const Iso14443_3aData* other);
bool iso14443_3a_verify(Iso14443_3aData* data, const FuriString* device_type);
bool iso14443_3a_load(Iso14443_3aData* data, FlipperFormat* ff, uint32_t version);
bool iso14443_3a_save(const Iso14443_3aData* data, FlipperFormat* ff);
bool iso14443_3a_is_equal(const Iso14443_3aData* data, const Iso14443_3aData* other);
const char* iso14443_3a_get_device_name(const Iso14443_3aData* data, NfcDeviceNameType name_type);
const uint8_t* iso14443_3a_get_uid(const Iso14443_3aData* data, size_t* uid_len);
bool iso14443_3a_set_uid(Iso14443_3aData* data, const uint8_t* uid, size_t uid_len);
Iso14443_3aData* iso14443_3a_get_base_data(const Iso14443_3aData* data);
uint32_t iso14443_3a_get_cuid(const Iso14443_3aData* data);
// Getters and tests
bool iso14443_3a_supports_iso14443_4(const Iso14443_3aData* data);
uint8_t iso14443_3a_get_sak(const Iso14443_3aData* data);
void iso14443_3a_get_atqa(const Iso14443_3aData* data, uint8_t atqa[2]);
// Setters
void iso14443_3a_set_sak(Iso14443_3aData* data, uint8_t sak);
void iso14443_3a_set_atqa(Iso14443_3aData* data, const uint8_t atqa[2]);
#ifdef __cplusplus
}
#endif