mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_H743ZI/TOOLCHAIN_ARM_MICRO/stm32h7xx_hal_cryp.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 172:65be27845400 1 /**
AnnaBridge 172:65be27845400 2 ******************************************************************************
AnnaBridge 172:65be27845400 3 * @file stm32h7xx_hal_cryp.h
AnnaBridge 172:65be27845400 4 * @author MCD Application Team
AnnaBridge 172:65be27845400 5 * @brief Header file of CRYP HAL module.
AnnaBridge 172:65be27845400 6 ******************************************************************************
AnnaBridge 172:65be27845400 7 * @attention
AnnaBridge 172:65be27845400 8 *
AnnaBridge 172:65be27845400 9 * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
AnnaBridge 172:65be27845400 10 * All rights reserved.</center></h2>
AnnaBridge 172:65be27845400 11 *
AnnaBridge 172:65be27845400 12 * This software component is licensed by ST under BSD 3-Clause license,
AnnaBridge 172:65be27845400 13 * the "License"; You may not use this file except in compliance with the
AnnaBridge 172:65be27845400 14 * License. You may obtain a copy of the License at:
AnnaBridge 172:65be27845400 15 * opensource.org/licenses/BSD-3-Clause
AnnaBridge 172:65be27845400 16 *
AnnaBridge 172:65be27845400 17 ******************************************************************************
AnnaBridge 172:65be27845400 18 */
AnnaBridge 172:65be27845400 19
AnnaBridge 172:65be27845400 20 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 172:65be27845400 21 #ifndef STM32H7xx_HAL_CRYP_H
AnnaBridge 172:65be27845400 22 #define STM32H7xx_HAL_CRYP_H
AnnaBridge 172:65be27845400 23
AnnaBridge 172:65be27845400 24 #ifdef __cplusplus
AnnaBridge 172:65be27845400 25 extern "C" {
AnnaBridge 172:65be27845400 26 #endif
AnnaBridge 172:65be27845400 27
AnnaBridge 172:65be27845400 28
AnnaBridge 172:65be27845400 29 /* Includes ------------------------------------------------------------------*/
AnnaBridge 172:65be27845400 30 #include "stm32h7xx_hal_def.h"
AnnaBridge 172:65be27845400 31
AnnaBridge 172:65be27845400 32 /** @addtogroup STM32H7xx_HAL_Driver
AnnaBridge 172:65be27845400 33 * @{
AnnaBridge 172:65be27845400 34 */
AnnaBridge 172:65be27845400 35 #if defined (CRYP)
AnnaBridge 172:65be27845400 36 /** @addtogroup CRYP
AnnaBridge 172:65be27845400 37 * @{
AnnaBridge 172:65be27845400 38 */
AnnaBridge 172:65be27845400 39
AnnaBridge 172:65be27845400 40 /* Exported types ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 41 /** @defgroup CRYP_Exported_Types CRYP Exported Types
AnnaBridge 172:65be27845400 42 * @{
AnnaBridge 172:65be27845400 43 */
AnnaBridge 172:65be27845400 44
AnnaBridge 172:65be27845400 45 /**
AnnaBridge 172:65be27845400 46 * @brief CRYP Init Structure definition
AnnaBridge 172:65be27845400 47 */
AnnaBridge 172:65be27845400 48
AnnaBridge 172:65be27845400 49 typedef struct
AnnaBridge 172:65be27845400 50 {
AnnaBridge 172:65be27845400 51 uint32_t DataType; /*!< 32-bit data, 16-bit data, 8-bit data or 1-bit string.
AnnaBridge 172:65be27845400 52 This parameter can be a value of @ref CRYP_Data_Type */
AnnaBridge 172:65be27845400 53 uint32_t KeySize; /*!< Used only in AES mode : 128, 192 or 256 bit key length in CRYP1.
AnnaBridge 172:65be27845400 54 This parameter can be a value of @ref CRYP_Key_Size */
AnnaBridge 172:65be27845400 55 uint32_t *pKey; /*!< The key used for encryption/decryption */
AnnaBridge 172:65be27845400 56 uint32_t *pInitVect; /*!< The initialization vector used also as initialization
AnnaBridge 172:65be27845400 57 counter in CTR mode */
AnnaBridge 172:65be27845400 58 uint32_t Algorithm; /*!< DES/ TDES Algorithm ECB/CBC
AnnaBridge 172:65be27845400 59 AES Algorithm ECB/CBC/CTR/GCM or CCM
AnnaBridge 172:65be27845400 60 This parameter can be a value of @ref CRYP_Algorithm_Mode */
AnnaBridge 172:65be27845400 61 uint32_t *Header; /*!< used only in AES GCM and CCM Algorithm for authentication,
AnnaBridge 172:65be27845400 62 GCM : also known as Additional Authentication Data
AnnaBridge 172:65be27845400 63 CCM : named B1 composed of the associated data length and Associated Data. */
AnnaBridge 172:65be27845400 64 uint32_t HeaderSize; /*!< The size of header buffer in word */
AnnaBridge 172:65be27845400 65 uint32_t *B0; /*!< B0 is first authentication block used only in AES CCM mode */
AnnaBridge 172:65be27845400 66 uint32_t DataWidthUnit; /*!< Data With Unit, this parameter can be value of @ref CRYP_Data_Width_Unit*/
AnnaBridge 172:65be27845400 67
AnnaBridge 172:65be27845400 68 } CRYP_ConfigTypeDef;
AnnaBridge 172:65be27845400 69
AnnaBridge 172:65be27845400 70
AnnaBridge 172:65be27845400 71 /**
AnnaBridge 172:65be27845400 72 * @brief CRYP State Structure definition
AnnaBridge 172:65be27845400 73 */
AnnaBridge 172:65be27845400 74
AnnaBridge 172:65be27845400 75 typedef enum
AnnaBridge 172:65be27845400 76 {
AnnaBridge 172:65be27845400 77 HAL_CRYP_STATE_RESET = 0x00U, /*!< CRYP not yet initialized or disabled */
AnnaBridge 172:65be27845400 78 HAL_CRYP_STATE_READY = 0x01U, /*!< CRYP initialized and ready for use */
AnnaBridge 172:65be27845400 79 HAL_CRYP_STATE_BUSY = 0x02U /*!< CRYP BUSY, internal processing is ongoing */
AnnaBridge 172:65be27845400 80 } HAL_CRYP_STATETypeDef;
AnnaBridge 172:65be27845400 81
AnnaBridge 172:65be27845400 82
AnnaBridge 172:65be27845400 83 /**
AnnaBridge 172:65be27845400 84 * @brief CRYP handle Structure definition
AnnaBridge 172:65be27845400 85 */
AnnaBridge 172:65be27845400 86
AnnaBridge 172:65be27845400 87 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 88 typedef struct __CRYP_HandleTypeDef
AnnaBridge 172:65be27845400 89 #else
AnnaBridge 172:65be27845400 90 typedef struct
AnnaBridge 172:65be27845400 91 #endif /* (USE_HAL_CRYP_REGISTER_CALLBACKS) */
AnnaBridge 172:65be27845400 92 {
AnnaBridge 172:65be27845400 93
AnnaBridge 172:65be27845400 94 CRYP_TypeDef *Instance; /*!< CRYP registers base address */
AnnaBridge 172:65be27845400 95
AnnaBridge 172:65be27845400 96 CRYP_ConfigTypeDef Init; /*!< CRYP required parameters */
AnnaBridge 172:65be27845400 97
AnnaBridge 172:65be27845400 98 uint32_t *pCrypInBuffPtr; /*!< Pointer to CRYP processing (encryption, decryption,...) buffer */
AnnaBridge 172:65be27845400 99
AnnaBridge 172:65be27845400 100 uint32_t *pCrypOutBuffPtr; /*!< Pointer to CRYP processing (encryption, decryption,...) buffer */
AnnaBridge 172:65be27845400 101
AnnaBridge 172:65be27845400 102 __IO uint16_t CrypHeaderCount; /*!< Counter of header data */
AnnaBridge 172:65be27845400 103
AnnaBridge 172:65be27845400 104 __IO uint16_t CrypInCount; /*!< Counter of input data */
AnnaBridge 172:65be27845400 105
AnnaBridge 172:65be27845400 106 __IO uint16_t CrypOutCount; /*!< Counter of output data */
AnnaBridge 172:65be27845400 107
AnnaBridge 172:65be27845400 108 uint16_t Size; /*!< length of input data in word */
AnnaBridge 172:65be27845400 109
AnnaBridge 172:65be27845400 110 uint32_t Phase; /*!< CRYP peripheral phase */
AnnaBridge 172:65be27845400 111
AnnaBridge 172:65be27845400 112 DMA_HandleTypeDef *hdmain; /*!< CRYP In DMA handle parameters */
AnnaBridge 172:65be27845400 113
AnnaBridge 172:65be27845400 114 DMA_HandleTypeDef *hdmaout; /*!< CRYP Out DMA handle parameters */
AnnaBridge 172:65be27845400 115
AnnaBridge 172:65be27845400 116 HAL_LockTypeDef Lock; /*!< CRYP locking object */
AnnaBridge 172:65be27845400 117
AnnaBridge 172:65be27845400 118 __IO HAL_CRYP_STATETypeDef State; /*!< CRYP peripheral state */
AnnaBridge 172:65be27845400 119
AnnaBridge 172:65be27845400 120 __IO uint32_t ErrorCode; /*!< CRYP peripheral error code */
AnnaBridge 172:65be27845400 121
AnnaBridge 172:65be27845400 122
AnnaBridge 172:65be27845400 123 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 124 void (*InCpltCallback)(struct __CRYP_HandleTypeDef *hcryp); /*!< CRYP Input FIFO transfer completed callback */
AnnaBridge 172:65be27845400 125 void (*OutCpltCallback)(struct __CRYP_HandleTypeDef *hcryp); /*!< CRYP Output FIFO transfer completed callback */
AnnaBridge 172:65be27845400 126 void (*ErrorCallback)(struct __CRYP_HandleTypeDef *hcryp); /*!< CRYP Error callback */
AnnaBridge 172:65be27845400 127
AnnaBridge 172:65be27845400 128 void (* MspInitCallback)(struct __CRYP_HandleTypeDef *hcryp); /*!< CRYP Msp Init callback */
AnnaBridge 172:65be27845400 129 void (* MspDeInitCallback)(struct __CRYP_HandleTypeDef *hcryp); /*!< CRYP Msp DeInit callback */
AnnaBridge 172:65be27845400 130
AnnaBridge 172:65be27845400 131 #endif /* (USE_HAL_CRYP_REGISTER_CALLBACKS) */
AnnaBridge 172:65be27845400 132
AnnaBridge 172:65be27845400 133 } CRYP_HandleTypeDef;
AnnaBridge 172:65be27845400 134
AnnaBridge 172:65be27845400 135
AnnaBridge 172:65be27845400 136 /**
AnnaBridge 172:65be27845400 137 * @}
AnnaBridge 172:65be27845400 138 */
AnnaBridge 172:65be27845400 139
AnnaBridge 172:65be27845400 140 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 141 /** @defgroup HAL_CRYP_Callback_ID_enumeration_definition HAL CRYP Callback ID enumeration definition
AnnaBridge 172:65be27845400 142 * @brief HAL CRYP Callback ID enumeration definition
AnnaBridge 172:65be27845400 143 * @{
AnnaBridge 172:65be27845400 144 */
AnnaBridge 172:65be27845400 145 typedef enum
AnnaBridge 172:65be27845400 146 {
AnnaBridge 172:65be27845400 147 HAL_CRYP_INPUT_COMPLETE_CB_ID = 0x01U, /*!< CRYP Input FIFO transfer completed callback ID */
AnnaBridge 172:65be27845400 148 HAL_CRYP_OUTPUT_COMPLETE_CB_ID = 0x02U, /*!< CRYP Output FIFO transfer completed callback ID */
AnnaBridge 172:65be27845400 149 HAL_CRYP_ERROR_CB_ID = 0x03U, /*!< CRYP Error callback ID */
AnnaBridge 172:65be27845400 150
AnnaBridge 172:65be27845400 151 HAL_CRYP_MSPINIT_CB_ID = 0x04U, /*!< CRYP MspInit callback ID */
AnnaBridge 172:65be27845400 152 HAL_CRYP_MSPDEINIT_CB_ID = 0x05U /*!< CRYP MspDeInit callback ID */
AnnaBridge 172:65be27845400 153
AnnaBridge 172:65be27845400 154 } HAL_CRYP_CallbackIDTypeDef;
AnnaBridge 172:65be27845400 155 /**
AnnaBridge 172:65be27845400 156 * @}
AnnaBridge 172:65be27845400 157 */
AnnaBridge 172:65be27845400 158
AnnaBridge 172:65be27845400 159 /** @defgroup HAL_CRYP_Callback_pointer_definition HAL CRYP Callback pointer definition
AnnaBridge 172:65be27845400 160 * @brief HAL CRYP Callback pointer definition
AnnaBridge 172:65be27845400 161 * @{
AnnaBridge 172:65be27845400 162 */
AnnaBridge 172:65be27845400 163
AnnaBridge 172:65be27845400 164 typedef void (*pCRYP_CallbackTypeDef)(CRYP_HandleTypeDef *hcryp); /*!< pointer to a common CRYP callback function */
AnnaBridge 172:65be27845400 165
AnnaBridge 172:65be27845400 166 /**
AnnaBridge 172:65be27845400 167 * @}
AnnaBridge 172:65be27845400 168 */
AnnaBridge 172:65be27845400 169
AnnaBridge 172:65be27845400 170 #endif /* USE_HAL_CRYP_REGISTER_CALLBACKS */
AnnaBridge 172:65be27845400 171
AnnaBridge 172:65be27845400 172 /* Exported constants --------------------------------------------------------*/
AnnaBridge 172:65be27845400 173 /** @defgroup CRYP_Exported_Constants CRYP Exported Constants
AnnaBridge 172:65be27845400 174 * @{
AnnaBridge 172:65be27845400 175 */
AnnaBridge 172:65be27845400 176
AnnaBridge 172:65be27845400 177 /** @defgroup CRYP_Error_Definition CRYP Error Definition
AnnaBridge 172:65be27845400 178 * @{
AnnaBridge 172:65be27845400 179 */
AnnaBridge 172:65be27845400 180 #define HAL_CRYP_ERROR_NONE 0x00000000U /*!< No error */
AnnaBridge 172:65be27845400 181 #define HAL_CRYP_ERROR_WRITE 0x00000001U /*!< Write error */
AnnaBridge 172:65be27845400 182 #define HAL_CRYP_ERROR_READ 0x00000002U /*!< Read error */
AnnaBridge 172:65be27845400 183 #define HAL_CRYP_ERROR_DMA 0x00000004U /*!< DMA error */
AnnaBridge 172:65be27845400 184 #define HAL_CRYP_ERROR_BUSY 0x00000008U /*!< Busy flag error */
AnnaBridge 172:65be27845400 185 #define HAL_CRYP_ERROR_TIMEOUT 0x00000010U /*!< Timeout error */
AnnaBridge 172:65be27845400 186 #define HAL_CRYP_ERROR_NOT_SUPPORTED 0x00000020U /*!< Not supported mode */
AnnaBridge 172:65be27845400 187 #define HAL_CRYP_ERROR_AUTH_TAG_SEQUENCE 0x00000040U /*!< Sequence are not respected only for GCM or CCM */
AnnaBridge 172:65be27845400 188 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 189 #define HAL_CRYP_ERROR_INVALID_CALLBACK ((uint32_t)0x00000080U) /*!< Invalid Callback error */
AnnaBridge 172:65be27845400 190 #endif /* USE_HAL_CRYP_REGISTER_CALLBACKS */
AnnaBridge 172:65be27845400 191
AnnaBridge 172:65be27845400 192 /**
AnnaBridge 172:65be27845400 193 * @}
AnnaBridge 172:65be27845400 194 */
AnnaBridge 172:65be27845400 195
AnnaBridge 172:65be27845400 196
AnnaBridge 172:65be27845400 197 /** @defgroup CRYP_Data_Width_Unit CRYP Data Width Unit
AnnaBridge 172:65be27845400 198 * @{
AnnaBridge 172:65be27845400 199 */
AnnaBridge 172:65be27845400 200
AnnaBridge 172:65be27845400 201 #define CRYP_DATAWIDTHUNIT_WORD 0x00000000U /*!< By default, size unit is word */
AnnaBridge 172:65be27845400 202 #define CRYP_DATAWIDTHUNIT_BYTE 0x00000001U /*!< By default, size unit is word */
AnnaBridge 172:65be27845400 203
AnnaBridge 172:65be27845400 204 /**
AnnaBridge 172:65be27845400 205 * @}
AnnaBridge 172:65be27845400 206 */
AnnaBridge 172:65be27845400 207
AnnaBridge 172:65be27845400 208 /** @defgroup CRYP_Algorithm_Mode CRYP Algorithm Mode
AnnaBridge 172:65be27845400 209 * @{
AnnaBridge 172:65be27845400 210 */
AnnaBridge 172:65be27845400 211
AnnaBridge 172:65be27845400 212 #define CRYP_DES_ECB CRYP_CR_ALGOMODE_DES_ECB
AnnaBridge 172:65be27845400 213 #define CRYP_DES_CBC CRYP_CR_ALGOMODE_DES_CBC
AnnaBridge 172:65be27845400 214 #define CRYP_TDES_ECB CRYP_CR_ALGOMODE_TDES_ECB
AnnaBridge 172:65be27845400 215 #define CRYP_TDES_CBC CRYP_CR_ALGOMODE_TDES_CBC
AnnaBridge 172:65be27845400 216 #define CRYP_AES_ECB CRYP_CR_ALGOMODE_AES_ECB
AnnaBridge 172:65be27845400 217 #define CRYP_AES_CBC CRYP_CR_ALGOMODE_AES_CBC
AnnaBridge 172:65be27845400 218 #define CRYP_AES_CTR CRYP_CR_ALGOMODE_AES_CTR
AnnaBridge 172:65be27845400 219 #define CRYP_AES_GCM CRYP_CR_ALGOMODE_AES_GCM
AnnaBridge 172:65be27845400 220 #define CRYP_AES_CCM CRYP_CR_ALGOMODE_AES_CCM
AnnaBridge 172:65be27845400 221
AnnaBridge 172:65be27845400 222 /**
AnnaBridge 172:65be27845400 223 * @}
AnnaBridge 172:65be27845400 224 */
AnnaBridge 172:65be27845400 225
AnnaBridge 172:65be27845400 226 /** @defgroup CRYP_Key_Size CRYP Key Size
AnnaBridge 172:65be27845400 227 * @{
AnnaBridge 172:65be27845400 228 */
AnnaBridge 172:65be27845400 229
AnnaBridge 172:65be27845400 230 #define CRYP_KEYSIZE_128B 0x00000000U
AnnaBridge 172:65be27845400 231 #define CRYP_KEYSIZE_192B CRYP_CR_KEYSIZE_0
AnnaBridge 172:65be27845400 232 #define CRYP_KEYSIZE_256B CRYP_CR_KEYSIZE_1
AnnaBridge 172:65be27845400 233
AnnaBridge 172:65be27845400 234 /**
AnnaBridge 172:65be27845400 235 * @}
AnnaBridge 172:65be27845400 236 */
AnnaBridge 172:65be27845400 237
AnnaBridge 172:65be27845400 238 /** @defgroup CRYP_Data_Type CRYP Data Type
AnnaBridge 172:65be27845400 239 * @{
AnnaBridge 172:65be27845400 240 */
AnnaBridge 172:65be27845400 241
AnnaBridge 172:65be27845400 242 #define CRYP_DATATYPE_32B 0x00000000U
AnnaBridge 172:65be27845400 243 #define CRYP_DATATYPE_16B CRYP_CR_DATATYPE_0
AnnaBridge 172:65be27845400 244 #define CRYP_DATATYPE_8B CRYP_CR_DATATYPE_1
AnnaBridge 172:65be27845400 245 #define CRYP_DATATYPE_1B CRYP_CR_DATATYPE
AnnaBridge 172:65be27845400 246
AnnaBridge 172:65be27845400 247 /**
AnnaBridge 172:65be27845400 248 * @}
AnnaBridge 172:65be27845400 249 */
AnnaBridge 172:65be27845400 250
AnnaBridge 172:65be27845400 251 /** @defgroup CRYP_Interrupt CRYP Interrupt
AnnaBridge 172:65be27845400 252 * @{
AnnaBridge 172:65be27845400 253 */
AnnaBridge 172:65be27845400 254
AnnaBridge 172:65be27845400 255 #define CRYP_IT_INI CRYP_IMSCR_INIM /*!< Input FIFO Interrupt */
AnnaBridge 172:65be27845400 256 #define CRYP_IT_OUTI CRYP_IMSCR_OUTIM /*!< Output FIFO Interrupt */
AnnaBridge 172:65be27845400 257
AnnaBridge 172:65be27845400 258 /**
AnnaBridge 172:65be27845400 259 * @}
AnnaBridge 172:65be27845400 260 */
AnnaBridge 172:65be27845400 261
AnnaBridge 172:65be27845400 262 /** @defgroup CRYP_Flags CRYP Flags
AnnaBridge 172:65be27845400 263 * @{
AnnaBridge 172:65be27845400 264 */
AnnaBridge 172:65be27845400 265
AnnaBridge 172:65be27845400 266 /* Flags in the SR register */
AnnaBridge 172:65be27845400 267 #define CRYP_FLAG_IFEM CRYP_SR_IFEM /*!< Input FIFO is empty */
AnnaBridge 172:65be27845400 268 #define CRYP_FLAG_IFNF CRYP_SR_IFNF /*!< Input FIFO is not Full */
AnnaBridge 172:65be27845400 269 #define CRYP_FLAG_OFNE CRYP_SR_OFNE /*!< Output FIFO is not empty */
AnnaBridge 172:65be27845400 270 #define CRYP_FLAG_OFFU CRYP_SR_OFFU /*!< Output FIFO is Full */
AnnaBridge 172:65be27845400 271 #define CRYP_FLAG_BUSY CRYP_SR_BUSY /*!< The CRYP core is currently processing a block of data
AnnaBridge 172:65be27845400 272 or a key preparation (for AES decryption). */
AnnaBridge 172:65be27845400 273 /* Flags in the RISR register */
AnnaBridge 172:65be27845400 274 #define CRYP_FLAG_OUTRIS 0x01000002U /*!< Output FIFO service raw interrupt status */
AnnaBridge 172:65be27845400 275 #define CRYP_FLAG_INRIS 0x01000001U /*!< Input FIFO service raw interrupt status*/
AnnaBridge 172:65be27845400 276
AnnaBridge 172:65be27845400 277 /**
AnnaBridge 172:65be27845400 278 * @}
AnnaBridge 172:65be27845400 279 */
AnnaBridge 172:65be27845400 280
AnnaBridge 172:65be27845400 281
AnnaBridge 172:65be27845400 282 /**
AnnaBridge 172:65be27845400 283 * @}
AnnaBridge 172:65be27845400 284 */
AnnaBridge 172:65be27845400 285
AnnaBridge 172:65be27845400 286 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 172:65be27845400 287 /** @defgroup CRYP_Exported_Macros CRYP Exported Macros
AnnaBridge 172:65be27845400 288 * @{
AnnaBridge 172:65be27845400 289 */
AnnaBridge 172:65be27845400 290
AnnaBridge 172:65be27845400 291 /** @brief Reset CRYP handle state
AnnaBridge 172:65be27845400 292 * @param __HANDLE__ specifies the CRYP handle.
AnnaBridge 172:65be27845400 293 * @retval None
AnnaBridge 172:65be27845400 294 */
AnnaBridge 172:65be27845400 295 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 296 #define __HAL_CRYP_RESET_HANDLE_STATE(__HANDLE__) do{\
AnnaBridge 172:65be27845400 297 (__HANDLE__)->State = HAL_CRYP_STATE_RESET;\
AnnaBridge 172:65be27845400 298 (__HANDLE__)->MspInitCallback = NULL;\
AnnaBridge 172:65be27845400 299 (__HANDLE__)->MspDeInitCallback = NULL;\
AnnaBridge 172:65be27845400 300 }while(0)
AnnaBridge 172:65be27845400 301 #else
AnnaBridge 172:65be27845400 302 #define __HAL_CRYP_RESET_HANDLE_STATE(__HANDLE__) ( (__HANDLE__)->State = HAL_CRYP_STATE_RESET)
AnnaBridge 172:65be27845400 303 #endif /* USE_HAL_CRYP_REGISTER_CALLBACKS */
AnnaBridge 172:65be27845400 304
AnnaBridge 172:65be27845400 305 /**
AnnaBridge 172:65be27845400 306 * @brief Enable/Disable the CRYP peripheral.
AnnaBridge 172:65be27845400 307 * @param __HANDLE__: specifies the CRYP handle.
AnnaBridge 172:65be27845400 308 * @retval None
AnnaBridge 172:65be27845400 309 */
AnnaBridge 172:65be27845400 310
AnnaBridge 172:65be27845400 311 #define __HAL_CRYP_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= CRYP_CR_CRYPEN)
AnnaBridge 172:65be27845400 312 #define __HAL_CRYP_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~CRYP_CR_CRYPEN)
AnnaBridge 172:65be27845400 313
AnnaBridge 172:65be27845400 314 /** @brief Check whether the specified CRYP status flag is set or not.
AnnaBridge 172:65be27845400 315 * @param __FLAG__: specifies the flag to check.
AnnaBridge 172:65be27845400 316 * This parameter can be one of the following values for CRYP:
AnnaBridge 172:65be27845400 317 * @arg CRYP_FLAG_BUSY: The CRYP core is currently processing a block of data
AnnaBridge 172:65be27845400 318 * or a key preparation (for AES decryption).
AnnaBridge 172:65be27845400 319 * @arg CRYP_FLAG_IFEM: Input FIFO is empty
AnnaBridge 172:65be27845400 320 * @arg CRYP_FLAG_IFNF: Input FIFO is not full
AnnaBridge 172:65be27845400 321 * @arg CRYP_FLAG_INRIS: Input FIFO service raw interrupt is pending
AnnaBridge 172:65be27845400 322 * @arg CRYP_FLAG_OFNE: Output FIFO is not empty
AnnaBridge 172:65be27845400 323 * @arg CRYP_FLAG_OFFU: Output FIFO is full
AnnaBridge 172:65be27845400 324 * @arg CRYP_FLAG_OUTRIS: Input FIFO service raw interrupt is pending
AnnaBridge 172:65be27845400 325 * @retval The state of __FLAG__ (TRUE or FALSE).
AnnaBridge 172:65be27845400 326 */
AnnaBridge 172:65be27845400 327 #define CRYP_FLAG_MASK 0x0000001FU
AnnaBridge 172:65be27845400 328
AnnaBridge 172:65be27845400 329 #define __HAL_CRYP_GET_FLAG(__HANDLE__, __FLAG__) ((((uint8_t)((__FLAG__) >> 24)) == 0x01U)?((((__HANDLE__)->Instance->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)): \
AnnaBridge 172:65be27845400 330 ((((__HANDLE__)->Instance->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)))
AnnaBridge 172:65be27845400 331
AnnaBridge 172:65be27845400 332 /** @brief Check whether the specified CRYP interrupt is set or not.
AnnaBridge 172:65be27845400 333 * @param __HANDLE__: specifies the CRYP handle.
AnnaBridge 172:65be27845400 334 * @param __INTERRUPT__: specifies the interrupt to check.
AnnaBridge 172:65be27845400 335 * This parameter can be one of the following values for CRYP:
AnnaBridge 172:65be27845400 336 * @arg CRYP_IT_INI: Input FIFO service masked interrupt status
AnnaBridge 172:65be27845400 337 * @arg CRYP_IT_OUTI: Output FIFO service masked interrupt status
AnnaBridge 172:65be27845400 338 * @retval The state of __INTERRUPT__ (TRUE or FALSE).
AnnaBridge 172:65be27845400 339 */
AnnaBridge 172:65be27845400 340
AnnaBridge 172:65be27845400 341 #define __HAL_CRYP_GET_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->MISR & (__INTERRUPT__)) == (__INTERRUPT__))
AnnaBridge 172:65be27845400 342
AnnaBridge 172:65be27845400 343 /**
AnnaBridge 172:65be27845400 344 * @brief Enable the CRYP interrupt.
AnnaBridge 172:65be27845400 345 * @param __HANDLE__: specifies the CRYP handle.
AnnaBridge 172:65be27845400 346 * @param __INTERRUPT__: CRYP Interrupt.
AnnaBridge 172:65be27845400 347 * This parameter can be one of the following values for CRYP:
AnnaBridge 172:65be27845400 348 * @ CRYP_IT_INI : Input FIFO service interrupt mask.
AnnaBridge 172:65be27845400 349 * @ CRYP_IT_OUTI : Output FIFO service interrupt mask.CRYP interrupt.
AnnaBridge 172:65be27845400 350 * @retval None
AnnaBridge 172:65be27845400 351 */
AnnaBridge 172:65be27845400 352
AnnaBridge 172:65be27845400 353 #define __HAL_CRYP_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IMSCR) |= (__INTERRUPT__))
AnnaBridge 172:65be27845400 354
AnnaBridge 172:65be27845400 355 /**
AnnaBridge 172:65be27845400 356 * @brief Disable the CRYP interrupt.
AnnaBridge 172:65be27845400 357 * @param __HANDLE__: specifies the CRYP handle.
AnnaBridge 172:65be27845400 358 * @param __INTERRUPT__: CRYP Interrupt.
AnnaBridge 172:65be27845400 359 * This parameter can be one of the following values for CRYP:
AnnaBridge 172:65be27845400 360 * @ CRYP_IT_INI : Input FIFO service interrupt mask.
AnnaBridge 172:65be27845400 361 * @ CRYP_IT_OUTI : Output FIFO service interrupt mask.CRYP interrupt.
AnnaBridge 172:65be27845400 362 * @retval None
AnnaBridge 172:65be27845400 363 */
AnnaBridge 172:65be27845400 364
AnnaBridge 172:65be27845400 365 #define __HAL_CRYP_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IMSCR) &= ~(__INTERRUPT__))
AnnaBridge 172:65be27845400 366
AnnaBridge 172:65be27845400 367 /**
AnnaBridge 172:65be27845400 368 * @}
AnnaBridge 172:65be27845400 369 */
AnnaBridge 172:65be27845400 370
AnnaBridge 172:65be27845400 371 /* Include CRYP HAL Extended module */
AnnaBridge 172:65be27845400 372 #include "stm32h7xx_hal_cryp_ex.h"
AnnaBridge 172:65be27845400 373
AnnaBridge 172:65be27845400 374 /* Exported functions --------------------------------------------------------*/
AnnaBridge 172:65be27845400 375 /** @defgroup CRYP_Exported_Functions CRYP Exported Functions
AnnaBridge 172:65be27845400 376 * @{
AnnaBridge 172:65be27845400 377 */
AnnaBridge 172:65be27845400 378
AnnaBridge 172:65be27845400 379 /** @addtogroup CRYP_Exported_Functions_Group1
AnnaBridge 172:65be27845400 380 * @{
AnnaBridge 172:65be27845400 381 */
AnnaBridge 172:65be27845400 382 HAL_StatusTypeDef HAL_CRYP_Init(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 383 HAL_StatusTypeDef HAL_CRYP_DeInit(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 384 void HAL_CRYP_MspInit(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 385 void HAL_CRYP_MspDeInit(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 386 HAL_StatusTypeDef HAL_CRYP_SetConfig(CRYP_HandleTypeDef *hcryp, CRYP_ConfigTypeDef *pConf);
AnnaBridge 172:65be27845400 387 HAL_StatusTypeDef HAL_CRYP_GetConfig(CRYP_HandleTypeDef *hcryp, CRYP_ConfigTypeDef *pConf);
AnnaBridge 172:65be27845400 388 #if (USE_HAL_CRYP_REGISTER_CALLBACKS == 1)
AnnaBridge 172:65be27845400 389 HAL_StatusTypeDef HAL_CRYP_RegisterCallback(CRYP_HandleTypeDef *hcryp, HAL_CRYP_CallbackIDTypeDef CallbackID,
AnnaBridge 172:65be27845400 390 pCRYP_CallbackTypeDef pCallback);
AnnaBridge 172:65be27845400 391 HAL_StatusTypeDef HAL_CRYP_UnRegisterCallback(CRYP_HandleTypeDef *hcryp, HAL_CRYP_CallbackIDTypeDef CallbackID);
AnnaBridge 172:65be27845400 392 #endif /* USE_HAL_CRYP_REGISTER_CALLBACKS */
AnnaBridge 172:65be27845400 393 /**
AnnaBridge 172:65be27845400 394 * @}
AnnaBridge 172:65be27845400 395 */
AnnaBridge 172:65be27845400 396
AnnaBridge 172:65be27845400 397 /** @addtogroup CRYP_Exported_Functions_Group2
AnnaBridge 172:65be27845400 398 * @{
AnnaBridge 172:65be27845400 399 */
AnnaBridge 172:65be27845400 400
AnnaBridge 172:65be27845400 401 /* encryption/decryption ***********************************/
AnnaBridge 172:65be27845400 402 HAL_StatusTypeDef HAL_CRYP_Encrypt(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output,
AnnaBridge 172:65be27845400 403 uint32_t Timeout);
AnnaBridge 172:65be27845400 404 HAL_StatusTypeDef HAL_CRYP_Decrypt(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output,
AnnaBridge 172:65be27845400 405 uint32_t Timeout);
AnnaBridge 172:65be27845400 406 HAL_StatusTypeDef HAL_CRYP_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
AnnaBridge 172:65be27845400 407 HAL_StatusTypeDef HAL_CRYP_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
AnnaBridge 172:65be27845400 408 HAL_StatusTypeDef HAL_CRYP_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
AnnaBridge 172:65be27845400 409 HAL_StatusTypeDef HAL_CRYP_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint32_t *Input, uint16_t Size, uint32_t *Output);
AnnaBridge 172:65be27845400 410
AnnaBridge 172:65be27845400 411 /**
AnnaBridge 172:65be27845400 412 * @}
AnnaBridge 172:65be27845400 413 */
AnnaBridge 172:65be27845400 414
AnnaBridge 172:65be27845400 415
AnnaBridge 172:65be27845400 416 /** @addtogroup CRYP_Exported_Functions_Group3
AnnaBridge 172:65be27845400 417 * @{
AnnaBridge 172:65be27845400 418 */
AnnaBridge 172:65be27845400 419 /* Interrupt Handler functions **********************************************/
AnnaBridge 172:65be27845400 420 void HAL_CRYP_IRQHandler(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 421 HAL_CRYP_STATETypeDef HAL_CRYP_GetState(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 422 void HAL_CRYP_InCpltCallback(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 423 void HAL_CRYP_OutCpltCallback(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 424 void HAL_CRYP_ErrorCallback(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 425 uint32_t HAL_CRYP_GetError(CRYP_HandleTypeDef *hcryp);
AnnaBridge 172:65be27845400 426
AnnaBridge 172:65be27845400 427 /**
AnnaBridge 172:65be27845400 428 * @}
AnnaBridge 172:65be27845400 429 */
AnnaBridge 172:65be27845400 430
AnnaBridge 172:65be27845400 431 /**
AnnaBridge 172:65be27845400 432 * @}
AnnaBridge 172:65be27845400 433 */
AnnaBridge 172:65be27845400 434
AnnaBridge 172:65be27845400 435 /* Private macros --------------------------------------------------------*/
AnnaBridge 172:65be27845400 436 /** @defgroup CRYP_Private_Macros CRYP Private Macros
AnnaBridge 172:65be27845400 437 * @{
AnnaBridge 172:65be27845400 438 */
AnnaBridge 172:65be27845400 439
AnnaBridge 172:65be27845400 440 /** @defgroup CRYP_IS_CRYP_Definitions CRYP Private macros to check input parameters
AnnaBridge 172:65be27845400 441 * @{
AnnaBridge 172:65be27845400 442 */
AnnaBridge 172:65be27845400 443
AnnaBridge 172:65be27845400 444 #define IS_CRYP_ALGORITHM(ALGORITHM) (((ALGORITHM) == CRYP_DES_ECB) || \
AnnaBridge 172:65be27845400 445 ((ALGORITHM) == CRYP_DES_CBC) || \
AnnaBridge 172:65be27845400 446 ((ALGORITHM) == CRYP_TDES_ECB) || \
AnnaBridge 172:65be27845400 447 ((ALGORITHM) == CRYP_TDES_CBC) || \
AnnaBridge 172:65be27845400 448 ((ALGORITHM) == CRYP_AES_ECB) || \
AnnaBridge 172:65be27845400 449 ((ALGORITHM) == CRYP_AES_CBC) || \
AnnaBridge 172:65be27845400 450 ((ALGORITHM) == CRYP_AES_CTR) || \
AnnaBridge 172:65be27845400 451 ((ALGORITHM) == CRYP_AES_GCM) || \
AnnaBridge 172:65be27845400 452 ((ALGORITHM) == CRYP_AES_CCM))
AnnaBridge 172:65be27845400 453
AnnaBridge 172:65be27845400 454 #define IS_CRYP_KEYSIZE(KEYSIZE)(((KEYSIZE) == CRYP_KEYSIZE_128B) || \
AnnaBridge 172:65be27845400 455 ((KEYSIZE) == CRYP_KEYSIZE_192B) || \
AnnaBridge 172:65be27845400 456 ((KEYSIZE) == CRYP_KEYSIZE_256B))
AnnaBridge 172:65be27845400 457
AnnaBridge 172:65be27845400 458 #define IS_CRYP_DATATYPE(DATATYPE)(((DATATYPE) == CRYP_DATATYPE_32B) || \
AnnaBridge 172:65be27845400 459 ((DATATYPE) == CRYP_DATATYPE_16B) || \
AnnaBridge 172:65be27845400 460 ((DATATYPE) == CRYP_DATATYPE_8B) || \
AnnaBridge 172:65be27845400 461 ((DATATYPE) == CRYP_DATATYPE_1B))
AnnaBridge 172:65be27845400 462
AnnaBridge 172:65be27845400 463 /**
AnnaBridge 172:65be27845400 464 * @}
AnnaBridge 172:65be27845400 465 */
AnnaBridge 172:65be27845400 466
AnnaBridge 172:65be27845400 467 /**
AnnaBridge 172:65be27845400 468 * @}
AnnaBridge 172:65be27845400 469 */
AnnaBridge 172:65be27845400 470
AnnaBridge 172:65be27845400 471
AnnaBridge 172:65be27845400 472 /* Private constants ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 473 /** @defgroup CRYP_Private_Constants CRYP Private Constants
AnnaBridge 172:65be27845400 474 * @{
AnnaBridge 172:65be27845400 475 */
AnnaBridge 172:65be27845400 476
AnnaBridge 172:65be27845400 477 /**
AnnaBridge 172:65be27845400 478 * @}
AnnaBridge 172:65be27845400 479 */
AnnaBridge 172:65be27845400 480 /* Private defines -----------------------------------------------------------*/
AnnaBridge 172:65be27845400 481 /** @defgroup CRYP_Private_Defines CRYP Private Defines
AnnaBridge 172:65be27845400 482 * @{
AnnaBridge 172:65be27845400 483 */
AnnaBridge 172:65be27845400 484
AnnaBridge 172:65be27845400 485 /**
AnnaBridge 172:65be27845400 486 * @}
AnnaBridge 172:65be27845400 487 */
AnnaBridge 172:65be27845400 488
AnnaBridge 172:65be27845400 489 /* Private variables ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 490 /** @defgroup CRYP_Private_Variables CRYP Private Variables
AnnaBridge 172:65be27845400 491 * @{
AnnaBridge 172:65be27845400 492 */
AnnaBridge 172:65be27845400 493
AnnaBridge 172:65be27845400 494 /**
AnnaBridge 172:65be27845400 495 * @}
AnnaBridge 172:65be27845400 496 */
AnnaBridge 172:65be27845400 497 /* Private functions prototypes ----------------------------------------------*/
AnnaBridge 172:65be27845400 498 /** @defgroup CRYP_Private_Functions_Prototypes CRYP Private Functions Prototypes
AnnaBridge 172:65be27845400 499 * @{
AnnaBridge 172:65be27845400 500 */
AnnaBridge 172:65be27845400 501
AnnaBridge 172:65be27845400 502 /**
AnnaBridge 172:65be27845400 503 * @}
AnnaBridge 172:65be27845400 504 */
AnnaBridge 172:65be27845400 505
AnnaBridge 172:65be27845400 506 /* Private functions ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 507 /** @defgroup CRYP_Private_Functions CRYP Private Functions
AnnaBridge 172:65be27845400 508 * @{
AnnaBridge 172:65be27845400 509 */
AnnaBridge 172:65be27845400 510
AnnaBridge 172:65be27845400 511 /**
AnnaBridge 172:65be27845400 512 * @}
AnnaBridge 172:65be27845400 513 */
AnnaBridge 172:65be27845400 514
AnnaBridge 172:65be27845400 515
AnnaBridge 172:65be27845400 516 /**
AnnaBridge 172:65be27845400 517 * @}
AnnaBridge 172:65be27845400 518 */
AnnaBridge 172:65be27845400 519
AnnaBridge 172:65be27845400 520
AnnaBridge 172:65be27845400 521 #endif /* CRYP */
AnnaBridge 172:65be27845400 522 /**
AnnaBridge 172:65be27845400 523 * @}
AnnaBridge 172:65be27845400 524 */
AnnaBridge 172:65be27845400 525
AnnaBridge 172:65be27845400 526 #ifdef __cplusplus
AnnaBridge 172:65be27845400 527 }
AnnaBridge 172:65be27845400 528 #endif
AnnaBridge 172:65be27845400 529
AnnaBridge 172:65be27845400 530 #endif /* STM32H7xx_HAL_CRYP_H */
AnnaBridge 172:65be27845400 531
AnnaBridge 172:65be27845400 532 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/