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
/**
* \file
* \brief Wrapper API for software SHA 256 routines
*
* \copyright (c) 2015-2020 Microchip Technology Inc. and its subsidiaries.
*
* \page License
*
* Subject to your compliance with these terms, you may use Microchip software
* and any derivatives exclusively with Microchip products. It is your
* responsibility to comply with third party license terms applicable to your
* use of third party software (including open source software) that may
* accompany Microchip software.
*
* THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER
* EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED
* WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A
* PARTICULAR PURPOSE. IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT,
* SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE
* OF ANY KIND WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF
* MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE
* FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL
* LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED
* THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR
* THIS SOFTWARE.
*/
/** \brief initializes the SHA256 software
* \param[in] ctx ptr to context data structure
* \return ATCA_SUCCESS on success, otherwise an error code.
*/
int
/** \brief updates the running hash with the next block of data, called iteratively for the entire
stream of data to be hashed using the SHA256 software
\param[in] ctx ptr to SHA context data structure
\param[in] data ptr to next block of data to hash
\param[in] data_size size amount of data to hash in the given block, in bytes
\return ATCA_SUCCESS
*/
int
/** \brief completes the final SHA256 calculation and returns the final digest/hash
* \param[in] ctx ptr to context data structure
* \param[out] digest receives the computed digest of the SHA 256
* \return ATCA_SUCCESS
*/
int
/** \brief single call convenience function which computes Hash of given data using SHA256 software
* \param[in] data pointer to stream of data to hash
* \param[in] data_size size of data stream to hash
* \param[out] digest result
* \return ATCA_SUCCESS on success, otherwise an error code.
*/
int