Functions
void	ECC_initialize (uint32_t *pWorkzone)
	Initialize elliptic curve parameters to default values and specify workzone. More...

void	ECC_init (uint32_t workzone, uint8_t windowSize, const uint32_t prime, const uint32_t order, const uint32_t a, const uint32_t b, const uint32_t generatorX, const uint32_t *generatorY)
	Initialize elliptic curve parameters to specified values and specify workzone. More...

uint8_t	ECC_generateKey (uint32_t randString, uint32_t privateKey, uint32_t publicKey_x, uint32_t publicKey_y)
	Generate a key. More...

uint8_t	ECC_ECDSA_sign (uint32_t secretKey, uint32_t text, uint32_t randString, uint32_t sign1, uint32_t *sign2)
	Sign data. More...

uint8_t	ECC_ECDSA_verify (uint32_t publicKey_x, uint32_t publicKey_y, uint32_t text, uint32_t sign1, uint32_t *sign2)
	Verify signature. More...

uint8_t	ECC_ECDH_computeSharedSecret (uint32_t privateKey, uint32_t publicKey_x, uint32_t publicKey_y, uint32_t sharedSecret_x, uint32_t *sharedSecret_y)
	Compute the shared secret. More...

Detailed Description

Function Documentation

§ ECC_ECDH_computeSharedSecret()

uint8_t ECC_ECDH_computeSharedSecret	(	uint32_t *	privateKey,
		uint32_t *	publicKey_x,
		uint32_t *	publicKey_y,
		uint32_t *	sharedSecret_x,
		uint32_t *	sharedSecret_y
	)

Compute the shared secret.

Parameters

privateKey	Pointer to private key, input.
publicKey_x	Pointer to public key X-coordinate, input.
publicKey_y	Pointer to public key Y-coordinate, input.
sharedSecret_x	Pointer to shared secret X-coordinate, output.
sharedSecret_y	Pointer to shared secret Y-coordinate, output.

Returns: Status

 {
   return (uint8_t)ecdh_computeSharedSecret((uint32_t*)privateKey, (uint32_t*)publicKey_x,
                                  (uint32_t*)publicKey_y, (uint32_t*)sharedSecret_x,
                                  (uint32_t*)sharedSecret_y);
 }

§ ECC_ECDSA_sign()

uint8_t ECC_ECDSA_sign	(	uint32_t *	secretKey,
		uint32_t *	text,
		uint32_t *	randString,
		uint32_t *	sign1,
		uint32_t *	sign2
	)

Sign data.

Parameters

secretKey	Pointer to the secret key, input.
text	Pointer to the message, input.
randString	Pointer to random string, input.
sign1	Pointer to signature part 1, output.
sign2	Pointer to signature part 2, output.

Returns: Status

 {
   return (uint8_t)ecc_ecdsa_sign((uint32_t*)secretKey, (uint32_t*)text, (uint32_t*)randString,
                              (uint32_t*)sign1, (uint32_t*)sign2);
 }

§ ECC_ECDSA_verify()

uint8_t ECC_ECDSA_verify	(	uint32_t *	publicKey_x,
		uint32_t *	publicKey_y,
		uint32_t *	text,
		uint32_t *	sign1,
		uint32_t *	sign2
	)

Verify signature.

Parameters

publicKey_x	Pointer to public key X-coordinate, input.
publicKey_y	Pointer to public key Y-coordinate, input.
text	Pointer to message data, input.
sign1	Pointer to signature part 1, input.
sign2	Pointer to signature part 2, input.

Returns: Status

 {
   return (uint8_t)ecc_ecdsa_verify((uint32_t*)publicKey_x, (uint32_t*)publicKey_y, (uint32_t*)text,
                               (uint32_t*)sign1, (uint32_t*)sign2);
 }

§ ECC_generateKey()

uint8_t ECC_generateKey	(	uint32_t *	randString,
		uint32_t *	privateKey,
		uint32_t *	publicKey_x,
		uint32_t *	publicKey_y
	)

Generate a key.

This is used for both ECDH and ECDSA.

Parameters

randString	Pointer to random string, input.
privateKey	Pointer to the private key, output.
publicKey_x	Pointer to public key X-coordinate, output.
publicKey_y	Pointer to public key Y-coordinate, output.

