Functions for reading and writing common NDEF messages and records into various NFC tags. Currently, only NFC Type 2 Tags are supported, while support for other NFC Tag types will be added in future upgrades. More...

Functions
UFR_STATUS DL_API	erase_all_ndef_recordsM (UFR_HANDLE hndUFR, uint8_t message_nr)
	Multi reader support. Function deletes all records of the message, then writes an empty message.

UFR_STATUS DL_API	erase_last_ndef_recordM (UFR_HANDLE hndUFR, uint8_t message_nr)
	Multi reader support. Function deletes the last record of the selected message. If a message contains one record, then it will be written as an empty message.

UFR_STATUS DL_API	get_ndef_record_countM (UFR_HANDLE hndUFR, VAR uint8_t ndef_message_cnt, VAR uint8_t ndef_record_cnt, OUT uint8_t ndef_record_array, VAR uint8_t empty_ndef_message_cnt)
	Multi reader support. Function returns the number of NDEF messages that have been read from the card, and number of NDEF records, number of NDEF empty messages. Also, function returns array of bytes containing number of messages pairs. First byte of pair is message ordinal, and second byte is number of NDEF records in that message. Message ordinal starts from 1.

UFR_STATUS DL_API	ndef_card_initializationM (UFR_HANDLE hndUFR)
	Multi reader support. Function prepares the card for NDEF using. Function writes Capability Container (CC) if necessary, and writes empty message. If the card is MIFARE CLASSIC or MIFARE PLUS, then the function writes MAD (MIFARE Application Directory), and default keys and access bits for NDEF using.

UFR_STATUS DL_API	read_ndef_recordM (UFR_HANDLE hndUFR, uint8_t message_nr, uint8_t record_nr, VAR uint8_t tnf, OUT uint8_t type_record, VAR uint8_t type_length, OUT uint8_t id, VAR uint8_t id_length, OUT uint8_t payload, VAR uint32_t *payload_length)
	Multi reader support. Function returns TNF, type of record, ID and payload from the NDEF record. NDEF record shall be elected by the message ordinal and record ordinal in this message.

UFR_STATUS DL_API	ReadNdefRecord_AddressM (UFR_HANDLE hndUFR, OUT char *address)
	Multi reader support. Reads NDEF address (city, street name,etc) from card.

UFR_STATUS DL_API	ReadNdefRecord_AndroidAppM (UFR_HANDLE hndUFR, OUT char *package_name)
	Reads android app package name stored as NDEF record.

UFR_STATUS DL_API	ReadNdefRecord_BitcoinM (UFR_HANDLE hndUFR, OUT char bitcoin_address, OUT char amount, OUT char *message)
	Multi reader support. Reads NDEF bitcoin address, amount and donation message from card.

UFR_STATUS DL_API	ReadNdefRecord_BTM (UFR_HANDLE hndUFR, OUT char *bt_mac_address)
	Multi reader support. Reads NDEF Bluetooth MAC address for pairing from card.

UFR_STATUS DL_API	ReadNdefRecord_ContactM (UFR_HANDLE hndUFR, OUT char *vCard)
	Multi reader support. Reads NDEF phone contact from card.

UFR_STATUS DL_API	ReadNdefRecord_EmailM (UFR_HANDLE hndUFR, OUT char email_address, OUT char subject, OUT char *message)
	Multi reader support. Reads NDEF email address, subject and message from card.

UFR_STATUS DL_API	ReadNdefRecord_GeoLocationM (UFR_HANDLE hndUFR, OUT char latitude, OUT char longitude)
	Multi reader support. Reads NDEF latitude and longitude from card.

UFR_STATUS DL_API	ReadNdefRecord_NaviDestinationM (UFR_HANDLE hndUFR, OUT char *destination)
	Multi reader support. Reads NDEF navigation destination from card.

UFR_STATUS DL_API	ReadNdefRecord_PhoneM (UFR_HANDLE hndUFR, OUT char *phone_number)
	Multi reader support. Reads NDEF phone number from card.

