diff 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 diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/service/cardReader/pyfreefare/freefare.h	Wed Feb 05 16:40:46 2020 -0800
@@ -0,0 +1,557 @@
+
+#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__ */