STM32U5 public-key hardware accelerator (PKA) More...

#include "stm32u5xx.h"
#include "stm32u5xx_hal.h"
#include "core/crypto.h"
#include "hardware/stm32u5xx/stm32u5xx_crypto.h"
#include "hardware/stm32u5xx/stm32u5xx_crypto_pkc.h"
#include "pkc/rsa.h"
#include "ecc/ec.h"
#include "ecc/ec_misc.h"
#include "ecc/ecdsa.h"
#include "debug.h"

Macros
#define	TRACE_LEVEL CRYPTO_TRACE_LEVEL

Functions
error_t	pkaInit (void)
	PKA module initialization. More...

void	pkaImportArray (const uint8_t *src, size_t srcLen, uint_t destLen, uint_t offset)
	Import byte array. More...

void	pkaImportScalar (const uint32_t *src, uint_t length, uint_t offset)
	Import scalar. More...

void	pkaImportMpi (const Mpi *src, uint_t length, uint_t offset)
	Import multiple-precision integer. More...

void	pkaExportScalar (uint32_t *dest, uint_t length, uint_t offset)
	Export scalar. More...

error_t	pkaExportMpi (Mpi *dest, uint_t length, uint_t offset)
	Export multiple-precision integer. More...

error_t	mpiExpMod (Mpi r, const Mpi a, const Mpi e, const Mpi p)
	Modular exponentiation. More...

error_t	pkaRsaCrtExp (const RsaPrivateKey key, const Mpi c, Mpi *m)
	Modular exponentiation with CRT. More...

error_t	rsadp (const RsaPrivateKey key, const Mpi c, Mpi *m)
	RSA decryption primitive. More...

error_t	ecMulFast (const EcCurve curve, EcPoint3 r, const uint32_t d, const EcPoint3 s)
	Scalar multiplication (fast calculation) More...

error_t	ecMulRegular (const EcCurve curve, EcPoint3 r, const uint32_t d, const EcPoint3 s)
	Scalar multiplication (regular calculation) More...

error_t	ecdsaGenerateSignature (const PrngAlgo prngAlgo, void prngContext, const EcPrivateKey privateKey, const uint8_t digest, size_t digestLen, EcdsaSignature *signature)
	ECDSA signature generation. More...

error_t	ecdsaVerifySignature (const EcPublicKey publicKey, const uint8_t digest, size_t digestLen, const EcdsaSignature *signature)
	ECDSA signature verification. More...

Detailed Description

STM32U5 public-key hardware accelerator (PKA)

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.5.0

Definition in file stm32u5xx_crypto_pkc.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL CRYPTO_TRACE_LEVEL

Definition at line 32 of file stm32u5xx_crypto_pkc.c.

Function Documentation

◆ ecdsaGenerateSignature()

error_t ecdsaGenerateSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const EcPrivateKey *	privateKey,
		const uint8_t *	digest,
		size_t	digestLen,
		EcdsaSignature *	signature
	)

ECDSA signature generation.

Parameters

[in]	prngAlgo	PRNG algorithm
[in]	prngContext	Pointer to the PRNG context
[in]	privateKey	Signer's EC private key
[in]	digest	Digest of the message to be signed
[in]	digestLen	Length in octets of the digest
[out]	signature	(R, S) integer pair

Returns: Error code

Definition at line 634 of file stm32u5xx_crypto_pkc.c.

◆ ecdsaVerifySignature()

error_t ecdsaVerifySignature	(	const EcPublicKey *	publicKey,
		const uint8_t *	digest,
		size_t	digestLen,
		const EcdsaSignature *	signature
	)

ECDSA signature verification.

Parameters

[in]	publicKey	Signer's EC public key
[in]	digest	Digest of the message whose signature is to be verified
[in]	digestLen	Length in octets of the digest
[in]	signature	(R, S) integer pair

Returns: Error code

Definition at line 767 of file stm32u5xx_crypto_pkc.c.

◆ ecMulFast()

error_t ecMulFast	(	const EcCurve *	curve,
		EcPoint3 *	r,
		const uint32_t *	d,
		const EcPoint3 *	s
	)

Scalar multiplication (fast calculation)

Parameters

[in]	curve	Elliptic curve parameters
[out]	r	Resulting point R = d.S
[in]	d	An integer d such as 0 <= d < p
[in]	s	EC point

Returns: Error code

Definition at line 502 of file stm32u5xx_crypto_pkc.c.

◆ ecMulRegular()

