1 /**
2   ******************************************************************************
3   * @file    stm32l5xx_ll_rng.c
4   * @author  MCD Application Team
5   * @brief   RNG LL module driver.
6   ******************************************************************************
7   * @attention
8   *
9   * <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
10   * All rights reserved.</center></h2>
11   *
12   * This software component is licensed by ST under BSD 3-Clause license,
13   * the "License"; You may not use this file except in compliance with the
14   * License. You may obtain a copy of the License at:
15   *                        opensource.org/licenses/BSD-3-Clause
16   *
17   ******************************************************************************
18   */
19 #if defined(USE_FULL_LL_DRIVER)
20 
21 /* Includes ------------------------------------------------------------------*/
22 #include "stm32l5xx_ll_rng.h"
23 #include "stm32l5xx_ll_bus.h"
24 
25 #ifdef  USE_FULL_ASSERT
26 #include "stm32_assert.h"
27 #else
28 #define assert_param(expr) ((void)0U)
29 #endif /* USE_FULL_ASSERT */
30 
31 /** @addtogroup STM32L5xx_LL_Driver
32   * @{
33   */
34 
35 #if defined (RNG)
36 
37 /** @addtogroup RNG_LL
38   * @{
39   */
40 
41 /* Private types -------------------------------------------------------------*/
42 /* Private variables ---------------------------------------------------------*/
43 /* Private constants ---------------------------------------------------------*/
44 /* Private macros ------------------------------------------------------------*/
45 /** @defgroup RNG_LL_Private_Macros RNG Private Macros
46   * @{
47   */
48 #define IS_LL_RNG_CED(__MODE__) (((__MODE__) == LL_RNG_CED_ENABLE) || \
49                                  ((__MODE__) == LL_RNG_CED_DISABLE))
50 
51 #define IS_LL_RNG_CLOCK_DIVIDER(__CLOCK_DIV__) ((__CLOCK_DIV__) <=0x0Fu)
52 
53 
54 #define IS_LL_RNG_NIST_COMPLIANCE(__NIST_COMPLIANCE__) (((__NIST_COMPLIANCE__) == LL_RNG_NIST_COMPLIANT) || \
55                                                         ((__NIST_COMPLIANCE__) == LL_RNG_NOTNIST_COMPLIANT))
56 
57 #define IS_LL_RNG_CONFIG1 (__CONFIG1__) ((__CONFIG1__) <= 0x3FUL)
58 
59 #define IS_LL_RNG_CONFIG2 (__CONFIG2__) ((__CONFIG2__) <= 0x07UL)
60 
61 #define IS_LL_RNG_CONFIG3 (__CONFIG3__) ((__CONFIG3__) <= 0xFUL)
62 /**
63   * @}
64   */
65 /* Private function prototypes -----------------------------------------------*/
66 
67 /* Exported functions --------------------------------------------------------*/
68 /** @addtogroup RNG_LL_Exported_Functions
69   * @{
70   */
71 
72 /** @addtogroup RNG_LL_EF_Init
73   * @{
74   */
75 
76 /**
77   * @brief  De-initialize RNG registers (Registers restored to their default values).
78   * @param  RNGx RNG Instance
79   * @retval An ErrorStatus enumeration value:
80   *          - SUCCESS: RNG registers are de-initialized
81   *          - ERROR: not applicable
82   */
LL_RNG_DeInit(RNG_TypeDef * RNGx)83 ErrorStatus LL_RNG_DeInit(RNG_TypeDef *RNGx)
84 {
85   /* Check the parameters */
86   assert_param(IS_RNG_ALL_INSTANCE(RNGx));
87   /* Enable RNG reset state */
88   LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_RNG);
89 
90   /* Release RNG from reset state */
91   LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_RNG);
92   return (SUCCESS);
93 }
94 
95 /**
96   * @brief  Initialize RNG registers according to the specified parameters in RNG_InitStruct.
97   * @param  RNGx RNG Instance
98   * @param  RNG_InitStruct pointer to a LL_RNG_InitTypeDef structure
99   *         that contains the configuration information for the specified RNG peripheral.
100   * @retval An ErrorStatus enumeration value:
101   *          - SUCCESS: RNG registers are initialized according to RNG_InitStruct content
102   *          - ERROR: not applicable
103   */
LL_RNG_Init(RNG_TypeDef * RNGx,LL_RNG_InitTypeDef * RNG_InitStruct)104 ErrorStatus LL_RNG_Init(RNG_TypeDef *RNGx, LL_RNG_InitTypeDef *RNG_InitStruct)
105 {
106   /* Check the parameters */
107   assert_param(IS_RNG_ALL_INSTANCE(RNGx));
108   assert_param(IS_LL_RNG_CED(RNG_InitStruct->ClockErrorDetection));
109 
110   /* Clock Error Detection Configuration when CONDRT bit is set to 1 */
111   MODIFY_REG(RNGx->CR, RNG_CR_CED | RNG_CR_CONDRST, RNG_InitStruct->ClockErrorDetection | RNG_CR_CONDRST);
112   /* Writing bits CONDRST=0*/
113   CLEAR_BIT(RNGx->CR, RNG_CR_CONDRST);
114 
115   return (SUCCESS);
116 }
117 
118 /**
119   * @brief Set each @ref LL_RNG_InitTypeDef field to default value.
120   * @param RNG_InitStruct pointer to a @ref LL_RNG_InitTypeDef structure
121   *                       whose fields will be set to default values.
122   * @retval None
123   */
LL_RNG_StructInit(LL_RNG_InitTypeDef * RNG_InitStruct)124 void LL_RNG_StructInit(LL_RNG_InitTypeDef *RNG_InitStruct)
125 {
126   /* Set RNG_InitStruct fields to default values */
127   RNG_InitStruct->ClockErrorDetection = LL_RNG_CED_ENABLE;
128 
129 }
130 /**
131   * @}
132   */
133 
134 /**
135   * @}
136   */
137 
138 /**
139   * @}
140   */
141 
142 #endif /* RNG */
143 
144 /**
145   * @}
146   */
147 
148 #endif /* USE_FULL_LL_DRIVER */
149 
150 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
151 
152