mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

Revision:
226:b062af740e40
Parent:
106:ced8cbb51063
--- a/targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_cryp_ex.c	Wed Jun 11 09:30:07 2014 +0100
+++ b/targets/cmsis/TARGET_STM/TARGET_NUCLEO_F401RE/stm32f4xx_hal_cryp_ex.c	Wed Jun 11 09:45:09 2014 +0100
@@ -2,8 +2,8 @@
   ******************************************************************************
   * @file    stm32f4xx_hal_cryp_ex.c
   * @author  MCD Application Team
-  * @version V1.0.0
-  * @date    18-February-2014
+  * @version V1.1.0RC2
+  * @date    14-May-2014
   * @brief   Extended CRYP HAL module driver
   *          This file provides firmware functions to manage the following 
   *          functionalities of CRYP extension peripheral:
@@ -153,7 +153,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM encryption mode then 
   *         encrypt pPlainData. The cypher data are available in pCypherData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -407,7 +408,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM encryption mode then 
   *         encrypt pPlainData. The cypher data are available in pCypherData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -504,7 +506,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM decryption mode then
   *         decrypted pCypherData. The cypher data are available in pPlainData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pCypherData: Pointer to the cyphertext buffer
   * @param  Size: Length of the cyphertext buffer, must be a multiple of 16
   * @param  pPlainData: Pointer to the plaintext buffer 
@@ -596,7 +599,8 @@
 
 /**
   * @brief  Computes the authentication TAG.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  Size: Total length of the plain/cyphertext buffer
   * @param  AuthTag: Pointer to the authentication buffer
   * @param  Timeout: Timeout duration
@@ -704,7 +708,8 @@
 /**
   * @brief  Computes the authentication TAG for AES CCM mode.
   * @note   This API is called after HAL_AES_CCM_Encrypt()/HAL_AES_CCM_Decrypt()   
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  AuthTag: Pointer to the authentication buffer
   * @param  Timeout: Timeout duration
   * @retval HAL status
@@ -795,7 +800,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM decryption mode then
   *         decrypted pCypherData. The cypher data are available in pPlainData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -1046,7 +1052,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM encryption mode using IT.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -1196,7 +1203,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM encryption mode using interrupt.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -1494,7 +1502,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM decryption mode using IT.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pCypherData: Pointer to the cyphertext buffer
   * @param  Size: Length of the cyphertext buffer, must be a multiple of 16
   * @param  pPlainData: Pointer to the plaintext buffer
@@ -1641,7 +1650,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM decryption mode using interrupt
   *         then decrypted pCypherData. The cypher data are available in pPlainData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pCypherData: Pointer to the cyphertext buffer 
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pPlainData: Pointer to the plaintext buffer  
@@ -1930,7 +1940,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM encryption mode using DMA.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -2026,7 +2037,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM encryption mode using interrupt.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pPlainData: Pointer to the plaintext buffer
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pCypherData: Pointer to the cyphertext buffer
@@ -2279,7 +2291,8 @@
 
 /**
   * @brief  Initializes the CRYP peripheral in AES GCM decryption mode using DMA.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pCypherData: Pointer to the cyphertext buffer.
   * @param  Size: Length of the cyphertext buffer, must be a multiple of 16
   * @param  pPlainData: Pointer to the plaintext buffer
@@ -2368,7 +2381,8 @@
 /**
   * @brief  Initializes the CRYP peripheral in AES CCM decryption mode using DMA
   *         then decrypted pCypherData. The cypher data are available in pPlainData.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  pCypherData: Pointer to the cyphertext buffer  
   * @param  Size: Length of the plaintext buffer, must be a multiple of 16
   * @param  pPlainData: Pointer to the plaintext buffer  
@@ -2621,7 +2635,8 @@
 
 /**
   * @brief  This function handles CRYP interrupt request.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @retval None
   */
 void HAL_CRYPEx_GCMCCM_IRQHandler(CRYP_HandleTypeDef *hcryp)
@@ -2707,7 +2722,8 @@
 
 /**
   * @brief  Writes the Key in Key registers. 
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  Key: Pointer to Key buffer
   * @param  KeySize: Size of Key
   * @retval None
@@ -2765,7 +2781,8 @@
 
 /**
   * @brief  Writes the InitVector/InitCounter in IV registers.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  InitVector: Pointer to InitVector/InitCounter buffer
   * @param  IVSize: Size of the InitVector/InitCounter
   * @retval None
@@ -2803,7 +2820,8 @@
 
 /**
   * @brief  Process Data: Writes Input data in polling mode and read the Output data.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  Input: Pointer to the Input buffer.
   * @param  Ilength: Length of the Input buffer, must be a multiple of 16
   * @param  Output: Pointer to the returned buffer
@@ -2865,7 +2883,8 @@
 
 /**
   * @brief  Sets the header phase
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  Input: Pointer to the Input buffer.
   * @param  Ilength: Length of the Input buffer, must be a multiple of 16
   * @param  Timeout: Timeout value   
@@ -2947,7 +2966,8 @@
 
 /**
   * @brief  Sets the DMA configuration and start the DMA transfert.
-  * @param  hcryp: CRYP handle
+  * @param  hcryp: pointer to a CRYP_HandleTypeDef structure that contains
+  *         the configuration information for CRYP module
   * @param  inputaddr: Address of the Input buffer
   * @param  Size: Size of the Input buffer, must be a multiple of 16
   * @param  outputaddr: Address of the Output buffer