Ricardo Benitez / mbed

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed by mbed official

TARGET_DISCO_F746NG/stm32f7xx_hal_cryp_ex.h@107:4f6c30876dfa, 2015-09-16 (annotated)

Committer:
Kojto
Date:
Wed Sep 16 15:32:31 2015 +0100
Revision:
107:4f6c30876dfa
Child:
116:c0f6e94411f5
Release 107  of the mbed library



Changes:

- new platforms - DISCO_F746NG, DISCO_L476VG, NUCLEO_L476RG

- KL43Z - bugfix RTC init function

- K20 - SPI mode fix

Who changed what in which revision?

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