Miscellaneous

Functions
UFR_STATUS DL_API	CheckUidChangeable (void)
	Function tries to change the UID on the card.
UFR_STATUS DL_API	GetAtqaSak (VAR uint16_t *atqa, VAR uint8_t *sak)
	Function returns ATQA and SAK (ISO 14443-3) of selected card.
UFR_STATUS DL_API	GetReaderStatus (VAR pcd_states_t *state, VAR emul_modes_t *emul_mode, VAR emul_states_t *emul_state, VAR uint8_t *sleep_mode)
	Function returns various reader states.
UFR_STATUS DL_API	ReaderRfOff (void)
	Function switch off RF field at the reader.
UFR_STATUS DL_API	ReaderRfOn (void)
	Function switch on RF field at the reader.
UFR_STATUS DL_API	ReaderRfReset (void)
	Function reset RF field at the reader. The RF field will be off, and then on after 50ms.
UFR_STATUS DL_API	ReadTTStatus (OUT uint8_t *tt_message, VAR uint8_t *tt_status)
	Function provides the information about the tag tamper status which is detected when the NTAG 213 TT is powered by an RF field.
void	setNFCMessage (const char *message)
	For iOS only: This function is used to set message displayed when the NFC Session window is started E.g 'Read the tag with the phone' NFC Session can be started via ReaderOpenEx() and appropriate parameters, or openNFCSession()

Detailed Description

Function Documentation

CheckUidChangeable()

UFR_STATUS DL_API CheckUidChangeable

(

void

)

Function tries to change the UID on the card.

On some cards (e.g. Magic Classic) changing UID is possible. If theed card is that type of card, then the function returns UFR_OK.

Returns

Operation status

GetAtqaSak()

UFR_STATUS DL_API GetAtqaSak	(	VAR uint16_t *	atqa,
		VAR uint8_t *	sak )

Function returns ATQA and SAK (ISO 14443-3) of selected card.

Parameters

atqa	pointer to variable which contain ATQA sak pointer to variable which contain SAK
sak	pointer to variable which contain SAK

Returns

Operation status

GetReaderStatus()

UFR_STATUS DL_API GetReaderStatus	(	VAR pcd_states_t *	state,
		VAR emul_modes_t *	emul_mode,
		VAR emul_states_t *	emul_state,
		VAR uint8_t *	sleep_mode )

Function returns various reader states.

From library version 5.0.31 and firmware version 5.0.33 The reader states are defined into following structures. This function is useful for checking if the reader is still in emulation mode after calling the TagEmulationStartRam() function. typedef enum E_EMULATION_MODES { TAG_EMU_DISABLED, TAG_EMU_DEDICATED, TAG_EMU_COMBINED, TAG_EMU_AUTO_AD_HOC }emul_modes_t; typedef enum E_EMULATION_STATES { EMULATION_NONE, EMULATION_IDLE, EMULATION_AUTO_COLL, EMULATION_ACTIVE, EMULATION_HALT, EMULATION_POWER_OFF }emul_states_t; typedef enum E_PCD_MGR_STATES { PCD_MGR_NO_RF_GENERATED, PCD_MGR_14443A_POLLING, PCD_MGR_14443A_SELECTED, PCD_MGR_CE_DEDICATED, PCD_MGR_CE_COMBO_START, PCD_MGR_CE_COMBO, PCD_MGR_CE_COMBO_IN_FIELD }pcd_states_t;

Parameters

state	- normal working mode states are PCD_MGR_NO_RF_GENERATED or PCD_MGR_14443A_POLLING or PCD_MGR_14443A_SELECTED. - NTAG emulation mode state is PCD_MGR_CE_DEDICATED emul_mode - normal working mode state is TAG_EMU_DISABLED - NTAG emulation mode state is TAG_EMU_DEDICATED emul_state state from structure emul_states_t sleep_mode 0 - reader is in normal or emulation mode 1 - reader is in sleep mode
emul_mode	- normal working mode state is TAG_EMU_DISABLED - NTAG emulation mode state is TAG_EMU_DEDICATED emul_state state from structure emul_states_t sleep_mode 0 - reader is in normal or emulation mode 1 - reader is in sleep mode
emul_state	state from structure emul_states_t sleep_mode 0 - reader is in normal or emulation mode 1 - reader is in sleep mode
sleep_mode	0 - reader is in normal or emulation mode 1 - reader is in sleep mode

Returns

Operation status

ReaderRfOff()

UFR_STATUS DL_API ReaderRfOff

(

void

)

Function switch off RF field at the reader.

For proper functionality the reader must be in the multi card mode. The RF field can be switched on by functions ReaderRfOn, EnumCards, or DisableAnticolision. From library version 5.0.48, and firmware version 5.0.51.

Returns

Operation status

ReaderRfOn()

UFR_STATUS DL_API ReaderRfOn

(

void

)

Function switch on RF field at the reader.

For proper functionality the reader must be in the multi card mode. From library version 5.0.48, and firmware version 5.0.51.

Returns

Operation status

ReaderRfReset()

UFR_STATUS DL_API ReaderRfReset

(

void

)

Function reset RF field at the reader. The RF field will be off, and then on after 50ms.

Returns

Operation status

ReadTTStatus()

UFR_STATUS DL_API ReadTTStatus	(	OUT uint8_t *	tt_message,
		VAR uint8_t *	tt_status )

Function provides the information about the tag tamper status which is detected when the NTAG 213 TT is powered by an RF field.

Parameters

tt_message	4 byte Tag Tamper message. “0000” is returned, if the NTAG 213 TT has never detected the Tag Tamper as opened during the startup. If the NTAG 213 TT has once detected the tag tamper wire as opened, it returns the data which have been programmed in page 45 (TT_MESSAGE)
tt_status	status of the tag tamper wire detected during startup. “C” if Tag Tamper was closed at current startup “O” if Tag Tamper was open at current startup “I” if Tag Tamper measurement was incorrect

Returns

Operation status

setNFCMessage()

void setNFCMessage

(

const char *

message

)

For iOS only: This function is used to set message displayed when the NFC Session window is started
E.g 'Read the tag with the phone' NFC Session can be started via ReaderOpenEx() and appropriate parameters, or openNFCSession()

Since

uFCoder library version 6.0.0

Returns

Operation status