mcuxClPkc functions of PKC UPTR table setup
More...
mcuxClPkc functions of PKC UPTR table setup
◆ MCUXCLPKC_FP_GENERATEUPTRT
#define MCUXCLPKC_FP_GENERATEUPTRT |
( |
|
pUPTRT, |
|
|
|
pBaseBuffer, |
|
|
|
bufferSize, |
|
|
|
noOfBuffer |
|
) |
| |
◆ mcuxClPkc_GenerateUPTRT()
void mcuxClPkc_GenerateUPTRT |
( |
uint16_t * |
pUPTRT, |
|
|
const uint8_t * |
pBaseBuffer, |
|
|
uint16_t |
bufferLength, |
|
|
uint8_t |
noOfBuffer |
|
) |
| |
Initialize UPTR table.
This function initializes elements in UPTR table. UPTR table contains the address (16-bit offset in PKC workarea) of each buffer (PKC operand). Each element of the table will be initialized with a 16-bit offset, associated with a buffer allocated in sequence in PKC workarea. When calling this function, there shall be no on-going and pending PKC calculations using the specified UPTR table elements.
- Parameters
-
[out] | pUPTRT | pointer to the first element to be initialized in UPTR table. |
[in] | pBaseBuffer | address of the buffer in PKC workarea, with which the first element will be associated. |
[in] | bufferLength | byte length of each buffer in PKC workarea. |
[in] | noOfBuffer | number of elements to be initialized. |
- Parameter properties
pUPTRT
- this pointer shall be 2-byte aligned.
pBaseBuffer
- this address shall be MCUXCLPKC_WORDSIZE aligned.
bufferLength
- this length shall be a multiple of MCUXCLPKC_WORDSIZE.
◆ mcuxClPkc_RandomizeUPTRT()
Randomize UPTR table.
This function randomly permutes offsets stored in UPTR table. It randomizes the buffer allocation (physical address in PKC workarea). When calling this function, there shall be no on-going and pending PKC calculations using the specified UPTR table elements.
- Parameters
-
[in] | pSession | handle for the current CL session. |
[in,out] | pUPTRT | pointer to the first element to be randomized in UPTR table. |
[in] | noOfBuffer | number of elements to be randomized. |
- Parameter properties
- pSession:
- The session pointed to by pSession has to be initialized prior to a call to this function.
pUPTRT
- this pointer shall be 2-byte aligned.
- Attention
- Only the buffer allocation will be randomized, existing operands stored in each buffer will not be moved accordingly.
-
This function uses PRNG. Caller needs to check if PRNG is ready.
- Returns
- A flow-protected status code (see Flow Protection API).
- Return values
-
- Attention
- This function uses PRNG which has to be initialized prior to calling the function.
◆ mcuxClPkc_ReRandomizeUPTRT()
Randomize UPTR table and operands in PKC workarea.
This function randomly permutes offsets stored in UPTR table, together with operands stored in each buffer in PKC workarea. It randomizes the buffer allocation (physical address in PKC workarea) and moves operands stored accordingly. When calling this function, there shall be no on-going and pending PKC calculations using the specified UPTR table elements.
- Parameters
-
[in] | pSession | handle for the current CL session. |
[in,out] | pUPTRT | pointer to the first element to be randomized in UPTR table. |
[in] | bufferLength | byte length of each buffer in PKC workarea. |
[in] | noOfBuffer | number of elements to be randomized. |
- Parameter properties
- pSession:
- The session pointed to by pSession has to be initialized prior to a call to this function.
pUPTRT
- this pointer shall be 2-byte aligned.
All offsets (pUPTRT[0~(noOfBuffer-1)]) shall be exactly a multiple of MCUXCLPKC_WORDSIZE.
bufferLength
- this length shall be a multiple of MCUXCLPKC_WORDSIZE.
- Attention
- This function uses PRNG. Caller needs to check if PRNG is ready.
- Returns
- A flow-protected status code (see Flow Protection API).
- Return values
-
- Attention
- This function uses PRNG which has to be initialized prior to calling the function.