Detailed Description

AESCMAC (CMAC & CBC-MAC) driver implementation for the Low Power F3 family.

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

Hardware Accelerator

The Low Power F3 and WiFi F3 families of devices have 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. CC35XX devices have only dedicated hardware accelerator. 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.

The following limitations apply to the AESCCMXXF3 Driver for CC27xx device family only:

The CryptoKey input must have the correct encoding, CryptoKey.h.
The application can only use one handle per driver. Concurrent dynamic instances will be supported in the future.
CCM driver only supports polling return behaviour. Blocking and callback return behaviours will be supported in the future.

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/AESCMAC.h>
#include <ti/drivers/cryptoutils/aes/AESCommonXXF3.h>
#include <ti/drivers/cryptoutils/sharedresources/CryptoResourceXXF3.h>
#include <ti/devices/DeviceFamily.h>

Include dependency graph for AESCMACXXF3.h:

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

Go to the source code of this file.

Data Structures
struct	AESCMACXXF3_Object
	AESCMACXXF3 Object. More...

Macros
#define	AESCMACXXF3_DEFAULT_AUTOCFG ((uint32_t)AES_AUTOCFG_AESSRC_TXTXBUF \| (uint32_t)AES_AUTOCFG_TRGAES_WRBUF3 \| (uint32_t)AES_AUTOCFG_BUSHALT_EN)

#define	AESCMACXXF3_DMA_CONFIG ((uint32_t)AES_DMA_ADRCHA_BUF0 \| (uint32_t)AES_DMA_TRGCHA_AESSTART)

#define	AESCBCMACLPF3_DMA_CONFIG AESCMACXXF3_DMA_CONFIG

Typedefs
typedef AESCommonXXF3_HWAttrs	AESCMACXXF3_HWAttrs
	AESCMACXXF3 Hardware Attributes. More...

Macro Definition Documentation

§ AESCMACXXF3_DEFAULT_AUTOCFG

#define AESCMACXXF3_DEFAULT_AUTOCFG ((uint32_t)AES_AUTOCFG_AESSRC_TXTXBUF | (uint32_t)AES_AUTOCFG_TRGAES_WRBUF3 | (uint32_t)AES_AUTOCFG_BUSHALT_EN)

§ AESCMACXXF3_DMA_CONFIG

#define AESCMACXXF3_DMA_CONFIG ((uint32_t)AES_DMA_ADRCHA_BUF0 | (uint32_t)AES_DMA_TRGCHA_AESSTART)

§ AESCBCMACLPF3_DMA_CONFIG

#define AESCBCMACLPF3_DMA_CONFIG AESCMACXXF3_DMA_CONFIG

Typedef Documentation

§ AESCMACXXF3_HWAttrs

typedef AESCommonXXF3_HWAttrs AESCMACXXF3_HWAttrs

AESCMACXXF3 Hardware Attributes.

AESCMACXXF3 hardware attributes should be included in the board file and pointed to by the AESCMAC_config struct.