Lancaster University / mbed-src

Lancaster University's (short term!) clone of mbed-src for micro:bit. This is a copy of the github branch https://github.com/lancaster-university/mbed-classic

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_cryp_ex.h@610:813dcc80987e, 2015-08-14 (annotated)

Committer:
mbed_official
Date:
Fri Aug 14 13:15:17 2015 +0100
Revision:
610:813dcc80987e
Parent:
573:ad23fe03a082 
Synchronized with git revision 6d84db41c6833e0b9b024741eb0616a5f62d5599



Full URL: https://github.com/mbedmicro/mbed/commit/6d84db41c6833e0b9b024741eb0616a5f62d5599/



DISCO_F746NG - Improvements

Who changed what in which revision?

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