CC26xx Driver Library
pka.c File Reference
#include "pka.h"

Macros

#define MAX(x, y)   (((x) > (y)) ? (x) : (y))
 
#define MIN(x, y)   (((x) < (y)) ? (x) : (y))
 
#define INRANGE(x, y, z)   ((x) > (y) && (x) < (z))
 
#define PKA_MAX_CURVE_SIZE_32_BIT_WORD   12
 
#define PKA_MAX_LEN_IN_32_BIT_WORD   PKA_MAX_CURVE_SIZE_32_BIT_WORD
 
#define PKA_NO_POINTER_REG   0xFF
 

Functions

void PKAClearPkaRam (void)
 Zeroizes PKA RAM. More...
 
static uint32_t PKAWritePkaParam (const uint8_t *param, uint32_t paramLength, uint32_t paramOffset, uint32_t ptrRegOffset)
 
static uint32_t PKAWritePkaParamExtraOffset (const uint8_t *param, uint32_t paramLength, uint32_t paramOffset, uint32_t ptrRegOffset)
 
static uint32_t PKAGetBigNumResult (uint8_t *resultBuf, uint32_t *resultLength, uint32_t resultPKAMemAddr)
 
static uint32_t PKAGetBigNumResultRemainder (uint8_t *resultBuf, uint32_t *resultLength, uint32_t resultPKAMemAddr)
 
static uint32_t PKAGetECCResult (uint8_t *curvePointX, uint8_t *curvePointY, uint32_t resultPKAMemAddr, uint32_t length)
 
uint32_t PKAGetOpsStatus (void)
 Gets the PKA operation status. More...
 
bool PKAArrayAllZeros (const uint8_t *array, uint32_t arrayLength)
 Checks whether and array only consists of zeros. More...
 
void PKAZeroOutArray (const uint8_t *array, uint32_t arrayLength)
 Zeros-out an array. More...
 
uint32_t PKABigNumModStart (const uint8_t *bigNum, uint32_t bigNumLength, const uint8_t *modulus, uint32_t modulusLength, uint32_t *resultPKAMemAddr)
 Starts a big number modulus operation. More...
 
uint32_t PKABigNumModGetResult (uint8_t *resultBuf, uint32_t length, uint32_t resultPKAMemAddr)
 Gets the result of the big number modulus operation. More...
 
uint32_t PKABigNumDivideStart (const uint8_t *dividend, uint32_t dividendLength, const uint8_t *divisor, uint32_t divisorLength, uint32_t *resultQuotientMemAddr, uint32_t *resultRemainderMemAddr)
 Starts a big number divide operation. More...
 
uint32_t PKABigNumDivideGetQuotient (uint8_t *resultBuf, uint32_t *length, uint32_t resultQuotientMemAddr)
 Gets the quotient of the big number divide operation. More...
 
uint32_t PKABigNumDivideGetRemainder (uint8_t *resultBuf, uint32_t *length, uint32_t resultQuotientMemAddr)
 Gets the remainder of the big number divide operation. More...
 
uint32_t PKABigNumCmpStart (const uint8_t *bigNum1, const uint8_t *bigNum2, uint32_t length)
 Starts the comparison of two big numbers. More...
 
uint32_t PKABigNumCmpGetResult (void)
 Gets the result of the comparison operation of two big numbers. More...
 
uint32_t PKABigNumInvModStart (const uint8_t *bigNum, uint32_t bigNumLength, const uint8_t *modulus, uint32_t modulusLength, uint32_t *resultPKAMemAddr)
 Starts a big number inverse modulo operation. More...
 
uint32_t PKABigNumInvModGetResult (uint8_t *resultBuf, uint32_t length, uint32_t resultPKAMemAddr)
 Gets the result of the big number inverse modulo operation. More...
 
uint32_t PKABigNumExpModStart (const uint8_t *base, uint32_t baseLength, const uint8_t *exponent, uint32_t exponentLength, const uint8_t *modulus, uint32_t modulusLength, uint32_t *resultPKAMemAddr)
 Starts a big number modular exponentiation operation. More...
 
uint32_t PKABigNumExpModGetResult (uint8_t *resultBuf, uint32_t length, uint32_t resultPKAMemAddr)
 Gets the result of the big number modular exponentiation operation. More...
 
uint32_t PKABigNumMultiplyStart (const uint8_t *multiplicand, uint32_t multiplicandLength, const uint8_t *multiplier, uint32_t multiplierLength, uint32_t *resultPKAMemAddr)
 Starts the multiplication of two big numbers. More...
 
