EEPROM manipulation

Functions
UFR_STATUS DL_API	ReaderKeyWrite (IN const uint8_t *aucKey, uint8_t ucKeyIndex)
UFR_STATUS DL_API	ReaderKeysLock (IN const uint8_t *password)
UFR_STATUS DL_API	ReaderKeysUnlock (IN const uint8_t *password)
UFR_STATUS DL_API	ReadUserData (OUT uint8_t *aucData)
UFR_STATUS DL_API	ReadUserDataExt (OUT uint8_t *aucData)
UFR_STATUS DL_API	WriteUserData (IN const uint8_t *aucData)
UFR_STATUS DL_API	WriteUserDataExt (IN const uint8_t *aucData)
UFR_STATUS DL_API	ChangeReaderPassword (IN uint8_t *old_password, IN uint8_t *new_password)
UFR_STATUS DL_API	ReaderEepromWrite (IN uint8_t *data, uint32_t address, uint32_t size, IN uint8_t *password)
UFR_STATUS DL_API	ReaderEepromRead (OUT uint8_t *data, uint32_t address, uint32_t size)

Detailed Description

Function Documentation

ReaderKeyWrite()

UFR_STATUS DL_API ReaderKeyWrite	(	IN const uint8_t *	aucKey,
		uint8_t	ucKeyIndex )

Store a new key or change existing key under provided index parameter.The keys are in a special area in EEPROM that can not be read anymore which gains protection.

Parameters

aucKey	Pointer to an array of 6 bytes containing the key. Default key values are always “FF FF FF FF FF FF” hex.
ucKeyIndex	key Index. Possible values ​​are 0 to 31.

Returns

Operation status

ReaderKeysLock()

UFR_STATUS DL_API ReaderKeysLock

(

IN const uint8_t *

password

)

Lock reader’s keys to prevent further changing.

Parameters

password

pointer to the 8 bytes array containing valid password.

Returns

Operation status

ReaderKeysUnlock()

UFR_STATUS DL_API ReaderKeysUnlock

(

IN const uint8_t *

password

)

Unlock reader’s keys if they are locked with previous function. The factory setting is that reader keys are unlocked.

Parameters

password

pointer to the 8 bytes array containing valid password.

Returns

Operation status

ReadUserData()

UFR_STATUS DL_API ReadUserData

(

OUT uint8_t *

aucData

)

Read user data written in device NV memory. User data is 16 byte long.

Parameters

aucData

pointer to a 16 bytes array containing user data

Returns

Operation status

ReadUserDataExt()

UFR_STATUS DL_API ReadUserDataExt

(

OUT uint8_t *

aucData

)

Read user data written in device NV memory. User data is 32 byte long.

Parameters

aucData

pointer to a 32 bytes array containing user data

Returns

Operation status

WriteUserData()

UFR_STATUS DL_API WriteUserData

(

IN const uint8_t *

aucData

)

Write user data into the device's NV memory. User data is 16 byte long.

Parameters

aucData

pointer to a 16 byte array containing user data

Returns

Operation status

WriteUserDataExt()

UFR_STATUS DL_API WriteUserDataExt

(

IN const uint8_t *

aucData

)

Write user data into the device's NV memory. User data is 32 byte long.

Parameters

aucData

pointer to a 32 byte array containing user data

Returns

Operation status

ChangeReaderPassword()

UFR_STATUS DL_API ChangeReaderPassword	(	IN uint8_t *	old_password,
		IN uint8_t *	new_password )

This function is used in Common, Advance and Access Control set of functions. It defines/changes password which I used for:

• Locking/unlocking keys stored into reader
• Setting date/time of RTC

Parameters

old_password	pointer to the 8 bytes array containing current password
new_password	pointer to the 8 bytes array containing new password

Returns

Operation status

ReaderEepromWrite()

UFR_STATUS DL_API ReaderEepromWrite	(	IN uint8_t *	data,
		uint32_t	address,
		uint32_t	size,
		IN uint8_t *	password )

Function writes array of data into EEPROM. Maximal length of array is 128 bytes. Function requires password which length is 8 bytes. Factory password is “11111111” (0x31, 0x31, 0x31, 0x31, 0x31, 0x31, 0x31, 0x31).

Parameters

data	pointer to array containing data
address	address of first data
size	length of array password pointer to array containing password Functions that works with Mifare Desfire Card (AES encryption in reader) AES encryption and decryption is performed in the reader. AES keys are stored into reader.
password	pointer to array containing password Functions that works with Mifare Desfire Card (AES encryption in reader) AES encryption and decryption is performed in the reader. AES keys are stored into reader.

Returns

Operation status

ReaderEepromRead()

UFR_STATUS DL_API ReaderEepromRead	(	OUT uint8_t *	data,
		uint32_t	address,
		uint32_t	size )

Function returns array of data read from EEPROM. Maximal length of array is 128 bytes.

Parameters

data	pointer to array containing data from EEPROM
address	address of first data
size	length of array

Returns

Operation status