These Components implement the MIFARE Identity Data Management related commands. More...

Collaboration diagram for Commands_DataManagement:

Functions
phStatus_t	phalMfIdentity_ReadData (void pDataParams, uint8_t bOption, uint8_t bIns, uint8_t bFileNo, uint8_t pOffset, uint8_t pLength, uint8_t ppRxdata, uint16_t pRxdataLen)
	Reads data from standard data files or backup data files. More...

phStatus_t	phalMfIdentity_WriteData (void pDataParams, uint8_t bOption, uint8_t bIns, uint8_t bFileNo, uint8_t pOffset, uint8_t pTxData, uint8_t pTxDataLen)
	Writes data to standard data files or backup data files. More...

phStatus_t	phalMfIdentity_ReadRecords (void pDataParams, uint8_t bCommOption, uint8_t bIns, uint8_t bFileNo, uint8_t pRecNo, uint8_t pRecCount, uint8_t pRecSize, uint8_t *ppRxdata, uint16_t pRxdataLen)
	Reads out a set of complete records from a Cyclic or Linear Record File. More...

phStatus_t	phalMfIdentity_WriteRecord (void pDataParams, uint8_t bCommOption, uint8_t bIns, uint8_t bFileNo, uint8_t pOffset, uint8_t pData, uint8_t pDataLen)
	Writes data to a record in a Cyclic or Linear Record File. More...

phStatus_t	phalMfIdentity_ClearRecordFile (void *pDataParams, uint8_t bFileNo)
	Resets a Cyclic or Linear Record File. More...

Detailed Description

These Components implement the MIFARE Identity Data Management related commands.

Function Documentation

◆ phalMfIdentity_ReadData()

phStatus_t phalMfIdentity_ReadData	(	void *	pDataParams,
		uint8_t	bOption,
		uint8_t	bIns,
		uint8_t	bFileNo,
		uint8_t *	pOffset,
		uint8_t *	pLength,
		uint8_t **	ppRxdata,
		uint16_t *	pRxdataLen
	)

Reads data from standard data files or backup data files.

Remarks

Chaining upto the size of the HAL Rx buffer is handled within this function. If more data is to be read, the user has to call this function again with bOption = PH_EXCHANGE_RXCHAINING | [one of the communication options]

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_SUCCESS_CHAINING	indicating more data to be read.
Depending	on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bOption	[In] Communication settings for the file. PHAL_MFIDENTITY_COMMUNICATION_PLAIN PHAL_MFIDENTITY_COMMUNICATION_MACD PHAL_MFIDENTITY_COMMUNICATION_ENC `PH_EXCHANGE_RXCHAINING:` To be Or'd with the above option flag if Chaining status is returned.
[in]	bIns	[In] If set, uses ISO 14443-4 chaining instead of DESFire application chaining.
[in]	bFileNo	[In] The file number from where the data to be read.
[in]	pOffset	[In] The offset from where the data should be read. Will be of 3 bytes with LSB first. `If` 0x10 need to be offset then it will be 10 00 00.
[in]	pLength	[In] The number of bytes to be read. Will be of 3 bytes with LSB first. `If` 0x10 bytes need to be read then it will be 10 00 00. `If` complete file need to be read then it will be 00 00 00.
[out]	ppRxdata	[Out] The data retuned by the PICC.
[out]	pRxdataLen	[Out] Length of bytes available in RxData buffer.

◆ phalMfIdentity_WriteData()

phStatus_t phalMfIdentity_WriteData	(	void *	pDataParams,
		uint8_t	bOption,
		uint8_t	bIns,
		uint8_t	bFileNo,
		uint8_t *	pOffset,
		uint8_t *	pTxData,
		uint8_t *	pTxDataLen
	)

Writes data to standard data files or backup data files.

Remarks: Implements chaining to the card.

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] Communication settings for the file. PHAL_MFIDENTITY_COMMUNICATION_PLAIN PHAL_MFIDENTITY_COMMUNICATION_MACD PHAL_MFIDENTITY_COMMUNICATION_ENC
[in]	bIns	[In] If set, uses ISO 14443-4 chaining instead of DESFire application chaining.
[in]	bFileNo	[In] The file number from where the data to be read.
[in]	pOffset	[In] The offset from where the data should be written. Will be of 3 bytes with LSB first. `If` 0x10 need to be offset then it will be 10 00 00.
[in]	pTxData	[In] The data to be written to the PICC.
[in]	pTxDataLen	[In] The number of bytes to be written. Will be of 3 bytes with LSB first. `If` 0x10 bytes need to be written then it will be 10 00 00.

