Functions specific to Mifare DESFire® cards. All uFR Series readers support DESfire set of commands in AES encryption mode according to manufacturer's recommendations. In addition to AES, support for DES/2K3DES/3K3DES included. More...

Enumerations
enum	KEY_TYPE { AES_KEY_TYPE , DES3K_KEY_TYPE , DES_KEY_TYPE , DES2K_KEY_TYPE }

Functions
UFR_STATUS DL_API	AES_to_DES_key_type (void)
	Function allow to change the card master key type from AES to DES.

UFR_STATUS DL_API	DES_to_AES_key_type (void)
	Function allows you to change the card master key type from DES to AES.

UFR_STATUS DL_API	uFR_int_DesfireChange2K3DesKey_2k3des (uint8_t auth_des2k_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_2k3des_key_nr, uint8_t aid_key_no, uint8_t old_2k3des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any 2K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChange2K3DesKey_2k3des_PK (IN uint8_t auth_des2k_key, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_2k3des_key[16], uint8_t aid_key_no, IN uint8_t old_2k3des_key[16], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any 2K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChange2K3DesKey_des (uint8_t auth_des_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_2k3des_key_nr, uint8_t aid_key_no, uint8_t old_2k3des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any 2K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChange2K3DesKey_des_PK (IN uint8_t auth_des_key, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_2k3des_key[16], uint8_t aid_key_no, IN uint8_t old_2k3des_key[16], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any 2K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChange3K3DesKey_3k3des (uint8_t auth_des3k_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_3k3des_key_nr, uint8_t aid_key_no, uint8_t old_3k3des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any 3K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChange3K3DesKey_3k3des_PK (IN uint8_t auth_des3k_key, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_3k3des_key[24], uint8_t aid_key_no, IN uint8_t old_3k3des_key[24], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any 3K3DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeAesKey (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_aes_key[16], uint8_t aid_key_no, IN uint8_t old_aes_key[16], VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeAesKey_A (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_aes_key_nr, uint8_t aid_key_no, uint8_t old_aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeAesKey_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_aes_key_nr, uint8_t aid_key_no, uint8_t old_aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeAesKey_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_aes_key[16], uint8_t aid_key_no, IN uint8_t old_aes_key[16], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeAesKey_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_aes_key[16], uint8_t aid_key_no, IN uint8_t old_aes_key[16], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeDesKey_2k3des (uint8_t auth_des2k_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des_key_nr, uint8_t aid_key_no, uint8_t old_des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeDesKey_2k3des_PK (IN uint8_t auth_des2k_key, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_des_key[8], uint8_t aid_key_no, IN uint8_t old_des_key[8], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeDesKey_des (uint8_t auth_des_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des_key_nr, uint8_t aid_key_no, uint8_t old_des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeDesKey_des_PK (IN uint8_t auth_des_key, uint32_t aid, uint8_t aid_key_no_auth, IN uint8_t new_des_key[8], uint8_t aid_key_no, IN uint8_t old_des_key[8], VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettingsSdm (uint8_t aes_key_nr, uint32_t aid, uint8_t file_no, uint8_t communication_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t uid_enable, uint8_t read_ctr_enable, uint8_t read_ctr_limit_enable, uint8_t enc_file_data_enable, uint8_t meta_data_key_no, uint8_t file_data_read_key_no, uint8_t read_ctr_key_no, uint32_t uid_offset, uint32_t read_ctr_offset, uint32_t picc_data_offset, uint32_t mac_input_offset, uint32_t enc_offset, uint32_t enc_length, uint32_t mac_offset, uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettingsSdm_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_no, uint8_t communication_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t uid_enable, uint8_t read_ctr_enable, uint8_t read_ctr_limit_enable, uint8_t enc_file_data_enable, uint8_t meta_data_key_no, uint8_t file_data_read_key_no, uint8_t read_ctr_key_no, uint32_t uid_offset, uint32_t read_ctr_offset, uint32_t picc_data_offset, uint32_t mac_input_offset, uint32_t enc_offset, uint32_t enc_length, uint32_t mac_offset, uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows changing of file settings Desfire EV3 only. Security Dynamic Messaging settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_des (uint8_t des_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeKeySettings_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeMasterKey (uint8_t auth_key_nr, uint8_t auth_key_type, uint8_t new_key_nr, uint8_t new_key_type, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change master key of the card from any type to any type.

UFR_STATUS DL_API	uFR_int_DesfireChangeMasterKey_PK (IN uint8_t auth_key, uint8_t auth_key_type, IN uint8_t new_key, uint8_t new_key_type, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change master key of the card from any type to any type.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_2k3des_2 (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_2k3des_PK_2 (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_3k3des_2 (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_3k3des_PK_2 (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_aes_2 (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_aes_PK_2 (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_des_2 (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_des_PK_2 (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_no_auth (uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireClearRecordFile_TransMac_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des_iso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des_iso_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_iso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_iso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_iso_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_iso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_iso_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_no_auth (uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_no_auth_iso (uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_iso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_iso_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_iso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_iso_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_iso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_iso_ascd (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_iso_ascd_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_iso_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_iso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_iso_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_no_auth (uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_no_auth_iso (uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_no_auth (uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_no_auth (uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des_iso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des_iso_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_iso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_iso_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_iso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_iso_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_iso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_iso_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_no_auth (uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_no_auth_iso (uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_no_auth (uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des_iso (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des_iso_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_iso (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_iso_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_sdm (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_sdm_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, uint16_t VAR card_status, uint16_t VAR *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_iso (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_iso_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_no_auth (uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_no_auth_iso (uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_no_auth (uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireCreateValueFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_3k3des (uint8_t des3_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDecreaseValueFile_TransMac_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication (uint8_t aes_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_2k3des (uint8_t des2k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_3k3des (uint8_t des3k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_aes (uint8_t aes_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_2k3des (uint8_t des2k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_3k3des (uint8_t des3k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_aes (uint8_t aes_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_des (uint8_t des_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_des_PK (IN uint8_t des_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_app_master_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_des (uint8_t des_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_des_PK (IN uint8_t des_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteApplication_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_no_auth (uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireDeleteFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard (uint8_t aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_2k3des (uint8_t des2k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_2k3des_PK (IN uint8_t des2k_key_ext, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_3k3des (uint8_t des3k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_3k3des_PK (IN uint8_t des3k_key_ext, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_aes (uint8_t aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_aes_PK (IN uint8_t aes_key_ext, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_des (uint8_t des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_des_PK (IN uint8_t des_key_ext, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFormatCard_PK (IN uint8_t aes_key_ext, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_int_DesfireFreeMem (VAR uint32_t free_mem_byte, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the available bytes on the card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds (uint8_t aes_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_2k3des (uint8_t des2k_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_2k3des_PK (IN uint8_t des2k_key_ext, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_3k3des (uint8_t des3k_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_3k3des_PK (IN uint8_t des3k_key_ext, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_aes (uint8_t aes_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_aes_PK (IN uint8_t aes_key_ext, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_des (uint8_t des_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_des_PK (IN uint8_t des_key_ext, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_no_auth (OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_PK (IN uint8_t aes_key_ext, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettings_no_auth (uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettingsSdm_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR uint8_t sdm_enable, VAR uint8_t uid_enable, VAR uint8_t read_ctr_enable, VAR uint8_t read_ctr_limit_enable, VAR uint8_t enc_file_data_enable, VAR uint8_t meta_data_key_no, VAR uint8_t file_data_read_key_no, VAR uint8_t read_ctr_key_no, VAR uint32_t uid_offset, VAR uint32_t read_ctr_offset, VAR uint32_t picc_data_offset, VAR uint32_t mac_input_offset, VAR uint32_t enc_offset, VAR uint32_t enc_length, VAR uint32_t mac_offset, VAR uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetFileSettingsSdm_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR uint8_t sdm_enable, VAR uint8_t uid_enable, VAR uint8_t read_ctr_enable, VAR uint8_t read_ctr_limit_enable, VAR uint8_t enc_file_data_enable, VAR uint8_t meta_data_key_no, VAR uint8_t file_data_read_key_no, VAR uint8_t read_ctr_key_no, VAR uint32_t uid_offset, VAR uint32_t read_ctr_offset, VAR uint32_t picc_data_offset, VAR uint32_t mac_input_offset, VAR uint32_t enc_offset, VAR uint32_t enc_length, VAR uint32_t mac_offset, VAR uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings (uint8_t aes_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_2k3des (uint8_t des2k_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_3k3des (uint8_t des3k_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_aes (uint8_t aes_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_des (uint8_t des_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_des_PK (IN uint8_t des_key_ext, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_no_auth (uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetKeySettings_PK (IN uint8_t aes_key_ext, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_des (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireGetStdFileSize_no_auth (uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireIncreaseValueFile_TransMac_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_int_DesfireNDEFFormat (uint32_t ndef_file_size)
	Function used to create and initialize necessary application/files for storing NDEF message.

UFR_STATUS DL_API	uFR_int_DesfireReadNDEFMessage (OUT uint8_t message, uint32_t message_length)
	Function used to read the whole NDEF message stored on the Desfire card.

UFR_STATUS DL_API	uFR_int_DesfireReadNDEFPayload (OUT char *payload_str)
	Function used to extract the payload of the NDEF message stored on the Desfire card.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadRecords_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadStdDataFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_2k3des (uint8_t auth_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t *lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_2k3des_PK (IN uint8_t auth_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_3k3des (uint8_t auth_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t *lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_3k3des_PK (IN uint8_t auth_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_aes (uint8_t auth_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t *lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_aes_PK (IN uint8_t auth_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_des (uint8_t auth_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t *lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireRidReadECCSignature_des_PK (IN uint8_t auth_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, OUT uint8_t lpucECCSignature, VAR uint8_t lpucDlogicCardType)
	From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 64 bit DES key provided key Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA). If the Random ID is activated, then authentication with a valid key is required.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration (uint8_t aes_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_2k3des (uint8_t des2k_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_2k3des_PK (IN uint8_t des2k_key_ext, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_3k3des (uint8_t des3k_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_3k3des_PK (IN uint8_t des3k_key_ext, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_aes (uint8_t aes_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_aes_PK (IN uint8_t aes_key_ext, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_des (uint8_t des_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_des_PK (IN uint8_t des_key_ext, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetConfiguration_PK (IN uint8_t aes_key_ext, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_int_DesfireSetTransactionTimer_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t transaction_timer, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function set value of application transaction timer.

UFR_STATUS DL_API	uFR_int_DesfireSetTransactionTimer_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t transaction_timer, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function set value of application transaction timer.

UFR_STATUS DL_API	uFR_int_DesfireUidReadECCSignature (OUT uint8_t lpucECCSignature, OUT uint8_t card_uid, VAR uint8_t *lpucDlogicCardType)
	Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

UFR_STATUS DL_API	uFR_int_DesfireWriteAesKey (uint8_t aes_key_no, IN uint8_t *aes_key)
	Function writes AES key (16 bytes) into reader.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteBackupDataFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteKey (uint8_t key_no, IN uint8_t *key, uint8_t key_type)
	Function writes AES key (16 bytes) into reader.

UFR_STATUS DL_API	uFR_int_DesfireWriteNDEFMessage (IN uint8_t *data, uint32_t data_length)
	Function used to write NDEF message to the Desfire card.

UFR_STATUS DL_API	uFR_int_DesfireWriteNDEFPayload (IN c_string payload_str)
	Function used to write the payload of the NDEF message on the Desfire card.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_TransMac_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_no_auth (uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_DesfireWriteStdDataFile_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_int_GetDesfireUid (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_2k3des (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_2k3des_PK (IN uint8_t des2k_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_3k3des (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_3k3des_PK (IN uint8_t des3k_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_aes (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_aes_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_des (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_des_PK (IN uint8_t des_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_int_GetDesfireUid_PK (IN uint8_t aes_key_ext, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_SAM_DesfireChange2k3desKey_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des2k_key_nr, uint8_t aid_key_no, uint8_t old_des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any 2K3DES key on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireChange3k3desKey_3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des3k_key_nr, uint8_t aid_key_no, uint8_t old_des3k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any 3K3DES key on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeAesKey_AesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_aes_key_nr, uint8_t aid_key_no, uint8_t old_aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any AES key on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeDesKey_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des_key_nr, uint8_t aid_key_no, uint8_t old_des2k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeDesKey_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_no_auth, uint8_t new_des_key_nr, uint8_t aid_key_no, uint8_t old_des_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change any DES key on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeFileSettings2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeFileSettings3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeFileSettingsAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeFileSettingsDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_no, uint8_t comm_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeFileSettingsSdm (uint8_t aes_key_nr, uint32_t aid, uint8_t file_no, uint8_t communication_settings, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t uid_enable, uint8_t read_ctr_enable, uint8_t read_ctr_limit_enable, uint8_t enc_file_data_enable, uint8_t meta_data_key_no, uint8_t file_data_read_key_no, uint8_t read_ctr_key_no, uint32_t uid_offset, uint32_t read_ctr_offset, uint32_t picc_data_offset, uint32_t mac_input_offset, uint32_t enc_offset, uint32_t enc_length, uint32_t mac_offset, uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows changing of file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeKeySettings2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeKeySettings3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeKeySettingsAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeKeySettingsDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t setting, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to set card master key, and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireChangeMasterKey (uint8_t auth_key_nr, uint8_t auth_key_type, uint8_t new_key_nr, uint8_t new_key_type, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to change master key of the card from any type to any type.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile2k3desAuth_2 (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile3k3desAuth_2 (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile_TransMac_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile_TransMac_3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile_TransMac_AesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFile_TransMac_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFileAesAuth_2 (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireClearRecordFileDesAuth_2 (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication2k3desAuthIso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication3k3desAuthIso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationAesAuthIso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationDesAuthIso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication2k3desAuthIso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication3k3desAuthIso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuthIso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuthIsoAscd (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationDesAuthIso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateCyclicRecordFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateCyclicRecordFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateCyclicRecordFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateCyclicRecordFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication2k3desAuthIso (uint8_t des2k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication3k3desAuthIso (uint8_t des3k_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationAesAuthIso (uint8_t aes_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationDesAuthIso (uint8_t des_key_nr, uint32_t aid, uint8_t setting, uint8_t max_key_no, uint16_t iso_file_id, IN uint8_t iso_df_name, uint8_t iso_df_name_len, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to create a new application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateLinearRecordFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateLinearRecordFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateLinearRecordFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateLinearRecordFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t record_size, uint32_t max_rec_no, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for multiple storage of structural data, within an existing application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile2k3desAuthIso (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile3k3desAuthIso (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuthIso (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuthIsoSdm (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileDesAuthIso (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint32_t file_size, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, uint16_t iso_file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create a file for the storage of unformatted user data within an existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateTransMacFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateTransMacFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateTransMacFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateTransMacFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, uint8_t read_key_no, uint8_t commit_reader_id_key_no, uint8_t change_key_no, uint8_t communication_settings, IN uint8_t trans_mac_key, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function creates Transaction MAC file in application.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateValueFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateValueFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateValueFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateValueFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, int32_t lower_limit, int32_t upper_limit, int32_t value, uint8_t limited_credit_enabled, uint8_t read_key_no, uint8_t write_key_no, uint8_t read_write_key_no, uint8_t change_key_no, uint8_t communication_settings, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile_TransMac_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile_TransMac_3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile_TransMac_AesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFile_TransMac_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDecreaseValueFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to decrease value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication_app_master_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication_app_master_3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication_app_master_AesAuth (uint8_t aes_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplication_app_master_DesAuth (uint8_t des_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplicationAesAuth (uint8_t aes_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteApplicationDesAuth (uint8_t des_key_nr, uint32_t aid, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to deactivate application on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_SAM_DesfireDeleteFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function deactivates a file within the currently selected application.

UFR_STATUS DL_API	uFR_SAM_DesfireFormatCard2k3desAuth (uint8_t des3k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireFormatCard3k3desAuth (uint8_t des3k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireFormatCardAesAuth (uint8_t aes_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireFormatCardDesAuth (uint8_t des3k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function releases all allocated user memory on the card.

UFR_STATUS DL_API	uFR_SAM_DesfireGetApplicationIds2k3desAuth (uint8_t des2k_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_SAM_DesfireGetApplicationIds3k3desAuth (uint8_t des3k_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_SAM_DesfireGetApplicationIdsAesAuth (uint8_t aes_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_SAM_DesfireGetApplicationIdsDesAuth (uint8_t des_key_nr, OUT uint32_t application_ids, VAR uint8_t number_of_aplication_ids, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns the Application Identifiers for all active applications on a card.

UFR_STATUS DL_API	uFR_SAM_DesfireGetFileSettings2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetFileSettings3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetFileSettingsAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetFileSettingsDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR int32_t lower_limit, VAR int32_t upper_limit, VAR uint32_t limited_credit_value, VAR uint8_t limited_credit_enable, VAR uint32_t record_size, VAR uint32_t max_number_of_rec, VAR uint32_t curr_number_of_rec, VAR uint8_t tm_key_type, VAR uint8_t tm_key_version, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetFileSettingsSdmAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint8_t file_type, VAR uint8_t communication_mode, VAR uint8_t read_key_no, VAR uint8_t write_key_no, VAR uint8_t read_write_key_no, VAR uint8_t change_key_no, VAR uint32_t file_size, VAR uint8_t sdm_enable, VAR uint8_t uid_enable, VAR uint8_t read_ctr_enable, VAR uint8_t read_ctr_limit_enable, VAR uint8_t enc_file_data_enable, VAR uint8_t meta_data_key_no, VAR uint8_t file_data_read_key_no, VAR uint8_t read_ctr_key_no, VAR uint32_t uid_offset, VAR uint32_t read_ctr_offset, VAR uint32_t picc_data_offset, VAR uint32_t mac_input_offset, VAR uint32_t enc_offset, VAR uint32_t enc_length, VAR uint32_t mac_offset, VAR uint32_t read_ctr_limit, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function returns file settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetKeySettings2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetKeySettings3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetKeySettingsAesAuth (uint8_t aes_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetKeySettingsDesAuth (uint8_t des_key_nr, uint32_t aid, VAR uint8_t setting, VAR uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to get card master key and application master key configuration settings.

UFR_STATUS DL_API	uFR_SAM_DesfireGetStdFileSize2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_SAM_DesfireGetStdFileSize3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_SAM_DesfireGetStdFileSizeAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_SAM_DesfireGetStdFileSizeDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function retrieves the information about the size of the standard data file stored on the tag.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile_TransMac_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile_TransMac_3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile_TransMac_AesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFile_TransMac_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, VAR uint32_t trans_mac_cnt, OUT uint8_t trans_mac_value)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireIncreaseValueFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, uint32_t value, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows to increase a value stored in a value files.

UFR_STATUS DL_API	uFR_SAM_DesfireReadRecords2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadRecords3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadRecordsAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadRecordsDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t number_of_records, uint16_t record_size, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadStdDataFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadStdDataFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadStdDataFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadStdDataFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, OUT uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows to read data from Standard Data File, or from Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireReadValueFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireReadValueFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireReadValueFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireReadValueFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint8_t communication_settings, VAR int32_t value, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allow to read value from value files.

UFR_STATUS DL_API	uFR_SAM_DesfireSetConfiguration2k3desAuth (uint8_t des2k_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_SAM_DesfireSetConfiguration3k3desAuth (uint8_t des3k_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_SAM_DesfireSetConfigurationAesAuth (uint8_t aes_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_SAM_DesfireSetConfigurationDesAuth (uint8_t des_key_nr, uint8_t random_uid, uint8_t format_disable, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function allows you to activate the Random ID option, and/or Format disable option.

UFR_STATUS DL_API	uFR_SAM_DesfireSetTransactionTimerAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t transaction_timer, VAR uint16_t card_status, VAR uint16_t exec_time)
	Function set value of application transaction timer.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteBackupDataFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteBackupDataFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteBackupDataFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteBackupDataFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to the Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord_TransMac_2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord_TransMac_3k3desAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord_TransMac_AesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecord_TransMac_DesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t exec_time, uint8_t use_reader_id, OUT uint8_t reader_id, OUT uint8_t prev_enc_reader_id, OUT uint32_t trans_mac_cnt, OUT uint8_t *trans_mac_value)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecordAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteRecordDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to a record in a Linear Record File or Cyclic Record File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteStdDataFile2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteStdDataFile3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteStdDataFileAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_SAM_DesfireWriteStdDataFileDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, uint8_t file_id, uint16_t offset, uint16_t data_length, uint8_t communication_settings, IN uint8_t data, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Function allows writing data to Standard Data File, or to Backup Data File.

UFR_STATUS DL_API	uFR_SAM_GetDesfireUid2k3desAuth (uint8_t des2k_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_SAM_GetDesfireUid3k3desAuth (uint8_t des3k_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_SAM_GetDesfireUidAesAuth (uint8_t aes_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

UFR_STATUS DL_API	uFR_SAM_GetDesfireUidDesAuth (uint8_t des_key_nr, uint32_t aid, uint8_t aid_key_nr, OUT uint8_t card_uid, VAR uint8_t card_uid_len, VAR uint16_t card_status, VAR uint16_t exec_time)
	This function returns Unique ID of card, if the Random ID is used.

Detailed Description

Functions specific to Mifare DESFire® cards. All uFR Series readers support DESfire set of commands in AES encryption mode according to manufacturer's recommendations. In addition to AES, support for DES/2K3DES/3K3DES included.

Enumeration Type Documentation

◆ KEY_TYPE

enum KEY_TYPE

Enumerator
AES_KEY_TYPE
DES3K_KEY_TYPE
DES_KEY_TYPE
DES2K_KEY_TYPE

Function Documentation

◆ AES_to_DES_key_type()

UFR_STATUS DL_API AES_to_DES_key_type ( void )

Function allow to change the card master key type from AES to DES.

Set master AES key before use this function to 0x00000000000000000000000000000000. New DES key will be 0x0000000000000000 as in factory settings.

Returns: Operation status

◆ DES_to_AES_key_type()

UFR_STATUS DL_API DES_to_AES_key_type ( void )

Function allows you to change the card master key type from DES to AES.

Factory setting for the DESFIRE card master key is the DES key type, and the value is 0x0000000000000000. Because the reader uses AES keys, you must change the type key on AES. New AES key is 0x00000000000000000000000000000000.

Returns: Operation status

◆ uFR_int_DesfireChange2K3DesKey_2k3des()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_2k3des	(	uint8_t	auth_des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_2k3des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_2k3des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 2K3DES key on the card.

128 bit 2K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des2k_key_nr	auth_des2k_key_nr
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_2k3des_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_2k3des_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange2K3DesKey_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_2k3des_PK	(	IN uint8_t *	auth_des2k_key,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_2k3des_key[16],
		uint8_t	aid_key_no,
		IN uint8_t	old_2k3des_key[16],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 2K3DES key on the card.

128 bit 2K3DES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des2k_key	ordinal number of authentication 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_2k3des_key	16 bytes array that represent 2K3DES key
aid_key_no	key number into application that will be changed
old_2k3des_key	16 bytes array that represent current 2K3DES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange2K3DesKey_des()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_des	(	uint8_t	auth_des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_2k3des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_2k3des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 2K3DES key on the card.

64 bit DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_2k3des_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_2k3des_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange2K3DesKey_des_PK()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_des_PK	(	IN uint8_t *	auth_des_key,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_2k3des_key[16],
		uint8_t	aid_key_no,
		IN uint8_t	old_2k3des_key[16],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 2K3DES key on the card.

64 bit DES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des_key	pointer to 8 bytes array containing the DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_2k3des_key	16 bytes array that represent 2K3DES key
aid_key_no	key number into application that will be changed
old_2k3des_key	16 bytes array that represent current 2K3DES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange3K3DesKey_3k3des()

UFR_STATUS DL_API uFR_int_DesfireChange3K3DesKey_3k3des	(	uint8_t	auth_des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_3k3des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_3k3des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 3K3DES key on the card.

192 bit 3K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des3k_key_nr	ordinal number of authentication 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_3k3des_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_3k3des_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange3K3DesKey_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChange3K3DesKey_3k3des_PK	(	IN uint8_t *	auth_des3k_key,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_3k3des_key[24],
		uint8_t	aid_key_no,
		IN uint8_t	old_3k3des_key[24],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 3K3DES key on the card.

192 bit 3K3DES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des3k_key	pointer to 32 bytes array containing the 3K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_3k3des_key	24 bytes array that represent 3K3DES key
aid_key_no	key number into application that will be changed
old_3k3des_key	24 bytes array that represent current 3K3DES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_aes_key[16],
		uint8_t	aid_key_no,
		IN uint8_t	old_aes_key[16],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key	16 bytes array that represent AES key
aid_key_no	key number into application that will be changed
old_aes_key	16 bytes array that represent current AES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey_A()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_A	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_aes_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_aes_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey_aes()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_aes_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

128 bit AES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_aes_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_aes_key[16],
		uint8_t	aid_key_no,
		IN uint8_t	old_aes_key[16],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

128 bit AES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key	16 bytes array that represent AES key
aid_key_no	key number into application that will be changed
old_aes_key	16 bytes array that represent current AES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_aes_key[16],
		uint8_t	aid_key_no,
		IN uint8_t	old_aes_key[16],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

Provided Key mode (PK) Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key	16 bytes array that represent AES key
aid_key_no	key number into application that will be changed
old_aes_key	16 bytes array that represent current AES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeDesKey_2k3des()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_2k3des	(	uint8_t	auth_des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

128 bit 2K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des2k_key_nr	auth_des2k_key_nr
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_des_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeDesKey_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_2k3des_PK	(	IN uint8_t *	auth_des2k_key,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_des_key[8],
		uint8_t	aid_key_no,
		IN uint8_t	old_des_key[8],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

128 bit 2K3DES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des2k_key	ordinal number of authentication 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key	8 bytes array that represent DES key
aid_key_no	key number into application that will be changed
old_des_key	8 bytes array that represent current AES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeDesKey_des()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_des	(	uint8_t	auth_des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

64 bit DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key_nr	ordinal number of authentication AES key in the reader
aid_key_no	key number into application that will be changed
old_des_key_nr	ordinal number of authentication AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeDesKey_des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_des_PK	(	IN uint8_t *	auth_des_key,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		IN uint8_t	new_des_key[8],
		uint8_t	aid_key_no,
		IN uint8_t	old_des_key[8],
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

64 bit DES key provided key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_des_key	pointer to 8 bytes array containing the DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key	8 bytes array that represent DES key
aid_key_no	key number into application that will be changed
old_des_key	8 bytes array that represent current AES key that will be changed, if this is not key by which is made authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_2k3des()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_3k3des()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_aes()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_des()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettingsSdm()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettingsSdm	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	communication_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	uid_enable,
		uint8_t	read_ctr_enable,
		uint8_t	read_ctr_limit_enable,
		uint8_t	enc_file_data_enable,
		uint8_t	meta_data_key_no,
		uint8_t	file_data_read_key_no,
		uint8_t	read_ctr_key_no,
		uint32_t	uid_offset,
		uint32_t	read_ctr_offset,
		uint32_t	picc_data_offset,
		uint32_t	mac_input_offset,
		uint32_t	enc_offset,
		uint32_t	enc_length,
		uint32_t	mac_offset,
		uint32_t	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. Security Dynamic Messaging settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_no	ID of file that will be created (0 - 31) ID of file (0 - 31)
communication_settings	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettingsSdm_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettingsSdm_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	communication_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	uid_enable,
		uint8_t	read_ctr_enable,
		uint8_t	read_ctr_limit_enable,
		uint8_t	enc_file_data_enable,
		uint8_t	meta_data_key_no,
		uint8_t	file_data_read_key_no,
		uint8_t	read_ctr_key_no,
		uint32_t	uid_offset,
		uint32_t	read_ctr_offset,
		uint32_t	picc_data_offset,
		uint32_t	mac_input_offset,
		uint32_t	enc_offset,
		uint32_t	enc_length,
		uint32_t	mac_offset,
		uint32_t	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings Desfire EV3 only. Security Dynamic Messaging settings.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_no	ID of file that will be created (0 - 31) ID of file (0 - 31)
communication_settings	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_2k3des()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

128 bit 2K3DES key provided key

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_3k3des()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

192 bit 3K3DES key provided key

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_aes()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

128 bit AES key provided key

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_des()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_des_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

64 bit DES key provided key

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

Provided Key mode (PK)

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeMasterKey()

UFR_STATUS DL_API uFR_int_DesfireChangeMasterKey	(	uint8_t	auth_key_nr,
		uint8_t	auth_key_type,
		uint8_t	new_key_nr,
		uint8_t	new_key_type,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change master key of the card from any type to any type.

Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_key_nr	ordinal number of key in the reader
auth_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
new_key_nr	ordinal number of authentication AES key in the reader
new_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeMasterKey_PK()

UFR_STATUS DL_API uFR_int_DesfireChangeMasterKey_PK	(	IN uint8_t *	auth_key,
		uint8_t	auth_key_type,
		IN uint8_t *	new_key,
		uint8_t	new_key_type,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change master key of the card from any type to any type.

Provided Key mode (PK) Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_key	pointer to array contained AES key
auth_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
new_key	pointer to array contained new AES key
new_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_2k3des_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_2	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_2k3des_PK_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_PK_2	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3des_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_2	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3des_PK_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_PK_2	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aes()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aes_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_2	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aes_PK_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_PK_2	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_des_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_2	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_des_PK_2()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_PK_2	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

No authentication Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

Provided Key mode (PK) Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_2k3des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit 2K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_3k3des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

192 bit 3K3DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_aes()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

128 bit AES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_des()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_des_PK()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

64 bit DES key provided key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_iso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	rdinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_iso_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_iso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_aes()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_aes_iso()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_iso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_aes_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_iso_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_des()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_iso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_iso_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_no_auth	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

No authentication If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_no_auth_iso()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_no_auth_iso	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_2k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_iso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_2k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_iso_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_3k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_iso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_3k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_iso_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes_iso_ascd()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso_ascd	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File Identifier
iso_df_name	ISO/IEC 7816-4 DF (Dedicated File) name
iso_df_name_len	DF name length
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes_iso_ascd_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso_ascd_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined. Application specific Capability data enabled.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File Identifier
iso_df_name	ISO/IEC 7816-4 DF (Dedicated File) name
iso_df_name_len	DF name length
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_des()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_iso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_iso_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_no_auth	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

No authentication If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_no_auth_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_no_auth_iso	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

Provided Key mode (PK) If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit 2K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit 2K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

192 bit 3K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

192 bit 3K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit AES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit AES key provided key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

64 bit DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

64 bit DES key provided key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

No authentication From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateBackupDataFile_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit 2K3DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit 2K3DES key provided key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

192 bit 3K3DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

192 bit 3K3DES key provided key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit AES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit AES key provided key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

64 bit DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

64 bit DES key provided key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateCyclicRecordFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

No authentication Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_2k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_iso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	rdinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_2k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_iso_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit 2K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_3k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_iso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_3k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_iso_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

192 bit 3K3DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_aes_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_iso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_aes_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_iso_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

128 bit AES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_des()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_iso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_iso_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

64 bit DES key provided key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_no_auth	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

No authentication If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_no_auth_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_no_auth_iso	(	uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit 2K3DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit 2K3DES key provided key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

192 bit 3K3DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

192 bit 3K3DES key provided key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit AES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

128 bit AES key provided key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

64 bit DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

64 bit DES key provided key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateLinearRecordFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

No authentication Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit 2K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_2k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_iso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_2k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_iso_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit 2K3DES key provided key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

192 bit 3K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_3k3des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_iso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_3k3des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_iso_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

192 bit 3K3DES key provided key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit AES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes_iso_sdm()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_sdm	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 – 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created. Secure Dynamic Message can be created.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes_iso_sdm_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_sdm_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		uint16_t VAR *	card_status,
		uint16_t VAR *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 – 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created. Secure Dynamic Message can be created.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading [i]
write_key_no	key for writing [j]
read_write_key_no	key for reading and writing [k]
change_key_no	key for changing this setting [l]
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

128 bit AES key provided key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

64 bit DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_des_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_iso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_des_iso_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_iso_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

64 bit DES key provided key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

No authentication Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_no_auth_iso()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_no_auth_iso	(	uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateStdDataFile_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Provided Key mode (PK) Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

128 bit 2K3DES key provided key

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

192 bit 3K3DES key provided key

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

128 bit AES key provided key

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateTransMacFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

64 bit DES key provided key

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

128 bit 2K3DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

128 bit 2K3DES key provided key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

192 bit 3K3DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

192 bit 3K3DES key provided key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_aes()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

128 bit AES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

128 bit AES key provided key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_des()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

64 bit DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

64 bit DES key provided key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

No authentication For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateValueFile_PK()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

Provided Key mode (PK) For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

128 bit 2K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

128 bit 2K3DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_3k3des	(	uint8_t	des3_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

192 bit 3K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

192 bit 3K3DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_aes()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

128 bit AES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

128 bit AES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

64 bit DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

64 bit DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

No authentication For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

Provided Key mode (PK) For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_2k3des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

128 bit 2K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

128 bit 2K3DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_3k3des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

192 bit 3K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

192 bit 3K3DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_aes()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

128 bit AES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

128 bit AES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_des()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

64 bit DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_des_PK()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

64 bit DES key provided key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDecreaseValueFile_TransMac_no_auth()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

No authentication For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_2k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit 2K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_nr	ordinal number of 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit 2K3DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_3k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

192 bit 3K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_nr	ordinal number of 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

192 bit 3K3DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_aes()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit AES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit AES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_2k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit 2K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_nr	ordinal number of 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit 2K3DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_3k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

192 bit 3K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_nr	ordinal number of 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

192 bit 3K3DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_aes()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit AES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

128 bit AES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

64 bit DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

64 bit DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

Provided Key mode (PK) Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_des()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

64 bit DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

64 bit DES key provided key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

Provided Key mode (PK) Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

128 bit 2K3DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

128 bit 2K3DES key provided key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

192 bit 3K3DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

192 bit 3K3DES key provided key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_aes()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

128 bit AES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

128 bit AES key provided key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_des()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

64 bit DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

64 bit DES key provided key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

No authentication Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_PK()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

Provided Key mode (PK) Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard()

UFR_STATUS DL_API uFR_int_DesfireFormatCard	(	uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

aes_key_nr	ordinal number of AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_2k3des()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_2k3des	(	uint8_t	des2k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

128 bit 2K3DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

128 bit 2K3DES key provided key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_3k3des()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_3k3des	(	uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

192 bit 3K3DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

192 bit 3K3DES key provided key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_aes()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_aes	(	uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

128 bit AES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

aes_key_nr	ordinal number of AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_aes_PK	(	IN uint8_t *	aes_key_ext,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

128 bit AES key provided key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_des()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_des	(	uint8_t	des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

64 bit DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des_key_nr	ordinal number of DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_des_PK()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_des_PK	(	IN uint8_t *	des_key_ext,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

64 bit DES key provided key

All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_PK()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_PK	(	IN uint8_t *	aes_key_ext,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Provided Key mode (PK) All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFreeMem()

UFR_STATUS DL_API uFR_int_DesfireFreeMem	(	VAR uint32_t *	free_mem_byte,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the available bytes on the card.

Parameters

free_mem_byte	pointer to free memory variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds	(	uint8_t	aes_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

For uFR PLUS devices only

Parameters

aes_key_nr	ordinal number of AES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_2k3des()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_2k3des	(	uint8_t	des2k_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

128 bit 2K3DES key For uFR PLUS devices only

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

128 bit 2K3DES key provided key For uFR PLUS devices only

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_3k3des()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_3k3des	(	uint8_t	des3k_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

192 bit 3K3DES key For uFR PLUS devices only

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

192 bit 3K3DES key provided key For uFR PLUS devices only

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_aes()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_aes	(	uint8_t	aes_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

128 bit AES key For uFR PLUS devices only

Parameters

aes_key_nr	ordinal number of AES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_aes_PK	(	IN uint8_t *	aes_key_ext,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

128 bit AES key provided key For uFR PLUS devices only

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_des()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_des	(	uint8_t	des_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

64 bit DES key For uFR PLUS devices only

Parameters

des_key_nr	ordinal number of DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_des_PK	(	IN uint8_t *	des_key_ext,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

64 bit DES key provided key For uFR PLUS devices only

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_no_auth()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_no_auth	(	OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

No authentication For uFR PLUS devices only

Parameters

application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_PK()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_PK	(	IN uint8_t *	aes_key_ext,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

Provided Key mode (PK) For uFR PLUS devices only

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_2k3des()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit 2K3DES key provided key

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_3k3des()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

192 bit 3K3DES key provided key

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_aes()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit AES key provided key

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_des()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

64 bit DES key provided key

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettings_no_auth()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

No authentication

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettingsSdm_aes()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettingsSdm_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR uint8_t *	sdm_enable,
		VAR uint8_t *	uid_enable,
		VAR uint8_t *	read_ctr_enable,
		VAR uint8_t *	read_ctr_limit_enable,
		VAR uint8_t *	enc_file_data_enable,
		VAR uint8_t *	meta_data_key_no,
		VAR uint8_t *	file_data_read_key_no,
		VAR uint8_t *	read_ctr_key_no,
		VAR uint32_t *	uid_offset,
		VAR uint32_t *	read_ctr_offset,
		VAR uint32_t *	picc_data_offset,
		VAR uint32_t *	mac_input_offset,
		VAR uint32_t *	enc_offset,
		VAR uint32_t *	enc_length,
		VAR uint32_t *	mac_offset,
		VAR uint32_t *	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit 2K3DES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
sdm_enable	Secure Dynamic Messaging enable status
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetFileSettingsSdm_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettingsSdm_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR uint8_t *	sdm_enable,
		VAR uint8_t *	uid_enable,
		VAR uint8_t *	read_ctr_enable,
		VAR uint8_t *	read_ctr_limit_enable,
		VAR uint8_t *	enc_file_data_enable,
		VAR uint8_t *	meta_data_key_no,
		VAR uint8_t *	file_data_read_key_no,
		VAR uint8_t *	read_ctr_key_no,
		VAR uint32_t *	uid_offset,
		VAR uint32_t *	read_ctr_offset,
		VAR uint32_t *	picc_data_offset,
		VAR uint32_t *	mac_input_offset,
		VAR uint32_t *	enc_offset,
		VAR uint32_t *	enc_length,
		VAR uint32_t *	mac_offset,
		VAR uint32_t *	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

128 bit 2K3DES key

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
sdm_enable	Secure Dynamic Messaging enable status
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_2k3des()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

128 bit 2K3DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

128 bit 2K3DES key provided key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_3k3des()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

192 bit 3K3DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

192 bit 3K3DES key provided key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_aes()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

128 bit AES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

128 bit AES key provided key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_des()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

64 bit DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

64 bit DES key provided key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_no_auth()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_no_auth	(	uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

No authentication In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetKeySettings_PK()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

Provided Key mode (PK) In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_2k3des()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

128 bit 2K3DES key provided key

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_3k3des()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

192 bit 3K3DES key provided key

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_aes()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

128 bit AES key provided key

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_des()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_des_PK()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

64 bit DES key provided key

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetStdFileSize_no_auth()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_no_auth	(	uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

No authentication

Parameters

aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

128 bit 2K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

128 bit 2K3DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

192 bit 3K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

192 bit 3K3DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_aes()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

128 bit AES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

128 bit AES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

64 bit DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

64 bit DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

No authentication For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

Provided Key mode (PK) For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_2k3des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

128 bit 2K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

128 bit 2K3DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_3k3des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

192 bit 3K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

192 bit 3K3DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_aes()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

128 bit AES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

128 bit AES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_des()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

64 bit DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_des_PK()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

64 bit DES key provided key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireIncreaseValueFile_TransMac_no_auth()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

No authentication For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireNDEFFormat()

UFR_STATUS DL_API uFR_int_DesfireNDEFFormat ( uint32_t ndef_file_size )

Function used to create and initialize necessary application/files for storing NDEF message.

The procedure involves following steps:

Tries switching card master key from factory DES key to new AES key (16 bytes 0x00)
Wipes the card data, complete format with new default AES key (16 bytes 0x00)
Creates AES Application with AID 1, maximum key number 1, app settings 0x0F
In AID 1 creates two new file for the purpose of NDEF message
CC File: Stored in AID 1, File ID 1, File size: 16, Access rights: 'Read' is free (no auth), writing/changing file settings will require authentication with AID key 0 of the NDEF application (AID 1, key 0)
NDEF File: Stored in AID 1, File ID 2, File size: Provided by 'ndef_file_size, Access rights: 'Read' is free (no auth), writing/changing file settings will require authentication with AID key 0 of the NDEF application (AID 1, key 0)
Writes necessary data to the CC file

Parameters

ndef_file_size Defines maximum size for the newly created NDEF file that will store NDEF message, if set as '0' function checks free memory on the card and uses all of it for the NDEF file

Returns: Operation status

◆ uFR_int_DesfireReadNDEFMessage()

UFR_STATUS DL_API uFR_int_DesfireReadNDEFMessage	(	OUT uint8_t *	message,
		uint32_t *	message_length )

Function used to read the whole NDEF message stored on the Desfire card.

Parameters

message	pointer to array that will hold message data
message_length	length of the message that was read if successfull

Returns: Operation status

◆ uFR_int_DesfireReadNDEFPayload()

UFR_STATUS DL_API uFR_int_DesfireReadNDEFPayload ( OUT char * payload_str )

Function used to extract the payload of the NDEF message stored on the Desfire card.

Parameters

payload_str pointer to buffer that will hold payload data

Returns: Operation status

◆ uFR_int_DesfireReadRecords_2k3des()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_3k3des()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_aes()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

128 bit AES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

128 bit AES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_des()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

64 bit DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

64 bit DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadRecords_no_auth()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

No authentication Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

128 bit 2K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

128 bit 2K3DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

192 bit 3K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

192 bit 3K3DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_aes()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

128 bit AES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

128 bit AES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_des()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

64 bit DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

64 bit DES key provided key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

No authentication Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadStdDataFile_PK()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

Provided Key mode (PK) Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

128 bit 2K3DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

128 bit 2K3DES key provided key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

192 bit 3K3DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

192 bit 3K3DES key provided key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_aes()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

128 bit AES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

128 bit AES key provided key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_des()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

64 bit DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

64 bit DES key provided key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

No authentication For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_PK()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

Provided Key mode (PK) For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_2k3des()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_2k3des	(	uint8_t	auth_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 128 bit 2K3DES key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_nr	ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_2k3des_PK	(	IN uint8_t *	auth_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 128 bit 2K3DES key provided key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_ext	pointer to array containing the key auth_key_nr ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_3k3des()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_3k3des	(	uint8_t	auth_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 192 bit 3K3DES key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_nr	ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_3k3des_PK	(	IN uint8_t *	auth_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 192 bit 3K3DES key provided key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_ext	pointer to array containing the key auth_key_nr ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_aes()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_aes	(	uint8_t	auth_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 128 bit AES key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_nr	ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_aes_PK	(	IN uint8_t *	auth_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 128 bit AES key provided key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_ext	pointer to array containing the key auth_key_nr ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_des()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_des	(	uint8_t	auth_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 64 bit DES key If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_nr	ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_des_PK()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_des_PK	(	IN uint8_t *	auth_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		OUT uint8_t *	lpucECCSignature,
		VAR uint8_t *	lpucDlogicCardType )

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 64 bit DES key provided key Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA). If the Random ID is activated, then authentication with a valid key is required.

Parameters

auth_key_ext	pointer to array containing the key auth_key_nr ordinal number of key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
card_uid	7 bytes length card UID
lpucECCSignature	56 bytes ECC signature
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration	(	uint8_t	aes_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_2k3des()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_2k3des	(	uint8_t	des2k_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

128 bit 2K3DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

128 bit 2K3DES key provided key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_3k3des()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_3k3des	(	uint8_t	des3k_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

192 bit 3K3DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

192 bit 3K3DES key provided key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_aes()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_aes	(	uint8_t	aes_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

128 bit AES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

128 bit AES key provided key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_des()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_des	(	uint8_t	des_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

64 bit DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_des_PK()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_des_PK	(	IN uint8_t *	des_key_ext,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

64 bit DES key provided key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetConfiguration_PK()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_PK	(	IN uint8_t *	aes_key_ext,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

Provided Key mode (PK) If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetTransactionTimer_aes()

UFR_STATUS DL_API uFR_int_DesfireSetTransactionTimer_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	transaction_timer,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function set value of application transaction timer.

Desfire EV3 only. At the current application specific capability data option must be enabled. Application must be created by function uFR_int_DesfireCreateAesApplication_aes_iso_ascd.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
transaction_timer	0 - disabled, 1 - 1 - 3 seconds, 2 - 10 - 30 seconds, 3 - 100 - 300 seconds
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireSetTransactionTimer_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireSetTransactionTimer_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	transaction_timer,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function set value of application transaction timer.

Desfire EV3 only. At the current application specific capability data option must be enabled. Application must be created by function uFR_int_DesfireCreateAesApplication_aes_iso_ascd.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
transaction_timer	0 - disabled, 1 - 1 - 3 seconds, 2 - 10 - 30 seconds, 3 - 100 - 300 seconds
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireUidReadECCSignature()

UFR_STATUS DL_API uFR_int_DesfireUidReadECCSignature	(	OUT uint8_t *	lpucECCSignature,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	lpucDlogicCardType )

Function retrieves the asymmetric originality signature based on an asymmetric cryptographic algorithm Elliptic Curve Cryptography Digital Signature Algorithm (ECDSA).

From library version 5.0.45 and firmware version 5.0.44. For Desfire Light, and Desfire EV2. 64 bit DES key provided key If the Random ID is activated, then authentication with a valid key is required.

Parameters

lpucECCSignature	56 bytes ECC signature
card_uid	7 bytes length card UID
lpucDlogicCardType	pointer to variable which will (in case of successfully executed operation) receive DlogicCardType. Returned here for convenience. For DlogicCardType uFR API uses the same constants as with GetDlogicCardType() function (see Appendix: DLogic CardType enumeration).

Returns: Operation status

◆ uFR_int_DesfireWriteAesKey()

UFR_STATUS DL_API uFR_int_DesfireWriteAesKey	(	uint8_t	aes_key_no,
		IN uint8_t *	aes_key )

Function writes AES key (16 bytes) into reader.

Parameters

aes_key_no	ordinal number of AES key in the reader (0 - 15)
aes_key	pointer to 16 byte array containing the AES key

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

128 bit 2K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

192 bit 3K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_aes()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

128 bit AES key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

128 bit AES key provided key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_des()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

64 bit DES key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

64 bit DES key provided key From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteBackupDataFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

No authentication From library version 5.0.96, and firmware version 5.0.79. Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteKey()

UFR_STATUS DL_API uFR_int_DesfireWriteKey	(	uint8_t	key_no,
		IN uint8_t *	key,
		uint8_t	key_type )

Function writes AES key (16 bytes) into reader.

Parameters

key_no	ordinal number of key in the reader (0 - 15)
key	pointer to array containing the key
key_type	enumerated key type (0 - 3)

Returns: Operation status

◆ uFR_int_DesfireWriteNDEFMessage()

UFR_STATUS DL_API uFR_int_DesfireWriteNDEFMessage	(	IN uint8_t *	data,
		uint32_t	data_length )

Function used to write NDEF message to the Desfire card.

Writes data directly to the NDEF File previously created by the uFR_int_DesfireNDEFFormat() function And such it addresses the AID 1 -> File 2, and overwrites the contents with data provided

Parameters

data	Array containing NDEF message data stored in a buffer to be written
data_length	length of the data to be written

Returns: Operation status

◆ uFR_int_DesfireWriteNDEFPayload()

UFR_STATUS DL_API uFR_int_DesfireWriteNDEFPayload ( IN c_string payload_str )

Function used to write the payload of the NDEF message on the Desfire card.

The function takes in only c-string URI, and sets it's uri_identifier to 0 so it is not prefixed by anything when read.

Parameters

payload_str pointer to buffer that will hold message data

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_2k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_3k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_aes()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit AES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

64 bit DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_no_auth()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

No authentication Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_2k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit 2K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_3k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

192 bit 3K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_aes()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

128 bit AES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_des()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

64 bit DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteRecord_TransMac_no_auth()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

No authentication Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_2k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_2k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

128 bit 2K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_3k3des()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_3k3des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

192 bit 3K3DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_aes()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_aes_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

128 bit AES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_des()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_des_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

64 bit DES key provided key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_no_auth()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_no_auth	(	uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

No authentication Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireWriteStdDataFile_PK()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

Provided Key mode (PK) Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid()

UFR_STATUS DL_API uFR_int_GetDesfireUid	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_2k3des()

UFR_STATUS DL_API uFR_int_GetDesfireUid_2k3des	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

128 bit 2K3DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_2k3des_PK()

UFR_STATUS DL_API uFR_int_GetDesfireUid_2k3des_PK	(	IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

128 bit 2K3DES key provided key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_3k3des()

UFR_STATUS DL_API uFR_int_GetDesfireUid_3k3des	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

192 bit 3K3DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_3k3des_PK()

UFR_STATUS DL_API uFR_int_GetDesfireUid_3k3des_PK	(	IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

192 bit 3K3DES key provided key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_aes()

UFR_STATUS DL_API uFR_int_GetDesfireUid_aes	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

128 bit AES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_aes_PK()

UFR_STATUS DL_API uFR_int_GetDesfireUid_aes_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

128 bit AES key provided key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_des()

UFR_STATUS DL_API uFR_int_GetDesfireUid_des	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

64 bit DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_des_PK()

UFR_STATUS DL_API uFR_int_GetDesfireUid_des_PK	(	IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

64 bit DES key provided key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_GetDesfireUid_PK()

UFR_STATUS DL_API uFR_int_GetDesfireUid_PK	(	IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

Provided Key mode (PK) Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChange2k3desKey_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChange2k3desKey_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des2k_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 2K3DES key on the card.

*only uFR CS with SAM support 128 bit 2K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des2k_key_nr	ordinal number of 2K3DES key in the reader
aid_key_no	key number into application that will be changed
old_des_key_nr	ordinal number of DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChange3k3desKey_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChange3k3desKey_3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des3k_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any 3K3DES key on the card.

*only uFR CS with SAM support 192 bit 3K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des3k_key_nr	ordinal number of 3K3DES key in the reader
aid_key_no	key number into application that will be changed
old_des3k_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeAesKey_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeAesKey_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_aes_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any AES key on the card.

*only uFR CS with SAM support 128 bit AES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of authentication AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_aes_key_nr	ordinal number of AES key in the reader
aid_key_no	key number into application that will be changed
old_aes_key_nr	ordinal number of AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeDesKey_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeDesKey_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des2k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

*only uFR CS with SAM support 128 bit 2K3DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key_nr	ordinal number of DES key in the reader
aid_key_no	key number into application that will be changed
old_des2k_key_nr	ordinal number of 2K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeDesKey_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeDesKey_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_no_auth,
		uint8_t	new_des_key_nr,
		uint8_t	aid_key_no,
		uint8_t	old_des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change any DES key on the card.

*only uFR CS with SAM support 64 bit DES key Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_no_auth	key number into application which uses for authentication
new_des_key_nr	ordinal number of 3K3DES key in the reader
aid_key_no	key number into application that will be changed
old_des_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettings2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettings2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. *only uFR CS with SAM support Function allows changing of file settings

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettings3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettings3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. *only uFR CS with SAM support Function allows changing of file settings

Parameters

des3k_key_nr	ordinal number of 3k3DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettingsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. *only uFR CS with SAM support Function allows changing of file settings

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettingsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	comm_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. *only uFR CS with SAM support Function allows changing of file settings

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_no	ID of file (0 – 31)
comm_settings	communication mode 0 - Plain, 1 - MACed, 3 - Enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettingsSdm()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsSdm	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_no,
		uint8_t	communication_settings,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	uid_enable,
		uint8_t	read_ctr_enable,
		uint8_t	read_ctr_limit_enable,
		uint8_t	enc_file_data_enable,
		uint8_t	meta_data_key_no,
		uint8_t	file_data_read_key_no,
		uint8_t	read_ctr_key_no,
		uint32_t	uid_offset,
		uint32_t	read_ctr_offset,
		uint32_t	picc_data_offset,
		uint32_t	mac_input_offset,
		uint32_t	enc_offset,
		uint32_t	enc_length,
		uint32_t	mac_offset,
		uint32_t	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows changing of file settings.

Desfire EV3 only. *only uFR CS with SAM support Security Dynamic Messaging settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_no	ID of file that will be created (0 - 31) ID of file (0 - 31)
communication_settings	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettings2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettings2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

*only uFR CS with SAM support 128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettings3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettings3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

*only uFR CS with SAM support 192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettingsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettingsAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

*only uFR CS with SAM support 128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettingsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettingsDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to set card master key, and application master key configuration settings.

*only uFR CS with SAM support 64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeMasterKey()

UFR_STATUS DL_API uFR_SAM_DesfireChangeMasterKey	(	uint8_t	auth_key_nr,
		uint8_t	auth_key_type,
		uint8_t	new_key_nr,
		uint8_t	new_key_type,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to change master key of the card from any type to any type.

*only uFR CS with SAM support Changing the card master key requires current card master key authentication. Authentication for the application keys changing depends on the application master key settings (which key is used for authentication). Important: When changing a card key to a 2K3DES key, the new 2K3DES key must have different first 8 bytes and second 8 bytes. For example, the new 2K3DES key should be: 11111111111111112222222222222222. New 2K3DES key must not consist of all zeros (16 0x00 bytes). From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

auth_key_nr	ordinal number of key in the reader
auth_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
new_key_nr	ordinal number of key in the reader
new_key_type	AES_KEY_TYPE = 0, //AES 16 bytes DES3K_KEY_TYPE = 1, //3K3DES 24 bytes DES_KEY_TYPE = 2, //DES 8 bytes DES2K_KEY_TYPE = 3 //2K3DES 16 bytes
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile2k3desAuth_2()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile2k3desAuth_2	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile3k3desAuth_2()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile3k3desAuth_2	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile_TransMac_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit 2K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile_TransMac_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 192 bit 3K3DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile_TransMac_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile_TransMac_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFileAesAuth_2()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileAesAuth_2	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 128 bit AES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFileDesAuth_2()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileDesAuth_2	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to reset a Linear Record File or Cyclic Record file to the empty state.

*only uFR CS with SAM support 64 bit DES key Clear command requires a preceding authentication with the key specified for Read&Write access. Bug fix from library version 5.0.29. The aid key number was omitted in function parameters, so it was used application master key number 0 for Read&Write access. For compatibility reasons old functions were retained. New function names have the “_2” suffix. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplication2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplication2k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication2k3desAuthIso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplication3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplication3k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication3k3desAuthIso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplicationAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplicationAesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationAesAuthIso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplicationDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreate3k3desApplicationDesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationDesAuthIso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplication2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplication2k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication2k3desAuthIso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplication3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplication3k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication3k3desAuthIso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplicationAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplicationAesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuthIso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplicationAesAuthIsoAscd()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuthIsoAscd	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File Identifier
iso_df_name	ISO/IEC 7816-4 DF (Dedicated File) name
iso_df_name_len	DF name length
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplicationDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateAesApplicationDesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationDesAuthIso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateBackupDataFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateBackupDataFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateBackupDataFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 128 bit AES key From library version 5.0.96, and firmware version 5.0.79.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateBackupDataFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 64 bit DES key From library version 5.0.96, and firmware version 5.0.79. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). Due to the mirror image a BackupDataFile always consumes double quantity of the card’s memory compared to a StandardDataFile with the same specified file size.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateCyclicRecordFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 128 bit 2K3DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateCyclicRecordFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 192 bit 3K3DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateCyclicRecordFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 128 bit AES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateCyclicRecordFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 64 bit DES key Once the file filled completely with data records, the card automatically overwrites the oldest record with latest written one. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplication2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplication2k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication2k3desAuthIso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplication3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplication3k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication3k3desAuthIso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplicationAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 128 bit AES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplicationAesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationAesAuthIso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplicationDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

*only uFR CS with SAM support 64 bit DES key If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateDesApplicationDesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationDesAuthIso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		uint16_t	iso_file_id,
		IN uint8_t *	iso_df_name,
		uint8_t	iso_df_name_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a new application on the card.

From library version 5.0.97, and firmware version 5.0.81. If the card master key authentication is required, depending on the card master key settings. Maximal number of applications on the card is 28. Each application is linked to a set of up 14 different user definable access keys. ISO/IEC 7816-4 File Identifier, and ISO/IEC 7816-4 DF Name for this application must be defined.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
setting	application master key settings
max_key_no	maximal number of keys into application (1 to 14)
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
iso_df_name	pointer to ISO/IEC 7816-4 DF Name array
iso_df_name_len	length of the ISO/IEC 7816-4 DF Name array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateLinearRecordFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 128 bit 2K3DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateLinearRecordFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 192 bit 3K3DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateLinearRecordFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 128 bit AES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateLinearRecordFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	record_size,
		uint32_t	max_rec_no,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for multiple storage of structural data, within an existing application.

*only uFR CS with SAM support 64 bit DES key Once the file is filled completely with data records, further writing to file is not possible unless it is cleared. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
record_size	size of record in bytes
max_rec_no	maximal number of records in file
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFile2k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile2k3desAuthIso	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFile3k3desAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile3k3desAuthIso	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 128 bit AES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFileAesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuthIso	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

aes_key_nr	ordinal number of AES key
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFileAesAuthIsoSdm()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuthIsoSdm	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Desfire EV3 only. Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 – 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created. Secure Dynamic Message can be created.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

*only uFR CS with SAM support 64 bit DES key Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateStdDataFileDesAuthIso()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileDesAuthIso	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint32_t	file_size,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		uint16_t	iso_file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create a file for the storage of unformatted user data within an existing application on the card.

Maximal number of files into the application is 32. The file will be created in the currently selected application. If the application master key authentication is required, depend on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain keys within application's keys (0 - 13). If the value is 14, this means free access, independent of previous authentication. If the value is 15, this means deny access (for example if write access is 15 then the file type is read only). ISO/IEC 7816-4 File ID for the file to be created.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that creates (3 bytes long 0x000000 to 0xFFFFFF)
file_id	ID of file that will be created (0 - 31)
file_size	file size in bytes
read_key_no	key for reading
write_key_no	key for writing
read_write_key_no	key for reading and writing
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
iso_file_id	ISO/IEC 7816-4 File ID for the file to be created
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateTransMacFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

*only uFR CS with SAM support 128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateTransMacFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

*only uFR CS with SAM support 192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateTransMacFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

*only uFR CS with SAM support 128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateTransMacFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		uint8_t	read_key_no,
		uint8_t	commit_reader_id_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		IN uint8_t *	trans_mac_key,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function creates Transaction MAC file in application.

*only uFR CS with SAM support 64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
trans_mac_key	pointer to 16 bytes array containing Transaction MAC key
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateValueFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateValueFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateValueFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireCreateValueFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		int32_t	lower_limit,
		int32_t	upper_limit,
		int32_t	value,
		uint8_t	limited_credit_enabled,
		uint8_t	read_key_no,
		uint8_t	write_key_no,
		uint8_t	read_write_key_no,
		uint8_t	change_key_no,
		uint8_t	communication_settings,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to create file for the storage and manipulation of 32 bit signed integer values within existing application on the card.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only. Maximal number of files into application is 32. The file will be created in the currently selected application. Is the application master key authentication is required, depending on the application master key settings. Communication settings define communication mode between reader and card. The communication modes are:

plain communication communication settings value is 0x00
plain communication secured by MACing communication settings value is 0x01
fully enciphered communication communication settings value is 0x03 Access rights for read, write, read&write and changing, references certain key within application's keys (0 - 13). If value is 14, this means free access, independent of previous authentication. If value is 15, this means deny access (for example if write access is 15 then the file type is read only).

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31)
lower_limit	lower limit which is valid for this file
upper_limit	upper limit which is valid for this file
value	initial value of the value file
limited_credit_enabled	bit 0 - limited credit enabled (1 - yes, 0 - no) bit 1 - free get value (1 - yes, 0 - no)
read_key_no	key for get and debit value
write_key_no	key for get, debit and limited credit value
read_write_key_no	for get, debit, limited credit and credit value
change_key_no	key for changing this setting
communication_settings	variable that contains communication settings
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile_TransMac_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile_TransMac_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile_TransMac_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFile_TransMac_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to decrease value from value files.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDecreaseValueFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to decrease value from value files.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only Debit command requires a preceding authentication with on of the keys specified for Read, Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_nr	ordinal number of 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_nr	ordinal number of 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 128 bit 2K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des2k_key_nr	ordinal number of 2K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 192 bit 3K3DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des3k_key_nr	ordinal number of 3K3DES key
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 128 bit AES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 64 bit DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplicationAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplicationAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 128 bit AES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplicationDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplicationDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to deactivate application on the card.

*only uFR CS with SAM support 64 bit DES key Is the authentication with card master key or with the application master key is required, depending on the card master key settings. AID allocation is removed, but deleted memory blocks can only recovered by using Format card function.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that deletes (3 bytes long 0x000000 to 0xFFFFFF)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

*only uFR CS with SAM support 128 bit 2K3DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

*only uFR CS with SAM support 192 bit 3K3DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

*only uFR CS with SAM support 128 bit AES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function deactivates a file within the currently selected application.

*only uFR CS with SAM support 64 bit DES key Allocated memory blocks associated with deleted file not set free. Only format card function can delete the memory blocks. Is the application master key authentication is required, depending on the application master key settings.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be deleted (0 - 31)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireFormatCard2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCard2k3desAuth	(	uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

*only uFR CS with SAM support 128 bit 2K3DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireFormatCard3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCard3k3desAuth	(	uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

*only uFR CS with SAM support 192 bit 3K3DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireFormatCardAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCardAesAuth	(	uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

*only uFR CS with SAM support 128 bit AES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

aes_key_nr	ordinal number of AES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireFormatCardDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCardDesAuth	(	uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

*only uFR CS with SAM support 64 bit DES key All applications will be deleted, also all files within those applications will be deleted. Only the card master key, and card master key settings will not be deleted. This operation requires authentication with the card master key.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetApplicationIds2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIds2k3desAuth	(	uint8_t	des2k_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetApplicationIds3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIds3k3desAuth	(	uint8_t	des3k_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetApplicationIdsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIdsAesAuth	(	uint8_t	aes_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only

Parameters

aes_key_nr	ordinal number of AES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetApplicationIdsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIdsDesAuth	(	uint8_t	des_key_nr,
		OUT uint32_t *	application_ids,
		VAR uint8_t *	number_of_aplication_ids,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns the Application Identifiers for all active applications on a card.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only

Parameters

des_key_nr	ordinal number of DES key in the reader
application_ids	array of application identifiers
number_of_aplication_ids	number of application identifiers
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetFileSettings2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettings2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

*only uFR CS with SAM support 128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetFileSettings3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettings3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

*only uFR CS with SAM support 192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetFileSettingsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

*only uFR CS with SAM support 128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetFileSettingsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR int32_t *	lower_limit,
		VAR int32_t *	upper_limit,
		VAR uint32_t *	limited_credit_value,
		VAR uint8_t *	limited_credit_enable,
		VAR uint32_t *	record_size,
		VAR uint32_t *	max_number_of_rec,
		VAR uint32_t *	curr_number_of_rec,
		VAR uint8_t *	tm_key_type,
		VAR uint8_t *	tm_key_version,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

*only uFR CS with SAM support 64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
lower_limit	value file lower limit
upper_limit	value file upper limit
limited_credit_value	value file limited credit value
limited_credit_enable	value file limited credit enable (0 - disabled, 1 - enabled)
record_size	record file size of record
max_number_of_rec	record file maximal number of record
curr_number_of_rec	record file number of used record
tm_key_type	TMC file key type AES
tm_key_version	TMC key version
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetFileSettingsSdmAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsSdmAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint8_t *	file_type,
		VAR uint8_t *	communication_mode,
		VAR uint8_t *	read_key_no,
		VAR uint8_t *	write_key_no,
		VAR uint8_t *	read_write_key_no,
		VAR uint8_t *	change_key_no,
		VAR uint32_t *	file_size,
		VAR uint8_t *	sdm_enable,
		VAR uint8_t *	uid_enable,
		VAR uint8_t *	read_ctr_enable,
		VAR uint8_t *	read_ctr_limit_enable,
		VAR uint8_t *	enc_file_data_enable,
		VAR uint8_t *	meta_data_key_no,
		VAR uint8_t *	file_data_read_key_no,
		VAR uint8_t *	read_ctr_key_no,
		VAR uint32_t *	uid_offset,
		VAR uint32_t *	read_ctr_offset,
		VAR uint32_t *	picc_data_offset,
		VAR uint32_t *	mac_input_offset,
		VAR uint32_t *	enc_offset,
		VAR uint32_t *	enc_length,
		VAR uint32_t *	mac_offset,
		VAR uint32_t *	read_ctr_limit,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function returns file settings.

*only uFR CS with SAM support 192 bit 3K3DES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_type	file type 0 - standard data file, 1 - backup data file, 2 - value file, 3 - linear record file, 4 - cyclic record file, 5 - transaction MAC file
communication_mode	communication mode 0 - plain, 1 - maced, 3 - enciphered
read_key_no	read key number
write_key_no	write key number
read_write_key_no	read write key number
change_key_no	change key number
file_size	standard data file size
sdm_enable	Secure Dynamic Messaging enable status
uid_enable	UID mirroring (0 - disabled, 1 - enabled)
read_ctr_enable	SDM reading counter (0 - disabled, 1 - enabled)
read_ctr_limit_enable	SDM reading counter limit (0 - disabled, 1 - enabled)
enc_file_data_enable	using encrypted part of file data (0 - disabled, 1 - enabled)
meta_data_key_no	key number for PICC data (UID and SDM read ctr) encryption 0 - 13, 14 no encryption, 15 no PICC data
file_data_read_key_no	key number for MAC and encrypted part of file data 0 - 13, 15 no MAC
read_ctr_key_no	key number for SDM reading counter retrieving 0 - 13, 14 free, 15 no access
uid_offset	mirror position of UID if PICC data aren’t encrypted
read_ctr_offset	mirror position of SDM reading counter if PICC data aren’t encrypted
picc_data_offset	mirror position of encrypted PICC data
mac_input_offset	offset in the file where the SDM MAC computation starts
enc_offset	mirror position of encrypted part of file data
enc_length	length of encrypted part of file data
mac_offset	mirror position of SDM MAC
read_ctr_limit	value of SDM reading counter limit
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetKeySettings2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettings2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

*only uFR CS with SAM support 128 bit 2K3DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to key settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetKeySettings3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettings3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

*only uFR CS with SAM support 192 bit 3K3DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetKeySettingsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettingsAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

*only uFR CS with SAM support 128 bit AES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetKeySettingsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettingsDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		VAR uint8_t *	setting,
		VAR uint8_t *	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to get card master key and application master key configuration settings.

*only uFR CS with SAM support 64 bit DES key In addition it returns the maximum number of keys which can be stored within the selected application. Is authentication with the master key required, depending on the master key setting.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
setting	pointer to settings variable
max_key_no	maximum number of keys within selected application
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetStdFileSize2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSize2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

*only uFR CS with SAM support 128 bit 2K3DES key

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetStdFileSize3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSize3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

*only uFR CS with SAM support 192 bit 3K3DES key

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetStdFileSizeAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSizeAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

*only uFR CS with SAM support 128 bit AES key

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireGetStdFileSizeDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSizeDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

*only uFR CS with SAM support 64 bit DES key

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
file_size	pointer to file size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile_TransMac_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile_TransMac_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile_TransMac_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFile_TransMac_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		VAR uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireIncreaseValueFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		uint32_t	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to increase a value stored in a value files.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only. Credit command requires a preceding authentication with the key specified for Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation supported for Desfire Light and Desfire EV2. To use these features, an Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	value (must be a positive number)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadRecords2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecords2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit 2K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadRecords3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecords3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 192 bit 3K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadRecordsAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecordsAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit AES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadRecordsDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecordsDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	number_of_records,
		uint16_t	record_size,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 64 bit DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
number_of_records	number of records to be read
record_size	size of record in bytes
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadStdDataFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

*only uFR CS with SAM support 128 bit 2K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadStdDataFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

*only uFR CS with SAM support 192 bit 3K3DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadStdDataFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

*only uFR CS with SAM support 128 bit AES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadStdDataFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		OUT uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows to read data from Standard Data File, or from Backup Data File.

*only uFR CS with SAM support 64 bit DES key Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadValueFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

*only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadValueFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

*only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadValueFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

*only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadValueFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint8_t	communication_settings,
		VAR int32_t *	value,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allow to read value from value files.

*only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only. Read command requires a preceding authentication either with the key specified for Read or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31)
communication_settings	variable that contains communication settings
value	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireSetConfiguration2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfiguration2k3desAuth	(	uint8_t	des2k_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

*only uFR CS with SAM support 128 bit 2K3DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireSetConfiguration3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfiguration3k3desAuth	(	uint8_t	des3k_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

*only uFR CS with SAM support 192 bit 3K3DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireSetConfigurationAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfigurationAesAuth	(	uint8_t	aes_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

*only uFR CS with SAM support 128 bit AES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireSetConfigurationDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfigurationDesAuth	(	uint8_t	des_key_nr,
		uint8_t	random_uid,
		uint8_t	format_disable,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows you to activate the Random ID option, and/or Format disable option.

*only uFR CS with SAM support 64 bit DES key If these options are activated, then they can not be returned to the factory setting (Random ID disabled, Format card enabled). This operation requires authentication with the card master key. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
random_uid	0 - Random ID disabled, 1 - Random ID enabled
format_disable	0 - Format enabled, 1 - Format disabled
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireSetTransactionTimerAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireSetTransactionTimerAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	transaction_timer,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function set value of application transaction timer.

*only uFR CS with SAM support Desfire EV3 only. At the current application specific capability data option must be enabled. Application must be created by function uFR_int_DesfireCreateAesApplication_aes_iso_ascd.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
transaction_timer	0 - disabled, 1 - 1 - 3 seconds, 2 - 10 - 30 seconds, 3 - 100 - 300 seconds
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteBackupDataFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

*only uFR CS with SAM support 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79.

Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteBackupDataFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

*only uFR CS with SAM support 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79.

Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteBackupDataFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

*only uFR CS with SAM support 128 bit AES key From library version 5.0.96, and firmware version 5.0.79.

Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteBackupDataFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to the Backup Data File.

*only uFR CS with SAM support 64 bit DES key From library version 5.0.96, and firmware version 5.0.79.

Write command requires a preceding authentication either with the key specified for Write or Read&Write access.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord_TransMac_2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord_TransMac_3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_3k3desAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord_TransMac_AesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_AesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecord_TransMac_DesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_DesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time,
		uint8_t	use_reader_id,
		OUT uint8_t *	reader_id,
		OUT uint8_t *	prev_enc_reader_id,
		OUT uint32_t *	trans_mac_cnt,
		OUT uint8_t *	trans_mac_value )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time
use_reader_id	0 - Reader ID is not used, 1- Reader ID is used
reader_id	pointer to 16 bytes array containing the Reader ID
prev_enc_reader_id	pointer to 16 bytes array containing the Previous Encrypted Reader ID
trans_mac_cnt	pointer to value of Transaction MAC counter
trans_mac_value	pointer to 8 bytes array containing Transaction MAC

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecordAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecordAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteRecordDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecordDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to a record in a Linear Record File or Cyclic Record File.

*only uFR CS with SAM support 64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported. NOTE: Transaction MAC file exist by factory default setting. For using this function, user must delete transaction MAC file first. From library version 5.0.37 and firmware version 5.0.38, Transaction MAC operation is supported for Desfire Light and Desfire EV2. To use these features, a Transaction MAC file must exist in the selected application. Function returns current Reader ID if they used, Previous Encrypted Reader ID, Transaction MAC counter, and Transaction MAC.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file that will be created (0 - 31) ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteStdDataFile2k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFile2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

*only uFR CS with SAM support 128 bit 2K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteStdDataFile3k3desAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFile3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

*only uFR CS with SAM support 192 bit 3K3DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteStdDataFileAesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFileAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

*only uFR CS with SAM support 128 bit AES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireWriteStdDataFileDesAuth()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFileDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		uint8_t	file_id,
		uint16_t	offset,
		uint16_t	data_length,
		uint8_t	communication_settings,
		IN uint8_t *	data,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function allows writing data to Standard Data File, or to Backup Data File.

*only uFR CS with SAM support 64 bit DES key Write command requires a preceding authentication either with the key specified for Write or Read&Write access. From library version 5.0.29 and firmware version 5.0.32, Desfire Light supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
aid_key_nr	key number into application
file_id	ID of file (0 - 31)
offset	start position for read operation within file
data_length	number of data to be read
communication_settings	variable that contains communication settings
data	pointer to data array
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_GetDesfireUid2k3desAuth()

UFR_STATUS DL_API uFR_SAM_GetDesfireUid2k3desAuth	(	uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

*only uFR CS with SAM support 128 bit 2K3DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_GetDesfireUid3k3desAuth()

UFR_STATUS DL_API uFR_SAM_GetDesfireUid3k3desAuth	(	uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

*only uFR CS with SAM support 192 bit 3K3DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_GetDesfireUidAesAuth()

UFR_STATUS DL_API uFR_SAM_GetDesfireUidAesAuth	(	uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

*only uFR CS with SAM support 128 bit AES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_GetDesfireUidDesAuth()

UFR_STATUS DL_API uFR_SAM_GetDesfireUidDesAuth	(	uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	aid_key_nr,
		OUT uint8_t *	card_uid,
		VAR uint8_t *	card_uid_len,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

This function returns Unique ID of card, if the Random ID is used.

*only uFR CS with SAM support 64 bit DES key Mifare Desfire EV1 card can be configured to use Random ID numbers instead Unique ID numbers during anti-collision procedure. In this case card uses single anti-collision loop, and returns Random Number Tag 0x08 and 3 bytes Random Number (4 bytes Random ID). From library version 5.0.29. and firmware version 5.0.32, Desfire Light card supported.

Parameters

des_key_nr	ordinal number of DES key in the reader
aid	ID of application that uses this key (3 bytes long, 0x000000 for card master key)
aid_key_nr	key number into application (0 for card master key or application master key)
card_uid	pointer to array containing card UID
card_uid_len	pointer to card UID length variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ KEY_TYPE

Function Documentation

◆ AES_to_DES_key_type()

◆ DES_to_AES_key_type()

◆ uFR_int_DesfireChange2K3DesKey_2k3des()

◆ uFR_int_DesfireChange2K3DesKey_2k3des_PK()

◆ uFR_int_DesfireChange2K3DesKey_des()

◆ uFR_int_DesfireChange2K3DesKey_des_PK()

◆ uFR_int_DesfireChange3K3DesKey_3k3des()

◆ uFR_int_DesfireChange3K3DesKey_3k3des_PK()

◆ uFR_int_DesfireChangeAesKey()

◆ uFR_int_DesfireChangeAesKey_A()

◆ uFR_int_DesfireChangeAesKey_aes()

◆ uFR_int_DesfireChangeAesKey_aes_PK()

◆ uFR_int_DesfireChangeAesKey_PK()

◆ uFR_int_DesfireChangeDesKey_2k3des()

◆ uFR_int_DesfireChangeDesKey_2k3des_PK()

◆ uFR_int_DesfireChangeDesKey_des()

◆ uFR_int_DesfireChangeDesKey_des_PK()

◆ uFR_int_DesfireChangeFileSettings_2k3des()

◆ uFR_int_DesfireChangeFileSettings_2k3des_PK()

◆ uFR_int_DesfireChangeFileSettings_3k3des()

◆ uFR_int_DesfireChangeFileSettings_3k3des_PK()

◆ uFR_int_DesfireChangeFileSettings_aes()

◆ uFR_int_DesfireChangeFileSettings_aes_PK()

◆ uFR_int_DesfireChangeFileSettings_des()

◆ uFR_int_DesfireChangeFileSettings_des_PK()

◆ uFR_int_DesfireChangeFileSettingsSdm()

◆ uFR_int_DesfireChangeFileSettingsSdm_PK()

◆ uFR_int_DesfireChangeKeySettings()

◆ uFR_int_DesfireChangeKeySettings_2k3des()

◆ uFR_int_DesfireChangeKeySettings_2k3des_PK()

◆ uFR_int_DesfireChangeKeySettings_3k3des()

◆ uFR_int_DesfireChangeKeySettings_3k3des_PK()

◆ uFR_int_DesfireChangeKeySettings_aes()

◆ uFR_int_DesfireChangeKeySettings_aes_PK()

◆ uFR_int_DesfireChangeKeySettings_des()

◆ uFR_int_DesfireChangeKeySettings_des_PK()

◆ uFR_int_DesfireChangeKeySettings_PK()

◆ uFR_int_DesfireChangeMasterKey()

◆ uFR_int_DesfireChangeMasterKey_PK()

◆ uFR_int_DesfireClearRecordFile()

◆ uFR_int_DesfireClearRecordFile_2k3des()

◆ uFR_int_DesfireClearRecordFile_2k3des_2()

◆ uFR_int_DesfireClearRecordFile_2k3des_PK()

◆ uFR_int_DesfireClearRecordFile_2k3des_PK_2()

◆ uFR_int_DesfireClearRecordFile_3k3des()

◆ uFR_int_DesfireClearRecordFile_3k3des_2()

◆ uFR_int_DesfireClearRecordFile_3k3des_PK()

◆ uFR_int_DesfireClearRecordFile_3k3des_PK_2()

◆ uFR_int_DesfireClearRecordFile_aes()

◆ uFR_int_DesfireClearRecordFile_aes_2()

◆ uFR_int_DesfireClearRecordFile_aes_PK()

◆ uFR_int_DesfireClearRecordFile_aes_PK_2()

◆ uFR_int_DesfireClearRecordFile_des()

◆ uFR_int_DesfireClearRecordFile_des_2()

◆ uFR_int_DesfireClearRecordFile_des_PK()

◆ uFR_int_DesfireClearRecordFile_des_PK_2()

◆ uFR_int_DesfireClearRecordFile_no_auth()

◆ uFR_int_DesfireClearRecordFile_PK()

◆ uFR_int_DesfireClearRecordFile_TransMac_2k3des()

◆ uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK()

◆ uFR_int_DesfireClearRecordFile_TransMac_3k3des()

◆ uFR_int_DesfireClearRecordFile_TransMac_3k3des_PK()

◆ uFR_int_DesfireClearRecordFile_TransMac_aes()

◆ uFR_int_DesfireClearRecordFile_TransMac_aes_PK()

◆ uFR_int_DesfireClearRecordFile_TransMac_des()

◆ uFR_int_DesfireClearRecordFile_TransMac_des_PK()

◆ uFR_int_DesfireCreate3k3desApplication_2k3des()

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_iso()

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_iso_PK()

◆ uFR_int_DesfireCreate3k3desApplication_2k3des_PK()

◆ uFR_int_DesfireCreate3k3desApplication_3k3des()

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_iso()

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK()

◆ uFR_int_DesfireCreate3k3desApplication_3k3des_PK()