uint32_t PKABigNumMultGetResult (uint8_t *resultBuf, uint32_t *resultLength, uint32_t resultPKAMemAddr)
 Gets the result of the big number multiplication. More...
 
uint32_t PKABigNumAddStart (const uint8_t *bigNum1, uint32_t bigNum1Length, const uint8_t *bigNum2, uint32_t bigNum2Length, uint32_t *resultPKAMemAddr)
 Starts the addition of two big numbers. More...
 
uint32_t PKABigNumSubGetResult (uint8_t *resultBuf, uint32_t *resultLength, uint32_t resultPKAMemAddr)
 Gets the result of the subtraction operation on two big numbers. More...
 
uint32_t PKABigNumSubStart (const uint8_t *minuend, uint32_t minuendLength, const uint8_t *subtrahend, uint32_t subtrahendLength, uint32_t *resultPKAMemAddr)
 Starts the subtraction of one big number from another. More...
 
uint32_t PKABigNumAddGetResult (uint8_t *resultBuf, uint32_t *resultLength, uint32_t resultPKAMemAddr)
 Gets the result of the addition operation on two big numbers. More...
 
uint32_t PKAEccMultiplyStart (const uint8_t *scalar, const uint8_t *curvePointX, const uint8_t *curvePointY, const uint8_t *prime, const uint8_t *a, const uint8_t *b, uint32_t length, uint32_t *resultPKAMemAddr)
 Starts ECC multiplication. More...
 
uint32_t PKAEccMontgomeryMultiplyStart (const uint8_t *scalar, const uint8_t *curvePointX, const uint8_t *prime, const uint8_t *a, uint32_t length, uint32_t *resultPKAMemAddr)
 Starts ECC Montgomery multiplication. More...
 
uint32_t PKAEccMultiplyGetResult (uint8_t *curvePointX, uint8_t *curvePointY, uint32_t resultPKAMemAddr, uint32_t length)
 Gets the result of ECC multiplication. More...
 
uint32_t PKAEccAddStart (const uint8_t *curvePoint1X, const uint8_t *curvePoint1Y, const uint8_t *curvePoint2X, const uint8_t *curvePoint2Y, const uint8_t *prime, const uint8_t *a, uint32_t length, uint32_t *resultPKAMemAddr)
 Starts the ECC addition. More...
 
uint32_t PKAEccAddGetResult (uint8_t *curvePointX, uint8_t *curvePointY, uint32_t resultPKAMemAddr, uint32_t length)
 Gets the result of the ECC addition. More...
 
uint32_t PKAEccVerifyPublicKeyWeierstrassStart (const uint8_t *curvePointX, const uint8_t *curvePointY, const uint8_t *prime, const uint8_t *a, const uint8_t *b, const uint8_t *order, uint32_t length)
 Begins the validation of a public key against a Short-Weierstrass curve. More...
 

Variables

const PKA_EccPoint224 NISTP224_generator
 X coordinate of the generator point of the NISTP224 curve. More...
 
const PKA_EccParam224 NISTP224_prime
 Prime of the NISTP224 curve. More...
 
const PKA_EccParam224 NISTP224_a
 a constant of the NISTP224 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam224 NISTP224_b
 b constant of the NISTP224 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam224 NISTP224_order
 Order of the NISTP224 curve. More...
 
const PKA_EccPoint256 NISTP256_generator
 X coordinate of the generator point of the NISTP256 curve. More...
 
const PKA_EccParam256 NISTP256_prime
 Prime of the NISTP256 curve. More...
 
const PKA_EccParam256 NISTP256_a
 a constant of the NISTP256 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam256 NISTP256_b
 b constant of the NISTP256 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam256 NISTP256_order
 Order of the NISTP256 curve. More...
 
const PKA_EccPoint384 NISTP384_generator
 X coordinate of the generator point of the NISTP384 curve. More...
 
const PKA_EccParam384 NISTP384_prime
 Prime of the NISTP384 curve. More...
 
const PKA_EccParam384 NISTP384_a
 a constant of the NISTP384 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam384 NISTP384_b
 b constant of the NISTP384 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam384 NISTP384_order
 Order of the NISTP384 curve. More...
 
const PKA_EccPoint521 NISTP521_generator
 X coordinate of the generator point of the NISTP521 curve. More...
 
const PKA_EccParam521 NISTP521_prime
 Prime of the NISTP521 curve. More...
 