UFR_STATUS DL_API	ReadNdefRecord_SkypeM (UFR_HANDLE hndUFR, OUT char user_name, OUT char action)
	Multi reader support. Reads NDEF skype username and action from card.

UFR_STATUS DL_API	ReadNdefRecord_SMSM (UFR_HANDLE hndUFR, OUT char phone_number, OUT char message)
	Multi reader support. Reads NDEF phone number and message from card.

UFR_STATUS DL_API	ReadNdefRecord_StreetViewM (UFR_HANDLE hndUFR, OUT char latitude, OUT char longitude)
	Multi reader support. Reads NDEF latitude and longitude for Google StreetView from card.

UFR_STATUS DL_API	ReadNdefRecord_TextM (UFR_HANDLE hndUFR, OUT char *text)
	Multi reader support. Reads NDEF text from card.

UFR_STATUS DL_API	ReadNdefRecord_ViberM (UFR_HANDLE hndUFR, OUT char *message)
	Multi reader support. Reads NDEF Viber message from card.

UFR_STATUS DL_API	ReadNdefRecord_WhatsappM (UFR_HANDLE hndUFR, OUT char *message)
	Multi reader support. Reads NDEF Whatsapp message from card.

UFR_STATUS DL_API	ReadNdefRecord_WiFiM (UFR_HANDLE hndUFR, OUT char ssid, OUT char auth_type, OUT char encryption_type, OUT char password)
	Multi reader support. Reads NDEF WiFi configuration from card..

UFR_STATUS DL_API	write_ndef_record_mirroring_ttM (UFR_HANDLE hndUFR, uint8_t message_nr, uint8_t tnf, IN uint8_t type_record, uint8_t type_length, IN uint8_t id, uint8_t id_length, IN uint8_t payload, uint32_t payload_length, VAR uint8_t card_formated, int use_uid_ascii_mirror, int use_counter_ascii_mirror, int use_tt_message_mirror, uint32_t payload_mirroring_pos)
	Multi reader support. This function works the same as the write_ndef_record(), with the additional “UID and / or NFC counter mirror” features support. NTAG 21x family of devices offers these specific features. For details about “ASCII mirror” features refer to http://www.nxp.com/docs/en/data-sheet/NTAG213_215_216.pdf (in Rev. 3.2 from 2. June 2015, page 20) and http://www.nxp.com/docs/en/data-sheet/NTAG210_212.pdf (in Rev. 3.0 from 14. March 2013, page 16).

UFR_STATUS DL_API	write_ndef_record_mirroringM (UFR_HANDLE hndUFR, uint8_t message_nr, uint8_t tnf, IN uint8_t type_record, uint8_t type_length, IN uint8_t id, uint8_t id_length, IN uint8_t payload, uint32_t payload_length, VAR uint8_t card_formated, int use_uid_ascii_mirror, int use_counter_ascii_mirror, uint32_t payload_mirroring_pos)
	Multi reader support. This function works the same as the write_ndef_record(), with the additional “UID and / or NFC counter mirror” features support. NTAG 21x family of devices offers these specific features. For details about “ASCII mirror” features refer to http://www.nxp.com/docs/en/data-sheet/NTAG213_215_216.pdf (in Rev. 3.2 from 2. June 2015, page 20) and http://www.nxp.com/docs/en/data-sheet/NTAG210_212.pdf (in Rev. 3.0 from 14. March 2013, page 16).

UFR_STATUS DL_API	write_ndef_recordM (UFR_HANDLE hndUFR, uint8_t message_nr, uint8_t tnf, IN uint8_t type_record, uint8_t type_length, IN uint8_t id, uint8_t id_length, IN uint8_t payload, uint32_t payload_length, VAR uint8_t card_formated)
	Multi reader support. Function adds a record to the end of message, if one or more records already exist in this message. If current message is empty, then this empty record will be replaced with the record. Parameters of function are: ordinal of message, TNF, type of record, ID, payload. Function also returns pointer to the variable which reported that the card formatted for NDEF using (card does not have a capability container, for example new Mifare Ultralight, or Mifare Classic card).

