Ricardo Benitez / mbed

meh

Fork of mbed by mbed official

TARGET_NUCLEO_F411RE/stm32f4xx_hal_cryp.h@118:16969dd821af, 2016-04-05 (annotated)

Committer:
ricardobtez
Date:
Tue Apr 05 23:51:21 2016 +0000
Revision:
118:16969dd821af
Parent:
86:04dd9b1680ae
Child:
99:dbbf35b96557
dgdgr

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 86:04dd9b1680ae 1 /**
bogdanm 86:04dd9b1680ae 2 ******************************************************************************
bogdanm 86:04dd9b1680ae 3 * @file stm32f4xx_hal_cryp.h
bogdanm 86:04dd9b1680ae 4 * @author MCD Application Team
bogdanm 86:04dd9b1680ae 5 * @version V1.1.0
bogdanm 86:04dd9b1680ae 6 * @date 19-June-2014
bogdanm 86:04dd9b1680ae 7 * @brief Header file of CRYP HAL module.
bogdanm 86:04dd9b1680ae 8 ******************************************************************************
bogdanm 86:04dd9b1680ae 9 * @attention
bogdanm 86:04dd9b1680ae 10 *
bogdanm 86:04dd9b1680ae 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm 86:04dd9b1680ae 12 *
bogdanm 86:04dd9b1680ae 13 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 86:04dd9b1680ae 14 * are permitted provided that the following conditions are met:
bogdanm 86:04dd9b1680ae 15 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 86:04dd9b1680ae 16 * this list of conditions and the following disclaimer.
bogdanm 86:04dd9b1680ae 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 86:04dd9b1680ae 18 * this list of conditions and the following disclaimer in the documentation
bogdanm 86:04dd9b1680ae 19 * and/or other materials provided with the distribution.
bogdanm 86:04dd9b1680ae 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 86:04dd9b1680ae 21 * may be used to endorse or promote products derived from this software
bogdanm 86:04dd9b1680ae 22 * without specific prior written permission.
bogdanm 86:04dd9b1680ae 23 *
bogdanm 86:04dd9b1680ae 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 86:04dd9b1680ae 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 86:04dd9b1680ae 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 86:04dd9b1680ae 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 86:04dd9b1680ae 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 86:04dd9b1680ae 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 86:04dd9b1680ae 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 86:04dd9b1680ae 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 86:04dd9b1680ae 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 86:04dd9b1680ae 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 86:04dd9b1680ae 34 *
bogdanm 86:04dd9b1680ae 35 ******************************************************************************
bogdanm 86:04dd9b1680ae 36 */
bogdanm 86:04dd9b1680ae 37
bogdanm 86:04dd9b1680ae 38 /* Define to prevent recursive inclusion -------------------------------------*/
bogdanm 86:04dd9b1680ae 39 #ifndef __STM32F4xx_HAL_CRYP_H
bogdanm 86:04dd9b1680ae 40 #define __STM32F4xx_HAL_CRYP_H
bogdanm 86:04dd9b1680ae 41
bogdanm 86:04dd9b1680ae 42 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 43 extern "C" {
bogdanm 86:04dd9b1680ae 44 #endif
bogdanm 86:04dd9b1680ae 45
bogdanm 86:04dd9b1680ae 46 #if defined(STM32F415xx) || defined(STM32F417xx) || defined(STM32F437xx) || defined(STM32F439xx)
bogdanm 86:04dd9b1680ae 47 /* Includes ------------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 48 #include "stm32f4xx_hal_def.h"
bogdanm 86:04dd9b1680ae 49
bogdanm 86:04dd9b1680ae 50 /** @addtogroup STM32F4xx_HAL_Driver
bogdanm 86:04dd9b1680ae 51 * @{
bogdanm 86:04dd9b1680ae 52 */
bogdanm 86:04dd9b1680ae 53
bogdanm 86:04dd9b1680ae 54 /** @addtogroup CRYP
bogdanm 86:04dd9b1680ae 55 * @{
bogdanm 86:04dd9b1680ae 56 */
bogdanm 86:04dd9b1680ae 57
bogdanm 86:04dd9b1680ae 58 /* Exported types ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 59
bogdanm 86:04dd9b1680ae 60 /**
bogdanm 86:04dd9b1680ae 61 * @brief CRYP Configuration Structure definition
bogdanm 86:04dd9b1680ae 62 */
bogdanm 86:04dd9b1680ae 63 typedef struct
bogdanm 86:04dd9b1680ae 64 {
bogdanm 86:04dd9b1680ae 65 uint32_t DataType; /*!< 32-bit data, 16-bit data, 8-bit data or 1-bit string.
bogdanm 86:04dd9b1680ae 66 This parameter can be a value of @ref CRYP_Data_Type */
bogdanm 86:04dd9b1680ae 67
bogdanm 86:04dd9b1680ae 68 uint32_t KeySize; /*!< Used only in AES mode only : 128, 192 or 256 bit key length.
bogdanm 86:04dd9b1680ae 69 This parameter can be a value of @ref CRYP_Key_Size */
bogdanm 86:04dd9b1680ae 70
bogdanm 86:04dd9b1680ae 71 uint8_t* pKey; /*!< The key used for encryption/decryption */
bogdanm 86:04dd9b1680ae 72
bogdanm 86:04dd9b1680ae 73 uint8_t* pInitVect; /*!< The initialization vector used also as initialization
bogdanm 86:04dd9b1680ae 74 counter in CTR mode */
bogdanm 86:04dd9b1680ae 75
bogdanm 86:04dd9b1680ae 76 uint8_t IVSize; /*!< The size of initialization vector.
bogdanm 86:04dd9b1680ae 77 This parameter (called nonce size in CCM) is used only
bogdanm 86:04dd9b1680ae 78 in AES-128/192/256 encryption/decryption CCM mode */
bogdanm 86:04dd9b1680ae 79
bogdanm 86:04dd9b1680ae 80 uint8_t TagSize; /*!< The size of returned authentication TAG.
bogdanm 86:04dd9b1680ae 81 This parameter is used only in AES-128/192/256
bogdanm 86:04dd9b1680ae 82 encryption/decryption CCM mode */
bogdanm 86:04dd9b1680ae 83
bogdanm 86:04dd9b1680ae 84 uint8_t* Header; /*!< The header used in GCM and CCM modes */
bogdanm 86:04dd9b1680ae 85
bogdanm 86:04dd9b1680ae 86 uint16_t HeaderSize; /*!< The size of header buffer in bytes */
bogdanm 86:04dd9b1680ae 87
bogdanm 86:04dd9b1680ae 88 uint8_t* pScratch; /*!< Scratch buffer used to append the header. It's size must be equal to header size + 21 bytes.
bogdanm 86:04dd9b1680ae 89 This parameter is used only in AES-128/192/256 encryption/decryption CCM mode */
bogdanm 86:04dd9b1680ae 90 }CRYP_InitTypeDef;
bogdanm 86:04dd9b1680ae 91
bogdanm 86:04dd9b1680ae 92 /**
bogdanm 86:04dd9b1680ae 93 * @brief HAL CRYP State structures definition
bogdanm 86:04dd9b1680ae 94 */
bogdanm 86:04dd9b1680ae 95 typedef enum
bogdanm 86:04dd9b1680ae 96 {
bogdanm 86:04dd9b1680ae 97 HAL_CRYP_STATE_RESET = 0x00, /*!< CRYP not yet initialized or disabled */
bogdanm 86:04dd9b1680ae 98 HAL_CRYP_STATE_READY = 0x01, /*!< CRYP initialized and ready for use */
bogdanm 86:04dd9b1680ae 99 HAL_CRYP_STATE_BUSY = 0x02, /*!< CRYP internal processing is ongoing */
bogdanm 86:04dd9b1680ae 100 HAL_CRYP_STATE_TIMEOUT = 0x03, /*!< CRYP timeout state */
bogdanm 86:04dd9b1680ae 101 HAL_CRYP_STATE_ERROR = 0x04 /*!< CRYP error state */
bogdanm 86:04dd9b1680ae 102 }HAL_CRYP_STATETypeDef;
bogdanm 86:04dd9b1680ae 103
bogdanm 86:04dd9b1680ae 104 /**
bogdanm 86:04dd9b1680ae 105 * @brief HAL CRYP phase structures definition
bogdanm 86:04dd9b1680ae 106 */
bogdanm 86:04dd9b1680ae 107 typedef enum
bogdanm 86:04dd9b1680ae 108 {
bogdanm 86:04dd9b1680ae 109 HAL_CRYP_PHASE_READY = 0x01, /*!< CRYP peripheral is ready for initialization. */
bogdanm 86:04dd9b1680ae 110 HAL_CRYP_PHASE_PROCESS = 0x02, /*!< CRYP peripheral is in processing phase */
bogdanm 86:04dd9b1680ae 111 HAL_CRYP_PHASE_FINAL = 0x03 /*!< CRYP peripheral is in final phase
bogdanm 86:04dd9b1680ae 112 This is relevant only with CCM and GCM modes */
bogdanm 86:04dd9b1680ae 113 }HAL_PhaseTypeDef;
bogdanm 86:04dd9b1680ae 114
bogdanm 86:04dd9b1680ae 115 /**
bogdanm 86:04dd9b1680ae 116 * @brief CRYP handle Structure definition
bogdanm 86:04dd9b1680ae 117 */
bogdanm 86:04dd9b1680ae 118 typedef struct
bogdanm 86:04dd9b1680ae 119 {
bogdanm 86:04dd9b1680ae 120 CRYP_InitTypeDef Init; /*!< CRYP required parameters */
bogdanm 86:04dd9b1680ae 121
bogdanm 86:04dd9b1680ae 122 uint8_t *pCrypInBuffPtr; /*!< Pointer to CRYP processing (encryption, decryption,...) buffer */
bogdanm 86:04dd9b1680ae 123
bogdanm 86:04dd9b1680ae 124 uint8_t *pCrypOutBuffPtr; /*!< Pointer to CRYP processing (encryption, decryption,...) buffer */
bogdanm 86:04dd9b1680ae 125
bogdanm 86:04dd9b1680ae 126 __IO uint16_t CrypInCount; /*!< Counter of inputed data */
bogdanm 86:04dd9b1680ae 127
bogdanm 86:04dd9b1680ae 128 __IO uint16_t CrypOutCount; /*!< Counter of outputed data */
bogdanm 86:04dd9b1680ae 129
bogdanm 86:04dd9b1680ae 130 HAL_StatusTypeDef Status; /*!< CRYP peripheral status */
bogdanm 86:04dd9b1680ae 131
bogdanm 86:04dd9b1680ae 132 HAL_PhaseTypeDef Phase; /*!< CRYP peripheral phase */
bogdanm 86:04dd9b1680ae 133
bogdanm 86:04dd9b1680ae 134 DMA_HandleTypeDef *hdmain; /*!< CRYP In DMA handle parameters */
bogdanm 86:04dd9b1680ae 135
bogdanm 86:04dd9b1680ae 136 DMA_HandleTypeDef *hdmaout; /*!< CRYP Out DMA handle parameters */
bogdanm 86:04dd9b1680ae 137
bogdanm 86:04dd9b1680ae 138 HAL_LockTypeDef Lock; /*!< CRYP locking object */
bogdanm 86:04dd9b1680ae 139
bogdanm 86:04dd9b1680ae 140 __IO HAL_CRYP_STATETypeDef State; /*!< CRYP peripheral state */
bogdanm 86:04dd9b1680ae 141 }CRYP_HandleTypeDef;
bogdanm 86:04dd9b1680ae 142
bogdanm 86:04dd9b1680ae 143 /* Exported constants --------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 144
bogdanm 86:04dd9b1680ae 145 /** @defgroup CRYP_Exported_Constants
bogdanm 86:04dd9b1680ae 146 * @{
bogdanm 86:04dd9b1680ae 147 */
bogdanm 86:04dd9b1680ae 148
bogdanm 86:04dd9b1680ae 149 /** @defgroup CRYP_Key_Size
bogdanm 86:04dd9b1680ae 150 * @{
bogdanm 86:04dd9b1680ae 151 */
bogdanm 86:04dd9b1680ae 152 #define CRYP_KEYSIZE_128B ((uint32_t)0x00000000)
bogdanm 86:04dd9b1680ae 153 #define CRYP_KEYSIZE_192B CRYP_CR_KEYSIZE_0
bogdanm 86:04dd9b1680ae 154 #define CRYP_KEYSIZE_256B CRYP_CR_KEYSIZE_1
bogdanm 86:04dd9b1680ae 155
bogdanm 86:04dd9b1680ae 156 #define IS_CRYP_KEYSIZE(KEYSIZE) (((KEYSIZE) == CRYP_KEYSIZE_128B) || \
bogdanm 86:04dd9b1680ae 157 ((KEYSIZE) == CRYP_KEYSIZE_192B) || \
bogdanm 86:04dd9b1680ae 158 ((KEYSIZE) == CRYP_KEYSIZE_256B))
bogdanm 86:04dd9b1680ae 159 /**
bogdanm 86:04dd9b1680ae 160 * @}
bogdanm 86:04dd9b1680ae 161 */
bogdanm 86:04dd9b1680ae 162
bogdanm 86:04dd9b1680ae 163 /** @defgroup CRYP_Data_Type
bogdanm 86:04dd9b1680ae 164 * @{
bogdanm 86:04dd9b1680ae 165 */
bogdanm 86:04dd9b1680ae 166 #define CRYP_DATATYPE_32B ((uint32_t)0x00000000)
bogdanm 86:04dd9b1680ae 167 #define CRYP_DATATYPE_16B CRYP_CR_DATATYPE_0
bogdanm 86:04dd9b1680ae 168 #define CRYP_DATATYPE_8B CRYP_CR_DATATYPE_1
bogdanm 86:04dd9b1680ae 169 #define CRYP_DATATYPE_1B CRYP_CR_DATATYPE
bogdanm 86:04dd9b1680ae 170
bogdanm 86:04dd9b1680ae 171 #define IS_CRYP_DATATYPE(DATATYPE) (((DATATYPE) == CRYP_DATATYPE_32B) || \
bogdanm 86:04dd9b1680ae 172 ((DATATYPE) == CRYP_DATATYPE_16B) || \
bogdanm 86:04dd9b1680ae 173 ((DATATYPE) == CRYP_DATATYPE_8B) || \
bogdanm 86:04dd9b1680ae 174 ((DATATYPE) == CRYP_DATATYPE_1B))
bogdanm 86:04dd9b1680ae 175 /**
bogdanm 86:04dd9b1680ae 176 * @}
bogdanm 86:04dd9b1680ae 177 */
bogdanm 86:04dd9b1680ae 178
bogdanm 86:04dd9b1680ae 179 /** @defgroup CRYP_AlgoModeDirection
bogdanm 86:04dd9b1680ae 180 * @{
bogdanm 86:04dd9b1680ae 181 */
bogdanm 86:04dd9b1680ae 182 #define CRYP_CR_ALGOMODE_DIRECTION ((uint32_t)0x0008003C)
bogdanm 86:04dd9b1680ae 183 #define CRYP_CR_ALGOMODE_TDES_ECB_ENCRYPT ((uint32_t)0x00000000)
bogdanm 86:04dd9b1680ae 184 #define CRYP_CR_ALGOMODE_TDES_ECB_DECRYPT ((uint32_t)0x00000004)
bogdanm 86:04dd9b1680ae 185 #define CRYP_CR_ALGOMODE_TDES_CBC_ENCRYPT ((uint32_t)0x00000008)
bogdanm 86:04dd9b1680ae 186 #define CRYP_CR_ALGOMODE_TDES_CBC_DECRYPT ((uint32_t)0x0000000C)
bogdanm 86:04dd9b1680ae 187 #define CRYP_CR_ALGOMODE_DES_ECB_ENCRYPT ((uint32_t)0x00000010)
bogdanm 86:04dd9b1680ae 188 #define CRYP_CR_ALGOMODE_DES_ECB_DECRYPT ((uint32_t)0x00000014)
bogdanm 86:04dd9b1680ae 189 #define CRYP_CR_ALGOMODE_DES_CBC_ENCRYPT ((uint32_t)0x00000018)
bogdanm 86:04dd9b1680ae 190 #define CRYP_CR_ALGOMODE_DES_CBC_DECRYPT ((uint32_t)0x0000001C)
bogdanm 86:04dd9b1680ae 191 #define CRYP_CR_ALGOMODE_AES_ECB_ENCRYPT ((uint32_t)0x00000020)
bogdanm 86:04dd9b1680ae 192 #define CRYP_CR_ALGOMODE_AES_ECB_DECRYPT ((uint32_t)0x00000024)
bogdanm 86:04dd9b1680ae 193 #define CRYP_CR_ALGOMODE_AES_CBC_ENCRYPT ((uint32_t)0x00000028)
bogdanm 86:04dd9b1680ae 194 #define CRYP_CR_ALGOMODE_AES_CBC_DECRYPT ((uint32_t)0x0000002C)
bogdanm 86:04dd9b1680ae 195 #define CRYP_CR_ALGOMODE_AES_CTR_ENCRYPT ((uint32_t)0x00000030)
bogdanm 86:04dd9b1680ae 196 #define CRYP_CR_ALGOMODE_AES_CTR_DECRYPT ((uint32_t)0x00000034)
bogdanm 86:04dd9b1680ae 197 /**
bogdanm 86:04dd9b1680ae 198 * @}
bogdanm 86:04dd9b1680ae 199 */
bogdanm 86:04dd9b1680ae 200
bogdanm 86:04dd9b1680ae 201 /** @defgroup CRYP_Interrupt
bogdanm 86:04dd9b1680ae 202 * @{
bogdanm 86:04dd9b1680ae 203 */
bogdanm 86:04dd9b1680ae 204 #define CRYP_IT_INI ((uint32_t)CRYP_IMSCR_INIM) /*!< Input FIFO Interrupt */
bogdanm 86:04dd9b1680ae 205 #define CRYP_IT_OUTI ((uint32_t)CRYP_IMSCR_OUTIM) /*!< Output FIFO Interrupt */
bogdanm 86:04dd9b1680ae 206 /**
bogdanm 86:04dd9b1680ae 207 * @}
bogdanm 86:04dd9b1680ae 208 */
bogdanm 86:04dd9b1680ae 209
bogdanm 86:04dd9b1680ae 210 /** @defgroup CRYP_Flags
bogdanm 86:04dd9b1680ae 211 * @{
bogdanm 86:04dd9b1680ae 212 */
bogdanm 86:04dd9b1680ae 213
bogdanm 86:04dd9b1680ae 214 #define CRYP_FLAG_BUSY ((uint32_t)0x00000010) /*!< The CRYP core is currently
bogdanm 86:04dd9b1680ae 215 processing a block of data
bogdanm 86:04dd9b1680ae 216 or a key preparation (for
bogdanm 86:04dd9b1680ae 217 AES decryption). */
bogdanm 86:04dd9b1680ae 218 #define CRYP_FLAG_IFEM ((uint32_t)0x00000001) /*!< Input FIFO is empty */
bogdanm 86:04dd9b1680ae 219 #define CRYP_FLAG_IFNF ((uint32_t)0x00000002) /*!< Input FIFO is not Full */
bogdanm 86:04dd9b1680ae 220 #define CRYP_FLAG_OFNE ((uint32_t)0x00000004) /*!< Output FIFO is not empty */
bogdanm 86:04dd9b1680ae 221 #define CRYP_FLAG_OFFU ((uint32_t)0x00000008) /*!< Output FIFO is Full */
bogdanm 86:04dd9b1680ae 222 #define CRYP_FLAG_OUTRIS ((uint32_t)0x01000002) /*!< Output FIFO service raw
bogdanm 86:04dd9b1680ae 223 interrupt status */
bogdanm 86:04dd9b1680ae 224 #define CRYP_FLAG_INRIS ((uint32_t)0x01000001) /*!< Input FIFO service raw
bogdanm 86:04dd9b1680ae 225 interrupt status */
bogdanm 86:04dd9b1680ae 226 /**
bogdanm 86:04dd9b1680ae 227 * @}
bogdanm 86:04dd9b1680ae 228 */
bogdanm 86:04dd9b1680ae 229
bogdanm 86:04dd9b1680ae 230 /**
bogdanm 86:04dd9b1680ae 231 * @}
bogdanm 86:04dd9b1680ae 232 */
bogdanm 86:04dd9b1680ae 233
bogdanm 86:04dd9b1680ae 234 /* Exported macro ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 235
bogdanm 86:04dd9b1680ae 236 /** @brief Reset CRYP handle state
bogdanm 86:04dd9b1680ae 237 * @param __HANDLE__: specifies the CRYP handle.
bogdanm 86:04dd9b1680ae 238 * @retval None
bogdanm 86:04dd9b1680ae 239 */
bogdanm 86:04dd9b1680ae 240 #define __HAL_CRYP_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_CRYP_STATE_RESET)
bogdanm 86:04dd9b1680ae 241
bogdanm 86:04dd9b1680ae 242 /**
bogdanm 86:04dd9b1680ae 243 * @brief Enable/Disable the CRYP peripheral.
bogdanm 86:04dd9b1680ae 244 * @param None
bogdanm 86:04dd9b1680ae 245 * @retval None
bogdanm 86:04dd9b1680ae 246 */
bogdanm 86:04dd9b1680ae 247 #define __HAL_CRYP_ENABLE() (CRYP->CR |= CRYP_CR_CRYPEN)
bogdanm 86:04dd9b1680ae 248 #define __HAL_CRYP_DISABLE() (CRYP->CR &= ~CRYP_CR_CRYPEN)
bogdanm 86:04dd9b1680ae 249
bogdanm 86:04dd9b1680ae 250 /**
bogdanm 86:04dd9b1680ae 251 * @brief Flush the data FIFO.
bogdanm 86:04dd9b1680ae 252 * @param None
bogdanm 86:04dd9b1680ae 253 * @retval None
bogdanm 86:04dd9b1680ae 254 */
bogdanm 86:04dd9b1680ae 255 #define __HAL_CRYP_FIFO_FLUSH() (CRYP->CR |= CRYP_CR_FFLUSH)
bogdanm 86:04dd9b1680ae 256
bogdanm 86:04dd9b1680ae 257 /**
bogdanm 86:04dd9b1680ae 258 * @brief Set the algorithm mode: AES-ECB, AES-CBC, AES-CTR, DES-ECB, DES-CBC.
bogdanm 86:04dd9b1680ae 259 * @param MODE: The algorithm mode.
bogdanm 86:04dd9b1680ae 260 * @retval None
bogdanm 86:04dd9b1680ae 261 */
bogdanm 86:04dd9b1680ae 262 #define __HAL_CRYP_SET_MODE(MODE) CRYP->CR |= (uint32_t)(MODE)
bogdanm 86:04dd9b1680ae 263
bogdanm 86:04dd9b1680ae 264 /** @brief Check whether the specified CRYP flag is set or not.
bogdanm 86:04dd9b1680ae 265 * @param __FLAG__: specifies the flag to check.
bogdanm 86:04dd9b1680ae 266 * This parameter can be one of the following values:
bogdanm 86:04dd9b1680ae 267 * @arg CRYP_FLAG_BUSY: The CRYP core is currently processing a block of data
bogdanm 86:04dd9b1680ae 268 * or a key preparation (for AES decryption).
bogdanm 86:04dd9b1680ae 269 * @arg CRYP_FLAG_IFEM: Input FIFO is empty
bogdanm 86:04dd9b1680ae 270 * @arg CRYP_FLAG_IFNF: Input FIFO is not full
bogdanm 86:04dd9b1680ae 271 * @arg CRYP_FLAG_INRIS: Input FIFO service raw interrupt is pending
bogdanm 86:04dd9b1680ae 272 * @arg CRYP_FLAG_OFNE: Output FIFO is not empty
bogdanm 86:04dd9b1680ae 273 * @arg CRYP_FLAG_OFFU: Output FIFO is full
bogdanm 86:04dd9b1680ae 274 * @arg CRYP_FLAG_OUTRIS: Input FIFO service raw interrupt is pending
bogdanm 86:04dd9b1680ae 275 * @retval The new state of __FLAG__ (TRUE or FALSE).
bogdanm 86:04dd9b1680ae 276 */
bogdanm 86:04dd9b1680ae 277 #define CRYP_FLAG_MASK ((uint32_t)0x0000001F)
bogdanm 86:04dd9b1680ae 278 #define __HAL_CRYP_GET_FLAG(__FLAG__) ((((uint8_t)((__FLAG__) >> 24)) == 0x01)?(((CRYP->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)): \
bogdanm 86:04dd9b1680ae 279 (((CRYP->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)))
bogdanm 86:04dd9b1680ae 280
bogdanm 86:04dd9b1680ae 281 /** @brief Check whether the specified CRYP interrupt is set or not.
bogdanm 86:04dd9b1680ae 282 * @param __INTERRUPT__: specifies the interrupt to check.
bogdanm 86:04dd9b1680ae 283 * This parameter can be one of the following values:
bogdanm 86:04dd9b1680ae 284 * @arg CRYP_IT_INRIS: Input FIFO service raw interrupt is pending
bogdanm 86:04dd9b1680ae 285 * @arg CRYP_IT_OUTRIS: Output FIFO service raw interrupt is pending
bogdanm 86:04dd9b1680ae 286 * @retval The new state of __INTERRUPT__ (TRUE or FALSE).
bogdanm 86:04dd9b1680ae 287 */
bogdanm 86:04dd9b1680ae 288 #define __HAL_CRYP_GET_IT(__INTERRUPT__) ((CRYP->MISR & (__INTERRUPT__)) == (__INTERRUPT__))
bogdanm 86:04dd9b1680ae 289
bogdanm 86:04dd9b1680ae 290 /**
bogdanm 86:04dd9b1680ae 291 * @brief Enable the CRYP interrupt.
bogdanm 86:04dd9b1680ae 292 * @param __INTERRUPT__: CRYP Interrupt.
bogdanm 86:04dd9b1680ae 293 * @retval None
bogdanm 86:04dd9b1680ae 294 */
bogdanm 86:04dd9b1680ae 295 #define __HAL_CRYP_ENABLE_IT(__INTERRUPT__) ((CRYP->IMSCR) |= (__INTERRUPT__))
bogdanm 86:04dd9b1680ae 296
bogdanm 86:04dd9b1680ae 297 /**
bogdanm 86:04dd9b1680ae 298 * @brief Disable the CRYP interrupt.
bogdanm 86:04dd9b1680ae 299 * @param __INTERRUPT__: CRYP interrupt.
bogdanm 86:04dd9b1680ae 300 * @retval None
bogdanm 86:04dd9b1680ae 301 */
bogdanm 86:04dd9b1680ae 302 #define __HAL_CRYP_DISABLE_IT(__INTERRUPT__) ((CRYP->IMSCR) &= ~(__INTERRUPT__))
bogdanm 86:04dd9b1680ae 303
bogdanm 86:04dd9b1680ae 304 /* Include CRYP HAL Extension module */
bogdanm 86:04dd9b1680ae 305 #include "stm32f4xx_hal_cryp_ex.h"
bogdanm 86:04dd9b1680ae 306
bogdanm 86:04dd9b1680ae 307 /* Exported functions --------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 308 /* Initialization/de-initialization functions ********************************/
bogdanm 86:04dd9b1680ae 309 HAL_StatusTypeDef HAL_CRYP_Init(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 310 HAL_StatusTypeDef HAL_CRYP_DeInit(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 311
bogdanm 86:04dd9b1680ae 312 /* AES encryption/decryption using polling ***********************************/
bogdanm 86:04dd9b1680ae 313 HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 314 HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 315 HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 316 HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 317 HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 318 HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 319
bogdanm 86:04dd9b1680ae 320 /* AES encryption/decryption using interrupt *********************************/
bogdanm 86:04dd9b1680ae 321 HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 322 HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 323 HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 324 HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 325 HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 326 HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 327
bogdanm 86:04dd9b1680ae 328 /* AES encryption/decryption using DMA ***************************************/
bogdanm 86:04dd9b1680ae 329 HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 330 HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 331 HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 332 HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 333 HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 334 HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 335
bogdanm 86:04dd9b1680ae 336 /* DES encryption/decryption using polling ***********************************/
bogdanm 86:04dd9b1680ae 337 HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 338 HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 339 HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 340 HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 341
bogdanm 86:04dd9b1680ae 342 /* DES encryption/decryption using interrupt *********************************/
bogdanm 86:04dd9b1680ae 343 HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 344 HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 345 HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 346 HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 347
bogdanm 86:04dd9b1680ae 348 /* DES encryption/decryption using DMA ***************************************/
bogdanm 86:04dd9b1680ae 349 HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 350 HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 351 HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 352 HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 353
bogdanm 86:04dd9b1680ae 354 /* TDES encryption/decryption using polling **********************************/
bogdanm 86:04dd9b1680ae 355 HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 356 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 357 HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 358 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
bogdanm 86:04dd9b1680ae 359
bogdanm 86:04dd9b1680ae 360 /* TDES encryption/decryption using interrupt ********************************/
bogdanm 86:04dd9b1680ae 361 HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 362 HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 363 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 364 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 365
bogdanm 86:04dd9b1680ae 366 /* TDES encryption/decryption using DMA **************************************/
bogdanm 86:04dd9b1680ae 367 HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 368 HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 369 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData);
bogdanm 86:04dd9b1680ae 370 HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData);
bogdanm 86:04dd9b1680ae 371
bogdanm 86:04dd9b1680ae 372 /* Processing functions ******************************************************/
bogdanm 86:04dd9b1680ae 373 void HAL_CRYP_IRQHandler(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 374
bogdanm 86:04dd9b1680ae 375 /* Peripheral State functions ************************************************/
bogdanm 86:04dd9b1680ae 376 HAL_CRYP_STATETypeDef HAL_CRYP_GetState(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 377
bogdanm 86:04dd9b1680ae 378 /* MSP functions *************************************************************/
bogdanm 86:04dd9b1680ae 379 void HAL_CRYP_MspInit(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 380 void HAL_CRYP_MspDeInit(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 381
bogdanm 86:04dd9b1680ae 382 /* CallBack functions ********************************************************/
bogdanm 86:04dd9b1680ae 383 void HAL_CRYP_InCpltCallback(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 384 void HAL_CRYP_OutCpltCallback(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 385 void HAL_CRYP_ErrorCallback(CRYP_HandleTypeDef *hcryp);
bogdanm 86:04dd9b1680ae 386
bogdanm 86:04dd9b1680ae 387 #endif /* STM32F415xx || STM32F417xx || STM32F437xx || STM32F439xx */
bogdanm 86:04dd9b1680ae 388
bogdanm 86:04dd9b1680ae 389 /**
bogdanm 86:04dd9b1680ae 390 * @}
bogdanm 86:04dd9b1680ae 391 */
bogdanm 86:04dd9b1680ae 392
bogdanm 86:04dd9b1680ae 393 /**
bogdanm 86:04dd9b1680ae 394 * @}
bogdanm 86:04dd9b1680ae 395 */
bogdanm 86:04dd9b1680ae 396
bogdanm 86:04dd9b1680ae 397 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 398 }
bogdanm 86:04dd9b1680ae 399 #endif
bogdanm 86:04dd9b1680ae 400
bogdanm 86:04dd9b1680ae 401 #endif /* __STM32F4xx_HAL_CRYP_H */
bogdanm 86:04dd9b1680ae 402
bogdanm 86:04dd9b1680ae 403 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/