const PKA_EccParam521 NISTP521_a
 a constant of the NISTP521 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam521 NISTP521_b
 b constant of the NISTP521 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam521 NISTP521_order
 Order of the NISTP521 curve. More...
 
const PKA_EccPoint256 BrainpoolP256R1_generator
 X coordinate of the generator point of the BrainpoolP256R1 curve. More...
 
const PKA_EccParam256 BrainpoolP256R1_prime
 Prime of the BrainpoolP256R1 curve. More...
 
const PKA_EccParam256 BrainpoolP256R1_a
 a constant of the BrainpoolP256R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam256 BrainpoolP256R1_b
 b constant of the BrainpoolP256R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam256 BrainpoolP256R1_order
 Order of the BrainpoolP256R1 curve. More...
 
const PKA_EccPoint384 BrainpoolP384R1_generator
 X coordinate of the generator point of the BrainpoolP384R1 curve. More...
 
const PKA_EccParam384 BrainpoolP384R1_prime
 Prime of the BrainpoolP384R1 curve. More...
 
const PKA_EccParam384 BrainpoolP384R1_a
 a constant of the BrainpoolP384R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam384 BrainpoolP384R1_b
 b constant of the BrainpoolP384R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam384 BrainpoolP384R1_order
 Order of the BrainpoolP384R1 curve. More...
 
const PKA_EccPoint512 BrainpoolP512R1_generator
 X coordinate of the generator point of the BrainpoolP512R1 curve. More...
 
const PKA_EccParam512 BrainpoolP512R1_prime
 Prime of the BrainpoolP512R1 curve. More...
 
const PKA_EccParam512 BrainpoolP512R1_a
 a constant of the BrainpoolP512R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam512 BrainpoolP512R1_b
 b constant of the BrainpoolP512R1 curve when expressed in short Weierstrass form (y^3 = x^2 + a*x + b). More...
 
const PKA_EccParam512 BrainpoolP512R1_order
 Order of the BrainpoolP512R1 curve. More...
 
const PKA_EccPoint256 Curve25519_generator
 X coordinate of the generator point of the Curve25519 curve. More...
 
const PKA_EccParam256 Curve25519_prime
 Prime of the Curve25519 curve. More...
 
const PKA_EccParam256 Curve25519_a
 a constant of the Curve25519 curve when expressed in Montgomery form (By^2 = x^3 + a*x^2 + x). More...
 
const PKA_EccParam256 Curve25519_b
 b constant of the Curve25519 curve when expressed in Montgomery form (By^2 = x^3 + a*x^2 + x). More...
 
const PKA_EccParam256 Curve25519_order
 Order of the Curve25519 curve. More...
 

Macro Definition Documentation

§ INRANGE

#define INRANGE (   x,
  y,
 
)    ((x) > (y) && (x) < (z))

§ MAX

#define MAX (   x,
 
)    (((x) > (y)) ? (x) : (y))

§ MIN

#define MIN (   x,
 
)    (((x) < (y)) ? (x) : (y))

§ PKA_MAX_CURVE_SIZE_32_BIT_WORD

#define PKA_MAX_CURVE_SIZE_32_BIT_WORD   12

§ PKA_MAX_LEN_IN_32_BIT_WORD

#define PKA_MAX_LEN_IN_32_BIT_WORD   PKA_MAX_CURVE_SIZE_32_BIT_WORD

§ PKA_NO_POINTER_REG

#define PKA_NO_POINTER_REG   0xFF

Function Documentation

§ PKAGetBigNumResult()

static uint32_t PKAGetBigNumResult ( uint8_t *  resultBuf,
uint32_t *  resultLength,
uint32_t  resultPKAMemAddr 
)
static

Referenced by PKABigNumAddGetResult(), PKABigNumDivideGetQuotient(), PKABigNumExpModGetResult(), PKABigNumInvModGetResult(), PKABigNumMultGetResult(), and PKABigNumSubGetResult().

