MacroRat / MouseCode

Mouse code for the MacroRat

Dependencies:   ITG3200 QEI

mbed-dev/targets/TARGET_STM/TARGET_STM32F4/device/stm32f4xx_hal_rng.c@18:6a4db94011d3, 2017-05-14 (annotated)

Committer:
sahilmgandhi
Date:
Sun May 14 23:18:57 2017 +0000
Revision:
18:6a4db94011d3
Publishing again

Who changed what in which revision?

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