AESCBCLPF3.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2021-2024, Texas Instruments Incorporated
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * * Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  *
12  * * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * * Neither the name of Texas Instruments Incorporated nor the names of
17  * its contributors may be used to endorse or promote products derived
18  * from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
22  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
24  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
27  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
28  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31  */
58 #ifndef ti_drivers_aescbc_AESCBCLPF3__include
59 #define ti_drivers_aescbc_AESCBCLPF3__include
60 
61 #include <stdbool.h>
62 #include <stdint.h>
63 
64 #include <ti/drivers/AESCBC.h>
67 #include <ti/devices/DeviceFamily.h>
68 
69 #if (DeviceFamily_PARENT == DeviceFamily_PARENT_CC27XX) || (DeviceFamily_PARENT == DeviceFamily_PARENT_CC35XX)
71 #endif
72 
73 #if (DeviceFamily_PARENT != DeviceFamily_PARENT_CC35XX)
74  #include DeviceFamily_constructPath(driverlib/aes.h)
75 #endif
76 
77 #ifdef __cplusplus
78 extern "C" {
79 #endif
80 
88 
94 typedef struct
95 {
96  /* Common member first to allow struct to be cast to the common type */
98  volatile uint32_t iv[AES_IV_LENGTH_BYTES / 4];
99  const uint8_t *input;
100  uint8_t *output;
105 #if (DeviceFamily_PARENT == DeviceFamily_PARENT_CC27XX) || (DeviceFamily_PARENT == DeviceFamily_PARENT_CC35XX)
106  size_t inputLength;
112  int_fast16_t hsmStatus;
113  uint32_t keyAssetID;
115  /* To indicate whether a segmented operation is in progress
116  */
118 #endif
120 
135 __STATIC_INLINE bool AESCBC_acquireLock(AESCBC_Handle handle, uint32_t timeout)
136 {
137  return CryptoResourceLPF3_acquireLock(timeout);
138 }
149 __STATIC_INLINE void AESCBC_releaseLock(AESCBC_Handle handle)
150 {
152 }
163 __STATIC_INLINE void AESCBC_enableThreadSafety(AESCBC_Handle handle)
164 {
165  AESCBCLPF3_Object *object = handle->object;
166  object->threadSafe = true;
167 }
181 __STATIC_INLINE void AESCBC_disableThreadSafety(AESCBC_Handle handle)
182 {
183  AESCBCLPF3_Object *object = handle->object;
184  object->threadSafe = false;
185 }
188 #ifdef __cplusplus
189 }
190 #endif
191 
192 #endif /* ti_drivers_aesmode_AESCBCLPF3__include */
AESCBC_OperationUnion * operation
Definition: AESCBCLPF3.h:102
AESCBC driver header.
AESCommonLPF3_HWAttrs AESCBCLPF3_HWAttrs
AESCBCLPF3 Hardware Attributes.
Definition: AESCBCLPF3.h:87
bool CryptoResourceLPF3_acquireLock(uint32_t timeout)
bool threadSafe
Definition: AESCBCLPF3.h:104
const uint8_t * input
Definition: AESCBCLPF3.h:99
CryptoKeyKeyStore_PSA driver header.
AES Global configuration.
Definition: AESCommon.h:154
#define AES_IV_LENGTH_BYTES
Definition: AESCommonLPF3.h:92
AESCBC_CallbackFxn callbackFxn
Definition: AESCBCLPF3.h:101
int_fast16_t hsmStatus
The staus of the HSM Boot up process if HSMLPF3_STATUS_SUCCESS, the HSM booted properly. if HSMLPF3_STATUS_ERROR, the HSM did not boot properly.
Definition: AESCBCLPF3.h:112
AESCBC_OperationType operationType
Definition: AESCBCLPF3.h:103
size_t inputLength
Definition: AESCBCLPF3.h:106
uint32_t keyAssetID
Definition: AESCBCLPF3.h:113
AESCommonLPF3 Hardware Attributes.
Definition: AESCommonLPF3.h:103
bool segmentedOperationInProgress
Definition: AESCBCLPF3.h:117
psa_key_location_t KeyStore_PSA_KeyLocation
Definition: CryptoKeyKeyStore_PSA.h:251
void CryptoResourceLPF3_releaseLock(void)
KeyStore_PSA_KeyLocation keyLocation
Definition: AESCBCLPF3.h:114
AESCommon driver implementation for the Low Power F3 family.
Shared resources to arbitrate access to the AES engine.
AESCBC_OperationType
Enum for the operation types supported by the driver.
Definition: AESCBC.h:884
void * object
Definition: AESCommon.h:157
Union containing a reference to a one step or segmented operation.
Definition: AESCBC.h:875
AESCommonLPF3_Object common
Definition: AESCBCLPF3.h:97
AESCBCLPF3 Object.
Definition: AESCBCLPF3.h:94
uint8_t * output
Definition: AESCBCLPF3.h:100
void(* AESCBC_CallbackFxn)(AESCBC_Handle handle, int_fast16_t returnValue, AESCBC_OperationUnion *operation, AESCBC_OperationType operationType)
The definition of a callback function used by the AESCBC driver when used in AESCBC_RETURN_BEHAVIOR_C...
Definition: AESCBC.h:912
AESCommonLPF3 Object.
Definition: AESCommonLPF3.h:125
© Copyright 1995-2025, Texas Instruments Incorporated. All rights reserved.
Trademarks | Privacy policy | Terms of use | Terms of sale