blob: 648ec3896f7feeb606a50df157f782a42020bc4e [file] [log] [blame]
/*
* Copyright (C) 2010 NXP Semiconductors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* \file phFriNfc_MifStdFormat.h
* \brief NFC Ndef Formatting For Mifare standard card.
*
* Project: NFC-FRI
*
* $Date: Fri Sep 25 15:24:17 2009 $
* $Author: ing07299 $
* $Revision: 1.4 $
* $Aliases: NFC_FRI1.1_WK941_PREP2,NFC_FRI1.1_WK941_1,NFC_FRI1.1_WK943_R32_1,NFC_FRI1.1_WK949_PREP1,NFC_FRI1.1_WK943_R32_10,NFC_FRI1.1_WK943_R32_13,NFC_FRI1.1_WK943_R32_14,NFC_FRI1.1_WK1007_R33_1,NFC_FRI1.1_WK1007_R33_4,NFC_FRI1.1_WK1017_PREP1,NFC_FRI1.1_WK1017_R34_1,NFC_FRI1.1_WK1017_R34_2,NFC_FRI1.1_WK1023_R35_1 $
*
*/
#ifndef PHFRINFC_MIFSTDFORMAT_H
#define PHFRINFC_MIFSTDFORMAT_H
#include <phFriNfc.h>
#ifdef PH_HAL4_ENABLE
#include <phHal4Nfc.h>
#else
#include <phHalNfc.h>
#endif /* #ifdef PH_HAL4_ENABLE */
#include <phNfcStatus.h>
#include <phNfcTypes.h>
#include <phFriNfc_SmtCrdFmt.h>
#define PH_FRINFC_MIFSTD_FORMAT_FILEREVISION "$Revision: 1.4 $"
#define PH_FRINFC_MIFSTD_FORMAT_FILEALIASES "$Aliases: NFC_FRI1.1_WK941_PREP2,NFC_FRI1.1_WK941_1,NFC_FRI1.1_WK943_R32_1,NFC_FRI1.1_WK949_PREP1,NFC_FRI1.1_WK943_R32_10,NFC_FRI1.1_WK943_R32_13,NFC_FRI1.1_WK943_R32_14,NFC_FRI1.1_WK1007_R33_1,NFC_FRI1.1_WK1007_R33_4,NFC_FRI1.1_WK1017_PREP1,NFC_FRI1.1_WK1017_R34_1,NFC_FRI1.1_WK1017_R34_2,NFC_FRI1.1_WK1023_R35_1 $"
/*!
* \name Mifare standard - constants for the state
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_RESET_INIT 0 /*!< Reset state */
#define PH_FRINFC_MFSTD_FMT_AUTH_SECT 1 /*!< Sector authentication is in progress */
#define PH_FRINFC_MFSTD_FMT_DIS_CON 2 /*!< Disconnect is in progress */
#define PH_FRINFC_MFSTD_FMT_CON 3 /*!< Connect is in progress */
#define PH_FRINFC_MFSTD_FMT_POLL 4 /*!< Poll is in progress */
#define PH_FRINFC_MFSTD_FMT_RD_SECT_TR 5 /*!< Read sector trailer is in progress */
#define PH_FRINFC_MFSTD_FMT_WR_SECT_TR 6 /*!< Write sector trailer is in progress */
#define PH_FRINFC_MFSTD_FMT_WR_TLV 7 /*!< Write sector trailer is in progress */
#define PH_FRINFC_MFSTD_FMT_WR_MAD_BLK 8 /*!< Write MAD is in progress */
#define PH_FRINFC_MFSTD_FMT_UPD_MAD_BLK 9 /*!< Write MAD is in progress */
/*@}*/
/*!
* \name Mifare standard - Authenticate states
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_AUTH_DEF_KEY 0 /*!< Trying to authenticate with the default key */
#define PH_FRINFC_MFSTD_FMT_AUTH_NFC_KEY 1 /*!< Trying to authenticate with the MAD key */
#define PH_FRINFC_MFSTD_FMT_AUTH_MAD_KEY 2 /*!< Trying to authenticate with the NFC forum key */
#define PH_FRINFC_MFSTD_FMT_AUTH_KEYB 3 /*!< Trying to authenticate with key B */
#define PH_FRINFC_MFSTD_FMT_AUTH_SCRT_KEYB 4 /*!< Trying to authenticate with secret key B */
/*@}*/
/*!
* \name Mifare standard - Update MAD block flag
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_NOT_A_MAD_BLK 0 /*!< Not a MAD block */
#define PH_FRINFC_MFSTD_FMT_MAD_BLK_1 1 /*!< MAD block number 1 */
#define PH_FRINFC_MFSTD_FMT_MAD_BLK_2 2 /*!< MAD block number 2 */
#define PH_FRINFC_MFSTD_FMT_MAD_BLK_64 64 /*!< MAD block number 64 (only used for Mifare 4k card) */
#define PH_FRINFC_MFSTD_FMT_MAD_BLK_65 65 /*!< MAD block number 65 (only used for Mifare 4k card) */
#define PH_FRINFC_MFSTD_FMT_MAD_BLK_66 66 /*!< MAD block number 66 (only used for Mifare 4k card) */
/*@}*/
/*!
* \name Mifare standard - Update MAD block flag
*
*/
/*@{*/
#define PH_FRINFC_SMTCRDFMT_MSTD_MADSECT_KEYA_ACS_BIT_1K {0xA0,0xA1,0xA2,0xA3,0xA4,0xA5,0x78,0x77,0x88,0xC1}
#define PH_FRINFC_SMTCRDFMT_MSTD_MADSECT_KEYA_ACS_BIT_4K {0xA0,0xA1,0xA2,0xA3,0xA4,0xA5,0x78,0x77,0x88,0xC2}
#define PH_FRINFC_SMTCRDFMT_NFCFORUMSECT_KEYA_ACS_BIT {0xD3,0xF7,0xD3,0xF7,0xD3,0xF7,0x7F,0x07,0x88,0x40}
/*@}*/
/*!
* \name Mifare standard - Key and access bit constants
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_KEYA0 0xD3 /*!< NFC forum sector key A */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_KEYA1 0xF7 /*!< NFC forum sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA0 0xA0 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA1 0xA1 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA2 0xA2 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA3 0xA3 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA4 0xA4 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_KEYA5 0xA5 /*!< MAD sector key A */
#define PH_FRINFC_MFSTD_FMT_DEFAULT_KEY 0xFF /*!< Default key A or B */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_ACS6 0x78 /*!< MAD sector access bits 6 */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_ACS7 0x77 /*!< MAD sector access bits 7 */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_ACS8 0x88 /*!< MAD sector access bits 8 */
#define PH_FRINFC_MFSTD_FMT_MAD_SECT_GPB 0xC1 /*!< MAD sector GPB */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RW6 0x7F /*!< NFC forum sector access bits 6 for read write */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RW7 0x07 /*!< NFC forum sector access bits 7 for read write */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RW8 0x88 /*!< NFC forum sector access bits 8 for read write */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_GPB_RW 0x40 /*!< NFC forum sector GPB for read write */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RO6 0x07 /*!< NFC forum sector access bits 6 for read only */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RO7 0x8F /*!< NFC forum sector access bits 7 for read only */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_ACS_RO8 0x0F /*!< NFC forum sector access bits 8 for read only */
#define PH_FRINFC_MFSTD_FMT_NFC_SECT_GPB_R0 0x43 /*!< NFC forum sector GPB for read only */
/*@}*/
/*!
* \name Mifare standard - enums the values
*
*/
/*@{*/
typedef enum{
PH_FRINFC_MFSTD_FMT_VAL_0,
PH_FRINFC_MFSTD_FMT_VAL_1,
PH_FRINFC_MFSTD_FMT_VAL_2,
PH_FRINFC_MFSTD_FMT_VAL_3,
PH_FRINFC_MFSTD_FMT_VAL_4,
PH_FRINFC_MFSTD_FMT_VAL_5,
PH_FRINFC_MFSTD_FMT_VAL_6,
PH_FRINFC_MFSTD_FMT_VAL_7,
PH_FRINFC_MFSTD_FMT_VAL_8,
PH_FRINFC_MFSTD_FMT_VAL_9,
PH_FRINFC_MFSTD_FMT_VAL_10,
PH_FRINFC_MFSTD_FMT_VAL_11
}phFriNfc_MfStdVal;
/*@}*/
/*!
* \name Mifare standard - NDEF information constants
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_NON_NDEF_COMPL 0 /*!< Sector is not ndef compliant */
#define PH_FRINFC_MFSTD_FMT_NDEF_COMPL 1 /*!< Sector is ndef compliant */
#define PH_FRINFC_MFSTD_FMT_NDEF_INFO1 0x03 /*!< If sector is ndef compliant, then one of the MAD
sector byte is 0x03 */
#define PH_FRINFC_MFSTD_FMT_NDEF_INFO2 0xE1 /*!< If sector is ndef compliant, then one of the MAD
sector byte is 0xE1 */
/*@}*/
/*!
* \name Mifare standard - constants
*
*/
/*@{*/
#define PH_FRINFC_MFSTD_FMT_MAX_RECV_LENGTH 252 /*!< Maximum receive length */
#define PH_FRINFC_MFSTD_FMT_WR_SEND_LENGTH 17 /*!< Send length for write */
#define PH_FRINFC_MFSTD_FMT_MAX_SECT_IND_1K 16 /*!< Maximum sector index for Mifare 1k = 16 */
#define PH_FRINFC_MFSTD_FMT_MAX_SECT_IND_4K 40 /*!< Maximum sector index for Mifare 4k = 40 */
#define PH_FRINFC_MFSTD_FMT_MAX_BLOCKS_1K 64 /*!< Maximum sector index for Mifare 1k = 16 */
#define PH_FRINFC_MFSTD_FMT_MAX_BLOCKS_4K 256 /*!< Maximum sector index for Mifare 4k = 40 */
/*@}*/
/*!
* \name Mifare standard - constants for filling send buffer, calculating the block number,
* checking the authenticate state
*
*/
/*@{*/
/* Copy default keyA to send buffer */
#ifdef PH_HAL4_ENABLE
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_DEF(mem)\
do \
{\
(void)memset(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
PH_FRINFC_MFSTD_FMT_DEFAULT_KEY,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = ((NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState == \
PH_FRINFC_MFSTD_FMT_AUTH_DEF_KEY)? \
phHal_eMifareAuthentA: \
phHal_eMifareAuthentB); \
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7; \
}while(0)
/* Copy NFC forum sector keyA to send buffer */
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_NFCSECT_KEYA(mem)\
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.NFCForumSect_KeyA,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareAuthentA;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
/* Copy MAD sector keyA to send buffer */
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_MADSECT_KEYA(mem)\
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.MADSect_KeyA,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareAuthentA;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_SCRT_KEY(mem) \
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.ScrtKeyB,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareAuthentB;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
#else
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_DEF(mem)\
do \
{\
(void)memset(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
PH_FRINFC_MFSTD_FMT_DEFAULT_KEY,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = ((NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState == \
PH_FRINFC_MFSTD_FMT_AUTH_DEF_KEY)? \
phHal_eMifareCmdListMifareAuthentA: \
phHal_eMifareCmdListMifareAuthentB); \
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7; \
}while(0)
/* Copy NFC forum sector keyA to send buffer */
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_NFCSECT_KEYA(mem)\
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.NFCForumSect_KeyA,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareCmdListMifareAuthentA;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
/* Copy MAD sector keyA to send buffer */
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_MADSECT_KEYA(mem)\
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.MADSect_KeyA,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareCmdListMifareAuthentA;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
#define PH_FRINFC_MFSTD_FMT_AUTH_SEND_BUF_SCRT_KEY(mem) \
do \
{\
(void)memcpy(&NdefSmtCrdFmt->SendRecvBuf[PH_FRINFC_MFSTD_FMT_VAL_1],\
NdefSmtCrdFmt->AddInfo.MfStdInfo.ScrtKeyB,\
PH_FRINFC_MFSTD_FMT_VAL_6);\
NdefSmtCrdFmt->Cmd.MfCmd = phHal_eMifareCmdListMifareAuthentB;\
NdefSmtCrdFmt->SendLength = PH_FRINFC_MFSTD_FMT_VAL_7;\
} while(0)
#endif /* #ifdef PH_HAL4_ENABLE */
/* Get the next block */
#define PH_FRINFC_MFSTD_FMT_CUR_BLK_INC() \
NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock += \
((NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock >= 127)?\
16:4)
/* Get the sector index */
#define PH_FRINFC_MFSTD_FMT_SECT_INDEX_CALC \
((NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock >= 128)?\
(32 + ((NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock - 128)/16)):\
(NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock/4))
#define PH_FRINFC_MFSTD_FMT_CUR_BLK_CHK\
((NdefSmtCrdFmt->CardType == PH_FRINFC_SMTCRDFMT_MFSTD_1K_CRD) && \
(NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock >= \
PH_FRINFC_MFSTD_FMT_MAX_BLOCKS_1K)) || \
((NdefSmtCrdFmt->CardType == PH_FRINFC_SMTCRDFMT_MFSTD_4K_CRD) && \
(NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock >= \
PH_FRINFC_MFSTD_FMT_MAX_BLOCKS_4K))
/* Get the next authenticate state */
#define PH_FRINFC_MFSTD_FMT_NXT_AUTH_STATE() \
do \
{\
switch(NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState)\
{\
case PH_FRINFC_MFSTD_FMT_AUTH_DEF_KEY:\
{\
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = (uint8_t) \
((((NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock <= 3) || \
((NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock > 63) && \
(NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock < 67))))? \
PH_FRINFC_MFSTD_FMT_AUTH_MAD_KEY: \
PH_FRINFC_MFSTD_FMT_AUTH_NFC_KEY);\
}\
break;\
case PH_FRINFC_MFSTD_FMT_AUTH_NFC_KEY:\
{\
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = \
PH_FRINFC_MFSTD_FMT_AUTH_KEYB;\
}\
break;\
case PH_FRINFC_MFSTD_FMT_AUTH_MAD_KEY:\
{\
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = \
PH_FRINFC_MFSTD_FMT_AUTH_NFC_KEY;\
}\
break;\
case PH_FRINFC_MFSTD_FMT_AUTH_KEYB:\
{ \
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = \
PH_FRINFC_MFSTD_FMT_AUTH_SCRT_KEYB;\
} \
break;\
case PH_FRINFC_MFSTD_FMT_AUTH_SCRT_KEYB:\
default:\
{ \
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = \
PH_FRINFC_MFSTD_FMT_AUTH_DEF_KEY;\
}\
break;\
}\
} while(0)
/* Increment the sector index */
#define PH_FRINFC_MFSTD_FMT_INCR_SECT \
do \
{\
SectIndex++;\
SectIndex = (uint8_t)((SectIndex == 16)?\
(SectIndex + PH_FRINFC_MFSTD_FMT_VAL_1):\
SectIndex);\
} while(0)
/* Increment the sector index */
#define PH_FRINFC_MFSTD_FMT_CHK_SECT_ARRAY \
do \
{\
while ((index < PH_FRINFC_MFSTD_FMT_MAX_SECT_IND_4K) && \
(memcompare != PH_FRINFC_MFSTD_FMT_VAL_0))\
{\
/* Compare any one among the sectors is NDEF COMPLIANT */\
memcompare = (uint32_t)phFriNfc_MfStd_MemCompare(&Buffer[PH_FRINFC_MFSTD_FMT_VAL_0], \
&NdefSmtCrdFmt->AddInfo.MfStdInfo.SectCompl[index],\
PH_FRINFC_MFSTD_FMT_VAL_1);\
/* increment the index */\
index += (uint8_t)((index == (PH_FRINFC_MFSTD_FMT_MAX_SECT_IND_1K - \
PH_FRINFC_MFSTD_FMT_VAL_1))?\
PH_FRINFC_MFSTD_FMT_VAL_2:\
PH_FRINFC_MFSTD_FMT_VAL_1);\
}\
} while(0)
#define PH_FRINFC_MFSTD_FMT_CHK_END_OF_CARD() \
do \
{ \
phFriNfc_MfStd_H_NdefComplSect(NdefSmtCrdFmt->CardType, \
NdefSmtCrdFmt->AddInfo.MfStdInfo.SectCompl); \
PH_FRINFC_MFSTD_FMT_CHK_SECT_ARRAY; \
if(memcompare == PH_FRINFC_MFSTD_FMT_VAL_0) \
{ \
phFriNfc_MfStd_H_StrNdefData(NdefSmtCrdFmt); \
NdefSmtCrdFmt->AddInfo.MfStdInfo.CurrentBlock = \
PH_FRINFC_MFSTD_FMT_VAL_1; \
NdefSmtCrdFmt->AddInfo.MfStdInfo.UpdMADBlk = \
PH_FRINFC_MFSTD_FMT_MAD_BLK_1; \
NdefSmtCrdFmt->AddInfo.MfStdInfo.AuthState = \
PH_FRINFC_MFSTD_FMT_AUTH_SCRT_KEYB; \
NdefSmtCrdFmt->State = PH_FRINFC_MFSTD_FMT_AUTH_SECT; \
Result = phFriNfc_MfStd_H_WrRdAuth(NdefSmtCrdFmt); \
} \
else \
{ \
Result = PHNFCSTVAL(CID_FRI_NFC_NDEF_SMTCRDFMT, \
NFCSTATUS_FORMAT_ERROR); \
} \
} while(0)
/*@}*/
/**
* \ingroup grp_fri_smart_card_formatting
* \brief Smart Card Formatting \b Reset function
*
* \copydoc page_reg Resets the component instance to the initial state and initializes the
* internal variables.
*/
void phFriNfc_MfStd_Reset(phFriNfc_sNdefSmtCrdFmt_t *NdefSmtCrdFmt);
/*!
* \ingroup grp_fri_smart_card_formatting
*
* \brief Initiates the card formatting procedure for Remote Smart Card Type.
*
* \copydoc page_ovr The function initiates and formats the Smart Card.After this formation, remote
* card would be properly initialized and Ndef Compliant.
* Depending upon the different card type, this function handles formatting procedure.
* This function also handles the different recovery procedures for different types of the cards. For both
* Format and Recovery Management same API is used.
*
* \param[in] phFriNfc_sNdefSmartCardFmt_t Pointer to a valid instance of the \ref phFriNfc_sNdefSmartCardFmt_t
* structure describing the component context.
* \retval NFCSTATUS_PENDING The action has been successfully triggered.
* \retval Other values An error has occurred.
*
*/
NFCSTATUS phFriNfc_MfStd_Format(phFriNfc_sNdefSmtCrdFmt_t *NdefSmtCrdFmt, const uint8_t *ScrtKeyB);
/**
*\ingroup grp_fri_smart_card_formatting
*
* \brief Smart card Formatting \b Completion \b Routine or \b Process function
*
* \copydoc page_ovr Completion Routine: This function is called by the lower layer (OVR HAL)
* when an I/O operation has finished. The internal state machine decides
* whether to call into the lower device again or to complete the process
* by calling into the upper layer's completion routine, stored within this
* component's context (\ref phFriNfc_sNdefSmtCrdFmt_t).
*
* The function call scheme is according to \ref grp_interact. No State reset is performed during
* operation.
*
* \param[in] Context The context of the current (not the lower/upper) instance, as set by the lower,
* calling layer, upon its completion.
* \param[in] Status The completion status of the lower layer (to be handled by the implementation of
* the state machine of this function like a regular return value of an internally
* called function).
*
* \note For general information about the completion routine interface please see \ref pphFriNfc_Cr_t . * The Different Status Values are as follows
*
*/
void phFriNfc_MfStd_Process(void *Context,
NFCSTATUS Status);
#endif /* PHFRINFC_MIFSTDFMT_H */