aes.h

Go to the documentation of this file.

 
/******************************************************************************
 *
 * Copyright (C) 2022-2023 Maxim Integrated Products, Inc. (now owned by 
 * Analog Devices, Inc.),
 * Copyright (C) 2023-2024 Analog Devices, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 ******************************************************************************/
 
#ifndef LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32672_AES_H_
#define LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32672_AES_H_
 
/***** Includes *****/
#include "aes_regs.h"
#include "sys_aeskeys_regs.h"
#include "usr_aeskeys_regs.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/***** Definitions *****/
 
typedef void (*mxc_aes_complete_t)(void *req, int result);
 
/* ************************************************************************* */
/* Cipher Definitions                                                                          */
/* ************************************************************************* */
 
typedef enum {
    MXC_AES_128BITS = MXC_S_AES_CTRL_KEY_SIZE_AES128, 
    MXC_AES_192BITS = MXC_S_AES_CTRL_KEY_SIZE_AES192, 
    MXC_AES_256BITS = MXC_S_AES_CTRL_KEY_SIZE_AES256, 
} mxc_aes_keys_t;
 
typedef enum {
    MXC_AES_ENCRYPT_EXT_KEY = 0, 
    MXC_AES_DECRYPT_EXT_KEY = 1, 
    MXC_AES_DECRYPT_INT_KEY = 2 
} mxc_aes_enc_type_t;
 
struct _mxc_aes_cipher_req_t {
    uint32_t length; 
    uint32_t *inputData; 
    uint32_t *resultData; 
    mxc_aes_keys_t keySize; 
    mxc_aes_enc_type_t encryption; 
    mxc_aes_complete_t callback; 
} typedef mxc_aes_req_t;
 
/***** Function Prototypes *****/
 
/* ************************************************************************* */
/* Global Control/Configuration functions                                    */
/* ************************************************************************* */
 
int MXC_AES_Init(void);
 
void MXC_AES_EnableInt(uint32_t interrupt);
 
void MXC_AES_DisableInt(uint32_t interrupt);
 
int MXC_AES_IsBusy(void);
 
int MXC_AES_Shutdown(void);
 
void MXC_AES_DMACallback(int ch, int error);
 
void MXC_AES_SetKeySize(mxc_aes_keys_t key);
 
mxc_aes_keys_t MXC_AES_GetKeySize(void);
 
void MXC_AES_SetExtKey(const void *key, mxc_aes_keys_t len);
 
void MXC_AES_FlushInputFIFO(void);
 
void MXC_AES_FlushOutputFIFO(void);
 
void MXC_AES_Start(void);
 
uint32_t MXC_AES_GetFlags(void);
 
void MXC_AES_ClearFlags(uint32_t flags);
 
int MXC_AES_Generic(mxc_aes_req_t *req);
 
int MXC_AES_Encrypt(mxc_aes_req_t *req);
 
int MXC_AES_Decrypt(mxc_aes_req_t *req);
 
int MXC_AES_TXDMAConfig(void *src_addr, int len);
 
int MXC_AES_RXDMAConfig(void *dest_addr, int len);
 
int MXC_AES_GenericAsync(mxc_aes_req_t *req, uint8_t enc);
 
int MXC_AES_EncryptAsync(mxc_aes_req_t *req);
 
int MXC_AES_DecryptAsync(mxc_aes_req_t *req);
 
#ifdef __cplusplus
}
#endif
#endif // LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32672_AES_H_