PHung Tung / SRC_STM32F7

SPKT

Dependents:   WAV

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_cryp_ex.h@0:e87aa4c49e95, 2019-06-04 (annotated)

Committer:
phungductung
Date:
Tue Jun 04 21:51:46 2019 +0000
Revision:
0:e87aa4c49e95
libray

Who changed what in which revision?

UserRevisionLine numberNew contents of line
phungductung 0:e87aa4c49e95 1 /**
phungductung 0:e87aa4c49e95 2 ******************************************************************************
phungductung 0:e87aa4c49e95 3 * @file stm32f7xx_hal_cryp_ex.h
phungductung 0:e87aa4c49e95 4 * @author MCD Application Team
phungductung 0:e87aa4c49e95 5 * @version V1.0.4
phungductung 0:e87aa4c49e95 6 * @date 09-December-2015
phungductung 0:e87aa4c49e95 7 * @brief Header file of CRYP HAL Extension module.
phungductung 0:e87aa4c49e95 8 ******************************************************************************
phungductung 0:e87aa4c49e95 9 * @attention
phungductung 0:e87aa4c49e95 10 *
phungductung 0:e87aa4c49e95 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
phungductung 0:e87aa4c49e95 12 *
phungductung 0:e87aa4c49e95 13 * Redistribution and use in source and binary forms, with or without modification,
phungductung 0:e87aa4c49e95 14 * are permitted provided that the following conditions are met:
phungductung 0:e87aa4c49e95 15 * 1. Redistributions of source code must retain the above copyright notice,
phungductung 0:e87aa4c49e95 16 * this list of conditions and the following disclaimer.
phungductung 0:e87aa4c49e95 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
phungductung 0:e87aa4c49e95 18 * this list of conditions and the following disclaimer in the documentation
phungductung 0:e87aa4c49e95 19 * and/or other materials provided with the distribution.
phungductung 0:e87aa4c49e95 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
phungductung 0:e87aa4c49e95 21 * may be used to endorse or promote products derived from this software
phungductung 0:e87aa4c49e95 22 * without specific prior written permission.
phungductung 0:e87aa4c49e95 23 *
phungductung 0:e87aa4c49e95 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
phungductung 0:e87aa4c49e95 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
phungductung 0:e87aa4c49e95 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
phungductung 0:e87aa4c49e95 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
phungductung 0:e87aa4c49e95 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
phungductung 0:e87aa4c49e95 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
phungductung 0:e87aa4c49e95 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
phungductung 0:e87aa4c49e95 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
phungductung 0:e87aa4c49e95 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
phungductung 0:e87aa4c49e95 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
phungductung 0:e87aa4c49e95 34 *
phungductung 0:e87aa4c49e95 35 ******************************************************************************
phungductung 0:e87aa4c49e95 36 */
phungductung 0:e87aa4c49e95 37
phungductung 0:e87aa4c49e95 38 /* Define to prevent recursive inclusion -------------------------------------*/
phungductung 0:e87aa4c49e95 39 #ifndef __STM32F7xx_HAL_CRYP_EX_H
phungductung 0:e87aa4c49e95 40 #define __STM32F7xx_HAL_CRYP_EX_H
phungductung 0:e87aa4c49e95 41
phungductung 0:e87aa4c49e95 42 #ifdef __cplusplus
phungductung 0:e87aa4c49e95 43 extern "C" {
phungductung 0:e87aa4c49e95 44 #endif
phungductung 0:e87aa4c49e95 45
phungductung 0:e87aa4c49e95 46 #if defined (STM32F756xx)
phungductung 0:e87aa4c49e95 47 /* Includes ------------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 48 #include "stm32f7xx_hal_def.h"
phungductung 0:e87aa4c49e95 49
phungductung 0:e87aa4c49e95 50 /** @addtogroup STM32F7xx_HAL_Driver
phungductung 0:e87aa4c49e95 51 * @{
phungductung 0:e87aa4c49e95 52 */
phungductung 0:e87aa4c49e95 53
phungductung 0:e87aa4c49e95 54 /** @addtogroup CRYPEx
phungductung 0:e87aa4c49e95 55 * @{
phungductung 0:e87aa4c49e95 56 */
phungductung 0:e87aa4c49e95 57
phungductung 0:e87aa4c49e95 58 /* Exported types ------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 59 /* Exported constants --------------------------------------------------------*/
phungductung 0:e87aa4c49e95 60
phungductung 0:e87aa4c49e95 61 /** @defgroup CRYPEx_Exported_Constants CRYPEx Exported Constants
phungductung 0:e87aa4c49e95 62 * @{
phungductung 0:e87aa4c49e95 63 */
phungductung 0:e87aa4c49e95 64
phungductung 0:e87aa4c49e95 65 /** @defgroup CRYPEx_Exported_Constants_Group1 CRYP AlgoModeDirection
phungductung 0:e87aa4c49e95 66 * @{
phungductung 0:e87aa4c49e95 67 */
phungductung 0:e87aa4c49e95 68 #define CRYP_CR_ALGOMODE_AES_GCM_ENCRYPT ((uint32_t)0x00080000)
phungductung 0:e87aa4c49e95 69 #define CRYP_CR_ALGOMODE_AES_GCM_DECRYPT ((uint32_t)0x00080004)
phungductung 0:e87aa4c49e95 70 #define CRYP_CR_ALGOMODE_AES_CCM_ENCRYPT ((uint32_t)0x00080008)
phungductung 0:e87aa4c49e95 71 #define CRYP_CR_ALGOMODE_AES_CCM_DECRYPT ((uint32_t)0x0008000C)
phungductung 0:e87aa4c49e95 72 /**
phungductung 0:e87aa4c49e95 73 * @}
phungductung 0:e87aa4c49e95 74 */
phungductung 0:e87aa4c49e95 75
phungductung 0:e87aa4c49e95 76 /** @defgroup CRYPEx_Exported_Constants_Group3 CRYP PhaseConfig
phungductung 0:e87aa4c49e95 77 * @brief The phases are relevant only to AES-GCM and AES-CCM
phungductung 0:e87aa4c49e95 78 * @{
phungductung 0:e87aa4c49e95 79 */
phungductung 0:e87aa4c49e95 80 #define CRYP_PHASE_INIT ((uint32_t)0x00000000)
phungductung 0:e87aa4c49e95 81 #define CRYP_PHASE_HEADER CRYP_CR_GCM_CCMPH_0
phungductung 0:e87aa4c49e95 82 #define CRYP_PHASE_PAYLOAD CRYP_CR_GCM_CCMPH_1
phungductung 0:e87aa4c49e95 83 #define CRYP_PHASE_FINAL CRYP_CR_GCM_CCMPH
phungductung 0:e87aa4c49e95 84 /**
phungductung 0:e87aa4c49e95 85 * @}
phungductung 0:e87aa4c49e95 86 */
phungductung 0:e87aa4c49e95 87
phungductung 0:e87aa4c49e95 88 /**
phungductung 0:e87aa4c49e95 89 * @}
phungductung 0:e87aa4c49e95 90 */
phungductung 0:e87aa4c49e95 91
phungductung 0:e87aa4c49e95 92 /* Exported macro ------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 93 /** @defgroup CRYPEx_Exported_Macros CRYP Exported Macros
phungductung 0:e87aa4c49e95 94 * @{
phungductung 0:e87aa4c49e95 95 */
phungductung 0:e87aa4c49e95 96
phungductung 0:e87aa4c49e95 97 /**
phungductung 0:e87aa4c49e95 98 * @brief Set the phase: Init, header, payload, final.
phungductung 0:e87aa4c49e95 99 * This is relevant only for GCM and CCM modes.
phungductung 0:e87aa4c49e95 100 * @param __HANDLE__: specifies the CRYP handle.
phungductung 0:e87aa4c49e95 101 * @param __PHASE__: The phase.
phungductung 0:e87aa4c49e95 102 * @retval None
phungductung 0:e87aa4c49e95 103 */
phungductung 0:e87aa4c49e95 104 #define __HAL_CRYP_SET_PHASE(__HANDLE__, __PHASE__) do{(__HANDLE__)->Instance->CR &= (uint32_t)(~CRYP_CR_GCM_CCMPH);\
phungductung 0:e87aa4c49e95 105 (__HANDLE__)->Instance->CR |= (uint32_t)(__PHASE__);\
phungductung 0:e87aa4c49e95 106 }while(0)
phungductung 0:e87aa4c49e95 107
phungductung 0:e87aa4c49e95 108 /**
phungductung 0:e87aa4c49e95 109 * @}
phungductung 0:e87aa4c49e95 110 */
phungductung 0:e87aa4c49e95 111
phungductung 0:e87aa4c49e95 112 /* Exported functions --------------------------------------------------------*/
phungductung 0:e87aa4c49e95 113 /** @defgroup CRYPEx_Exported_Functions CRYPEx Exported Functions
phungductung 0:e87aa4c49e95 114 * @{
phungductung 0:e87aa4c49e95 115 */
phungductung 0:e87aa4c49e95 116
phungductung 0:e87aa4c49e95 117 /** @addtogroup CRYPEx_Exported_Functions_Group1
phungductung 0:e87aa4c49e95 118 * @{
phungductung 0:e87aa4c49e95 119 */
phungductung 0:e87aa4c49e95 120
phungductung 0:e87aa4c49e95 121 /* AES encryption/decryption using polling ***********************************/
phungductung 0:e87aa4c49e95 122 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
phungductung 0:e87aa4c49e95 123 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
phungductung 0:e87aa4c49e95 124 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Finish(CRYP_HandleTypeDef *hcryp, uint32_t Size, uint8_t *AuthTag, uint32_t Timeout);
phungductung 0:e87aa4c49e95 125 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
phungductung 0:e87aa4c49e95 126 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
phungductung 0:e87aa4c49e95 127 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Finish(CRYP_HandleTypeDef *hcryp, uint8_t *AuthTag, uint32_t Timeout);
phungductung 0:e87aa4c49e95 128
phungductung 0:e87aa4c49e95 129 /* AES encryption/decryption using interrupt *********************************/
phungductung 0:e87aa4c49e95 130 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
phungductung 0:e87aa4c49e95 131 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
phungductung 0:e87aa4c49e95 132 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
phungductung 0:e87aa4c49e95 133 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
phungductung 0:e87aa4c49e95 134
phungductung 0:e87aa4c49e95 135 /* AES encryption/decryption using DMA ***************************************/
phungductung 0:e87aa4c49e95 136 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
phungductung 0:e87aa4c49e95 137 HAL_StatusTypeDef HAL_CRYPEx_AESGCM_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
phungductung 0:e87aa4c49e95 138 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
phungductung 0:e87aa4c49e95 139 HAL_StatusTypeDef HAL_CRYPEx_AESCCM_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
phungductung 0:e87aa4c49e95 140
phungductung 0:e87aa4c49e95 141 /**
phungductung 0:e87aa4c49e95 142 * @}
phungductung 0:e87aa4c49e95 143 */
phungductung 0:e87aa4c49e95 144
phungductung 0:e87aa4c49e95 145 /** @addtogroup CRYPEx_Exported_Functions_Group2
phungductung 0:e87aa4c49e95 146 * @{
phungductung 0:e87aa4c49e95 147 */
phungductung 0:e87aa4c49e95 148
phungductung 0:e87aa4c49e95 149 void HAL_CRYPEx_GCMCCM_IRQHandler(CRYP_HandleTypeDef *hcryp);
phungductung 0:e87aa4c49e95 150
phungductung 0:e87aa4c49e95 151 /**
phungductung 0:e87aa4c49e95 152 * @}
phungductung 0:e87aa4c49e95 153 */
phungductung 0:e87aa4c49e95 154
phungductung 0:e87aa4c49e95 155 /**
phungductung 0:e87aa4c49e95 156 * @}
phungductung 0:e87aa4c49e95 157 */
phungductung 0:e87aa4c49e95 158
phungductung 0:e87aa4c49e95 159
phungductung 0:e87aa4c49e95 160 /* Private types -------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 161 /** @defgroup CRYPEx_Private_Types CRYPEx Private Types
phungductung 0:e87aa4c49e95 162 * @{
phungductung 0:e87aa4c49e95 163 */
phungductung 0:e87aa4c49e95 164
phungductung 0:e87aa4c49e95 165 /**
phungductung 0:e87aa4c49e95 166 * @}
phungductung 0:e87aa4c49e95 167 */
phungductung 0:e87aa4c49e95 168
phungductung 0:e87aa4c49e95 169 /* Private variables ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 170 /** @defgroup CRYPEx_Private_Variables CRYPEx Private Variables
phungductung 0:e87aa4c49e95 171 * @{
phungductung 0:e87aa4c49e95 172 */
phungductung 0:e87aa4c49e95 173
phungductung 0:e87aa4c49e95 174 /**
phungductung 0:e87aa4c49e95 175 * @}
phungductung 0:e87aa4c49e95 176 */
phungductung 0:e87aa4c49e95 177
phungductung 0:e87aa4c49e95 178 /* Private constants ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 179 /** @defgroup CRYPEx_Private_Constants CRYPEx Private Constants
phungductung 0:e87aa4c49e95 180 * @{
phungductung 0:e87aa4c49e95 181 */
phungductung 0:e87aa4c49e95 182
phungductung 0:e87aa4c49e95 183 /**
phungductung 0:e87aa4c49e95 184 * @}
phungductung 0:e87aa4c49e95 185 */
phungductung 0:e87aa4c49e95 186
phungductung 0:e87aa4c49e95 187 /* Private macros ------------------------------------------------------------*/
phungductung 0:e87aa4c49e95 188 /** @defgroup CRYPEx_Private_Macros CRYPEx Private Macros
phungductung 0:e87aa4c49e95 189 * @{
phungductung 0:e87aa4c49e95 190 */
phungductung 0:e87aa4c49e95 191
phungductung 0:e87aa4c49e95 192 /**
phungductung 0:e87aa4c49e95 193 * @}
phungductung 0:e87aa4c49e95 194 */
phungductung 0:e87aa4c49e95 195
phungductung 0:e87aa4c49e95 196 /* Private functions ---------------------------------------------------------*/
phungductung 0:e87aa4c49e95 197 /** @defgroup CRYPEx_Private_Functions CRYPEx Private Functions
phungductung 0:e87aa4c49e95 198 * @{
phungductung 0:e87aa4c49e95 199 */
phungductung 0:e87aa4c49e95 200
phungductung 0:e87aa4c49e95 201 /**
phungductung 0:e87aa4c49e95 202 * @}
phungductung 0:e87aa4c49e95 203 */
phungductung 0:e87aa4c49e95 204
phungductung 0:e87aa4c49e95 205 /**
phungductung 0:e87aa4c49e95 206 * @}
phungductung 0:e87aa4c49e95 207 */
phungductung 0:e87aa4c49e95 208
phungductung 0:e87aa4c49e95 209 #endif /* STM32F756xx */
phungductung 0:e87aa4c49e95 210
phungductung 0:e87aa4c49e95 211 /**
phungductung 0:e87aa4c49e95 212 * @}
phungductung 0:e87aa4c49e95 213 */
phungductung 0:e87aa4c49e95 214
phungductung 0:e87aa4c49e95 215 #ifdef __cplusplus
phungductung 0:e87aa4c49e95 216 }
phungductung 0:e87aa4c49e95 217 #endif
phungductung 0:e87aa4c49e95 218
phungductung 0:e87aa4c49e95 219 #endif /* __STM32F7xx_HAL_CRYP_EX_H */
phungductung 0:e87aa4c49e95 220
phungductung 0:e87aa4c49e95 221 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/