KeyStore Provisioning

KeyStore Provisioning Command of HAL DUT Command dispatcher frame. More...

Collaboration diagram for KeyStore Provisioning:

Modules
	Command_Codes
	KeyStore Provisioning Command Codes of HAL DUT Command dispatcher frame.

Functions
phStatus_t	phhalHw_DUT_Cmd_KeyStore_Provision_Init (phhalHw_DUT_DataParams_t *pDataParams, uint16_t wOption, uint8_t *pTransportKey_AES128, uint8_t *pTransportKey_AES256, uint8_t *pAppRootKey_AES128, uint8_t *pAppRootKey_AES256, uint8_t *pExpDecData, uint8_t *pDervMsg, uint8_t *pWrapIV)
	Initializes the KeyStore component for Key provisioning. More...
void	phhalHw_DUT_Cmd_KeyStore_Provision_DeInit (phhalHw_DUT_DataParams_t *pDataParams)
	De-Initializes PN7642 KeyStore component for Key provisioning. More...
phStatus_t	phhalHw_DUT_Cmd_KeyStore_SetConfig_Ext (phhalHw_DUT_DataParams_t *pDataParams, uint16_t wConfig, uint8_t *pValue, uint16_t wValueLen)
	Set configuration parameter. More...
phStatus_t	phhalHw_DUT_Cmd_KeyStore_GetConfig_Ext (phhalHw_DUT_DataParams_t *pDataParams, uint16_t wConfig, uint8_t *pValue, uint16_t *pValueLen)
	Get configuration parameter. More...
phStatus_t	phhalHw_DUT_Cmd_KeyStore_Provision_AppFixedKeys (phhalHw_DUT_DataParams_t *pDataParams, uint8_t bKeyIndex, uint16_t wKeyType, uint8_t *pNewKey)
	Provision Application Fixed Keys. More...

Detailed Description

KeyStore Provisioning Command of HAL DUT Command dispatcher frame.

Function Documentation

phhalHw_DUT_Cmd_KeyStore_Provision_Init()

phStatus_t phhalHw_DUT_Cmd_KeyStore_Provision_Init	(	phhalHw_DUT_DataParams_t *	pDataParams,
		uint16_t	wOption,
		uint8_t *	pTransportKey_AES128,
		uint8_t *	pTransportKey_AES256,
		uint8_t *	pAppRootKey_AES128,
		uint8_t *	pAppRootKey_AES256,
		uint8_t *	pExpDecData,
		uint8_t *	pDervMsg,
		uint8_t *	pWrapIV
	)

Initializes the KeyStore component for Key provisioning.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to an initialized HAL parameter structure.
[in]	wOption	[In] Options to perform the following.
[in]	pTransportKey_AES128	[In] Array containing AES 128-Bit [16 Byte] Transport Key.
[in]	pTransportKey_AES256	[In] Array containing AES 256-Bit [32 Byte] Transport Key.
[in]	pAppRootKey_AES128	[In] Array containing AES 128-Bit [16 Byte] Application Root Key. Should not be Null.
[in]	pAppRootKey_AES256	[In] Array containing AES 256-Bit [32 Byte] Application Root Key. Should not be Null.
[in]	pExpDecData	[In] Array containing AES 128-Bit [16 Byte] expected Decrypted data to be used while
[in]	pDervMsg	[In] Array containing derivation message. Should not be NULL.
[in]	pWrapIV	[In] IV used for wrapping the key. This information will be used while provisioning the Key.

phhalHw_DUT_Cmd_KeyStore_Provision_DeInit()

void phhalHw_DUT_Cmd_KeyStore_Provision_DeInit

(

phhalHw_DUT_DataParams_t *

pDataParams

)

De-Initializes PN7642 KeyStore component for Key provisioning.

Parameters

[in]

pDataParams

[In] Pointer to an initialized HAL parameter structure.

phhalHw_DUT_Cmd_KeyStore_SetConfig_Ext()

phStatus_t phhalHw_DUT_Cmd_KeyStore_SetConfig_Ext	(	phhalHw_DUT_DataParams_t *	pDataParams,
		uint16_t	wConfig,
		uint8_t *	pValue,
		uint16_t	wValueLen
	)

Set configuration parameter.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to an initialized HAL parameter structure.
[in]	wConfig	[In] Configuration Identifier.
[in]	pValue	[In] Configuration Value to update.
[in]	wValueLen	[In] Length of byte available in pValue buffer.

phhalHw_DUT_Cmd_KeyStore_GetConfig_Ext()

phStatus_t phhalHw_DUT_Cmd_KeyStore_GetConfig_Ext	(	phhalHw_DUT_DataParams_t *	pDataParams,
		uint16_t	wConfig,
		uint8_t *	pValue,
		uint16_t *	pValueLen
	)

Get configuration parameter.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to an initialized HAL parameter structure.
[in]	wConfig	[In] Configuration Identifier.
[in]	pValue	[In] Configuration Value to retrieve.
[in]	pValueLen	[In] Length of byte available in pValue buffer.

phhalHw_DUT_Cmd_KeyStore_Provision_AppFixedKeys()

phStatus_t phhalHw_DUT_Cmd_KeyStore_Provision_AppFixedKeys	(	phhalHw_DUT_DataParams_t *	pDataParams,
		uint8_t	bKeyIndex,
		uint16_t	wKeyType,
		uint8_t *	pNewKey
	)

Provision Application Fixed Keys.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to an initialized HAL parameter structure.
[in]	bKeyIndex	[In] Key number of the hardware keys store to be provisioned.
[in]	wKeyType	[In] Key type of the key to be loaded. Should be one of the following
[in]	pNewKey	[In] Pointer to the key itself.