mirror of
https://github.com/DarkFlippers/unleashed-firmware.git
synced 2025-12-12 04:34:43 +04:00
338 lines
9.1 KiB
C
338 lines
9.1 KiB
C
#pragma once
|
|
|
|
#include <toolbox/bit_buffer.h>
|
|
#include <nfc/protocols/nfc_device_base_i.h>
|
|
#include <mbedtls/include/mbedtls/des.h>
|
|
#include <lib/toolbox/simple_array.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define FELICA_IDM_SIZE (8U)
|
|
#define FELICA_PMM_SIZE (8U)
|
|
#define FELICA_DATA_BLOCK_SIZE (16U)
|
|
|
|
#define FELICA_CMD_READ_WITHOUT_ENCRYPTION (0x06U)
|
|
#define FELICA_CMD_WRITE_WITHOUT_ENCRYPTION (0x08U)
|
|
|
|
#define FELICA_SERVICE_RW_ACCESS (0x0009U)
|
|
#define FELICA_SERVICE_RO_ACCESS (0x000BU)
|
|
|
|
#define FELICA_BLOCKS_TOTAL_COUNT (28U)
|
|
#define FELICA_BLOCK_INDEX_REG (0x0EU)
|
|
#define FELICA_BLOCK_INDEX_RC (0x80U)
|
|
#define FELICA_BLOCK_INDEX_MAC (0x81U)
|
|
#define FELICA_BLOCK_INDEX_ID (0x82U)
|
|
#define FELICA_BLOCK_INDEX_D_ID (0x83U)
|
|
#define FELICA_BLOCK_INDEX_SER_C (0x84U)
|
|
#define FELICA_BLOCK_INDEX_SYS_C (0x85U)
|
|
#define FELICA_BLOCK_INDEX_CKV (0x86U)
|
|
#define FELICA_BLOCK_INDEX_CK (0x87U)
|
|
#define FELICA_BLOCK_INDEX_MC (0x88U)
|
|
#define FELICA_BLOCK_INDEX_WCNT (0x90U)
|
|
#define FELICA_BLOCK_INDEX_MAC_A (0x91U)
|
|
#define FELICA_BLOCK_INDEX_STATE (0x92U)
|
|
#define FELICA_BLOCK_INDEX_CRC_CHECK (0xA0U)
|
|
|
|
#define FELICA_STANDARD_MAX_BLOCK_COUNT (0xFFU)
|
|
|
|
#define FELICA_GUARD_TIME_US (20000U)
|
|
#define FELICA_FDT_POLL_FC (10000U)
|
|
#define FELICA_POLL_POLL_MIN_US (1280U)
|
|
|
|
#define FELICA_FDT_LISTEN_FC (0)
|
|
|
|
#define FELICA_SYSTEM_CODE_CODE (0xFFFFU)
|
|
#define FELICA_TIME_SLOT_1 (0x00U)
|
|
#define FELICA_TIME_SLOT_2 (0x01U)
|
|
#define FELICA_TIME_SLOT_4 (0x03U)
|
|
#define FELICA_TIME_SLOT_8 (0x07U)
|
|
#define FELICA_TIME_SLOT_16 (0x0FU)
|
|
|
|
#define FELICA_CMD_LIST_SERVICE_CODE 0x0A
|
|
#define FELICA_CMD_LIST_SERVICE_CODE_RESP 0x0B
|
|
#define FELICA_CMD_REQUEST_SYSTEM_CODE 0x0C
|
|
#define FELICA_CMD_REQUEST_SYSTEM_CODE_RESP 0x0D
|
|
|
|
#define FELICA_SERVICE_ATTRIBUTE_UNAUTH_READ (0b000001)
|
|
#define FELICA_SERVICE_ATTRIBUTE_READ_ONLY (0b000010)
|
|
#define FELICA_SERVICE_ATTRIBUTE_RANDOM_ACCESS (0b001000)
|
|
#define FELICA_SERVICE_ATTRIBUTE_CYCLIC (0b001100)
|
|
#define FELICA_SERVICE_ATTRIBUTE_PURSE (0b010000)
|
|
#define FELICA_SERVICE_ATTRIBUTE_PURSE_SUBFIELD (0b000110)
|
|
|
|
/** @brief Type of possible Felica errors */
|
|
typedef enum {
|
|
FelicaErrorNone,
|
|
FelicaErrorNotPresent,
|
|
FelicaErrorColResFailed,
|
|
FelicaErrorBufferOverflow,
|
|
FelicaErrorCommunication,
|
|
FelicaErrorFieldOff,
|
|
FelicaErrorWrongCrc,
|
|
FelicaErrorProtocol,
|
|
FelicaErrorTimeout,
|
|
FelicaErrorFeatureUnsupported,
|
|
} FelicaError;
|
|
|
|
typedef enum {
|
|
FelicaUnknown,
|
|
FelicaStandard,
|
|
FelicaLite,
|
|
} FelicaWorkflowType;
|
|
|
|
typedef struct {
|
|
uint8_t data[FELICA_DATA_BLOCK_SIZE];
|
|
} FelicaBlockData;
|
|
|
|
/** @brief Separate type for card key block. Used in authentication process */
|
|
typedef struct {
|
|
uint8_t data[FELICA_DATA_BLOCK_SIZE];
|
|
} FelicaCardKey;
|
|
|
|
/** @brief In Felica there two types of auth. Internal is the first one, after
|
|
* which external became possible. Here are two flags representing which one
|
|
* was passed */
|
|
typedef struct {
|
|
bool internal : 1;
|
|
bool external : 1;
|
|
} FelicaAuthenticationStatus;
|
|
|
|
/** @brief Struct which controls the process of authentication and can be passed as
|
|
* a parameter to the application level. In order to force user to fill card key block data. */
|
|
typedef struct {
|
|
bool skip_auth; /**< By default it is true, so auth is skipped. By setting this to false several auth steps will be performed in order to pass auth*/
|
|
FelicaCardKey
|
|
card_key; /**< User must fill this field with known card key in order to pass auth*/
|
|
FelicaAuthenticationStatus auth_status; /**< Authentication status*/
|
|
} FelicaAuthenticationContext;
|
|
|
|
/**
|
|
* @brief Stucture for holding Felica session key which is calculated from rc and ck.
|
|
*/
|
|
typedef struct {
|
|
uint8_t data[FELICA_DATA_BLOCK_SIZE];
|
|
} FelicaSessionKey;
|
|
|
|
/**
|
|
* @brief Structure used to hold authentication related fields.
|
|
*/
|
|
typedef struct {
|
|
mbedtls_des3_context des_context; /**< Context for mbedtls des functions. */
|
|
FelicaSessionKey session_key; /**< Calculated session key. */
|
|
FelicaAuthenticationContext context; /**< Public auth context provided to upper levels. */
|
|
} FelicaAuthentication;
|
|
|
|
/** @brief Felica ID block */
|
|
typedef struct {
|
|
uint8_t data[FELICA_IDM_SIZE];
|
|
} FelicaIDm;
|
|
|
|
/** @brief Felica PMm block */
|
|
typedef struct {
|
|
uint8_t data[FELICA_PMM_SIZE];
|
|
} FelicaPMm;
|
|
|
|
/** @brief Felica block with status flags indicating last operation with it.
|
|
* See Felica manual for more details on status codes. */
|
|
typedef struct {
|
|
uint8_t SF1; /**< Status flag 1, equals to 0 when success*/
|
|
uint8_t SF2; /**< Status flag 2, equals to 0 when success*/
|
|
uint8_t data[FELICA_DATA_BLOCK_SIZE]; /**< Block data */
|
|
} FelicaBlock;
|
|
|
|
/** @brief Felica filesystem structure */
|
|
typedef struct {
|
|
FelicaBlock spad[14];
|
|
FelicaBlock reg;
|
|
FelicaBlock rc;
|
|
FelicaBlock mac;
|
|
FelicaBlock id;
|
|
FelicaBlock d_id;
|
|
FelicaBlock ser_c;
|
|
FelicaBlock sys_c;
|
|
FelicaBlock ckv;
|
|
FelicaBlock ck;
|
|
FelicaBlock mc;
|
|
FelicaBlock wcnt;
|
|
FelicaBlock mac_a;
|
|
FelicaBlock state;
|
|
FelicaBlock crc_check;
|
|
} FelicaFileSystem;
|
|
|
|
/** @brief Union which represents filesystem in junction with plain data dump */
|
|
typedef union {
|
|
FelicaFileSystem fs;
|
|
uint8_t dump[sizeof(FelicaFileSystem)];
|
|
} FelicaFSUnion;
|
|
|
|
typedef struct {
|
|
uint16_t code;
|
|
uint8_t attr;
|
|
} FelicaService;
|
|
|
|
typedef struct {
|
|
uint16_t code;
|
|
uint16_t first_idx;
|
|
uint16_t last_idx;
|
|
} FelicaArea;
|
|
|
|
typedef struct {
|
|
FelicaBlock block;
|
|
uint16_t service_code;
|
|
uint8_t block_idx;
|
|
} FelicaPublicBlock;
|
|
|
|
typedef struct {
|
|
uint8_t system_code_idx;
|
|
uint16_t system_code;
|
|
SimpleArray* services;
|
|
SimpleArray* areas;
|
|
SimpleArray* public_blocks;
|
|
} FelicaSystem;
|
|
|
|
/** @brief Structure used to store Felica data and additional values about reading */
|
|
typedef struct {
|
|
FelicaIDm idm;
|
|
FelicaPMm pmm;
|
|
uint8_t blocks_total;
|
|
uint8_t blocks_read;
|
|
FelicaFSUnion data;
|
|
|
|
SimpleArray* systems;
|
|
|
|
FelicaWorkflowType workflow_type;
|
|
} FelicaData;
|
|
|
|
typedef struct FURI_PACKED {
|
|
uint8_t code;
|
|
FelicaIDm idm;
|
|
uint8_t service_num;
|
|
uint16_t service_code;
|
|
uint8_t block_count;
|
|
} FelicaCommandHeader;
|
|
|
|
typedef struct {
|
|
uint8_t length;
|
|
uint8_t response_code;
|
|
FelicaIDm idm;
|
|
uint8_t SF1;
|
|
uint8_t SF2;
|
|
} FelicaCommandResponseHeader;
|
|
|
|
#pragma pack(push, 1)
|
|
typedef struct {
|
|
uint8_t length;
|
|
uint8_t command;
|
|
FelicaIDm idm;
|
|
} FelicaCommandHeaderRaw;
|
|
#pragma pack(pop)
|
|
|
|
typedef struct {
|
|
uint8_t service_code : 4;
|
|
uint8_t access_mode : 3;
|
|
uint8_t length : 1;
|
|
uint8_t block_number;
|
|
} FelicaBlockListElement;
|
|
|
|
typedef struct {
|
|
uint8_t length;
|
|
uint8_t response_code;
|
|
FelicaIDm idm;
|
|
uint8_t SF1;
|
|
uint8_t SF2;
|
|
uint8_t block_count;
|
|
uint8_t data[];
|
|
} FelicaPollerReadCommandResponse;
|
|
|
|
typedef struct {
|
|
FelicaCommandResponseHeader header;
|
|
uint8_t block_count;
|
|
uint8_t data[];
|
|
} FelicaListenerReadCommandResponse;
|
|
|
|
typedef struct {
|
|
FelicaCommandHeaderRaw header;
|
|
uint8_t data[];
|
|
} FelicaListServiceCommandResponse;
|
|
|
|
typedef struct {
|
|
FelicaCommandHeaderRaw header;
|
|
uint8_t system_count;
|
|
uint8_t system_code[];
|
|
} FelicaListSystemCodeCommandResponse;
|
|
|
|
typedef FelicaCommandResponseHeader FelicaListenerWriteCommandResponse;
|
|
|
|
typedef FelicaCommandResponseHeader FelicaPollerWriteCommandResponse;
|
|
|
|
extern const NfcDeviceBase nfc_device_felica;
|
|
|
|
FelicaData* felica_alloc(void);
|
|
|
|
void felica_free(FelicaData* data);
|
|
|
|
void felica_reset(FelicaData* data);
|
|
|
|
void felica_copy(FelicaData* data, const FelicaData* other);
|
|
|
|
bool felica_verify(FelicaData* data, const FuriString* device_type);
|
|
|
|
bool felica_load(FelicaData* data, FlipperFormat* ff, uint32_t version);
|
|
|
|
bool felica_save(const FelicaData* data, FlipperFormat* ff);
|
|
|
|
bool felica_is_equal(const FelicaData* data, const FelicaData* other);
|
|
|
|
const char* felica_get_device_name(const FelicaData* data, NfcDeviceNameType name_type);
|
|
|
|
const uint8_t* felica_get_uid(const FelicaData* data, size_t* uid_len);
|
|
|
|
bool felica_set_uid(FelicaData* data, const uint8_t* uid, size_t uid_len);
|
|
|
|
FelicaData* felica_get_base_data(const FelicaData* data);
|
|
|
|
void felica_calculate_session_key(
|
|
mbedtls_des3_context* ctx,
|
|
const uint8_t* ck,
|
|
const uint8_t* rc,
|
|
uint8_t* out);
|
|
|
|
bool felica_check_mac(
|
|
mbedtls_des3_context* ctx,
|
|
const uint8_t* session_key,
|
|
const uint8_t* rc,
|
|
const uint8_t* blocks,
|
|
const uint8_t block_count,
|
|
uint8_t* data);
|
|
|
|
void felica_calculate_mac_read(
|
|
mbedtls_des3_context* ctx,
|
|
const uint8_t* session_key,
|
|
const uint8_t* rc,
|
|
const uint8_t* blocks,
|
|
const uint8_t block_count,
|
|
const uint8_t* data,
|
|
uint8_t* mac);
|
|
|
|
void felica_calculate_mac_write(
|
|
mbedtls_des3_context* ctx,
|
|
const uint8_t* session_key,
|
|
const uint8_t* rc,
|
|
const uint8_t* wcnt,
|
|
const uint8_t* data,
|
|
uint8_t* mac);
|
|
|
|
void felica_write_directory_tree(const FelicaSystem* system, FuriString* str);
|
|
|
|
void felica_get_workflow_type(FelicaData* data);
|
|
|
|
void felica_get_ic_name(const FelicaData* data, FuriString* ic_name);
|
|
|
|
void felica_service_get_attribute_string(const FelicaService* service, FuriString* str);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|