STM32L486xx HAL User Manual
|
00001 /** 00002 ****************************************************************************** 00003 * @file stm32l4xx_ll_rng.c 00004 * @author MCD Application Team 00005 * @brief RNG LL module driver. 00006 ****************************************************************************** 00007 * @attention 00008 * 00009 * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2> 00010 * 00011 * Redistribution and use in source and binary forms, with or without modification, 00012 * are permitted provided that the following conditions are met: 00013 * 1. Redistributions of source code must retain the above copyright notice, 00014 * this list of conditions and the following disclaimer. 00015 * 2. Redistributions in binary form must reproduce the above copyright notice, 00016 * this list of conditions and the following disclaimer in the documentation 00017 * and/or other materials provided with the distribution. 00018 * 3. Neither the name of STMicroelectronics nor the names of its contributors 00019 * may be used to endorse or promote products derived from this software 00020 * without specific prior written permission. 00021 * 00022 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00023 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00024 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00025 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE 00026 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 00027 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 00028 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 00029 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00030 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 00031 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 00032 * 00033 ****************************************************************************** 00034 */ 00035 #if defined(USE_FULL_LL_DRIVER) 00036 00037 /* Includes ------------------------------------------------------------------*/ 00038 #include "stm32l4xx_ll_rng.h" 00039 #include "stm32l4xx_ll_bus.h" 00040 00041 #ifdef USE_FULL_ASSERT 00042 #include "stm32_assert.h" 00043 #else 00044 #define assert_param(expr) ((void)0U) 00045 #endif 00046 00047 /** @addtogroup STM32L4xx_LL_Driver 00048 * @{ 00049 */ 00050 00051 #if defined (RNG) 00052 00053 /** @addtogroup RNG_LL 00054 * @{ 00055 */ 00056 00057 /* Private types -------------------------------------------------------------*/ 00058 /* Private variables ---------------------------------------------------------*/ 00059 /* Private constants ---------------------------------------------------------*/ 00060 /* Private macros ------------------------------------------------------------*/ 00061 /** @addtogroup RNG_LL_Private_Macros 00062 * @{ 00063 */ 00064 #if defined(RNG_CR_CED) 00065 #define IS_LL_RNG_CED(__MODE__) (((__MODE__) == LL_RNG_CED_ENABLE) || \ 00066 ((__MODE__) == LL_RNG_CED_DISABLE)) 00067 #endif /* defined(RNG_CR_CED) */ 00068 00069 /** 00070 * @} 00071 */ 00072 00073 /* Private function prototypes -----------------------------------------------*/ 00074 00075 /* Exported functions --------------------------------------------------------*/ 00076 /** @addtogroup RNG_LL_Exported_Functions 00077 * @{ 00078 */ 00079 00080 /** @addtogroup RNG_LL_EF_Init 00081 * @{ 00082 */ 00083 00084 /** 00085 * @brief De-initialize RNG registers (Registers restored to their default values). 00086 * @param RNGx RNG Instance 00087 * @retval An ErrorStatus enumeration value: 00088 * - SUCCESS: RNG registers are de-initialized 00089 * - ERROR: not applicable 00090 */ 00091 ErrorStatus LL_RNG_DeInit(RNG_TypeDef *RNGx) 00092 { 00093 /* Check the parameters */ 00094 assert_param(IS_RNG_ALL_INSTANCE(RNGx)); 00095 00096 /* Enable RNG reset state */ 00097 LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_RNG); 00098 00099 /* Release RNG from reset state */ 00100 LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_RNG); 00101 00102 return (SUCCESS); 00103 } 00104 00105 #if defined(RNG_CR_CED) 00106 /** 00107 * @brief Initialize RNG registers according to the specified parameters in RNG_InitStruct. 00108 * @param RNGx RNG Instance 00109 * @param RNG_InitStruct: pointer to a LL_RNG_InitTypeDef structure 00110 * that contains the configuration information for the specified RNG peripheral. 00111 * @retval An ErrorStatus enumeration value: 00112 * - SUCCESS: RNG registers are initialized according to RNG_InitStruct content 00113 * - ERROR: not applicable 00114 */ 00115 ErrorStatus LL_RNG_Init(RNG_TypeDef *RNGx, LL_RNG_InitTypeDef *RNG_InitStruct) 00116 { 00117 /* Check the parameters */ 00118 assert_param(IS_RNG_ALL_INSTANCE(RNGx)); 00119 assert_param(IS_LL_RNG_CED(RNG_InitStruct->ClockErrorDetection)); 00120 00121 /* Clock Error Detection configuration */ 00122 MODIFY_REG(RNGx->CR, RNG_CR_CED, RNG_InitStruct->ClockErrorDetection); 00123 00124 return (SUCCESS); 00125 } 00126 00127 /** 00128 * @brief Set each @ref LL_RNG_InitTypeDef field to default value. 00129 * @param RNG_InitStruct: pointer to a @ref LL_RNG_InitTypeDef structure 00130 * whose fields will be set to default values. 00131 * @retval None 00132 */ 00133 void LL_RNG_StructInit(LL_RNG_InitTypeDef *RNG_InitStruct) 00134 { 00135 /* Set RNG_InitStruct fields to default values */ 00136 RNG_InitStruct->ClockErrorDetection = LL_RNG_CED_ENABLE; 00137 00138 } 00139 #endif /* defined(RNG_CR_CED) */ 00140 00141 /** 00142 * @} 00143 */ 00144 00145 /** 00146 * @} 00147 */ 00148 00149 /** 00150 * @} 00151 */ 00152 00153 #endif /* defined (RNG) */ 00154 00155 /** 00156 * @} 00157 */ 00158 00159 #endif /* USE_FULL_LL_DRIVER */ 00160 00161 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ 00162