mbedTLS
Select one of the symbols to view example projects that use it.
 
Outline
#define _ESP_BIGNUM_H_
#include <mbedtls/bignum.h>
#include <stdbool.h>
#define ESP_MPI_USE_MONT_EXP
esp_mpi_enable_hardware_hw_op();
esp_mpi_disable_hardware_hw_op();
esp_mpi_hardware_words(size_t);
esp_mpi_mul_mpi_mod_hw_op(const mbedtls_mpi *, const mbedtls_mpi *, const mbedtls_mpi *, const mbedtls_mpi *, mbedtls_mpi_uint, size_t);
esp_mpi_mul_mpi_hw_op(const mbedtls_mpi *, const mbedtls_mpi *, size_t);
esp_mpi_mult_mpi_failover_mod_mult_hw_op(const mbedtls_mpi *, const mbedtls_mpi *, size_t);
esp_mpi_read_result_hw_op(mbedtls_mpi *, size_t);
esp_mont_hw_op(mbedtls_mpi *, const mbedtls_mpi *, const mbedtls_mpi *, const mbedtls_mpi *, mbedtls_mpi_uint, size_t, bool);
esp_mpi_interrupt_enable(bool);
esp_mpi_interrupt_clear();
Files
loading...
SourceVuESP-IDF Framework and ExamplesmbedTLSport/include/bignum_impl.h
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
#ifndef _ESP_BIGNUM_H_ #define _ESP_BIGNUM_H_ #include <mbedtls/bignum.h> #include <stdbool.h> /* Use montgomery exponentiation (HAC 14.94) for calculating X ^ Y mod M, this may be faster for some targets. The hardware acceleration support for modular exponentiation on the ESP32 is slow for public key operations, so use montgomery exponentiation instead. *//* ... */ #if CONFIG_IDF_TARGET_ESP32 #define ESP_MPI_USE_MONT_EXP #endif /** * @brief Enable the MPI hardware and acquire the lock * *//* ... */ void esp_mpi_enable_hardware_hw_op( void ); /** * @brief Disable the MPI hardware and release the lock * *//* ... */ void esp_mpi_disable_hardware_hw_op( void ); /** * @brief Calculate the number of words needed to represent the input word in hardware * * @param words The number of words to be represented * * @return size_t Number of words required *//* ... */ size_t esp_mpi_hardware_words(size_t words); /** * @brief Starts a (X * Y) Mod M calculation in hardware. Rinv and M_prime needs to be precalculated in software. * *//* ... */ void esp_mpi_mul_mpi_mod_hw_op(const mbedtls_mpi *X, const mbedtls_mpi *Y, const mbedtls_mpi *M, const mbedtls_mpi *Rinv, mbedtls_mpi_uint Mprime, size_t hw_words); /** * @brief Starts a (X * Y) calculation in hardware. * *//* ... */ void esp_mpi_mul_mpi_hw_op(const mbedtls_mpi *X, const mbedtls_mpi *Y, size_t num_words); /** * @brief Special-case of (X * Y), where we use hardware montgomery mod multiplication to calculate result where either A or B are >2048 bits so can't use the standard multiplication method. * *//* ... */ void esp_mpi_mult_mpi_failover_mod_mult_hw_op(const mbedtls_mpi *X, const mbedtls_mpi *Y, size_t num_words); /** * @brief Read out the result from the previous calculation. * *//* ... */ void esp_mpi_read_result_hw_op(mbedtls_mpi *Z, size_t z_words); #ifdef ESP_MPI_USE_MONT_EXP /** * @brief Starts a montgomery multiplication calculation in hardware * *//* ... */ int esp_mont_hw_op(mbedtls_mpi* Z, const mbedtls_mpi* X, const mbedtls_mpi* Y, const mbedtls_mpi* M, mbedtls_mpi_uint Mprime, size_t hw_words, bool again); /* ... */ #else /** * @brief Starts a (X ^ Y) Mod M calculation in hardware. Rinv and M_prime needs to be precalculated in software. * *//* ... */ void esp_mpi_exp_mpi_mod_hw_op(const mbedtls_mpi *X, const mbedtls_mpi *Y, const mbedtls_mpi *M, const mbedtls_mpi *Rinv, mbedtls_mpi_uint Mprime, size_t hw_words); /* ... */ #endif //ESP_MPI_USE_MONT_EXP /** * @brief Enable/disables MPI operation complete interrupt * * @param enable true: enable, false: disable *//* ... */ void esp_mpi_interrupt_enable( bool enable ); /** * @brief Clears the MPI operation complete interrupt status * *//* ... */ void esp_mpi_interrupt_clear( void ); /* ... */ #endif
Details
Show:
from
Types: Columns: