ESP-IDF
Select one of the symbols to view example projects that use it.
 
Outline
#include "hal/sha_hal.h"
#include "hal/sha_types.h"
#include "hal/sha_ll.h"
#include "soc/soc_caps.h"
#include <stdlib.h>
#include <stdio.h>
#define SHA1_STATE_LEN_WORDS
#define SHA256_STATE_LEN_WORDS
#define SHA512_STATE_LEN_WORDS
state_length(esp_sha_type)
sha_hal_hash_block(esp_sha_type, const void *, size_t, bool)
sha_hal_wait_idle()
sha_hal_read_digest(esp_sha_type, void *)
Files
loading...
SourceVuESP-IDF Framework and ExamplesESP-IDFcomponents/hal/sha_hal.c
 
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/* * SPDX-FileCopyrightText: 2020-2023 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: Apache-2.0 *//* ... */ // The HAL layer for SHA #include "hal/sha_hal.h" #include "hal/sha_types.h" #include "hal/sha_ll.h" #include "soc/soc_caps.h" #include <stdlib.h> #include <stdio.h>6 includes #define SHA1_STATE_LEN_WORDS (160 / 32) #define SHA256_STATE_LEN_WORDS (256 / 32) #define SHA512_STATE_LEN_WORDS (512 / 32) #if CONFIG_IDF_TARGET_ESP32 /* Return state size (in words) for a given SHA type */ inline static size_t state_length(esp_sha_type type) { switch (type) { case SHA1: return SHA1_STATE_LEN_WORDS;... case SHA2_256: return SHA256_STATE_LEN_WORDS;... case SHA2_384: case SHA2_512: return SHA512_STATE_LEN_WORDS;... default: return 0;... }{...} }{ ... } /* ... */#else /* Return state size (in words) for a given SHA type */ inline static size_t state_length(esp_sha_type type) { switch (type) { case SHA1: return SHA1_STATE_LEN_WORDS;... case SHA2_224: case SHA2_256: return SHA256_STATE_LEN_WORDS; #if SOC_SHA_SUPPORT_SHA384... case SHA2_384: return SHA512_STATE_LEN_WORDS;/* ... */ #endif #if SOC_SHA_SUPPORT_SHA512 case SHA2_512: return SHA512_STATE_LEN_WORDS;/* ... */ #endif #if SOC_SHA_SUPPORT_SHA512_T case SHA2_512224: case SHA2_512256: case SHA2_512T: return SHA512_STATE_LEN_WORDS;/* ... */ #endif default: return 0;... }{...} }{...} /* ... */#endif /* Hash a single block */ void sha_hal_hash_block(esp_sha_type sha_type, const void *data_block, size_t block_word_len, bool first_block) { sha_hal_wait_idle(); sha_ll_fill_text_block(data_block, block_word_len); /* Start hashing */ if (first_block) { sha_ll_start_block(sha_type); }{...} else { sha_ll_continue_block(sha_type); }{...} }{ ... } #if SOC_SHA_SUPPORT_DMA /* Hashes a number of message blocks using DMA */ void sha_hal_hash_dma(esp_sha_type sha_type, size_t num_blocks, bool first_block) { sha_hal_wait_idle(); sha_ll_set_block_num(num_blocks); /* Start hashing */ if (first_block) { sha_ll_start_dma(sha_type); }{...} else { sha_ll_continue_dma(sha_type); }{...} }{...} /* ... */ #endif //SOC_SHA_SUPPORT_DMA void sha_hal_wait_idle() { while (sha_ll_busy()) { }{...} }{ ... } /* Reads the current message digest from the SHA engine */ void sha_hal_read_digest(esp_sha_type sha_type, void *digest_state) { uint32_t *digest_state_words = (uint32_t *)digest_state; sha_ll_load(sha_type); uint32_t word_len = state_length(sha_type); sha_hal_wait_idle(); sha_ll_read_digest(sha_type, digest_state, word_len); /* Fault injection check: verify SHA engine actually ran, state is not all zeroes. *//* ... */ for (size_t i = 0; i < word_len; i++) { if (digest_state_words[i] != 0) { return; }{...} }{...} abort(); // SHA peripheral returned all zero state, probably due to fault injection }{ ... } #if SOC_SHA_SUPPORT_RESUME /* Writes the message digest to the SHA engine */ void sha_hal_write_digest(esp_sha_type sha_type, void *digest_state) { sha_ll_write_digest(sha_type, digest_state, state_length(sha_type)); }{...} /* ... */#endif //SOC_SHA_SUPPORT_RESUME #if SOC_SHA_SUPPORT_SHA512_T /* Calculates and sets the initial digiest for SHA512_t */ void sha_hal_sha512_init_hash(uint32_t t_string, uint8_t t_len) { sha_ll_t_string_set(t_string); sha_ll_t_len_set(t_len); sha_ll_start_block(SHA2_512T); sha_hal_wait_idle(); }{...} /* ... */#endif //SOC_SHA_SUPPORT_SHA512_T
Details
Show:
from
Types: Columns: