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.
- 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] context Pointer to the AES context [in] input Ciphertext block to decrypt [out] output Plaintext 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] context Pointer to the AES context [in] input Plaintext block to encrypt [out] output Ciphertext 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] context Pointer to the AES context to initialize [in] key Pointer to the key [in] keyLen Length 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] context AES algorithm context [in] key Pointer 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] context AES algorithm context [in,out] iv Initialization vector [in] input Data to be encrypted/decrypted [out] output Data resulting from the encryption/decryption process [in] length Total number of data bytes to be processed [in] mode Operation 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] cipher Cipher algorithm [in] context Cipher algorithm context [in,out] iv Initialization vector [in] c Ciphertext to be decrypted [out] p Plaintext resulting from the decryption [in] length Total 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] cipher Cipher algorithm [in] context Cipher algorithm context [in,out] iv Initialization vector [in] p Plaintext to be encrypted [out] c Ciphertext resulting from the encryption [in] length Total 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] cipher Cipher algorithm [in] context Cipher algorithm context [in] m Size in bits of the specific part of the block to be incremented [in,out] t Initial counter block [in] p Plaintext to be encrypted [out] c Ciphertext resulting from the encryption [in] length Total 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] cipher Cipher algorithm [in] context Cipher algorithm context [in] c Ciphertext to be decrypted [out] p Plaintext resulting from the decryption [in] length Total 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] cipher Cipher algorithm [in] context Cipher algorithm context [in] p Plaintext to be encrypted [out] c Ciphertext resulting from the encryption [in] length Total 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] context Pointer to the GCM context [in] iv Initialization vector [in] ivLen Length of the initialization vector [in] a Additional authenticated data [in] aLen Length of the additional data [in] c Ciphertext to be decrypted [out] p Plaintext resulting from the decryption [in] length Total number of data bytes to be decrypted [in] t Authentication tag [in] tLen Length 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] context Pointer to the GCM context [in] iv Initialization vector [in] ivLen Length of the initialization vector [in] a Additional authenticated data [in] aLen Length of the additional data [in] p Plaintext to be encrypted [out] c Ciphertext resulting from the encryption [in] length Total number of data bytes to be encrypted [out] t Authentication tag [in] tLen Length 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] context Pointer to the GCM context [in] cipherAlgo Cipher algorithm [in] cipherContext Pointer 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] context AES algorithm context [in] iv Initialization vector [in] a Additional authenticated data [in] aLen Length of the additional data [in] input Data to be encrypted/decrypted [out] output Data resulting from the encryption/decryption process [in] length Total number of data bytes to be processed [out] t Authentication tag [in] mode Operation mode
Definition at line 779 of file stm32l4xx_crypto_cipher.c.