Key Management

SAM commands used for key management related configuration. More...

Collaboration diagram for Key Management:

Macros
#define	PHHAL_HW_SAMAV2_CMD_AV1_KEY_ENTRY_RESPONSE_NO_VC_LENGTH   0x0BU
	Response in AV1 Mode length if VC is not available.
#define	PHHAL_HW_SAMAV2_CMD_AV1_KEY_ENTRY_RESPONSE_VC_LENGTH   0x0CU
	Response in AV1 Mode length if VC is available.
#define	PHHAL_HW_SAMAV2_CMD_AV2_KEY_ENTRY_RESPONSE_NO_VC_LENGTH   0x0CU
	Response in AV2 Mode length if VC is not available.
#define	PHHAL_HW_SAMAV2_CMD_AV2_KEY_ENTRY_RESPONSE_VC_LENGTH   0x0DU
	Response in AV2 Mode length if VC is available.

Functions
phStatus_t	phhalHw_SamAV2_Cmd_SAM_GetKeyEntry (phhalHw_SamAV2_DataParams_t *pDataParams, uint8_t bKeyNo, uint8_t *pKeyEntry, uint8_t *bKeyEntryLength)
	Get information about a key entry. More...
phStatus_t	phhalHw_SamAV2_Cmd_SAM_GetKUCEntry (phhalHw_SamAV2_DataParams_t *pDataParams, uint8_t bKucNo, uint8_t *pKucEntry)
	Get information about a key usage counter (KUC). More...

Sam AV2 command code for Sam Key Management feature.
#define	PHHAL_HW_SAMAV2_CMD_GET_KEYENTRY_INS   0x64U
	CMD Byte for GetKeyEntry command.
#define	PHHAL_HW_SAMAV2_CMD_GET_KUCENTRY_INS   0x6CU
	CMD Byte for GetKUCEntry command.

Detailed Description

SAM commands used for key management related configuration.

Function Documentation

phhalHw_SamAV2_Cmd_SAM_GetKeyEntry()

phStatus_t phhalHw_SamAV2_Cmd_SAM_GetKeyEntry	(	phhalHw_SamAV2_DataParams_t *	pDataParams,
		uint8_t	bKeyNo,
		uint8_t *	pKeyEntry,
		uint8_t *	bKeyEntryLength
	)

Get information about a key entry.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bKeyNo	[In] Reference number of the key entry to be returned (00h to 7Fh).
[out]	pKeyEntry	[Out] Buffer containing the information about the key entry. This buffer has to be 13 bytes long.
[out]	bKeyEntryLength	[Out] Amount of valid bytes in pKeyEntry.

phhalHw_SamAV2_Cmd_SAM_GetKUCEntry()

phStatus_t phhalHw_SamAV2_Cmd_SAM_GetKUCEntry	(	phhalHw_SamAV2_DataParams_t *	pDataParams,
		uint8_t	bKucNo,
		uint8_t *	pKucEntry
	)

Get information about a key usage counter (KUC).

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bKucNo	[In] Reference number of the key usage counter to be returned (00h to 0Fh).
[out]	pKucEntry	[Out] Buffer containing the KUC entry. This buffer has to be 10 bytes long.