error_t ecMulRegular	(	const EcCurve *	curve,
		EcPoint3 *	r,
		const uint32_t *	d,
		const EcPoint3 *	s
	)

Scalar multiplication (regular calculation)

Parameters

[in]	curve	Elliptic curve parameters
[out]	r	Resulting point R = d.S
[in]	d	An integer d such as 0 <= d < q
[in]	s	EC point

Returns: Error code

Definition at line 519 of file stm32u5xx_crypto_pkc.c.

◆ mpiExpMod()

error_t mpiExpMod	(	Mpi *	r,
		const Mpi *	a,
		const Mpi *	e,
		const Mpi *	p
	)

Modular exponentiation.

Parameters

[out]	r	Resulting integer R = A ^ E mod P
[in]	a	Pointer to a multiple precision integer
[in]	e	Exponent
[in]	p	Modulus

Returns: Error code

Definition at line 291 of file stm32u5xx_crypto_pkc.c.

◆ pkaExportMpi()

error_t pkaExportMpi	(	Mpi *	dest,
		uint_t	length,
		uint_t	offset
	)

Export multiple-precision integer.

Parameters

[out]	dest	Pointer to the multiple-precision integer
[in]	length	Length of the operand, in bits
[in]	offset	PKA ram offset

Returns: Error code

Definition at line 239 of file stm32u5xx_crypto_pkc.c.

◆ pkaExportScalar()

void pkaExportScalar	(	uint32_t *	dest,
		uint_t	length,
		uint_t	offset
	)

Export scalar.

Parameters

[out]	dest	Pointer to the scalar
[in]	length	Length of the operand, in bits
[in]	offset	PKA ram offset

Definition at line 216 of file stm32u5xx_crypto_pkc.c.

◆ pkaImportArray()

void pkaImportArray	(	const uint8_t *	src,
		size_t	srcLen,
		uint_t	destLen,
		uint_t	offset
	)

Import byte array.

Parameters

[in]	src	Pointer to the byte array
[in]	srcLen	Length of the array to be copied, in bytes
[in]	destLen	Length of the operand, in bits
[in]	offset	PKA ram offset

Definition at line 85 of file stm32u5xx_crypto_pkc.c.

◆ pkaImportMpi()

void pkaImportMpi	(	const Mpi *	src,
		uint_t	length,
		uint_t	offset
	)

Import multiple-precision integer.

Parameters

[in]	src	Pointer to the multiple-precision integer
[in]	length	Length of the operand, in bits
[in]	offset	PKA ram offset

Definition at line 180 of file stm32u5xx_crypto_pkc.c.

◆ pkaImportScalar()

void pkaImportScalar	(	const uint32_t *	src,
		uint_t	length,
		uint_t	offset
	)

Import scalar.

Parameters

[in]	src	Pointer to the scalar
[in]	length	Length of the operand, in bits
[in]	offset	PKA ram offset

Definition at line 147 of file stm32u5xx_crypto_pkc.c.

◆ pkaInit()

error_t pkaInit ( void )

PKA module initialization.

Returns: Error code

Definition at line 55 of file stm32u5xx_crypto_pkc.c.

◆ pkaRsaCrtExp()

error_t pkaRsaCrtExp	(	const RsaPrivateKey *	key,
		const Mpi *	c,
		Mpi *	m
	)

Modular exponentiation with CRT.

Parameters

[in]	key	RSA public key
[in]	m	Message representative
[out]	c	Ciphertext representative

Returns: Error code

Definition at line 376 of file stm32u5xx_crypto_pkc.c.

◆ rsadp()

error_t rsadp	(	const RsaPrivateKey *	key,
		const Mpi *	c,
		Mpi *	m
	)

RSA decryption primitive.

Parameters

[in]	key	RSA private key
[in]	c	Ciphertext representative
[out]	m	Message representative

Returns: Error code

Definition at line 459 of file stm32u5xx_crypto_pkc.c.

Macros

Functions

Detailed Description

License

Macro Definition Documentation

◆ TRACE_LEVEL

Function Documentation

◆ ecdsaGenerateSignature()

◆ ecdsaVerifySignature()

◆ ecMulFast()

◆ ecMulRegular()

◆ mpiExpMod()

◆ pkaExportMpi()

◆ pkaExportScalar()

◆ pkaImportArray()

◆ pkaImportMpi()

◆ pkaImportScalar()

◆ pkaInit()

◆ pkaRsaCrtExp()

◆ rsadp()