◆ phalMfIdentity_ReadRecords()

phStatus_t phalMfIdentity_ReadRecords	(	void *	pDataParams,
		uint8_t	bCommOption,
		uint8_t	bIns,
		uint8_t	bFileNo,
		uint8_t *	pRecNo,
		uint8_t *	pRecCount,
		uint8_t *	pRecSize,
		uint8_t **	ppRxdata,
		uint16_t *	pRxdataLen
	)

Reads out a set of complete records from a Cyclic or Linear Record File.

Remarks: The readrecords command reads and stores data in the rxbuffer upto the rxbuffer size before returning to the user. The rxbuffer is configured during the HAL init and this is specified by the user.

Chaining upto the size of the HAL Rx buffer is handled within this function. If more data is to be read, the user has to call this function again with bCommOption = PH_EXCHANGE_RXCHAINING | [one of the communication options]

If TMI collection is ON, if pRecCount is zero then pRecSize is madatory parameter. If pRecSize and RecCount are zero and TMI collection is ON, then PH_ERR_INVALID_PARAMETER error returned. If TMI collection is ON; and if wrong pRecSize is provided, then wrong RecCount value will be calculated and updated for TMI collection.

Returns: Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_SUCCESS_CHAINING	indicating more data to be read.
Depending	on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bCommOption	[In] Communication settings for the file. PHAL_MFIDENTITY_COMMUNICATION_PLAIN PHAL_MFIDENTITY_COMMUNICATION_MACD PHAL_MFIDENTITY_COMMUNICATION_ENC `PH_EXCHANGE_RXCHAINING:` To be Or'd with the above option flag if Chaining status is returned.
[in]	bIns	[In] If set, uses ISO 14443-4 chaining instead of DESFire application chaining.
[in]	bFileNo	[In] The file number from where the data to be read.
[in]	pRecNo	[In] 3 bytes LSB first. Record number of the newest record targeted, starting to count from the latest record written.
[in]	pRecCount	[In] 3 bytes LSB first. Number of records to be read. If 0x00 00 00, then all the records are read.
[in]	pRecSize	[In] The number of bytes to be read. Will be of 3 bytes with LSB first.
[out]	ppRxdata	[Out] The data retuned by the PICC.
[out]	pRxdataLen	[Out] Length of bytes available in RxData buffer.

◆ phalMfIdentity_WriteRecord()

phStatus_t phalMfIdentity_WriteRecord	(	void *	pDataParams,
		uint8_t	bCommOption,
		uint8_t	bIns,
		uint8_t	bFileNo,
		uint8_t *	pOffset,
		uint8_t *	pData,
		uint8_t *	pDataLen
	)

Writes data to a record in a Cyclic or Linear Record File.

Remarks: Implements chaining to the card. The data provided on pData will be chained to the card by sending data upto the frame size of the DESFire PICC, at a time.

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]	bCommOption	[In] Communication settings for the file. PHAL_MFIDENTITY_COMMUNICATION_PLAIN PHAL_MFIDENTITY_COMMUNICATION_MACD PHAL_MFIDENTITY_COMMUNICATION_ENC
[in]	bIns	[In] If set, uses ISO 14443-4 chaining instead of DESFire application chaining.
[in]	bFileNo	[In] The file number to which the data should be written.
[in]	pOffset	[In] The offset from where the data should be written. Will be of 3 bytes with LSB first. `If` 0x10 need to be offset then it will be 10 00 00.
[in]	pData	[In] The data to be written to the PICC.
[in]	pDataLen	[In] The number of bytes to be written. Will be of 3 bytes with LSB first. `If` 0x10 bytes need to be written then it will be 10 00 00.

◆ phalMfIdentity_ClearRecordFile()

phStatus_t phalMfIdentity_ClearRecordFile	(	void *	pDataParams,
		uint8_t	bFileNo
	)

Resets a Cyclic or Linear Record File.

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]	bFileNo	[In] The file number to be cleared.

Functions

Detailed Description

Function Documentation

◆ phalMfIdentity_ReadData()

◆ phalMfIdentity_WriteData()

◆ phalMfIdentity_ReadRecords()

◆ phalMfIdentity_WriteRecord()

◆ phalMfIdentity_ClearRecordFile()