These Components implement the MIFARE DESFire ISO/IEC 7816-4 Basic inter-industry commands. More...

Collaboration diagram for Commands_ISO7816:

Modules
	Defines
	These are definitions for phalMfdf_IsoSelectFile.

Functions
phStatus_t	phalMfdf_IsoSelectFile (void pDataParams, uint8_t bOption, uint8_t bSelector, uint8_t pFid, uint8_t pDFname, uint8_t bDFnameLen, uint8_t ppFCI, uint16_t pwFCILen)
	ISO Select. More...

phStatus_t	phalMfdf_IsoReadBinary (void pDataParams, uint16_t wOption, uint8_t bOffset, uint8_t bSfid, uint8_t bBytesToRead, uint8_t ppRxBuffer, uint16_t pBytesRead)
	ISO Read Binary. More...

phStatus_t	phalMfdf_IsoUpdateBinary (void pDataParams, uint8_t bOffset, uint8_t bSfid, uint8_t pData, uint8_t bDataLen)
	Iso Update Binary. More...

phStatus_t	phalMfdf_IsoReadRecords (void pDataParams, uint16_t wOption, uint8_t bRecNo, uint8_t bReadAllFromP1, uint8_t bSfid, uint8_t bBytesToRead, uint8_t ppRxBuffer, uint16_t pBytesRead)
	Iso Read Records. More...

phStatus_t	phalMfdf_IsoAppendRecord (void pDataParams, uint8_t bSfid, uint8_t pData, uint8_t bDataLen)
	Iso Append record. More...

phStatus_t	phalMfdf_IsoGetChallenge (void pDataParams, uint16_t wKeyNo, uint16_t wKeyVer, uint8_t bLe, uint8_t pRPICC1)
	ISOGetChallenge. More...

Detailed Description

These Components implement the MIFARE DESFire ISO/IEC 7816-4 Basic inter-industry commands.

Function Documentation

◆ phalMfdf_IsoSelectFile()

phStatus_t phalMfdf_IsoSelectFile	(	void *	pDataParams,
		uint8_t	bOption,
		uint8_t	bSelector,
		uint8_t *	pFid,
		uint8_t *	pDFname,
		uint8_t	bDFnameLen,
		uint8_t **	ppFCI,
		uint16_t *	pwFCILen
	)

ISO Select.

This command is implemented in compliance with ISO/IEC 7816-4.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bOption	[In] Option for return / no return of FCI. PHAL_MFDF_FCI_RETURNED PHAL_MFDF_FCI_NOT_RETURNED
[in]	bSelector	[In] The selector to be used. PHAL_MFDF_SELECTOR_0 PHAL_MFDF_SELECTOR_2 PHAL_MFDF_SELECTOR_4
[in]	pFid	[In] The ISO File number to be selected.
[in]	pDFname	[In] The ISO DFName to be selected. Valid only when bOption = 0x04.
[in]	bDFnameLen	[In] Length of bytes available in DFname buffer.
[out]	ppFCI	[Out] The FCI information returned by the PICC.
[out]	pwFCILen	[Out] Length of bytes available in FCI buffer.

◆ phalMfdf_IsoReadBinary()

phStatus_t phalMfdf_IsoReadBinary	(	void *	pDataParams,
		uint16_t	wOption,
		uint8_t	bOffset,
		uint8_t	bSfid,
		uint8_t	bBytesToRead,
		uint8_t **	ppRxBuffer,
		uint16_t *	pBytesRead
	)

ISO Read Binary.

This command is implemented in compliance with ISO/IEC 7816-4.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_SUCCESS_CHAINING	operation success with chaining.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	wOption	[In] One of the below options. PH_EXCHANGE_DEFAULT : To exchange the initial command to the PICC. PH_EXCHANGE_RXCHAINING: To exchange the chaining command to PICC in case PICC returns AF as the status.
[in]	bOffset	[In] The offset from where the data should be read.
[in]	bSfid	[In] Short ISO File Id. Bit 7 should be 1 to indicate Sfid is supplied. Else it is treated as MSB of 2Byte offset.
[in]	bBytesToRead	[In] Number of bytes to read. If 0, then entire file to be read.
[out]	ppRxBuffer	[Out] The data retuned by the PICC.
[out]	pBytesRead	[Out] Length of bytes available in RxData buffer.

