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
29 of 47
void * pDataParams ); [In]
*pDataParams: pointer to the PAL layer data parameter structure.
returnValues:
PH_ERR_SUCCESS : card has been turned into Halt mode successfully. After Halt command
has been transmitted to the card and no subsequent RF signal from card received. Time
to wait is by value
PHPAL_I14443P3A_HALT_TIME_US + PHPAL_I14443P3A_EXT_TIME_US in
microseconds.
PH_ERR_PROTOCOL_ERROR : protocol error occurred. After transmitting Halt command some
echo signal has been detected, which is considered that card has not turned Halt mode.
Other: depending on implementation and underlaying component.
2.3.9 Wake up A - phStatus_t phpalI14443p3a_WakeUpA()
This function reactivates a card if the card has been pushed to Halt state before. The
Request Guard Time (see 6.2.2, ISO/IEC 14443-3:2009(E)) is mandatory and is neither
implemented here nor implemented in every HAL layer. Make sure that either the used
HAL or the used application does comply to this rule.
phStatus_t phpalI14443p3a_WakeUpA(
void * pDataParams, [In]
uint8_t * pAtqa ); [Out]
*pDataParams pointer to the PAL layer data parameter structure.
*pAtqa pointer to ATQA. If WakuUpA is successful, then 2 byte ATQA is written to this
variable.
returnValues:
PH_ERR_PROTOCOL_ERROR: invalid response code received.
PH_ERR_SUCCESS - operation successful.
Other: depending on implementation and underlaying component.
2.4 AL: MIFARE Classic commands
This section describes MIFARE Authentication function and data manipulating functions
reflecting data manipulating MIFARE commands. You can find further information about
the MIFARE Classic commands in [2]. All of them are implemented in the Application
Layer of the NXP Reader Library in the folder NxpRdbLib_PublicRelease/comps/phalMfc.
2.4.1 Init MIFARE Classic - phalMfc_Sw_Init()
This function initiates MIFARE Classic card component.
phStatus_t phalMfc_Sw_Init(
phalMfc_Sw_DataParams_t * pDataParams, [In]
uint16_t wSizeOfDataParams, [In]
void * pPalMifareDataParams, [In]
void * pKeyStoreDataParams ); [In]
*pDataParams: pointer to the AL parameter structure.
wSizeOfDataParams: specifies the size of the data parameter structure. Recommended
to pass here sizeof(phalMfc_Sw_DataParams_t) .
*pPalMifareDataParams: pointer to the undelaying PAL parameter structure.