SAM9X60 cipher hardware accelerator. More...

#include "sam.h"
#include "core/crypto.h"
#include "hardware/sam9x6/sam9x6_crypto.h"
#include "hardware/sam9x6/sam9x6_crypto_cipher.h"
#include "cipher/cipher_algorithms.h"
#include "cipher_modes/cipher_modes.h"
#include "aead/aead_algorithms.h"
#include "debug.h"

Macros
#define	TRACE_LEVEL CRYPTO_TRACE_LEVEL

Functions
void	desProcessDataBlock (const uint8_t input, uint8_t output)
	Encrypt/decrypt a 16-byte block using DES algorithm. More...

void	desProcessData (DesContext context, uint8_t iv, const uint8_t input, uint8_t output, size_t length, uint32_t mode)
	Perform DES encryption or decryption. More...

error_t	desInit (DesContext context, const uint8_t key, size_t keyLen)
	Initialize a DES context using the supplied key. More...

void	desEncryptBlock (DesContext context, const uint8_t input, uint8_t *output)
	Encrypt a 8-byte block using DES algorithm. More...

void	desDecryptBlock (DesContext context, const uint8_t input, uint8_t *output)
	Decrypt a 8-byte block using DES algorithm. More...

void	des3ProcessData (Des3Context context, uint8_t iv, const uint8_t input, uint8_t output, size_t length, uint32_t mode)
	Perform Triple DES encryption or decryption. More...

error_t	des3Init (Des3Context context, const uint8_t key, size_t keyLen)
	Initialize a Triple DES context using the supplied key. More...

void	des3EncryptBlock (Des3Context context, const uint8_t input, uint8_t *output)
	Encrypt a 8-byte block using Triple DES algorithm. More...

void	des3DecryptBlock (Des3Context context, const uint8_t input, uint8_t *output)
	Decrypt a 8-byte block using Triple DES algorithm. More...

void	xteaProcessDataBlock (const uint8_t input, uint8_t output)
	Encrypt/decrypt a 16-byte block using XTEA algorithm. More...

void	xteaProcessData (XteaContext context, uint8_t iv, const uint8_t input, uint8_t output, size_t length, uint32_t mode)
	Perform XTEA encryption or decryption. More...

error_t	xteaInit (XteaContext context, const uint8_t key, size_t keyLen)
	Initialize a XTEA context using the supplied key. More...

void	xteaEncryptBlock (XteaContext context, const uint8_t input, uint8_t *output)
	Encrypt a 8-byte block using XTEA algorithm. More...

void	xteaDecryptBlock (XteaContext context, const uint8_t input, uint8_t *output)
	Decrypt a 8-byte block using XTEA algorithm. More...

void	aesLoadKey (AesContext *context)
	Load AES key. More...

void	aesProcessDataBlock (const uint8_t input, uint8_t output)
	Encrypt/decrypt a 16-byte block using AES algorithm. 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	cfbEncrypt (const CipherAlgo cipher, void context, uint_t s, uint8_t iv, const uint8_t p, uint8_t *c, size_t length)
	CFB encryption. More...

error_t	cfbDecrypt (const CipherAlgo cipher, void context, uint_t s, uint8_t iv, const uint8_t c, uint8_t *p, size_t length)
	CFB decryption. More...

error_t	ofbEncrypt (const CipherAlgo cipher, void context, uint_t s, uint8_t iv, const uint8_t p, uint8_t *c, size_t length)
	OFB encryption. More...

void	gcmUpdateGhash (const uint8_t *data)
	Update GHASH value. 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

SAM9X60 cipher hardware accelerator.

License

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

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 sam9x6_crypto_cipher.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL CRYPTO_TRACE_LEVEL

Definition at line 32 of file sam9x6_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 746 of file sam9x6_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 731 of file sam9x6_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 688 of file sam9x6_crypto_cipher.c.

◆ aesLoadKey()

void aesLoadKey ( AesContext * context )

Load AES key.

Parameters

[in] context AES algorithm context

