User manual

NXP Semiconductors
UM10663
NXP Reader Library User Manual
UM10663
All information provided in this document is subject to legal disclaimers.
© NXP B.V. 2013. All rights reserved.
User Manual
COMPANY PUBLIC
Rev. 1.2 — 24 July 2013
257412
36 of 47
*pCryptoDataParams: pointer to the phCrypto data parameters structure.
*pCryptoRngDataParams: pointer to the parameter structure of the CryptoRng layer.
PH_ERR_SUCCESS - operation successful.
PH_ERR_INVALID_DATA_PARAMS – wSizeOfDataParams does not agree with defined size of MFUL
component.
2.5.2 Read - phalMful_Read
This function performs MIFARE Ultralight Read command.
phStatus_t phalMful_Read(
void * pDataParams, [In]
uint8_t bAddress, [In]
uint8_t * pData ); [Out]
*pDataParams: pointer to the MIFARE Ultralight AL layer data parameter structure.
bAddress: addres on the card to read from. In range from 00h to FFh. If out of range of
valid address, MFUL returns NAK.
*pData: pointer to 16 byte data array containing data read from the Ultralight card.
returnValues:
PH_ERR_PROTOCOL_ERROR – number of received data differs from 16 bytes.
PH_ERR_SUCCESS - operation successful.
Other Depending on implementation and underlaying component.
2.5.3 Write - phalMful_Write()
This function performs MIFARE Ultralight Write command – writes 4 bytes to given
memory page.
phStatus_t phalMful_Write(
void * pDataParams, [In]
uint8_t bAddress, [In]
uint8_t * pData ); [In]
*pDataParams: pointer the MIFARE Ultralight AL layer data parameter structure.
bAddress: address on the card to write to. It can be the lock bytes in page 02h, the one
time only programmable bytes in page 03h or the data bytes in pages 04h to 0Fh.
*pData: pointer to 4 byte data array containing data read from the Ultralight card.
returnValues:
PH_ERR_SUCCESS - operation successful.
Other Depending on implementation and underlaying component.
2.5.4 CompatibilityWrite - phalMful_CompatibilityWrite()
This function performs MIFARE Ultralight Compatibility-Write command.
phStatus_t phalMful_CompatibilityWrite(
void * pDataParams, [In]
uint8_t bAddress, [In]
uint8_t * pData ); [Out]