UFR_STATUS DL_API	WriteNdefRecord_AddressM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *address)
	Multi reader support. Store address (city, street name, etc) as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_AndroidAppM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *package_name)
	Multi reader support. Store android app package name as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_BitcoinM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char bitcoin_address, IN const char amount, IN const char *message)
	Multi reader support. Store bitcoin address, amount and donation message as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_BTM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *bt_mac_address)
	Multi reader support. Store BT MAC address for pairing as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_ContactM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char name, IN const char company, IN const char address, IN const char phone, IN const char email, IN const char website)
	Multi reader support. Store phone contact as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_EmailM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char email_address, IN const char subject, IN const char *message)
	Multi reader support. Store email message as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_GeoLocationM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char latitude, IN const char longitude)
	Multi reader support. Store latitude and longitude as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_NaviDestinationM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *destination)
	Multi reader support. Store wanted destination as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_PhoneM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *phone_number)
	Multi reader support. Store phone_number as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_SkypeM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *user_name, uint8_t action)
	Multi reader support. Store skype username as NDEF message into reader or into card for call or chat.

UFR_STATUS DL_API	WriteNdefRecord_SMSM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char phone_number, IN const char message)
	Multi reader support. Store phone number and message data as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_StreetViewM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char latitude, IN const char longitude)
	Multi reader support. Store latitude and longitude as NDEF message into reader or into card for Google StreetView.

UFR_STATUS DL_API	WriteNdefRecord_ViberM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *message)
	Multi reader support. Store Viber message as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_WhatsappM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char *message)
	Multi reader support. Store Whatsapp message as NDEF message into reader or into card.

UFR_STATUS DL_API	WriteNdefRecord_WiFiM (UFR_HANDLE hndUFR, uint8_t ndef_storage, IN const char ssid, uint8_t auth_type, uint8_t encryption_type, IN const char password)
	Multi reader support. Store WiFi configuration as NDEF message into reader or into card.

Detailed Description

Functions for reading and writing common NDEF messages and records into various NFC tags. Currently, only NFC Type 2 Tags are supported, while support for other NFC Tag types will be added in future upgrades.

Function Documentation

◆ erase_all_ndef_recordsM()

UFR_STATUS DL_API erase_all_ndef_recordsM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr )

Multi reader support. Function deletes all records of the message, then writes an empty message.

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts form 1)

Returns: Operation status

◆ erase_last_ndef_recordM()

UFR_STATUS DL_API erase_last_ndef_recordM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr )

Multi reader support. Function deletes the last record of the selected message. If a message contains one record, then it will be written as an empty message.

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts form 1)

Returns: Operation status

◆ get_ndef_record_countM()

UFR_STATUS DL_API get_ndef_record_countM	(	UFR_HANDLE	hndUFR,
		VAR uint8_t *	ndef_message_cnt,
		VAR uint8_t *	ndef_record_cnt,
		OUT uint8_t *	ndef_record_array,
		VAR uint8_t *	empty_ndef_message_cnt )

Multi reader support. Function returns the number of NDEF messages that have been read from the card, and number of NDEF records, number of NDEF empty messages. Also, function returns array of bytes containing number of messages pairs. First byte of pair is message ordinal, and second byte is number of NDEF records in that message. Message ordinal starts from 1.

Parameters

hndUFR	handle of the uFR device
ndef_message_cnt	pointer to the variable containing number of NDEF messages
ndef_record_cnt	pointer to the variable containing number of NDEF record
ndef_record_array	pointer to the array of bytes containing pairs (message ordinal - number of records)
empty_ndef_message_cnt	pointer to the variable containing number of empty messages

Returns: Operation status

◆ ndef_card_initializationM()

UFR_STATUS DL_API ndef_card_initializationM ( UFR_HANDLE hndUFR )

