stm32l1xx_ll_rcc.h 57 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821
  1. /**
  2. ******************************************************************************
  3. * @file stm32l1xx_ll_rcc.h
  4. * @author MCD Application Team
  5. * @brief Header file of RCC LL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
  10. *
  11. * Redistribution and use in source and binary forms, with or without modification,
  12. * are permitted provided that the following conditions are met:
  13. * 1. Redistributions of source code must retain the above copyright notice,
  14. * this list of conditions and the following disclaimer.
  15. * 2. Redistributions in binary form must reproduce the above copyright notice,
  16. * this list of conditions and the following disclaimer in the documentation
  17. * and/or other materials provided with the distribution.
  18. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  19. * may be used to endorse or promote products derived from this software
  20. * without specific prior written permission.
  21. *
  22. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  23. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  25. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  26. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  28. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  29. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  30. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  31. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  32. *
  33. ******************************************************************************
  34. */
  35. /* Define to prevent recursive inclusion -------------------------------------*/
  36. #ifndef __STM32L1xx_LL_RCC_H
  37. #define __STM32L1xx_LL_RCC_H
  38. #ifdef __cplusplus
  39. extern "C" {
  40. #endif
  41. /* Includes ------------------------------------------------------------------*/
  42. #include "stm32l1xx.h"
  43. /** @addtogroup STM32L1xx_LL_Driver
  44. * @{
  45. */
  46. #if defined(RCC)
  47. /** @defgroup RCC_LL RCC
  48. * @{
  49. */
  50. /* Private types -------------------------------------------------------------*/
  51. /* Private variables ---------------------------------------------------------*/
  52. /* Private constants ---------------------------------------------------------*/
  53. /** @defgroup RCC_LL_Private_Constants RCC Private Constants
  54. * @{
  55. */
  56. /* Defines used for the bit position in the register and perform offsets*/
  57. #define RCC_POSITION_MSICAL (uint32_t)POSITION_VAL(RCC_ICSCR_MSICAL) /*!< field position in register RCC_ICSCR */
  58. #define RCC_POSITION_MSITRIM (uint32_t)POSITION_VAL(RCC_ICSCR_MSITRIM) /*!< field position in register RCC_ICSCR */
  59. #define RCC_POSITION_MSIRANGE (uint32_t)POSITION_VAL(RCC_ICSCR_MSIRANGE) /*!< field position in register RCC_ICSCR */
  60. #define RCC_POSITION_HPRE (uint32_t)POSITION_VAL(RCC_CFGR_HPRE) /*!< field position in register RCC_CFGR */
  61. #define RCC_POSITION_PPRE1 (uint32_t)POSITION_VAL(RCC_CFGR_PPRE1) /*!< field position in register RCC_CFGR */
  62. #define RCC_POSITION_PPRE2 (uint32_t)POSITION_VAL(RCC_CFGR_PPRE2) /*!< field position in register RCC_CFGR */
  63. #define RCC_POSITION_HSICAL (uint32_t)POSITION_VAL(RCC_ICSCR_HSICAL) /*!< field position in register RCC_ICSCR */
  64. #define RCC_POSITION_HSITRIM (uint32_t)POSITION_VAL(RCC_ICSCR_HSITRIM) /*!< field position in register RCC_ICSCR */
  65. #define RCC_POSITION_PLLMUL (uint32_t)POSITION_VAL(RCC_CFGR_PLLMUL) /*!< field position in register RCC_CFGR */
  66. #define RCC_POSITION_PLLDIV (uint32_t)POSITION_VAL(RCC_CFGR_PLLDIV) /*!< field position in register RCC_CFGR */
  67. /**
  68. * @}
  69. */
  70. /* Private macros ------------------------------------------------------------*/
  71. /* Exported types ------------------------------------------------------------*/
  72. #if defined(USE_FULL_LL_DRIVER)
  73. /** @defgroup RCC_LL_Exported_Types RCC Exported Types
  74. * @{
  75. */
  76. /** @defgroup LL_ES_CLOCK_FREQ Clocks Frequency Structure
  77. * @{
  78. */
  79. /**
  80. * @brief RCC Clocks Frequency Structure
  81. */
  82. typedef struct
  83. {
  84. uint32_t SYSCLK_Frequency; /*!< SYSCLK clock frequency */
  85. uint32_t HCLK_Frequency; /*!< HCLK clock frequency */
  86. uint32_t PCLK1_Frequency; /*!< PCLK1 clock frequency */
  87. uint32_t PCLK2_Frequency; /*!< PCLK2 clock frequency */
  88. } LL_RCC_ClocksTypeDef;
  89. /**
  90. * @}
  91. */
  92. /**
  93. * @}
  94. */
  95. #endif /* USE_FULL_LL_DRIVER */
  96. /* Exported constants --------------------------------------------------------*/
  97. /** @defgroup RCC_LL_Exported_Constants RCC Exported Constants
  98. * @{
  99. */
  100. /** @defgroup RCC_LL_EC_OSC_VALUES Oscillator Values adaptation
  101. * @brief Defines used to adapt values of different oscillators
  102. * @note These values could be modified in the user environment according to
  103. * HW set-up.
  104. * @{
  105. */
  106. #if !defined (HSE_VALUE)
  107. #define HSE_VALUE 8000000U /*!< Value of the HSE oscillator in Hz */
  108. #endif /* HSE_VALUE */
  109. #if !defined (HSI_VALUE)
  110. #define HSI_VALUE 16000000U /*!< Value of the HSI oscillator in Hz */
  111. #endif /* HSI_VALUE */
  112. #if !defined (LSE_VALUE)
  113. #define LSE_VALUE 32768U /*!< Value of the LSE oscillator in Hz */
  114. #endif /* LSE_VALUE */
  115. #if !defined (LSI_VALUE)
  116. #define LSI_VALUE 32000U /*!< Value of the LSI oscillator in Hz */
  117. #endif /* LSI_VALUE */
  118. /**
  119. * @}
  120. */
  121. /** @defgroup RCC_LL_EC_CLEAR_FLAG Clear Flags Defines
  122. * @brief Flags defines which can be used with LL_RCC_WriteReg function
  123. * @{
  124. */
  125. #define LL_RCC_CIR_LSIRDYC RCC_CIR_LSIRDYC /*!< LSI Ready Interrupt Clear */
  126. #define LL_RCC_CIR_LSERDYC RCC_CIR_LSERDYC /*!< LSE Ready Interrupt Clear */
  127. #define LL_RCC_CIR_HSIRDYC RCC_CIR_HSIRDYC /*!< HSI Ready Interrupt Clear */
  128. #define LL_RCC_CIR_HSERDYC RCC_CIR_HSERDYC /*!< HSE Ready Interrupt Clear */
  129. #define LL_RCC_CIR_PLLRDYC RCC_CIR_PLLRDYC /*!< PLL Ready Interrupt Clear */
  130. #define LL_RCC_CIR_MSIRDYC RCC_CIR_MSIRDYC /*!< MSI Ready Interrupt Clear */
  131. #if defined(RCC_LSECSS_SUPPORT)
  132. #define LL_RCC_CIR_LSECSSC RCC_CIR_LSECSSC /*!< LSE Clock Security System Interrupt Clear */
  133. #endif /* RCC_LSECSS_SUPPORT */
  134. #define LL_RCC_CIR_CSSC RCC_CIR_CSSC /*!< Clock Security System Interrupt Clear */
  135. /**
  136. * @}
  137. */
  138. /** @defgroup RCC_LL_EC_GET_FLAG Get Flags Defines
  139. * @brief Flags defines which can be used with LL_RCC_ReadReg function
  140. * @{
  141. */
  142. #define LL_RCC_CIR_LSIRDYF RCC_CIR_LSIRDYF /*!< LSI Ready Interrupt flag */
  143. #define LL_RCC_CIR_LSERDYF RCC_CIR_LSERDYF /*!< LSE Ready Interrupt flag */
  144. #define LL_RCC_CIR_HSIRDYF RCC_CIR_HSIRDYF /*!< HSI Ready Interrupt flag */
  145. #define LL_RCC_CIR_HSERDYF RCC_CIR_HSERDYF /*!< HSE Ready Interrupt flag */
  146. #define LL_RCC_CIR_PLLRDYF RCC_CIR_PLLRDYF /*!< PLL Ready Interrupt flag */
  147. #define LL_RCC_CIR_MSIRDYF RCC_CIR_MSIRDYF /*!< MSI Ready Interrupt flag */
  148. #if defined(RCC_LSECSS_SUPPORT)
  149. #define LL_RCC_CIR_LSECSSF RCC_CIR_LSECSSF /*!< LSE Clock Security System Interrupt flag */
  150. #endif /* RCC_LSECSS_SUPPORT */
  151. #define LL_RCC_CIR_CSSF RCC_CIR_CSSF /*!< Clock Security System Interrupt flag */
  152. #define LL_RCC_CSR_OBLRSTF RCC_CSR_OBLRSTF /*!< OBL reset flag */
  153. #define LL_RCC_CSR_PINRSTF RCC_CSR_PINRSTF /*!< PIN reset flag */
  154. #define LL_RCC_CSR_PORRSTF RCC_CSR_PORRSTF /*!< POR/PDR reset flag */
  155. #define LL_RCC_CSR_SFTRSTF RCC_CSR_SFTRSTF /*!< Software Reset flag */
  156. #define LL_RCC_CSR_IWDGRSTF RCC_CSR_IWDGRSTF /*!< Independent Watchdog reset flag */
  157. #define LL_RCC_CSR_WWDGRSTF RCC_CSR_WWDGRSTF /*!< Window watchdog reset flag */
  158. #define LL_RCC_CSR_LPWRRSTF RCC_CSR_LPWRRSTF /*!< Low-Power reset flag */
  159. /**
  160. * @}
  161. */
  162. /** @defgroup RCC_LL_EC_IT IT Defines
  163. * @brief IT defines which can be used with LL_RCC_ReadReg and LL_RCC_WriteReg functions
  164. * @{
  165. */
  166. #define LL_RCC_CIR_LSIRDYIE RCC_CIR_LSIRDYIE /*!< LSI Ready Interrupt Enable */
  167. #define LL_RCC_CIR_LSERDYIE RCC_CIR_LSERDYIE /*!< LSE Ready Interrupt Enable */
  168. #define LL_RCC_CIR_HSIRDYIE RCC_CIR_HSIRDYIE /*!< HSI Ready Interrupt Enable */
  169. #define LL_RCC_CIR_HSERDYIE RCC_CIR_HSERDYIE /*!< HSE Ready Interrupt Enable */
  170. #define LL_RCC_CIR_PLLRDYIE RCC_CIR_PLLRDYIE /*!< PLL Ready Interrupt Enable */
  171. #define LL_RCC_CIR_MSIRDYIE RCC_CIR_MSIRDYIE /*!< MSI Ready Interrupt Enable */
  172. #if defined(RCC_LSECSS_SUPPORT)
  173. #define LL_RCC_CIR_LSECSSIE RCC_CIR_LSECSSIE /*!< LSE CSS Interrupt Enable */
  174. #endif /* RCC_LSECSS_SUPPORT */
  175. /**
  176. * @}
  177. */
  178. /** @defgroup RCC_LL_EC_RTC_HSE_DIV RTC HSE Prescaler
  179. * @{
  180. */
  181. #define LL_RCC_RTC_HSE_DIV_2 0x00000000U /*!< HSE is divided by 2 for RTC clock */
  182. #define LL_RCC_RTC_HSE_DIV_4 RCC_CR_RTCPRE_0 /*!< HSE is divided by 4 for RTC clock */
  183. #define LL_RCC_RTC_HSE_DIV_8 RCC_CR_RTCPRE_1 /*!< HSE is divided by 8 for RTC clock */
  184. #define LL_RCC_RTC_HSE_DIV_16 RCC_CR_RTCPRE /*!< HSE is divided by 16 for RTC clock */
  185. /**
  186. * @}
  187. */
  188. /** @defgroup RCC_LL_EC_MSIRANGE MSI clock ranges
  189. * @{
  190. */
  191. #define LL_RCC_MSIRANGE_0 RCC_ICSCR_MSIRANGE_0 /*!< MSI = 65.536 KHz */
  192. #define LL_RCC_MSIRANGE_1 RCC_ICSCR_MSIRANGE_1 /*!< MSI = 131.072 KHz*/
  193. #define LL_RCC_MSIRANGE_2 RCC_ICSCR_MSIRANGE_2 /*!< MSI = 262.144 KHz */
  194. #define LL_RCC_MSIRANGE_3 RCC_ICSCR_MSIRANGE_3 /*!< MSI = 524.288 KHz */
  195. #define LL_RCC_MSIRANGE_4 RCC_ICSCR_MSIRANGE_4 /*!< MSI = 1.048 MHz */
  196. #define LL_RCC_MSIRANGE_5 RCC_ICSCR_MSIRANGE_5 /*!< MSI = 2.097 MHz */
  197. #define LL_RCC_MSIRANGE_6 RCC_ICSCR_MSIRANGE_6 /*!< MSI = 4.194 MHz */
  198. /**
  199. * @}
  200. */
  201. /** @defgroup RCC_LL_EC_SYS_CLKSOURCE System clock switch
  202. * @{
  203. */
  204. #define LL_RCC_SYS_CLKSOURCE_MSI RCC_CFGR_SW_MSI /*!< MSI selection as system clock */
  205. #define LL_RCC_SYS_CLKSOURCE_HSI RCC_CFGR_SW_HSI /*!< HSI selection as system clock */
  206. #define LL_RCC_SYS_CLKSOURCE_HSE RCC_CFGR_SW_HSE /*!< HSE selection as system clock */
  207. #define LL_RCC_SYS_CLKSOURCE_PLL RCC_CFGR_SW_PLL /*!< PLL selection as system clock */
  208. /**
  209. * @}
  210. */
  211. /** @defgroup RCC_LL_EC_SYS_CLKSOURCE_STATUS System clock switch status
  212. * @{
  213. */
  214. #define LL_RCC_SYS_CLKSOURCE_STATUS_MSI RCC_CFGR_SWS_MSI /*!< MSI used as system clock */
  215. #define LL_RCC_SYS_CLKSOURCE_STATUS_HSI RCC_CFGR_SWS_HSI /*!< HSI used as system clock */
  216. #define LL_RCC_SYS_CLKSOURCE_STATUS_HSE RCC_CFGR_SWS_HSE /*!< HSE used as system clock */
  217. #define LL_RCC_SYS_CLKSOURCE_STATUS_PLL RCC_CFGR_SWS_PLL /*!< PLL used as system clock */
  218. /**
  219. * @}
  220. */
  221. /** @defgroup RCC_LL_EC_SYSCLK_DIV AHB prescaler
  222. * @{
  223. */
  224. #define LL_RCC_SYSCLK_DIV_1 RCC_CFGR_HPRE_DIV1 /*!< SYSCLK not divided */
  225. #define LL_RCC_SYSCLK_DIV_2 RCC_CFGR_HPRE_DIV2 /*!< SYSCLK divided by 2 */
  226. #define LL_RCC_SYSCLK_DIV_4 RCC_CFGR_HPRE_DIV4 /*!< SYSCLK divided by 4 */
  227. #define LL_RCC_SYSCLK_DIV_8 RCC_CFGR_HPRE_DIV8 /*!< SYSCLK divided by 8 */
  228. #define LL_RCC_SYSCLK_DIV_16 RCC_CFGR_HPRE_DIV16 /*!< SYSCLK divided by 16 */
  229. #define LL_RCC_SYSCLK_DIV_64 RCC_CFGR_HPRE_DIV64 /*!< SYSCLK divided by 64 */
  230. #define LL_RCC_SYSCLK_DIV_128 RCC_CFGR_HPRE_DIV128 /*!< SYSCLK divided by 128 */
  231. #define LL_RCC_SYSCLK_DIV_256 RCC_CFGR_HPRE_DIV256 /*!< SYSCLK divided by 256 */
  232. #define LL_RCC_SYSCLK_DIV_512 RCC_CFGR_HPRE_DIV512 /*!< SYSCLK divided by 512 */
  233. /**
  234. * @}
  235. */
  236. /** @defgroup RCC_LL_EC_APB1_DIV APB low-speed prescaler (APB1)
  237. * @{
  238. */
  239. #define LL_RCC_APB1_DIV_1 RCC_CFGR_PPRE1_DIV1 /*!< HCLK not divided */
  240. #define LL_RCC_APB1_DIV_2 RCC_CFGR_PPRE1_DIV2 /*!< HCLK divided by 2 */
  241. #define LL_RCC_APB1_DIV_4 RCC_CFGR_PPRE1_DIV4 /*!< HCLK divided by 4 */
  242. #define LL_RCC_APB1_DIV_8 RCC_CFGR_PPRE1_DIV8 /*!< HCLK divided by 8 */
  243. #define LL_RCC_APB1_DIV_16 RCC_CFGR_PPRE1_DIV16 /*!< HCLK divided by 16 */
  244. /**
  245. * @}
  246. */
  247. /** @defgroup RCC_LL_EC_APB2_DIV APB high-speed prescaler (APB2)
  248. * @{
  249. */
  250. #define LL_RCC_APB2_DIV_1 RCC_CFGR_PPRE2_DIV1 /*!< HCLK not divided */
  251. #define LL_RCC_APB2_DIV_2 RCC_CFGR_PPRE2_DIV2 /*!< HCLK divided by 2 */
  252. #define LL_RCC_APB2_DIV_4 RCC_CFGR_PPRE2_DIV4 /*!< HCLK divided by 4 */
  253. #define LL_RCC_APB2_DIV_8 RCC_CFGR_PPRE2_DIV8 /*!< HCLK divided by 8 */
  254. #define LL_RCC_APB2_DIV_16 RCC_CFGR_PPRE2_DIV16 /*!< HCLK divided by 16 */
  255. /**
  256. * @}
  257. */
  258. /** @defgroup RCC_LL_EC_MCO1SOURCE MCO1 SOURCE selection
  259. * @{
  260. */
  261. #define LL_RCC_MCO1SOURCE_NOCLOCK RCC_CFGR_MCOSEL_NOCLOCK /*!< MCO output disabled, no clock on MCO */
  262. #define LL_RCC_MCO1SOURCE_SYSCLK RCC_CFGR_MCOSEL_SYSCLK /*!< SYSCLK selection as MCO source */
  263. #define LL_RCC_MCO1SOURCE_HSI RCC_CFGR_MCOSEL_HSI /*!< HSI selection as MCO source */
  264. #define LL_RCC_MCO1SOURCE_MSI RCC_CFGR_MCOSEL_MSI /*!< MSI selection as MCO source */
  265. #define LL_RCC_MCO1SOURCE_HSE RCC_CFGR_MCOSEL_HSE /*!< HSE selection as MCO source */
  266. #define LL_RCC_MCO1SOURCE_LSI RCC_CFGR_MCOSEL_LSI /*!< LSI selection as MCO source */
  267. #define LL_RCC_MCO1SOURCE_LSE RCC_CFGR_MCOSEL_LSE /*!< LSE selection as MCO source */
  268. #define LL_RCC_MCO1SOURCE_PLLCLK RCC_CFGR_MCOSEL_PLL /*!< PLLCLK selection as MCO source */
  269. /**
  270. * @}
  271. */
  272. /** @defgroup RCC_LL_EC_MCO1_DIV MCO1 prescaler
  273. * @{
  274. */
  275. #define LL_RCC_MCO1_DIV_1 RCC_CFGR_MCOPRE_DIV1 /*!< MCO Clock divided by 1 */
  276. #define LL_RCC_MCO1_DIV_2 RCC_CFGR_MCOPRE_DIV2 /*!< MCO Clock divided by 2 */
  277. #define LL_RCC_MCO1_DIV_4 RCC_CFGR_MCOPRE_DIV4 /*!< MCO Clock divided by 4 */
  278. #define LL_RCC_MCO1_DIV_8 RCC_CFGR_MCOPRE_DIV8 /*!< MCO Clock divided by 8 */
  279. #define LL_RCC_MCO1_DIV_16 RCC_CFGR_MCOPRE_DIV16 /*!< MCO Clock divided by 16 */
  280. /**
  281. * @}
  282. */
  283. #if defined(USE_FULL_LL_DRIVER)
  284. /** @defgroup RCC_LL_EC_PERIPH_FREQUENCY Peripheral clock frequency
  285. * @{
  286. */
  287. #define LL_RCC_PERIPH_FREQUENCY_NO 0x00000000U /*!< No clock enabled for the peripheral */
  288. #define LL_RCC_PERIPH_FREQUENCY_NA 0xFFFFFFFFU /*!< Frequency cannot be provided as external clock */
  289. /**
  290. * @}
  291. */
  292. #endif /* USE_FULL_LL_DRIVER */
  293. /** @defgroup RCC_LL_EC_RTC_CLKSOURCE RTC clock source selection
  294. * @{
  295. */
  296. #define LL_RCC_RTC_CLKSOURCE_NONE 0x00000000U /*!< No clock used as RTC clock */
  297. #define LL_RCC_RTC_CLKSOURCE_LSE RCC_CSR_RTCSEL_LSE /*!< LSE oscillator clock used as RTC clock */
  298. #define LL_RCC_RTC_CLKSOURCE_LSI RCC_CSR_RTCSEL_LSI /*!< LSI oscillator clock used as RTC clock */
  299. #define LL_RCC_RTC_CLKSOURCE_HSE RCC_CSR_RTCSEL_HSE /*!< HSE oscillator clock divided by a programmable prescaler
  300. (selection through @ref LL_RCC_SetRTC_HSEPrescaler function ) */
  301. /**
  302. * @}
  303. */
  304. /** @defgroup RCC_LL_EC_PLL_MUL PLL Multiplicator factor
  305. * @{
  306. */
  307. #define LL_RCC_PLL_MUL_3 RCC_CFGR_PLLMUL3 /*!< PLL input clock * 3 */
  308. #define LL_RCC_PLL_MUL_4 RCC_CFGR_PLLMUL4 /*!< PLL input clock * 4 */
  309. #define LL_RCC_PLL_MUL_6 RCC_CFGR_PLLMUL6 /*!< PLL input clock * 6 */
  310. #define LL_RCC_PLL_MUL_8 RCC_CFGR_PLLMUL8 /*!< PLL input clock * 8 */
  311. #define LL_RCC_PLL_MUL_12 RCC_CFGR_PLLMUL12 /*!< PLL input clock * 12 */
  312. #define LL_RCC_PLL_MUL_16 RCC_CFGR_PLLMUL16 /*!< PLL input clock * 16 */
  313. #define LL_RCC_PLL_MUL_24 RCC_CFGR_PLLMUL24 /*!< PLL input clock * 24 */
  314. #define LL_RCC_PLL_MUL_32 RCC_CFGR_PLLMUL32 /*!< PLL input clock * 32 */
  315. #define LL_RCC_PLL_MUL_48 RCC_CFGR_PLLMUL48 /*!< PLL input clock * 48 */
  316. /**
  317. * @}
  318. */
  319. /** @defgroup RCC_LL_EC_PLL_DIV PLL division factor
  320. * @{
  321. */
  322. #define LL_RCC_PLL_DIV_2 RCC_CFGR_PLLDIV2 /*!< PLL clock output = PLLVCO / 2 */
  323. #define LL_RCC_PLL_DIV_3 RCC_CFGR_PLLDIV3 /*!< PLL clock output = PLLVCO / 3 */
  324. #define LL_RCC_PLL_DIV_4 RCC_CFGR_PLLDIV4 /*!< PLL clock output = PLLVCO / 4 */
  325. /**
  326. * @}
  327. */
  328. /** @defgroup RCC_LL_EC_PLLSOURCE PLL SOURCE
  329. * @{
  330. */
  331. #define LL_RCC_PLLSOURCE_HSI RCC_CFGR_PLLSRC_HSI /*!< HSI clock selected as PLL entry clock source */
  332. #define LL_RCC_PLLSOURCE_HSE RCC_CFGR_PLLSRC_HSE /*!< HSE clock selected as PLL entry clock source */
  333. /**
  334. * @}
  335. */
  336. /**
  337. * @}
  338. */
  339. /* Exported macro ------------------------------------------------------------*/
  340. /** @defgroup RCC_LL_Exported_Macros RCC Exported Macros
  341. * @{
  342. */
  343. /** @defgroup RCC_LL_EM_WRITE_READ Common Write and read registers Macros
  344. * @{
  345. */
  346. /**
  347. * @brief Write a value in RCC register
  348. * @param __REG__ Register to be written
  349. * @param __VALUE__ Value to be written in the register
  350. * @retval None
  351. */
  352. #define LL_RCC_WriteReg(__REG__, __VALUE__) WRITE_REG(RCC->__REG__, (__VALUE__))
  353. /**
  354. * @brief Read a value in RCC register
  355. * @param __REG__ Register to be read
  356. * @retval Register value
  357. */
  358. #define LL_RCC_ReadReg(__REG__) READ_REG(RCC->__REG__)
  359. /**
  360. * @}
  361. */
  362. /** @defgroup RCC_LL_EM_CALC_FREQ Calculate frequencies
  363. * @{
  364. */
  365. /**
  366. * @brief Helper macro to calculate the PLLCLK frequency
  367. * @note ex: @ref __LL_RCC_CALC_PLLCLK_FREQ (HSE_VALUE,
  368. * @ref LL_RCC_PLL_GetMultiplicator (),
  369. * @ref LL_RCC_PLL_GetDivider ());
  370. * @param __INPUTFREQ__ PLL Input frequency (based on MSI/HSE/HSI)
  371. * @param __PLLMUL__ This parameter can be one of the following values:
  372. * @arg @ref LL_RCC_PLL_MUL_3
  373. * @arg @ref LL_RCC_PLL_MUL_4
  374. * @arg @ref LL_RCC_PLL_MUL_6
  375. * @arg @ref LL_RCC_PLL_MUL_8
  376. * @arg @ref LL_RCC_PLL_MUL_12
  377. * @arg @ref LL_RCC_PLL_MUL_16
  378. * @arg @ref LL_RCC_PLL_MUL_24
  379. * @arg @ref LL_RCC_PLL_MUL_32
  380. * @arg @ref LL_RCC_PLL_MUL_48
  381. * @param __PLLDIV__ This parameter can be one of the following values:
  382. * @arg @ref LL_RCC_PLL_DIV_2
  383. * @arg @ref LL_RCC_PLL_DIV_3
  384. * @arg @ref LL_RCC_PLL_DIV_4
  385. * @retval PLL clock frequency (in Hz)
  386. */
  387. #define __LL_RCC_CALC_PLLCLK_FREQ(__INPUTFREQ__, __PLLMUL__, __PLLDIV__) ((__INPUTFREQ__) * (PLLMulTable[(__PLLMUL__) >> RCC_POSITION_PLLMUL]) / (((__PLLDIV__) >> RCC_POSITION_PLLDIV)+1U))
  388. /**
  389. * @brief Helper macro to calculate the HCLK frequency
  390. * @note: __AHBPRESCALER__ be retrieved by @ref LL_RCC_GetAHBPrescaler
  391. * ex: __LL_RCC_CALC_HCLK_FREQ(LL_RCC_GetAHBPrescaler())
  392. * @param __SYSCLKFREQ__ SYSCLK frequency (based on MSI/HSE/HSI/PLLCLK)
  393. * @param __AHBPRESCALER__: This parameter can be one of the following values:
  394. * @arg @ref LL_RCC_SYSCLK_DIV_1
  395. * @arg @ref LL_RCC_SYSCLK_DIV_2
  396. * @arg @ref LL_RCC_SYSCLK_DIV_4
  397. * @arg @ref LL_RCC_SYSCLK_DIV_8
  398. * @arg @ref LL_RCC_SYSCLK_DIV_16
  399. * @arg @ref LL_RCC_SYSCLK_DIV_64
  400. * @arg @ref LL_RCC_SYSCLK_DIV_128
  401. * @arg @ref LL_RCC_SYSCLK_DIV_256
  402. * @arg @ref LL_RCC_SYSCLK_DIV_512
  403. * @retval HCLK clock frequency (in Hz)
  404. */
  405. #define __LL_RCC_CALC_HCLK_FREQ(__SYSCLKFREQ__, __AHBPRESCALER__) ((__SYSCLKFREQ__) >> AHBPrescTable[((__AHBPRESCALER__) & RCC_CFGR_HPRE) >> RCC_CFGR_HPRE_Pos])
  406. /**
  407. * @brief Helper macro to calculate the PCLK1 frequency (ABP1)
  408. * @note: __APB1PRESCALER__ be retrieved by @ref LL_RCC_GetAPB1Prescaler
  409. * ex: __LL_RCC_CALC_PCLK1_FREQ(LL_RCC_GetAPB1Prescaler())
  410. * @param __HCLKFREQ__ HCLK frequency
  411. * @param __APB1PRESCALER__: This parameter can be one of the following values:
  412. * @arg @ref LL_RCC_APB1_DIV_1
  413. * @arg @ref LL_RCC_APB1_DIV_2
  414. * @arg @ref LL_RCC_APB1_DIV_4
  415. * @arg @ref LL_RCC_APB1_DIV_8
  416. * @arg @ref LL_RCC_APB1_DIV_16
  417. * @retval PCLK1 clock frequency (in Hz)
  418. */
  419. #define __LL_RCC_CALC_PCLK1_FREQ(__HCLKFREQ__, __APB1PRESCALER__) ((__HCLKFREQ__) >> APBPrescTable[(__APB1PRESCALER__) >> RCC_CFGR_PPRE1_Pos])
  420. /**
  421. * @brief Helper macro to calculate the PCLK2 frequency (ABP2)
  422. * @note: __APB2PRESCALER__ be retrieved by @ref LL_RCC_GetAPB2Prescaler
  423. * ex: __LL_RCC_CALC_PCLK2_FREQ(LL_RCC_GetAPB2Prescaler())
  424. * @param __HCLKFREQ__ HCLK frequency
  425. * @param __APB2PRESCALER__: This parameter can be one of the following values:
  426. * @arg @ref LL_RCC_APB2_DIV_1
  427. * @arg @ref LL_RCC_APB2_DIV_2
  428. * @arg @ref LL_RCC_APB2_DIV_4
  429. * @arg @ref LL_RCC_APB2_DIV_8
  430. * @arg @ref LL_RCC_APB2_DIV_16
  431. * @retval PCLK2 clock frequency (in Hz)
  432. */
  433. #define __LL_RCC_CALC_PCLK2_FREQ(__HCLKFREQ__, __APB2PRESCALER__) ((__HCLKFREQ__) >> APBPrescTable[(__APB2PRESCALER__) >> RCC_CFGR_PPRE2_Pos])
  434. /**
  435. * @brief Helper macro to calculate the MSI frequency (in Hz)
  436. * @note: __MSIRANGE__can be retrieved by @ref LL_RCC_MSI_GetRange
  437. * ex: __LL_RCC_CALC_MSI_FREQ(LL_RCC_MSI_GetRange())
  438. * @param __MSIRANGE__: This parameter can be one of the following values:
  439. * @arg @ref LL_RCC_MSIRANGE_0
  440. * @arg @ref LL_RCC_MSIRANGE_1
  441. * @arg @ref LL_RCC_MSIRANGE_2
  442. * @arg @ref LL_RCC_MSIRANGE_3
  443. * @arg @ref LL_RCC_MSIRANGE_4
  444. * @arg @ref LL_RCC_MSIRANGE_5
  445. * @arg @ref LL_RCC_MSIRANGE_6
  446. * @retval MSI clock frequency (in Hz)
  447. */
  448. #define __LL_RCC_CALC_MSI_FREQ(__MSIRANGE__) ((32768U * ( 1U << (((__MSIRANGE__) >> RCC_POSITION_MSIRANGE) + 1U))))
  449. /**
  450. * @}
  451. */
  452. /**
  453. * @}
  454. */
  455. /* Exported functions --------------------------------------------------------*/
  456. /** @defgroup RCC_LL_Exported_Functions RCC Exported Functions
  457. * @{
  458. */
  459. /** @defgroup RCC_LL_EF_HSE HSE
  460. * @{
  461. */
  462. /**
  463. * @brief Enable the Clock Security System.
  464. * @rmtoll CR CSSON LL_RCC_HSE_EnableCSS
  465. * @retval None
  466. */
  467. __STATIC_INLINE void LL_RCC_HSE_EnableCSS(void)
  468. {
  469. SET_BIT(RCC->CR, RCC_CR_CSSON);
  470. }
  471. /**
  472. * @brief Disable the Clock Security System.
  473. * @note Cannot be disabled in HSE is ready (only by hardware)
  474. * @rmtoll CR CSSON LL_RCC_HSE_DisableCSS
  475. * @retval None
  476. */
  477. __STATIC_INLINE void LL_RCC_HSE_DisableCSS(void)
  478. {
  479. CLEAR_BIT(RCC->CR, RCC_CR_CSSON);
  480. }
  481. /**
  482. * @brief Enable HSE external oscillator (HSE Bypass)
  483. * @rmtoll CR HSEBYP LL_RCC_HSE_EnableBypass
  484. * @retval None
  485. */
  486. __STATIC_INLINE void LL_RCC_HSE_EnableBypass(void)
  487. {
  488. SET_BIT(RCC->CR, RCC_CR_HSEBYP);
  489. }
  490. /**
  491. * @brief Disable HSE external oscillator (HSE Bypass)
  492. * @rmtoll CR HSEBYP LL_RCC_HSE_DisableBypass
  493. * @retval None
  494. */
  495. __STATIC_INLINE void LL_RCC_HSE_DisableBypass(void)
  496. {
  497. CLEAR_BIT(RCC->CR, RCC_CR_HSEBYP);
  498. }
  499. /**
  500. * @brief Enable HSE crystal oscillator (HSE ON)
  501. * @rmtoll CR HSEON LL_RCC_HSE_Enable
  502. * @retval None
  503. */
  504. __STATIC_INLINE void LL_RCC_HSE_Enable(void)
  505. {
  506. SET_BIT(RCC->CR, RCC_CR_HSEON);
  507. }
  508. /**
  509. * @brief Disable HSE crystal oscillator (HSE ON)
  510. * @rmtoll CR HSEON LL_RCC_HSE_Disable
  511. * @retval None
  512. */
  513. __STATIC_INLINE void LL_RCC_HSE_Disable(void)
  514. {
  515. CLEAR_BIT(RCC->CR, RCC_CR_HSEON);
  516. }
  517. /**
  518. * @brief Check if HSE oscillator Ready
  519. * @rmtoll CR HSERDY LL_RCC_HSE_IsReady
  520. * @retval State of bit (1 or 0).
  521. */
  522. __STATIC_INLINE uint32_t LL_RCC_HSE_IsReady(void)
  523. {
  524. return (READ_BIT(RCC->CR, RCC_CR_HSERDY) == (RCC_CR_HSERDY));
  525. }
  526. /**
  527. * @brief Configure the RTC prescaler (divider)
  528. * @rmtoll CR RTCPRE LL_RCC_SetRTC_HSEPrescaler
  529. * @param Div This parameter can be one of the following values:
  530. * @arg @ref LL_RCC_RTC_HSE_DIV_2
  531. * @arg @ref LL_RCC_RTC_HSE_DIV_4
  532. * @arg @ref LL_RCC_RTC_HSE_DIV_8
  533. * @arg @ref LL_RCC_RTC_HSE_DIV_16
  534. * @retval None
  535. */
  536. __STATIC_INLINE void LL_RCC_SetRTC_HSEPrescaler(uint32_t Div)
  537. {
  538. MODIFY_REG(RCC->CR, RCC_CR_RTCPRE, Div);
  539. }
  540. /**
  541. * @brief Get the RTC divider (prescaler)
  542. * @rmtoll CR RTCPRE LL_RCC_GetRTC_HSEPrescaler
  543. * @retval Returned value can be one of the following values:
  544. * @arg @ref LL_RCC_RTC_HSE_DIV_2
  545. * @arg @ref LL_RCC_RTC_HSE_DIV_4
  546. * @arg @ref LL_RCC_RTC_HSE_DIV_8
  547. * @arg @ref LL_RCC_RTC_HSE_DIV_16
  548. */
  549. __STATIC_INLINE uint32_t LL_RCC_GetRTC_HSEPrescaler(void)
  550. {
  551. return (uint32_t)(READ_BIT(RCC->CR, RCC_CR_RTCPRE));
  552. }
  553. /**
  554. * @}
  555. */
  556. /** @defgroup RCC_LL_EF_HSI HSI
  557. * @{
  558. */
  559. /**
  560. * @brief Enable HSI oscillator
  561. * @rmtoll CR HSION LL_RCC_HSI_Enable
  562. * @retval None
  563. */
  564. __STATIC_INLINE void LL_RCC_HSI_Enable(void)
  565. {
  566. SET_BIT(RCC->CR, RCC_CR_HSION);
  567. }
  568. /**
  569. * @brief Disable HSI oscillator
  570. * @rmtoll CR HSION LL_RCC_HSI_Disable
  571. * @retval None
  572. */
  573. __STATIC_INLINE void LL_RCC_HSI_Disable(void)
  574. {
  575. CLEAR_BIT(RCC->CR, RCC_CR_HSION);
  576. }
  577. /**
  578. * @brief Check if HSI clock is ready
  579. * @rmtoll CR HSIRDY LL_RCC_HSI_IsReady
  580. * @retval State of bit (1 or 0).
  581. */
  582. __STATIC_INLINE uint32_t LL_RCC_HSI_IsReady(void)
  583. {
  584. return (READ_BIT(RCC->CR, RCC_CR_HSIRDY) == (RCC_CR_HSIRDY));
  585. }
  586. /**
  587. * @brief Get HSI Calibration value
  588. * @note When HSITRIM is written, HSICAL is updated with the sum of
  589. * HSITRIM and the factory trim value
  590. * @rmtoll ICSCR HSICAL LL_RCC_HSI_GetCalibration
  591. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  592. */
  593. __STATIC_INLINE uint32_t LL_RCC_HSI_GetCalibration(void)
  594. {
  595. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_HSICAL) >> RCC_ICSCR_HSICAL_Pos);
  596. }
  597. /**
  598. * @brief Set HSI Calibration trimming
  599. * @note user-programmable trimming value that is added to the HSICAL
  600. * @note Default value is 16, which, when added to the HSICAL value,
  601. * should trim the HSI to 16 MHz +/- 1 %
  602. * @rmtoll ICSCR HSITRIM LL_RCC_HSI_SetCalibTrimming
  603. * @param Value between Min_Data = 0x00 and Max_Data = 0x1F
  604. * @retval None
  605. */
  606. __STATIC_INLINE void LL_RCC_HSI_SetCalibTrimming(uint32_t Value)
  607. {
  608. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_HSITRIM, Value << RCC_ICSCR_HSITRIM_Pos);
  609. }
  610. /**
  611. * @brief Get HSI Calibration trimming
  612. * @rmtoll ICSCR HSITRIM LL_RCC_HSI_GetCalibTrimming
  613. * @retval Between Min_Data = 0x00 and Max_Data = 0x1F
  614. */
  615. __STATIC_INLINE uint32_t LL_RCC_HSI_GetCalibTrimming(void)
  616. {
  617. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_HSITRIM) >> RCC_ICSCR_HSITRIM_Pos);
  618. }
  619. /**
  620. * @}
  621. */
  622. /** @defgroup RCC_LL_EF_LSE LSE
  623. * @{
  624. */
  625. /**
  626. * @brief Enable Low Speed External (LSE) crystal.
  627. * @rmtoll CSR LSEON LL_RCC_LSE_Enable
  628. * @retval None
  629. */
  630. __STATIC_INLINE void LL_RCC_LSE_Enable(void)
  631. {
  632. SET_BIT(RCC->CSR, RCC_CSR_LSEON);
  633. }
  634. /**
  635. * @brief Disable Low Speed External (LSE) crystal.
  636. * @rmtoll CSR LSEON LL_RCC_LSE_Disable
  637. * @retval None
  638. */
  639. __STATIC_INLINE void LL_RCC_LSE_Disable(void)
  640. {
  641. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEON);
  642. }
  643. /**
  644. * @brief Enable external clock source (LSE bypass).
  645. * @rmtoll CSR LSEBYP LL_RCC_LSE_EnableBypass
  646. * @retval None
  647. */
  648. __STATIC_INLINE void LL_RCC_LSE_EnableBypass(void)
  649. {
  650. SET_BIT(RCC->CSR, RCC_CSR_LSEBYP);
  651. }
  652. /**
  653. * @brief Disable external clock source (LSE bypass).
  654. * @rmtoll CSR LSEBYP LL_RCC_LSE_DisableBypass
  655. * @retval None
  656. */
  657. __STATIC_INLINE void LL_RCC_LSE_DisableBypass(void)
  658. {
  659. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEBYP);
  660. }
  661. #if defined(RCC_LSECSS_SUPPORT)
  662. /**
  663. * @brief Enable Clock security system on LSE.
  664. * @rmtoll CSR LSECSSON LL_RCC_LSE_EnableCSS
  665. * @retval None
  666. */
  667. __STATIC_INLINE void LL_RCC_LSE_EnableCSS(void)
  668. {
  669. SET_BIT(RCC->CSR, RCC_CSR_LSECSSON);
  670. }
  671. /**
  672. * @brief Disable Clock security system on LSE.
  673. * @note Clock security system can be disabled only after a LSE
  674. * failure detection. In that case it MUST be disabled by software.
  675. * @rmtoll CSR LSECSSON LL_RCC_LSE_DisableCSS
  676. * @retval None
  677. */
  678. __STATIC_INLINE void LL_RCC_LSE_DisableCSS(void)
  679. {
  680. CLEAR_BIT(RCC->CSR, RCC_CSR_LSECSSON);
  681. }
  682. #endif /* RCC_LSECSS_SUPPORT */
  683. /**
  684. * @brief Check if LSE oscillator Ready
  685. * @rmtoll CSR LSERDY LL_RCC_LSE_IsReady
  686. * @retval State of bit (1 or 0).
  687. */
  688. __STATIC_INLINE uint32_t LL_RCC_LSE_IsReady(void)
  689. {
  690. return (READ_BIT(RCC->CSR, RCC_CSR_LSERDY) == (RCC_CSR_LSERDY));
  691. }
  692. #if defined(RCC_LSECSS_SUPPORT)
  693. /**
  694. * @brief Check if CSS on LSE failure Detection
  695. * @rmtoll CSR LSECSSD LL_RCC_LSE_IsCSSDetected
  696. * @retval State of bit (1 or 0).
  697. */
  698. __STATIC_INLINE uint32_t LL_RCC_LSE_IsCSSDetected(void)
  699. {
  700. return (READ_BIT(RCC->CSR, RCC_CSR_LSECSSD) == (RCC_CSR_LSECSSD));
  701. }
  702. #endif /* RCC_LSECSS_SUPPORT */
  703. /**
  704. * @}
  705. */
  706. /** @defgroup RCC_LL_EF_LSI LSI
  707. * @{
  708. */
  709. /**
  710. * @brief Enable LSI Oscillator
  711. * @rmtoll CSR LSION LL_RCC_LSI_Enable
  712. * @retval None
  713. */
  714. __STATIC_INLINE void LL_RCC_LSI_Enable(void)
  715. {
  716. SET_BIT(RCC->CSR, RCC_CSR_LSION);
  717. }
  718. /**
  719. * @brief Disable LSI Oscillator
  720. * @rmtoll CSR LSION LL_RCC_LSI_Disable
  721. * @retval None
  722. */
  723. __STATIC_INLINE void LL_RCC_LSI_Disable(void)
  724. {
  725. CLEAR_BIT(RCC->CSR, RCC_CSR_LSION);
  726. }
  727. /**
  728. * @brief Check if LSI is Ready
  729. * @rmtoll CSR LSIRDY LL_RCC_LSI_IsReady
  730. * @retval State of bit (1 or 0).
  731. */
  732. __STATIC_INLINE uint32_t LL_RCC_LSI_IsReady(void)
  733. {
  734. return (READ_BIT(RCC->CSR, RCC_CSR_LSIRDY) == (RCC_CSR_LSIRDY));
  735. }
  736. /**
  737. * @}
  738. */
  739. /** @defgroup RCC_LL_EF_MSI MSI
  740. * @{
  741. */
  742. /**
  743. * @brief Enable MSI oscillator
  744. * @rmtoll CR MSION LL_RCC_MSI_Enable
  745. * @retval None
  746. */
  747. __STATIC_INLINE void LL_RCC_MSI_Enable(void)
  748. {
  749. SET_BIT(RCC->CR, RCC_CR_MSION);
  750. }
  751. /**
  752. * @brief Disable MSI oscillator
  753. * @rmtoll CR MSION LL_RCC_MSI_Disable
  754. * @retval None
  755. */
  756. __STATIC_INLINE void LL_RCC_MSI_Disable(void)
  757. {
  758. CLEAR_BIT(RCC->CR, RCC_CR_MSION);
  759. }
  760. /**
  761. * @brief Check if MSI oscillator Ready
  762. * @rmtoll CR MSIRDY LL_RCC_MSI_IsReady
  763. * @retval State of bit (1 or 0).
  764. */
  765. __STATIC_INLINE uint32_t LL_RCC_MSI_IsReady(void)
  766. {
  767. return (READ_BIT(RCC->CR, RCC_CR_MSIRDY) == (RCC_CR_MSIRDY));
  768. }
  769. /**
  770. * @brief Configure the Internal Multi Speed oscillator (MSI) clock range in run mode.
  771. * @rmtoll ICSCR MSIRANGE LL_RCC_MSI_SetRange
  772. * @param Range This parameter can be one of the following values:
  773. * @arg @ref LL_RCC_MSIRANGE_0
  774. * @arg @ref LL_RCC_MSIRANGE_1
  775. * @arg @ref LL_RCC_MSIRANGE_2
  776. * @arg @ref LL_RCC_MSIRANGE_3
  777. * @arg @ref LL_RCC_MSIRANGE_4
  778. * @arg @ref LL_RCC_MSIRANGE_5
  779. * @arg @ref LL_RCC_MSIRANGE_6
  780. * @retval None
  781. */
  782. __STATIC_INLINE void LL_RCC_MSI_SetRange(uint32_t Range)
  783. {
  784. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_MSIRANGE, Range);
  785. }
  786. /**
  787. * @brief Get the Internal Multi Speed oscillator (MSI) clock range in run mode.
  788. * @rmtoll ICSCR MSIRANGE LL_RCC_MSI_GetRange
  789. * @retval Returned value can be one of the following values:
  790. * @arg @ref LL_RCC_MSIRANGE_0
  791. * @arg @ref LL_RCC_MSIRANGE_1
  792. * @arg @ref LL_RCC_MSIRANGE_2
  793. * @arg @ref LL_RCC_MSIRANGE_3
  794. * @arg @ref LL_RCC_MSIRANGE_4
  795. * @arg @ref LL_RCC_MSIRANGE_5
  796. * @arg @ref LL_RCC_MSIRANGE_6
  797. */
  798. __STATIC_INLINE uint32_t LL_RCC_MSI_GetRange(void)
  799. {
  800. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSIRANGE));
  801. }
  802. /**
  803. * @brief Get MSI Calibration value
  804. * @note When MSITRIM is written, MSICAL is updated with the sum of
  805. * MSITRIM and the factory trim value
  806. * @rmtoll ICSCR MSICAL LL_RCC_MSI_GetCalibration
  807. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  808. */
  809. __STATIC_INLINE uint32_t LL_RCC_MSI_GetCalibration(void)
  810. {
  811. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSICAL) >> RCC_POSITION_MSICAL);
  812. }
  813. /**
  814. * @brief Set MSI Calibration trimming
  815. * @note user-programmable trimming value that is added to the MSICAL
  816. * @rmtoll ICSCR MSITRIM LL_RCC_MSI_SetCalibTrimming
  817. * @param Value between Min_Data = 0x00 and Max_Data = 0xFF
  818. * @retval None
  819. */
  820. __STATIC_INLINE void LL_RCC_MSI_SetCalibTrimming(uint32_t Value)
  821. {
  822. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_MSITRIM, Value << RCC_POSITION_MSITRIM);
  823. }
  824. /**
  825. * @brief Get MSI Calibration trimming
  826. * @rmtoll ICSCR MSITRIM LL_RCC_MSI_GetCalibTrimming
  827. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  828. */
  829. __STATIC_INLINE uint32_t LL_RCC_MSI_GetCalibTrimming(void)
  830. {
  831. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSITRIM) >> RCC_POSITION_MSITRIM);
  832. }
  833. /**
  834. * @}
  835. */
  836. /** @defgroup RCC_LL_EF_System System
  837. * @{
  838. */
  839. /**
  840. * @brief Configure the system clock source
  841. * @rmtoll CFGR SW LL_RCC_SetSysClkSource
  842. * @param Source This parameter can be one of the following values:
  843. * @arg @ref LL_RCC_SYS_CLKSOURCE_MSI
  844. * @arg @ref LL_RCC_SYS_CLKSOURCE_HSI
  845. * @arg @ref LL_RCC_SYS_CLKSOURCE_HSE
  846. * @arg @ref LL_RCC_SYS_CLKSOURCE_PLL
  847. * @retval None
  848. */
  849. __STATIC_INLINE void LL_RCC_SetSysClkSource(uint32_t Source)
  850. {
  851. MODIFY_REG(RCC->CFGR, RCC_CFGR_SW, Source);
  852. }
  853. /**
  854. * @brief Get the system clock source
  855. * @rmtoll CFGR SWS LL_RCC_GetSysClkSource
  856. * @retval Returned value can be one of the following values:
  857. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_MSI
  858. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_HSI
  859. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_HSE
  860. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_PLL
  861. */
  862. __STATIC_INLINE uint32_t LL_RCC_GetSysClkSource(void)
  863. {
  864. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_SWS));
  865. }
  866. /**
  867. * @brief Set AHB prescaler
  868. * @rmtoll CFGR HPRE LL_RCC_SetAHBPrescaler
  869. * @param Prescaler This parameter can be one of the following values:
  870. * @arg @ref LL_RCC_SYSCLK_DIV_1
  871. * @arg @ref LL_RCC_SYSCLK_DIV_2
  872. * @arg @ref LL_RCC_SYSCLK_DIV_4
  873. * @arg @ref LL_RCC_SYSCLK_DIV_8
  874. * @arg @ref LL_RCC_SYSCLK_DIV_16
  875. * @arg @ref LL_RCC_SYSCLK_DIV_64
  876. * @arg @ref LL_RCC_SYSCLK_DIV_128
  877. * @arg @ref LL_RCC_SYSCLK_DIV_256
  878. * @arg @ref LL_RCC_SYSCLK_DIV_512
  879. * @retval None
  880. */
  881. __STATIC_INLINE void LL_RCC_SetAHBPrescaler(uint32_t Prescaler)
  882. {
  883. MODIFY_REG(RCC->CFGR, RCC_CFGR_HPRE, Prescaler);
  884. }
  885. /**
  886. * @brief Set APB1 prescaler
  887. * @rmtoll CFGR PPRE1 LL_RCC_SetAPB1Prescaler
  888. * @param Prescaler This parameter can be one of the following values:
  889. * @arg @ref LL_RCC_APB1_DIV_1
  890. * @arg @ref LL_RCC_APB1_DIV_2
  891. * @arg @ref LL_RCC_APB1_DIV_4
  892. * @arg @ref LL_RCC_APB1_DIV_8
  893. * @arg @ref LL_RCC_APB1_DIV_16
  894. * @retval None
  895. */
  896. __STATIC_INLINE void LL_RCC_SetAPB1Prescaler(uint32_t Prescaler)
  897. {
  898. MODIFY_REG(RCC->CFGR, RCC_CFGR_PPRE1, Prescaler);
  899. }
  900. /**
  901. * @brief Set APB2 prescaler
  902. * @rmtoll CFGR PPRE2 LL_RCC_SetAPB2Prescaler
  903. * @param Prescaler This parameter can be one of the following values:
  904. * @arg @ref LL_RCC_APB2_DIV_1
  905. * @arg @ref LL_RCC_APB2_DIV_2
  906. * @arg @ref LL_RCC_APB2_DIV_4
  907. * @arg @ref LL_RCC_APB2_DIV_8
  908. * @arg @ref LL_RCC_APB2_DIV_16
  909. * @retval None
  910. */
  911. __STATIC_INLINE void LL_RCC_SetAPB2Prescaler(uint32_t Prescaler)
  912. {
  913. MODIFY_REG(RCC->CFGR, RCC_CFGR_PPRE2, Prescaler);
  914. }
  915. /**
  916. * @brief Get AHB prescaler
  917. * @rmtoll CFGR HPRE LL_RCC_GetAHBPrescaler
  918. * @retval Returned value can be one of the following values:
  919. * @arg @ref LL_RCC_SYSCLK_DIV_1
  920. * @arg @ref LL_RCC_SYSCLK_DIV_2
  921. * @arg @ref LL_RCC_SYSCLK_DIV_4
  922. * @arg @ref LL_RCC_SYSCLK_DIV_8
  923. * @arg @ref LL_RCC_SYSCLK_DIV_16
  924. * @arg @ref LL_RCC_SYSCLK_DIV_64
  925. * @arg @ref LL_RCC_SYSCLK_DIV_128
  926. * @arg @ref LL_RCC_SYSCLK_DIV_256
  927. * @arg @ref LL_RCC_SYSCLK_DIV_512
  928. */
  929. __STATIC_INLINE uint32_t LL_RCC_GetAHBPrescaler(void)
  930. {
  931. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_HPRE));
  932. }
  933. /**
  934. * @brief Get APB1 prescaler
  935. * @rmtoll CFGR PPRE1 LL_RCC_GetAPB1Prescaler
  936. * @retval Returned value can be one of the following values:
  937. * @arg @ref LL_RCC_APB1_DIV_1
  938. * @arg @ref LL_RCC_APB1_DIV_2
  939. * @arg @ref LL_RCC_APB1_DIV_4
  940. * @arg @ref LL_RCC_APB1_DIV_8
  941. * @arg @ref LL_RCC_APB1_DIV_16
  942. */
  943. __STATIC_INLINE uint32_t LL_RCC_GetAPB1Prescaler(void)
  944. {
  945. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PPRE1));
  946. }
  947. /**
  948. * @brief Get APB2 prescaler
  949. * @rmtoll CFGR PPRE2 LL_RCC_GetAPB2Prescaler
  950. * @retval Returned value can be one of the following values:
  951. * @arg @ref LL_RCC_APB2_DIV_1
  952. * @arg @ref LL_RCC_APB2_DIV_2
  953. * @arg @ref LL_RCC_APB2_DIV_4
  954. * @arg @ref LL_RCC_APB2_DIV_8
  955. * @arg @ref LL_RCC_APB2_DIV_16
  956. */
  957. __STATIC_INLINE uint32_t LL_RCC_GetAPB2Prescaler(void)
  958. {
  959. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PPRE2));
  960. }
  961. /**
  962. * @}
  963. */
  964. /** @defgroup RCC_LL_EF_MCO MCO
  965. * @{
  966. */
  967. /**
  968. * @brief Configure MCOx
  969. * @rmtoll CFGR MCOSEL LL_RCC_ConfigMCO\n
  970. * CFGR MCOPRE LL_RCC_ConfigMCO
  971. * @param MCOxSource This parameter can be one of the following values:
  972. * @arg @ref LL_RCC_MCO1SOURCE_NOCLOCK
  973. * @arg @ref LL_RCC_MCO1SOURCE_SYSCLK
  974. * @arg @ref LL_RCC_MCO1SOURCE_HSI
  975. * @arg @ref LL_RCC_MCO1SOURCE_MSI
  976. * @arg @ref LL_RCC_MCO1SOURCE_HSE
  977. * @arg @ref LL_RCC_MCO1SOURCE_PLLCLK
  978. * @arg @ref LL_RCC_MCO1SOURCE_LSI
  979. * @arg @ref LL_RCC_MCO1SOURCE_LSE
  980. * @param MCOxPrescaler This parameter can be one of the following values:
  981. * @arg @ref LL_RCC_MCO1_DIV_1
  982. * @arg @ref LL_RCC_MCO1_DIV_2
  983. * @arg @ref LL_RCC_MCO1_DIV_4
  984. * @arg @ref LL_RCC_MCO1_DIV_8
  985. * @arg @ref LL_RCC_MCO1_DIV_16
  986. * @retval None
  987. */
  988. __STATIC_INLINE void LL_RCC_ConfigMCO(uint32_t MCOxSource, uint32_t MCOxPrescaler)
  989. {
  990. MODIFY_REG(RCC->CFGR, RCC_CFGR_MCOSEL | RCC_CFGR_MCOPRE, MCOxSource | MCOxPrescaler);
  991. }
  992. /**
  993. * @}
  994. */
  995. /** @defgroup RCC_LL_EF_RTC RTC
  996. * @{
  997. */
  998. /**
  999. * @brief Set RTC Clock Source
  1000. * @note Once the RTC clock source has been selected, it cannot be changed any more unless
  1001. * the Backup domain is reset, or unless a failure is detected on LSE (LSECSSD is
  1002. * set). The RTCRST bit can be used to reset them.
  1003. * @rmtoll CSR RTCSEL LL_RCC_SetRTCClockSource
  1004. * @param Source This parameter can be one of the following values:
  1005. * @arg @ref LL_RCC_RTC_CLKSOURCE_NONE
  1006. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSE
  1007. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSI
  1008. * @arg @ref LL_RCC_RTC_CLKSOURCE_HSE
  1009. * @retval None
  1010. */
  1011. __STATIC_INLINE void LL_RCC_SetRTCClockSource(uint32_t Source)
  1012. {
  1013. MODIFY_REG(RCC->CSR, RCC_CSR_RTCSEL, Source);
  1014. }
  1015. /**
  1016. * @brief Get RTC Clock Source
  1017. * @rmtoll CSR RTCSEL LL_RCC_GetRTCClockSource
  1018. * @retval Returned value can be one of the following values:
  1019. * @arg @ref LL_RCC_RTC_CLKSOURCE_NONE
  1020. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSE
  1021. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSI
  1022. * @arg @ref LL_RCC_RTC_CLKSOURCE_HSE
  1023. */
  1024. __STATIC_INLINE uint32_t LL_RCC_GetRTCClockSource(void)
  1025. {
  1026. return (uint32_t)(READ_BIT(RCC->CSR, RCC_CSR_RTCSEL));
  1027. }
  1028. /**
  1029. * @brief Enable RTC
  1030. * @rmtoll CSR RTCEN LL_RCC_EnableRTC
  1031. * @retval None
  1032. */
  1033. __STATIC_INLINE void LL_RCC_EnableRTC(void)
  1034. {
  1035. SET_BIT(RCC->CSR, RCC_CSR_RTCEN);
  1036. }
  1037. /**
  1038. * @brief Disable RTC
  1039. * @rmtoll CSR RTCEN LL_RCC_DisableRTC
  1040. * @retval None
  1041. */
  1042. __STATIC_INLINE void LL_RCC_DisableRTC(void)
  1043. {
  1044. CLEAR_BIT(RCC->CSR, RCC_CSR_RTCEN);
  1045. }
  1046. /**
  1047. * @brief Check if RTC has been enabled or not
  1048. * @rmtoll CSR RTCEN LL_RCC_IsEnabledRTC
  1049. * @retval State of bit (1 or 0).
  1050. */
  1051. __STATIC_INLINE uint32_t LL_RCC_IsEnabledRTC(void)
  1052. {
  1053. return (READ_BIT(RCC->CSR, RCC_CSR_RTCEN) == (RCC_CSR_RTCEN));
  1054. }
  1055. /**
  1056. * @brief Force the Backup domain reset
  1057. * @rmtoll CSR RTCRST LL_RCC_ForceBackupDomainReset
  1058. * @retval None
  1059. */
  1060. __STATIC_INLINE void LL_RCC_ForceBackupDomainReset(void)
  1061. {
  1062. SET_BIT(RCC->CSR, RCC_CSR_RTCRST);
  1063. }
  1064. /**
  1065. * @brief Release the Backup domain reset
  1066. * @rmtoll CSR RTCRST LL_RCC_ReleaseBackupDomainReset
  1067. * @retval None
  1068. */
  1069. __STATIC_INLINE void LL_RCC_ReleaseBackupDomainReset(void)
  1070. {
  1071. CLEAR_BIT(RCC->CSR, RCC_CSR_RTCRST);
  1072. }
  1073. /**
  1074. * @}
  1075. */
  1076. /** @defgroup RCC_LL_EF_PLL PLL
  1077. * @{
  1078. */
  1079. /**
  1080. * @brief Enable PLL
  1081. * @rmtoll CR PLLON LL_RCC_PLL_Enable
  1082. * @retval None
  1083. */
  1084. __STATIC_INLINE void LL_RCC_PLL_Enable(void)
  1085. {
  1086. SET_BIT(RCC->CR, RCC_CR_PLLON);
  1087. }
  1088. /**
  1089. * @brief Disable PLL
  1090. * @note Cannot be disabled if the PLL clock is used as the system clock
  1091. * @rmtoll CR PLLON LL_RCC_PLL_Disable
  1092. * @retval None
  1093. */
  1094. __STATIC_INLINE void LL_RCC_PLL_Disable(void)
  1095. {
  1096. CLEAR_BIT(RCC->CR, RCC_CR_PLLON);
  1097. }
  1098. /**
  1099. * @brief Check if PLL Ready
  1100. * @rmtoll CR PLLRDY LL_RCC_PLL_IsReady
  1101. * @retval State of bit (1 or 0).
  1102. */
  1103. __STATIC_INLINE uint32_t LL_RCC_PLL_IsReady(void)
  1104. {
  1105. return (READ_BIT(RCC->CR, RCC_CR_PLLRDY) == (RCC_CR_PLLRDY));
  1106. }
  1107. /**
  1108. * @brief Configure PLL used for SYSCLK Domain
  1109. * @rmtoll CFGR PLLSRC LL_RCC_PLL_ConfigDomain_SYS\n
  1110. * CFGR PLLMUL LL_RCC_PLL_ConfigDomain_SYS\n
  1111. * CFGR PLLDIV LL_RCC_PLL_ConfigDomain_SYS
  1112. * @param Source This parameter can be one of the following values:
  1113. * @arg @ref LL_RCC_PLLSOURCE_HSI
  1114. * @arg @ref LL_RCC_PLLSOURCE_HSE
  1115. * @param PLLMul This parameter can be one of the following values:
  1116. * @arg @ref LL_RCC_PLL_MUL_3
  1117. * @arg @ref LL_RCC_PLL_MUL_4
  1118. * @arg @ref LL_RCC_PLL_MUL_6
  1119. * @arg @ref LL_RCC_PLL_MUL_8
  1120. * @arg @ref LL_RCC_PLL_MUL_12
  1121. * @arg @ref LL_RCC_PLL_MUL_16
  1122. * @arg @ref LL_RCC_PLL_MUL_24
  1123. * @arg @ref LL_RCC_PLL_MUL_32
  1124. * @arg @ref LL_RCC_PLL_MUL_48
  1125. * @param PLLDiv This parameter can be one of the following values:
  1126. * @arg @ref LL_RCC_PLL_DIV_2
  1127. * @arg @ref LL_RCC_PLL_DIV_3
  1128. * @arg @ref LL_RCC_PLL_DIV_4
  1129. * @retval None
  1130. */
  1131. __STATIC_INLINE void LL_RCC_PLL_ConfigDomain_SYS(uint32_t Source, uint32_t PLLMul, uint32_t PLLDiv)
  1132. {
  1133. MODIFY_REG(RCC->CFGR, RCC_CFGR_PLLSRC | RCC_CFGR_PLLMUL | RCC_CFGR_PLLDIV, Source | PLLMul | PLLDiv);
  1134. }
  1135. /**
  1136. * @brief Get the oscillator used as PLL clock source.
  1137. * @rmtoll CFGR PLLSRC LL_RCC_PLL_GetMainSource
  1138. * @retval Returned value can be one of the following values:
  1139. * @arg @ref LL_RCC_PLLSOURCE_HSI
  1140. * @arg @ref LL_RCC_PLLSOURCE_HSE
  1141. */
  1142. __STATIC_INLINE uint32_t LL_RCC_PLL_GetMainSource(void)
  1143. {
  1144. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLSRC));
  1145. }
  1146. /**
  1147. * @brief Get PLL multiplication Factor
  1148. * @rmtoll CFGR PLLMUL LL_RCC_PLL_GetMultiplicator
  1149. * @retval Returned value can be one of the following values:
  1150. * @arg @ref LL_RCC_PLL_MUL_3
  1151. * @arg @ref LL_RCC_PLL_MUL_4
  1152. * @arg @ref LL_RCC_PLL_MUL_6
  1153. * @arg @ref LL_RCC_PLL_MUL_8
  1154. * @arg @ref LL_RCC_PLL_MUL_12
  1155. * @arg @ref LL_RCC_PLL_MUL_16
  1156. * @arg @ref LL_RCC_PLL_MUL_24
  1157. * @arg @ref LL_RCC_PLL_MUL_32
  1158. * @arg @ref LL_RCC_PLL_MUL_48
  1159. */
  1160. __STATIC_INLINE uint32_t LL_RCC_PLL_GetMultiplicator(void)
  1161. {
  1162. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLMUL));
  1163. }
  1164. /**
  1165. * @brief Get Division factor for the main PLL and other PLL
  1166. * @rmtoll CFGR PLLDIV LL_RCC_PLL_GetDivider
  1167. * @retval Returned value can be one of the following values:
  1168. * @arg @ref LL_RCC_PLL_DIV_2
  1169. * @arg @ref LL_RCC_PLL_DIV_3
  1170. * @arg @ref LL_RCC_PLL_DIV_4
  1171. */
  1172. __STATIC_INLINE uint32_t LL_RCC_PLL_GetDivider(void)
  1173. {
  1174. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLDIV));
  1175. }
  1176. /**
  1177. * @}
  1178. */
  1179. /** @defgroup RCC_LL_EF_FLAG_Management FLAG Management
  1180. * @{
  1181. */
  1182. /**
  1183. * @brief Clear LSI ready interrupt flag
  1184. * @rmtoll CIR LSIRDYC LL_RCC_ClearFlag_LSIRDY
  1185. * @retval None
  1186. */
  1187. __STATIC_INLINE void LL_RCC_ClearFlag_LSIRDY(void)
  1188. {
  1189. SET_BIT(RCC->CIR, RCC_CIR_LSIRDYC);
  1190. }
  1191. /**
  1192. * @brief Clear LSE ready interrupt flag
  1193. * @rmtoll CIR LSERDYC LL_RCC_ClearFlag_LSERDY
  1194. * @retval None
  1195. */
  1196. __STATIC_INLINE void LL_RCC_ClearFlag_LSERDY(void)
  1197. {
  1198. SET_BIT(RCC->CIR, RCC_CIR_LSERDYC);
  1199. }
  1200. /**
  1201. * @brief Clear MSI ready interrupt flag
  1202. * @rmtoll CIR MSIRDYC LL_RCC_ClearFlag_MSIRDY
  1203. * @retval None
  1204. */
  1205. __STATIC_INLINE void LL_RCC_ClearFlag_MSIRDY(void)
  1206. {
  1207. SET_BIT(RCC->CIR, RCC_CIR_MSIRDYC);
  1208. }
  1209. /**
  1210. * @brief Clear HSI ready interrupt flag
  1211. * @rmtoll CIR HSIRDYC LL_RCC_ClearFlag_HSIRDY
  1212. * @retval None
  1213. */
  1214. __STATIC_INLINE void LL_RCC_ClearFlag_HSIRDY(void)
  1215. {
  1216. SET_BIT(RCC->CIR, RCC_CIR_HSIRDYC);
  1217. }
  1218. /**
  1219. * @brief Clear HSE ready interrupt flag
  1220. * @rmtoll CIR HSERDYC LL_RCC_ClearFlag_HSERDY
  1221. * @retval None
  1222. */
  1223. __STATIC_INLINE void LL_RCC_ClearFlag_HSERDY(void)
  1224. {
  1225. SET_BIT(RCC->CIR, RCC_CIR_HSERDYC);
  1226. }
  1227. /**
  1228. * @brief Clear PLL ready interrupt flag
  1229. * @rmtoll CIR PLLRDYC LL_RCC_ClearFlag_PLLRDY
  1230. * @retval None
  1231. */
  1232. __STATIC_INLINE void LL_RCC_ClearFlag_PLLRDY(void)
  1233. {
  1234. SET_BIT(RCC->CIR, RCC_CIR_PLLRDYC);
  1235. }
  1236. /**
  1237. * @brief Clear Clock security system interrupt flag
  1238. * @rmtoll CIR CSSC LL_RCC_ClearFlag_HSECSS
  1239. * @retval None
  1240. */
  1241. __STATIC_INLINE void LL_RCC_ClearFlag_HSECSS(void)
  1242. {
  1243. SET_BIT(RCC->CIR, RCC_CIR_CSSC);
  1244. }
  1245. #if defined(RCC_LSECSS_SUPPORT)
  1246. /**
  1247. * @brief Clear LSE Clock security system interrupt flag
  1248. * @rmtoll CIR LSECSSC LL_RCC_ClearFlag_LSECSS
  1249. * @retval None
  1250. */
  1251. __STATIC_INLINE void LL_RCC_ClearFlag_LSECSS(void)
  1252. {
  1253. SET_BIT(RCC->CIR, RCC_CIR_LSECSSC);
  1254. }
  1255. #endif /* RCC_LSECSS_SUPPORT */
  1256. /**
  1257. * @brief Check if LSI ready interrupt occurred or not
  1258. * @rmtoll CIR LSIRDYF LL_RCC_IsActiveFlag_LSIRDY
  1259. * @retval State of bit (1 or 0).
  1260. */
  1261. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSIRDY(void)
  1262. {
  1263. return (READ_BIT(RCC->CIR, RCC_CIR_LSIRDYF) == (RCC_CIR_LSIRDYF));
  1264. }
  1265. /**
  1266. * @brief Check if LSE ready interrupt occurred or not
  1267. * @rmtoll CIR LSERDYF LL_RCC_IsActiveFlag_LSERDY
  1268. * @retval State of bit (1 or 0).
  1269. */
  1270. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSERDY(void)
  1271. {
  1272. return (READ_BIT(RCC->CIR, RCC_CIR_LSERDYF) == (RCC_CIR_LSERDYF));
  1273. }
  1274. /**
  1275. * @brief Check if MSI ready interrupt occurred or not
  1276. * @rmtoll CIR MSIRDYF LL_RCC_IsActiveFlag_MSIRDY
  1277. * @retval State of bit (1 or 0).
  1278. */
  1279. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_MSIRDY(void)
  1280. {
  1281. return (READ_BIT(RCC->CIR, RCC_CIR_MSIRDYF) == (RCC_CIR_MSIRDYF));
  1282. }
  1283. /**
  1284. * @brief Check if HSI ready interrupt occurred or not
  1285. * @rmtoll CIR HSIRDYF LL_RCC_IsActiveFlag_HSIRDY
  1286. * @retval State of bit (1 or 0).
  1287. */
  1288. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSIRDY(void)
  1289. {
  1290. return (READ_BIT(RCC->CIR, RCC_CIR_HSIRDYF) == (RCC_CIR_HSIRDYF));
  1291. }
  1292. /**
  1293. * @brief Check if HSE ready interrupt occurred or not
  1294. * @rmtoll CIR HSERDYF LL_RCC_IsActiveFlag_HSERDY
  1295. * @retval State of bit (1 or 0).
  1296. */
  1297. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSERDY(void)
  1298. {
  1299. return (READ_BIT(RCC->CIR, RCC_CIR_HSERDYF) == (RCC_CIR_HSERDYF));
  1300. }
  1301. /**
  1302. * @brief Check if PLL ready interrupt occurred or not
  1303. * @rmtoll CIR PLLRDYF LL_RCC_IsActiveFlag_PLLRDY
  1304. * @retval State of bit (1 or 0).
  1305. */
  1306. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PLLRDY(void)
  1307. {
  1308. return (READ_BIT(RCC->CIR, RCC_CIR_PLLRDYF) == (RCC_CIR_PLLRDYF));
  1309. }
  1310. /**
  1311. * @brief Check if Clock security system interrupt occurred or not
  1312. * @rmtoll CIR CSSF LL_RCC_IsActiveFlag_HSECSS
  1313. * @retval State of bit (1 or 0).
  1314. */
  1315. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSECSS(void)
  1316. {
  1317. return (READ_BIT(RCC->CIR, RCC_CIR_CSSF) == (RCC_CIR_CSSF));
  1318. }
  1319. #if defined(RCC_LSECSS_SUPPORT)
  1320. /**
  1321. * @brief Check if LSE Clock security system interrupt occurred or not
  1322. * @rmtoll CIR LSECSSF LL_RCC_IsActiveFlag_LSECSS
  1323. * @retval State of bit (1 or 0).
  1324. */
  1325. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSECSS(void)
  1326. {
  1327. return (READ_BIT(RCC->CIR, RCC_CIR_LSECSSF) == (RCC_CIR_LSECSSF));
  1328. }
  1329. #endif /* RCC_LSECSS_SUPPORT */
  1330. /**
  1331. * @brief Check if RCC flag Independent Watchdog reset is set or not.
  1332. * @rmtoll CSR IWDGRSTF LL_RCC_IsActiveFlag_IWDGRST
  1333. * @retval State of bit (1 or 0).
  1334. */
  1335. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_IWDGRST(void)
  1336. {
  1337. return (READ_BIT(RCC->CSR, RCC_CSR_IWDGRSTF) == (RCC_CSR_IWDGRSTF));
  1338. }
  1339. /**
  1340. * @brief Check if RCC flag Low Power reset is set or not.
  1341. * @rmtoll CSR LPWRRSTF LL_RCC_IsActiveFlag_LPWRRST
  1342. * @retval State of bit (1 or 0).
  1343. */
  1344. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LPWRRST(void)
  1345. {
  1346. return (READ_BIT(RCC->CSR, RCC_CSR_LPWRRSTF) == (RCC_CSR_LPWRRSTF));
  1347. }
  1348. /**
  1349. * @brief Check if RCC flag is set or not.
  1350. * @rmtoll CSR OBLRSTF LL_RCC_IsActiveFlag_OBLRST
  1351. * @retval State of bit (1 or 0).
  1352. */
  1353. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_OBLRST(void)
  1354. {
  1355. return (READ_BIT(RCC->CSR, RCC_CSR_OBLRSTF) == (RCC_CSR_OBLRSTF));
  1356. }
  1357. /**
  1358. * @brief Check if RCC flag Pin reset is set or not.
  1359. * @rmtoll CSR PINRSTF LL_RCC_IsActiveFlag_PINRST
  1360. * @retval State of bit (1 or 0).
  1361. */
  1362. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PINRST(void)
  1363. {
  1364. return (READ_BIT(RCC->CSR, RCC_CSR_PINRSTF) == (RCC_CSR_PINRSTF));
  1365. }
  1366. /**
  1367. * @brief Check if RCC flag POR/PDR reset is set or not.
  1368. * @rmtoll CSR PORRSTF LL_RCC_IsActiveFlag_PORRST
  1369. * @retval State of bit (1 or 0).
  1370. */
  1371. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PORRST(void)
  1372. {
  1373. return (READ_BIT(RCC->CSR, RCC_CSR_PORRSTF) == (RCC_CSR_PORRSTF));
  1374. }
  1375. /**
  1376. * @brief Check if RCC flag Software reset is set or not.
  1377. * @rmtoll CSR SFTRSTF LL_RCC_IsActiveFlag_SFTRST
  1378. * @retval State of bit (1 or 0).
  1379. */
  1380. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_SFTRST(void)
  1381. {
  1382. return (READ_BIT(RCC->CSR, RCC_CSR_SFTRSTF) == (RCC_CSR_SFTRSTF));
  1383. }
  1384. /**
  1385. * @brief Check if RCC flag Window Watchdog reset is set or not.
  1386. * @rmtoll CSR WWDGRSTF LL_RCC_IsActiveFlag_WWDGRST
  1387. * @retval State of bit (1 or 0).
  1388. */
  1389. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_WWDGRST(void)
  1390. {
  1391. return (READ_BIT(RCC->CSR, RCC_CSR_WWDGRSTF) == (RCC_CSR_WWDGRSTF));
  1392. }
  1393. /**
  1394. * @brief Set RMVF bit to clear the reset flags.
  1395. * @rmtoll CSR RMVF LL_RCC_ClearResetFlags
  1396. * @retval None
  1397. */
  1398. __STATIC_INLINE void LL_RCC_ClearResetFlags(void)
  1399. {
  1400. SET_BIT(RCC->CSR, RCC_CSR_RMVF);
  1401. }
  1402. /**
  1403. * @}
  1404. */
  1405. /** @defgroup RCC_LL_EF_IT_Management IT Management
  1406. * @{
  1407. */
  1408. /**
  1409. * @brief Enable LSI ready interrupt
  1410. * @rmtoll CIR LSIRDYIE LL_RCC_EnableIT_LSIRDY
  1411. * @retval None
  1412. */
  1413. __STATIC_INLINE void LL_RCC_EnableIT_LSIRDY(void)
  1414. {
  1415. SET_BIT(RCC->CIR, RCC_CIR_LSIRDYIE);
  1416. }
  1417. /**
  1418. * @brief Enable LSE ready interrupt
  1419. * @rmtoll CIR LSERDYIE LL_RCC_EnableIT_LSERDY
  1420. * @retval None
  1421. */
  1422. __STATIC_INLINE void LL_RCC_EnableIT_LSERDY(void)
  1423. {
  1424. SET_BIT(RCC->CIR, RCC_CIR_LSERDYIE);
  1425. }
  1426. /**
  1427. * @brief Enable MSI ready interrupt
  1428. * @rmtoll CIR MSIRDYIE LL_RCC_EnableIT_MSIRDY
  1429. * @retval None
  1430. */
  1431. __STATIC_INLINE void LL_RCC_EnableIT_MSIRDY(void)
  1432. {
  1433. SET_BIT(RCC->CIR, RCC_CIR_MSIRDYIE);
  1434. }
  1435. /**
  1436. * @brief Enable HSI ready interrupt
  1437. * @rmtoll CIR HSIRDYIE LL_RCC_EnableIT_HSIRDY
  1438. * @retval None
  1439. */
  1440. __STATIC_INLINE void LL_RCC_EnableIT_HSIRDY(void)
  1441. {
  1442. SET_BIT(RCC->CIR, RCC_CIR_HSIRDYIE);
  1443. }
  1444. /**
  1445. * @brief Enable HSE ready interrupt
  1446. * @rmtoll CIR HSERDYIE LL_RCC_EnableIT_HSERDY
  1447. * @retval None
  1448. */
  1449. __STATIC_INLINE void LL_RCC_EnableIT_HSERDY(void)
  1450. {
  1451. SET_BIT(RCC->CIR, RCC_CIR_HSERDYIE);
  1452. }
  1453. /**
  1454. * @brief Enable PLL ready interrupt
  1455. * @rmtoll CIR PLLRDYIE LL_RCC_EnableIT_PLLRDY
  1456. * @retval None
  1457. */
  1458. __STATIC_INLINE void LL_RCC_EnableIT_PLLRDY(void)
  1459. {
  1460. SET_BIT(RCC->CIR, RCC_CIR_PLLRDYIE);
  1461. }
  1462. #if defined(RCC_LSECSS_SUPPORT)
  1463. /**
  1464. * @brief Enable LSE clock security system interrupt
  1465. * @rmtoll CIR LSECSSIE LL_RCC_EnableIT_LSECSS
  1466. * @retval None
  1467. */
  1468. __STATIC_INLINE void LL_RCC_EnableIT_LSECSS(void)
  1469. {
  1470. SET_BIT(RCC->CIR, RCC_CIR_LSECSSIE);
  1471. }
  1472. #endif /* RCC_LSECSS_SUPPORT */
  1473. /**
  1474. * @brief Disable LSI ready interrupt
  1475. * @rmtoll CIR LSIRDYIE LL_RCC_DisableIT_LSIRDY
  1476. * @retval None
  1477. */
  1478. __STATIC_INLINE void LL_RCC_DisableIT_LSIRDY(void)
  1479. {
  1480. CLEAR_BIT(RCC->CIR, RCC_CIR_LSIRDYIE);
  1481. }
  1482. /**
  1483. * @brief Disable LSE ready interrupt
  1484. * @rmtoll CIR LSERDYIE LL_RCC_DisableIT_LSERDY
  1485. * @retval None
  1486. */
  1487. __STATIC_INLINE void LL_RCC_DisableIT_LSERDY(void)
  1488. {
  1489. CLEAR_BIT(RCC->CIR, RCC_CIR_LSERDYIE);
  1490. }
  1491. /**
  1492. * @brief Disable MSI ready interrupt
  1493. * @rmtoll CIR MSIRDYIE LL_RCC_DisableIT_MSIRDY
  1494. * @retval None
  1495. */
  1496. __STATIC_INLINE void LL_RCC_DisableIT_MSIRDY(void)
  1497. {
  1498. CLEAR_BIT(RCC->CIR, RCC_CIR_MSIRDYIE);
  1499. }
  1500. /**
  1501. * @brief Disable HSI ready interrupt
  1502. * @rmtoll CIR HSIRDYIE LL_RCC_DisableIT_HSIRDY
  1503. * @retval None
  1504. */
  1505. __STATIC_INLINE void LL_RCC_DisableIT_HSIRDY(void)
  1506. {
  1507. CLEAR_BIT(RCC->CIR, RCC_CIR_HSIRDYIE);
  1508. }
  1509. /**
  1510. * @brief Disable HSE ready interrupt
  1511. * @rmtoll CIR HSERDYIE LL_RCC_DisableIT_HSERDY
  1512. * @retval None
  1513. */
  1514. __STATIC_INLINE void LL_RCC_DisableIT_HSERDY(void)
  1515. {
  1516. CLEAR_BIT(RCC->CIR, RCC_CIR_HSERDYIE);
  1517. }
  1518. /**
  1519. * @brief Disable PLL ready interrupt
  1520. * @rmtoll CIR PLLRDYIE LL_RCC_DisableIT_PLLRDY
  1521. * @retval None
  1522. */
  1523. __STATIC_INLINE void LL_RCC_DisableIT_PLLRDY(void)
  1524. {
  1525. CLEAR_BIT(RCC->CIR, RCC_CIR_PLLRDYIE);
  1526. }
  1527. #if defined(RCC_LSECSS_SUPPORT)
  1528. /**
  1529. * @brief Disable LSE clock security system interrupt
  1530. * @rmtoll CIR LSECSSIE LL_RCC_DisableIT_LSECSS
  1531. * @retval None
  1532. */
  1533. __STATIC_INLINE void LL_RCC_DisableIT_LSECSS(void)
  1534. {
  1535. CLEAR_BIT(RCC->CIR, RCC_CIR_LSECSSIE);
  1536. }
  1537. #endif /* RCC_LSECSS_SUPPORT */
  1538. /**
  1539. * @brief Checks if LSI ready interrupt source is enabled or disabled.
  1540. * @rmtoll CIR LSIRDYIE LL_RCC_IsEnabledIT_LSIRDY
  1541. * @retval State of bit (1 or 0).
  1542. */
  1543. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSIRDY(void)
  1544. {
  1545. return (READ_BIT(RCC->CIR, RCC_CIR_LSIRDYIE) == (RCC_CIR_LSIRDYIE));
  1546. }
  1547. /**
  1548. * @brief Checks if LSE ready interrupt source is enabled or disabled.
  1549. * @rmtoll CIR LSERDYIE LL_RCC_IsEnabledIT_LSERDY
  1550. * @retval State of bit (1 or 0).
  1551. */
  1552. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSERDY(void)
  1553. {
  1554. return (READ_BIT(RCC->CIR, RCC_CIR_LSERDYIE) == (RCC_CIR_LSERDYIE));
  1555. }
  1556. /**
  1557. * @brief Checks if MSI ready interrupt source is enabled or disabled.
  1558. * @rmtoll CIR MSIRDYIE LL_RCC_IsEnabledIT_MSIRDY
  1559. * @retval State of bit (1 or 0).
  1560. */
  1561. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_MSIRDY(void)
  1562. {
  1563. return (READ_BIT(RCC->CIR, RCC_CIR_MSIRDYIE) == (RCC_CIR_MSIRDYIE));
  1564. }
  1565. /**
  1566. * @brief Checks if HSI ready interrupt source is enabled or disabled.
  1567. * @rmtoll CIR HSIRDYIE LL_RCC_IsEnabledIT_HSIRDY
  1568. * @retval State of bit (1 or 0).
  1569. */
  1570. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_HSIRDY(void)
  1571. {
  1572. return (READ_BIT(RCC->CIR, RCC_CIR_HSIRDYIE) == (RCC_CIR_HSIRDYIE));
  1573. }
  1574. /**
  1575. * @brief Checks if HSE ready interrupt source is enabled or disabled.
  1576. * @rmtoll CIR HSERDYIE LL_RCC_IsEnabledIT_HSERDY
  1577. * @retval State of bit (1 or 0).
  1578. */
  1579. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_HSERDY(void)
  1580. {
  1581. return (READ_BIT(RCC->CIR, RCC_CIR_HSERDYIE) == (RCC_CIR_HSERDYIE));
  1582. }
  1583. /**
  1584. * @brief Checks if PLL ready interrupt source is enabled or disabled.
  1585. * @rmtoll CIR PLLRDYIE LL_RCC_IsEnabledIT_PLLRDY
  1586. * @retval State of bit (1 or 0).
  1587. */
  1588. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_PLLRDY(void)
  1589. {
  1590. return (READ_BIT(RCC->CIR, RCC_CIR_PLLRDYIE) == (RCC_CIR_PLLRDYIE));
  1591. }
  1592. #if defined(RCC_LSECSS_SUPPORT)
  1593. /**
  1594. * @brief Checks if LSECSS interrupt source is enabled or disabled.
  1595. * @rmtoll CIR LSECSSIE LL_RCC_IsEnabledIT_LSECSS
  1596. * @retval State of bit (1 or 0).
  1597. */
  1598. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSECSS(void)
  1599. {
  1600. return (READ_BIT(RCC->CIR, RCC_CIR_LSECSSIE) == (RCC_CIR_LSECSSIE));
  1601. }
  1602. #endif /* RCC_LSECSS_SUPPORT */
  1603. /**
  1604. * @}
  1605. */
  1606. #if defined(USE_FULL_LL_DRIVER)
  1607. /** @defgroup RCC_LL_EF_Init De-initialization function
  1608. * @{
  1609. */
  1610. ErrorStatus LL_RCC_DeInit(void);
  1611. /**
  1612. * @}
  1613. */
  1614. /** @defgroup RCC_LL_EF_Get_Freq Get system and peripherals clocks frequency functions
  1615. * @{
  1616. */
  1617. void LL_RCC_GetSystemClocksFreq(LL_RCC_ClocksTypeDef *RCC_Clocks);
  1618. /**
  1619. * @}
  1620. */
  1621. #endif /* USE_FULL_LL_DRIVER */
  1622. /**
  1623. * @}
  1624. */
  1625. /**
  1626. * @}
  1627. */
  1628. #endif /* RCC */
  1629. /**
  1630. * @}
  1631. */
  1632. #ifdef __cplusplus
  1633. }
  1634. #endif
  1635. #endif /* __STM32L1xx_LL_RCC_H */
  1636. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/