1 /***************************************************************************//**
2 * \file cy_crypto_core_sha_v1.h
3 * \version 2.120
4 *
5 * \brief
6 *  This file provides constants and function prototypes
7 *  for the API for the SHA method in the Crypto block driver.
8 *
9 ********************************************************************************
10 * \copyright
11 * Copyright (c) (2020-2022), Cypress Semiconductor Corporation (an Infineon company) or
12 * an affiliate of Cypress Semiconductor Corporation.
13 * SPDX-License-Identifier: Apache-2.0
14 *
15 * Licensed under the Apache License, Version 2.0 (the "License");
16 * you may not use this file except in compliance with the License.
17 * You may obtain a copy of the License at
18 *
19 *    http://www.apache.org/licenses/LICENSE-2.0
20 *
21 * Unless required by applicable law or agreed to in writing, software
22 * distributed under the License is distributed on an "AS IS" BASIS,
23 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
24 * See the License for the specific language governing permissions and
25 * limitations under the License.
26 *******************************************************************************/
27 
28 
29 #if !defined (CY_CRYPTO_CORE_SHA_V1_H)
30 #define CY_CRYPTO_CORE_SHA_V1_H
31 
32 #include "cy_crypto_common.h"
33 
34 #if defined(CY_IP_MXCRYPTO) && defined(CY_CRYPTO_CFG_HW_V1_ENABLE)
35 
36 #if defined(__cplusplus)
37 extern "C" {
38 #endif
39 
40 #if (CPUSS_CRYPTO_SHA == 1) && defined(CY_CRYPTO_CFG_SHA_C)
41 
42 /** \cond INTERNAL */
43 
44 #if (CPUSS_CRYPTO_SHA1 == 1) && defined(CY_CRYPTO_CFG_SHA1_ENABLED)
45 typedef struct
46 {
47     /* Allocates CRYPTO_MAX_BLOCK_SIZE Bytes for the block. */
48     uint32_t block[CY_CRYPTO_SHA1_BLOCK_SIZE / 4u];
49 
50     /* Allocates CRYPTO_MAX_HASH_SIZE Bytes for the hash. */
51     uint32_t hash[CY_CRYPTO_SHA1_HASH_SIZE / 4u];
52 
53     /* Allocates CRYPTO_MAX_ROUND_MEM_SIZE Bytes for roundMem. */
54     uint32_t roundMem[CY_CRYPTO_SHA1_ROUND_MEM_SIZE / 4u];
55 } cy_stc_crypto_v1_sha1_buffers_t;
56 #endif /* (CPUSS_CRYPTO_SHA1 == 1) && defined(CY_CRYPTO_CFG_SHA1_ENABLED) */
57 
58 #if (CPUSS_CRYPTO_SHA256 == 1) && defined(CY_CRYPTO_CFG_SHA2_256_ENABLED)
59 typedef struct
60 {
61     /* Allocates CRYPTO_MAX_BLOCK_SIZE Bytes for the block. */
62     uint32_t block[CY_CRYPTO_SHA256_BLOCK_SIZE / 4u];
63 
64     /* Allocates CRYPTO_MAX_HASH_SIZE Bytes for the hash. */
65     uint32_t hash[CY_CRYPTO_SHA256_HASH_SIZE / 4u];
66 
67     /* Allocates CRYPTO_MAX_ROUND_MEM_SIZE Bytes for roundMem. */
68     uint32_t roundMem[CY_CRYPTO_SHA256_ROUND_MEM_SIZE / 4u];
69 } cy_stc_crypto_v1_sha256_buffers_t;
70 #endif /* (CPUSS_CRYPTO_SHA256 == 1) && defined(CY_CRYPTO_CFG_SHA2_256_ENABLED) */
71 
72 #if (CPUSS_CRYPTO_SHA512 == 1) && defined(CY_CRYPTO_CFG_SHA2_512_ENABLED)
73 typedef struct
74 {
75     /* Allocates CRYPTO_MAX_BLOCK_SIZE Bytes for the block. */
76     uint32_t block[CY_CRYPTO_SHA512_BLOCK_SIZE / 4u];
77 
78     /* Allocates CRYPTO_MAX_HASH_SIZE Bytes for the hash. */
79     uint32_t hash[CY_CRYPTO_SHA512_HASH_SIZE / 4u];
80 
81     /* Allocates CRYPTO_MAX_ROUND_MEM_SIZE Bytes for roundMem. */
82     uint32_t roundMem[CY_CRYPTO_SHA512_ROUND_MEM_SIZE / 4u];
83 } cy_stc_crypto_v1_sha512_buffers_t;
84 #endif /* (CPUSS_CRYPTO_SHA512 == 1) && defined(CY_CRYPTO_CFG_SHA2_512_ENABLED) */
85 
86 typedef struct
87 {
88     /* Allocates CRYPTO_MAX_BLOCK_SIZE Bytes for the block. */
89     uint32_t block[CY_CRYPTO_SHA_MAX_BLOCK_SIZE / 4u];
90 
91     /* Allocates CRYPTO_MAX_HASH_SIZE Bytes for the hash. */
92     uint32_t hash[CY_CRYPTO_SHA_MAX_HASH_SIZE / 4u];
93 
94     /* Allocates CRYPTO_MAX_ROUND_MEM_SIZE Bytes for roundMem. */
95     uint32_t roundMem[CY_CRYPTO_SHA_MAX_ROUND_MEM_SIZE / 4u];
96 } cy_stc_crypto_v1_sha_buffers_t;
97 
98 void Cy_Crypto_Core_V1_Sha_ProcessBlock(CRYPTO_Type *base,
99                                 cy_stc_crypto_sha_state_t *hashState,
100                                 uint8_t const *block);
101 
102 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha_Init(CRYPTO_Type *base,
103                                 cy_stc_crypto_sha_state_t *hashState,
104                                 cy_en_crypto_sha_mode_t mode,
105                                 void *shaBuffers);
106 
107 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha_Start(CRYPTO_Type *base,
108                                 cy_stc_crypto_sha_state_t *hashState);
109 
110 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha_Update(CRYPTO_Type *base,
111                                 cy_stc_crypto_sha_state_t *hashState,
112                                 uint8_t const *message,
113                                 uint32_t messageSize);
114 
115 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha_Finish(CRYPTO_Type *base,
116                                 cy_stc_crypto_sha_state_t *hashState,
117                                 uint8_t *digest);
118 
119 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha_Free(CRYPTO_Type *base,
120                                 cy_stc_crypto_sha_state_t *hashState);
121 
122 cy_en_crypto_status_t Cy_Crypto_Core_V1_Sha(CRYPTO_Type *base,
123                                 uint8_t const *message,
124                                 uint32_t  messageSize,
125                                 uint8_t *digest,
126                                 cy_en_crypto_sha_mode_t mode);
127 
128 /** \endcond */
129 
130 #endif /* (CPUSS_CRYPTO_SHA == 1) && defined(CY_CRYPTO_CFG_SHA_C) */
131 
132 #if defined(__cplusplus)
133 }
134 #endif
135 
136 #endif /* defined(CY_IP_MXCRYPTO) && defined(CY_CRYPTO_CFG_HW_V1_ENABLE) */
137 
138 #endif /* #if !defined (CY_CRYPTO_CORE_SHA_H) */
139 
140 
141 /* [] END OF FILE */
142