Multi reader support. Function prepares the card for NDEF using. Function writes Capability Container (CC) if necessary, and writes empty message. If the card is MIFARE CLASSIC or MIFARE PLUS, then the function writes MAD (MIFARE Application Directory), and default keys and access bits for NDEF using.

Parameters

hndUFR handle of the uFR device

Returns: Operation status

◆ read_ndef_recordM()

UFR_STATUS DL_API read_ndef_recordM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr,
		uint8_t	record_nr,
		VAR uint8_t *	tnf,
		OUT uint8_t *	type_record,
		VAR uint8_t *	type_length,
		OUT uint8_t *	id,
		VAR uint8_t *	id_length,
		OUT uint8_t *	payload,
		VAR uint32_t *	payload_length )

Multi reader support. Function returns TNF, type of record, ID and payload from the NDEF record. NDEF record shall be elected by the message ordinal and record ordinal in this message.

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts from 1)
record_nr	NDEF record ordinal (in message)
tnf	pointer to the variable containing TNF of record
type_record	pointer to array containing type of record
type_length	pointer to the variable containing length of type of record string
id	pointer to array containing ID of record
id_length	pointer to the variable containing length of ID of record string
payload	pointer to array containing payload of record
payload_length	pointer to the variable containing length of payload

Returns: Operation status

◆ ReadNdefRecord_AddressM()

UFR_STATUS DL_API ReadNdefRecord_AddressM	(	UFR_HANDLE	hndUFR,
		OUT char *	address )

Multi reader support. Reads NDEF address (city, street name,etc) from card.

Parameters

hndUFR	handle of the uFR device
address	Pointer to char array containing address

Returns: Operation status

◆ ReadNdefRecord_AndroidAppM()

UFR_STATUS DL_API ReadNdefRecord_AndroidAppM	(	UFR_HANDLE	hndUFR,
		OUT char *	package_name )

Reads android app package name stored as NDEF record.

Parameters

hndUFR	handle of the uFR device
package_name	Pointer to the null-terminated string that should contain android app package name

Returns: Operation status

◆ ReadNdefRecord_BitcoinM()

UFR_STATUS DL_API ReadNdefRecord_BitcoinM	(	UFR_HANDLE	hndUFR,
		OUT char *	bitcoin_address,
		OUT char *	amount,
		OUT char *	message )

Multi reader support. Reads NDEF bitcoin address, amount and donation message from card.

Parameters

hndUFR	handle of the uFR device
bitcoin_address	Pointer to char array containing bitcoin_address
amount	Pointer to char array containing bitcoin amount
message	Pointer to char array containing donation message

Returns: Operation status

◆ ReadNdefRecord_BTM()

UFR_STATUS DL_API ReadNdefRecord_BTM	(	UFR_HANDLE	hndUFR,
		OUT char *	bt_mac_address )

Multi reader support. Reads NDEF Bluetooth MAC address for pairing from card.

Parameters

hndUFR	handle of the uFR device
bt_mac_address	Pointer to char array containing Bluetooth MAC address

Returns: Operation status

◆ ReadNdefRecord_ContactM()

UFR_STATUS DL_API ReadNdefRecord_ContactM	(	UFR_HANDLE	hndUFR,
		OUT char *	vCard )

Multi reader support. Reads NDEF phone contact from card.

Parameters

hndUFR	handle of the uFR device
vCard	Pointer to char array containing phone contact data

Returns: Operation status

◆ ReadNdefRecord_EmailM()

UFR_STATUS DL_API ReadNdefRecord_EmailM	(	UFR_HANDLE	hndUFR,
		OUT char *	email_address,
		OUT char *	subject,
		OUT char *	message )

Multi reader support. Reads NDEF email address, subject and message from card.

Parameters

hndUFR	handle of the uFR device
email_address	Pointer to char array containing recipient email address
subject	Pointer to char array containing subject
message	Pointer to char array containing message

Returns: Operation status

◆ ReadNdefRecord_GeoLocationM()

UFR_STATUS DL_API ReadNdefRecord_GeoLocationM	(	UFR_HANDLE	hndUFR,
		OUT char *	latitude,
		OUT char *	longitude )

