GD32W5 public-key hardware accelerator (PKCAU) More...

#include "gd32w51x.h"
#include "core/crypto.h"
#include "hardware/gd32w5xx/gd32w5xx_crypto.h"
#include "hardware/gd32w5xx/gd32w5xx_crypto_pkc.h"
#include "pkc/rsa.h"
#include "ecc/ec.h"
#include "ecc/ecdsa.h"
#include "ecc/curve25519.h"
#include "ecc/curve448.h"
#include "debug.h"

Macros
#define	TRACE_LEVEL CRYPTO_TRACE_LEVEL

Functions
error_t	pkcauInit (void)
	PKCAU module initialization. More...

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

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

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

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

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

error_t	rsaep (const RsaPublicKey key, const Mpi m, Mpi *c)
	RSA encryption primitive. More...

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

error_t	ecMult (const EcDomainParameters params, EcPoint r, const Mpi d, const EcPoint s)
	Scalar multiplication. More...

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

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

void	curve25519Mul (uint32_t r, const uint32_t a, const uint32_t *b)
	Modular multiplication. More...

void	curve448Mul (uint32_t r, const uint32_t a, const uint32_t *b)
	Modular multiplication. More...

Detailed Description

GD32W5 public-key hardware accelerator (PKCAU)

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

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL CRYPTO_TRACE_LEVEL

Definition at line 32 of file gd32w5xx_crypto_pkc.c.

Function Documentation

◆ curve25519Mul()

void curve25519Mul	(	uint32_t *	r,
		const uint32_t *	a,
		const uint32_t *	b
	)

Modular multiplication.

Parameters

[out]	r	Resulting integer R = (A * B) mod p
[in]	a	An integer such as 0 <= A < p
[in]	b	An integer such as 0 <= B < p

Definition at line 847 of file gd32w5xx_crypto_pkc.c.

◆ curve448Mul()

void curve448Mul	(	uint32_t *	r,
		const uint32_t *	a,
		const uint32_t *	b
	)

Modular multiplication.

Parameters

[out]	r	Resulting integer R = (A * B) mod p
[in]	a	An integer such as 0 <= A < p
[in]	b	An integer such as 0 <= B < p

Definition at line 969 of file gd32w5xx_crypto_pkc.c.

◆ ecdsaGenerateSignature()

error_t ecdsaGenerateSignature	(	const PrngAlgo *	prngAlgo,
		void *	prngContext,
		const EcDomainParameters *	params,
		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]	params	EC domain parameters
[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 608 of file gd32w5xx_crypto_pkc.c.

◆ ecdsaVerifySignature()

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

ECDSA signature verification.

Parameters

[in]	params	EC domain 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 733 of file gd32w5xx_crypto_pkc.c.

◆ ecMult()

error_t ecMult	(	const EcDomainParameters *	params,
		EcPoint *	r,
		const Mpi *	d,
		const EcPoint *	s
	)

Scalar multiplication.

Parameters

[in]	params	EC domain 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 512 of file gd32w5xx_crypto_pkc.c.

◆ pkcauExportMpi()

error_t pkcauExportMpi	(	Mpi *	r,
		uint_t	length,
		uint_t	offset
	)

Export multiple-precision integer.

Parameters

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

Returns: Error code

Definition at line 182 of file gd32w5xx_crypto_pkc.c.

◆ pkcauImportArray()

void pkcauImportArray	(	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	PKCAU ram offset

Definition at line 85 of file gd32w5xx_crypto_pkc.c.

◆ pkcauImportMpi()

void pkcauImportMpi	(	const Mpi *	a,
		uint_t	length,
		uint_t	offset
	)

Import multiple-precision integer.

Parameters

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

Definition at line 146 of file gd32w5xx_crypto_pkc.c.

◆ pkcauInit()

error_t pkcauInit ( void )

PKCAU module initialization.

Returns: Error code

Definition at line 55 of file gd32w5xx_crypto_pkc.c.

◆ pkcauModExp()

error_t pkcauModExp	(	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 232 of file gd32w5xx_crypto_pkc.c.

◆ pkcauRsaCrtExp()

error_t pkcauRsaCrtExp	(	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 312 of file gd32w5xx_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 471 of file gd32w5xx_crypto_pkc.c.

◆ rsaep()

error_t rsaep	(	const RsaPublicKey *	key,
		const Mpi *	m,
		Mpi *	c
	)

RSA encryption primitive.

Parameters

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

Returns: Error code

Definition at line 441 of file gd32w5xx_crypto_pkc.c.

Macros

Functions

Detailed Description

License

Macro Definition Documentation

◆ TRACE_LEVEL

Function Documentation

◆ curve25519Mul()

◆ curve448Mul()

◆ ecdsaGenerateSignature()

◆ ecdsaVerifySignature()

◆ ecMult()

◆ pkcauExportMpi()

◆ pkcauImportArray()

◆ pkcauImportMpi()

◆ pkcauInit()

◆ pkcauModExp()

◆ pkcauRsaCrtExp()

◆ rsadp()

◆ rsaep()