Returns: Status

 {
   return (uint8_t)ecc_generatekey((uint32_t*)randString, (uint32_t*)privateKey,
                                   (uint32_t*)publicKey_x, (uint32_t*)publicKey_y);
 
 }

§ ECC_init()

void ECC_init	(	uint32_t *	workzone,
		uint8_t	windowSize,
		const uint32_t *	prime,
		const uint32_t *	order,
		const uint32_t *	a,
		const uint32_t *	b,
		const uint32_t *	generatorX,
		const uint32_t *	generatorY
	)

Initialize elliptic curve parameters to specified values and specify workzone.

This function may be used to explicitly specify the curve parameters used by the ECC in ROM implementation.

All curve parameters must be prepended with a length word specifying the length of the parameter in 32-bit words excluding the length word itself. For NIST-P256, the length word is 8.

Parameters

workzone	Pointer to memory allocated for computations, input. See description at beginning of ECC section for memory requirements.
windowSize	Window size of `workzone`. Default value is 3.
prime	Curve prime
order	Curve order
a	Curve a value
b	Curve b value
generatorX	X coordinate of generator point
generatorY	Y coordinate of generator point

 {
   // Initialize curve parameters
   //data_p  = (uint32_t *)PARAM_P;
   *((const uint32_t **)0x20000138) = prime;
 
   //data_r  = (uint32_t *)PARAM_R;
   *((const uint32_t **)0x2000013c) = order;
 
   //data_a  = (uint32_t *)PARAM_A;
   *((const uint32_t **)0x20000140) = a;
 
   //data_b  = (uint32_t *)PARAM_B;
   *((const uint32_t **)0x20000144) = b;
 
   //data_Gx = (uint32_t *)PARAM_GX;
   *((const uint32_t **)0x2000012c) = generatorX;
 
   //data_Gy = (uint32_t *)PARAM_GY;
   *((const uint32_t **)0x20000130) = generatorY;
 
   // Initialize window size
   //win = (uint8_t) windowSize;
   *((uint8_t *)0x20000148) = windowSize;
 
   // Initialize work zone
   //workzone = (uint32_t *) pWorkzone;
   *((uint32_t **)0x20000134) = workzone;
 }

§ ECC_initialize()

void ECC_initialize ( uint32_t * pWorkzone )

Initialize elliptic curve parameters to default values and specify workzone.

This function initializes the elliptic curve parameters to default values. The default elliptic curve used is NIST-P256.

The workzone defaults to an expected window size of 3.

This function can be called again to point the ECC workzone at a different memory buffer.

Parameters

pWorkzone Pointer to memory allocated for computations, input. See description at beginning of ECC section for memory requirements.

Returns: None

 {
   // Initialize curve parameters
   //data_p  = ECC_NISTP256_prime;
   *((const uint32_t **)0x20000138) = ECC_NISTP256_prime;
 
   //data_r  = ECC_NISTP256_order;
   *((const uint32_t **)0x2000013c) = ECC_NISTP256_order;
 
   //data_a  = ECC_NISTP256_a;
   *((const uint32_t **)0x20000140) = ECC_NISTP256_a;
 
   //data_b  = ECC_NISTP256_b;
   *((const uint32_t **)0x20000144) = ECC_NISTP256_b;
 
   //data_Gx = ECC_NISTP256_generatorX;
   *((const uint32_t **)0x2000012c) = ECC_NISTP256_generatorX;
 
   //data_Gy = ECC_NISTP256_generatorY;
   *((const uint32_t **)0x20000130) = ECC_NISTP256_generatorY;
 
   // Initialize window size
   //win = (uint8_t) ECC_WINDOW_SIZE;
   *((uint8_t *)0x20000148) = (uint8_t) ECC_WINDOW_SIZE;
 
   // Initialize work zone
   //workzone = (uint32_t *) pWorkzone;
   *((uint32_t **)0x20000134) = (uint32_t *) pWorkzone;
 }

Macro Definition Documentation

§ ECC_A_COEF_LENGTH_ZERO

#define ECC_A_COEF_LENGTH_ZERO 0xC5

§ ECC_A_COEF_TOO_LONG

#define ECC_A_COEF_TOO_LONG 0x5C

§ ECC_BAD_WINDOW_SIZE

#define ECC_BAD_WINDOW_SIZE 0x66

§ ECC_DIGEST_LENGTH_ZERO

#define ECC_DIGEST_LENGTH_ZERO 0x72

§ ECC_DIGEST_TOO_LONG

#define ECC_DIGEST_TOO_LONG 0x27

§ ECC_ECC_KEY_LENGTH_ZERO

#define ECC_ECC_KEY_LENGTH_ZERO 0x52

§ ECC_ECC_KEY_TOO_LONG

#define ECC_ECC_KEY_TOO_LONG 0x25

§ ECC_ECDH_COMMON_KEY_OK

#define ECC_ECDH_COMMON_KEY_OK ECC_SCALAR_MUL_OK

§ ECC_ECDH_KEYGEN_OK

#define ECC_ECDH_KEYGEN_OK ECC_SCALAR_MUL_OK

§ ECC_ECDSA_INVALID_SIGNATURE

#define ECC_ECDSA_INVALID_SIGNATURE 0x5A

§ ECC_ECDSA_KEYGEN_OK

#define ECC_ECDSA_KEYGEN_OK ECC_SCALAR_MUL_OK

§ ECC_ECDSA_SIGN_OK

#define ECC_ECDSA_SIGN_OK 0x32

§ ECC_ECDSA_VALID_SIGNATURE

#define ECC_ECDSA_VALID_SIGNATURE 0xA5

§ ECC_LENGTH_OFFSET_BYTES

#define ECC_LENGTH_OFFSET_BYTES 4

§ ECC_MODULUS_EVEN

#define ECC_MODULUS_EVEN 0xDC

§ ECC_MODULUS_LARGER_THAN_255_WORDS

#define ECC_MODULUS_LARGER_THAN_255_WORDS 0xD2

§ ECC_MODULUS_LENGTH_ZERO

#define ECC_MODULUS_LENGTH_ZERO 0x08

§ ECC_MODULUS_MSW_IS_ZERO

#define ECC_MODULUS_MSW_IS_ZERO 0x30

§ ECC_NISTP256_a

#define ECC_NISTP256_a ((const uint32_t *) 0x1002581c)

Referenced by ECC_initialize().

§ ECC_NISTP256_b

#define ECC_NISTP256_b ((const uint32_t *) 0x10025840)

Referenced by ECC_initialize().

§ ECC_NISTP256_generatorX

#define ECC_NISTP256_generatorX ((const uint32_t *) 0x10025864)

Referenced by ECC_initialize().

§ ECC_NISTP256_generatorY

#define ECC_NISTP256_generatorY ((const uint32_t *) 0x10025888)

Referenced by ECC_initialize().

§ ECC_NISTP256_order

#define ECC_NISTP256_order ((const uint32_t *) 0x100257f8)

Referenced by ECC_initialize().

§ ECC_NISTP256_PARAM_LENGTH_BYTES

#define ECC_NISTP256_PARAM_LENGTH_BYTES 32

§ ECC_NISTP256_PARAM_LENGTH_WORDS

#define ECC_NISTP256_PARAM_LENGTH_WORDS (ECC_NISTP256_PARAM_LENGTH_BYTES / sizeof(uint32_t))

§ ECC_NISTP256_prime

#define ECC_NISTP256_prime ((const uint32_t *) 0x100257d4)

Referenced by ECC_initialize().

§ ECC_ORDER_EVEN

#define ECC_ORDER_EVEN 0x82

§ ECC_ORDER_LARGER_THAN_255_WORDS

#define ECC_ORDER_LARGER_THAN_255_WORDS 0x28

§ ECC_ORDER_LENGTH_ZERO

#define ECC_ORDER_LENGTH_ZERO 0x6C

§ ECC_ORDER_MSW_IS_ZERO

#define ECC_ORDER_MSW_IS_ZERO 0x23

§ ECC_ORDER_TOO_LONG

#define ECC_ORDER_TOO_LONG 0xC6

§ ECC_PRIME_NIST256_CURVE