Multi reader support. Reads NDEF latitude and longitude from card.

Parameters

hndUFR	handle of the uFR device
latitude	Pointer to char array containing latitude
longitude	Pointer to char array containing longitude

Returns: Operation status

◆ ReadNdefRecord_NaviDestinationM()

UFR_STATUS DL_API ReadNdefRecord_NaviDestinationM	(	UFR_HANDLE	hndUFR,
		OUT char *	destination )

Multi reader support. Reads NDEF navigation destination from card.

Parameters

hndUFR	handle of the uFR device
destination	Pointer to char array containing destination

Returns: Operation status

◆ ReadNdefRecord_PhoneM()

UFR_STATUS DL_API ReadNdefRecord_PhoneM	(	UFR_HANDLE	hndUFR,
		OUT char *	phone_number )

Multi reader support. Reads NDEF phone number from card.

Parameters

hndUFR	handle of the uFR device
phone_number	Pointer to char array containing phone number

Returns: Operation status

◆ ReadNdefRecord_SkypeM()

UFR_STATUS DL_API ReadNdefRecord_SkypeM	(	UFR_HANDLE	hndUFR,
		OUT char *	user_name,
		OUT char *	action )

Multi reader support. Reads NDEF skype username and action from card.

Parameters

hndUFR	handle of the uFR device
user_name	pointer to the null-terminated string that should contain skype username
action	Pointer to char array containing Skype action (“call” or “chat”)

Returns: Operation status

◆ ReadNdefRecord_SMSM()

UFR_STATUS DL_API ReadNdefRecord_SMSM	(	UFR_HANDLE	hndUFR,
		OUT char *	phone_number,
		OUT char *	message )

Multi reader support. Reads NDEF phone number and message from card.

Parameters

hndUFR	handle of the uFR device
phone_number	Pointer to char array containing phone number
message	Pointer to char array containing message

Returns: Operation status

◆ ReadNdefRecord_StreetViewM()

UFR_STATUS DL_API ReadNdefRecord_StreetViewM	(	UFR_HANDLE	hndUFR,
		OUT char *	latitude,
		OUT char *	longitude )

Multi reader support. Reads NDEF latitude and longitude for Google StreetView from card.

Parameters

hndUFR	handle of the uFR device
latitude	Pointer to char array containing latitude
longitude	Pointer to char array containing longitude

Returns: Operation status

◆ ReadNdefRecord_TextM()

UFR_STATUS DL_API ReadNdefRecord_TextM	(	UFR_HANDLE	hndUFR,
		OUT char *	text )

Multi reader support. Reads NDEF text from card.

Parameters

hndUFR	handle of the uFR device
text	Pointer to char array containing text

Returns: Operation status

◆ ReadNdefRecord_ViberM()

UFR_STATUS DL_API ReadNdefRecord_ViberM	(	UFR_HANDLE	hndUFR,
		OUT char *	message )

Multi reader support. Reads NDEF Viber message from card.

Parameters

hndUFR	handle of the uFR device
message	Pointer to char array containing Viber message

Returns: Operation status

◆ ReadNdefRecord_WhatsappM()

UFR_STATUS DL_API ReadNdefRecord_WhatsappM	(	UFR_HANDLE	hndUFR,
		OUT char *	message )

Multi reader support. Reads NDEF Whatsapp message from card.

Parameters

hndUFR	handle of the uFR device
message	Pointer to char array containing Whatsapp message

Returns: Operation status

◆ ReadNdefRecord_WiFiM()

UFR_STATUS DL_API ReadNdefRecord_WiFiM	(	UFR_HANDLE	hndUFR,
		OUT char *	ssid,
		OUT char *	auth_type,
		OUT char *	encryption_type,
		OUT char *	password )

Multi reader support. Reads NDEF WiFi configuration from card..

Parameters

hndUFR	handle of the uFR device
ssid	Pointer to char array containing SSID name
auth_type	Pointer to char array containing authentication type
encryption_type	Pointer to char array containing encryption type
password	Pointer to char array containing password

