xilasu
Vitis Drivers API Documentation
KDF Client APIs

Functions

s32 XAsu_KdfGenerate (XAsu_ClientParams *ClientParamsPtr, XAsu_KdfParams *KdfParamsPtr)
 This function sends command to ASUFW to generate the derived key of specified key length by using the Key Derivative Function (KDF) in counter mode. More...
 
s32 XAsu_KdfKat (XAsu_ClientParams *ClientParamsPtr)
 This function sends command to ASUFW to perform KDF Known Answer Tests (KAT's). More...
 

Function Documentation

s32 XAsu_KdfGenerate ( XAsu_ClientParams ClientParamsPtr,
XAsu_KdfParams KdfParamsPtr 
)

This function sends command to ASUFW to generate the derived key of specified key length by using the Key Derivative Function (KDF) in counter mode.

Parameters
ClientParamsPtrPointer to the XAsu_ClientParams structure which holds the client input parameters.
KdfParamsPtrPointer to XAsu_KdfParams structure which holds the parameters of KDF input arguments.
Returns
  • XST_SUCCESS, if IPI request to ASU is sent successfully.
  • XASU_INVALID_ARGUMENT, if any argument is invalid.
  • XASU_INVALID_UNIQUE_ID, if received Queue ID is invalid.
  • XST_FAILURE, if sending IPI request to ASU fails.

Validate input parameters.

Get the command ID based on SHA type.

Update request buffer and send an IPI request to ASU.

References XAsu_KdfParams::ShaType, XAsu_CreateHeader(), XASU_INVALID_UNIQUE_ID, XASU_KDF_GENERATE_SHA2_CMD_ID, XASU_KDF_GENERATE_SHA3_CMD_ID, XASU_MODULE_KDF_ID, XAsu_RegCallBackNGetUniqueId(), XASU_SHA2_TYPE, XASU_UNIQUE_ID_MAX, XAsu_UpdateQueueBufferNSendIpi(), and XAsu_ValidateClientParameters().

s32 XAsu_KdfKat ( XAsu_ClientParams ClientParamsPtr)

This function sends command to ASUFW to perform KDF Known Answer Tests (KAT's).

Parameters
ClientParamsPtrPointer to the XAsu_ClientParams structure which holds the client input parameters.
Returns
  • XST_SUCCESS, if IPI request to ASU is sent successfully.
  • XASU_INVALID_ARGUMENT, if any argument is invalid.
  • XASU_INVALID_UNIQUE_ID, if received Queue ID is invalid.
  • XST_FAILURE, if sending IPI request to ASU fails.

Validate input parameters.

Update request buffer and send an IPI request to ASU.

References XAsu_CreateHeader(), XASU_INVALID_UNIQUE_ID, XASU_KDF_KAT_CMD_ID, XASU_MODULE_KDF_ID, XAsu_RegCallBackNGetUniqueId(), XASU_UNIQUE_ID_MAX, XAsu_UpdateQueueBufferNSendIpi(), and XAsu_ValidateClientParameters().