Detailed Description

AESCTR driver implementation for the Low Power F3 family.

==========================================================================

Hardware Accelerator

The Low Power F3 family of devices has dedicated hardware accelerators. CC23XX devices have one dedicated accelerator whereas CC27XX devices have two (Primary and Secondary). Combined they can perform AES encryption operations with 128-bit, 192-bit and 256-bit keys. Only one operation can be carried out on the accelerator at a time. Mutual exclusion is implemented at the driver level and coordinated between all drivers relying on the accelerator. It is transparent to the application and only noted to ensure sensible access timeouts are set.

Implementation Limitations

Only plaintext CryptoKeys are supported by this implementation.

Runtime Parameter Validation

The driver implementation does not perform runtime checks for most input parameters. Only values that are likely to have a stochastic element to them are checked (such as whether a driver is already open). Higher input parameter validation coverage is achieved by turning on assertions when compiling the driver.

#include <stdbool.h>
#include <stdint.h>
#include <ti/drivers/AESCTR.h>
#include <ti/drivers/cryptoutils/aes/AESCommonLPF3.h>
#include <ti/drivers/cryptoutils/sharedresources/CryptoResourceLPF3.h>
#include <ti/devices/DeviceFamily.h>
#include <DeviceFamily_constructPath(driverlib/aes.h)>

Include dependency graph for AESCTRLPF3.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	AESCTRLPF3_Object
	AESCTRLPF3 Object. More...

Macros
#define	AES_AUTOCFG_CTRENDN_BIGENDIAN AES_AUTOCFG_CTRENDIAN_BIGENDIAN

#define	AESCTRLPF3_DEFAULT_AUTOCFG

#define	AESCTRLPF3_LAST_BLOCK_AUTOCFG

Typedefs
typedef AESCommonLPF3_HWAttrs	AESCTRLPF3_HWAttrs
	AESCTRLPF3 Hardware Attributes. More...

Macro Definition Documentation

§ AES_AUTOCFG_CTRENDN_BIGENDIAN

#define AES_AUTOCFG_CTRENDN_BIGENDIAN AES_AUTOCFG_CTRENDIAN_BIGENDIAN

§ AESCTRLPF3_DEFAULT_AUTOCFG

#define AESCTRLPF3_DEFAULT_AUTOCFG

Value:

((uint32_t)AES_AUTOCFG_AESSRC_BUF | (uint32_t)AES_AUTOCFG_TRGAES_WRBUF3S |    \
         (uint32_t)AES_AUTOCFG_TRGAES_RDTXT3 | (uint32_t)AES_AUTOCFG_CTRSIZE_CTR128 | \
         (uint32_t)AES_AUTOCFG_CTRENDN_BIGENDIAN | (uint32_t)AES_AUTOCFG_BUSHALT_EN)

§ AESCTRLPF3_LAST_BLOCK_AUTOCFG

#define AESCTRLPF3_LAST_BLOCK_AUTOCFG

Value:

((uint32_t)AES_AUTOCFG_AESSRC_BUF | (uint32_t)AES_AUTOCFG_TRGAES_WRBUF3S |        \
         (uint32_t)AES_AUTOCFG_CTRSIZE_CTR128 | (uint32_t)AES_AUTOCFG_CTRENDN_BIGENDIAN | \
         (uint32_t)AES_AUTOCFG_BUSHALT_EN)

Typedef Documentation

§ AESCTRLPF3_HWAttrs

typedef AESCommonLPF3_HWAttrs AESCTRLPF3_HWAttrs

AESCTRLPF3 Hardware Attributes.

AESCTRLPF3 hardware attributes should be included in the board file and pointed to by the AESCTR_config struct.