Returns: Operation status

◆ write_ndef_record_mirroring_ttM()

UFR_STATUS DL_API write_ndef_record_mirroring_ttM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr,
		uint8_t *	tnf,
		IN uint8_t *	type_record,
		uint8_t *	type_length,
		IN uint8_t *	id,
		uint8_t *	id_length,
		IN uint8_t *	payload,
		uint32_t *	payload_length,
		VAR uint8_t *	card_formated,
		int	use_uid_ascii_mirror,
		int	use_counter_ascii_mirror,
		int	use_tt_message_mirror,
		uint32_t	payload_mirroring_pos )

Multi reader support. This function works the same as the write_ndef_record(), with the additional “UID and / or NFC counter mirror” features support. NTAG 21x family of devices offers these specific features. For details about “ASCII mirror” features refer to http://www.nxp.com/docs/en/data-sheet/NTAG213_215_216.pdf (in Rev. 3.2 from 2. June 2015, page 20) and http://www.nxp.com/docs/en/data-sheet/NTAG210_212.pdf (in Rev. 3.0 from 14. March 2013, page 16).

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts from 1)
tnf	pointer to variable containing TNF of record
type_record	pointer to array containing type of record
type_length	pointer to the variable containing length of type of record string
id	pointer to array containing ID of record
id_length	pointer to the variable containing length of ID of record string
payload	pointer to array containing payload of record
payload_length	pointer to the variable containing length of payload
card_formated	pointer to the variable which shows that the card formatted for NDEF using.
use_uid_ascii_mirror	if use_uid_ascii_mirror == 1 then “UID ASCII Mirror” feature is in use. if use_uid_ascii_mirror == 0 then “UID ASCII Mirror” feature is switched off.
use_counter_ascii_mirror	if use_counter_ascii_mirror == 1 then “NFC counter ASCII Mirror” feature is in use. if use_counter_ascii_mirror == 0 then “NFC counter ASCII Mirror” feature is switched off. payload_mirroring_pos Defines the starting position of the “ASCII Mirror” into the NDEF record payload.
use_tt_message_mirror	if use_tt_message_mirror == 1 then Tag tamper status mirroring is enabled
payload_mirroring_pos	Defines the starting position of the “ASCII Mirror” into the NDEF record payload.

Returns: Operation status

◆ write_ndef_record_mirroringM()

UFR_STATUS DL_API write_ndef_record_mirroringM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr,
		uint8_t *	tnf,
		IN uint8_t *	type_record,
		uint8_t *	type_length,
		IN uint8_t *	id,
		uint8_t *	id_length,
		IN uint8_t *	payload,
		uint32_t *	payload_length,
		VAR uint8_t *	card_formated,
		int	use_uid_ascii_mirror,
		int	use_counter_ascii_mirror,
		uint32_t	payload_mirroring_pos )

Multi reader support. This function works the same as the write_ndef_record(), with the additional “UID and / or NFC counter mirror” features support. NTAG 21x family of devices offers these specific features. For details about “ASCII mirror” features refer to http://www.nxp.com/docs/en/data-sheet/NTAG213_215_216.pdf (in Rev. 3.2 from 2. June 2015, page 20) and http://www.nxp.com/docs/en/data-sheet/NTAG210_212.pdf (in Rev. 3.0 from 14. March 2013, page 16).

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts from 1)
tnf	pointer to variable containing TNF of record
type_record	pointer to array containing type of record
type_length	pointer to the variable containing length of type of record string
id	pointer to array containing ID of record
id_length	pointer to the variable containing length of ID of record string
payload	pointer to array containing payload of record
payload_length	pointer to the variable containing length of payload
card_formated	pointer to the variable which shows that the card formatted for NDEF using.
use_uid_ascii_mirror	if use_uid_ascii_mirror == 1 then “UID ASCII Mirror” feature is in use. if use_uid_ascii_mirror == 0 then “UID ASCII Mirror” feature is switched off.
use_counter_ascii_mirror	if use_counter_ascii_mirror == 1 then “NFC counter ASCII Mirror” feature is in use. if use_counter_ascii_mirror == 0 then “NFC counter ASCII Mirror” feature is switched off.
payload_mirroring_pos	Defines the starting position of the “ASCII Mirror” into the NDEF record payload.

