Zeroday Hong / mbed-dev

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-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F4/stm32f4xx_hal_rng.c@19:112740acecfa, 2015-11-10 (annotated)

Committer:
mbed_official
Date:
Tue Nov 10 09:30:11 2015 +0000
Revision:
19:112740acecfa
Parent:
0:9b334a45a8ff
Child:
144:ef7eb2e8f9f7
Synchronized with git revision 7218418919aeaf775fb8d386ea7ee0dfc0c80ff9



Full URL: https://github.com/mbedmicro/mbed/commit/7218418919aeaf775fb8d386ea7ee0dfc0c80ff9/



DISCO_F469NI - add disco F469NI support

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32f4xx_hal_rng.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
mbed_official 19:112740acecfa 5 * @version V1.4.1
mbed_official 19:112740acecfa 6 * @date 09-October-2015
bogdanm 0:9b334a45a8ff 7 * @brief RNG HAL module driver.
bogdanm 0:9b334a45a8ff 8 * This file provides firmware functions to manage the following
bogdanm 0:9b334a45a8ff 9 * functionalities of the Random Number Generator (RNG) peripheral:
bogdanm 0:9b334a45a8ff 10 * + Initialization/de-initialization functions
bogdanm 0:9b334a45a8ff 11 * + Peripheral Control functions
bogdanm 0:9b334a45a8ff 12 * + Peripheral State functions
bogdanm 0:9b334a45a8ff 13 *
bogdanm 0:9b334a45a8ff 14 @verbatim
bogdanm 0:9b334a45a8ff 15 ==============================================================================
bogdanm 0:9b334a45a8ff 16 ##### How to use this driver #####
bogdanm 0:9b334a45a8ff 17 ==============================================================================
bogdanm 0:9b334a45a8ff 18 [..]
bogdanm 0:9b334a45a8ff 19 The RNG HAL driver can be used as follows:
bogdanm 0:9b334a45a8ff 20
bogdanm 0:9b334a45a8ff 21 (#) Enable the RNG controller clock using __HAL_RCC_RNG_CLK_ENABLE() macro
bogdanm 0:9b334a45a8ff 22 in HAL_RNG_MspInit().
bogdanm 0:9b334a45a8ff 23 (#) Activate the RNG peripheral using HAL_RNG_Init() function.
bogdanm 0:9b334a45a8ff 24 (#) Wait until the 32 bit Random Number Generator contains a valid
bogdanm 0:9b334a45a8ff 25 random data using (polling/interrupt) mode.
bogdanm 0:9b334a45a8ff 26 (#) Get the 32 bit random number using HAL_RNG_GenerateRandomNumber() function.
bogdanm 0:9b334a45a8ff 27
bogdanm 0:9b334a45a8ff 28 @endverbatim
bogdanm 0:9b334a45a8ff 29 ******************************************************************************
bogdanm 0:9b334a45a8ff 30 * @attention
bogdanm 0:9b334a45a8ff 31 *
bogdanm 0:9b334a45a8ff 32 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bogdanm 0:9b334a45a8ff 33 *
bogdanm 0:9b334a45a8ff 34 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 0:9b334a45a8ff 35 * are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 36 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 37 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 38 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 39 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 40 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 41 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 42 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 43 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 44 *
bogdanm 0:9b334a45a8ff 45 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 46 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 47 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 48 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 49 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 50 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 51 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 52 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 53 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 54 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 55 *
bogdanm 0:9b334a45a8ff 56 ******************************************************************************
bogdanm 0:9b334a45a8ff 57 */
bogdanm 0:9b334a45a8ff 58
bogdanm 0:9b334a45a8ff 59 /* Includes ------------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 60 #include "stm32f4xx_hal.h"
bogdanm 0:9b334a45a8ff 61
bogdanm 0:9b334a45a8ff 62 /** @addtogroup STM32F4xx_HAL_Driver
bogdanm 0:9b334a45a8ff 63 * @{
bogdanm 0:9b334a45a8ff 64 */
bogdanm 0:9b334a45a8ff 65
bogdanm 0:9b334a45a8ff 66 /** @addtogroup RNG
bogdanm 0:9b334a45a8ff 67 * @{
bogdanm 0:9b334a45a8ff 68 */
bogdanm 0:9b334a45a8ff 69
bogdanm 0:9b334a45a8ff 70 #ifdef HAL_RNG_MODULE_ENABLED
bogdanm 0:9b334a45a8ff 71
bogdanm 0:9b334a45a8ff 72 #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx) || defined(STM32F417xx) ||\
mbed_official 19:112740acecfa 73 defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx) || defined(STM32F439xx) ||\
mbed_official 19:112740acecfa 74 defined(STM32F410Tx) || defined(STM32F410Cx) || defined(STM32F410Rx) || defined(STM32F469xx) ||\
mbed_official 19:112740acecfa 75 defined(STM32F479xx)
bogdanm 0:9b334a45a8ff 76
bogdanm 0:9b334a45a8ff 77
bogdanm 0:9b334a45a8ff 78 /* Private types -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 79 /* Private defines -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 80 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 81 /* Private constants ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 82 /** @addtogroup RNG_Private_Constants
bogdanm 0:9b334a45a8ff 83 * @{
bogdanm 0:9b334a45a8ff 84 */
bogdanm 0:9b334a45a8ff 85 #define RNG_TIMEOUT_VALUE 2
bogdanm 0:9b334a45a8ff 86 /**
bogdanm 0:9b334a45a8ff 87 * @}
bogdanm 0:9b334a45a8ff 88 */
bogdanm 0:9b334a45a8ff 89 /* Private macros ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 90 /* Private functions prototypes ----------------------------------------------*/
bogdanm 0:9b334a45a8ff 91 /* Private functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 92 /* Exported functions --------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 93
bogdanm 0:9b334a45a8ff 94 /** @addtogroup RNG_Exported_Functions
bogdanm 0:9b334a45a8ff 95 * @{
bogdanm 0:9b334a45a8ff 96 */
bogdanm 0:9b334a45a8ff 97
bogdanm 0:9b334a45a8ff 98 /** @addtogroup RNG_Exported_Functions_Group1
bogdanm 0:9b334a45a8ff 99 * @brief Initialization and de-initialization functions
bogdanm 0:9b334a45a8ff 100 *
bogdanm 0:9b334a45a8ff 101 @verbatim
bogdanm 0:9b334a45a8ff 102 ===============================================================================
bogdanm 0:9b334a45a8ff 103 ##### Initialization and de-initialization functions #####
bogdanm 0:9b334a45a8ff 104 ===============================================================================
bogdanm 0:9b334a45a8ff 105 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 106 (+) Initialize the RNG according to the specified parameters
bogdanm 0:9b334a45a8ff 107 in the RNG_InitTypeDef and create the associated handle
bogdanm 0:9b334a45a8ff 108 (+) DeInitialize the RNG peripheral
bogdanm 0:9b334a45a8ff 109 (+) Initialize the RNG MSP
bogdanm 0:9b334a45a8ff 110 (+) DeInitialize RNG MSP
bogdanm 0:9b334a45a8ff 111
bogdanm 0:9b334a45a8ff 112 @endverbatim
bogdanm 0:9b334a45a8ff 113 * @{
bogdanm 0:9b334a45a8ff 114 */
bogdanm 0:9b334a45a8ff 115
bogdanm 0:9b334a45a8ff 116 /**
bogdanm 0:9b334a45a8ff 117 * @brief Initializes the RNG peripheral and creates the associated handle.
bogdanm 0:9b334a45a8ff 118 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 119 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 120 * @retval HAL status
bogdanm 0:9b334a45a8ff 121 */
bogdanm 0:9b334a45a8ff 122 HAL_StatusTypeDef HAL_RNG_Init(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 123 {
bogdanm 0:9b334a45a8ff 124 /* Check the RNG handle allocation */
bogdanm 0:9b334a45a8ff 125 if(hrng == NULL)
bogdanm 0:9b334a45a8ff 126 {
bogdanm 0:9b334a45a8ff 127 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 128 }
bogdanm 0:9b334a45a8ff 129
bogdanm 0:9b334a45a8ff 130 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 131
bogdanm 0:9b334a45a8ff 132 if(hrng->State == HAL_RNG_STATE_RESET)
bogdanm 0:9b334a45a8ff 133 {
bogdanm 0:9b334a45a8ff 134 /* Allocate lock resource and initialize it */
bogdanm 0:9b334a45a8ff 135 hrng->Lock = HAL_UNLOCKED;
bogdanm 0:9b334a45a8ff 136 /* Init the low level hardware */
bogdanm 0:9b334a45a8ff 137 HAL_RNG_MspInit(hrng);
bogdanm 0:9b334a45a8ff 138 }
bogdanm 0:9b334a45a8ff 139
bogdanm 0:9b334a45a8ff 140 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 141 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 142
bogdanm 0:9b334a45a8ff 143 /* Enable the RNG Peripheral */
bogdanm 0:9b334a45a8ff 144 __HAL_RNG_ENABLE(hrng);
bogdanm 0:9b334a45a8ff 145
bogdanm 0:9b334a45a8ff 146 /* Initialize the RNG state */
bogdanm 0:9b334a45a8ff 147 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 148
bogdanm 0:9b334a45a8ff 149 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 150
bogdanm 0:9b334a45a8ff 151 /* Return function status */
bogdanm 0:9b334a45a8ff 152 return HAL_OK;
bogdanm 0:9b334a45a8ff 153 }
bogdanm 0:9b334a45a8ff 154
bogdanm 0:9b334a45a8ff 155 /**
bogdanm 0:9b334a45a8ff 156 * @brief DeInitializes the RNG peripheral.
bogdanm 0:9b334a45a8ff 157 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 158 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 159 * @retval HAL status
bogdanm 0:9b334a45a8ff 160 */
bogdanm 0:9b334a45a8ff 161 HAL_StatusTypeDef HAL_RNG_DeInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 162 {
bogdanm 0:9b334a45a8ff 163 /* Check the RNG handle allocation */
bogdanm 0:9b334a45a8ff 164 if(hrng == NULL)
bogdanm 0:9b334a45a8ff 165 {
bogdanm 0:9b334a45a8ff 166 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 167 }
bogdanm 0:9b334a45a8ff 168 /* Disable the RNG Peripheral */
bogdanm 0:9b334a45a8ff 169 CLEAR_BIT(hrng->Instance->CR, RNG_CR_IE | RNG_CR_RNGEN);
bogdanm 0:9b334a45a8ff 170
bogdanm 0:9b334a45a8ff 171 /* Clear RNG interrupt status flags */
bogdanm 0:9b334a45a8ff 172 CLEAR_BIT(hrng->Instance->SR, RNG_SR_CEIS | RNG_SR_SEIS);
bogdanm 0:9b334a45a8ff 173
bogdanm 0:9b334a45a8ff 174 /* DeInit the low level hardware */
bogdanm 0:9b334a45a8ff 175 HAL_RNG_MspDeInit(hrng);
bogdanm 0:9b334a45a8ff 176
bogdanm 0:9b334a45a8ff 177 /* Update the RNG state */
bogdanm 0:9b334a45a8ff 178 hrng->State = HAL_RNG_STATE_RESET;
bogdanm 0:9b334a45a8ff 179
bogdanm 0:9b334a45a8ff 180 /* Release Lock */
bogdanm 0:9b334a45a8ff 181 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 182
bogdanm 0:9b334a45a8ff 183 /* Return the function status */
bogdanm 0:9b334a45a8ff 184 return HAL_OK;
bogdanm 0:9b334a45a8ff 185 }
bogdanm 0:9b334a45a8ff 186
bogdanm 0:9b334a45a8ff 187 /**
bogdanm 0:9b334a45a8ff 188 * @brief Initializes the RNG MSP.
bogdanm 0:9b334a45a8ff 189 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 190 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 191 * @retval None
bogdanm 0:9b334a45a8ff 192 */
bogdanm 0:9b334a45a8ff 193 __weak void HAL_RNG_MspInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 194 {
bogdanm 0:9b334a45a8ff 195 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 196 function HAL_RNG_MspInit must be implemented in the user file.
bogdanm 0:9b334a45a8ff 197 */
bogdanm 0:9b334a45a8ff 198 }
bogdanm 0:9b334a45a8ff 199
bogdanm 0:9b334a45a8ff 200 /**
bogdanm 0:9b334a45a8ff 201 * @brief DeInitializes the RNG MSP.
bogdanm 0:9b334a45a8ff 202 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 203 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 204 * @retval None
bogdanm 0:9b334a45a8ff 205 */
bogdanm 0:9b334a45a8ff 206 __weak void HAL_RNG_MspDeInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 207 {
bogdanm 0:9b334a45a8ff 208 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 209 function HAL_RNG_MspDeInit must be implemented in the user file.
bogdanm 0:9b334a45a8ff 210 */
bogdanm 0:9b334a45a8ff 211 }
bogdanm 0:9b334a45a8ff 212
bogdanm 0:9b334a45a8ff 213 /**
bogdanm 0:9b334a45a8ff 214 * @}
bogdanm 0:9b334a45a8ff 215 */
bogdanm 0:9b334a45a8ff 216
bogdanm 0:9b334a45a8ff 217 /** @addtogroup RNG_Exported_Functions_Group2
bogdanm 0:9b334a45a8ff 218 * @brief Peripheral Control functions
bogdanm 0:9b334a45a8ff 219 *
bogdanm 0:9b334a45a8ff 220 @verbatim
bogdanm 0:9b334a45a8ff 221 ===============================================================================
bogdanm 0:9b334a45a8ff 222 ##### Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 223 ===============================================================================
bogdanm 0:9b334a45a8ff 224 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 225 (+) Get the 32 bit Random number
bogdanm 0:9b334a45a8ff 226 (+) Get the 32 bit Random number with interrupt enabled
bogdanm 0:9b334a45a8ff 227 (+) Handle RNG interrupt request
bogdanm 0:9b334a45a8ff 228
bogdanm 0:9b334a45a8ff 229 @endverbatim
bogdanm 0:9b334a45a8ff 230 * @{
bogdanm 0:9b334a45a8ff 231 */
bogdanm 0:9b334a45a8ff 232
bogdanm 0:9b334a45a8ff 233 /**
bogdanm 0:9b334a45a8ff 234 * @brief Generates a 32-bit random number.
bogdanm 0:9b334a45a8ff 235 * @note Each time the random number data is read the RNG_FLAG_DRDY flag
bogdanm 0:9b334a45a8ff 236 * is automatically cleared.
bogdanm 0:9b334a45a8ff 237 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 238 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 239 * @param random32bit: pointer to generated random number variable if successful.
bogdanm 0:9b334a45a8ff 240 * @retval HAL status
bogdanm 0:9b334a45a8ff 241 */
bogdanm 0:9b334a45a8ff 242
bogdanm 0:9b334a45a8ff 243 HAL_StatusTypeDef HAL_RNG_GenerateRandomNumber(RNG_HandleTypeDef *hrng, uint32_t *random32bit)
bogdanm 0:9b334a45a8ff 244 {
bogdanm 0:9b334a45a8ff 245 uint32_t tickstart = 0;
bogdanm 0:9b334a45a8ff 246 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 247
bogdanm 0:9b334a45a8ff 248 /* Process Locked */
bogdanm 0:9b334a45a8ff 249 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 250
bogdanm 0:9b334a45a8ff 251 /* Check RNG peripheral state */
bogdanm 0:9b334a45a8ff 252 if(hrng->State == HAL_RNG_STATE_READY)
bogdanm 0:9b334a45a8ff 253 {
bogdanm 0:9b334a45a8ff 254 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 255 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 256
bogdanm 0:9b334a45a8ff 257 /* Get tick */
bogdanm 0:9b334a45a8ff 258 tickstart = HAL_GetTick();
bogdanm 0:9b334a45a8ff 259
bogdanm 0:9b334a45a8ff 260 /* Check if data register contains valid random data */
bogdanm 0:9b334a45a8ff 261 while(__HAL_RNG_GET_FLAG(hrng, RNG_FLAG_DRDY) == RESET)
bogdanm 0:9b334a45a8ff 262 {
bogdanm 0:9b334a45a8ff 263 if((HAL_GetTick() - tickstart ) > RNG_TIMEOUT_VALUE)
bogdanm 0:9b334a45a8ff 264 {
bogdanm 0:9b334a45a8ff 265 hrng->State = HAL_RNG_STATE_ERROR;
bogdanm 0:9b334a45a8ff 266
bogdanm 0:9b334a45a8ff 267 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 268 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 269
bogdanm 0:9b334a45a8ff 270 return HAL_TIMEOUT;
bogdanm 0:9b334a45a8ff 271 }
bogdanm 0:9b334a45a8ff 272 }
bogdanm 0:9b334a45a8ff 273
bogdanm 0:9b334a45a8ff 274 /* Get a 32bit Random number */
bogdanm 0:9b334a45a8ff 275 hrng->RandomNumber = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 276 *random32bit = hrng->RandomNumber;
bogdanm 0:9b334a45a8ff 277
bogdanm 0:9b334a45a8ff 278 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 279 }
bogdanm 0:9b334a45a8ff 280 else
bogdanm 0:9b334a45a8ff 281 {
bogdanm 0:9b334a45a8ff 282 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 283 }
bogdanm 0:9b334a45a8ff 284
bogdanm 0:9b334a45a8ff 285 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 286 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 287
bogdanm 0:9b334a45a8ff 288 return status;
bogdanm 0:9b334a45a8ff 289 }
bogdanm 0:9b334a45a8ff 290
bogdanm 0:9b334a45a8ff 291 /**
bogdanm 0:9b334a45a8ff 292 * @brief Generates a 32-bit random number in interrupt mode.
bogdanm 0:9b334a45a8ff 293 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 294 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 295 * @retval HAL status
bogdanm 0:9b334a45a8ff 296 */
bogdanm 0:9b334a45a8ff 297 HAL_StatusTypeDef HAL_RNG_GenerateRandomNumber_IT(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 298 {
bogdanm 0:9b334a45a8ff 299 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 300
bogdanm 0:9b334a45a8ff 301 /* Process Locked */
bogdanm 0:9b334a45a8ff 302 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 303
bogdanm 0:9b334a45a8ff 304 /* Check RNG peripheral state */
bogdanm 0:9b334a45a8ff 305 if(hrng->State == HAL_RNG_STATE_READY)
bogdanm 0:9b334a45a8ff 306 {
bogdanm 0:9b334a45a8ff 307 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 308 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 309
bogdanm 0:9b334a45a8ff 310 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 311 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 312
bogdanm 0:9b334a45a8ff 313 /* Enable the RNG Interrupts: Data Ready, Clock error, Seed error */
bogdanm 0:9b334a45a8ff 314 __HAL_RNG_ENABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 315 }
bogdanm 0:9b334a45a8ff 316 else
bogdanm 0:9b334a45a8ff 317 {
bogdanm 0:9b334a45a8ff 318 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 319 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 320
bogdanm 0:9b334a45a8ff 321 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 322 }
bogdanm 0:9b334a45a8ff 323
bogdanm 0:9b334a45a8ff 324 return status;
bogdanm 0:9b334a45a8ff 325 }
bogdanm 0:9b334a45a8ff 326
bogdanm 0:9b334a45a8ff 327 /**
bogdanm 0:9b334a45a8ff 328 * @brief Handles RNG interrupt request.
bogdanm 0:9b334a45a8ff 329 * @note In the case of a clock error, the RNG is no more able to generate
bogdanm 0:9b334a45a8ff 330 * random numbers because the PLL48CLK clock is not correct. User has
bogdanm 0:9b334a45a8ff 331 * to check that the clock controller is correctly configured to provide
bogdanm 0:9b334a45a8ff 332 * the RNG clock and clear the CEIS bit using __HAL_RNG_CLEAR_IT().
bogdanm 0:9b334a45a8ff 333 * The clock error has no impact on the previously generated
bogdanm 0:9b334a45a8ff 334 * random numbers, and the RNG_DR register contents can be used.
bogdanm 0:9b334a45a8ff 335 * @note In the case of a seed error, the generation of random numbers is
bogdanm 0:9b334a45a8ff 336 * interrupted as long as the SECS bit is '1'. If a number is
bogdanm 0:9b334a45a8ff 337 * available in the RNG_DR register, it must not be used because it may
bogdanm 0:9b334a45a8ff 338 * not have enough entropy. In this case, it is recommended to clear the
bogdanm 0:9b334a45a8ff 339 * SEIS bit using __HAL_RNG_CLEAR_IT(), then disable and enable
bogdanm 0:9b334a45a8ff 340 * the RNG peripheral to reinitialize and restart the RNG.
bogdanm 0:9b334a45a8ff 341 * @note User-written HAL_RNG_ErrorCallback() API is called once whether SEIS
bogdanm 0:9b334a45a8ff 342 * or CEIS are set.
bogdanm 0:9b334a45a8ff 343 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 344 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 345 * @retval None
bogdanm 0:9b334a45a8ff 346
bogdanm 0:9b334a45a8ff 347 */
bogdanm 0:9b334a45a8ff 348 void HAL_RNG_IRQHandler(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 349 {
bogdanm 0:9b334a45a8ff 350 /* RNG clock error interrupt occurred */
bogdanm 0:9b334a45a8ff 351 if((__HAL_RNG_GET_IT(hrng, RNG_IT_CEI) != RESET) || (__HAL_RNG_GET_IT(hrng, RNG_IT_SEI) != RESET))
bogdanm 0:9b334a45a8ff 352 {
bogdanm 0:9b334a45a8ff 353 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 354 hrng->State = HAL_RNG_STATE_ERROR;
bogdanm 0:9b334a45a8ff 355
bogdanm 0:9b334a45a8ff 356 HAL_RNG_ErrorCallback(hrng);
bogdanm 0:9b334a45a8ff 357
bogdanm 0:9b334a45a8ff 358 /* Clear the clock error flag */
bogdanm 0:9b334a45a8ff 359 __HAL_RNG_CLEAR_IT(hrng, RNG_IT_CEI|RNG_IT_SEI);
bogdanm 0:9b334a45a8ff 360
bogdanm 0:9b334a45a8ff 361 }
bogdanm 0:9b334a45a8ff 362
bogdanm 0:9b334a45a8ff 363 /* Check RNG data ready interrupt occurred */
bogdanm 0:9b334a45a8ff 364 if(__HAL_RNG_GET_IT(hrng, RNG_IT_DRDY) != RESET)
bogdanm 0:9b334a45a8ff 365 {
bogdanm 0:9b334a45a8ff 366 /* Generate random number once, so disable the IT */
bogdanm 0:9b334a45a8ff 367 __HAL_RNG_DISABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 368
bogdanm 0:9b334a45a8ff 369 /* Get the 32bit Random number (DRDY flag automatically cleared) */
bogdanm 0:9b334a45a8ff 370 hrng->RandomNumber = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 371
bogdanm 0:9b334a45a8ff 372 if(hrng->State != HAL_RNG_STATE_ERROR)
bogdanm 0:9b334a45a8ff 373 {
bogdanm 0:9b334a45a8ff 374 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 375 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 376
bogdanm 0:9b334a45a8ff 377 /* Data Ready callback */
bogdanm 0:9b334a45a8ff 378 HAL_RNG_ReadyDataCallback(hrng, hrng->RandomNumber);
bogdanm 0:9b334a45a8ff 379 }
bogdanm 0:9b334a45a8ff 380 }
bogdanm 0:9b334a45a8ff 381 }
bogdanm 0:9b334a45a8ff 382
bogdanm 0:9b334a45a8ff 383 /**
bogdanm 0:9b334a45a8ff 384 * @brief Returns generated random number in polling mode (Obsolete)
bogdanm 0:9b334a45a8ff 385 * Use HAL_RNG_GenerateRandomNumber() API instead.
bogdanm 0:9b334a45a8ff 386 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 387 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 388 * @retval Random value
bogdanm 0:9b334a45a8ff 389 */
bogdanm 0:9b334a45a8ff 390 uint32_t HAL_RNG_GetRandomNumber(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 391 {
bogdanm 0:9b334a45a8ff 392 if(HAL_RNG_GenerateRandomNumber(hrng, &(hrng->RandomNumber)) == HAL_OK)
bogdanm 0:9b334a45a8ff 393 {
bogdanm 0:9b334a45a8ff 394 return hrng->RandomNumber;
bogdanm 0:9b334a45a8ff 395 }
bogdanm 0:9b334a45a8ff 396 else
bogdanm 0:9b334a45a8ff 397 {
bogdanm 0:9b334a45a8ff 398 return 0;
bogdanm 0:9b334a45a8ff 399 }
bogdanm 0:9b334a45a8ff 400 }
bogdanm 0:9b334a45a8ff 401
bogdanm 0:9b334a45a8ff 402 /**
bogdanm 0:9b334a45a8ff 403 * @brief Returns a 32-bit random number with interrupt enabled (Obsolete),
bogdanm 0:9b334a45a8ff 404 * Use HAL_RNG_GenerateRandomNumber_IT() API instead.
bogdanm 0:9b334a45a8ff 405 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 406 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 407 * @retval 32-bit random number
bogdanm 0:9b334a45a8ff 408 */
bogdanm 0:9b334a45a8ff 409 uint32_t HAL_RNG_GetRandomNumber_IT(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 410 {
bogdanm 0:9b334a45a8ff 411 uint32_t random32bit = 0;
bogdanm 0:9b334a45a8ff 412
bogdanm 0:9b334a45a8ff 413 /* Process locked */
bogdanm 0:9b334a45a8ff 414 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 415
bogdanm 0:9b334a45a8ff 416 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 417 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 418
bogdanm 0:9b334a45a8ff 419 /* Get a 32bit Random number */
bogdanm 0:9b334a45a8ff 420 random32bit = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 421
bogdanm 0:9b334a45a8ff 422 /* Enable the RNG Interrupts: Data Ready, Clock error, Seed error */
bogdanm 0:9b334a45a8ff 423 __HAL_RNG_ENABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 424
bogdanm 0:9b334a45a8ff 425 /* Return the 32 bit random number */
bogdanm 0:9b334a45a8ff 426 return random32bit;
bogdanm 0:9b334a45a8ff 427 }
bogdanm 0:9b334a45a8ff 428
bogdanm 0:9b334a45a8ff 429 /**
bogdanm 0:9b334a45a8ff 430 * @brief Read latest generated random number.
bogdanm 0:9b334a45a8ff 431 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 432 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 433 * @retval random value
bogdanm 0:9b334a45a8ff 434 */
bogdanm 0:9b334a45a8ff 435 uint32_t HAL_RNG_ReadLastRandomNumber(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 436 {
bogdanm 0:9b334a45a8ff 437 return(hrng->RandomNumber);
bogdanm 0:9b334a45a8ff 438 }
bogdanm 0:9b334a45a8ff 439
bogdanm 0:9b334a45a8ff 440 /**
bogdanm 0:9b334a45a8ff 441 * @brief Data Ready callback in non-blocking mode.
bogdanm 0:9b334a45a8ff 442 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 443 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 444 * @param random32bit: generated random number.
bogdanm 0:9b334a45a8ff 445 * @retval None
bogdanm 0:9b334a45a8ff 446 */
bogdanm 0:9b334a45a8ff 447 __weak void HAL_RNG_ReadyDataCallback(RNG_HandleTypeDef *hrng, uint32_t random32bit)
bogdanm 0:9b334a45a8ff 448 {
bogdanm 0:9b334a45a8ff 449 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 450 function HAL_RNG_ReadyDataCallback must be implemented in the user file.
bogdanm 0:9b334a45a8ff 451 */
bogdanm 0:9b334a45a8ff 452 }
bogdanm 0:9b334a45a8ff 453
bogdanm 0:9b334a45a8ff 454 /**
bogdanm 0:9b334a45a8ff 455 * @brief RNG error callbacks.
bogdanm 0:9b334a45a8ff 456 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 457 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 458 * @retval None
bogdanm 0:9b334a45a8ff 459 */
bogdanm 0:9b334a45a8ff 460 __weak void HAL_RNG_ErrorCallback(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 461 {
bogdanm 0:9b334a45a8ff 462 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 463 function HAL_RNG_ErrorCallback must be implemented in the user file.
bogdanm 0:9b334a45a8ff 464 */
bogdanm 0:9b334a45a8ff 465 }
bogdanm 0:9b334a45a8ff 466 /**
bogdanm 0:9b334a45a8ff 467 * @}
bogdanm 0:9b334a45a8ff 468 */
bogdanm 0:9b334a45a8ff 469
bogdanm 0:9b334a45a8ff 470
bogdanm 0:9b334a45a8ff 471 /** @addtogroup RNG_Exported_Functions_Group3
bogdanm 0:9b334a45a8ff 472 * @brief Peripheral State functions
bogdanm 0:9b334a45a8ff 473 *
bogdanm 0:9b334a45a8ff 474 @verbatim
bogdanm 0:9b334a45a8ff 475 ===============================================================================
bogdanm 0:9b334a45a8ff 476 ##### Peripheral State functions #####
bogdanm 0:9b334a45a8ff 477 ===============================================================================
bogdanm 0:9b334a45a8ff 478 [..]
bogdanm 0:9b334a45a8ff 479 This subsection permits to get in run-time the status of the peripheral
bogdanm 0:9b334a45a8ff 480 and the data flow.
bogdanm 0:9b334a45a8ff 481
bogdanm 0:9b334a45a8ff 482 @endverbatim
bogdanm 0:9b334a45a8ff 483 * @{
bogdanm 0:9b334a45a8ff 484 */
bogdanm 0:9b334a45a8ff 485
bogdanm 0:9b334a45a8ff 486 /**
bogdanm 0:9b334a45a8ff 487 * @brief Returns the RNG state.
bogdanm 0:9b334a45a8ff 488 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 489 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 490 * @retval HAL state
bogdanm 0:9b334a45a8ff 491 */
bogdanm 0:9b334a45a8ff 492 HAL_RNG_StateTypeDef HAL_RNG_GetState(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 493 {
bogdanm 0:9b334a45a8ff 494 return hrng->State;
bogdanm 0:9b334a45a8ff 495 }
bogdanm 0:9b334a45a8ff 496
bogdanm 0:9b334a45a8ff 497 /**
bogdanm 0:9b334a45a8ff 498 * @}
bogdanm 0:9b334a45a8ff 499 */
bogdanm 0:9b334a45a8ff 500
bogdanm 0:9b334a45a8ff 501 /**
bogdanm 0:9b334a45a8ff 502 * @}
bogdanm 0:9b334a45a8ff 503 */
bogdanm 0:9b334a45a8ff 504
mbed_official 19:112740acecfa 505 #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx || STM32F427xx || STM32F437xx ||\
mbed_official 19:112740acecfa 506 STM32F429xx || STM32F439xx || STM32F410xx || STM32F469xx || STM32F479xx */
bogdanm 0:9b334a45a8ff 507
bogdanm 0:9b334a45a8ff 508 #endif /* HAL_RNG_MODULE_ENABLED */
bogdanm 0:9b334a45a8ff 509
bogdanm 0:9b334a45a8ff 510 /**
bogdanm 0:9b334a45a8ff 511 * @}
bogdanm 0:9b334a45a8ff 512 */
bogdanm 0:9b334a45a8ff 513
bogdanm 0:9b334a45a8ff 514 /**
bogdanm 0:9b334a45a8ff 515 * @}
bogdanm 0:9b334a45a8ff 516 */
bogdanm 0:9b334a45a8ff 517
bogdanm 0:9b334a45a8ff 518 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/