◆ phalMfdf_IsoUpdateBinary()

phStatus_t phalMfdf_IsoUpdateBinary	(	void *	pDataParams,
		uint8_t	bOffset,
		uint8_t	bSfid,
		uint8_t *	pData,
		uint8_t	bDataLen
	)

Iso Update Binary.

This command is implemented in compliance with ISO/IEC 7816-4.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bOffset	[In] The offset from where the data should be updated.
[in]	bSfid	[In] Short ISO File Id. Bit 7 should be 1 to indicate Sfid is supplied. Else it is treated as MSB of 2Byte offset.
[in]	pData	[In] Data to be updated.
[in]	bDataLen	[In] Length of bytes available in Data buffer.

◆ phalMfdf_IsoReadRecords()

phStatus_t phalMfdf_IsoReadRecords	(	void *	pDataParams,
		uint16_t	wOption,
		uint8_t	bRecNo,
		uint8_t	bReadAllFromP1,
		uint8_t	bSfid,
		uint8_t	bBytesToRead,
		uint8_t **	ppRxBuffer,
		uint16_t *	pBytesRead
	)

Iso Read Records.

This command is implemented in compliance with ISO/IEC 7816-4.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	wOption	[In] One of the below options. PH_EXCHANGE_DEFAULT : To exchange the initial command to the PICC. PH_EXCHANGE_RXCHAINING: To exchange the chaining command to PICC in case PICC returns AF as the status.
[in]	bRecNo	[In] Record to read / from where to read.
[in]	bReadAllFromP1	[In] Whether to read all records from P1 or just one.
[in]	bSfid	[In] Short ISO File Id.
[in]	bBytesToRead	[In] Number of bytes to read.
[out]	ppRxBuffer	[Out] The data retuned by the PICC.
[out]	pBytesRead	[Out] Length of bytes available in RxData buffer.

◆ phalMfdf_IsoAppendRecord()

phStatus_t phalMfdf_IsoAppendRecord	(	void *	pDataParams,
		uint8_t	bSfid,
		uint8_t *	pData,
		uint8_t	bDataLen
	)

Iso Append record.

This command is implemented in compliance with ISO/IEC 7816-4.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bSfid	[In] Short ISO File Id.
[in]	pData	[In] Data to be appended.
[in]	bDataLen	[In] Length of bytes available in Data buffer.

◆ phalMfdf_IsoGetChallenge()

phStatus_t phalMfdf_IsoGetChallenge	(	void *	pDataParams,
		uint16_t	wKeyNo,
		uint16_t	wKeyVer,
		uint8_t	bLe,
		uint8_t *	pRPICC1
	)

ISOGetChallenge.

This command is implemented in compliance with ISO/IEC 7816-4.

Remarks: THIS COMMAND IS NOT SUPPORTED IN SAM-X Configuration.

Returns the random number from the PICC. Size depends on the key type referred by wKeyNo and wKeyVer.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	wKeyNo	[In] Key number to be used form keystore.
[in]	wKeyVer	[In] Key version to be used from key store.
[in]	bLe	[In] Length of expected challenge RPICC1.
[out]	pRPICC1	[Out] RPICC1 returned from PICC.

Modules

Functions

Detailed Description

Function Documentation

◆ phalMfdf_IsoSelectFile()

◆ phalMfdf_IsoReadBinary()

◆ phalMfdf_IsoUpdateBinary()

◆ phalMfdf_IsoReadRecords()

◆ phalMfdf_IsoAppendRecord()

◆ phalMfdf_IsoGetChallenge()