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...

Functions
UFR_STATUS DL_API	uFR_int_DesfireChange2K3DesKey_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_DesfireChange2K3DesKey_desM (UFR_HANDLE hndUFR, 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_DesfireChange3K3DesKey_3k3des_PK_M (UFR_HANDLE hndUFR, 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_DesfireChange3K3DesKey_3k3desM (UFR_HANDLE hndUFR, 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_DesfireChangeAesKey_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireChangeAesKeyM (UFR_HANDLE hndUFR, 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_DesfireChangeDesKey_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_DesfireChangeDesKey_desM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettings_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. Function allows changing of file settings.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettings_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettings_desM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettingsSdm_PK_M (UFR_HANDLE hndUFR, 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.

UFR_STATUS DL_API	uFR_int_DesfireChangeFileSettingsSdmM (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettings_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettingsM (UFR_HANDLE hndUFR, 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_DesfireChangeMasterKey_PK_M (UFR_HANDLE hndUFR, 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_DesfireChangeMasterKeyM (UFR_HANDLE hndUFR, 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_DesfireClearRecordFile_2k3des_2M (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_2M (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_2M (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_2M (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_authM (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_TransMac_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_DesfireClearRecordFile_TransMac_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, uint32_t aid, 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_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_3k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_iso_PK_M (UFR_HANDLE hndUFR, 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)
	From library version 5.0.97, and firmware version 5.0.81. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aes_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_aesM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_no_auth_isoM (UFR_HANDLE hndUFR, 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.

UFR_STATUS DL_API	uFR_int_DesfireCreate3k3desApplication_no_auth_M (UFR_HANDLE hndUFR, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Multi reader support. No authentication 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_3k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_iso_ascd_PK_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_isoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aes_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_aesM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_no_auth_isoM (UFR_HANDLE hndUFR, 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_no_auth_M (UFR_HANDLE hndUFR, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Multi reader support. No authentication 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplication_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateAesApplicationM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_3k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_3k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_aes_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key provided key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_aesM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateBackupDataFile_no_auth_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. No authentication From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateCyclicRecordFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_authM (UFR_HANDLE hndUFR, 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_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_3k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_iso_PK_M (UFR_HANDLE hndUFR, 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aes_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_aesM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_iso_PK_M (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_isoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key provided key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_no_auth_isoM (UFR_HANDLE hndUFR, 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)
	Multi reader support 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateDesApplication_no_auth_M (UFR_HANDLE hndUFR, uint32_t aid, uint8_t setting, uint8_t max_key_no, VAR uint16_t card_status, VAR uint16_t exec_time)
	Multi reader support. No authentication 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.

UFR_STATUS DL_API	uFR_int_DesfireCreateLinearRecordFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_authM (UFR_HANDLE hndUFR, 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_2k3des_iso_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des_isoM (UFR_HANDLE hndUFR, 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)
	Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key provided key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_iso_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_isoM (UFR_HANDLE hndUFR, 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)
	Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key provided key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_3k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 192 bit 3K3DES key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_sdm_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_iso_sdmM (UFR_HANDLE hndUFR, 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)
	Multi reader support. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_isoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aes_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key provided key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_aesM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit AES key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_iso_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_isoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_des_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key provided key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 64 bit DES key 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_no_auth_isoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. From library version 5.0.96, and firmware version 5.0.81. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_no_auth_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. No authentication 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFile_PK_M (UFR_HANDLE hndUFR, 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)
	Multi reader support. Provided Key mode (PK) 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateStdDataFileM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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:

UFR_STATUS DL_API	uFR_int_DesfireCreateTransMacFile_2k3des_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireCreateValueFileM (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_int_DesfireDecreaseValueFile_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFileM (UFR_HANDLE hndUFR, 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_DesfireDeleteApplication_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireDeleteApplicationM (UFR_HANDLE hndUFR, 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_DesfireDeleteFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireDeleteFileM (UFR_HANDLE hndUFR, 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_DesfireFormatCard_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireFormatCardM (UFR_HANDLE hndUFR, 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_DesfireFreeMemM (UFR_HANDLE hndUFR, VAR uint32_t free_mem_byte, VAR uint16_t card_status, VAR uint16_t *exec_time)
	Multi reader support. Function returns the available bytes on the card.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_2k3aes_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 128 bit 2K3DES key For uFR PLUS devices only.

UFR_STATUS DL_API	uFR_int_DesfireGetApplicationIds_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireGetApplicationIdsM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettings_2k3des_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireGetKeySettingsM (UFR_HANDLE hndUFR, 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_DesfireGetStdFileSize_2k3des_M (UFR_HANDLE hndUFR, uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, IN uint8_t des2k_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, IN uint8_t des3k_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, IN uint8_t aes_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, IN uint8_t des_key_ext, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_M (UFR_HANDLE hndUFR, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_DesfireIncreaseValueFileM (UFR_HANDLE hndUFR, 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_DesfireReadRecords_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_authM (UFR_HANDLE hndUFR, 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, uint8_t data, uint16_t card_status, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireReadStddDataFile_aesM (UFR_HANDLE hndUFR, 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)
	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.

UFR_STATUS DL_API	uFR_int_DesfireReadStddDataFileM (UFR_HANDLE hndUFR, 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)
	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.

UFR_STATUS DL_API	uFR_int_DesfireReadValueFile_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireReadValueFileM (UFR_HANDLE hndUFR, 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_DesfireRidReadECCSignature_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_DesfireSetConfiguration_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireSetConfigurationM (UFR_HANDLE hndUFR, 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_DesfireSetTransactionTimer_aes_PK_M (UFR_HANDLE hndUFR, 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_DesfireSetTransactionTimer_aesM (UFR_HANDLE hndUFR, 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_DesfireUidReadECCSignatureM (UFR_HANDLE hndUFR, 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_DesfireWriteAesKeyM (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_DesfireWriteKeyM (UFR_HANDLE hndUFR, uint8_t key_no, IN uint8_t *key, uint8_t key_type)
	Multi reader support. Function writes AES key (16 bytes) into reader.

UFR_STATUS DL_API	uFR_int_DesfireWriteRecord_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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, 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_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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, 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_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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, 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_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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, 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_authM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_no_auth_M (UFR_HANDLE hndUFR, 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_M (UFR_HANDLE hndUFR, 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_DesfireWriteStdDataFileM (UFR_HANDLE hndUFR, 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_GetDesfireUid_2k3des_PK_M (UFR_HANDLE hndUFR, 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_2k3desM (UFR_HANDLE hndUFR, 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_3k3des_PK_M (UFR_HANDLE hndUFR, 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_3k3desM (UFR_HANDLE hndUFR, IN 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_aes_PK_M (UFR_HANDLE hndUFR, 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_aesM (UFR_HANDLE hndUFR, 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_des_PK_M (UFR_HANDLE hndUFR, 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_desM (UFR_HANDLE hndUFR, 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_PK_M (UFR_HANDLE hndUFR, 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_GetDesfireUidM (UFR_HANDLE hndUFR, 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_DesfireChange2k3desKey_2k3desAuthM (UFR_HANDLE hndUFR, uint8_t des2k_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_des2k_key_nr, VAR uint16_t card_status, VAR uint16_t exec_time)
	*only uFR CS with SAM support 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireChange2k3desKey_DesAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_2k3desAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettings2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettings3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettingsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettingsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeFileSettingsSdmM (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettings2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettings3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettingsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeKeySettingsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireChangeMasterKeyM (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_DesfireClearRecordFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireClearRecordFile_TransMac_2k3desAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_2M (UFR_HANDLE hndUFR, 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_DesfireClearRecordFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireClearRecordFileDesAuth_2M (UFR_HANDLE hndUFR, 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_DesfireCreate3k3desApplication2k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication2k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication3k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplication3k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationAesAuthIsoM (UFR_HANDLE hndUFR, 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)
	From library version 5.0.97, and firmware version 5.0.81. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationAesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit AES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationDesAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreate3k3desApplicationDesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 64 bit DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication2k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication2k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication3k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplication3k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuthIsoAscdM (UFR_HANDLE hndUFR, 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)
	Multi reader support 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationAesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit AES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationDesAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateAesApplicationDesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 64 bit DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFile2k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFile3k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFileAesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit AES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateBackupDataFileDesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 64 bit DES key From library version 5.0.96, and firmware version 5.0.79. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateCyclicRecordFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateCyclicRecordFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateCyclicRecordFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateCyclicRecordFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateDesApplication2k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication2k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication3k3desAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplication3k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationAesAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationAesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit AES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationDesAuthIsoM (UFR_HANDLE hndUFR, 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. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateDesApplicationDesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 64 bit DES key 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateLinearRecordFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateLinearRecordFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateLinearRecordFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateLinearRecordFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateStdDataFile2k3desAuthIsoM (UFR_HANDLE hndUFR, 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile2k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile3k3desAuthIsoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFile3k3desAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuthIsoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuthIsoSdmM (UFR_HANDLE hndUFR, 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)
	Multi reader support. Desfire EV3 only. 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileAesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 128 bit AES key 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileDesAuthIsoM (UFR_HANDLE hndUFR, 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)
	Multi reader support. 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.

UFR_STATUS DL_API	uFR_SAM_DesfireCreateStdDataFileDesAuthM (UFR_HANDLE hndUFR, 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)
	Multi reader support. *only uFR CS with SAM support 64 bit DES key 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:

UFR_STATUS DL_API	uFR_SAM_DesfireCreateTransMacFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateTransMacFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateTransMacFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateTransMacFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateValueFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateValueFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateValueFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireCreateValueFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFile3k3desAuthM (UFR_HANDLE hndUFR, 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_2k3desAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireDecreaseValueFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteApplication3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_2k3desAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteApplicationd2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteApplicationDesAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireDeleteFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireFormatCard2k3desAuthM (UFR_HANDLE hndUFR, 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_SAM_DesfireFormatCard3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireFormatCardAesAuthM (UFR_HANDLE hndUFR, 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_DesfireFormatCardDesAuthM (UFR_HANDLE hndUFR, 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_SAM_DesfireGetApplicationIds2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetApplicationIds3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetApplicationIdsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetApplicationIdsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettings2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettings3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettingsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettingsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetFileSettingsSdmAesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetKeySettings2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetKeySettings3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireGetKeySettingsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetKeySettingsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireGetStdFileSize2k3desAuthM (UFR_HANDLE hndUFR, uint8_t des2k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_DesfireGetStdFileSize3k3desAuthM (UFR_HANDLE hndUFR, uint8_t des3k_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_DesfireGetStdFileSizeAesAuthM (UFR_HANDLE hndUFR, uint8_t aes_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_DesfireGetStdFileSizeDesAuthM (UFR_HANDLE hndUFR, uint8_t des_key_nr, uint32_t aid, uint8_t file_id, VAR uint32_t file_size, uint16_t card_status, 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_DesfireIncreaseValueFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireIncreaseValueFile3k3desAuthM (UFR_HANDLE hndUFR, 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_2k3desAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_DesfireIncreaseValueFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireIncreaseValueFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadRecords2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadRecords3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadRecordsAesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadRecordsDesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadStdDataFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadStdDataFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadStdDataFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadStdDataFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadValueFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadValueFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireReadValueFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireReadValueFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireSetConfiguration2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireSetConfiguration3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireSetConfigurationAesAuthM (UFR_HANDLE hndUFR, 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_DesfireSetConfigurationDesAuthM (UFR_HANDLE hndUFR, 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_DesfireSetTransactionTimerAesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteBackupDataFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteBackupDataFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteBackupDataFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteBackupDataFileDesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteRecord2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteRecord3k3desAuthM (UFR_HANDLE hndUFR, 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_2k3desAuthM (UFR_HANDLE hndUFR, 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_3k3desAuthM (UFR_HANDLE hndUFR, 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_AesAuthM (UFR_HANDLE hndUFR, 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_DesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteRecordAesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteRecordDesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteStdDataFile2k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteStdDataFile3k3desAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteStdDataFileAesAuthM (UFR_HANDLE hndUFR, 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_DesfireWriteStdDataFileDesAuthM (UFR_HANDLE hndUFR, 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_GetDesfireUid2k3desAuthM (UFR_HANDLE hndUFR, 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_GetDesfireUid3k3desAuthM (UFR_HANDLE hndUFR, 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_GetDesfireUidAesAuthM (UFR_HANDLE hndUFR, 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_GetDesfireUidDesAuthM (UFR_HANDLE hndUFR, 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.

Function Documentation

◆ uFR_int_DesfireChange2K3DesKey_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
auth_des2k_key_nr	key index of DES key stored in the reader that will be used for authentication
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	key index of 2K3DES key stored in the reader that will be new 2K3DES key
aid_key_no	key number into application that will be changed
old_2k3des_key_nr	key index of 2K3DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange2K3DesKey_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChange2K3DesKey_desM()

UFR_STATUS DL_API uFR_int_DesfireChange2K3DesKey_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
auth_des_key_nr	ordinal number of authentication 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_2k3des_key_nr	key index of 2K3DES key stored in the reader that will be new 2K3DES key
aid_key_no	key number into application that will be changed
old_2k3des_key_nr	key index of 2K3DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChange3K3DesKey_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChange3K3DesKey_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChange3K3DesKey_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireChange3K3DesKey_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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	key index of 3K3DES key stored in the reader that will be new 3K3DES key
aid_key_no	key number into application that will be changed
old_3k3des_key_nr	key index of 3K3DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeAesKey_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_int_DesfireChangeAesKey_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKey_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeAesKeyM()

UFR_STATUS DL_API uFR_int_DesfireChangeAesKeyM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeDesKey_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
auth_des2k_key_nr	key index of DES key stored in the reader that will be used for authentication
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	index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeDesKey_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeDesKey_desM()

UFR_STATUS DL_API uFR_int_DesfireChangeDesKey_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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	key index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeFileSettings_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Function allows changing of file settings.

Parameters

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettings_desM()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettings_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettingsSdm_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettingsSdm_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. Security Dynamic Messaging settings.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettingsSdmM()

UFR_STATUS DL_API uFR_int_DesfireChangeFileSettingsSdmM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. Security Dynamic Messaging settings.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeKeySettings_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_aesM()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_desM()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettings_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettings_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. Provided Key mode (PK)

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeKeySettingsM()

UFR_STATUS DL_API uFR_int_DesfireChangeKeySettingsM	(	UFR_HANDLE	hndUFR,
		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.

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

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireChangeMasterKey_PK_M()

UFR_STATUS DL_API uFR_int_DesfireChangeMasterKey_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeMasterKeyM()

UFR_STATUS DL_API uFR_int_DesfireChangeMasterKeyM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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	key index of the key stored 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_DesfireClearRecordFile_2k3des_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_PK_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3des_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_PK_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aes_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_PK_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_aesM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_des_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_PK_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_no_authM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_no_authM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

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

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_PK_2M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_PK_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireClearRecordFile_TransMac_desM()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireClearRecordFile_TransMac_no_auth_M	(	UFR_HANDLE	hndUFR,
		uint32_t	aid,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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
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_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_DesfireCreate3k3desApplication_3k3des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_3k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_DesfireCreate3k3desApplication_aes_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

From library version 5.0.97, and firmware version 5.0.81. 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.

Parameters

hndUFR	handle of the uFR device
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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key provided key 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_aesM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreate3k3desApplication_des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreate3k3desApplication_desM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_DesfireCreate3k3desApplication_no_auth_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_no_auth_isoM	(	UFR_HANDLE	hndUFR,
		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.

Parameters

hndUFR	handle of the uFR device
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	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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireCreate3k3desApplication_no_auth_M	(	UFR_HANDLE	hndUFR,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Multi reader support. No authentication 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

hndUFR	hndUFR handle of the uFR device
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_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_3k3des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_3k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_aes_iso_ascd_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso_ascd_PK_M	(	UFR_HANDLE	hndUFR,
		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. Multi reader support

Parameters

hndUFR	handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key provided key 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_aesM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplication_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_no_auth_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_no_auth_isoM	(	UFR_HANDLE	hndUFR,
		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.

Parameters

hndUFR	handle of the uFR device
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	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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_no_auth_M	(	UFR_HANDLE	hndUFR,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Multi reader support. No authentication 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplication_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateAesApplicationM()

UFR_STATUS DL_API uFR_int_DesfireCreateAesApplicationM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateBackupDataFile_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key provided key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key provided key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateBackupDataFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. No authentication From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_authM()

UFR_STATUS DL_API uFR_int_DesfireCreateCyclicRecordFile_no_authM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_DesfireCreateDesApplication_3k3des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_3k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_DesfireCreateDesApplication_aes_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Parameters

hndUFR	handle of the uFR device
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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key provided key 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_aesM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateDesApplication_des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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	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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_isoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key provided key 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

hndUFR	hndUFR handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES 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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireCreateDesApplication_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_DesfireCreateDesApplication_no_auth_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_no_auth_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support 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.

Parameters

hndUFR	handle of the uFR device
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	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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireCreateDesApplication_no_auth_M	(	UFR_HANDLE	hndUFR,
		uint32_t	aid,
		uint8_t	setting,
		uint8_t	max_key_no,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Multi reader support. No authentication 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateLinearRecordFile_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_authM()

UFR_STATUS DL_API uFR_int_DesfireCreateLinearRecordFile_no_authM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3des_iso_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
des3k_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_3k3des_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key provided key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_iso_sdm_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_sdm_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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. Secure Dynamic Message can be created.

Parameters

hndUFR	hndUFR handle of the uFR device
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_iso_sdmM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_iso_sdmM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Desfire EV3 only. 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. Secure Dynamic Message can be created.

Parameters

hndUFR	handle of the uFR device
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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. From library version 5.0.96, and firmware version 5.0.81. Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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 [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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key provided key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_iso_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Desfire EV3 only. 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

hndUFR	handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key provided key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_isoM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_no_auth_isoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. From library version 5.0.96, and firmware version 5.0.81. 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. No authentication 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFile_PK_M	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Provided Key mode (PK) 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_DesfireCreateStdDataFileM()

UFR_STATUS DL_API uFR_int_DesfireCreateStdDataFileM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_2k3des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multireader support. 128 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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)
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_3k3des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_aes_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateTransMacFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateValueFileM()

UFR_STATUS DL_API uFR_int_DesfireCreateValueFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFile_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFile_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFile_TransMac_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFileM()

UFR_STATUS DL_API uFR_int_DesfireDecreaseValueFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireDeleteApplication_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_aesM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des2k_key_ext	pointer to 16 bytes array containing the 2K3DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des3k_key_ext	pointer to 24 bytes array containing the 3K3DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_aesM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_app_master_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_app_master_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des_key_ext	pointer to 8 bytes array containing the DES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplication_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplication_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteApplicationM()

UFR_STATUS DL_API uFR_int_DesfireDeleteApplicationM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_aesM()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key provided key 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_desM()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

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

Returns: Operation status

◆ uFR_int_DesfireDeleteFile_PK_M()

UFR_STATUS DL_API uFR_int_DesfireDeleteFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireDeleteFileM()

UFR_STATUS DL_API uFR_int_DesfireDeleteFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireFormatCard_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_2k3desM	(	UFR_HANDLE	hndUFR,
		uint8_t	des2k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader 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

hndUFR	handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_3k3desM	(	UFR_HANDLE	hndUFR,
		uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader 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

hndUFR	handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_aesM	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader 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

hndUFR	handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_desM	(	UFR_HANDLE	hndUFR,
		uint8_t	des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader 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

hndUFR	handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireFormatCard_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_DesfireFormatCardM()

UFR_STATUS DL_API uFR_int_DesfireFormatCardM	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader support. 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

hndUFR	handle of the uFR device
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_DesfireFreeMemM()

UFR_STATUS DL_API uFR_int_DesfireFreeMemM	(	UFR_HANDLE	hndUFR,
		VAR uint32_t *	free_mem_byte,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Multi reader support. Function returns the available bytes on the card.

Parameters

hndUFR	handle of the uFR device
free_mem_byte	pointer to free memory size variable
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireGetApplicationIds_2k3aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_2k3aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_2k3desM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 128 bit 2K3DES key For uFR PLUS devices only.

Parameters

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key provided key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key provided key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
application_ids	pointer to 8 bytes array containing the DES key
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key provided key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. No authentication For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIds_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. Provided Key mode (PK) For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
aes_key_ext	pointer to 16 bytes array containing the AES key
application_ids	pointer to 8 bytes array containing the DES key
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_DesfireGetApplicationIdsM()

UFR_STATUS DL_API uFR_int_DesfireGetApplicationIdsM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_2k3des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_3k3des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 192 bit 3K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_aes_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit AES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_des_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 64 bit DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettings_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. No authentication

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettingsSdm_aes_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetFileSettingsSdm_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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	application key settings
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettings_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireGetKeySettingsM()

UFR_STATUS DL_API uFR_int_DesfireGetKeySettingsM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	application key settings
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_2k3des_M	(	UFR_HANDLE	hndUFR,
		uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		IN uint8_t *	des2k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 128 bit 2K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_3k3des_M	(	UFR_HANDLE	hndUFR,
		uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		IN uint8_t *	des3k_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 192 bit 3K3DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_aes_M	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_aes_PK_M	(	UFR_HANDLE	hndUFR,
		IN uint8_t *	aes_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 128 bit AES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_des_M	(	UFR_HANDLE	hndUFR,
		uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_des_PK_M	(	UFR_HANDLE	hndUFR,
		IN uint8_t *	des_key_ext,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. 64 bit DES key provided key

Parameters

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireGetStdFileSize_no_auth_M	(	UFR_HANDLE	hndUFR,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. No authentication

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFile_TransMac_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireIncreaseValueFileM()

UFR_STATUS DL_API uFR_int_DesfireIncreaseValueFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadRecords_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_no_authM()

UFR_STATUS DL_API uFR_int_DesfireReadRecords_no_authM	(	UFR_HANDLE	hndUFR,
		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,
		uint8_t *	data,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function allows to read data from a record in a Linear Record File or Cyclic Record File.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_aesM()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_desM()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireReadStdDataFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireReadStddDataFile_aesM()

UFR_STATUS DL_API uFR_int_DesfireReadStddDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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 )

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

hndUFR	hndUFR handle of the uFR device
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)
offset	start position for read operation within file
data_length	number of bytes into array
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_DesfireReadStddDataFileM()

UFR_STATUS DL_API uFR_int_DesfireReadStddDataFileM	(	UFR_HANDLE	hndUFR,
		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 )

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

hndUFR	hndUFR handle of the uFR device
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)
offset	start position for read operation within file
data_length	number of bytes into array
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_int_DesfireReadValueFile_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_int_DesfireReadValueFile_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_aesM()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFile_desM()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_int_DesfireReadValueFile_no_auth_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireReadValueFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireReadValueFileM()

UFR_STATUS DL_API uFR_int_DesfireReadValueFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_int_DesfireRidReadECCSignature_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_2k3desM	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_3k3desM	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_aesM	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_M()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_des_PK_M	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireRidReadECCSignature_desM	(	UFR_HANDLE	hndUFR,
		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).

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetConfiguration_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetConfigurationM()

UFR_STATUS DL_API uFR_int_DesfireSetConfigurationM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetTransactionTimer_aes_PK_M()

UFR_STATUS DL_API uFR_int_DesfireSetTransactionTimer_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetTransactionTimer_aesM()

UFR_STATUS DL_API uFR_int_DesfireSetTransactionTimer_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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_DesfireUidReadECCSignatureM()

UFR_STATUS DL_API uFR_int_DesfireUidReadECCSignatureM	(	UFR_HANDLE	hndUFR,
		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). .

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireWriteAesKeyM()

UFR_STATUS DL_API uFR_int_DesfireWriteAesKeyM	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_no,
		IN uint8_t *	aes_key )

Function writes AES key (16 bytes) into reader.

Parameters

hndUFR	hndUFR handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_aesM()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_desM()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireWriteBackupDataFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. Provided Key mode (PK) 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteKeyM()

UFR_STATUS DL_API uFR_int_DesfireWriteKeyM	(	UFR_HANDLE	hndUFR,
		uint8_t	key_no,
		IN uint8_t *	key,
		uint8_t	key_type )

Multi reader support. Function writes AES key (16 bytes) into reader.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireWriteRecord_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_2k3desM	(	UFR_HANDLE	hndUFR,
		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,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_3k3desM	(	UFR_HANDLE	hndUFR,
		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,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_aesM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_aesM	(	UFR_HANDLE	hndUFR,
		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,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_desM	(	UFR_HANDLE	hndUFR,
		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,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_authM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_no_authM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_PK_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_aesM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_desM()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteRecord_TransMac_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desM()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_3k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_aesM()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_desM()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_no_auth_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_M()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFile_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteStdDataFileM()

UFR_STATUS DL_API uFR_int_DesfireWriteStdDataFileM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3des_PK_M()

UFR_STATUS DL_API uFR_int_GetDesfireUid_2k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_2k3desM()

UFR_STATUS DL_API uFR_int_GetDesfireUid_2k3desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	handle of the uFR device
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_3k3des_PK_M()

UFR_STATUS DL_API uFR_int_GetDesfireUid_3k3des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_3k3desM()

UFR_STATUS DL_API uFR_int_GetDesfireUid_3k3desM	(	UFR_HANDLE	hndUFR,
		IN 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.

Multi reader 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

hndUFR	handle of the uFR device
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_aes_PK_M()

UFR_STATUS DL_API uFR_int_GetDesfireUid_aes_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_aesM()

UFR_STATUS DL_API uFR_int_GetDesfireUid_aesM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	handle of the uFR device
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_des_PK_M()

UFR_STATUS DL_API uFR_int_GetDesfireUid_des_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_desM()

UFR_STATUS DL_API uFR_int_GetDesfireUid_desM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader 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

hndUFR	handle of the uFR device
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_PK_M()

UFR_STATUS DL_API uFR_int_GetDesfireUid_PK_M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_GetDesfireUidM()

UFR_STATUS DL_API uFR_int_GetDesfireUidM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. 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

hndUFR	handle of the uFR device
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_DesfireChange2k3desKey_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChange2k3desKey_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des2k_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_des2k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

*only uFR CS with SAM support 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
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_des2k_key_nr	key index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des2k_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChange2k3desKey_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChange2k3desKey_DesAuthM	(	UFR_HANDLE	hndUFR,
		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

hndUFR	hndUFR handle of the uFR device
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	key index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChange3k3desKey_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChange3k3desKey_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	key index of 3K3DES key stored in the reader that will be new 3K3DES key
aid_key_no	key number into application that will be changed
old_des3k_key_nr	key index of 3K3DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeAesKey_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeAesKey_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	key index of AES key stored in the reader that will be new AES key
aid_key_no	key number into application that will be changed
old_aes_key_nr	key index of AES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeDesKey_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeDesKey_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	key index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des2k_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeDesKey_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeDesKey_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	index of DES key stored in the reader that will be new DES key
aid_key_no	key number into application that will be changed
old_des_key_nr	key index of DES key stored in the reader that will be used for authentication
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeFileSettings2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettings2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettings3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettings3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettingsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettingsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeFileSettingsSdmM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeFileSettingsSdmM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support Security Dynamic Messaging settings.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireChangeKeySettings2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettings2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettings3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettings3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettingsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettingsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeKeySettingsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeKeySettingsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireChangeMasterKeyM()

UFR_STATUS DL_API uFR_SAM_DesfireChangeMasterKeyM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	key index of a key stored in the reader that will be new 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_SAM_DesfireClearRecordFile2k3desAuth_2M()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile2k3desAuth_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile3k3desAuth_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireClearRecordFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFile_TransMac_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFile_TransMac_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_2M()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileAesAuth_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireClearRecordFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireClearRecordFileDesAuth_2M()

UFR_STATUS DL_API uFR_SAM_DesfireClearRecordFileDesAuth_2M	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreate3k3desApplication2k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication2k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_DesfireCreate3k3desApplication2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_SAM_DesfireCreate3k3desApplication3k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication3k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_DesfireCreate3k3desApplication3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplication3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_SAM_DesfireCreate3k3desApplicationAesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationAesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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 )

From library version 5.0.97, and firmware version 5.0.81. 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.

Parameters

hndUFR	handle of the uFR device
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	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_DesfireCreate3k3desApplicationAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationAesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireCreate3k3desApplicationDesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationDesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_DesfireCreate3k3desApplicationDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreate3k3desApplicationDesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_SAM_DesfireCreateAesApplication2k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication2k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_DesfireCreateAesApplication2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_SAM_DesfireCreateAesApplication3k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication3k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_DesfireCreateAesApplication3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplication3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_SAM_DesfireCreateAesApplicationAesAuthIsoAscdM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuthIsoAscdM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support 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

hndUFR	handle of the uFR device
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_DesfireCreateAesApplicationAesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
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	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_DesfireCreateAesApplicationAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationAesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireCreateAesApplicationDesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationDesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_DesfireCreateAesApplicationDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateAesApplicationDesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_SAM_DesfireCreateBackupDataFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_DesfireCreateBackupDataFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_DesfireCreateBackupDataFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit AES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_DesfireCreateBackupDataFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateBackupDataFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 64 bit DES key From library version 5.0.96, and firmware version 5.0.79. 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). 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

hndUFR	hndUFR handle of the uFR device
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 [m]
write_key_no	key for writing [n]
read_write_key_no	key for reading and writing [o]
change_key_no	key for changing this setting [p]
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_DesfireCreateCyclicRecordFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateCyclicRecordFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateCyclicRecordFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateCyclicRecordFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateCyclicRecordFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateDesApplication2k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication2k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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	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_DesfireCreateDesApplication2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES 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_SAM_DesfireCreateDesApplication3k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication3k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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	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_DesfireCreateDesApplication3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplication3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES 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_SAM_DesfireCreateDesApplicationAesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationAesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
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	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_DesfireCreateDesApplicationAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationAesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireCreateDesApplicationDesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationDesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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. 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

hndUFR	handle of the uFR device
des_key_nr	ordinal number of DES 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	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_DesfireCreateDesApplicationDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateDesApplicationDesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES 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_SAM_DesfireCreateLinearRecordFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateLinearRecordFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateLinearRecordFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateLinearRecordFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateLinearRecordFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateStdDataFile2k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile2k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireCreateStdDataFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_DesfireCreateStdDataFile3k3desAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile3k3desAuthIsoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
des3k_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_SAM_DesfireCreateStdDataFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_DesfireCreateStdDataFileAesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Desfire EV3 only. 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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateStdDataFileAesAuthIsoSdmM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuthIsoSdmM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. Desfire EV3 only. 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. Secure Dynamic Message can be created.

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateStdDataFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 128 bit AES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_DesfireCreateStdDataFileDesAuthIsoM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileDesAuthIsoM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. 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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireCreateStdDataFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateStdDataFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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 )

Multi reader support. *only uFR CS with SAM support 64 bit DES key 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

hndUFR	hndUFR handle of the uFR device
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 [a]
write_key_no	key for writing [b]
read_write_key_no	key for reading and writing [c]
change_key_no	key for changing this setting [d]
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_DesfireCreateTransMacFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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)
read_key_no	key for reading
commit_reader_id_key_no	key for commit Reader ID command
change_key_no	ey 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_DesfireCreateTransMacFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateTransMacFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateTransMacFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateTransMacFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateValueFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateValueFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateValueFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireCreateValueFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireCreateValueFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFile_TransMac_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireDecreaseValueFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDecreaseValueFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireDeleteApplication3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplication_app_master_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplication_app_master_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplicationd2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplicationd2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteApplicationDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteApplicationDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
aid	ID of application that contains the file
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireDeleteFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireDeleteFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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)
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireFormatCard2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCard2k3desAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des2k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader support. *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

hndUFR	handle of the uFR device
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_DesfireFormatCard3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCard3k3desAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des3k_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader support. *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

hndUFR	handle of the uFR device
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_DesfireFormatCardAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCardAesAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader support. *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

hndUFR	handle of the uFR device
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_DesfireFormatCardDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireFormatCardDesAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des_key_nr,
		VAR uint16_t *	card_status,
		VAR uint16_t *	exec_time )

Function releases all allocated user memory on the card.

Multi reader support. *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

hndUFR	handle of the uFR device
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_DesfireGetApplicationIds2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIds2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
des2k_key_nr	ordinal number of 2K3DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_DesfireGetApplicationIds3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIds3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
des3k_key_nr	ordinal number of 3K3DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_DesfireGetApplicationIdsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIdsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit AES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
aes_key_nr	ordinal number of AES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_DesfireGetApplicationIdsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetApplicationIdsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 64 bit DES key For uFR PLUS devices only

Parameters

hndUFR	hndUFR handle of the uFR device
des_key_nr	ordinal number of DES key in the reader
application_ids	pointer to 8 bytes array containing the DES key
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_DesfireGetFileSettings2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettings2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetFileSettings3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettings3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetFileSettingsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetFileSettingsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetFileSettingsSdmAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetFileSettingsSdmAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetKeySettings2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettings2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_SAM_DesfireGetKeySettings3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettings3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireGetKeySettingsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettingsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireGetKeySettingsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetKeySettingsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireGetStdFileSize2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSize2k3desAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des2k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. *only uFR CS with SAM support 128 bit 2K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetStdFileSize3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSize3k3desAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des3k_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. *only uFR CS with SAM support 192 bit 3K3DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetStdFileSizeAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSizeAesAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	aes_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. *only uFR CS with SAM support 128 bit AES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireGetStdFileSizeDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireGetStdFileSizeDesAuthM	(	UFR_HANDLE	hndUFR,
		uint8_t	des_key_nr,
		uint32_t	aid,
		uint8_t	file_id,
		VAR uint32_t *	file_size,
		uint16_t *	card_status,
		uint16_t *	exec_time )

Function retrieves the information about the size of the standard data file stored on the tag.

Multi reader support. *only uFR CS with SAM support 64 bit DES key

Parameters

hndUFR	hndUFR handle of the uFR device
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_DesfireIncreaseValueFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireIncreaseValueFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFile_TransMac_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireIncreaseValueFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireIncreaseValueFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireIncreaseValueFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadRecords2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecords2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadRecords3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecords3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadRecordsAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecordsAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadRecordsDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadRecordsDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadStdDataFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireReadStdDataFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireReadStdDataFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireReadStdDataFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadStdDataFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireReadValueFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadValueFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireReadValueFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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	pointer to value
card_status	pointer to card error variable
exec_time	function's execution time

Returns: Operation status

◆ uFR_SAM_DesfireReadValueFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireReadValueFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetConfiguration2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfiguration2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetConfiguration3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfiguration3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetConfigurationAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfigurationAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetConfigurationDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireSetConfigurationDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireSetTransactionTimerAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireSetTransactionTimerAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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_DesfireWriteBackupDataFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteBackupDataFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteBackupDataFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteBackupDataFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteBackupDataFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteRecord2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteRecord3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_AesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_AesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecord_TransMac_DesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteRecordAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecordAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteRecordDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteRecordDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteStdDataFile2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFile2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteStdDataFile3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFile3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteStdDataFileAesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFileAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_DesfireWriteStdDataFileDesAuthM()

UFR_STATUS DL_API uFR_SAM_DesfireWriteStdDataFileDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	hndUFR handle of the uFR device
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 bytes into array 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_GetDesfireUid2k3desAuthM()

UFR_STATUS DL_API uFR_SAM_GetDesfireUid2k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	handle of the uFR device
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_GetDesfireUid3k3desAuthM()

UFR_STATUS DL_API uFR_SAM_GetDesfireUid3k3desAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	handle of the uFR device
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_GetDesfireUidAesAuthM()

UFR_STATUS DL_API uFR_SAM_GetDesfireUidAesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	handle of the uFR device
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_GetDesfireUidDesAuthM()

UFR_STATUS DL_API uFR_SAM_GetDesfireUidDesAuthM	(	UFR_HANDLE	hndUFR,
		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.

Multi reader support. *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

hndUFR	handle of the uFR device
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