view service/cardReader/pyfreefare/freefare.h @ 725:1ecceb2e92a3

rename rfid_pn532_py Ignore-this: 89356f780bb5df4d9ec639c44d2a3a67
author drewp@bigasterisk.com
date Wed, 05 Feb 2020 16:40:46 -0800
parents service/rfid_pn532_py/pyfreefare/freefare.h@19ef0ac8f7f7
children
line wrap: on
line source


#ifndef __FREEFARE_H__
#define __FREEFARE_H__

#include <sys/types.h>

#include <stdint.h>

#include <nfc/nfc.h>

#ifdef __cplusplus
extern "C" {
#endif // __cplusplus

enum freefare_tag_type {
    FELICA,
    MIFARE_MINI,
    MIFARE_CLASSIC_1K,
    MIFARE_CLASSIC_4K,
    MIFARE_DESFIRE,
//    MIFARE_PLUS_S2K,
//    MIFARE_PLUS_S4K,
//    MIFARE_PLUS_X2K,
//    MIFARE_PLUS_X4K,
    MIFARE_ULTRALIGHT,
    MIFARE_ULTRALIGHT_C,
    NTAG_21x,
};
  typedef enum freefare_tag_type freefare_tag_type;
  
struct freefare_tag;
typedef struct freefare_tag *FreefareTag;

/* Replace any MifareTag by the generic FreefareTag. */
typedef struct freefare_tag *MifareTag;

struct mifare_desfire_key;
typedef struct mifare_desfire_key *MifareDESFireKey;

struct ntag21x_key;
typedef struct ntag21x_key *NTAG21xKey;

typedef uint8_t MifareUltralightPageNumber;
typedef unsigned char MifareUltralightPage[4];

FreefareTag	*freefare_get_tags(nfc_device *device);
FreefareTag	 freefare_tag_new(nfc_device *device, nfc_target target);
freefare_tag_type freefare_get_tag_type(FreefareTag tag);
const char	*freefare_get_tag_friendly_name(FreefareTag tag);
char		*freefare_get_tag_uid(FreefareTag tag);
void		 freefare_free_tag(FreefareTag tag);
void		 freefare_free_tags(FreefareTag *tags);
bool		 freefare_selected_tag_is_present(nfc_device *device);

const char	*freefare_strerror(FreefareTag tag);
int		 freefare_strerror_r(FreefareTag tag, char *buffer, size_t len);
void		 freefare_perror(FreefareTag tag, const char *string);



  // bool		 felica_taste(nfc_device *device, nfc_target target);

  // #define FELICA_SC_RW 0x0009
// #define FELICA_SC_RO 0x000b
// 
// FreefareTag	 felica_tag_new(nfc_device *device, nfc_target target);
// void		 felica_tag_free(FreefareTag tag);
// 
// ssize_t		 felica_read(FreefareTag tag, uint16_t service, uint8_t block, uint8_t *data, size_t length);
// ssize_t		 felica_read_ex(FreefareTag tag, uint16_t service, uint8_t block_count, uint8_t blocks[], uint8_t *data, size_t length);
// ssize_t		 felica_write(FreefareTag tag, uint16_t service, uint8_t block, uint8_t *data, size_t length);
// ssize_t		 felica_write_ex(FreefareTag tag, uint16_t service, uint8_t block_count, uint8_t blocks[], uint8_t *data, size_t length);
// 
// 
// 
// bool		 mifare_ultralight_taste(nfc_device *device, nfc_target target);
// bool		 mifare_ultralightc_taste(nfc_device *device, nfc_target target);
// FreefareTag	 mifare_ultralight_tag_new(nfc_device *device, nfc_target target);
// FreefareTag	 mifare_ultralightc_tag_new(nfc_device *device, nfc_target target);
// void		 mifare_ultralight_tag_free(FreefareTag tag);
// void		 mifare_ultralightc_tag_free(FreefareTag tag);
// 
// int		 mifare_ultralight_connect(FreefareTag tag);
// int		 mifare_ultralight_disconnect(FreefareTag tag);
// 
// int		 mifare_ultralight_read(FreefareTag tag, const MifareUltralightPageNumber page, MifareUltralightPage *data);
// int		 mifare_ultralight_write(FreefareTag tag, const MifareUltralightPageNumber page, const MifareUltralightPage data);
// 
// int		 mifare_ultralightc_authenticate(FreefareTag tag, const MifareDESFireKey key);
// int		 mifare_ultralightc_set_key(FreefareTag tag, MifareDESFireKey key);
// bool		 is_mifare_ultralight(FreefareTag tag);
// bool		 is_mifare_ultralightc(FreefareTag tag);
// bool		 is_mifare_ultralightc_on_reader(nfc_device *device, nfc_iso14443a_info nai);
// 
// 
// 
// bool		 ntag21x_taste(nfc_device *device, nfc_target target);
// uint8_t		 ntag21x_last_error(FreefareTag tag);
// 
// /* NTAG21x access features */
// #define NTAG_PROT 0x80
// #define NTAG_CFGLCK 0x40
// #define NTAG_NFC_CNT_EN 0x20
// #define NTAG_NFC_CNT_PWD_PROT 0x10
// #define NTAG_AUTHLIM 0x07
// 
// enum ntag_tag_subtype {
//     NTAG_UNKNOWN,
//     NTAG_213,
//     NTAG_215,
//     NTAG_216
// };
// 
// FreefareTag	 ntag21x_tag_new(nfc_device *device, nfc_target target);
// FreefareTag	 ntag21x_tag_reuse(FreefareTag tag);  /* Copy data from Ultralight tag to new NTAG21x, don't forget to free your old tag */
// NTAG21xKey	 ntag21x_key_new(const uint8_t data[4], const uint8_t pack[2]); /* Create new key */
// void		 ntag21x_key_free(NTAG21xKey key);  /* Clear key from memory */
// void		 ntag21x_tag_free(FreefareTag tag);
// int		 ntag21x_connect(FreefareTag tag);
// int		 ntag21x_disconnect(FreefareTag tag);
// int		 ntag21x_get_info(FreefareTag tag);  /* Get all information about tag (size,vendor ...) */
// enum  ntag_tag_subtype ntag21x_get_subtype(FreefareTag tag);  /* Get subtype of tag */
// uint8_t		 ntag21x_get_last_page(FreefareTag tag);  /* Get last page address based on gathered info from function above */
// int		 ntag21x_read_signature(FreefareTag tag, uint8_t *data); /* Get tag signature */
// int		 ntag21x_set_pwd(FreefareTag tag, uint8_t data[4]);  /* Set password */
// int		 ntag21x_set_pack(FreefareTag tag, uint8_t data[2]);  /* Set pack */
// int		 ntag21x_set_key(FreefareTag tag, const NTAG21xKey key); /* Set key */
// int		 ntag21x_set_auth(FreefareTag tag, uint8_t byte); /* Set AUTH0 byte (from which page starts password protection) */
// int		 ntag21x_get_auth(FreefareTag tag, uint8_t *byte); /* Get AUTH0 byte */
// int		 ntag21x_access_enable(FreefareTag tag, uint8_t byte); /* Enable access feature in ACCESS byte */
// int		 ntag21x_access_disable(FreefareTag tag, uint8_t byte); /* Disable access feature in ACCESS byte */
// int		 ntag21x_get_access(FreefareTag tag, uint8_t *byte); /* Get ACCESS byte */
// int		 ntag21x_check_access(FreefareTag tag, uint8_t byte, bool *result); /* Check if access feature is enabled */
// int		 ntag21x_get_authentication_limit(FreefareTag tag, uint8_t *byte); /* Get authentication limit */
// int		 ntag21x_set_authentication_limit(FreefareTag tag, uint8_t byte); /* Set authentication limit (0x00 = disabled, [0x01,0x07] = valid range, > 0x07 invalid range) */
// int		 ntag21x_read(FreefareTag tag, uint8_t page, uint8_t *data); /* Read 16 bytes starting from page */
// int		 ntag21x_read4(FreefareTag tag, uint8_t page, uint8_t *data); /* Read 4 bytes on page */
// int		 ntag21x_fast_read(FreefareTag tag, uint8_t start_page, uint8_t end_page, uint8_t *data); /* Read n*4 bytes from range [start_page,end_page] */
// int		 ntag21x_fast_read4(FreefareTag tag, uint8_t page, uint8_t *data); /* Fast read certain page */
// int		 ntag21x_read_cnt(FreefareTag tag, uint8_t *data);  /* Read 3-byte NFC counter if enabled else it returns error */
// int		 ntag21x_write(FreefareTag tag, uint8_t page, uint8_t data[4]);  /* Write 4 bytes to page */
// int		 ntag21x_compatibility_write(FreefareTag tag, uint8_t page, uint8_t data[4]);  /* Writes 4 bytes to page with mifare classic write */
// int		 ntag21x_authenticate(FreefareTag tag, const NTAG21xKey key);  /* Authenticate with tag */
// bool		 is_ntag21x(FreefareTag tag);  /* Check if tag type is NTAG21x */
// bool		 ntag21x_is_auth_supported(nfc_device *device, nfc_iso14443a_info nai);  /* Check if tag supports 21x commands */
// 
// 
// 
// bool             mifare_mini_taste(nfc_device *device, nfc_target target);
// bool		 mifare_classic1k_taste(nfc_device *device, nfc_target target);
// bool		 mifare_classic4k_taste(nfc_device *device, nfc_target target);
// FreefareTag      mifare_mini_tag_new(nfc_device *device, nfc_target target);
// FreefareTag	 mifare_classic1k_tag_new(nfc_device *device, nfc_target target);
// FreefareTag	 mifare_classic4k_tag_new(nfc_device *device, nfc_target target);
void		 mifare_classic_tag_free(FreefareTag tag);
// 
typedef unsigned char MifareClassicBlock[16];

typedef uint8_t MifareClassicSectorNumber;
typedef unsigned char MifareClassicBlockNumber;

typedef enum { MFC_KEY_A, MFC_KEY_B } MifareClassicKeyType;
typedef unsigned char MifareClassicKey[6];

/* NFC Forum public key */
extern const MifareClassicKey mifare_classic_nfcforum_public_key_a;

int		 mifare_classic_connect(FreefareTag tag);
int		 mifare_classic_disconnect(FreefareTag tag);

int		 mifare_classic_authenticate(FreefareTag tag, const MifareClassicBlockNumber block, const MifareClassicKey key, const MifareClassicKeyType key_type);
int		 mifare_classic_read(FreefareTag tag, const MifareClassicBlockNumber block, MifareClassicBlock *data);
int		 mifare_classic_init_value(FreefareTag tag, const MifareClassicBlockNumber block, const int32_t value, const MifareClassicBlockNumber adr);
int		 mifare_classic_read_value(FreefareTag tag, const MifareClassicBlockNumber block, int32_t *value, MifareClassicBlockNumber *adr);
int		 mifare_classic_write(FreefareTag tag, const MifareClassicBlockNumber block, const MifareClassicBlock data);

int		 mifare_classic_increment(FreefareTag tag, const MifareClassicBlockNumber block, const uint32_t amount);
int		 mifare_classic_decrement(FreefareTag tag, const MifareClassicBlockNumber block, const uint32_t amount);
int		 mifare_classic_restore(FreefareTag tag, const MifareClassicBlockNumber block);
int		 mifare_classic_transfer(FreefareTag tag, const MifareClassicBlockNumber block);

int		 mifare_classic_get_trailer_block_permission(FreefareTag tag, const MifareClassicBlockNumber block, const uint16_t permission, const MifareClassicKeyType key_type);
int		 mifare_classic_get_data_block_permission(FreefareTag tag, const MifareClassicBlockNumber block, const unsigned char permission, const MifareClassicKeyType key_type);

int		 mifare_classic_format_sector(FreefareTag tag, const MifareClassicSectorNumber sector);

void		 mifare_classic_trailer_block(MifareClassicBlock *block, const MifareClassicKey key_a, uint8_t ab_0, uint8_t ab_1, uint8_t ab_2, uint8_t ab_tb, const uint8_t gpb, const MifareClassicKey key_b);

MifareClassicSectorNumber mifare_classic_block_sector(MifareClassicBlockNumber block);
MifareClassicBlockNumber  mifare_classic_sector_first_block(MifareClassicSectorNumber sector);
size_t		 mifare_classic_sector_block_count(MifareClassicSectorNumber sector);
MifareClassicBlockNumber  mifare_classic_sector_last_block(MifareClassicSectorNumber sector);

#define C_000 0
#define C_001 1
#define C_010 2
#define C_011 3
#define C_100 4
#define C_101 5
#define C_110 6
#define C_111 7
#define C_DEFAULT 255

/* MIFARE Classic Access Bits */
#define MCAB_R 0x8
#define MCAB_W 0x4
#define MCAB_D 0x2
#define MCAB_I 0x1

#define MCAB_READ_KEYA         0x400
#define MCAB_WRITE_KEYA        0x100
#define MCAB_READ_ACCESS_BITS  0x040
#define MCAB_WRITE_ACCESS_BITS 0x010
#define MCAB_READ_KEYB         0x004
#define MCAB_WRITE_KEYB        0x001
// 
// struct mad_aid {
//     uint8_t application_code;
//     uint8_t function_cluster_code;
// };
// typedef struct mad_aid MadAid;
// 
// struct mad;
// typedef struct mad *Mad;
// 
// /* MAD Public read key A */
// extern const MifareClassicKey mad_public_key_a;
// 
// /* AID - Adminisration codes */
// extern const MadAid mad_free_aid;
// extern const MadAid mad_defect_aid;
// extern const MadAid mad_reserved_aid;
// extern const MadAid mad_card_holder_aid;
// extern const MadAid mad_not_applicable_aid;
// 
// /* NFC Forum AID */
// extern const MadAid mad_nfcforum_aid;
// 
// Mad		 mad_new(const uint8_t version);
// Mad		 mad_read(FreefareTag tag);
// int		 mad_write(FreefareTag tag, Mad mad, const MifareClassicKey key_b_sector_00, const MifareClassicKey key_b_sector_10);
// int		 mad_get_version(Mad mad);
// void		 mad_set_version(Mad mad, const uint8_t version);
// MifareClassicSectorNumber mad_get_card_publisher_sector(Mad mad);
// int		 mad_set_card_publisher_sector(Mad mad, const MifareClassicSectorNumber cps);
// int		 mad_get_aid(Mad mad, const MifareClassicSectorNumber sector, MadAid *aid);
// int		 mad_set_aid(Mad mad, const MifareClassicSectorNumber sector, MadAid aid);
// bool		 mad_sector_reserved(const MifareClassicSectorNumber sector);
// void		 mad_free(Mad mad);
// 
// MifareClassicSectorNumber *mifare_application_alloc(Mad mad, const MadAid aid, const size_t size);
// ssize_t		 mifare_application_read(FreefareTag tag, Mad mad, const MadAid aid, void *buf, size_t nbytes, const MifareClassicKey key, const MifareClassicKeyType key_type);
// ssize_t		 mifare_application_write(FreefareTag tag, Mad mad, const MadAid aid, const void *buf, size_t nbytes, const MifareClassicKey key, const MifareClassicKeyType key_type);
// int		 mifare_application_free(Mad mad, const MadAid aid);
// 
// MifareClassicSectorNumber *mifare_application_find(Mad mad, const MadAid aid);
// 
// 
// 
// bool		 mifare_desfire_taste(nfc_device *device, nfc_target target);
// 
// /* File types */
// 
// enum mifare_desfire_file_types {
//     MDFT_STANDARD_DATA_FILE             = 0x00,
//     MDFT_BACKUP_DATA_FILE               = 0x01,
//     MDFT_VALUE_FILE_WITH_BACKUP         = 0x02,
//     MDFT_LINEAR_RECORD_FILE_WITH_BACKUP = 0x03,
//     MDFT_CYCLIC_RECORD_FILE_WITH_BACKUP = 0x04
// };
// 
// /* Communication mode */
// 
// #define MDCM_PLAIN      0x00
// #define MDCM_MACED      0x01
// #define MDCM_ENCIPHERED 0x03
// 
// /* Mifare DESFire master key settings
// bit 7 - 4: Always 0.
// bit 3: PICC master key settings frozen = 0 (WARNING - this is irreversible); PICC master key settings changeable when authenticated with PICC master key = 1
// bit 2: PICC master key authentication required for creating or deleting applications = 0; Authentication not required = 1
// bit 1: PICC master key authentication required for listing of applications or reading key settings = 0; Free listing of applications and reading key settings = 1
// bit 0: PICC master key frozen (reversible with configuration change or when formatting card) = 0; PICC master key changeable = 1
// */
// 
// #define MDMK_SETTINGS(picc_master_key_settings_changeable,free_create_delete_application,free_listing_apps_and_key_settings,picc_master_key_changeable) ( \
// 	(picc_master_key_settings_changeable << 3) | \
// 	(free_create_delete_application << 2) | \
// 	(free_listing_apps_and_key_settings << 1) | \
// 	(picc_master_key_changeable) \
// 																			)
// 
// /* Mifare DESFire EV1 Application crypto operations */
// 
// #define APPLICATION_CRYPTO_DES    0x00
// #define APPLICATION_CRYPTO_3K3DES 0x40
// #define APPLICATION_CRYPTO_AES    0x80
// 
// /* Mifare DESFire Application settings
//  * bit 7 - 4: Number of key needed to change application keys (key 0 - 13; 0 = master key; 14 = key itself required for key change; 15 = all keys are frozen)
//  * bit 3: Application configuration frozen = 0; Application configuration changeable when authenticated with application master key = 1
//  * bit 2: Application master key authentication required for create/delete files = 0; Authentication not required = 1
//  * bit 1: GetFileIDs, GetFileSettings and GetKeySettings behavior: Master key authentication required = 0; No authentication required = 1
//  * bit 0 = Application master key frozen = 0; Application master key changeable = 1
//  */
// 
// #define MDAPP_SETTINGS(key_no_for_key_changing,config_changeable,free_create_delete_files,free_listing_contents,app_master_key_changeable) ( \
// 	(key_no_for_key_changing << 4) | \
// 	(config_changeable << 3) | \
// 	(free_create_delete_files << 2) | \
// 	(free_listing_contents << 1) | \
// 	(app_master_key_changeable) \
// 																	   )
// 
// /* Access right */
// 
// #define MDAR(read,write,read_write,change_access_rights) (    \
// 	(read << 12) | \
// 	(write << 8) | \
// 	(read_write << 4) | \
// 	(change_access_rights) \
// 							 )
// 
// #define MDAR_READ(ar)       (((ar) >> 12) & 0x0f)
// #define MDAR_WRITE(ar)      (((ar) >>  8) & 0x0f)
// #define MDAR_READ_WRITE(ar) (((ar) >>  4) & 0x0f)
// #define MDAR_CHANGE_AR(ar)  ((ar)         & 0x0f)
// 
// #define MDAR_KEY0  0x0
// #define MDAR_KEY1  0x1
// #define MDAR_KEY2  0x2
// #define MDAR_KEY3  0x3
// #define MDAR_KEY4  0x4
// #define MDAR_KEY5  0x5
// #define MDAR_KEY6  0x6
// #define MDAR_KEY7  0x7
// #define MDAR_KEY8  0x8
// #define MDAR_KEY9  0x9
// #define MDAR_KEY10 0xa
// #define MDAR_KEY11 0xb
// #define MDAR_KEY12 0xc
// #define MDAR_KEY13 0xd
// #define MDAR_FREE  0xE
// #define MDAR_DENY  0xF
// 
// /* Status and error codes */
// 
// #define	OPERATION_OK		0x00
// #define	NO_CHANGES		0x0C
// #define	OUT_OF_EEPROM_ERROR	0x0E
// #define	ILLEGAL_COMMAND_CODE	0x1C
// #define	INTEGRITY_ERROR		0x1E
// #define	NO_SUCH_KEY		0x40
// #define	LENGTH_ERROR		0x7E
// #define	PERMISSION_ERROR	0x9D
// #define	PARAMETER_ERROR		0x9E
// #define	APPLICATION_NOT_FOUND	0xA0
// #define	APPL_INTEGRITY_ERROR	0xA1
// #define	AUTHENTICATION_ERROR	0xAE
// #define	ADDITIONAL_FRAME	0xAF
// #define	BOUNDARY_ERROR		0xBE
// #define	PICC_INTEGRITY_ERROR	0xC1
// #define	COMMAND_ABORTED		0xCA
// #define	PICC_DISABLED_ERROR	0xCD
// #define	COUNT_ERROR		0xCE
// #define	DUPLICATE_ERROR		0xDE
// #define	EEPROM_ERROR		0xEE
// #define	FILE_NOT_FOUND		0xF0
// #define	FILE_INTEGRITY_ERROR	0xF1
// 
// /* Error code managed by the library */
// 
// #define CRYPTO_ERROR            0x01
// #define TAG_INFO_MISSING_ERROR	0xBA
// #define UNKNOWN_TAG_TYPE_ERROR	0xBB
// 
// struct mifare_desfire_aid;
// typedef struct mifare_desfire_aid *MifareDESFireAID;
// 
// struct mifare_desfire_df {
//     uint32_t aid;
//     uint16_t fid;
//     uint8_t df_name[16];
//     size_t df_name_len;
// };
// typedef struct mifare_desfire_df MifareDESFireDF;
// 
// MifareDESFireAID mifare_desfire_aid_new(uint32_t aid);
// MifareDESFireAID mifare_desfire_aid_new_with_mad_aid(MadAid mad_aid, uint8_t n);
// uint32_t	 mifare_desfire_aid_get_aid(MifareDESFireAID aid);
// 
// uint8_t		 mifare_desfire_last_pcd_error(FreefareTag tag);
// uint8_t		 mifare_desfire_last_picc_error(FreefareTag tag);
// 
// #pragma pack (push)
// #pragma pack (1)
// struct mifare_desfire_version_info {
//     struct {
// 	uint8_t vendor_id;
// 	uint8_t type;
// 	uint8_t subtype;
// 	uint8_t version_major;
// 	uint8_t version_minor;
// 	uint8_t storage_size;
// 	uint8_t protocol;
//     } hardware;
//     struct {
// 	uint8_t vendor_id;
// 	uint8_t type;
// 	uint8_t subtype;
// 	uint8_t version_major;
// 	uint8_t version_minor;
// 	uint8_t storage_size;
// 	uint8_t protocol;
//     } software;
//     uint8_t uid[7];
//     uint8_t batch_number[5];
//     uint8_t production_week;
//     uint8_t production_year;
// };
// #pragma pack (pop)
// 
// struct mifare_desfire_file_settings {
//     uint8_t file_type;
//     uint8_t communication_settings;
//     uint16_t access_rights;
//     union {
// 	struct {
// 	    uint32_t file_size;
// 	} standard_file;
// 	struct {
// 	    int32_t lower_limit;
// 	    int32_t upper_limit;
// 	    int32_t limited_credit_value;
// 	    uint8_t limited_credit_enabled;
// 	} value_file;
// 	struct {
// 	    uint32_t record_size;
// 	    uint32_t max_number_of_records;
// 	    uint32_t current_number_of_records;
// 	} linear_record_file;
//     } settings;
// };
// 
// FreefareTag	 mifare_desfire_tag_new(nfc_device *device, nfc_target target);
// void		 mifare_desfire_tag_free(FreefareTag tags);
// 
// int		 mifare_desfire_connect(FreefareTag tag);
// int		 mifare_desfire_disconnect(FreefareTag tag);
// 
// int		 mifare_desfire_authenticate(FreefareTag tag, uint8_t key_no, MifareDESFireKey key);
// int		 mifare_desfire_authenticate_iso(FreefareTag tag, uint8_t key_no, MifareDESFireKey key);
// int		 mifare_desfire_authenticate_aes(FreefareTag tag, uint8_t key_no, MifareDESFireKey key);
// int		 mifare_desfire_change_key_settings(FreefareTag tag, uint8_t settings);
// int		 mifare_desfire_get_key_settings(FreefareTag tag, uint8_t *settings, uint8_t *max_keys);
// int		 mifare_desfire_change_key(FreefareTag tag, uint8_t key_no, MifareDESFireKey new_key, MifareDESFireKey old_key);
// int		 mifare_desfire_get_key_version(FreefareTag tag, uint8_t key_no, uint8_t *version);
// int		 mifare_desfire_create_application(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no);
// int		 mifare_desfire_create_application_3k3des(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no);
// int		 mifare_desfire_create_application_aes(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no);
// 
// int		 mifare_desfire_create_application_iso(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no, int want_iso_file_identifiers, uint16_t iso_file_id, uint8_t *iso_file_name, size_t iso_file_name_len);
// int		 mifare_desfire_create_application_3k3des_iso(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no, int want_iso_file_identifiers, uint16_t iso_file_id, uint8_t *iso_file_name, size_t iso_file_name_len);
// int		 mifare_desfire_create_application_aes_iso(FreefareTag tag, MifareDESFireAID aid, uint8_t settings, uint8_t key_no, int want_iso_file_identifiers, uint16_t iso_file_id, uint8_t *iso_file_name, size_t iso_file_name_len);
// 
// int		 mifare_desfire_delete_application(FreefareTag tag, MifareDESFireAID aid);
// int		 mifare_desfire_get_application_ids(FreefareTag tag, MifareDESFireAID *aids[], size_t *count);
// int		 mifare_desfire_get_df_names(FreefareTag tag, MifareDESFireDF *dfs[], size_t *count);
// void		 mifare_desfire_free_application_ids(MifareDESFireAID aids[]);
// int		 mifare_desfire_select_application(FreefareTag tag, MifareDESFireAID aid);
// int		 mifare_desfire_format_picc(FreefareTag tag);
// int		 mifare_desfire_get_version(FreefareTag tag, struct mifare_desfire_version_info *version_info);
// int		 mifare_desfire_free_mem(FreefareTag tag, uint32_t *size);
// int		 mifare_desfire_set_configuration(FreefareTag tag, bool disable_format, bool enable_random_uid);
// int		 mifare_desfire_set_default_key(FreefareTag tag, MifareDESFireKey key);
// int		 mifare_desfire_set_ats(FreefareTag tag, uint8_t *ats);
// int		 mifare_desfire_get_card_uid(FreefareTag tag, char **uid);
// int		 mifare_desfire_get_card_uid_raw(FreefareTag tag, uint8_t uid[7]);
// int		 mifare_desfire_get_file_ids(FreefareTag tag, uint8_t **files, size_t *count);
// int		 mifare_desfire_get_iso_file_ids(FreefareTag tag, uint16_t **files, size_t *count);
// int		 mifare_desfire_get_file_settings(FreefareTag tag, uint8_t file_no, struct mifare_desfire_file_settings *settings);
// int		 mifare_desfire_change_file_settings(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights);
// int		 mifare_desfire_create_std_data_file(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t file_size);
// int		 mifare_desfire_create_std_data_file_iso(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t file_size, uint16_t iso_file_id);
// int		 mifare_desfire_create_backup_data_file(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t file_size);
// int		 mifare_desfire_create_backup_data_file_iso(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t file_size, uint16_t iso_file_id);
// int		 mifare_desfire_create_value_file(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enable);
// int		 mifare_desfire_create_linear_record_file(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t record_size, uint32_t max_number_of_records);
// int		 mifare_desfire_create_linear_record_file_iso(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t record_size, uint32_t max_number_of_records, uint16_t iso_file_id);
// int		 mifare_desfire_create_cyclic_record_file(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t record_size, uint32_t max_number_of_records);
// int		 mifare_desfire_create_cyclic_record_file_iso(FreefareTag tag, uint8_t file_no, uint8_t communication_settings, uint16_t access_rights, uint32_t record_size, uint32_t max_number_of_records, uint16_t iso_file_id);
// int		 mifare_desfire_delete_file(FreefareTag tag, uint8_t file_no);
// 
// ssize_t		 mifare_desfire_read_data(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data);
// ssize_t		 mifare_desfire_read_data_ex(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data, int cs);
// ssize_t		 mifare_desfire_write_data(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, const void *data);
// ssize_t		 mifare_desfire_write_data_ex(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, const void *data, int cs);
// int		 mifare_desfire_get_value(FreefareTag tag, uint8_t file_no, int32_t *value);
// int		 mifare_desfire_get_value_ex(FreefareTag tag, uint8_t file_no, int32_t *value, int cs);
// int		 mifare_desfire_credit(FreefareTag tag, uint8_t file_no, int32_t amount);
// int		 mifare_desfire_credit_ex(FreefareTag tag, uint8_t file_no, int32_t amount, int cs);
// int		 mifare_desfire_debit(FreefareTag tag, uint8_t file_no, int32_t amount);
// int		 mifare_desfire_debit_ex(FreefareTag tag, uint8_t file_no, int32_t amount, int cs);
// int		 mifare_desfire_limited_credit(FreefareTag tag, uint8_t file_no, int32_t amount);
// int		 mifare_desfire_limited_credit_ex(FreefareTag tag, uint8_t file_no, int32_t amount, int cs);
// ssize_t		 mifare_desfire_write_record(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data);
// ssize_t		 mifare_desfire_write_record_ex(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data, int cs);
// ssize_t		 mifare_desfire_read_records(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data);
// ssize_t		 mifare_desfire_read_records_ex(FreefareTag tag, uint8_t file_no, off_t offset, size_t length, void *data, int cs);
// int		 mifare_desfire_clear_record_file(FreefareTag tag, uint8_t file_no);
// int		 mifare_desfire_commit_transaction(FreefareTag tag);
// int		 mifare_desfire_abort_transaction(FreefareTag tag);
// 
// MifareDESFireKey mifare_desfire_des_key_new(const uint8_t value[8]);
// MifareDESFireKey mifare_desfire_3des_key_new(const uint8_t value[16]);
// MifareDESFireKey mifare_desfire_des_key_new_with_version(const uint8_t value[8]);
// MifareDESFireKey mifare_desfire_3des_key_new_with_version(const uint8_t value[16]);
// MifareDESFireKey mifare_desfire_3k3des_key_new(const uint8_t value[24]);
// MifareDESFireKey mifare_desfire_3k3des_key_new_with_version(const uint8_t value[24]);
// MifareDESFireKey mifare_desfire_aes_key_new(const uint8_t value[16]);
// MifareDESFireKey mifare_desfire_aes_key_new_with_version(const uint8_t value[16], uint8_t version);
// uint8_t		 mifare_desfire_key_get_version(MifareDESFireKey key);
// void		 mifare_desfire_key_set_version(MifareDESFireKey key, uint8_t version);
// void		 mifare_desfire_key_free(MifareDESFireKey key);
// 
// uint8_t		*tlv_encode(const uint8_t type, const uint8_t *istream, uint16_t isize, size_t *osize);
// uint8_t		*tlv_decode(const uint8_t *istream, uint8_t *type, uint16_t *size);
// size_t		tlv_record_length(const uint8_t *istream, size_t *field_length_size, size_t *field_value_size);
// uint8_t		*tlv_append(uint8_t *a, uint8_t *b);
// 
// typedef enum mifare_key_type {
//     MIFARE_KEY_DES,
//     MIFARE_KEY_2K3DES,
//     MIFARE_KEY_3K3DES,
//     MIFARE_KEY_AES128,
// 
//     MIFARE_KEY_LAST = MIFARE_KEY_AES128
// } MifareKeyType;
// 
// struct mifare_key_deriver;
// typedef struct mifare_key_deriver *MifareKeyDeriver;
// 
// MifareKeyDeriver mifare_key_deriver_new_an10922(MifareDESFireKey master_key, MifareKeyType output_key_type);
// int		 mifare_key_deriver_begin(MifareKeyDeriver deriver);
// int		 mifare_key_deriver_update_data(MifareKeyDeriver deriver, const uint8_t *data, size_t len);
// int		 mifare_key_deriver_update_uid(MifareKeyDeriver deriver, FreefareTag tag);
// int		 mifare_key_deriver_update_aid(MifareKeyDeriver deriver, MifareDESFireAID aid);
// int		 mifare_key_deriver_update_cstr(MifareKeyDeriver deriver, const char *cstr);
// MifareDESFireKey mifare_key_deriver_end(MifareKeyDeriver deriver);
// int		 mifare_key_deriver_end_raw(MifareKeyDeriver deriver, uint8_t* diversified_bytes, size_t data_max_len);
// void		 mifare_key_deriver_free(MifareKeyDeriver state);

#ifdef __cplusplus
}
#endif // __cplusplus

#endif /* !__FREEFARE_H__ */