ECIES Common APIs

Functions
s32	XAsu_ValidateEciesParameters (const XAsu_EciesParams *EciesParams)
	This function validates the input parameters for ECIES. More...
s32	XAsu_EccValidateCurveInfo (u32 CurveType, u32 CurveLen)
	This function validates the given ECC curve type and curve length. More...

Function Documentation

s32 XAsu_EccValidateCurveInfo	(	u32	CurveType,
		u32	CurveLen
	)

This function validates the given ECC curve type and curve length.

Parameters

CurveType	Curve type provided.
CurveLen	Curve length provided.

Returns

• XST_SUCCESS, if curve type is valid.
• XST_FAILURE, if curve length is invalid.

References XASU_ECC_BRAINPOOL_P256, XASU_ECC_BRAINPOOL_P320, XASU_ECC_BRAINPOOL_P384, XASU_ECC_BRAINPOOL_P512, XASU_ECC_NIST_P192, XASU_ECC_NIST_P224, XASU_ECC_NIST_P256, XASU_ECC_NIST_P384, XASU_ECC_NIST_P521, XASU_ECC_P192_SIZE_IN_BYTES, XASU_ECC_P224_SIZE_IN_BYTES, XASU_ECC_P256_SIZE_IN_BYTES, XASU_ECC_P320_SIZE_IN_BYTES, XASU_ECC_P384_SIZE_IN_BYTES, XASU_ECC_P512_SIZE_IN_BYTES, and XASU_ECC_P521_SIZE_IN_BYTES.

Referenced by XAsu_EccGenPubKey(), XAsu_EcdhGenSharedSecret(), XAsu_EciesDecrypt(), and XAsu_ValidateEciesParameters().

s32 XAsu_ValidateEciesParameters

(

const XAsu_EciesParams *

EciesParams

)

This function validates the input parameters for ECIES.

Parameters

EciesParams

Pointer to XAsu_EciesParams structure that holds the input parameters for ECIES.

Returns

• XST_SUCCESS, if ECIES input parameters validation is successful.
• XST_FAILURE, if ECIES input parameters validation fails.

Validate SHA Type and SHA Mode.

Validate AES key size.

Validate IV and MAC length paramters.

Validate context and data lengths.

Validate ECC curve type.

Validate that the addresses of all input and output buffers are non-zero.

References XAsu_EciesParams::AesKeySize, XAsu_EciesParams::ContextAddr, XAsu_EciesParams::ContextLen, XAsu_EciesParams::DataLength, XAsu_EciesParams::EccCurveType, XAsu_EciesParams::EccKeyLength, XAsu_EciesParams::InDataAddr, XAsu_EciesParams::IvAddr, XAsu_EciesParams::IvLength, XAsu_EciesParams::MacAddr, XAsu_EciesParams::MacLength, XAsu_EciesParams::OutDataAddr, XAsu_EciesParams::RxKeyAddr, XAsu_EciesParams::ShaMode, XAsu_EciesParams::ShaType, XAsu_EciesParams::TxKeyAddr, XASU_AES_IV_SIZE_96BIT_IN_BYTES, XASU_AES_KEY_SIZE_128_BITS, XASU_AES_KEY_SIZE_256_BITS, XASU_AES_MAX_TAG_LENGTH_IN_BYTES, XAsu_EccValidateCurveInfo(), XASU_KDF_MAX_CONTEXT_LEN, XASU_SHA2_TYPE, XASU_SHA3_TYPE, XASU_SHA_MODE_SHA256, XASU_SHA_MODE_SHA384, XASU_SHA_MODE_SHA512, and XASU_SHA_MODE_SHAKE256.

Referenced by XAsu_EciesDecrypt(), and XAsu_EciesEncrypt().