ECCROMCC26XX.h

Go to the documentation of this file.

/******************************************************************************

 @file  ECCROMCC26XX.h

 @brief This file contains the interface to the ECC in ROM Driver.

 Group: WCS, BTS
 $Target Device: DEVICES $

 ******************************************************************************
 $License: BSD3 2016 $
 ******************************************************************************
 $Release Name: PACKAGE NAME $
 $Release Date: PACKAGE RELEASE DATE $
 *****************************************************************************/

#ifndef ti_drivers_ECCROMCC26XX__include
#define ti_drivers_ECCROMCC26XX__include

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>

/* Add ECCROMCC26XX_STATUS_* macros here */
#define ECCROMCC26XX_STATUS_SUCCESS                              0  
#define ECCROMCC26XX_STATUS_MALLOC_FAIL                         -1  
#define ECCROMCC26XX_STATUS_ILLEGAL_PARAM                       -2  
#define ECCROMCC26XX_STATUS_TIMEOUT                             -3  
/* ECC status error codes from module */
#define ECCROMCC26XX_STATUS_MODULUS_EVEN                        0xDC  
#define ECCROMCC26XX_STATUS_MODULUS_LARGER_THAN_255_WORDS       0xD2  
#define ECCROMCC26XX_STATUS_MODULUS_LENGTH_ZERO                 0x08  
#define ECCROMCC26XX_STATUS_MODULUS_MSW_IS_ZERO                 0x30  
#define ECCROMCC26XX_STATUS_SCALAR_TOO_LONG                     0x35  
#define ECCROMCC26XX_STATUS_SCALAR_LENGTH_ZERO                  0x53  
#define ECCROMCC26XX_STATUS_ORDER_TOO_LONG                      0xC6  
#define ECCROMCC26XX_STATUS_ORDER_LENGTH_ZERO                   0x6C  
#define ECCROMCC26XX_STATUS_X_COORD_TOO_LONG                    0x3C  
#define ECCROMCC26XX_STATUS_X_COORD_LENGTH_ZERO                 0xC3  
#define ECCROMCC26XX_STATUS_Y_COORD_TOO_LONG                    0x65  
#define ECCROMCC26XX_STATUS_Y_COORD_LENGTH_ZERO                 0x56  
#define ECCROMCC26XX_STATUS_A_COEF_TOO_LONG                     0x5C  
#define ECCROMCC26XX_STATUS_A_COEF_LENGTH_ZERO                  0xC5  
#define ECCROMCC26XX_STATUS_BAD_WINDOW_SIZE                     0x66  
#define ECCROMCC26XX_STATUS_SCALAR_MUL_OK                       0x99  

#define ECCROMCC26XX_STATUS_ORDER_LARGER_THAN_255_WORDS         0x28  
#define ECCROMCC26XX_STATUS_ORDER_EVEN                          0x82  
#define ECCROMCC26XX_STATUS_ORDER_MSW_IS_ZERO                   0x23  
#define ECCROMCC26XX_STATUS_ECCROMCC26XX_STATUS_KEY_TOO_LONG    0x25  
#define ECCROMCC26XX_STATUS_ECCROMCC26XX_STATUS_KEY_LENGTH_ZERO 0x52  
#define ECCROMCC26XX_STATUS_DIGEST_TOO_LONG                     0x27  
#define ECCROMCC26XX_STATUS_DIGEST_LENGTH_ZERO                  0x72  
#define ECCROMCC26XX_STATUS_ECDSA_SIGN_OK                       0x32  
#define ECCROMCC26XX_STATUS_ECDSA_INVALID_SIGNATURE             0x5A  
#define ECCROMCC26XX_STATUS_ECDSA_VALID_SIGNATURE               0xA5  
#define ECCROMCC26XX_STATUS_SIG_P1_TOO_LONG                     0x11  
#define ECCROMCC26XX_STATUS_SIG_P1_LENGTH_ZERO                  0x12  
#define ECCROMCC26XX_STATUS_SIG_P2_TOO_LONG                     0x22  
#define ECCROMCC26XX_STATUS_SIG_P2_LENGTH_ZERO                  0x21  

#define ECCROMCC26XX_STATUS_ECDH_KEYGEN_OK                      ECCROMCC26XX_STATUS_SCALAR_MUL_OK 
#define ECCROMCC26XX_STATUS_ECDH_COMMON_KEY_OK                  ECCROMCC26XX_STATUS_SCALAR_MUL_OK 
#define ECCROMCC26XX_STATUS_ECDH_X_ZERO                         0x1      
#define ECCROMCC26XX_STATUS_ECDH_Y_ZERO                         0x2      
#define ECCROMCC26XX_STATUS_ECDH_X_LARGER_THAN_PRIME            0x3      
#define ECCROMCC26XX_STATUS_ECDH_Y_LARGER_THAN_PRIME            0x4      
#define ECCROMCC26XX_STATUS_ECDH_PT_CHECK_FAIL                  0x5      
#define ECCROMCC26XX_NIST_P256_WORKZONE_LEN_IN_BYTES           684

#define ECCROMCC26XX_NIST_P256_KEY_LEN_IN_BYTES                32

#define ECCROMCC26XX_WORKZONE_LEN_IN_BYTES(len, win)           (4 * ((13 * (len)) + 13 + (3 * (len) * (1 << ((win) - 2)))))

typedef struct ECCROMCC26XX_CurveParams
{
    uint8_t         keyLen;         
    uint16_t        workzoneLen;    
    uint8_t         windowSize;     
    uint32_t        *param_p;       
    uint32_t        *param_r;       
    uint32_t        *param_a;       
    uint32_t        *param_b;       
    uint32_t        *param_gx;      
    uint32_t        *param_gy;      
} ECCROMCC26XX_CurveParams;

typedef uint8_t *(*ECCROMCC26XX_MallocCB)(uint16_t len);

typedef void (*ECCROMCC26XX_FreeCB)(uint8_t *pBuf);

typedef struct ECCROMCC26XX_Params {
    ECCROMCC26XX_CurveParams curve;   
    ECCROMCC26XX_MallocCB    malloc;  
    ECCROMCC26XX_FreeCB      free;    
    uint32_t                 timeout; 
    int8_t                   status;  
} ECCROMCC26XX_Params;

void ECCROMCC26XX_init(void);

void ECCROMCC26XX_Params_init(ECCROMCC26XX_Params *params);

int8_t ECCROMCC26XX_genKeys(uint8_t *privateKey, uint8_t *publicKeyX,
                            uint8_t *publicKeyY, ECCROMCC26XX_Params *params);

int8_t ECCROMCC26XX_genDHKey(uint8_t *privateKey, uint8_t *publicKeyX,
                             uint8_t *publicKeyY, uint8_t *dHKeyX,
                             uint8_t *dHKeyY, ECCROMCC26XX_Params *params);

int8_t ECC_VerifyPublicKeyWeierstrass(ECCROMCC26XX_Params *params, 
                                        const uint8_t *curvePointX, 
                                        const uint8_t *curvePointY, 
                                        uint32_t length);

#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_ECCROMCC26XX__include */