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_MTS_MDOT_F405RG/stm32f4xx_hal_cryp_ex.h@106:ba1f97679dad, 2015-09-02 (annotated)

Committer:
Kojto
Date:
Wed Sep 02 14:17:43 2015 +0100
Revision:
106:ba1f97679dad
Parent:
99:dbbf35b96557
Child:
110:165afa46840b
Release 106  of the mbed library



Changes:

- new platform - Nucleo F446RE

- STM32F4 Cube driver update v2.3.2

- ST cmsis driver v2.3.2

- nordic bugfix gcc linker start address

- lpc11u68 - bugfix for serial ports

Who changed what in which revision?

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