/* * 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 #ifdef PH_HAL4_ENABLE #include #else #include #endif /* #ifdef PH_HAL4_ENABLE */ #include #include #include #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 */