include/drivers/arm/cryptocell/713/bsv_crypto_defs.h

/*
 * Copyright (c) 2017-2020 ARM Limited and Contributors. All rights reserved.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */

#ifndef _BSV_CRYPTO_DEFS_H
#define _BSV_CRYPTO_DEFS_H

#ifdef __cplusplus
extern "C"
{
#endif

/*!
@file
@brief This file contains the definitions of the cryptographic ROM APIs.

@defgroup cc_bsv_crypto_defs CryptoCell Boot Services cryptographic ROM API definitions
@{
@ingroup cc_bsv
*/

/*! AES supported HW key code table. */
typedef enum {

    CC_BSV_USER_KEY = 0,        /*!< Definition for a user key. */
    CC_BSV_HUK_KEY = 1,         /*!< Definition for the HW unique key. */
    CC_BSV_RTL_KEY = 2,         /*!< Definition for the RTL key. */
    CC_BSV_SESSION_KEY = 3,     /*!< Definition for the Session key. */
    CC_BSV_CE_KEY = 4,          /*!< Definition for the Kce. */
    CC_BSV_PLT_KEY = 5,         /*!< Definition for the Platform key. */
    CC_BSV_KCST_KEY = 6,        /*!< Definition for Kcst. */
    CC_BSV_ICV_PROV_KEY = 0xd,  /*!< Definition for the Kpicv. */
    CC_BSV_ICV_CE_KEY = 0xe,    /*!< Definition for the Kceicv. */
    CC_BSV_PROV_KEY = 0xf,      /*!< Definition for the Kcp. */
    CC_BSV_END_OF_KEY_TYPE = INT32_MAX, /*!< Reserved. */
}CCBsvKeyType_t;

/*! AES directions. */
typedef enum bsvAesDirection {
    BSV_AES_DIRECTION_ENCRYPT = 0, /*!< Encrypt.*/
    BSV_AES_DIRECTION_DECRYPT = 1, /*!< Decrypt.*/
    BSV_AES_NUM_OF_ENCRYPT_MODES,  /*!< The maximal number of operations. */
    BSV_AES_DIRECTION_RESERVE32B = INT32_MAX /*!< Reserved.*/
}bsvAesDirection_t;

/*! Definitions of the cryptographic flow supported as part of the Secure Boot. */
typedef enum {
    CC_BSV_CRYPTO_HASH_MODE     = 0,            /*!< Hash mode only. */
    CC_BSV_CRYPTO_AES_CTR_AND_HASH_MODE  = 1,   /*!< Data goes into the AES and Hash engines. */
    CC_BSV_CRYPTO_AES_CTR_TO_HASH_MODE = 2      /*!< Data goes into the AES and from the AES to the Hash engine. */
}CCBsvflowMode_t;

/*! CryptoImage HW completion sequence mode */
typedef enum
{
    BSV_CRYPTO_COMPLETION_NO_WAIT = 0, /*!< The driver waits only before reading the output. */
    BSV_CRYPTO_COMPLETION_WAIT_UPON_END = 1 /*!< The driver waits after each chunk of data. */
}bsvCryptoCompletionMode_t;


/*! AES-CMAC result size, in words. */
#define CC_BSV_CMAC_RESULT_SIZE_IN_WORDS    4  /* 128b */
/*! AES-CMAC result size, in bytes. */
#define CC_BSV_CMAC_RESULT_SIZE_IN_BYTES    16 /* 128b */
/*! AES-CCM 128bit key size, in bytes. */
#define CC_BSV_CCM_KEY_SIZE_BYTES               16
/*! AES-CCM 128bit key size, in words. */
#define CC_BSV_CCM_KEY_SIZE_WORDS               4
/*! AES-CCM NONCE size, in bytes. */
#define CC_BSV_CCM_NONCE_SIZE_BYTES     12


/*! AES-CMAC result buffer. */
typedef uint32_t CCBsvCmacResult_t[CC_BSV_CMAC_RESULT_SIZE_IN_WORDS];
/*! AES-CCM key buffer.*/
typedef uint32_t CCBsvCcmKey_t[CC_BSV_CCM_KEY_SIZE_WORDS];
/*! AES-CCM nonce buffer.*/
typedef uint8_t CCBsvCcmNonce_t[CC_BSV_CCM_NONCE_SIZE_BYTES];
/*! AES-CCM MAC buffer.*/
typedef uint8_t CCBsvCcmMacRes_t[CC_BSV_CMAC_RESULT_SIZE_IN_BYTES];


#ifdef __cplusplus
}
#endif

#endif

/**
@}
 */