Greg Steiert / maxim-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.

Dependents:   MAX34417_demo MAXREFDES1265 MAXREFDES1265

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F4/stm32f4xx_hal_rng.c@144:ef7eb2e8f9f7, 2016-09-02 (annotated)

Committer:
<>
Date:
Fri Sep 02 15:07:44 2016 +0100
Revision:
144:ef7eb2e8f9f7
Parent:
19:112740acecfa 
This updates the lib to the mbed lib v125

Who changed what in which revision?

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