ECDHCC26X1.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020-2021, 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  */
53 #ifndef ti_drivers_ecdh_ECDHCC26X1__include
54 #define ti_drivers_ecdh_ECDHCC26X1__include
55 
56 #include <stdint.h>
57 #include <stdbool.h>
58 
59 #include <ti/drivers/ECDH.h>
60 
61 #include <ti/devices/DeviceFamily.h>
62 #include DeviceFamily_constructPath(driverlib/rom_ecc.h)
63 
64 #ifdef __cplusplus
65 extern "C" {
66 #endif
67 
74 typedef struct {
75  uint8_t dummy;
77 
78 /*
79  * Performance of the ECC SW library is scaled via the window size parameter
80  * which defines the number of bits of the scalar that will be processed together
81  * during the execution of the scalar multiplication. A larger window size
82  * will have higher performance at the cost of increased memory consumption.
83  * A window size of 3 was selected for the best trade-off of performance and
84  * memory consumption.
85  *
86  * ---------------------------------------------------
87  * | | NIST P256 | X25519 |
88  * | Window Size | WorkZone Size | WorkZone Size |
89  * | | (words) | (words) |
90  * |-------------|-----------------|-----------------|
91  * | 2 or 3 | 171 | 198 |
92  * | 4 | 225 | 225 |
93  * | 5 | 333 | 333 |
94  * ---------------------------------------------------
95  */
96 #define ECDH26X1_ECC_WINDOW_SIZE 3
97 
98 /*
99  * ECC Workzone size is based on worst case empirical measurement of ECDH
100  * operations on supported curves with the selected window size.
101  * NIST P256 (win_size=3): 171 words
102  * Curve25519 (win_size=3): 198 words
103  */
104 #define ECDH26X1_ECC_WORKZONE_WORDS 198
105 
111 typedef struct {
112  bool isOpen;
114  ECDH_ReturnBehavior returnBehavior; /* Note: Callback return behavior is not supported */
115  ECC_State eccState;
116  uint32_t eccWorkZone[ECDH26X1_ECC_WORKZONE_WORDS];
118 
119 #ifdef __cplusplus
120 }
121 #endif
122 
123 #endif /* ti_drivers_ecdh_ECDHCC26X1__include */
ECDHCC26X1 Hardware Attributes.
Definition: ECDHCC26X1.h:74
bool isOpen
Definition: ECDHCC26X1.h:112
uint8_t dummy
Definition: ECDHCC26X1.h:75
ECDH_CallbackFxn callbackFxn
Definition: ECDHCC26X1.h:113
ECDHCC26X1 Object.
Definition: ECDHCC26X1.h:111
ECDH_ReturnBehavior returnBehavior
Definition: ECDHCC26X1.h:114
void(* ECDH_CallbackFxn)(ECDH_Handle handle, int_fast16_t returnStatus, ECDH_Operation operation, ECDH_OperationType operationType)
The definition of a callback function used by the ECDH driver when used in ECDH_RETURN_BEHAVIOR_CALLB...
Definition: ECDH.h:655
ECC_State eccState
Definition: ECDHCC26X1.h:115
TI Driver for Elliptic Curve Diffie-Hellman key agreement scheme.
ECDH_ReturnBehavior
The way in which ECDH function calls return after performing a public key generation or shared secret...
Definition: ECDH.h:554
#define ECDH26X1_ECC_WORKZONE_WORDS
Definition: ECDHCC26X1.h:104
© Copyright 1995-2022, Texas Instruments Incorporated. All rights reserved.
Trademarks | Privacy policy | Terms of use | Terms of sale