You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

stm32l1xx_ll_rcc.h 55KB

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