95 lines
3.0 KiB
C
95 lines
3.0 KiB
C
/*
|
|
* 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
|
|
|
|
/**
|
|
@}
|
|
*/
|
|
|