629 {
630  uint32_t mswOffset;
631  uint32_t lswOffset;
632  uint32_t lengthInWords;
633  uint32_t i;
634  uint32_t *resultWordAlias = (uint32_t *)resultBuf;
635 
636  // Check the arguments.
637  ASSERT(resultBuf);
638  ASSERT((resultPKAMemAddr > PKA_RAM_BASE) &&
639  (resultPKAMemAddr < (PKA_RAM_BASE + PKA_RAM_TOT_BYTE_SIZE)));
640 
641  // Verify that the operation is complete.
642  if (HWREG(PKA_BASE + PKA_O_FUNCTION) & PKA_FUNCTION_RUN) {
644  }
645 
646  // Get the MSW register value.
647  mswOffset = HWREG(PKA_BASE + PKA_O_MSW);
648 
649  // If the result vector is zero, write back one zero byte so the caller does not need
650  // to handle a special error for the perhaps valid result of zero.
651  // They will only get the error status if they do not provide a buffer
652  if (mswOffset & PKA_MSW_RESULT_IS_ZERO_M) {
653  if (*resultLength){
654  if(resultBuf){
655  resultBuf[0] = 0;
656  }
657 
658  *resultLength = 1;
659 
660  return PKA_STATUS_SUCCESS;
661  }
662  else {
664  }
665  }
666 
667  // Get the length of the result
668  mswOffset = ((mswOffset & PKA_MSW_MSW_ADDRESS_M) + 1);
669  lswOffset = ((resultPKAMemAddr - PKA_RAM_BASE) >> 2);
670 
671  if (mswOffset >= lswOffset) {
672  lengthInWords = mswOffset - lswOffset;
673  }
674  else {
676  }
677 
678  // Check if the provided buffer length is adequate to store the result data.
679  if (*resultLength < lengthInWords * sizeof(uint32_t)) {
681  }
682 
683  // Copy the resultant length.
684  *resultLength = lengthInWords * sizeof(uint32_t);
685 
686 
687  if (resultBuf) {
688  // Copy the result into the resultBuf.
689  for (i = 0; i < lengthInWords; i++) {
690  resultWordAlias[i]= HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
691  }
692  }
693 
694  return PKA_STATUS_SUCCESS;
695 }
#define PKA_STATUS_BUF_UNDERFLOW
Buffer underflow.
Definition: pka.h:124
#define PKA_STATUS_RESULT_ADDRESS_INCORRECT
The address of the result passed into one of the PKA*GetResult functions is incorrect.
Definition: pka.h:137
#define PKA_STATUS_OPERATION_BUSY
PKA operation is in progress.
Definition: pka.h:129
#define PKA_STATUS_SUCCESS
Success.
Definition: pka.h:121
#define ASSERT(expr)
Definition: debug.h:71

§ PKAGetBigNumResultRemainder()

static uint32_t PKAGetBigNumResultRemainder ( uint8_t *  resultBuf,
uint32_t *  resultLength,
uint32_t  resultPKAMemAddr 
)
static

Referenced by PKABigNumDivideGetRemainder(), and PKABigNumModGetResult().

703 {
704  uint32_t regMSWVal;
705  uint32_t lengthInWords;
706  uint32_t i;
707  uint32_t *resultWordAlias = (uint32_t *)resultBuf;
708 
709  // Check the arguments.
710  ASSERT(resultBuf);
711  ASSERT((resultPKAMemAddr > PKA_RAM_BASE) &&
712  (resultPKAMemAddr < (PKA_RAM_BASE + PKA_RAM_TOT_BYTE_SIZE)));
713 
714  // Verify that the operation is complete.
715  if (HWREG(PKA_BASE + PKA_O_FUNCTION) & PKA_FUNCTION_RUN) {
717  }
718 
719  // Get the MSW register value.
720  regMSWVal = HWREG(PKA_BASE + PKA_O_DIVMSW);
721 
722  // If the result vector is zero, write back one zero byte so the caller does not need
723  // to handle a special error for the perhaps valid result of zero.
724  // They will only get the error status if they do not provide a buffer
725  if (regMSWVal & PKA_DIVMSW_RESULT_IS_ZERO_M) {
726  if (*resultLength){
727  if(resultBuf){
728  resultBuf[0] = 0;
729  }
730 
731  *resultLength = 1;
732 
733  return PKA_STATUS_SUCCESS;
734  }
735  else {
737  }
738  }
739 
740  // Get the length of the result
741  lengthInWords = ((regMSWVal & PKA_DIVMSW_MSW_ADDRESS_M) + 1) - ((resultPKAMemAddr - PKA_RAM_BASE) >> 2);
742 
743  // Check if the provided buffer length is adequate to store the result data.
744  if (*resultLength < lengthInWords * sizeof(uint32_t)) {
746  }
747 
748  // Copy the resultant length.
749  *resultLength = lengthInWords * sizeof(uint32_t);
750 
751  if (resultBuf) {
752  // Copy the result into the resultBuf.
753  for (i = 0; i < lengthInWords; i++) {
754  resultWordAlias[i] = HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
755  }
756  }
757 
758  return PKA_STATUS_SUCCESS;
759 }
#define PKA_STATUS_BUF_UNDERFLOW
Buffer underflow.
Definition: pka.h:124
#define PKA_STATUS_OPERATION_BUSY
PKA operation is in progress.
Definition: pka.h:129
#define PKA_STATUS_SUCCESS
Success.
Definition: pka.h:121
#define ASSERT(expr)
Definition: debug.h:71

