STM32L4 cipher hardware accelerator. More...

#include "stm32l4xx.h"
#include "stm32l4xx_hal.h"
#include "core/crypto.h"
#include "hardware/stm32l4xx/stm32l4xx_crypto.h"
#include "hardware/stm32l4xx/stm32l4xx_crypto_cipher.h"
#include "cipher/cipher_algorithms.h"
#include "cipher_modes/cipher_modes.h"
#include "aead/aead_algorithms.h"
#include "debug.h"

Go to the source code of this file.

Macros

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL
 

Functions

error_t crypInit (void)
CRYP module initialization. More...
 
void aesLoadKey (AesContext *context, const uint32_t *key)
Load AES key. More...
 
void aesProcessData (AesContext *context, uint8_t *iv, const uint8_t *input, uint8_t *output, size_t length, uint32_t mode)
Perform AES encryption or decryption. More...
 
error_t aesInit (AesContext *context, const uint8_t *key, size_t keyLen)
Key expansion. More...
 
void aesEncryptBlock (AesContext *context, const uint8_t *input, uint8_t *output)
Encrypt a 16-byte block using AES algorithm. More...
 
void aesDecryptBlock (AesContext *context, const uint8_t *input, uint8_t *output)
Decrypt a 16-byte block using AES algorithm. More...
 
error_t ecbEncrypt (const CipherAlgo *cipher, void *context, const uint8_t *p, uint8_t *c, size_t length)
ECB encryption. More...
 
error_t ecbDecrypt (const CipherAlgo *cipher, void *context, const uint8_t *c, uint8_t *p, size_t length)
ECB decryption. More...
 
error_t cbcEncrypt (const CipherAlgo *cipher, void *context, uint8_t *iv, const uint8_t *p, uint8_t *c, size_t length)
CBC encryption. More...
 
error_t cbcDecrypt (const CipherAlgo *cipher, void *context, uint8_t *iv, const uint8_t *c, uint8_t *p, size_t length)
CBC decryption. More...
 
error_t ctrEncrypt (const CipherAlgo *cipher, void *context, uint_t m, uint8_t *t, const uint8_t *p, uint8_t *c, size_t length)
CTR encryption. More...
 
void gcmProcessData (AesContext *context, const uint8_t *iv, const uint8_t *a, size_t aLen, const uint8_t *input, uint8_t *output, size_t length, uint8_t *t, uint32_t mode)
Perform AES-GCM encryption or decryption. More...
 
error_t gcmInit (GcmContext *context, const CipherAlgo *cipherAlgo, void *cipherContext)
Initialize GCM context. More...
 
error_t gcmEncrypt (GcmContext *context, const uint8_t *iv, size_t ivLen, const uint8_t *a, size_t aLen, const uint8_t *p, uint8_t *c, size_t length, uint8_t *t, size_t tLen)
Authenticated encryption using GCM. More...
 
error_t gcmDecrypt (GcmContext *context, const uint8_t *iv, size_t ivLen, const uint8_t *a, size_t aLen, const uint8_t *c, uint8_t *p, size_t length, const uint8_t *t, size_t tLen)
Authenticated decryption using GCM. More...
 

Detailed Description

STM32L4 cipher hardware accelerator.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneCRYPTO Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
2.4.4

Definition in file stm32l4xx_crypto_cipher.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file stm32l4xx_crypto_cipher.c.

Function Documentation

◆ aesDecryptBlock()

void aesDecryptBlock ( AesContext context,
const uint8_t *  input,
uint8_t *  output 
)

Decrypt a 16-byte block using AES algorithm.

Parameters
[in]contextPointer to the AES context
[in]inputCiphertext block to decrypt
[out]outputPlaintext block resulting from decryption

Definition at line 365 of file stm32l4xx_crypto_cipher.c.

◆ aesEncryptBlock()

void aesEncryptBlock ( AesContext context,
const uint8_t *  input,
uint8_t *  output 
)

Encrypt a 16-byte block using AES algorithm.

Parameters
[in]contextPointer to the AES context
[in]inputPlaintext block to encrypt
[out]outputCiphertext block resulting from encryption

Definition at line 350 of file stm32l4xx_crypto_cipher.c.

◆ aesInit()

error_t aesInit ( AesContext context,
const uint8_t *  key,
size_t  keyLen 
)

Key expansion.

Parameters
[in]contextPointer to the AES context to initialize
[in]keyPointer to the key
[in]keyLenLength of the key
Returns
Error code

Definition at line 255 of file stm32l4xx_crypto_cipher.c.

◆ aesLoadKey()

void aesLoadKey ( AesContext context,
const uint32_t *  key 
)

Load AES key.

Parameters
[in]contextAES algorithm context
[in]keyPointer to the key

Definition at line 70 of file stm32l4xx_crypto_cipher.c.

◆ aesProcessData()

void aesProcessData ( AesContext context,
uint8_t *  iv,
const uint8_t *  input,
uint8_t *  output,
size_t  length,
uint32_t  mode 
)

Perform AES encryption or decryption.

Parameters
[in]contextAES algorithm context
[in,out]ivInitialization vector
[in]inputData to be encrypted/decrypted
[out]outputData resulting from the encryption/decryption process
[in]lengthTotal number of data bytes to be processed
[in]modeOperation mode

Definition at line 117 of file stm32l4xx_crypto_cipher.c.

◆ cbcDecrypt()

error_t cbcDecrypt ( const CipherAlgo cipher,
void *  context,
uint8_t *  iv,
const uint8_t *  c,
uint8_t *  p,
size_t  length 
)

CBC decryption.

Parameters
[in]cipherCipher algorithm
[in]contextCipher algorithm context
[in,out]ivInitialization vector
[in]cCiphertext to be decrypted
[out]pPlaintext resulting from the decryption
[in]lengthTotal number of data bytes to be decrypted
Returns
Error code

Definition at line 593 of file stm32l4xx_crypto_cipher.c.

◆ cbcEncrypt()

error_t cbcEncrypt ( const CipherAlgo cipher,
void *  context,
uint8_t *  iv,
const uint8_t *  p,
uint8_t *  c,
size_t  length 
)

CBC encryption.

Parameters
[in]cipherCipher algorithm
[in]contextCipher algorithm context
[in,out]ivInitialization vector
[in]pPlaintext to be encrypted
[out]cCiphertext resulting from the encryption
[in]lengthTotal number of data bytes to be encrypted
Returns
Error code

Definition at line 516 of file stm32l4xx_crypto_cipher.c.

◆ crypInit()

error_t crypInit ( void  )

CRYP module initialization.

Returns
Error code

Definition at line 54 of file stm32l4xx_crypto_cipher.c.

◆ ctrEncrypt()

error_t ctrEncrypt ( const CipherAlgo cipher,
void *  context,
uint_t  m,
uint8_t *  t,
const uint8_t *  p,
uint8_t *  c,
size_t  length 
)

CTR encryption.

Parameters
[in]cipherCipher algorithm
[in]contextCipher algorithm context
[in]mSize in bits of the specific part of the block to be incremented
[in,out]tInitial counter block
[in]pPlaintext to be encrypted
[out]cCiphertext resulting from the encryption
[in]lengthTotal number of data bytes to be encrypted
Returns
Error code

Definition at line 676 of file stm32l4xx_crypto_cipher.c.

◆ ecbDecrypt()

error_t ecbDecrypt ( const CipherAlgo cipher,
void *  context,
const uint8_t *  c,
uint8_t *  p,
size_t  length 
)

ECB decryption.

Parameters
[in]cipherCipher algorithm
[in]contextCipher algorithm context
[in]cCiphertext to be decrypted
[out]pPlaintext resulting from the decryption
[in]lengthTotal number of data bytes to be decrypted
Returns
Error code

Definition at line 449 of file stm32l4xx_crypto_cipher.c.

◆ ecbEncrypt()

error_t ecbEncrypt ( const CipherAlgo cipher,
void *  context,
const uint8_t *  p,
uint8_t *  c,
size_t  length 
)

ECB encryption.

Parameters
[in]cipherCipher algorithm
[in]contextCipher algorithm context
[in]pPlaintext to be encrypted
[out]cCiphertext resulting from the encryption
[in]lengthTotal number of data bytes to be encrypted
Returns
Error code

Definition at line 385 of file stm32l4xx_crypto_cipher.c.

◆ gcmDecrypt()

error_t gcmDecrypt ( GcmContext context,
const uint8_t *  iv,
size_t  ivLen,
const uint8_t *  a,
size_t  aLen,
const uint8_t *  c,
uint8_t *  p,
size_t  length,
const uint8_t *  t,
size_t  tLen 
)

Authenticated decryption using GCM.

Parameters
[in]contextPointer to the GCM context
[in]ivInitialization vector
[in]ivLenLength of the initialization vector
[in]aAdditional authenticated data
[in]aLenLength of the additional data
[in]cCiphertext to be decrypted
[out]pPlaintext resulting from the decryption
[in]lengthTotal number of data bytes to be decrypted
[in]tAuthentication tag
[in]tLenLength of the authentication tag
Returns
Error code

Make sure the GCM context is valid

Make sure the GCM context is valid

Definition at line 1167 of file stm32l4xx_crypto_cipher.c.

◆ gcmEncrypt()

error_t gcmEncrypt ( GcmContext context,
const uint8_t *  iv,
size_t  ivLen,
const uint8_t *  a,
size_t  aLen,
const uint8_t *  p,
uint8_t *  c,
size_t  length,
uint8_t *  t,
size_t  tLen 
)

Authenticated encryption using GCM.

Parameters
[in]contextPointer to the GCM context
[in]ivInitialization vector
[in]ivLenLength of the initialization vector
[in]aAdditional authenticated data
[in]aLenLength of the additional data
[in]pPlaintext to be encrypted
[out]cCiphertext resulting from the encryption
[in]lengthTotal number of data bytes to be encrypted
[out]tAuthentication tag
[in]tLenLength of the authentication tag
Returns
Error code

Definition at line 1122 of file stm32l4xx_crypto_cipher.c.

◆ gcmInit()

error_t gcmInit ( GcmContext context,
const CipherAlgo cipherAlgo,
void *  cipherContext 
)

Initialize GCM context.

Parameters
[in]contextPointer to the GCM context
[in]cipherAlgoCipher algorithm
[in]cipherContextPointer to the cipher algorithm context
Returns
Error code

Definition at line 1087 of file stm32l4xx_crypto_cipher.c.

◆ gcmProcessData()

void gcmProcessData ( AesContext context,
const uint8_t *  iv,
const uint8_t *  a,
size_t  aLen,
const uint8_t *  input,
uint8_t *  output,
size_t  length,
uint8_t *  t,
uint32_t  mode 
)

Perform AES-GCM encryption or decryption.

Parameters
[in]contextAES algorithm context
[in]ivInitialization vector
[in]aAdditional authenticated data
[in]aLenLength of the additional data
[in]inputData to be encrypted/decrypted
[out]outputData resulting from the encryption/decryption process
[in]lengthTotal number of data bytes to be processed
[out]tAuthentication tag
[in]modeOperation mode

Definition at line 779 of file stm32l4xx_crypto_cipher.c.