stm32l4xx_hal_cryp_ex.h

00001 /**
00002   ******************************************************************************
00003   * @file    stm32l4xx_hal_cryp_ex.h
00004   * @author  MCD Application Team
00005   * @version V1.5.1
00006   * @date    31-May-2016
00007   * @brief   Header file of CRYPEx HAL module.
00008   ******************************************************************************
00009   * @attention
00010   *
00011   * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
00012   *
00013   * Redistribution and use in source and binary forms, with or without modification,
00014   * are permitted provided that the following conditions are met:
00015   *   1. Redistributions of source code must retain the above copyright notice,
00016   *      this list of conditions and the following disclaimer.
00017   *   2. Redistributions in binary form must reproduce the above copyright notice,
00018   *      this list of conditions and the following disclaimer in the documentation
00019   *      and/or other materials provided with the distribution.
00020   *   3. Neither the name of STMicroelectronics nor the names of its contributors
00021   *      may be used to endorse or promote products derived from this software
00022   *      without specific prior written permission.
00023   *
00024   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00025   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00026   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00027   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
00028   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00029   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
00030   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00031   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00032   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
00033   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00034   *
00035   ******************************************************************************
00036   */ 
00037 
00038 /* Define to prevent recursive inclusion -------------------------------------*/
00039 #ifndef __STM32L4xx_HAL_CRYP_EX_H
00040 #define __STM32L4xx_HAL_CRYP_EX_H
00041 
00042 #ifdef __cplusplus
00043  extern "C" {
00044 #endif
00045 
00046 #if defined (STM32L442xx) || defined (STM32L443xx) || defined(STM32L485xx) || defined(STM32L486xx)
00047    
00048 
00049 /* Includes ------------------------------------------------------------------*/
00050 #include "stm32l4xx_hal_def.h"
00051 
00052 /** @addtogroup STM32L4xx_HAL_Driver
00053   * @{
00054   */
00055 
00056 /** @addtogroup CRYPEx
00057   * @{
00058   */ 
00059 
00060 /* Exported types ------------------------------------------------------------*/ 
00061 /* Exported constants --------------------------------------------------------*/
00062 /* Exported functions --------------------------------------------------------*/
00063 
00064 /** @addtogroup CRYPEx_Exported_Functions
00065   * @{
00066   */
00067 
00068 /** @addtogroup CRYPEx_Exported_Functions_Group1
00069   * @{
00070   */
00071 
00072 /* CallBack functions  ********************************************************/
00073 void HAL_CRYPEx_ComputationCpltCallback(CRYP_HandleTypeDef *hcryp);
00074 
00075 /**
00076   * @}
00077   */ 
00078 
00079 /** @addtogroup CRYPEx_Exported_Functions_Group2
00080   * @{
00081   */
00082 
00083 /* AES encryption/decryption processing functions  ****************************/
00084 HAL_StatusTypeDef HAL_CRYPEx_AES(CRYP_HandleTypeDef *hcryp, uint8_t *pInputData, uint16_t Size, uint8_t *pOutputData, uint32_t Timeout);
00085 HAL_StatusTypeDef HAL_CRYPEx_AES_IT(CRYP_HandleTypeDef *hcryp,  uint8_t *pInputData, uint16_t Size, uint8_t *pOutputData);
00086 HAL_StatusTypeDef HAL_CRYPEx_AES_DMA(CRYP_HandleTypeDef *hcryp,  uint8_t *pInputData, uint16_t Size, uint8_t *pOutputData);
00087 
00088 /* AES encryption/decryption/authentication processing functions  *************/
00089 HAL_StatusTypeDef HAL_CRYPEx_AES_Auth(CRYP_HandleTypeDef *hcryp, uint8_t *pInputData, uint64_t Size, uint8_t *pOutputData, uint32_t Timeout);
00090 HAL_StatusTypeDef HAL_CRYPEx_AES_Auth_IT(CRYP_HandleTypeDef *hcryp, uint8_t *pInputData, uint64_t Size, uint8_t *pOutputData);
00091 HAL_StatusTypeDef HAL_CRYPEx_AES_Auth_DMA(CRYP_HandleTypeDef *hcryp, uint8_t *pInputData, uint64_t Size, uint8_t *pOutputData);
00092 
00093 /**
00094   * @}
00095   */ 
00096 
00097 /** @addtogroup CRYPEx_Exported_Functions_Group3
00098   * @{
00099   */
00100 
00101 /* AES suspension/resumption functions  ***************************************/
00102 void HAL_CRYPEx_Read_IVRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Output);
00103 void HAL_CRYPEx_Write_IVRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Input);
00104 void HAL_CRYPEx_Read_SuspendRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Output);
00105 void HAL_CRYPEx_Write_SuspendRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Input);
00106 void HAL_CRYPEx_Read_KeyRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Output, uint32_t KeySize);
00107 void HAL_CRYPEx_Write_KeyRegisters(CRYP_HandleTypeDef *hcryp, uint8_t* Input, uint32_t KeySize);
00108 void HAL_CRYPEx_Read_ControlRegister(CRYP_HandleTypeDef *hcryp, uint8_t* Output);
00109 void HAL_CRYPEx_Write_ControlRegister(CRYP_HandleTypeDef *hcryp, uint8_t* Input);
00110 void HAL_CRYPEx_ProcessSuspend(CRYP_HandleTypeDef *hcryp);
00111 
00112 /**
00113   * @}
00114   */  
00115   
00116 
00117 /**
00118   * @}
00119   */ 
00120   
00121 /* Private functions -----------------------------------------------------------*/
00122 /** @addtogroup CRYPEx_Private_Functions CRYPEx Private Functions
00123   * @{
00124   */
00125 HAL_StatusTypeDef CRYP_AES_Auth_IT(CRYP_HandleTypeDef *hcryp);
00126 
00127 /**
00128   * @}
00129   */
00130   
00131 
00132 /**
00133   * @}
00134   */ 
00135 
00136 /**
00137   * @}
00138   */ 
00139   
00140 #endif /* defined (STM32L442xx) || defined (STM32L443xx) || defined(STM32L485xx) || defined(STM32L486xx) */     
00141   
00142 #ifdef __cplusplus
00143 }
00144 #endif
00145 
00146 #endif /* __STM32L4xx_HAL_CRYP_EX_H */
00147 
00148 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/