#define ECC_PRIME_NIST256_CURVE

§ ECC_SCALAR_LENGTH_ZERO

#define ECC_SCALAR_LENGTH_ZERO 0x53

§ ECC_SCALAR_MUL_OK

#define ECC_SCALAR_MUL_OK 0x99

§ ECC_SCALAR_TOO_LONG

#define ECC_SCALAR_TOO_LONG 0x35

§ ECC_SIG_P1_LENGTH_ZERO

#define ECC_SIG_P1_LENGTH_ZERO 0x12

§ ECC_SIG_P1_TOO_LONG

#define ECC_SIG_P1_TOO_LONG 0x11

§ ECC_SIG_P2_LENGTH_ZERO

#define ECC_SIG_P2_LENGTH_ZERO 0x21

§ ECC_SIG_P2_TOO_LONG

#define ECC_SIG_P2_TOO_LONG 0x22

§ ECC_WINDOW_SIZE

#define ECC_WINDOW_SIZE 3

Referenced by ECC_initialize().

§ ECC_X_COORD_LENGTH_ZERO

#define ECC_X_COORD_LENGTH_ZERO 0xC3

§ ECC_X_COORD_TOO_LONG

#define ECC_X_COORD_TOO_LONG 0x3C

§ ECC_Y_COORD_LENGTH_ZERO

#define ECC_Y_COORD_LENGTH_ZERO 0x56

§ ECC_Y_COORD_TOO_LONG

#define ECC_Y_COORD_TOO_LONG 0x65

Functions

Detailed Description

Function Documentation

§ ECC_ECDH_computeSharedSecret()

§ ECC_ECDSA_sign()

§ ECC_ECDSA_verify()

§ ECC_generateKey()

§ ECC_init()

§ ECC_initialize()

Macro Definition Documentation

§ ECC_A_COEF_LENGTH_ZERO

§ ECC_A_COEF_TOO_LONG

§ ECC_BAD_WINDOW_SIZE

§ ECC_DIGEST_LENGTH_ZERO

§ ECC_DIGEST_TOO_LONG

§ ECC_ECC_KEY_LENGTH_ZERO

§ ECC_ECC_KEY_TOO_LONG

§ ECC_ECDH_COMMON_KEY_OK

§ ECC_ECDH_KEYGEN_OK

§ ECC_ECDSA_INVALID_SIGNATURE

§ ECC_ECDSA_KEYGEN_OK

§ ECC_ECDSA_SIGN_OK

§ ECC_ECDSA_VALID_SIGNATURE

§ ECC_LENGTH_OFFSET_BYTES

§ ECC_MODULUS_EVEN

§ ECC_MODULUS_LARGER_THAN_255_WORDS

§ ECC_MODULUS_LENGTH_ZERO

§ ECC_MODULUS_MSW_IS_ZERO

§ ECC_NISTP256_a

§ ECC_NISTP256_b

§ ECC_NISTP256_generatorX

§ ECC_NISTP256_generatorY

§ ECC_NISTP256_order

§ ECC_NISTP256_PARAM_LENGTH_BYTES

§ ECC_NISTP256_PARAM_LENGTH_WORDS

§ ECC_NISTP256_prime

§ ECC_ORDER_EVEN

§ ECC_ORDER_LARGER_THAN_255_WORDS

§ ECC_ORDER_LENGTH_ZERO

§ ECC_ORDER_MSW_IS_ZERO

§ ECC_ORDER_TOO_LONG

§ ECC_PRIME_NIST256_CURVE

§ ECC_SCALAR_LENGTH_ZERO

§ ECC_SCALAR_MUL_OK

§ ECC_SCALAR_TOO_LONG

§ ECC_SIG_P1_LENGTH_ZERO

§ ECC_SIG_P1_TOO_LONG

§ ECC_SIG_P2_LENGTH_ZERO

§ ECC_SIG_P2_TOO_LONG

§ ECC_WINDOW_SIZE

§ ECC_X_COORD_LENGTH_ZERO

§ ECC_X_COORD_TOO_LONG

§ ECC_Y_COORD_LENGTH_ZERO

§ ECC_Y_COORD_TOO_LONG