Fawwaz Nadzmy / 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_STM32L0/stm32l0xx_hal_rng.c@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /**
bogdanm 0:9b334a45a8ff 2 ******************************************************************************
bogdanm 0:9b334a45a8ff 3 * @file stm32l0xx_hal_rng.c
bogdanm 0:9b334a45a8ff 4 * @author MCD Application Team
bogdanm 0:9b334a45a8ff 5 * @version V1.2.0
bogdanm 0:9b334a45a8ff 6 * @date 06-February-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 "stm32l0xx_hal.h"
bogdanm 0:9b334a45a8ff 61
bogdanm 0:9b334a45a8ff 62 /** @addtogroup STM32L0xx_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
bogdanm 0:9b334a45a8ff 73 #if defined (STM32L052xx) || defined (STM32L053xx) || defined (STM32L062xx) || defined (STM32L063xx) || \
bogdanm 0:9b334a45a8ff 74 defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L082xx) || defined (STM32L083xx)
bogdanm 0:9b334a45a8ff 75 /* Private types -------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 76 /* Private Defines -----------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 77 /** @addtogroup RNG_Private_Defines
bogdanm 0:9b334a45a8ff 78 * @{
bogdanm 0:9b334a45a8ff 79 */
bogdanm 0:9b334a45a8ff 80 #define RNG_TIMEOUT_VALUE 1000
bogdanm 0:9b334a45a8ff 81 /**
bogdanm 0:9b334a45a8ff 82 * @}
bogdanm 0:9b334a45a8ff 83 */
bogdanm 0:9b334a45a8ff 84
bogdanm 0:9b334a45a8ff 85 /* Private variables ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 86 /* Private constants ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 87 /* Private macros ------------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 88 /* Private functions prototypes ----------------------------------------------*/
bogdanm 0:9b334a45a8ff 89 /* Private functions ---------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 90 /* Exported functions --------------------------------------------------------*/
bogdanm 0:9b334a45a8ff 91
bogdanm 0:9b334a45a8ff 92 /** @addtogroup RNG_Exported_Functions
bogdanm 0:9b334a45a8ff 93 * @{
bogdanm 0:9b334a45a8ff 94 */
bogdanm 0:9b334a45a8ff 95
bogdanm 0:9b334a45a8ff 96 /** @addtogroup RNG_Exported_Functions_Group1
bogdanm 0:9b334a45a8ff 97 * @brief Initialization and de-initialization functions
bogdanm 0:9b334a45a8ff 98 *
bogdanm 0:9b334a45a8ff 99 @verbatim
bogdanm 0:9b334a45a8ff 100 ===============================================================================
bogdanm 0:9b334a45a8ff 101 ##### Initialization and de-initialization functions #####
bogdanm 0:9b334a45a8ff 102 ===============================================================================
bogdanm 0:9b334a45a8ff 103 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 104 (+) Initialize the RNG according to the specified parameters
bogdanm 0:9b334a45a8ff 105 in the RNG_InitTypeDef and create the associated handle
bogdanm 0:9b334a45a8ff 106 (+) DeInitialize the RNG peripheral
bogdanm 0:9b334a45a8ff 107 (+) Initialize the RNG MSP
bogdanm 0:9b334a45a8ff 108 (+) DeInitialize RNG MSP
bogdanm 0:9b334a45a8ff 109
bogdanm 0:9b334a45a8ff 110 @endverbatim
bogdanm 0:9b334a45a8ff 111 * @{
bogdanm 0:9b334a45a8ff 112 */
bogdanm 0:9b334a45a8ff 113
bogdanm 0:9b334a45a8ff 114 /**
bogdanm 0:9b334a45a8ff 115 * @brief Initializes the RNG peripheral and creates the associated handle.
bogdanm 0:9b334a45a8ff 116 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 117 * @retval HAL status
bogdanm 0:9b334a45a8ff 118 */
bogdanm 0:9b334a45a8ff 119 HAL_StatusTypeDef HAL_RNG_Init(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 120 {
bogdanm 0:9b334a45a8ff 121 /* Check the RNG handle allocation */
bogdanm 0:9b334a45a8ff 122 if(hrng == NULL)
bogdanm 0:9b334a45a8ff 123 {
bogdanm 0:9b334a45a8ff 124 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 125 }
bogdanm 0:9b334a45a8ff 126 assert_param(IS_RNG_ALL_INSTANCE(hrng->Instance));
bogdanm 0:9b334a45a8ff 127
bogdanm 0:9b334a45a8ff 128 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 129
bogdanm 0:9b334a45a8ff 130 if(hrng->State == HAL_RNG_STATE_RESET)
bogdanm 0:9b334a45a8ff 131 {
bogdanm 0:9b334a45a8ff 132 /* Init the low level hardware */
bogdanm 0:9b334a45a8ff 133 HAL_RNG_MspInit(hrng);
bogdanm 0:9b334a45a8ff 134 }
bogdanm 0:9b334a45a8ff 135
bogdanm 0:9b334a45a8ff 136 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 137 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 138
bogdanm 0:9b334a45a8ff 139 /* Enable the RNG Peripheral */
bogdanm 0:9b334a45a8ff 140 __HAL_RNG_ENABLE(hrng);
bogdanm 0:9b334a45a8ff 141
bogdanm 0:9b334a45a8ff 142 /* Initialize the RNG state */
bogdanm 0:9b334a45a8ff 143 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 144
bogdanm 0:9b334a45a8ff 145 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 146
bogdanm 0:9b334a45a8ff 147 /* Return function status */
bogdanm 0:9b334a45a8ff 148 return HAL_OK;
bogdanm 0:9b334a45a8ff 149 }
bogdanm 0:9b334a45a8ff 150
bogdanm 0:9b334a45a8ff 151 /**
bogdanm 0:9b334a45a8ff 152 * @brief DeInitializes the RNG peripheral.
bogdanm 0:9b334a45a8ff 153 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 154 * @retval HAL status
bogdanm 0:9b334a45a8ff 155 */
bogdanm 0:9b334a45a8ff 156 HAL_StatusTypeDef HAL_RNG_DeInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 157 {
bogdanm 0:9b334a45a8ff 158 /* Check the RNG handle allocation */
bogdanm 0:9b334a45a8ff 159 if(hrng == NULL)
bogdanm 0:9b334a45a8ff 160 {
bogdanm 0:9b334a45a8ff 161 return HAL_ERROR;
bogdanm 0:9b334a45a8ff 162 }
bogdanm 0:9b334a45a8ff 163 /* Disable the RNG Peripheral */
bogdanm 0:9b334a45a8ff 164 CLEAR_BIT(hrng->Instance->CR, RNG_CR_IE | RNG_CR_RNGEN);
bogdanm 0:9b334a45a8ff 165
bogdanm 0:9b334a45a8ff 166 /* Clear RNG interrupt status flags */
bogdanm 0:9b334a45a8ff 167 CLEAR_BIT(hrng->Instance->SR, RNG_SR_CEIS | RNG_SR_SEIS);
bogdanm 0:9b334a45a8ff 168
bogdanm 0:9b334a45a8ff 169 /* DeInit the low level hardware */
bogdanm 0:9b334a45a8ff 170 HAL_RNG_MspDeInit(hrng);
bogdanm 0:9b334a45a8ff 171
bogdanm 0:9b334a45a8ff 172 /* Update the RNG state */
bogdanm 0:9b334a45a8ff 173 hrng->State = HAL_RNG_STATE_RESET;
bogdanm 0:9b334a45a8ff 174
bogdanm 0:9b334a45a8ff 175 /* Release Lock */
bogdanm 0:9b334a45a8ff 176 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 177
bogdanm 0:9b334a45a8ff 178 /* Return the function status */
bogdanm 0:9b334a45a8ff 179 return HAL_OK;
bogdanm 0:9b334a45a8ff 180 }
bogdanm 0:9b334a45a8ff 181
bogdanm 0:9b334a45a8ff 182 /**
bogdanm 0:9b334a45a8ff 183 * @brief Initializes the RNG MSP.
bogdanm 0:9b334a45a8ff 184 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 185 * @retval None
bogdanm 0:9b334a45a8ff 186 */
bogdanm 0:9b334a45a8ff 187 __weak void HAL_RNG_MspInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 188 {
bogdanm 0:9b334a45a8ff 189 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 190 function HAL_RNG_MspInit must be implemented in the user file.
bogdanm 0:9b334a45a8ff 191 */
bogdanm 0:9b334a45a8ff 192 }
bogdanm 0:9b334a45a8ff 193
bogdanm 0:9b334a45a8ff 194 /**
bogdanm 0:9b334a45a8ff 195 * @brief DeInitializes the RNG MSP.
bogdanm 0:9b334a45a8ff 196 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 197 * @retval None
bogdanm 0:9b334a45a8ff 198 */
bogdanm 0:9b334a45a8ff 199 __weak void HAL_RNG_MspDeInit(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 200 {
bogdanm 0:9b334a45a8ff 201 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 202 function HAL_RNG_MspDeInit must be implemented in the user file.
bogdanm 0:9b334a45a8ff 203 */
bogdanm 0:9b334a45a8ff 204 }
bogdanm 0:9b334a45a8ff 205
bogdanm 0:9b334a45a8ff 206 /**
bogdanm 0:9b334a45a8ff 207 * @}
bogdanm 0:9b334a45a8ff 208 */
bogdanm 0:9b334a45a8ff 209
bogdanm 0:9b334a45a8ff 210 /** @addtogroup RNG_Exported_Functions_Group2
bogdanm 0:9b334a45a8ff 211 * @brief Peripheral Control functions
bogdanm 0:9b334a45a8ff 212 *
bogdanm 0:9b334a45a8ff 213 @verbatim
bogdanm 0:9b334a45a8ff 214 ===============================================================================
bogdanm 0:9b334a45a8ff 215 ##### Peripheral Control functions #####
bogdanm 0:9b334a45a8ff 216 ===============================================================================
bogdanm 0:9b334a45a8ff 217 [..] This section provides functions allowing to:
bogdanm 0:9b334a45a8ff 218 (+) Get the 32 bit Random number
bogdanm 0:9b334a45a8ff 219 (+) Get the 32 bit Random number with interrupt enabled
bogdanm 0:9b334a45a8ff 220 (+) Handle RNG interrupt request
bogdanm 0:9b334a45a8ff 221
bogdanm 0:9b334a45a8ff 222
bogdanm 0:9b334a45a8ff 223 @endverbatim
bogdanm 0:9b334a45a8ff 224 * @{
bogdanm 0:9b334a45a8ff 225 */
bogdanm 0:9b334a45a8ff 226
bogdanm 0:9b334a45a8ff 227 /**
bogdanm 0:9b334a45a8ff 228 * @brief Generates a 32-bit random number.
bogdanm 0:9b334a45a8ff 229 * @note Each time the random number data is read the RNG_FLAG_DRDY flag
bogdanm 0:9b334a45a8ff 230 * is automatically cleared.
bogdanm 0:9b334a45a8ff 231 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 232 * @param random32bit: pointer to generated random number variable if successful.
bogdanm 0:9b334a45a8ff 233 * @retval HAL status
bogdanm 0:9b334a45a8ff 234 */
bogdanm 0:9b334a45a8ff 235
bogdanm 0:9b334a45a8ff 236 HAL_StatusTypeDef HAL_RNG_GenerateRandomNumber(RNG_HandleTypeDef *hrng, uint32_t *random32bit)
bogdanm 0:9b334a45a8ff 237 {
bogdanm 0:9b334a45a8ff 238 uint32_t tickstart = 0;
bogdanm 0:9b334a45a8ff 239 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 240
bogdanm 0:9b334a45a8ff 241 /* Process Locked */
bogdanm 0:9b334a45a8ff 242 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 243
bogdanm 0:9b334a45a8ff 244 /* Check RNG peripheral state */
bogdanm 0:9b334a45a8ff 245 if(hrng->State == HAL_RNG_STATE_READY)
bogdanm 0:9b334a45a8ff 246 {
bogdanm 0:9b334a45a8ff 247 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 248 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 249
bogdanm 0:9b334a45a8ff 250 /* Get tick */
bogdanm 0:9b334a45a8ff 251 tickstart = HAL_GetTick();
bogdanm 0:9b334a45a8ff 252
bogdanm 0:9b334a45a8ff 253 /* Check if data register contains valid random data */
bogdanm 0:9b334a45a8ff 254 while(__HAL_RNG_GET_FLAG(hrng, RNG_FLAG_DRDY) == RESET)
bogdanm 0:9b334a45a8ff 255 {
bogdanm 0:9b334a45a8ff 256 if((HAL_GetTick() - tickstart ) > RNG_TIMEOUT_VALUE)
bogdanm 0:9b334a45a8ff 257 {
bogdanm 0:9b334a45a8ff 258 hrng->State = HAL_RNG_STATE_ERROR;
bogdanm 0:9b334a45a8ff 259
bogdanm 0:9b334a45a8ff 260 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 261 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 262
bogdanm 0:9b334a45a8ff 263 return HAL_TIMEOUT;
bogdanm 0:9b334a45a8ff 264 }
bogdanm 0:9b334a45a8ff 265 }
bogdanm 0:9b334a45a8ff 266
bogdanm 0:9b334a45a8ff 267 /* Get a 32bit Random number */
bogdanm 0:9b334a45a8ff 268 hrng->RandomNumber = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 269 *random32bit = hrng->RandomNumber;
bogdanm 0:9b334a45a8ff 270
bogdanm 0:9b334a45a8ff 271 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 272 }
bogdanm 0:9b334a45a8ff 273 else
bogdanm 0:9b334a45a8ff 274 {
bogdanm 0:9b334a45a8ff 275 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 276 }
bogdanm 0:9b334a45a8ff 277
bogdanm 0:9b334a45a8ff 278 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 279 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 280
bogdanm 0:9b334a45a8ff 281 return status;
bogdanm 0:9b334a45a8ff 282 }
bogdanm 0:9b334a45a8ff 283
bogdanm 0:9b334a45a8ff 284 /**
bogdanm 0:9b334a45a8ff 285 * @brief Generates a 32-bit random number in interrupt mode.
bogdanm 0:9b334a45a8ff 286 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 287 * @retval HAL status
bogdanm 0:9b334a45a8ff 288 */
bogdanm 0:9b334a45a8ff 289 HAL_StatusTypeDef HAL_RNG_GenerateRandomNumber_IT(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 290 {
bogdanm 0:9b334a45a8ff 291 HAL_StatusTypeDef status = HAL_OK;
bogdanm 0:9b334a45a8ff 292
bogdanm 0:9b334a45a8ff 293 /* Process Locked */
bogdanm 0:9b334a45a8ff 294 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 295
bogdanm 0:9b334a45a8ff 296 /* Check RNG peripheral state */
bogdanm 0:9b334a45a8ff 297 if(hrng->State == HAL_RNG_STATE_READY)
bogdanm 0:9b334a45a8ff 298 {
bogdanm 0:9b334a45a8ff 299 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 300 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 301
bogdanm 0:9b334a45a8ff 302 /* Process Unlocked */
bogdanm 0:9b334a45a8ff 303 __HAL_UNLOCK(hrng);
bogdanm 0:9b334a45a8ff 304
bogdanm 0:9b334a45a8ff 305 /* Enable the RNG Interrupts: Data Ready, Clock error, Seed error */
bogdanm 0:9b334a45a8ff 306 __HAL_RNG_ENABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 307 }
bogdanm 0:9b334a45a8ff 308 else
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 status = HAL_ERROR;
bogdanm 0:9b334a45a8ff 314 }
bogdanm 0:9b334a45a8ff 315
bogdanm 0:9b334a45a8ff 316 return status;
bogdanm 0:9b334a45a8ff 317 }
bogdanm 0:9b334a45a8ff 318
bogdanm 0:9b334a45a8ff 319 /**
bogdanm 0:9b334a45a8ff 320 * @brief Handles RNG interrupt request.
bogdanm 0:9b334a45a8ff 321 * @note In the case of a clock error, the RNG is no more able to generate
bogdanm 0:9b334a45a8ff 322 * random numbers because the PLL48CLK clock is not correct. User has
bogdanm 0:9b334a45a8ff 323 * to check that the clock controller is correctly configured to provide
bogdanm 0:9b334a45a8ff 324 * the RNG clock and clear the CEIS bit using __HAL_RNG_CLEAR_IT().
bogdanm 0:9b334a45a8ff 325 * The clock error has no impact on the previously generated
bogdanm 0:9b334a45a8ff 326 * random numbers, and the RNG_DR register contents can be used.
bogdanm 0:9b334a45a8ff 327 * @note In the case of a seed error, the generation of random numbers is
bogdanm 0:9b334a45a8ff 328 * interrupted as long as the SECS bit is '1'. If a number is
bogdanm 0:9b334a45a8ff 329 * available in the RNG_DR register, it must not be used because it may
bogdanm 0:9b334a45a8ff 330 * not have enough entropy. In this case, it is recommended to clear the
bogdanm 0:9b334a45a8ff 331 * SEIS bit using __HAL_RNG_CLEAR_IT(), then disable and enable
bogdanm 0:9b334a45a8ff 332 * the RNG peripheral to reinitialize and restart the RNG.
bogdanm 0:9b334a45a8ff 333 * @note User-written HAL_RNG_ErrorCallback() API is called once whether SEIS
bogdanm 0:9b334a45a8ff 334 * or CEIS are set.
bogdanm 0:9b334a45a8ff 335 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 336 * @retval None
bogdanm 0:9b334a45a8ff 337
bogdanm 0:9b334a45a8ff 338 */
bogdanm 0:9b334a45a8ff 339 void HAL_RNG_IRQHandler(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 340 {
bogdanm 0:9b334a45a8ff 341 /* RNG clock error interrupt occurred */
bogdanm 0:9b334a45a8ff 342 if((__HAL_RNG_GET_IT(hrng, RNG_IT_CEI) != RESET) || (__HAL_RNG_GET_IT(hrng, RNG_IT_SEI) != RESET))
bogdanm 0:9b334a45a8ff 343 {
bogdanm 0:9b334a45a8ff 344 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 345 hrng->State = HAL_RNG_STATE_ERROR;
bogdanm 0:9b334a45a8ff 346
bogdanm 0:9b334a45a8ff 347 HAL_RNG_ErrorCallback(hrng);
bogdanm 0:9b334a45a8ff 348
bogdanm 0:9b334a45a8ff 349 /* Clear the clock error flag */
bogdanm 0:9b334a45a8ff 350 __HAL_RNG_CLEAR_IT(hrng, RNG_IT_CEI|RNG_IT_SEI);
bogdanm 0:9b334a45a8ff 351
bogdanm 0:9b334a45a8ff 352 }
bogdanm 0:9b334a45a8ff 353
bogdanm 0:9b334a45a8ff 354 /* Check RNG data ready interrupt occurred */
bogdanm 0:9b334a45a8ff 355 if(__HAL_RNG_GET_IT(hrng, RNG_IT_DRDY) != RESET)
bogdanm 0:9b334a45a8ff 356 {
bogdanm 0:9b334a45a8ff 357 /* Generate random number once, so disable the IT */
bogdanm 0:9b334a45a8ff 358 __HAL_RNG_DISABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 359
bogdanm 0:9b334a45a8ff 360 /* Get the 32bit Random number (DRDY flag automatically cleared) */
bogdanm 0:9b334a45a8ff 361 hrng->RandomNumber = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 362
bogdanm 0:9b334a45a8ff 363 if(hrng->State != HAL_RNG_STATE_ERROR)
bogdanm 0:9b334a45a8ff 364 {
bogdanm 0:9b334a45a8ff 365 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 366 hrng->State = HAL_RNG_STATE_READY;
bogdanm 0:9b334a45a8ff 367
bogdanm 0:9b334a45a8ff 368 /* Data Ready callback */
bogdanm 0:9b334a45a8ff 369 HAL_RNG_ReadyDataCallback(hrng, hrng->RandomNumber);
bogdanm 0:9b334a45a8ff 370 }
bogdanm 0:9b334a45a8ff 371 }
bogdanm 0:9b334a45a8ff 372 }
bogdanm 0:9b334a45a8ff 373
bogdanm 0:9b334a45a8ff 374 /**
bogdanm 0:9b334a45a8ff 375 * @brief return generated random number in polling mode (Obsolete).
bogdanm 0:9b334a45a8ff 376 * Use HAL_RNG_GenerateRandomNumber() API instead.
bogdanm 0:9b334a45a8ff 377 * @param hrng: pointer to a RNG_HandleTypeDef structure that contains
bogdanm 0:9b334a45a8ff 378 * the configuration information for RNG.
bogdanm 0:9b334a45a8ff 379 * @retval random value
bogdanm 0:9b334a45a8ff 380 */
bogdanm 0:9b334a45a8ff 381 uint32_t HAL_RNG_GetRandomNumber(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 382 {
bogdanm 0:9b334a45a8ff 383 if(HAL_RNG_GenerateRandomNumber(hrng, &(hrng->RandomNumber)) == HAL_OK)
bogdanm 0:9b334a45a8ff 384 {
bogdanm 0:9b334a45a8ff 385 return hrng->RandomNumber;
bogdanm 0:9b334a45a8ff 386 }
bogdanm 0:9b334a45a8ff 387 else
bogdanm 0:9b334a45a8ff 388 {
bogdanm 0:9b334a45a8ff 389 return 0;
bogdanm 0:9b334a45a8ff 390 }
bogdanm 0:9b334a45a8ff 391 }
bogdanm 0:9b334a45a8ff 392
bogdanm 0:9b334a45a8ff 393
bogdanm 0:9b334a45a8ff 394 /**
bogdanm 0:9b334a45a8ff 395 * @brief Returns a 32-bit random number with interrupt enabled (Obsolete),
bogdanm 0:9b334a45a8ff 396 * Use HAL_RNG_GenerateRandomNumber_IT() API instead.
bogdanm 0:9b334a45a8ff 397 * @param hrng: RNG handle
bogdanm 0:9b334a45a8ff 398 * @retval 32-bit random number
bogdanm 0:9b334a45a8ff 399 */
bogdanm 0:9b334a45a8ff 400 uint32_t HAL_RNG_GetRandomNumber_IT(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 401 {
bogdanm 0:9b334a45a8ff 402 uint32_t random32bit = 0;
bogdanm 0:9b334a45a8ff 403
bogdanm 0:9b334a45a8ff 404 /* Process locked */
bogdanm 0:9b334a45a8ff 405 __HAL_LOCK(hrng);
bogdanm 0:9b334a45a8ff 406
bogdanm 0:9b334a45a8ff 407 /* Change RNG peripheral state */
bogdanm 0:9b334a45a8ff 408 hrng->State = HAL_RNG_STATE_BUSY;
bogdanm 0:9b334a45a8ff 409
bogdanm 0:9b334a45a8ff 410 /* Get a 32bit Random number */
bogdanm 0:9b334a45a8ff 411 random32bit = hrng->Instance->DR;
bogdanm 0:9b334a45a8ff 412
bogdanm 0:9b334a45a8ff 413 /* Enable the RNG Interrupts: Data Ready, Clock error, Seed error */
bogdanm 0:9b334a45a8ff 414 __HAL_RNG_ENABLE_IT(hrng);
bogdanm 0:9b334a45a8ff 415
bogdanm 0:9b334a45a8ff 416 /* Return the 32 bit random number */
bogdanm 0:9b334a45a8ff 417 return random32bit;
bogdanm 0:9b334a45a8ff 418 }
bogdanm 0:9b334a45a8ff 419
bogdanm 0:9b334a45a8ff 420
bogdanm 0:9b334a45a8ff 421
bogdanm 0:9b334a45a8ff 422 /**
bogdanm 0:9b334a45a8ff 423 * @brief Read latest generated random number.
bogdanm 0:9b334a45a8ff 424 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 425 * @retval random value
bogdanm 0:9b334a45a8ff 426 */
bogdanm 0:9b334a45a8ff 427 uint32_t HAL_RNG_ReadLastRandomNumber(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 428 {
bogdanm 0:9b334a45a8ff 429 return(hrng->RandomNumber);
bogdanm 0:9b334a45a8ff 430 }
bogdanm 0:9b334a45a8ff 431
bogdanm 0:9b334a45a8ff 432 /**
bogdanm 0:9b334a45a8ff 433 * @brief Data Ready callback in non-blocking mode.
bogdanm 0:9b334a45a8ff 434 * @param hrng: pointer to a RNG_HandleTypeDef structure..
bogdanm 0:9b334a45a8ff 435 * @param random32bit: generated random value
bogdanm 0:9b334a45a8ff 436 * @retval None
bogdanm 0:9b334a45a8ff 437 */
bogdanm 0:9b334a45a8ff 438 __weak void HAL_RNG_ReadyDataCallback(RNG_HandleTypeDef *hrng, uint32_t random32bit)
bogdanm 0:9b334a45a8ff 439 {
bogdanm 0:9b334a45a8ff 440 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 441 function HAL_RNG_ReadyDataCallback must be implemented in the user file.
bogdanm 0:9b334a45a8ff 442 */
bogdanm 0:9b334a45a8ff 443 }
bogdanm 0:9b334a45a8ff 444
bogdanm 0:9b334a45a8ff 445 /**
bogdanm 0:9b334a45a8ff 446 * @brief RNG error callbacks.
bogdanm 0:9b334a45a8ff 447 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 448 * @retval None
bogdanm 0:9b334a45a8ff 449 */
bogdanm 0:9b334a45a8ff 450 __weak void HAL_RNG_ErrorCallback(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 451 {
bogdanm 0:9b334a45a8ff 452 /* NOTE : This function should not be modified. When the callback is needed,
bogdanm 0:9b334a45a8ff 453 function HAL_RNG_ErrorCallback must be implemented in the user file.
bogdanm 0:9b334a45a8ff 454 */
bogdanm 0:9b334a45a8ff 455 }
bogdanm 0:9b334a45a8ff 456
bogdanm 0:9b334a45a8ff 457 /**
bogdanm 0:9b334a45a8ff 458 * @}
bogdanm 0:9b334a45a8ff 459 */
bogdanm 0:9b334a45a8ff 460
bogdanm 0:9b334a45a8ff 461 /** @addtogroup RNG_Exported_Functions_Group3
bogdanm 0:9b334a45a8ff 462 * @brief Peripheral State functions.
bogdanm 0:9b334a45a8ff 463 *
bogdanm 0:9b334a45a8ff 464 @verbatim
bogdanm 0:9b334a45a8ff 465 ===============================================================================
bogdanm 0:9b334a45a8ff 466 ##### Peripheral State functions #####
bogdanm 0:9b334a45a8ff 467 ===============================================================================
bogdanm 0:9b334a45a8ff 468 [..]
bogdanm 0:9b334a45a8ff 469 This subsection permits to get in run-time the status of the peripheral.
bogdanm 0:9b334a45a8ff 470
bogdanm 0:9b334a45a8ff 471 @endverbatim
bogdanm 0:9b334a45a8ff 472 * @{
bogdanm 0:9b334a45a8ff 473 */
bogdanm 0:9b334a45a8ff 474
bogdanm 0:9b334a45a8ff 475 /**
bogdanm 0:9b334a45a8ff 476 * @brief Returns the RNG state.
bogdanm 0:9b334a45a8ff 477 * @param hrng: pointer to a RNG_HandleTypeDef structure.
bogdanm 0:9b334a45a8ff 478 * @retval HAL state
bogdanm 0:9b334a45a8ff 479 */
bogdanm 0:9b334a45a8ff 480 HAL_RNG_StateTypeDef HAL_RNG_GetState(RNG_HandleTypeDef *hrng)
bogdanm 0:9b334a45a8ff 481 {
bogdanm 0:9b334a45a8ff 482 return hrng->State;
bogdanm 0:9b334a45a8ff 483 }
bogdanm 0:9b334a45a8ff 484
bogdanm 0:9b334a45a8ff 485 /**
bogdanm 0:9b334a45a8ff 486 * @}
bogdanm 0:9b334a45a8ff 487 */
bogdanm 0:9b334a45a8ff 488
bogdanm 0:9b334a45a8ff 489 /**
bogdanm 0:9b334a45a8ff 490 * @}
bogdanm 0:9b334a45a8ff 491 */
bogdanm 0:9b334a45a8ff 492
bogdanm 0:9b334a45a8ff 493 #endif /* if defined (STM32L052xx) || defined (STM32L053xx) || defined (STM32L062xx) || defined (STM32L063xx) || \
bogdanm 0:9b334a45a8ff 494 defined (STM32L072xx) || defined (STM32L073xx) || defined (STM32L082xx) || defined (STM32L083xx) */
bogdanm 0:9b334a45a8ff 495
bogdanm 0:9b334a45a8ff 496 #endif /* HAL_RNG_MODULE_ENABLED */
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 */
bogdanm 0:9b334a45a8ff 505
bogdanm 0:9b334a45a8ff 506 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
bogdanm 0:9b334a45a8ff 507