TI BLE-Stack for Bluetooth 4.2 API Documentation  3.01.00.07
ECCROMCC26XX.h
Go to the documentation of this file.
1 /******************************************************************************
2 
3  @file ECCROMCC26XX.h
4 
5  @brief This file contains the interface to the ECC in ROM Driver.
6 
7  Group: WCS, BTS
8  $Target Device: DEVICES $
9 
10  ******************************************************************************
11  $License: BSD3 2016 $
12  ******************************************************************************
13  $Release Name: PACKAGE NAME $
14  $Release Date: PACKAGE RELEASE DATE $
15  *****************************************************************************/
16 
210 #ifndef ti_drivers_ECCROMCC26XX__include
211 #define ti_drivers_ECCROMCC26XX__include
212 
213 #ifdef __cplusplus
214 extern "C" {
215 #endif
216 
217 #include <stdint.h>
218 
224 /* Add ECCROMCC26XX_STATUS_* macros here */
225 #define ECCROMCC26XX_STATUS_SUCCESS 0
226 #define ECCROMCC26XX_STATUS_MALLOC_FAIL -1
227 #define ECCROMCC26XX_STATUS_ILLEGAL_PARAM -2
228 #define ECCROMCC26XX_STATUS_TIMEOUT -3
230 /* ECC status error codes from module */
231 #define ECCROMCC26XX_STATUS_MODULUS_EVEN 0xDC
232 #define ECCROMCC26XX_STATUS_MODULUS_LARGER_THAN_255_WORDS 0xD2
233 #define ECCROMCC26XX_STATUS_MODULUS_LENGTH_ZERO 0x08
234 #define ECCROMCC26XX_STATUS_MODULUS_MSW_IS_ZERO 0x30
235 #define ECCROMCC26XX_STATUS_SCALAR_TOO_LONG 0x35
236 #define ECCROMCC26XX_STATUS_SCALAR_LENGTH_ZERO 0x53
237 #define ECCROMCC26XX_STATUS_ORDER_TOO_LONG 0xC6
238 #define ECCROMCC26XX_STATUS_ORDER_LENGTH_ZERO 0x6C
239 #define ECCROMCC26XX_STATUS_X_COORD_TOO_LONG 0x3C
240 #define ECCROMCC26XX_STATUS_X_COORD_LENGTH_ZERO 0xC3
241 #define ECCROMCC26XX_STATUS_Y_COORD_TOO_LONG 0x65
242 #define ECCROMCC26XX_STATUS_Y_COORD_LENGTH_ZERO 0x56
243 #define ECCROMCC26XX_STATUS_A_COEF_TOO_LONG 0x5C
244 #define ECCROMCC26XX_STATUS_A_COEF_LENGTH_ZERO 0xC5
245 #define ECCROMCC26XX_STATUS_BAD_WINDOW_SIZE 0x66
246 #define ECCROMCC26XX_STATUS_SCALAR_MUL_OK 0x99
248 #define ECCROMCC26XX_STATUS_ORDER_LARGER_THAN_255_WORDS 0x28
249 #define ECCROMCC26XX_STATUS_ORDER_EVEN 0x82
250 #define ECCROMCC26XX_STATUS_ORDER_MSW_IS_ZERO 0x23
251 #define ECCROMCC26XX_STATUS_ECCROMCC26XX_STATUS_KEY_TOO_LONG 0x25
252 #define ECCROMCC26XX_STATUS_ECCROMCC26XX_STATUS_KEY_LENGTH_ZERO 0x52
253 #define ECCROMCC26XX_STATUS_DIGEST_TOO_LONG 0x27
254 #define ECCROMCC26XX_STATUS_DIGEST_LENGTH_ZERO 0x72
255 #define ECCROMCC26XX_STATUS_ECDSA_SIGN_OK 0x32
256 #define ECCROMCC26XX_STATUS_ECDSA_INVALID_SIGNATURE 0x5A
257 #define ECCROMCC26XX_STATUS_ECDSA_VALID_SIGNATURE 0xA5
258 #define ECCROMCC26XX_STATUS_SIG_P1_TOO_LONG 0x11
259 #define ECCROMCC26XX_STATUS_SIG_P1_LENGTH_ZERO 0x12
260 #define ECCROMCC26XX_STATUS_SIG_P2_TOO_LONG 0x22
261 #define ECCROMCC26XX_STATUS_SIG_P2_LENGTH_ZERO 0x21
263 #define ECCROMCC26XX_STATUS_ECDH_KEYGEN_OK ECCROMCC26XX_STATUS_SCALAR_MUL_OK
264 #define ECCROMCC26XX_STATUS_ECDH_COMMON_KEY_OK ECCROMCC26XX_STATUS_SCALAR_MUL_OK
272 #define ECCROMCC26XX_NIST_P256_WORKZONE_LEN_IN_BYTES 684
273 
279 #define ECCROMCC26XX_NIST_P256_WORKZONE_SIGN_VERIFY_LEN_IN_BYTES 1100
280 
284 #define ECCROMCC26XX_NIST_P256_KEY_LEN_IN_BYTES 32
285 
295 #define ECCROMCC26XX_WORKZONE_LEN_IN_BYTES(len, win) (4 * ((13 * (len)) + 13 + (3 * (len) * (1 << ((win) - 2)))))
296 
304 {
305  uint8_t keyLen;
306  uint16_t workzoneLen;
307  uint8_t windowSize;
308  uint32_t *param_p;
309  uint32_t *param_r;
310  uint32_t *param_a;
311  uint32_t *param_b;
312  uint32_t *param_gx;
313  uint32_t *param_gy;
315 
325 typedef uint8_t *(*ECCROMCC26XX_MallocCB)(uint16_t len);
326 
336 typedef void (*ECCROMCC26XX_FreeCB)(uint8_t *pBuf);
337 
343 typedef struct ECCROMCC26XX_Params {
347  uint32_t timeout;
348  int8_t status;
350 
359 void ECCROMCC26XX_init(void);
360 
375 
406 int8_t ECCROMCC26XX_genKeys(uint8_t *privateKey, uint8_t *publicKeyX,
407  uint8_t *publicKeyY, ECCROMCC26XX_Params *params);
408 
451 int8_t ECCROMCC26XX_genDHKey(uint8_t *privateKey, uint8_t *publicKeyX,
452  uint8_t *publicKeyY, uint8_t *dHKeyX,
453  uint8_t *dHKeyY, ECCROMCC26XX_Params *params);
454 
484 int8_t ECCROMCC26XX_signHash(uint8_t *privateKey, const uint8_t *hash,
485  uint32_t hashLen, uint8_t *sign1,
486  uint8_t *sign2, ECCROMCC26XX_Params *params);
487 
529 int8_t ECCROMCC26XX_verifyHash(uint8_t *publicKeyX, uint8_t *publicKeyY,
530  uint8_t *sign1, uint8_t *sign2, uint8_t* hash, uint32_t hashLen,
531  ECCROMCC26XX_Params *params);
532 
533 #ifdef __cplusplus
534 }
535 #endif
536 
537 #endif /* ti_drivers_ECCROMCC26XX__include */
538 
ECCROMCC26XX Parameters.
Definition: ECCROMCC26XX.h:343
int8_t ECCROMCC26XX_verifyHash(uint8_t *publicKeyX, uint8_t *publicKeyY, uint8_t *sign1, uint8_t *sign2, uint8_t *hash, uint32_t hashLen, ECCROMCC26XX_Params *params)
Verify the signature of a previously hashed message.
struct ECCROMCC26XX_CurveParams ECCROMCC26XX_CurveParams
ECCROMCC26XX Curve Parameters.
uint32_t * param_gy
Definition: ECCROMCC26XX.h:313
int8_t status
Definition: ECCROMCC26XX.h:348
uint8_t windowSize
Definition: ECCROMCC26XX.h:307
void ECCROMCC26XX_Params_init(ECCROMCC26XX_Params *params)
Function to initialize the ECCROMCC26XX_Params struct to its defaults. params should not be modified ...
int8_t ECCROMCC26XX_signHash(uint8_t *privateKey, const uint8_t *hash, uint32_t hashLen, uint8_t *sign1, uint8_t *sign2, ECCROMCC26XX_Params *params)
Compute the signature of a previously hashed message.
ECCROMCC26XX_MallocCB malloc
Definition: ECCROMCC26XX.h:345
uint32_t * param_r
Definition: ECCROMCC26XX.h:309
struct ECCROMCC26XX_Params ECCROMCC26XX_Params
ECCROMCC26XX Parameters.
uint32_t * param_a
Definition: ECCROMCC26XX.h:310
int8_t ECCROMCC26XX_genKeys(uint8_t *privateKey, uint8_t *publicKeyX, uint8_t *publicKeyY, ECCROMCC26XX_Params *params)
Generate Public Key X and Y Coordinates.
uint32_t * param_gx
Definition: ECCROMCC26XX.h:312
uint16_t workzoneLen
Definition: ECCROMCC26XX.h:306
ECCROMCC26XX_CurveParams curve
Definition: ECCROMCC26XX.h:344
void ECCROMCC26XX_init(void)
Initializes module&#39;s synchronization resources. Only needs to be called once, but safe to call multip...
uint32_t timeout
Definition: ECCROMCC26XX.h:347
void(* ECCROMCC26XX_FreeCB)(uint8_t *pBuf)
ECCROMCC26XX Free Callback.
Definition: ECCROMCC26XX.h:336
ECCROMCC26XX_FreeCB free
Definition: ECCROMCC26XX.h:346
ECCROMCC26XX Curve Parameters.
Definition: ECCROMCC26XX.h:303
uint32_t * param_b
Definition: ECCROMCC26XX.h:311
uint32_t * param_p
Definition: ECCROMCC26XX.h:308
uint8_t keyLen
Definition: ECCROMCC26XX.h:305
int8_t ECCROMCC26XX_genDHKey(uint8_t *privateKey, uint8_t *publicKeyX, uint8_t *publicKeyY, uint8_t *dHKeyX, uint8_t *dHKeyY, ECCROMCC26XX_Params *params)
Generate Diffie-Hellman Shared Secret Key X and Y Coordinates.
uint8_t *(* ECCROMCC26XX_MallocCB)(uint16_t len)
ECCROMCC26XX Malloc Callback.
Definition: ECCROMCC26XX.h:325
Copyright 2017, Texas Instruments Incorporated