Returns: Operation status

◆ write_ndef_recordM()

UFR_STATUS DL_API write_ndef_recordM	(	UFR_HANDLE	hndUFR,
		uint8_t	message_nr,
		uint8_t *	tnf,
		IN uint8_t *	type_record,
		uint8_t *	type_length,
		IN uint8_t *	id,
		uint8_t *	id_length,
		IN uint8_t *	payload,
		uint32_t *	payload_length,
		VAR uint8_t *	card_formated )

Multi reader support. Function adds a record to the end of message, if one or more records already exist in this message. If current message is empty, then this empty record will be replaced with the record. Parameters of function are: ordinal of message, TNF, type of record, ID, payload. Function also returns pointer to the variable which reported that the card formatted for NDEF using (card does not have a capability container, for example new Mifare Ultralight, or Mifare Classic card).

Parameters

hndUFR	handle of the uFR device
message_nr	NDEF message ordinal (starts from 1)
tnf	pointer to variable containing TNF of record
type_record	pointer to array containing type of record
type_length	pointer to the variable containing length of type of record string
id	pointer to array containing ID of record
id_length	pointer to the variable containing length of ID of record string
payload	pointer to array containing payload of record
payload_length	pointer to the variable containing length of payload
card_formated	pointer to the variable which shows that the card formatted for NDEF using.

Returns: Operation status

◆ WriteNdefRecord_AddressM()

UFR_STATUS DL_API WriteNdefRecord_AddressM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	address )

Multi reader support. Store address (city, street name, etc) as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
address	Pointer to the null-terminated string that should contain city name, street name, etc.

Returns: Operation status

◆ WriteNdefRecord_AndroidAppM()

UFR_STATUS DL_API WriteNdefRecord_AndroidAppM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	package_name )

Multi reader support. Store android app package name as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
package_name	Pointer to the null-terminated string that should contain android app packagne name

Returns: Operation status

◆ WriteNdefRecord_BitcoinM()

UFR_STATUS DL_API WriteNdefRecord_BitcoinM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	bitcoin_address,
		IN const char *	amount,
		IN const char *	message )

Multi reader support. Store bitcoin address, amount and donation message as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
bitcoin_address	Pointer to the null-terminated string that should contain bitcoin address
amount	Pointer to the null-terminated string that should contain amount (e.g.: “1.0”)
message	Pointer to the null-terminated string that should contain donation message

Returns: Operation status

◆ WriteNdefRecord_BTM()

UFR_STATUS DL_API WriteNdefRecord_BTM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	bt_mac_address )

Multi reader support. Store BT MAC address for pairing as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
bt_mac_address	Pointer to the null-terminated string that should contain BT MAC address for pairing in hex format (12 characters) (e.g.: “AABBCCDDEEFF”)

Returns: Operation status

◆ WriteNdefRecord_ContactM()

UFR_STATUS DL_API WriteNdefRecord_ContactM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	name,
		IN const char *	company,
		IN const char *	address,
		IN const char *	phone,
		IN const char *	email,
		IN const char *	website )

Multi reader support. Store phone contact as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
name	pointer to the null-terminated string that should contain contact display name
company	pointer to the null-terminated string that should contain contact company name
address	Pointer to the null-terminated string that should contain contact residental address
phone	pointer to the null-terminated string that should contain contact phone number
email	pointer to the null-terminated string that should contain contact email address
website	pointer to the null-terminated string that should contain contact website

Returns: Operation status

◆ WriteNdefRecord_EmailM()

UFR_STATUS DL_API WriteNdefRecord_EmailM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	email_address,
		IN const char *	subject,
		IN const char *	message )