§ PKAGetECCResult()

static uint32_t PKAGetECCResult ( uint8_t *  curvePointX,
uint8_t *  curvePointY,
uint32_t  resultPKAMemAddr,
uint32_t  length 
)
static

Referenced by PKAEccAddGetResult(), and PKAEccMultiplyGetResult().

767 {
768  uint32_t i = 0;
769  uint32_t *xWordAlias = (uint32_t *)curvePointX;
770  uint32_t *yWordAlias = (uint32_t *)curvePointY;
771  uint32_t lengthInWordsCeiling = 0;
772 
773  // Check for the arguments.
774  ASSERT(curvePointX);
775  ASSERT(curvePointY);
776  ASSERT((resultPKAMemAddr > PKA_RAM_BASE) &&
777  (resultPKAMemAddr < (PKA_RAM_BASE + PKA_RAM_TOT_BYTE_SIZE)));
778 
779  // Verify that the operation is completed.
780  if (HWREG(PKA_BASE + PKA_O_FUNCTION) & PKA_FUNCTION_RUN) {
782  }
783 
784  if (HWREG(PKA_BASE + PKA_O_SHIFT)) {
785  return PKA_STATUS_FAILURE;
786  }
787 
788  // Check to make sure that the result vector is not the point at infinity.
789  if (HWREG(PKA_BASE + PKA_O_MSW) & PKA_MSW_RESULT_IS_ZERO) {
791  }
792 
793  if (curvePointX != NULL) {
794  // Copy the x co-ordinate value of the result from vector D into
795  // the curvePoint.
796  for (i = 0; i < (length / sizeof(uint32_t)); i++) {
797  xWordAlias[i] = HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
798  }
799 
800  // If the length is not a word-multiple, fill up a temporary word and copy that in
801  // to avoid a bus error.
802  if (length % sizeof(uint32_t)) {
803  uint32_t temp = 0;
804  uint8_t j;
805 
806  // Load the entire word line of the coordinate remainder
807  temp = HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
808 
809  // Write all remaining bytes to the coordinate
810  for (j = 0; j < length % sizeof(uint32_t); j++) {
811  curvePointX[i * sizeof(uint32_t) + j] = ((uint8_t *)&temp)[j];
812  }
813 
814  }
815  }
816 
817  lengthInWordsCeiling = (length % sizeof(uint32_t)) ? length / sizeof(uint32_t) + 1 : length / sizeof(uint32_t);
818 
819  resultPKAMemAddr += sizeof(uint32_t) * (2 + lengthInWordsCeiling + (lengthInWordsCeiling % 2));
820 
821  if (curvePointY != NULL) {
822  // Copy the y co-ordinate value of the result from vector D into
823  // the curvePoint.
824  for (i = 0; i < (length / sizeof(uint32_t)); i++) {
825  yWordAlias[i] = HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
826  }
827 
828  // If the length is not a word-multiple, fill up a temporary word and copy that in
829  // to avoid a bus error.
830  if (length % sizeof(uint32_t)) {
831  uint32_t temp = 0;
832  uint8_t j;
833 
834  // Load the entire word line of the coordinate remainder
835  temp = HWREG(resultPKAMemAddr + sizeof(uint32_t) * i);
836 
837  // Write all remaining bytes to the coordinate
838  for (j = 0; j < length % sizeof(uint32_t); j++) {
839  curvePointY[i * sizeof(uint32_t) + j] = ((uint8_t *)&temp)[j];
840  }
841  }
842  }
843 
844 
845  return PKA_STATUS_SUCCESS;
846 }
#define PKA_STATUS_FAILURE
Failure.
Definition: pka.h:122
#define PKA_STATUS_OPERATION_BUSY
PKA operation is in progress.
Definition: pka.h:129
#define PKA_STATUS_SUCCESS
Success.
Definition: pka.h:121
#define ASSERT(expr)
Definition: debug.h:71
#define PKA_STATUS_POINT_AT_INFINITY
The ECC operation resulted in the point at infinity.
Definition: pka.h:138

