1 /*
2  * Copyright (c) 2017-2023, 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  */
32 /** ============================================================================
33  *  @file       CryptoResourceLPF3.h
34  *
35  *  @brief      Shared resources to arbitrate access to the AES engine
36  *
37  */
38 
39 #ifndef ti_drivers_cryptoutils_sharedresources_CryptoResourceLPF3__include
40 #define ti_drivers_cryptoutils_sharedresources_CryptoResourceLPF3__include
41 
42 #include <stdint.h>
43 #include <stdbool.h>
44 
45 #include <ti/drivers/dpl/SemaphoreP.h>
46 #include <ti/drivers/dpl/HwiP.h>
47 
48 #ifdef __cplusplus
49 extern "C" {
50 #endif
51 
52 /* Crypto driver semaphore used to synchronize accesses to the AES engine */
53 extern SemaphoreP_Struct CryptoResourceLPF3_accessSemaphore;
54 extern SemaphoreP_Struct CryptoResourceLPF3_operationSemaphore;
55 
56 extern volatile bool CryptoResourceLPF3_pollingFlag;
57 
58 extern HwiP_Struct CryptoResourceLPF3_hwi;
59 
60 void CryptoResourceLPF3_constructRTOSObjects(void);
61 void CryptoResourceLPF3_destructRTOSObjects(void);
62 bool CryptoResourceLPF3_acquireLock(uint32_t timeout);
63 void CryptoResourceLPF3_releaseLock(void);
64 
65 #ifdef __cplusplus
66 }
67 #endif
68 
69 #endif /* ti_drivers_cryptoutils_sharedresources_CryptoResourceLPF3__include */
70