Multi reader support. Store email message as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
email_address	Pointer to the null-terminated string that should contain recipient email address
subject	Pointer to the null-terminated string that should contain subject
message	Pointer to the null-terminated string that should contain message

Returns: Operation status

◆ WriteNdefRecord_GeoLocationM()

UFR_STATUS DL_API WriteNdefRecord_GeoLocationM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	latitude,
		IN const char *	longitude )

Multi reader support. Store latitude and longitude as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
latitude	Pointer to the null-terminated string that should contain latitude (e.g.: “44.6229337”)
longitude	Pointer to the null-terminated string that should contain longitude (e.g.: “21.1787368”)

Returns: Operation status

◆ WriteNdefRecord_NaviDestinationM()

UFR_STATUS DL_API WriteNdefRecord_NaviDestinationM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	destination )

Multi reader support. Store wanted destination as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
destination	Pointer to the null-terminated string that should contain city, street name or some other destination

Returns: Operation status

◆ WriteNdefRecord_PhoneM()

UFR_STATUS DL_API WriteNdefRecord_PhoneM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	phone_number )

Multi reader support. Store phone_number as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
phone_number	Pointer to char array containing phone number

Returns: Operation status

◆ WriteNdefRecord_SkypeM()

UFR_STATUS DL_API WriteNdefRecord_SkypeM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	user_name,
		uint8_t	action )

Multi reader support. Store skype username as NDEF message into reader or into card for call or chat.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
user_name	pointer to the null-terminated string that should contain skype username
action	Action type: call - 0 chat - 1

Returns: Operation status

◆ WriteNdefRecord_SMSM()

UFR_STATUS DL_API WriteNdefRecord_SMSM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	phone_number,
		IN const char *	message )

Multi reader support. Store phone number and message data as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
phone_number	Pointer to char array containing phone number
message	Pointer to the null-terminated string that should contain message data

Returns: Operation status

◆ WriteNdefRecord_StreetViewM()

UFR_STATUS DL_API WriteNdefRecord_StreetViewM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	latitude,
		IN const char *	longitude )

Multi reader support. Store latitude and longitude as NDEF message into reader or into card for Google StreetView.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
latitude	Pointer to the null-terminated string that should contain latitude (e.g.: “44.6229337”)
longitude	Pointer to the null-terminated string that should contain longitude (e.g.: “21.1787368”)

Returns: Operation status

◆ WriteNdefRecord_ViberM()

UFR_STATUS DL_API WriteNdefRecord_ViberM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	message )

Multi reader support. Store Viber message as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
message	Pointer to the null-terminated string that should contain Viber message

Returns: Operation status

◆ WriteNdefRecord_WhatsappM()

UFR_STATUS DL_API WriteNdefRecord_WhatsappM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	message )

Multi reader support. Store Whatsapp message as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
message	Pointer to the null-terminated string that should contain Whatsapp message

Returns: Operation status

◆ WriteNdefRecord_WiFiM()

UFR_STATUS DL_API WriteNdefRecord_WiFiM	(	UFR_HANDLE	hndUFR,
		uint8_t	ndef_storage,
		IN const char *	ssid,
		uint8_t	auth_type,
		uint8_t	encryption_type,
		IN const char *	password )

Multi reader support. Store WiFi configuration as NDEF message into reader or into card.

Parameters

hndUFR	handle of the uFR device
ndef_storage	Store NDEF into: reader - 0, card - 1 From library 5.0.31 and firmware 5.0.33 2 - reader RAM
ssid	Pointer to the null-terminated string that should contain SSID name we want to connect to
auth_type	Authentication type: 0 - OPEN 1 - WPA Personal 2 - WPA Enterprise 3 - WPA2 Enterprise 4 - WPA2 Personal
encryption_type	Encryption type: 0 - NONE 1 - WEP 2 - TKIP 3 - AES 4 - AES/TKIP
password	Pointer to the null-terminated string that should contain password of the SSID we want to connect to

Returns: Operation status