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