123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359 |
- /*
- * Copyright (C) 2017-2020 Alibaba Group Holding Limited
- */
- /******************************************************************************
- * @file drv/aes.h
- * @brief Header File for AES Driver
- * @version V1.0
- * @date 9. Oct 2020
- * @model aes
- ******************************************************************************/
- #ifndef _DRV_AES_H_
- #define _DRV_AES_H_
- #include <stdint.h>
- #include "common.h"
- #ifdef __cplusplus
- extern "C" {
- #endif
- /*----- Encrypt & Decrypt: Config key length -----*/
- #define AES_KEY_LEN_BYTES_32 (32)
- #define AES_KEY_LEN_BYTES_24 (24)
- #define AES_KEY_LEN_BYTES_16 (16)
- #define AES_BLOCK_IV_SIZE (16)
- #define AES_BLOCK_TAG_SIZE (16)
- #define AES_BLOCK_CRYPTO_SIZE (16)
- #define AES_DIR_ENCRYPT (1)
- #define AES_DIR_DECRYPT (0)
- #define KEY_128_BITS (0x08)
- #define KEY_192_BITS (0x10)
- #define KEY_256_BITS (0x18)
- #define AES_DMA_ENABLE (1)
- #define AES_DMA_DISABLE (0)
- /**
- \brief DES data transfer mode config
- */
- typedef enum {
- AES_SLAVE_MODE = 0U, ///< slave mode
- AES_DMA_MODE, ///< dma mode
- } csi_aes_trans_mode_t;
- /**
- \brief AES Keylen type
- */
- typedef enum {
- AES_KEY_LEN_BITS_128 = 0, ///< 128 Data bits
- AES_KEY_LEN_BITS_192, ///< 192 Data bits
- AES_KEY_LEN_BITS_256 ///< 256 Data bits
- } csi_aes_key_bits_t;
- /**
- \brief AES mode config
- */
- typedef enum{
- AES_MODE_ECB = 0,
- AES_MODE_CBC = 0x20000020,
- AES_MODE_CTR = 0x200001c0,
- AES_MODE_CFB = 0x20000400,
- AES_MODE_GCM = 0x20030040,
- AES_MODE_CCM = 0x21D40040,
- AES_MODE_OFB = 0x24000000,
- } csi_aes_mode_t;
- /**
- \brief AES state
- */
- typedef struct {
- uint32_t busy : 1; ///< Calculate busy flag
- uint32_t error : 1; ///< Calculate error flag
- } csi_aes_state_t;
- /**
- \brief AES Context
- */
- typedef struct {
- uint32_t key_len_byte;
- uint8_t key[32]; ///< Data block being processed
- uint32_t sca;
- uint32_t is_kdf;
- uint32_t is_dma;
- } csi_aes_context_t;
- /**
- \brief AES Ctrl Block
- */
- typedef struct {
- csi_aes_state_t state;
- csi_aes_context_t context;
- csi_dev_t dev;
- void *priv;
- } csi_aes_t;
- /**
- \brief Initialize AES interface. Initializes the resources needed for the AES interface
- \param[in] aes Handle to operate
- \param[in] idx Device id
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_init(csi_aes_t *aes, uint32_t idx);
- /**
- \brief De-initialize AES interface. Stops operation and releases the software resources used by the interface
- \param[in] aes Dandle to operate
- \return None
- */
- void csi_aes_uninit(csi_aes_t *aes);
- /**
- \brief Set encrypt key
- \param[in] aes Handle to operate
- \param[in] key Pointer to the key buf
- \param[in] key_len Pointer to \ref csi_aes_key_bits_t
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_set_encrypt_key(csi_aes_t *aes, void *key, csi_aes_key_bits_t key_len);
- /**
- \brief Set decrypt key
- \param[in] aes Handle to operate
- \param[in] key Pointer to the key buf
- \param[in] key_len Pointer to \ref csi_aes_key_bits_t
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_set_decrypt_key(csi_aes_t *aes, void *key, csi_aes_key_bits_t key_len);
- /**
- \brief AES ecb encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_ecb_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size);
- /**
- \brief AES ecb decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_ecb_decrypt(csi_aes_t *aes, void *in, void *out, uint32_t size);
- /**
- \brief AES cbc encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cbc_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv) ;
- /**
- \brief AES cbc decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cbc_decrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb1 encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cfb1_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb1 decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cfb1_decrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb8 encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cfb8_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb8 decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref Csi_error_t
- */
- csi_error_t csi_aes_cfb8_decrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb128 decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_cfb128_decrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES cfb128 encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_cfb128_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief AES ofb encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \param[in] key_len key bits
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_ofb_encrypt(csi_aes_t *aes, void *in, void *out, uint32_t size, void *iv);
- /**
- \brief Aes ofb decrypt
- \param[in] dev_aes dev_aes handle to operate
- \param[in] in Pointer to the Source data
- \param[out] out Pointer to the Result data
- \param[in] size the Source data size
- \param[in] iv init vector
- \param[in] key_len key bits
- \return error code \ref csi_error_t
- */
- csi_error_t csi_aes_ofb_decrypt(csi_aes_t *aes, void *in, void *out,uint32_t size, void *iv);
- /**
- \brief AES ctr encrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vector
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_ctr_encrypt(csi_aes_t *aes,void *in,void *out,uint32_t size,void *iv);
- /**
- \brief AES ctr decrypt
- \param[in] aes Handle to operate
- \param[in] in Pointer to the source data
- \param[out] out Pointer to the result data
- \param[in] size The source data size
- \param[in] iv Init vecotr
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_ctr_decrypt(csi_aes_t *aes,void *in,void *out,uint32_t size,void *iv);
- /**
- \brief Aes gcm encrypt
- \param[in] dev_aes dev_aes handle to operate
- \param[in] in Pointer to the Source data
- \param[out] out Pointer to the Result data
- \param[in] size the Source data size
- \param[in] iv init vector
- \return error code \ref csi_error_t
- */
- csi_error_t csi_aes_gcm_encrypt(csi_aes_t *aes, void *in, void *out,uint32_t size, uint32_t add_len, void *iv);
- /**
- \brief Aes gcm decrypt
- \param[in] dev_aes dev_aes handle to operate
- \param[in] in Pointer to the Source data.
- \param[out] out Pointer to the Result data
- \param[in] size the Source data size
- \param[in] iv init vecotr
- \return error code \ref csi_error_t
- */
- csi_error_t csi_aes_gcm_decrypt(csi_aes_t *aes, void *in, void *out,uint32_t size, uint32_t add_len, void *iv);
- /**
- \brief Aes ccm encrypt
- \param[in] dev_aes dev_aes handle to operate
- \param[in] in Pointer to the Source data
- \param[out] out Pointer to the Result data
- \param[in] size the Source data size
- \param[in] iv init vector
- \param[in] tag_out tag output
- \return error code \ref csi_error_t
- */
- csi_error_t csi_aes_ccm_encrypt(csi_aes_t *aes, void *in, void *out,uint32_t size, uint32_t add_len, void *iv, uint8_t *tag_out);
- /**
- \brief Aes ccm decrypt
- \param[in] dev_aes dev_aes handle to operate
- \param[in] in Pointer to the Source data
- \param[out] out Pointer to the Result data
- \param[in] size the Source data size
- \param[in] iv init vecotr
- \param[in] tag_out tag output
- \return error code \ref csi_error_t
- */
- csi_error_t csi_aes_ccm_decrypt(csi_aes_t *aes, void *in, void *out,uint32_t size, uint32_t add_len, void *iv, uint8_t *tag_out);
- /**
- \brief Enable AES power manage
- \param[in] aes Handle to operate
- \return Error code \ref csi_error_t
- */
- csi_error_t csi_aes_enable_pm(csi_aes_t *aes);
- /**
- \brief Disable AES power manage
- \param[in] aes Handle to operate
- \return None
- */
- void csi_aes_disable_pm(csi_aes_t *aes);
- /**
- \brief Config AES data transfer mode
- \param[in] mode \ref csi_des_trans_mode_t
- \return None
- */
- void csi_aes_trans_config(csi_aes_t *aes, csi_aes_trans_mode_t mode);
- #ifdef __cplusplus
- }
- #endif
- #endif /* _DRV_AES_H_ */
|