NTAG2XX (Type 2) related commands

Functions
UFR_STATUS DL_API	GetNfcT2TVersionM (UFR_HANDLE hndUFR, OUT uint8_t lpucVersionResponse[8])
UFR_STATUS DL_API	ReadCounterM (UFR_HANDLE hndUFR, uint8_t counter_address, VAR uint32_t *value)
UFR_STATUS DL_API	IncrementCounterM (UFR_HANDLE hndUFR, uint8_t counter_address, uint32_t inc_value)
UFR_STATUS DL_API	ReadNFCCounterM (UFR_HANDLE hndUFR, VAR uint32_t *value)
UFR_STATUS DL_API	ReadNFCCounterPwdAuth_RKM (UFR_HANDLE hndUFR, VAR uint32_t *value, uint8_t reader_key_index)
UFR_STATUS DL_API	ReadNFCCounterPwdAuth_PKM (UFR_HANDLE hndUFR, VAR uint32_t *value, IN const uint8_t *key)

Detailed Description

Function Documentation

GetNfcT2TVersionM()

UFR_STATUS DL_API GetNfcT2TVersionM	(	UFR_HANDLE	hndUFR,
		OUT uint8_t	lpucVersionResponse[8] )

Multi reader support. This function returns 8 bytes of the T2T version. All modern T2T chips support this functionality and have in common a total of 8 byte long version response. This function is primarily intended to use with NFC_T2T_GENERIC tags (i.e. tags which return 0x0C in the *lpucCardType parameter of the GetDlogicCardType()).

Parameters

hndUFR	handle of the uFR device
lpucVersionResponse[8]	array containing 8 bytes which will receive raw T2T version.

Returns

Operation status

ReadCounterM()

UFR_STATUS DL_API ReadCounterM	(	UFR_HANDLE	hndUFR,
		uint8_t	counter_address,
		VAR uint32_t *	value )

Multi reader support. This function is used to read one of the three 24-bit one-way counters in Ultralight EV1 chip family. Those counters can’t be password protected. In the initial Ultralight EV1 chip state, the counter values are set to 0.

Parameters

hndUFR	handle of the uFR device
counter_address	Address of the target counter. Can be in range 0 to 2. Counters are mapped in a separate address space.
value	Pointer to a uint32_t which will contained counter value after successful function execution. Since counters are 24-bit in length, most significant byte of the *value will be always 0.

Returns

Operation status

IncrementCounterM()

UFR_STATUS DL_API IncrementCounterM	(	UFR_HANDLE	hndUFR,
		uint8_t	counter_address,
		uint32_t	inc_value )

Multi reader support. This function is used to increment one of the three 24-bit one-way counters in Ultralight EV1 chip family. Those counters can’t be password protected. If the sum of the addressed counter value and the increment value is higher than 0xFFFFFF, the tag replies with an error and does not update the respective counter.

Parameters

hndUFR	handle of the uFR device
counter_address	Address of the target counter. Can be in range 0 to 2. Counters are mapped in a separate address space.
inc_value	Increment value. Only the 3 least significant bytes are relevant.

Returns

Operation status

ReadNFCCounterM()

UFR_STATUS DL_API ReadNFCCounterM	(	UFR_HANDLE	hndUFR,
		VAR uint32_t *	value )

Multi reader support. This function is used to read 24-bit NFC counters in NTAG 213, NTAG 215 and NTAG 216 chips without using password authentication. If access to the NFC counter is configured to be password protected, this function will return COUNTER_ERROR.

Parameters

hndUFR	handle of the uFR device
value	Pointer to a uint32_t which will contain counter value after successfulfunction execution. Since counter is 24-bit in length, most significant byte of the *value will always be 0.

Returns

Operation status

ReadNFCCounterPwdAuth_RKM()

UFR_STATUS DL_API ReadNFCCounterPwdAuth_RKM	(	UFR_HANDLE	hndUFR,
		VAR uint32_t *	value,
		uint8_t	reader_key_index )

Multi reader support. This function is used to read 24-bit NFC counter in NTAG 213, NTAG 215 and NTAG 216 chips using “reader key password authentication”. If access to NFC counter is configured to be password protected and PWD-PACK pair stored as a 6-byte key in uFR reader disagrees with PWD-PACK pair configured in tag, this function will return UFR_AUTH_ERROR. If access to NFC counter isn’t configured to be password protected, this function will return UFR_AUTH_ERROR.

Parameters

hndUFR	handle of the uFR device
value	Pointer to a uint32_t which will contain counter value after successful function execution. Since counter is 24-bit in length, most significant byte of the *value will always be 0.
reader_key_index	Index of the 6-byte key (PWD-PACK pair for this type of NFC tags) stored in the uFR reader. Can be in range 0 to 31.

Returns

Operation status

ReadNFCCounterPwdAuth_PKM()

UFR_STATUS DL_API ReadNFCCounterPwdAuth_PKM	(	UFR_HANDLE	hndUFR,
		VAR uint32_t *	value,
		IN const uint8_t *	key )

Multi reader support. Provided Key mode (PK) This function is used to read 24-bit NFC counter in NTAG 213, NTAG 215 and NTAG 216 chips using “reader key password authentication”. If access to NFC counter is configured to be password protected and PWD-PACK pair stored as a 6-byte key in uFR reader disagrees with PWD-PACK pair configured in tag, this function will return UFR_AUTH_ERROR. If access to NFC counter isn’t configured to be password protected, this function will return UFR_AUTH_ERROR.

Parameters

hndUFR	handle of the uFR device
value	Pointer to a uint32_t which will contain counter value after successful function execution. Since counter is 24-bit in length, most significant byte of the *value will always be 0.
key	ointer to an array contains provided 6-byte key (PWD-PACK pair for this type of NFC tags) for password authentication.

Returns

Operation status