Definition at line 527 of file sam9x6_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]	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 623 of file sam9x6_crypto_cipher.c.

◆ aesProcessDataBlock()

void aesProcessDataBlock	(	const uint8_t *	input,
		uint8_t *	output
	)

Encrypt/decrypt a 16-byte block using AES algorithm.

Parameters

[in]	input	Input block to be encrypted/decrypted
[out]	output	Resulting block

Definition at line 583 of file sam9x6_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 1198 of file sam9x6_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 1037 of file sam9x6_crypto_cipher.c.

◆ cfbDecrypt()

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

CFB decryption.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	s	Size of the plaintext and ciphertext segments
[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 1558 of file sam9x6_crypto_cipher.c.

◆ cfbEncrypt()

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

CFB encryption.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	s	Size of the plaintext and ciphertext segments
[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 1381 of file sam9x6_crypto_cipher.c.

◆ des3DecryptBlock()

void des3DecryptBlock	(	Des3Context *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Decrypt a 8-byte block using Triple DES algorithm.

Parameters

[in]	context	Pointer to the Triple DES context
[in]	input	Ciphertext block to decrypt
[out]	output	Plaintext block resulting from decryption

Definition at line 351 of file sam9x6_crypto_cipher.c.

◆ des3EncryptBlock()

void des3EncryptBlock	(	Des3Context *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Encrypt a 8-byte block using Triple DES algorithm.

Parameters

[in]	context	Pointer to the Triple DES context
[in]	input	Plaintext block to encrypt
[out]	output	Ciphertext block resulting from encryption

Definition at line 336 of file sam9x6_crypto_cipher.c.

◆ des3Init()

error_t des3Init	(	Des3Context *	context,
		const uint8_t *	key,
		size_t	keyLen
	)

Initialize a Triple DES context using the supplied key.

Parameters

[in]	context	Pointer to the Triple DES context to initialize
[in]	key	Pointer to the key
[in]	keyLen	Length of the key

Returns: Error code

Definition at line 286 of file sam9x6_crypto_cipher.c.

◆ des3ProcessData()

void des3ProcessData	(	Des3Context *	context,
		uint8_t *	iv,
		const uint8_t *	input,
		uint8_t *	output,
		size_t	length,
		uint32_t	mode
	)

Perform Triple DES encryption or decryption.

Parameters

[in]	context	DES 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 216 of file sam9x6_crypto_cipher.c.

◆ desDecryptBlock()

void desDecryptBlock	(	DesContext *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Decrypt a 8-byte block using DES algorithm.

Parameters

[in]	context	Pointer to the DES context
[in]	input	Ciphertext block to decrypt
[out]	output	Plaintext block resulting from decryption

Definition at line 196 of file sam9x6_crypto_cipher.c.

◆ desEncryptBlock()

void desEncryptBlock	(	DesContext *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Encrypt a 8-byte block using DES algorithm.

Parameters

[in]	context	Pointer to the DES context
[in]	input	Plaintext block to encrypt
[out]	output	Ciphertext block resulting from encryption

Definition at line 181 of file sam9x6_crypto_cipher.c.

◆ desInit()

error_t desInit	(	DesContext *	context,
		const uint8_t *	key,
		size_t	keyLen
	)

Initialize a DES context using the supplied key.

Parameters

[in]	context	Pointer to the DES context to initialize
[in]	key	Pointer to the key
[in]	keyLen	Length of the key (must be set to 8)

Returns: Error code

Definition at line 156 of file sam9x6_crypto_cipher.c.

◆ desProcessData()

void desProcessData	(	DesContext *	context,
		uint8_t *	iv,
		const uint8_t *	input,
		uint8_t *	output,
		size_t	length,
		uint32_t	mode
	)

Perform DES encryption or decryption.

Parameters

[in]	context	DES 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 90 of file sam9x6_crypto_cipher.c.

◆ desProcessDataBlock()

void desProcessDataBlock	(	const uint8_t *	input,
		uint8_t *	output
	)

Encrypt/decrypt a 16-byte block using DES algorithm.

Parameters

[in]	input	Input block to be encrypted/decrypted
[out]	output	Resulting block

Definition at line 54 of file sam9x6_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 902 of file sam9x6_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 766 of file sam9x6_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

Definition at line 2163 of file sam9x6_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 2118 of file sam9x6_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 2083 of file sam9x6_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 1941 of file sam9x6_crypto_cipher.c.

◆ gcmUpdateGhash()

void gcmUpdateGhash ( const uint8_t * data )

Update GHASH value.

Parameters

[in] data Input block of data

Definition at line 1909 of file sam9x6_crypto_cipher.c.

◆ ofbEncrypt()

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

OFB encryption.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	s	Size of the plaintext and ciphertext segments
[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 1737 of file sam9x6_crypto_cipher.c.

◆ xteaDecryptBlock()

void xteaDecryptBlock	(	XteaContext *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Decrypt a 8-byte block using XTEA algorithm.

Decrypt a 16-byte block using XTEA algorithm.

Parameters

[in]	context	Pointer to the XTEA context
[in]	input	Ciphertext block to decrypt
[out]	output	Plaintext block resulting from decryption

Definition at line 512 of file sam9x6_crypto_cipher.c.

◆ xteaEncryptBlock()

void xteaEncryptBlock	(	XteaContext *	context,
		const uint8_t *	input,
		uint8_t *	output
	)

Encrypt a 8-byte block using XTEA algorithm.

Encrypt a 16-byte block using XTEA algorithm.

Parameters

[in]	context	Pointer to the XTEA context
[in]	input	Plaintext block to encrypt
[out]	output	Ciphertext block resulting from encryption

Definition at line 497 of file sam9x6_crypto_cipher.c.

◆ xteaInit()

error_t xteaInit	(	XteaContext *	context,
		const uint8_t *	key,
		size_t	keyLen
	)

Initialize a XTEA context using the supplied key.

Key expansion.

Parameters

[in]	context	Pointer to the XTEA context to initialize
[in]	key	Pointer to the key
[in]	keyLen	Length of the key (must be set to 16)

Returns: Error code

Definition at line 472 of file sam9x6_crypto_cipher.c.

◆ xteaProcessData()

void xteaProcessData	(	XteaContext *	context,
		uint8_t *	iv,
		const uint8_t *	input,
		uint8_t *	output,
		size_t	length,
		uint32_t	mode
	)

Perform XTEA encryption or decryption.

Parameters

[in]	context	XTEA 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 401 of file sam9x6_crypto_cipher.c.

◆ xteaProcessDataBlock()

void xteaProcessDataBlock	(	const uint8_t *	input,
		uint8_t *	output
	)

Encrypt/decrypt a 16-byte block using XTEA algorithm.

Parameters

[in]	input	Input block to be encrypted/decrypted
[out]	output	Resulting block

Definition at line 367 of file sam9x6_crypto_cipher.c.

Macros

Functions

Detailed Description

License

Macro Definition Documentation

◆ TRACE_LEVEL

Function Documentation

◆ aesDecryptBlock()

◆ aesEncryptBlock()

◆ aesInit()

◆ aesLoadKey()

◆ aesProcessData()

◆ aesProcessDataBlock()

◆ cbcDecrypt()

◆ cbcEncrypt()

◆ cfbDecrypt()

◆ cfbEncrypt()

◆ des3DecryptBlock()

◆ des3EncryptBlock()

◆ des3Init()

◆ des3ProcessData()

◆ desDecryptBlock()

◆ desEncryptBlock()

◆ desInit()

◆ desProcessData()

◆ desProcessDataBlock()

◆ ecbDecrypt()

◆ ecbEncrypt()

◆ gcmDecrypt()

◆ gcmEncrypt()

◆ gcmInit()

◆ gcmProcessData()

◆ gcmUpdateGhash()

◆ ofbEncrypt()

◆ xteaDecryptBlock()

◆ xteaEncryptBlock()

◆ xteaInit()

◆ xteaProcessData()

◆ xteaProcessDataBlock()