esp32_crypto_pkc.c File Reference

ESP32 public-key hardware accelerator. More...

#include "soc/hwcrypto_reg.h"
#include "soc/dport_access.h"
#include "esp_private/periph_ctrl.h"
#include "hardware/esp32/esp32_crypto.h"
#include "hardware/esp32/esp32_crypto_pkc.h"
#include "pkc/rsa.h"
#include "ecc/ec.h"
#include "ecc/ec_misc.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
void	esp32RsaInit (void)
	RSA module initialization. More...
error_t	mpiMul (Mpi *r, const Mpi *a, const Mpi *b)
	Multiple precision multiplication. More...
error_t	mpiExpMod (Mpi *r, const Mpi *a, const Mpi *e, const Mpi *p)
	Modular exponentiation. More...
void	ecScalarMul (uint32_t *rl, uint32_t *rh, const uint32_t *a, const uint32_t *b, uint_t n)
	Multiplication of two integers. More...
void	ecScalarSqr (uint32_t *r, const uint32_t *a, uint_t n)
	Squaring operation. More...

Detailed Description

ESP32 public-key hardware accelerator.

License

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

Copyright (C) 2010-2025 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.5.0

Definition in file esp32_crypto_pkc.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file esp32_crypto_pkc.c.

Function Documentation

ecScalarMul()

void ecScalarMul	(	uint32_t *	rl,
		uint32_t *	rh,
		const uint32_t *	a,
		const uint32_t *	b,
		uint_t	n
	)

Multiplication of two integers.

Parameters

[out]	rl	Low part of the result R = (A * B) mod (2^32)^n
[out]	rh	High part of the result R = (A * B) / (2^32)^n
[in]	a	An integer such as 0 <= A < (2^32)^n
[in]	b	An integer such as 0 <= B < (2^32)^n
[in]	n	Size of the operands, in words

Definition at line 392 of file esp32_crypto_pkc.c.

ecScalarSqr()

void ecScalarSqr	(	uint32_t *	r,
		const uint32_t *	a,
		uint_t	n
	)

Squaring operation.

Parameters

[out]	r	Result R = A ^ 2
[in]	a	An integer such as 0 <= A < (2^32)^n
[in]	n	Size of the integer A, in words

Definition at line 492 of file esp32_crypto_pkc.c.

esp32RsaInit()

void esp32RsaInit

(

void

)

RSA module initialization.

Definition at line 53 of file esp32_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 204 of file esp32_crypto_pkc.c.

mpiMul()

error_t mpiMul	(	Mpi *	r,
		const Mpi *	a,
		const Mpi *	b
	)

Multiple precision multiplication.

Parameters

[out]	r	Resulting integer R = A * B
[in]	a	First operand A
[in]	b	Second operand B

Returns

Error code

Definition at line 77 of file esp32_crypto_pkc.c.