§ PKAWritePkaParam()

static uint32_t PKAWritePkaParam ( const uint8_t *  param,
uint32_t  paramLength,
uint32_t  paramOffset,
uint32_t  ptrRegOffset 
)
static

Referenced by PKABigNumAddStart(), PKABigNumCmpStart(), PKABigNumDivideStart(), PKABigNumExpModStart(), PKABigNumInvModStart(), PKABigNumModStart(), PKABigNumMultiplyStart(), PKABigNumSubStart(), PKAEccMontgomeryMultiplyStart(), PKAEccMultiplyStart(), and PKAWritePkaParamExtraOffset().

548 {
549  uint32_t i;
550  uint32_t *paramWordAlias = (uint32_t *)param;
551  // Take the floor of paramLength in 32-bit words
552  uint32_t paramLengthInWords = paramLength / sizeof(uint32_t);
553 
554  // Only copy data if it is specified. We may wish to simply allocate another buffer and get
555  // the required offset.
556  if (param) {
557  // Load the number in PKA RAM
558  for (i = 0; i < paramLengthInWords; i++) {
559  HWREG(PKA_RAM_BASE + paramOffset + sizeof(uint32_t) * i) = paramWordAlias[i];
560  }
561 
562  // If the length is not a word-multiple, fill up a temporary word and copy that in
563  // to avoid a bus error. The extra zeros at the end should not matter, as the large
564  // number is little-endian and thus has no effect.
565  // We could have correctly calculated ceiling(paramLength / sizeof(uint32_t)) above.
566  // However, we would not have been able to zero-out the extra few most significant
567  // bytes of the most significant word. That would have resulted in doing maths operations
568  // on whatever follows param in RAM.
569  if (paramLength % sizeof(uint32_t)) {
570  uint32_t temp = 0;
571  uint8_t j;
572 
573  // Load the entire word line of the param remainder
574  temp = paramWordAlias[i];
575 
576  // Zero-out all bytes beyond the end of the param
577  for (j = paramLength % sizeof(uint32_t); j < sizeof(uint32_t); j++) {
578  ((uint8_t *)&temp)[j] = 0;
579  }
580 
581  HWREG(PKA_RAM_BASE + paramOffset + sizeof(uint32_t) * i) = temp;
582 
583  // Increment paramLengthInWords since we take the ceiling of length / sizeof(uint32_t)
584  paramLengthInWords++;
585  }
586  }
587 
588  // Update the A, B, C, or D pointer with the offset address of the PKA RAM location
589  // where the number will be stored.
590  switch (ptrRegOffset) {
591  case PKA_O_APTR:
592  HWREG(PKA_BASE + PKA_O_APTR) = paramOffset >> 2;
593  HWREG(PKA_BASE + PKA_O_ALENGTH) = paramLengthInWords;
594  break;
595  case PKA_O_BPTR:
596  HWREG(PKA_BASE + PKA_O_BPTR) = paramOffset >> 2;
597  HWREG(PKA_BASE + PKA_O_BLENGTH) = paramLengthInWords;
598  break;
599  case PKA_O_CPTR:
600  HWREG(PKA_BASE + PKA_O_CPTR) = paramOffset >> 2;
601  break;
602  case PKA_O_DPTR:
603  HWREG(PKA_BASE + PKA_O_DPTR) = paramOffset >> 2;
604  break;
605  }
606 
607  // Ensure 8-byte alignment of next parameter.
608  // Returns the offset for the next parameter.
609  return paramOffset + sizeof(uint32_t) * (paramLengthInWords + (paramLengthInWords % 2));
610 }

§ PKAWritePkaParamExtraOffset()

static uint32_t PKAWritePkaParamExtraOffset ( const uint8_t *  param,
uint32_t  paramLength,
uint32_t  paramOffset,
uint32_t  ptrRegOffset 
)
static

Referenced by PKABigNumDivideStart(), PKABigNumExpModStart(), PKABigNumModStart(), PKAEccAddStart(), PKAEccMontgomeryMultiplyStart(), and PKAEccMultiplyStart().

618 {
619  // Ensure 16-byte alignment.
620  return (sizeof(uint32_t) * 2) + PKAWritePkaParam(param, paramLength, paramOffset, ptrRegOffset);
621 }
static uint32_t PKAWritePkaParam(const uint8_t *param, uint32_t paramLength, uint32_t paramOffset, uint32_t ptrRegOffset)
Definition: pka.c:547
Here is the call graph for this function: