crypto_Sym_Status_E Crypto_Sym_ChaCha20Direct(
crypto_HandlerType_E handlerType_en,
uint8_t *ptr_inputData,
uint32_t dataLen,
uint8_t *ptr_outData,
uint8_t *ptr_key,
uint8_t *ptr_initVect,
uint32_t sessionID
);
Description
This API performs ChaCha20 encryption or decryption in a single step without
initializing. The same API is used for both encryption and decryption.
Parameters
| No. | Argument Type | Argument Name | Type | Description |
|---|
| 1 | crypto_HandlerType_E | handlerType_en | Input | Enum for
crypto operation handler i.e., SW, HW |
| 2 | uint8_t* | ptr_inputData | Input | Input
data/cipher data to encrypt or decrypt |
| 3 | uint32_t | dataLen | Input | Input length
of plain data/cipher data in bytes |
| 4 | uint8_t* | ptr_outData | Output | Pointer to
store cipher text/plain text as output |
| 5 | uint8_t* | ptr_key | Input | Key for the
Symmetric operation (32 bytes for Chacha20) |
| 6 | uint8_t* | ptr_initVect | Input | Initialization
vector where 96 bits are Nonce, and 32 bits are counter |
| 7 | uint32_t | sessionID | Input | It defines the
session ID, must be more than zero |
Returns
| Return Type | Description |
|---|
| crypto_Sym_Status_E | Function
returns the status of the API. |
Prerequisites
- To use the HW handler, the
algorithm must be enabled in Crypto v4 in MPLAB® Code Configurator.
- To use the SW handler, the
algorithm must be enabled in wolfCrypt, and linked to Crypto V4 in MPLAB® Code
Configurator.
Example
#define sessionID 1
crypto_Sym_Status_E status;
crypto_HandlerType_E handlerType_en = CRYPTO_HANDLER_SW_WOLFCRYPT;
uint8_t key[16] = {/*data*/};
uint8_t *ptr_initVect = {/*data*/};
uint8_t inputData[64] = {/*data*/};
uint32_t dataLen = sizeof(inputData);
uint8_t outData[64];
status = Crypto_Sym_ChaCha20Direct(
handlerType_en,
inputData,
dataLen,
outData,
key,
ptr_initVect,
sessionID
);
