stm32l0xx_ll_rcc.h 81 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494
  1. /**
  2. ******************************************************************************
  3. * @file stm32l0xx_ll_rcc.h
  4. * @author MCD Application Team
  5. * @brief Header file of RCC LL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.
  11. *
  12. * This software is licensed under terms that can be found in the LICENSE file in
  13. * the root directory of this software component.
  14. * If no LICENSE file comes with this software, it is provided AS-IS.
  15. ******************************************************************************
  16. */
  17. /* Define to prevent recursive inclusion -------------------------------------*/
  18. #ifndef __STM32L0xx_LL_RCC_H
  19. #define __STM32L0xx_LL_RCC_H
  20. #ifdef __cplusplus
  21. extern "C" {
  22. #endif
  23. /* Includes ------------------------------------------------------------------*/
  24. #include "stm32l0xx.h"
  25. /** @addtogroup STM32L0xx_LL_Driver
  26. * @{
  27. */
  28. #if defined(RCC)
  29. /** @defgroup RCC_LL RCC
  30. * @{
  31. */
  32. /* Private types -------------------------------------------------------------*/
  33. /* Private variables ---------------------------------------------------------*/
  34. /** @defgroup RCC_LL_Private_Variables RCC Private Variables
  35. * @{
  36. */
  37. /**
  38. * @}
  39. */
  40. /* Private constants ---------------------------------------------------------*/
  41. /** @defgroup RCC_LL_Private_Constants RCC Private Constants
  42. * @{
  43. */
  44. /**
  45. * @}
  46. */
  47. /* Private macros ------------------------------------------------------------*/
  48. #if defined(USE_FULL_LL_DRIVER)
  49. /** @defgroup RCC_LL_Private_Macros RCC Private Macros
  50. * @{
  51. */
  52. /**
  53. * @}
  54. */
  55. #endif /*USE_FULL_LL_DRIVER*/
  56. /* Exported types ------------------------------------------------------------*/
  57. #if defined(USE_FULL_LL_DRIVER)
  58. /** @defgroup RCC_LL_Exported_Types RCC Exported Types
  59. * @{
  60. */
  61. /** @defgroup LL_ES_CLOCK_FREQ Clocks Frequency Structure
  62. * @{
  63. */
  64. /**
  65. * @brief RCC Clocks Frequency Structure
  66. */
  67. typedef struct
  68. {
  69. uint32_t SYSCLK_Frequency; /*!< SYSCLK clock frequency */
  70. uint32_t HCLK_Frequency; /*!< HCLK clock frequency */
  71. uint32_t PCLK1_Frequency; /*!< PCLK1 clock frequency */
  72. uint32_t PCLK2_Frequency; /*!< PCLK2 clock frequency */
  73. } LL_RCC_ClocksTypeDef;
  74. /**
  75. * @}
  76. */
  77. /**
  78. * @}
  79. */
  80. #endif /* USE_FULL_LL_DRIVER */
  81. /* Exported constants --------------------------------------------------------*/
  82. /** @defgroup RCC_LL_Exported_Constants RCC Exported Constants
  83. * @{
  84. */
  85. /** @defgroup RCC_LL_EC_OSC_VALUES Oscillator Values adaptation
  86. * @brief Defines used to adapt values of different oscillators
  87. * @note These values could be modified in the user environment according to
  88. * HW set-up.
  89. * @{
  90. */
  91. #if !defined (HSE_VALUE)
  92. #define HSE_VALUE (8000000U) /*!< Value of the HSE oscillator in Hz */
  93. #endif /* HSE_VALUE */
  94. #if !defined (HSI_VALUE)
  95. #define HSI_VALUE (16000000U) /*!< Value of the HSI oscillator in Hz */
  96. #endif /* HSI_VALUE */
  97. #if !defined (LSE_VALUE)
  98. #define LSE_VALUE (32768U) /*!< Value of the LSE oscillator in Hz */
  99. #endif /* LSE_VALUE */
  100. #if !defined (LSI_VALUE)
  101. #define LSI_VALUE (37000U) /*!< Value of the LSI oscillator in Hz */
  102. #endif /* LSI_VALUE */
  103. #if defined(RCC_HSI48_SUPPORT)
  104. #if !defined (HSI48_VALUE)
  105. #define HSI48_VALUE (48000000U) /*!< Value of the HSI48 oscillator in Hz */
  106. #endif /* HSI48_VALUE */
  107. #endif /* RCC_HSI48_SUPPORT */
  108. /**
  109. * @}
  110. */
  111. /** @defgroup RCC_LL_EC_CLEAR_FLAG Clear Flags Defines
  112. * @brief Flags defines which can be used with LL_RCC_WriteReg function
  113. * @{
  114. */
  115. #define LL_RCC_CICR_LSIRDYC RCC_CICR_LSIRDYC /*!< LSI Ready Interrupt Clear */
  116. #define LL_RCC_CICR_LSERDYC RCC_CICR_LSERDYC /*!< LSE Ready Interrupt Clear */
  117. #define LL_RCC_CICR_HSIRDYC RCC_CICR_HSIRDYC /*!< HSI Ready Interrupt Clear */
  118. #define LL_RCC_CICR_HSERDYC RCC_CICR_HSERDYC /*!< HSE Ready Interrupt Clear */
  119. #define LL_RCC_CICR_PLLRDYC RCC_CICR_PLLRDYC /*!< PLL Ready Interrupt Clear */
  120. #define LL_RCC_CICR_MSIRDYC RCC_CICR_MSIRDYC /*!< MSI Ready Interrupt Clear */
  121. #if defined(RCC_HSI48_SUPPORT)
  122. #define LL_RCC_CICR_HSI48RDYC RCC_CICR_HSI48RDYC /*!< HSI48 Ready Interrupt Clear */
  123. #endif /* RCC_HSI48_SUPPORT */
  124. #define LL_RCC_CICR_LSECSSC RCC_CICR_LSECSSC /*!< LSE Clock Security System Interrupt Clear */
  125. #define LL_RCC_CICR_CSSC RCC_CICR_CSSC /*!< Clock Security System Interrupt Clear */
  126. /**
  127. * @}
  128. */
  129. /** @defgroup RCC_LL_EC_GET_FLAG Get Flags Defines
  130. * @brief Flags defines which can be used with LL_RCC_ReadReg function
  131. * @{
  132. */
  133. #define LL_RCC_CIFR_LSIRDYF RCC_CIFR_LSIRDYF /*!< LSI Ready Interrupt flag */
  134. #define LL_RCC_CIFR_LSERDYF RCC_CIFR_LSERDYF /*!< LSE Ready Interrupt flag */
  135. #define LL_RCC_CIFR_HSIRDYF RCC_CIFR_HSIRDYF /*!< HSI Ready Interrupt flag */
  136. #define LL_RCC_CIFR_HSERDYF RCC_CIFR_HSERDYF /*!< HSE Ready Interrupt flag */
  137. #define LL_RCC_CIFR_PLLRDYF RCC_CIFR_PLLRDYF /*!< PLL Ready Interrupt flag */
  138. #define LL_RCC_CIFR_MSIRDYF RCC_CIFR_MSIRDYF /*!< MSI Ready Interrupt flag */
  139. #if defined(RCC_HSI48_SUPPORT)
  140. #define LL_RCC_CIFR_HSI48RDYF RCC_CIFR_HSI48RDYF /*!< HSI48 Ready Interrupt flag */
  141. #endif /* RCC_HSI48_SUPPORT */
  142. #define LL_RCC_CIFR_LSECSSF RCC_CIFR_LSECSSF /*!< LSE Clock Security System Interrupt flag */
  143. #define LL_RCC_CIFR_CSSF RCC_CIFR_CSSF /*!< Clock Security System Interrupt flag */
  144. #define LL_RCC_CSR_FWRSTF RCC_CSR_FWRSTF /*!< Firewall reset flag */
  145. #define LL_RCC_CSR_OBLRSTF RCC_CSR_OBLRSTF /*!< OBL reset flag */
  146. #define LL_RCC_CSR_PINRSTF RCC_CSR_PINRSTF /*!< PIN reset flag */
  147. #define LL_RCC_CSR_PORRSTF RCC_CSR_PORRSTF /*!< POR/PDR reset flag */
  148. #define LL_RCC_CSR_SFTRSTF RCC_CSR_SFTRSTF /*!< Software Reset flag */
  149. #define LL_RCC_CSR_IWDGRSTF RCC_CSR_IWDGRSTF /*!< Independent Watchdog reset flag */
  150. #define LL_RCC_CSR_WWDGRSTF RCC_CSR_WWDGRSTF /*!< Window watchdog reset flag */
  151. #define LL_RCC_CSR_LPWRRSTF RCC_CSR_LPWRRSTF /*!< Low-Power reset flag */
  152. /**
  153. * @}
  154. */
  155. /** @defgroup RCC_LL_EC_IT IT Defines
  156. * @brief IT defines which can be used with LL_RCC_ReadReg and LL_RCC_WriteReg functions
  157. * @{
  158. */
  159. #define LL_RCC_CIER_LSIRDYIE RCC_CIER_LSIRDYIE /*!< LSI Ready Interrupt Enable */
  160. #define LL_RCC_CIER_LSERDYIE RCC_CIER_LSERDYIE /*!< LSE Ready Interrupt Enable */
  161. #define LL_RCC_CIER_HSIRDYIE RCC_CIER_HSIRDYIE /*!< HSI Ready Interrupt Enable */
  162. #define LL_RCC_CIER_HSERDYIE RCC_CIER_HSERDYIE /*!< HSE Ready Interrupt Enable */
  163. #define LL_RCC_CIER_PLLRDYIE RCC_CIER_PLLRDYIE /*!< PLL Ready Interrupt Enable */
  164. #define LL_RCC_CIER_MSIRDYIE RCC_CIER_MSIRDYIE /*!< MSI Ready Interrupt Enable */
  165. #if defined(RCC_HSI48_SUPPORT)
  166. #define LL_RCC_CIER_HSI48RDYIE RCC_CIER_HSI48RDYIE /*!< HSI48 Ready Interrupt Enable */
  167. #endif /* RCC_HSI48_SUPPORT */
  168. #define LL_RCC_CIER_LSECSSIE RCC_CIER_LSECSSIE /*!< LSE CSS Interrupt Enable */
  169. /**
  170. * @}
  171. */
  172. /** @defgroup RCC_LL_EC_LSEDRIVE LSE oscillator drive capability
  173. * @{
  174. */
  175. #define LL_RCC_LSEDRIVE_LOW (0x00000000U) /*!< Xtal mode lower driving capability */
  176. #define LL_RCC_LSEDRIVE_MEDIUMLOW RCC_CSR_LSEDRV_0 /*!< Xtal mode medium low driving capability */
  177. #define LL_RCC_LSEDRIVE_MEDIUMHIGH RCC_CSR_LSEDRV_1 /*!< Xtal mode medium high driving capability */
  178. #define LL_RCC_LSEDRIVE_HIGH RCC_CSR_LSEDRV /*!< Xtal mode higher driving capability */
  179. /**
  180. * @}
  181. */
  182. /** @defgroup RCC_LL_EC_RTC_HSE_DIV RTC HSE Prescaler
  183. * @{
  184. */
  185. #define LL_RCC_RTC_HSE_DIV_2 0x00000000U /*!< HSE is divided by 2 for RTC clock */
  186. #define LL_RCC_RTC_HSE_DIV_4 RCC_CR_RTCPRE_0 /*!< HSE is divided by 4 for RTC clock */
  187. #define LL_RCC_RTC_HSE_DIV_8 RCC_CR_RTCPRE_1 /*!< HSE is divided by 8 for RTC clock */
  188. #define LL_RCC_RTC_HSE_DIV_16 RCC_CR_RTCPRE /*!< HSE is divided by 16 for RTC clock */
  189. /**
  190. * @}
  191. */
  192. /** @defgroup RCC_LL_EC_MSIRANGE MSI clock ranges
  193. * @{
  194. */
  195. #define LL_RCC_MSIRANGE_0 RCC_ICSCR_MSIRANGE_0 /*!< MSI = 65.536 KHz */
  196. #define LL_RCC_MSIRANGE_1 RCC_ICSCR_MSIRANGE_1 /*!< MSI = 131.072 KHz*/
  197. #define LL_RCC_MSIRANGE_2 RCC_ICSCR_MSIRANGE_2 /*!< MSI = 262.144 KHz */
  198. #define LL_RCC_MSIRANGE_3 RCC_ICSCR_MSIRANGE_3 /*!< MSI = 524.288 KHz */
  199. #define LL_RCC_MSIRANGE_4 RCC_ICSCR_MSIRANGE_4 /*!< MSI = 1.048 MHz */
  200. #define LL_RCC_MSIRANGE_5 RCC_ICSCR_MSIRANGE_5 /*!< MSI = 2.097 MHz */
  201. #define LL_RCC_MSIRANGE_6 RCC_ICSCR_MSIRANGE_6 /*!< MSI = 4.194 MHz */
  202. /**
  203. * @}
  204. */
  205. /** @defgroup RCC_LL_EC_SYS_CLKSOURCE System clock switch
  206. * @{
  207. */
  208. #define LL_RCC_SYS_CLKSOURCE_MSI RCC_CFGR_SW_MSI /*!< MSI selection as system clock */
  209. #define LL_RCC_SYS_CLKSOURCE_HSI RCC_CFGR_SW_HSI /*!< HSI selection as system clock */
  210. #define LL_RCC_SYS_CLKSOURCE_HSE RCC_CFGR_SW_HSE /*!< HSE selection as system clock */
  211. #define LL_RCC_SYS_CLKSOURCE_PLL RCC_CFGR_SW_PLL /*!< PLL selection as system clock */
  212. /**
  213. * @}
  214. */
  215. /** @defgroup RCC_LL_EC_SYS_CLKSOURCE_STATUS System clock switch status
  216. * @{
  217. */
  218. #define LL_RCC_SYS_CLKSOURCE_STATUS_MSI RCC_CFGR_SWS_MSI /*!< MSI used as system clock */
  219. #define LL_RCC_SYS_CLKSOURCE_STATUS_HSI RCC_CFGR_SWS_HSI /*!< HSI used as system clock */
  220. #define LL_RCC_SYS_CLKSOURCE_STATUS_HSE RCC_CFGR_SWS_HSE /*!< HSE used as system clock */
  221. #define LL_RCC_SYS_CLKSOURCE_STATUS_PLL RCC_CFGR_SWS_PLL /*!< PLL used as system clock */
  222. /**
  223. * @}
  224. */
  225. /** @defgroup RCC_LL_EC_SYSCLK_DIV AHB prescaler
  226. * @{
  227. */
  228. #define LL_RCC_SYSCLK_DIV_1 RCC_CFGR_HPRE_DIV1 /*!< SYSCLK not divided */
  229. #define LL_RCC_SYSCLK_DIV_2 RCC_CFGR_HPRE_DIV2 /*!< SYSCLK divided by 2 */
  230. #define LL_RCC_SYSCLK_DIV_4 RCC_CFGR_HPRE_DIV4 /*!< SYSCLK divided by 4 */
  231. #define LL_RCC_SYSCLK_DIV_8 RCC_CFGR_HPRE_DIV8 /*!< SYSCLK divided by 8 */
  232. #define LL_RCC_SYSCLK_DIV_16 RCC_CFGR_HPRE_DIV16 /*!< SYSCLK divided by 16 */
  233. #define LL_RCC_SYSCLK_DIV_64 RCC_CFGR_HPRE_DIV64 /*!< SYSCLK divided by 64 */
  234. #define LL_RCC_SYSCLK_DIV_128 RCC_CFGR_HPRE_DIV128 /*!< SYSCLK divided by 128 */
  235. #define LL_RCC_SYSCLK_DIV_256 RCC_CFGR_HPRE_DIV256 /*!< SYSCLK divided by 256 */
  236. #define LL_RCC_SYSCLK_DIV_512 RCC_CFGR_HPRE_DIV512 /*!< SYSCLK divided by 512 */
  237. /**
  238. * @}
  239. */
  240. /** @defgroup RCC_LL_EC_APB1_DIV APB low-speed prescaler (APB1)
  241. * @{
  242. */
  243. #define LL_RCC_APB1_DIV_1 RCC_CFGR_PPRE1_DIV1 /*!< HCLK not divided */
  244. #define LL_RCC_APB1_DIV_2 RCC_CFGR_PPRE1_DIV2 /*!< HCLK divided by 2 */
  245. #define LL_RCC_APB1_DIV_4 RCC_CFGR_PPRE1_DIV4 /*!< HCLK divided by 4 */
  246. #define LL_RCC_APB1_DIV_8 RCC_CFGR_PPRE1_DIV8 /*!< HCLK divided by 8 */
  247. #define LL_RCC_APB1_DIV_16 RCC_CFGR_PPRE1_DIV16 /*!< HCLK divided by 16 */
  248. /**
  249. * @}
  250. */
  251. /** @defgroup RCC_LL_EC_APB2_DIV APB high-speed prescaler (APB2)
  252. * @{
  253. */
  254. #define LL_RCC_APB2_DIV_1 RCC_CFGR_PPRE2_DIV1 /*!< HCLK not divided */
  255. #define LL_RCC_APB2_DIV_2 RCC_CFGR_PPRE2_DIV2 /*!< HCLK divided by 2 */
  256. #define LL_RCC_APB2_DIV_4 RCC_CFGR_PPRE2_DIV4 /*!< HCLK divided by 4 */
  257. #define LL_RCC_APB2_DIV_8 RCC_CFGR_PPRE2_DIV8 /*!< HCLK divided by 8 */
  258. #define LL_RCC_APB2_DIV_16 RCC_CFGR_PPRE2_DIV16 /*!< HCLK divided by 16 */
  259. /**
  260. * @}
  261. */
  262. /** @defgroup RCC_LL_EC_STOP_WAKEUPCLOCK Wakeup from Stop and CSS backup clock selection
  263. * @{
  264. */
  265. #define LL_RCC_STOP_WAKEUPCLOCK_MSI (0x00000000U) /*!< MSI selection after wake-up from STOP */
  266. #define LL_RCC_STOP_WAKEUPCLOCK_HSI RCC_CFGR_STOPWUCK /*!< HSI selection after wake-up from STOP */
  267. /**
  268. * @}
  269. */
  270. /** @defgroup RCC_LL_EC_MCO1SOURCE MCO1 SOURCE selection
  271. * @{
  272. */
  273. #define LL_RCC_MCO1SOURCE_NOCLOCK RCC_CFGR_MCOSEL_NOCLOCK /*!< MCO output disabled, no clock on MCO */
  274. #define LL_RCC_MCO1SOURCE_SYSCLK RCC_CFGR_MCOSEL_SYSCLK /*!< SYSCLK selection as MCO source */
  275. #define LL_RCC_MCO1SOURCE_HSI RCC_CFGR_MCOSEL_HSI /*!< HSI selection as MCO source */
  276. #define LL_RCC_MCO1SOURCE_MSI RCC_CFGR_MCOSEL_MSI /*!< MSI selection as MCO source */
  277. #define LL_RCC_MCO1SOURCE_HSE RCC_CFGR_MCOSEL_HSE /*!< HSE selection as MCO source */
  278. #define LL_RCC_MCO1SOURCE_LSI RCC_CFGR_MCOSEL_LSI /*!< LSI selection as MCO source */
  279. #define LL_RCC_MCO1SOURCE_LSE RCC_CFGR_MCOSEL_LSE /*!< LSE selection as MCO source */
  280. #if defined(RCC_CFGR_MCOSEL_HSI48)
  281. #define LL_RCC_MCO1SOURCE_HSI48 RCC_CFGR_MCOSEL_HSI48 /*!< HSI48 selection as MCO source */
  282. #endif /* RCC_CFGR_MCOSEL_HSI48 */
  283. #define LL_RCC_MCO1SOURCE_PLLCLK RCC_CFGR_MCOSEL_PLL /*!< PLLCLK selection as MCO source */
  284. /**
  285. * @}
  286. */
  287. /** @defgroup RCC_LL_EC_MCO1_DIV MCO1 prescaler
  288. * @{
  289. */
  290. #define LL_RCC_MCO1_DIV_1 RCC_CFGR_MCOPRE_DIV1 /*!< MCO Clock divided by 1 */
  291. #define LL_RCC_MCO1_DIV_2 RCC_CFGR_MCOPRE_DIV2 /*!< MCO Clock divided by 2 */
  292. #define LL_RCC_MCO1_DIV_4 RCC_CFGR_MCOPRE_DIV4 /*!< MCO Clock divided by 4 */
  293. #define LL_RCC_MCO1_DIV_8 RCC_CFGR_MCOPRE_DIV8 /*!< MCO Clock divided by 8 */
  294. #define LL_RCC_MCO1_DIV_16 RCC_CFGR_MCOPRE_DIV16 /*!< MCO Clock divided by 16 */
  295. /**
  296. * @}
  297. */
  298. #if defined(USE_FULL_LL_DRIVER)
  299. /** @defgroup RCC_LL_EC_PERIPH_FREQUENCY Peripheral clock frequency
  300. * @{
  301. */
  302. #define LL_RCC_PERIPH_FREQUENCY_NO 0x00000000U /*!< No clock enabled for the peripheral */
  303. #define LL_RCC_PERIPH_FREQUENCY_NA 0xFFFFFFFFU /*!< Frequency cannot be provided as external clock */
  304. /**
  305. * @}
  306. */
  307. #endif /* USE_FULL_LL_DRIVER */
  308. /** @defgroup RCC_LL_EC_USART1_CLKSOURCE Peripheral USART clock source selection
  309. * @{
  310. */
  311. #if defined(RCC_CCIPR_USART1SEL)
  312. #define LL_RCC_USART1_CLKSOURCE_PCLK2 (uint32_t)((RCC_CCIPR_USART1SEL << 16U) | 0x00000000U) /*!< PCLK2 selected as USART1 clock */
  313. #define LL_RCC_USART1_CLKSOURCE_SYSCLK (uint32_t)((RCC_CCIPR_USART1SEL << 16U) | RCC_CCIPR_USART1SEL_0) /*!< SYSCLK selected as USART1 clock */
  314. #define LL_RCC_USART1_CLKSOURCE_HSI (uint32_t)((RCC_CCIPR_USART1SEL << 16U) | RCC_CCIPR_USART1SEL_1) /*!< HSI selected as USART1 clock */
  315. #define LL_RCC_USART1_CLKSOURCE_LSE (uint32_t)((RCC_CCIPR_USART1SEL << 16U) | RCC_CCIPR_USART1SEL) /*!< LSE selected as USART1 clock*/
  316. #endif /* RCC_CCIPR_USART1SEL */
  317. #define LL_RCC_USART2_CLKSOURCE_PCLK1 (uint32_t)((RCC_CCIPR_USART2SEL << 16U) | 0x00000000U) /*!< PCLK1 selected as USART2 clock */
  318. #define LL_RCC_USART2_CLKSOURCE_SYSCLK (uint32_t)((RCC_CCIPR_USART2SEL << 16U) | RCC_CCIPR_USART2SEL_0) /*!< SYSCLK selected as USART2 clock */
  319. #define LL_RCC_USART2_CLKSOURCE_HSI (uint32_t)((RCC_CCIPR_USART2SEL << 16U) | RCC_CCIPR_USART2SEL_1) /*!< HSI selected as USART2 clock */
  320. #define LL_RCC_USART2_CLKSOURCE_LSE (uint32_t)((RCC_CCIPR_USART2SEL << 16U) | RCC_CCIPR_USART2SEL) /*!< LSE selected as USART2 clock*/
  321. /**
  322. * @}
  323. */
  324. /** @defgroup RCC_LL_EC_LPUART1_CLKSOURCE Peripheral LPUART clock source selection
  325. * @{
  326. */
  327. #define LL_RCC_LPUART1_CLKSOURCE_PCLK1 0x00000000U /*!< PCLK1 selected as LPUART1 clock */
  328. #define LL_RCC_LPUART1_CLKSOURCE_SYSCLK RCC_CCIPR_LPUART1SEL_0 /*!< SYSCLK selected as LPUART1 clock */
  329. #define LL_RCC_LPUART1_CLKSOURCE_HSI RCC_CCIPR_LPUART1SEL_1 /*!< HSI selected as LPUART1 clock */
  330. #define LL_RCC_LPUART1_CLKSOURCE_LSE RCC_CCIPR_LPUART1SEL /*!< LSE selected as LPUART1 clock*/
  331. /**
  332. * @}
  333. */
  334. /** @defgroup RCC_LL_EC_I2C1_CLKSOURCE Peripheral I2C clock source selection
  335. * @{
  336. */
  337. #define LL_RCC_I2C1_CLKSOURCE_PCLK1 (uint32_t)((RCC_CCIPR_I2C1SEL << 4U) | (0x00000000U >> 4U)) /*!< PCLK1 selected as I2C1 clock */
  338. #define LL_RCC_I2C1_CLKSOURCE_SYSCLK (uint32_t)((RCC_CCIPR_I2C1SEL << 4U) | (RCC_CCIPR_I2C1SEL_0 >> 4U)) /*!< SYSCLK selected as I2C1 clock */
  339. #define LL_RCC_I2C1_CLKSOURCE_HSI (uint32_t)((RCC_CCIPR_I2C1SEL << 4U) | (RCC_CCIPR_I2C1SEL_1 >> 4U)) /*!< HSI selected as I2C1 clock */
  340. #if defined(RCC_CCIPR_I2C3SEL)
  341. #define LL_RCC_I2C3_CLKSOURCE_PCLK1 (uint32_t)((RCC_CCIPR_I2C3SEL << 4U) | (0x00000000U >> 4U)) /*!< PCLK1 selected as I2C3 clock */
  342. #define LL_RCC_I2C3_CLKSOURCE_SYSCLK (uint32_t)((RCC_CCIPR_I2C3SEL << 4U) | (RCC_CCIPR_I2C3SEL_0 >> 4U)) /*!< SYSCLK selected as I2C3 clock */
  343. #define LL_RCC_I2C3_CLKSOURCE_HSI (uint32_t)((RCC_CCIPR_I2C3SEL << 4U) | (RCC_CCIPR_I2C3SEL_1 >> 4U)) /*!< HSI selected as I2C3 clock */
  344. #endif /*RCC_CCIPR_I2C3SEL*/
  345. /**
  346. * @}
  347. */
  348. /** @defgroup RCC_LL_EC_LPTIM1_CLKSOURCE Peripheral LPTIM clock source selection
  349. * @{
  350. */
  351. #define LL_RCC_LPTIM1_CLKSOURCE_PCLK1 (0x00000000U) /*!< PCLK1 selected as LPTIM1 clock */
  352. #define LL_RCC_LPTIM1_CLKSOURCE_LSI RCC_CCIPR_LPTIM1SEL_0 /*!< LSI selected as LPTIM1 clock */
  353. #define LL_RCC_LPTIM1_CLKSOURCE_HSI RCC_CCIPR_LPTIM1SEL_1 /*!< HSI selected as LPTIM1 clock */
  354. #define LL_RCC_LPTIM1_CLKSOURCE_LSE RCC_CCIPR_LPTIM1SEL /*!< LSE selected as LPTIM1 clock*/
  355. /**
  356. * @}
  357. */
  358. #if defined(RCC_CCIPR_HSI48SEL)
  359. #if defined(RNG)
  360. /** @defgroup RCC_LL_EC_RNG_CLKSOURCE Peripheral RNG clock source selection
  361. * @{
  362. */
  363. #define LL_RCC_RNG_CLKSOURCE_PLL (0x00000000U) /*!< PLL selected as RNG clock */
  364. #define LL_RCC_RNG_CLKSOURCE_HSI48 RCC_CCIPR_HSI48SEL /*!< HSI48 selected as RNG clock*/
  365. /**
  366. * @}
  367. */
  368. #endif /* RNG */
  369. #if defined(USB)
  370. /** @defgroup RCC_LL_EC_USB_CLKSOURCE Peripheral USB clock source selection
  371. * @{
  372. */
  373. #define LL_RCC_USB_CLKSOURCE_PLL (0x00000000U) /*!< PLL selected as USB clock */
  374. #define LL_RCC_USB_CLKSOURCE_HSI48 RCC_CCIPR_HSI48SEL /*!< HSI48 selected as USB clock*/
  375. /**
  376. * @}
  377. */
  378. #endif /* USB */
  379. #endif /* RCC_CCIPR_HSI48SEL */
  380. /** @defgroup RCC_LL_EC_USART1 Peripheral USART get clock source
  381. * @{
  382. */
  383. #if defined(RCC_CCIPR_USART1SEL)
  384. #define LL_RCC_USART1_CLKSOURCE RCC_CCIPR_USART1SEL /*!< USART1 clock source selection bits */
  385. #endif /* RCC_CCIPR_USART1SEL */
  386. #define LL_RCC_USART2_CLKSOURCE RCC_CCIPR_USART2SEL /*!< USART2 clock source selection bits */
  387. /**
  388. * @}
  389. */
  390. /** @defgroup RCC_LL_EC_LPUART1 Peripheral LPUART get clock source
  391. * @{
  392. */
  393. #define LL_RCC_LPUART1_CLKSOURCE RCC_CCIPR_LPUART1SEL /*!< LPUART1 clock source selection bits */
  394. /**
  395. * @}
  396. */
  397. /** @defgroup RCC_LL_EC_I2C1 Peripheral I2C get clock source
  398. * @{
  399. */
  400. #define LL_RCC_I2C1_CLKSOURCE RCC_CCIPR_I2C1SEL /*!< I2C1 clock source selection bits */
  401. #if defined(RCC_CCIPR_I2C3SEL)
  402. #define LL_RCC_I2C3_CLKSOURCE RCC_CCIPR_I2C3SEL /*!< I2C3 clock source selection bits */
  403. #endif /*RCC_CCIPR_I2C3SEL*/
  404. /**
  405. * @}
  406. */
  407. /** @defgroup RCC_LL_EC_LPTIM1 Peripheral LPTIM get clock source
  408. * @{
  409. */
  410. #define LL_RCC_LPTIM1_CLKSOURCE RCC_CCIPR_LPTIM1SEL /*!< LPTIM1 clock source selection bits */
  411. /**
  412. * @}
  413. */
  414. #if defined(RCC_CCIPR_HSI48SEL)
  415. #if defined(RNG)
  416. /** @defgroup RCC_LL_EC_RNG Peripheral RNG get clock source
  417. * @{
  418. */
  419. #define LL_RCC_RNG_CLKSOURCE RCC_CCIPR_HSI48SEL /*!< HSI48 RC clock source selection bit for RNG*/
  420. /**
  421. * @}
  422. */
  423. #endif /* RNG */
  424. #if defined(USB)
  425. /** @defgroup RCC_LL_EC_USB Peripheral USB get clock source
  426. * @{
  427. */
  428. #define LL_RCC_USB_CLKSOURCE RCC_CCIPR_HSI48SEL /*!< HSI48 RC clock source selection bit for USB*/
  429. /**
  430. * @}
  431. */
  432. #endif /* USB */
  433. #endif /* RCC_CCIPR_HSI48SEL */
  434. /** @defgroup RCC_LL_EC_RTC_CLKSOURCE RTC clock source selection
  435. * @{
  436. */
  437. #define LL_RCC_RTC_CLKSOURCE_NONE 0x00000000U /*!< No clock used as RTC clock */
  438. #define LL_RCC_RTC_CLKSOURCE_LSE RCC_CSR_RTCSEL_LSE /*!< LSE oscillator clock used as RTC clock */
  439. #define LL_RCC_RTC_CLKSOURCE_LSI RCC_CSR_RTCSEL_LSI /*!< LSI oscillator clock used as RTC clock */
  440. #define LL_RCC_RTC_CLKSOURCE_HSE RCC_CSR_RTCSEL_HSE /*!< HSE oscillator clock divided by a programmable prescaler
  441. (selection through @ref LL_RCC_SetRTC_HSEPrescaler function ) */
  442. /**
  443. * @}
  444. */
  445. /** @defgroup RCC_LL_EC_PLL_MUL PLL Multiplicator factor
  446. * @{
  447. */
  448. #define LL_RCC_PLL_MUL_3 RCC_CFGR_PLLMUL3 /*!< PLL input clock * 3 */
  449. #define LL_RCC_PLL_MUL_4 RCC_CFGR_PLLMUL4 /*!< PLL input clock * 4 */
  450. #define LL_RCC_PLL_MUL_6 RCC_CFGR_PLLMUL6 /*!< PLL input clock * 6 */
  451. #define LL_RCC_PLL_MUL_8 RCC_CFGR_PLLMUL8 /*!< PLL input clock * 8 */
  452. #define LL_RCC_PLL_MUL_12 RCC_CFGR_PLLMUL12 /*!< PLL input clock * 12 */
  453. #define LL_RCC_PLL_MUL_16 RCC_CFGR_PLLMUL16 /*!< PLL input clock * 16 */
  454. #define LL_RCC_PLL_MUL_24 RCC_CFGR_PLLMUL24 /*!< PLL input clock * 24 */
  455. #define LL_RCC_PLL_MUL_32 RCC_CFGR_PLLMUL32 /*!< PLL input clock * 32 */
  456. #define LL_RCC_PLL_MUL_48 RCC_CFGR_PLLMUL48 /*!< PLL input clock * 48 */
  457. /**
  458. * @}
  459. */
  460. /** @defgroup RCC_LL_EC_PLL_DIV PLL division factor
  461. * @{
  462. */
  463. #define LL_RCC_PLL_DIV_2 RCC_CFGR_PLLDIV2 /*!< PLL clock output = PLLVCO / 2 */
  464. #define LL_RCC_PLL_DIV_3 RCC_CFGR_PLLDIV3 /*!< PLL clock output = PLLVCO / 3 */
  465. #define LL_RCC_PLL_DIV_4 RCC_CFGR_PLLDIV4 /*!< PLL clock output = PLLVCO / 4 */
  466. /**
  467. * @}
  468. */
  469. /** @defgroup RCC_LL_EC_PLLSOURCE PLL SOURCE
  470. * @{
  471. */
  472. #define LL_RCC_PLLSOURCE_HSI RCC_CFGR_PLLSRC_HSI /*!< HSI clock selected as PLL entry clock source */
  473. #define LL_RCC_PLLSOURCE_HSE RCC_CFGR_PLLSRC_HSE /*!< HSE clock selected as PLL entry clock source */
  474. /**
  475. * @}
  476. */
  477. /**
  478. * @}
  479. */
  480. /* Exported macro ------------------------------------------------------------*/
  481. /** @defgroup RCC_LL_Exported_Macros RCC Exported Macros
  482. * @{
  483. */
  484. /** @defgroup RCC_LL_EM_WRITE_READ Common Write and read registers Macros
  485. * @{
  486. */
  487. /**
  488. * @brief Write a value in RCC register
  489. * @param __REG__ Register to be written
  490. * @param __VALUE__ Value to be written in the register
  491. * @retval None
  492. */
  493. #define LL_RCC_WriteReg(__REG__, __VALUE__) WRITE_REG(RCC->__REG__, (__VALUE__))
  494. /**
  495. * @brief Read a value in RCC register
  496. * @param __REG__ Register to be read
  497. * @retval Register value
  498. */
  499. #define LL_RCC_ReadReg(__REG__) READ_REG(RCC->__REG__)
  500. /**
  501. * @}
  502. */
  503. /** @defgroup RCC_LL_EM_CALC_FREQ Calculate frequencies
  504. * @{
  505. */
  506. /**
  507. * @brief Helper macro to calculate the PLLCLK frequency
  508. * @note ex: @ref __LL_RCC_CALC_PLLCLK_FREQ (HSE_VALUE,
  509. * @ref LL_RCC_PLL_GetMultiplicator (),
  510. * @ref LL_RCC_PLL_GetDivider ());
  511. * @param __INPUTFREQ__ PLL Input frequency (based on MSI/HSE/HSI)
  512. * @param __PLLMUL__ This parameter can be one of the following values:
  513. * @arg @ref LL_RCC_PLL_MUL_3
  514. * @arg @ref LL_RCC_PLL_MUL_4
  515. * @arg @ref LL_RCC_PLL_MUL_6
  516. * @arg @ref LL_RCC_PLL_MUL_8
  517. * @arg @ref LL_RCC_PLL_MUL_12
  518. * @arg @ref LL_RCC_PLL_MUL_16
  519. * @arg @ref LL_RCC_PLL_MUL_24
  520. * @arg @ref LL_RCC_PLL_MUL_32
  521. * @arg @ref LL_RCC_PLL_MUL_48
  522. * @param __PLLDIV__ This parameter can be one of the following values:
  523. * @arg @ref LL_RCC_PLL_DIV_2
  524. * @arg @ref LL_RCC_PLL_DIV_3
  525. * @arg @ref LL_RCC_PLL_DIV_4
  526. * @retval PLL clock frequency (in Hz)
  527. */
  528. #define __LL_RCC_CALC_PLLCLK_FREQ(__INPUTFREQ__, __PLLMUL__, __PLLDIV__) ((__INPUTFREQ__) * (PLLMulTable[(__PLLMUL__) >> RCC_CFGR_PLLMUL_Pos]) / (((__PLLDIV__) >> RCC_CFGR_PLLDIV_Pos)+1UL))
  529. /**
  530. * @brief Helper macro to calculate the HCLK frequency
  531. * @note: __AHBPRESCALER__ be retrieved by @ref LL_RCC_GetAHBPrescaler
  532. * ex: __LL_RCC_CALC_HCLK_FREQ(LL_RCC_GetAHBPrescaler())
  533. * @param __SYSCLKFREQ__ SYSCLK frequency (based on MSI/HSE/HSI/PLLCLK)
  534. * @param __AHBPRESCALER__ This parameter can be one of the following values:
  535. * @arg @ref LL_RCC_SYSCLK_DIV_1
  536. * @arg @ref LL_RCC_SYSCLK_DIV_2
  537. * @arg @ref LL_RCC_SYSCLK_DIV_4
  538. * @arg @ref LL_RCC_SYSCLK_DIV_8
  539. * @arg @ref LL_RCC_SYSCLK_DIV_16
  540. * @arg @ref LL_RCC_SYSCLK_DIV_64
  541. * @arg @ref LL_RCC_SYSCLK_DIV_128
  542. * @arg @ref LL_RCC_SYSCLK_DIV_256
  543. * @arg @ref LL_RCC_SYSCLK_DIV_512
  544. * @retval HCLK clock frequency (in Hz)
  545. */
  546. #define __LL_RCC_CALC_HCLK_FREQ(__SYSCLKFREQ__, __AHBPRESCALER__) ((__SYSCLKFREQ__) >> AHBPrescTable[((__AHBPRESCALER__) & RCC_CFGR_HPRE) >> RCC_CFGR_HPRE_Pos])
  547. /**
  548. * @brief Helper macro to calculate the PCLK1 frequency (ABP1)
  549. * @note: __APB1PRESCALER__ be retrieved by @ref LL_RCC_GetAPB1Prescaler
  550. * ex: __LL_RCC_CALC_PCLK1_FREQ(LL_RCC_GetAPB1Prescaler())
  551. * @param __HCLKFREQ__ HCLK frequency
  552. * @param __APB1PRESCALER__ This parameter can be one of the following values:
  553. * @arg @ref LL_RCC_APB1_DIV_1
  554. * @arg @ref LL_RCC_APB1_DIV_2
  555. * @arg @ref LL_RCC_APB1_DIV_4
  556. * @arg @ref LL_RCC_APB1_DIV_8
  557. * @arg @ref LL_RCC_APB1_DIV_16
  558. * @retval PCLK1 clock frequency (in Hz)
  559. */
  560. #define __LL_RCC_CALC_PCLK1_FREQ(__HCLKFREQ__, __APB1PRESCALER__) ((__HCLKFREQ__) >> APBPrescTable[(__APB1PRESCALER__) >> RCC_CFGR_PPRE1_Pos])
  561. /**
  562. * @brief Helper macro to calculate the PCLK2 frequency (ABP2)
  563. * @note: __APB2PRESCALER__ be retrieved by @ref LL_RCC_GetAPB2Prescaler
  564. * ex: __LL_RCC_CALC_PCLK2_FREQ(LL_RCC_GetAPB2Prescaler())
  565. * @param __HCLKFREQ__ HCLK frequency
  566. * @param __APB2PRESCALER__ This parameter can be one of the following values:
  567. * @arg @ref LL_RCC_APB2_DIV_1
  568. * @arg @ref LL_RCC_APB2_DIV_2
  569. * @arg @ref LL_RCC_APB2_DIV_4
  570. * @arg @ref LL_RCC_APB2_DIV_8
  571. * @arg @ref LL_RCC_APB2_DIV_16
  572. * @retval PCLK2 clock frequency (in Hz)
  573. */
  574. #define __LL_RCC_CALC_PCLK2_FREQ(__HCLKFREQ__, __APB2PRESCALER__) ((__HCLKFREQ__) >> APBPrescTable[(__APB2PRESCALER__) >> RCC_CFGR_PPRE2_Pos])
  575. /**
  576. * @brief Helper macro to calculate the MSI frequency (in Hz)
  577. * @note: __MSIRANGE__can be retrieved by @ref LL_RCC_MSI_GetRange
  578. * ex: __LL_RCC_CALC_MSI_FREQ(LL_RCC_MSI_GetRange())
  579. * @param __MSIRANGE__ This parameter can be one of the following values:
  580. * @arg @ref LL_RCC_MSIRANGE_0
  581. * @arg @ref LL_RCC_MSIRANGE_1
  582. * @arg @ref LL_RCC_MSIRANGE_2
  583. * @arg @ref LL_RCC_MSIRANGE_3
  584. * @arg @ref LL_RCC_MSIRANGE_4
  585. * @arg @ref LL_RCC_MSIRANGE_5
  586. * @arg @ref LL_RCC_MSIRANGE_6
  587. * @retval MSI clock frequency (in Hz)
  588. */
  589. #define __LL_RCC_CALC_MSI_FREQ(__MSIRANGE__) (32768UL * ( 1UL << (((__MSIRANGE__) >> RCC_ICSCR_MSIRANGE_Pos) + 1UL) ))
  590. /**
  591. * @}
  592. */
  593. /**
  594. * @}
  595. */
  596. /* Exported functions --------------------------------------------------------*/
  597. /** @defgroup RCC_LL_Exported_Functions RCC Exported Functions
  598. * @{
  599. */
  600. /** @defgroup RCC_LL_EF_HSE HSE
  601. * @{
  602. */
  603. #if defined(RCC_HSECSS_SUPPORT)
  604. /**
  605. * @brief Enable the Clock Security System.
  606. * @rmtoll CR CSSHSEON LL_RCC_HSE_EnableCSS
  607. * @retval None
  608. */
  609. __STATIC_INLINE void LL_RCC_HSE_EnableCSS(void)
  610. {
  611. SET_BIT(RCC->CR, RCC_CR_CSSON);
  612. }
  613. #endif /* RCC_HSECSS_SUPPORT */
  614. /**
  615. * @brief Enable HSE external oscillator (HSE Bypass)
  616. * @rmtoll CR HSEBYP LL_RCC_HSE_EnableBypass
  617. * @retval None
  618. */
  619. __STATIC_INLINE void LL_RCC_HSE_EnableBypass(void)
  620. {
  621. SET_BIT(RCC->CR, RCC_CR_HSEBYP);
  622. }
  623. /**
  624. * @brief Disable HSE external oscillator (HSE Bypass)
  625. * @rmtoll CR HSEBYP LL_RCC_HSE_DisableBypass
  626. * @retval None
  627. */
  628. __STATIC_INLINE void LL_RCC_HSE_DisableBypass(void)
  629. {
  630. CLEAR_BIT(RCC->CR, RCC_CR_HSEBYP);
  631. }
  632. /**
  633. * @brief Enable HSE crystal oscillator (HSE ON)
  634. * @rmtoll CR HSEON LL_RCC_HSE_Enable
  635. * @retval None
  636. */
  637. __STATIC_INLINE void LL_RCC_HSE_Enable(void)
  638. {
  639. SET_BIT(RCC->CR, RCC_CR_HSEON);
  640. }
  641. /**
  642. * @brief Disable HSE crystal oscillator (HSE ON)
  643. * @rmtoll CR HSEON LL_RCC_HSE_Disable
  644. * @retval None
  645. */
  646. __STATIC_INLINE void LL_RCC_HSE_Disable(void)
  647. {
  648. CLEAR_BIT(RCC->CR, RCC_CR_HSEON);
  649. }
  650. /**
  651. * @brief Check if HSE oscillator Ready
  652. * @rmtoll CR HSERDY LL_RCC_HSE_IsReady
  653. * @retval State of bit (1 or 0).
  654. */
  655. __STATIC_INLINE uint32_t LL_RCC_HSE_IsReady(void)
  656. {
  657. return ((READ_BIT(RCC->CR, RCC_CR_HSERDY) == RCC_CR_HSERDY) ? 1UL : 0UL);
  658. }
  659. /**
  660. * @brief Configure the RTC prescaler (divider)
  661. * @rmtoll CR RTCPRE LL_RCC_SetRTC_HSEPrescaler
  662. * @param Div This parameter can be one of the following values:
  663. * @arg @ref LL_RCC_RTC_HSE_DIV_2
  664. * @arg @ref LL_RCC_RTC_HSE_DIV_4
  665. * @arg @ref LL_RCC_RTC_HSE_DIV_8
  666. * @arg @ref LL_RCC_RTC_HSE_DIV_16
  667. * @retval None
  668. */
  669. __STATIC_INLINE void LL_RCC_SetRTC_HSEPrescaler(uint32_t Div)
  670. {
  671. MODIFY_REG(RCC->CR, RCC_CR_RTCPRE, Div);
  672. }
  673. /**
  674. * @brief Get the RTC divider (prescaler)
  675. * @rmtoll CR RTCPRE LL_RCC_GetRTC_HSEPrescaler
  676. * @retval Returned value can be one of the following values:
  677. * @arg @ref LL_RCC_RTC_HSE_DIV_2
  678. * @arg @ref LL_RCC_RTC_HSE_DIV_4
  679. * @arg @ref LL_RCC_RTC_HSE_DIV_8
  680. * @arg @ref LL_RCC_RTC_HSE_DIV_16
  681. */
  682. __STATIC_INLINE uint32_t LL_RCC_GetRTC_HSEPrescaler(void)
  683. {
  684. return (uint32_t)(READ_BIT(RCC->CR, RCC_CR_RTCPRE));
  685. }
  686. /**
  687. * @}
  688. */
  689. /** @defgroup RCC_LL_EF_HSI HSI
  690. * @{
  691. */
  692. /**
  693. * @brief Enable HSI oscillator
  694. * @rmtoll CR HSION LL_RCC_HSI_Enable
  695. * @retval None
  696. */
  697. __STATIC_INLINE void LL_RCC_HSI_Enable(void)
  698. {
  699. SET_BIT(RCC->CR, RCC_CR_HSION);
  700. }
  701. /**
  702. * @brief Disable HSI oscillator
  703. * @rmtoll CR HSION LL_RCC_HSI_Disable
  704. * @retval None
  705. */
  706. __STATIC_INLINE void LL_RCC_HSI_Disable(void)
  707. {
  708. CLEAR_BIT(RCC->CR, RCC_CR_HSION);
  709. }
  710. /**
  711. * @brief Check if HSI clock is ready
  712. * @rmtoll CR HSIRDY LL_RCC_HSI_IsReady
  713. * @retval State of bit (1 or 0).
  714. */
  715. __STATIC_INLINE uint32_t LL_RCC_HSI_IsReady(void)
  716. {
  717. return ((READ_BIT(RCC->CR, RCC_CR_HSIRDY) == RCC_CR_HSIRDY) ? 1UL : 0UL);
  718. }
  719. /**
  720. * @brief Enable HSI even in stop mode
  721. * @note HSI oscillator is forced ON even in Stop mode
  722. * @rmtoll CR HSIKERON LL_RCC_HSI_EnableInStopMode
  723. * @retval None
  724. */
  725. __STATIC_INLINE void LL_RCC_HSI_EnableInStopMode(void)
  726. {
  727. SET_BIT(RCC->CR, RCC_CR_HSIKERON);
  728. }
  729. /**
  730. * @brief Disable HSI in stop mode
  731. * @rmtoll CR HSIKERON LL_RCC_HSI_DisableInStopMode
  732. * @retval None
  733. */
  734. __STATIC_INLINE void LL_RCC_HSI_DisableInStopMode(void)
  735. {
  736. CLEAR_BIT(RCC->CR, RCC_CR_HSIKERON);
  737. }
  738. /**
  739. * @brief Enable HSI Divider (it divides by 4)
  740. * @rmtoll CR HSIDIVEN LL_RCC_HSI_EnableDivider
  741. * @retval None
  742. */
  743. __STATIC_INLINE void LL_RCC_HSI_EnableDivider(void)
  744. {
  745. SET_BIT(RCC->CR, RCC_CR_HSIDIVEN);
  746. }
  747. /**
  748. * @brief Disable HSI Divider (it divides by 4)
  749. * @rmtoll CR HSIDIVEN LL_RCC_HSI_DisableDivider
  750. * @retval None
  751. */
  752. __STATIC_INLINE void LL_RCC_HSI_DisableDivider(void)
  753. {
  754. CLEAR_BIT(RCC->CR, RCC_CR_HSIDIVEN);
  755. }
  756. #if defined(RCC_CR_HSIOUTEN)
  757. /**
  758. * @brief Enable HSI Output
  759. * @rmtoll CR HSIOUTEN LL_RCC_HSI_EnableOutput
  760. * @retval None
  761. */
  762. __STATIC_INLINE void LL_RCC_HSI_EnableOutput(void)
  763. {
  764. SET_BIT(RCC->CR, RCC_CR_HSIOUTEN);
  765. }
  766. /**
  767. * @brief Disable HSI Output
  768. * @rmtoll CR HSIOUTEN LL_RCC_HSI_DisableOutput
  769. * @retval None
  770. */
  771. __STATIC_INLINE void LL_RCC_HSI_DisableOutput(void)
  772. {
  773. CLEAR_BIT(RCC->CR, RCC_CR_HSIOUTEN);
  774. }
  775. #endif /* RCC_CR_HSIOUTEN */
  776. /**
  777. * @brief Get HSI Calibration value
  778. * @note When HSITRIM is written, HSICAL is updated with the sum of
  779. * HSITRIM and the factory trim value
  780. * @rmtoll ICSCR HSICAL LL_RCC_HSI_GetCalibration
  781. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  782. */
  783. __STATIC_INLINE uint32_t LL_RCC_HSI_GetCalibration(void)
  784. {
  785. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_HSICAL) >> RCC_ICSCR_HSICAL_Pos);
  786. }
  787. /**
  788. * @brief Set HSI Calibration trimming
  789. * @note user-programmable trimming value that is added to the HSICAL
  790. * @note Default value is 16, which, when added to the HSICAL value,
  791. * should trim the HSI to 16 MHz +/- 1 %
  792. * @rmtoll ICSCR HSITRIM LL_RCC_HSI_SetCalibTrimming
  793. * @param Value between Min_Data = 0x00 and Max_Data = 0x1F
  794. * @retval None
  795. */
  796. __STATIC_INLINE void LL_RCC_HSI_SetCalibTrimming(uint32_t Value)
  797. {
  798. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_HSITRIM, Value << RCC_ICSCR_HSITRIM_Pos);
  799. }
  800. /**
  801. * @brief Get HSI Calibration trimming
  802. * @rmtoll ICSCR HSITRIM LL_RCC_HSI_GetCalibTrimming
  803. * @retval Between Min_Data = 0x00 and Max_Data = 0x1F
  804. */
  805. __STATIC_INLINE uint32_t LL_RCC_HSI_GetCalibTrimming(void)
  806. {
  807. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_HSITRIM) >> RCC_ICSCR_HSITRIM_Pos);
  808. }
  809. /**
  810. * @}
  811. */
  812. #if defined(RCC_HSI48_SUPPORT)
  813. /** @defgroup RCC_LL_EF_HSI48 HSI48
  814. * @{
  815. */
  816. /**
  817. * @brief Enable HSI48
  818. * @rmtoll CRRCR HSI48ON LL_RCC_HSI48_Enable
  819. * @retval None
  820. */
  821. __STATIC_INLINE void LL_RCC_HSI48_Enable(void)
  822. {
  823. SET_BIT(RCC->CRRCR, RCC_CRRCR_HSI48ON);
  824. }
  825. /**
  826. * @brief Disable HSI48
  827. * @rmtoll CRRCR HSI48ON LL_RCC_HSI48_Disable
  828. * @retval None
  829. */
  830. __STATIC_INLINE void LL_RCC_HSI48_Disable(void)
  831. {
  832. CLEAR_BIT(RCC->CRRCR, RCC_CRRCR_HSI48ON);
  833. }
  834. /**
  835. * @brief Check if HSI48 oscillator Ready
  836. * @rmtoll CRRCR HSI48RDY LL_RCC_HSI48_IsReady
  837. * @retval State of bit (1 or 0).
  838. */
  839. __STATIC_INLINE uint32_t LL_RCC_HSI48_IsReady(void)
  840. {
  841. return ((READ_BIT(RCC->CRRCR, RCC_CRRCR_HSI48RDY) == RCC_CRRCR_HSI48RDY) ? 1UL : 0UL);
  842. }
  843. /**
  844. * @brief Get HSI48 Calibration value
  845. * @rmtoll CRRCR HSI48CAL LL_RCC_HSI48_GetCalibration
  846. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  847. */
  848. __STATIC_INLINE uint32_t LL_RCC_HSI48_GetCalibration(void)
  849. {
  850. return (uint32_t)(READ_BIT(RCC->CRRCR, RCC_CRRCR_HSI48CAL) >> RCC_CRRCR_HSI48CAL_Pos);
  851. }
  852. #if defined(RCC_CRRCR_HSI48DIV6OUTEN)
  853. /**
  854. * @brief Enable HSI48 Divider (it divides by 6)
  855. * @rmtoll CRRCR HSI48DIV6OUTEN LL_RCC_HSI48_EnableDivider
  856. * @retval None
  857. */
  858. __STATIC_INLINE void LL_RCC_HSI48_EnableDivider(void)
  859. {
  860. SET_BIT(RCC->CRRCR, RCC_CRRCR_HSI48DIV6OUTEN);
  861. }
  862. /**
  863. * @brief Disable HSI48 Divider (it divides by 6)
  864. * @rmtoll CRRCR HSI48DIV6OUTEN LL_RCC_HSI48_DisableDivider
  865. * @retval None
  866. */
  867. __STATIC_INLINE void LL_RCC_HSI48_DisableDivider(void)
  868. {
  869. CLEAR_BIT(RCC->CRRCR, RCC_CRRCR_HSI48DIV6OUTEN);
  870. }
  871. /**
  872. * @brief Check if HSI48 Divider is enabled (it divides by 6)
  873. * @rmtoll CRRCR HSI48DIV6OUTEN LL_RCC_HSI48_IsDivided
  874. * @retval State of bit (1 or 0).
  875. */
  876. __STATIC_INLINE uint32_t LL_RCC_HSI48_IsDivided(void)
  877. {
  878. return ((READ_BIT(RCC->CRRCR, RCC_CRRCR_HSI48DIV6OUTEN) == RCC_CRRCR_HSI48DIV6OUTEN) ? 1UL : 0UL);
  879. }
  880. #endif /*RCC_CRRCR_HSI48DIV6OUTEN*/
  881. /**
  882. * @}
  883. */
  884. #endif /* RCC_HSI48_SUPPORT */
  885. /** @defgroup RCC_LL_EF_LSE LSE
  886. * @{
  887. */
  888. /**
  889. * @brief Enable Low Speed External (LSE) crystal.
  890. * @rmtoll CSR LSEON LL_RCC_LSE_Enable
  891. * @retval None
  892. */
  893. __STATIC_INLINE void LL_RCC_LSE_Enable(void)
  894. {
  895. SET_BIT(RCC->CSR, RCC_CSR_LSEON);
  896. }
  897. /**
  898. * @brief Disable Low Speed External (LSE) crystal.
  899. * @rmtoll CSR LSEON LL_RCC_LSE_Disable
  900. * @retval None
  901. */
  902. __STATIC_INLINE void LL_RCC_LSE_Disable(void)
  903. {
  904. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEON);
  905. }
  906. /**
  907. * @brief Enable external clock source (LSE bypass).
  908. * @rmtoll CSR LSEBYP LL_RCC_LSE_EnableBypass
  909. * @retval None
  910. */
  911. __STATIC_INLINE void LL_RCC_LSE_EnableBypass(void)
  912. {
  913. SET_BIT(RCC->CSR, RCC_CSR_LSEBYP);
  914. }
  915. /**
  916. * @brief Disable external clock source (LSE bypass).
  917. * @rmtoll CSR LSEBYP LL_RCC_LSE_DisableBypass
  918. * @retval None
  919. */
  920. __STATIC_INLINE void LL_RCC_LSE_DisableBypass(void)
  921. {
  922. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEBYP);
  923. }
  924. /**
  925. * @brief Set LSE oscillator drive capability
  926. * @note The oscillator is in Xtal mode when it is not in bypass mode.
  927. * @rmtoll CSR LSEDRV LL_RCC_LSE_SetDriveCapability
  928. * @param LSEDrive This parameter can be one of the following values:
  929. * @arg @ref LL_RCC_LSEDRIVE_LOW
  930. * @arg @ref LL_RCC_LSEDRIVE_MEDIUMLOW
  931. * @arg @ref LL_RCC_LSEDRIVE_MEDIUMHIGH
  932. * @arg @ref LL_RCC_LSEDRIVE_HIGH
  933. * @retval None
  934. */
  935. __STATIC_INLINE void LL_RCC_LSE_SetDriveCapability(uint32_t LSEDrive)
  936. {
  937. MODIFY_REG(RCC->CSR, RCC_CSR_LSEDRV, LSEDrive);
  938. }
  939. /**
  940. * @brief Get LSE oscillator drive capability
  941. * @rmtoll CSR LSEDRV LL_RCC_LSE_GetDriveCapability
  942. * @retval Returned value can be one of the following values:
  943. * @arg @ref LL_RCC_LSEDRIVE_LOW
  944. * @arg @ref LL_RCC_LSEDRIVE_MEDIUMLOW
  945. * @arg @ref LL_RCC_LSEDRIVE_MEDIUMHIGH
  946. * @arg @ref LL_RCC_LSEDRIVE_HIGH
  947. */
  948. __STATIC_INLINE uint32_t LL_RCC_LSE_GetDriveCapability(void)
  949. {
  950. return (uint32_t)(READ_BIT(RCC->CSR, RCC_CSR_LSEDRV));
  951. }
  952. /**
  953. * @brief Enable Clock security system on LSE.
  954. * @rmtoll CSR LSECSSON LL_RCC_LSE_EnableCSS
  955. * @retval None
  956. */
  957. __STATIC_INLINE void LL_RCC_LSE_EnableCSS(void)
  958. {
  959. SET_BIT(RCC->CSR, RCC_CSR_LSECSSON);
  960. }
  961. /**
  962. * @brief Disable Clock security system on LSE.
  963. * @note Clock security system can be disabled only after a LSE
  964. * failure detection. In that case it MUST be disabled by software.
  965. * @rmtoll CSR LSECSSON LL_RCC_LSE_DisableCSS
  966. * @retval None
  967. */
  968. __STATIC_INLINE void LL_RCC_LSE_DisableCSS(void)
  969. {
  970. CLEAR_BIT(RCC->CSR, RCC_CSR_LSECSSON);
  971. }
  972. /**
  973. * @brief Check if LSE oscillator Ready
  974. * @rmtoll CSR LSERDY LL_RCC_LSE_IsReady
  975. * @retval State of bit (1 or 0).
  976. */
  977. __STATIC_INLINE uint32_t LL_RCC_LSE_IsReady(void)
  978. {
  979. return ((READ_BIT(RCC->CSR, RCC_CSR_LSERDY) == RCC_CSR_LSERDY) ? 1UL : 0UL);
  980. }
  981. /**
  982. * @brief Check if CSS on LSE failure Detection
  983. * @rmtoll CSR LSECSSD LL_RCC_LSE_IsCSSDetected
  984. * @retval State of bit (1 or 0).
  985. */
  986. __STATIC_INLINE uint32_t LL_RCC_LSE_IsCSSDetected(void)
  987. {
  988. return ((READ_BIT(RCC->CSR, RCC_CSR_LSECSSD) == RCC_CSR_LSECSSD) ? 1UL : 0UL);
  989. }
  990. /**
  991. * @}
  992. */
  993. /** @defgroup RCC_LL_EF_LSI LSI
  994. * @{
  995. */
  996. /**
  997. * @brief Enable LSI Oscillator
  998. * @rmtoll CSR LSION LL_RCC_LSI_Enable
  999. * @retval None
  1000. */
  1001. __STATIC_INLINE void LL_RCC_LSI_Enable(void)
  1002. {
  1003. SET_BIT(RCC->CSR, RCC_CSR_LSION);
  1004. }
  1005. /**
  1006. * @brief Disable LSI Oscillator
  1007. * @rmtoll CSR LSION LL_RCC_LSI_Disable
  1008. * @retval None
  1009. */
  1010. __STATIC_INLINE void LL_RCC_LSI_Disable(void)
  1011. {
  1012. CLEAR_BIT(RCC->CSR, RCC_CSR_LSION);
  1013. }
  1014. /**
  1015. * @brief Check if LSI is Ready
  1016. * @rmtoll CSR LSIRDY LL_RCC_LSI_IsReady
  1017. * @retval State of bit (1 or 0).
  1018. */
  1019. __STATIC_INLINE uint32_t LL_RCC_LSI_IsReady(void)
  1020. {
  1021. return ((READ_BIT(RCC->CSR, RCC_CSR_LSIRDY) == RCC_CSR_LSIRDY) ? 1UL : 0UL);
  1022. }
  1023. /**
  1024. * @}
  1025. */
  1026. /** @defgroup RCC_LL_EF_MSI MSI
  1027. * @{
  1028. */
  1029. /**
  1030. * @brief Enable MSI oscillator
  1031. * @rmtoll CR MSION LL_RCC_MSI_Enable
  1032. * @retval None
  1033. */
  1034. __STATIC_INLINE void LL_RCC_MSI_Enable(void)
  1035. {
  1036. SET_BIT(RCC->CR, RCC_CR_MSION);
  1037. }
  1038. /**
  1039. * @brief Disable MSI oscillator
  1040. * @rmtoll CR MSION LL_RCC_MSI_Disable
  1041. * @retval None
  1042. */
  1043. __STATIC_INLINE void LL_RCC_MSI_Disable(void)
  1044. {
  1045. CLEAR_BIT(RCC->CR, RCC_CR_MSION);
  1046. }
  1047. /**
  1048. * @brief Check if MSI oscillator Ready
  1049. * @rmtoll CR MSIRDY LL_RCC_MSI_IsReady
  1050. * @retval State of bit (1 or 0).
  1051. */
  1052. __STATIC_INLINE uint32_t LL_RCC_MSI_IsReady(void)
  1053. {
  1054. return ((READ_BIT(RCC->CR, RCC_CR_MSIRDY) == RCC_CR_MSIRDY) ? 1UL : 0UL);
  1055. }
  1056. /**
  1057. * @brief Configure the Internal Multi Speed oscillator (MSI) clock range in run mode.
  1058. * @rmtoll ICSCR MSIRANGE LL_RCC_MSI_SetRange
  1059. * @param Range This parameter can be one of the following values:
  1060. * @arg @ref LL_RCC_MSIRANGE_0
  1061. * @arg @ref LL_RCC_MSIRANGE_1
  1062. * @arg @ref LL_RCC_MSIRANGE_2
  1063. * @arg @ref LL_RCC_MSIRANGE_3
  1064. * @arg @ref LL_RCC_MSIRANGE_4
  1065. * @arg @ref LL_RCC_MSIRANGE_5
  1066. * @arg @ref LL_RCC_MSIRANGE_6
  1067. * @retval None
  1068. */
  1069. __STATIC_INLINE void LL_RCC_MSI_SetRange(uint32_t Range)
  1070. {
  1071. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_MSIRANGE, Range);
  1072. }
  1073. /**
  1074. * @brief Get the Internal Multi Speed oscillator (MSI) clock range in run mode.
  1075. * @rmtoll ICSCR MSIRANGE LL_RCC_MSI_GetRange
  1076. * @retval Returned value can be one of the following values:
  1077. * @arg @ref LL_RCC_MSIRANGE_0
  1078. * @arg @ref LL_RCC_MSIRANGE_1
  1079. * @arg @ref LL_RCC_MSIRANGE_2
  1080. * @arg @ref LL_RCC_MSIRANGE_3
  1081. * @arg @ref LL_RCC_MSIRANGE_4
  1082. * @arg @ref LL_RCC_MSIRANGE_5
  1083. * @arg @ref LL_RCC_MSIRANGE_6
  1084. */
  1085. __STATIC_INLINE uint32_t LL_RCC_MSI_GetRange(void)
  1086. {
  1087. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSIRANGE));
  1088. }
  1089. /**
  1090. * @brief Get MSI Calibration value
  1091. * @note When MSITRIM is written, MSICAL is updated with the sum of
  1092. * MSITRIM and the factory trim value
  1093. * @rmtoll ICSCR MSICAL LL_RCC_MSI_GetCalibration
  1094. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  1095. */
  1096. __STATIC_INLINE uint32_t LL_RCC_MSI_GetCalibration(void)
  1097. {
  1098. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSICAL) >> RCC_ICSCR_MSICAL_Pos);
  1099. }
  1100. /**
  1101. * @brief Set MSI Calibration trimming
  1102. * @note user-programmable trimming value that is added to the MSICAL
  1103. * @rmtoll ICSCR MSITRIM LL_RCC_MSI_SetCalibTrimming
  1104. * @param Value between Min_Data = 0x00 and Max_Data = 0xFF
  1105. * @retval None
  1106. */
  1107. __STATIC_INLINE void LL_RCC_MSI_SetCalibTrimming(uint32_t Value)
  1108. {
  1109. MODIFY_REG(RCC->ICSCR, RCC_ICSCR_MSITRIM, Value << RCC_ICSCR_MSITRIM_Pos);
  1110. }
  1111. /**
  1112. * @brief Get MSI Calibration trimming
  1113. * @rmtoll ICSCR MSITRIM LL_RCC_MSI_GetCalibTrimming
  1114. * @retval Between Min_Data = 0x00 and Max_Data = 0xFF
  1115. */
  1116. __STATIC_INLINE uint32_t LL_RCC_MSI_GetCalibTrimming(void)
  1117. {
  1118. return (uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSITRIM) >> RCC_ICSCR_MSITRIM_Pos);
  1119. }
  1120. /**
  1121. * @}
  1122. */
  1123. /** @defgroup RCC_LL_EF_System System
  1124. * @{
  1125. */
  1126. /**
  1127. * @brief Configure the system clock source
  1128. * @rmtoll CFGR SW LL_RCC_SetSysClkSource
  1129. * @param Source This parameter can be one of the following values:
  1130. * @arg @ref LL_RCC_SYS_CLKSOURCE_MSI
  1131. * @arg @ref LL_RCC_SYS_CLKSOURCE_HSI
  1132. * @arg @ref LL_RCC_SYS_CLKSOURCE_HSE
  1133. * @arg @ref LL_RCC_SYS_CLKSOURCE_PLL
  1134. * @retval None
  1135. */
  1136. __STATIC_INLINE void LL_RCC_SetSysClkSource(uint32_t Source)
  1137. {
  1138. MODIFY_REG(RCC->CFGR, RCC_CFGR_SW, Source);
  1139. }
  1140. /**
  1141. * @brief Get the system clock source
  1142. * @rmtoll CFGR SWS LL_RCC_GetSysClkSource
  1143. * @retval Returned value can be one of the following values:
  1144. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_MSI
  1145. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_HSI
  1146. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_HSE
  1147. * @arg @ref LL_RCC_SYS_CLKSOURCE_STATUS_PLL
  1148. */
  1149. __STATIC_INLINE uint32_t LL_RCC_GetSysClkSource(void)
  1150. {
  1151. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_SWS));
  1152. }
  1153. /**
  1154. * @brief Set AHB prescaler
  1155. * @rmtoll CFGR HPRE LL_RCC_SetAHBPrescaler
  1156. * @param Prescaler This parameter can be one of the following values:
  1157. * @arg @ref LL_RCC_SYSCLK_DIV_1
  1158. * @arg @ref LL_RCC_SYSCLK_DIV_2
  1159. * @arg @ref LL_RCC_SYSCLK_DIV_4
  1160. * @arg @ref LL_RCC_SYSCLK_DIV_8
  1161. * @arg @ref LL_RCC_SYSCLK_DIV_16
  1162. * @arg @ref LL_RCC_SYSCLK_DIV_64
  1163. * @arg @ref LL_RCC_SYSCLK_DIV_128
  1164. * @arg @ref LL_RCC_SYSCLK_DIV_256
  1165. * @arg @ref LL_RCC_SYSCLK_DIV_512
  1166. * @retval None
  1167. */
  1168. __STATIC_INLINE void LL_RCC_SetAHBPrescaler(uint32_t Prescaler)
  1169. {
  1170. MODIFY_REG(RCC->CFGR, RCC_CFGR_HPRE, Prescaler);
  1171. }
  1172. /**
  1173. * @brief Set APB1 prescaler
  1174. * @rmtoll CFGR PPRE1 LL_RCC_SetAPB1Prescaler
  1175. * @param Prescaler This parameter can be one of the following values:
  1176. * @arg @ref LL_RCC_APB1_DIV_1
  1177. * @arg @ref LL_RCC_APB1_DIV_2
  1178. * @arg @ref LL_RCC_APB1_DIV_4
  1179. * @arg @ref LL_RCC_APB1_DIV_8
  1180. * @arg @ref LL_RCC_APB1_DIV_16
  1181. * @retval None
  1182. */
  1183. __STATIC_INLINE void LL_RCC_SetAPB1Prescaler(uint32_t Prescaler)
  1184. {
  1185. MODIFY_REG(RCC->CFGR, RCC_CFGR_PPRE1, Prescaler);
  1186. }
  1187. /**
  1188. * @brief Set APB2 prescaler
  1189. * @rmtoll CFGR PPRE2 LL_RCC_SetAPB2Prescaler
  1190. * @param Prescaler This parameter can be one of the following values:
  1191. * @arg @ref LL_RCC_APB2_DIV_1
  1192. * @arg @ref LL_RCC_APB2_DIV_2
  1193. * @arg @ref LL_RCC_APB2_DIV_4
  1194. * @arg @ref LL_RCC_APB2_DIV_8
  1195. * @arg @ref LL_RCC_APB2_DIV_16
  1196. * @retval None
  1197. */
  1198. __STATIC_INLINE void LL_RCC_SetAPB2Prescaler(uint32_t Prescaler)
  1199. {
  1200. MODIFY_REG(RCC->CFGR, RCC_CFGR_PPRE2, Prescaler);
  1201. }
  1202. /**
  1203. * @brief Get AHB prescaler
  1204. * @rmtoll CFGR HPRE LL_RCC_GetAHBPrescaler
  1205. * @retval Returned value can be one of the following values:
  1206. * @arg @ref LL_RCC_SYSCLK_DIV_1
  1207. * @arg @ref LL_RCC_SYSCLK_DIV_2
  1208. * @arg @ref LL_RCC_SYSCLK_DIV_4
  1209. * @arg @ref LL_RCC_SYSCLK_DIV_8
  1210. * @arg @ref LL_RCC_SYSCLK_DIV_16
  1211. * @arg @ref LL_RCC_SYSCLK_DIV_64
  1212. * @arg @ref LL_RCC_SYSCLK_DIV_128
  1213. * @arg @ref LL_RCC_SYSCLK_DIV_256
  1214. * @arg @ref LL_RCC_SYSCLK_DIV_512
  1215. */
  1216. __STATIC_INLINE uint32_t LL_RCC_GetAHBPrescaler(void)
  1217. {
  1218. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_HPRE));
  1219. }
  1220. /**
  1221. * @brief Get APB1 prescaler
  1222. * @rmtoll CFGR PPRE1 LL_RCC_GetAPB1Prescaler
  1223. * @retval Returned value can be one of the following values:
  1224. * @arg @ref LL_RCC_APB1_DIV_1
  1225. * @arg @ref LL_RCC_APB1_DIV_2
  1226. * @arg @ref LL_RCC_APB1_DIV_4
  1227. * @arg @ref LL_RCC_APB1_DIV_8
  1228. * @arg @ref LL_RCC_APB1_DIV_16
  1229. */
  1230. __STATIC_INLINE uint32_t LL_RCC_GetAPB1Prescaler(void)
  1231. {
  1232. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PPRE1));
  1233. }
  1234. /**
  1235. * @brief Get APB2 prescaler
  1236. * @rmtoll CFGR PPRE2 LL_RCC_GetAPB2Prescaler
  1237. * @retval Returned value can be one of the following values:
  1238. * @arg @ref LL_RCC_APB2_DIV_1
  1239. * @arg @ref LL_RCC_APB2_DIV_2
  1240. * @arg @ref LL_RCC_APB2_DIV_4
  1241. * @arg @ref LL_RCC_APB2_DIV_8
  1242. * @arg @ref LL_RCC_APB2_DIV_16
  1243. */
  1244. __STATIC_INLINE uint32_t LL_RCC_GetAPB2Prescaler(void)
  1245. {
  1246. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PPRE2));
  1247. }
  1248. /**
  1249. * @brief Set Clock After Wake-Up From Stop mode
  1250. * @rmtoll CFGR STOPWUCK LL_RCC_SetClkAfterWakeFromStop
  1251. * @param Clock This parameter can be one of the following values:
  1252. * @arg @ref LL_RCC_STOP_WAKEUPCLOCK_MSI
  1253. * @arg @ref LL_RCC_STOP_WAKEUPCLOCK_HSI
  1254. * @retval None
  1255. */
  1256. __STATIC_INLINE void LL_RCC_SetClkAfterWakeFromStop(uint32_t Clock)
  1257. {
  1258. MODIFY_REG(RCC->CFGR, RCC_CFGR_STOPWUCK, Clock);
  1259. }
  1260. /**
  1261. * @brief Get Clock After Wake-Up From Stop mode
  1262. * @rmtoll CFGR STOPWUCK LL_RCC_GetClkAfterWakeFromStop
  1263. * @retval Returned value can be one of the following values:
  1264. * @arg @ref LL_RCC_STOP_WAKEUPCLOCK_MSI
  1265. * @arg @ref LL_RCC_STOP_WAKEUPCLOCK_HSI
  1266. */
  1267. __STATIC_INLINE uint32_t LL_RCC_GetClkAfterWakeFromStop(void)
  1268. {
  1269. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_STOPWUCK));
  1270. }
  1271. /**
  1272. * @}
  1273. */
  1274. /** @defgroup RCC_LL_EF_MCO MCO
  1275. * @{
  1276. */
  1277. /**
  1278. * @brief Configure MCOx
  1279. * @rmtoll CFGR MCOSEL LL_RCC_ConfigMCO\n
  1280. * CFGR MCOPRE LL_RCC_ConfigMCO
  1281. * @param MCOxSource This parameter can be one of the following values:
  1282. * @arg @ref LL_RCC_MCO1SOURCE_NOCLOCK
  1283. * @arg @ref LL_RCC_MCO1SOURCE_SYSCLK
  1284. * @arg @ref LL_RCC_MCO1SOURCE_HSI
  1285. * @arg @ref LL_RCC_MCO1SOURCE_MSI
  1286. * @arg @ref LL_RCC_MCO1SOURCE_HSE
  1287. * @arg @ref LL_RCC_MCO1SOURCE_PLLCLK
  1288. * @arg @ref LL_RCC_MCO1SOURCE_LSI
  1289. * @arg @ref LL_RCC_MCO1SOURCE_LSE
  1290. * @arg @ref LL_RCC_MCO1SOURCE_HSI48 (*)
  1291. *
  1292. * (*) value not defined in all devices.
  1293. * @param MCOxPrescaler This parameter can be one of the following values:
  1294. * @arg @ref LL_RCC_MCO1_DIV_1
  1295. * @arg @ref LL_RCC_MCO1_DIV_2
  1296. * @arg @ref LL_RCC_MCO1_DIV_4
  1297. * @arg @ref LL_RCC_MCO1_DIV_8
  1298. * @arg @ref LL_RCC_MCO1_DIV_16
  1299. * @retval None
  1300. */
  1301. __STATIC_INLINE void LL_RCC_ConfigMCO(uint32_t MCOxSource, uint32_t MCOxPrescaler)
  1302. {
  1303. MODIFY_REG(RCC->CFGR, RCC_CFGR_MCOSEL | RCC_CFGR_MCOPRE, MCOxSource | MCOxPrescaler);
  1304. }
  1305. /**
  1306. * @}
  1307. */
  1308. /** @defgroup RCC_LL_EF_Peripheral_Clock_Source Peripheral Clock Source
  1309. * @{
  1310. */
  1311. /**
  1312. * @brief Configure USARTx clock source
  1313. * @rmtoll CCIPR USARTxSEL LL_RCC_SetUSARTClockSource
  1314. * @param USARTxSource This parameter can be one of the following values:
  1315. * @arg @ref LL_RCC_USART1_CLKSOURCE_PCLK2 (*)
  1316. * @arg @ref LL_RCC_USART1_CLKSOURCE_SYSCLK (*)
  1317. * @arg @ref LL_RCC_USART1_CLKSOURCE_HSI (*)
  1318. * @arg @ref LL_RCC_USART1_CLKSOURCE_LSE (*)
  1319. * @arg @ref LL_RCC_USART2_CLKSOURCE_PCLK1
  1320. * @arg @ref LL_RCC_USART2_CLKSOURCE_SYSCLK
  1321. * @arg @ref LL_RCC_USART2_CLKSOURCE_HSI
  1322. * @arg @ref LL_RCC_USART2_CLKSOURCE_LSE
  1323. *
  1324. * (*) value not defined in all devices.
  1325. * @retval None
  1326. */
  1327. __STATIC_INLINE void LL_RCC_SetUSARTClockSource(uint32_t USARTxSource)
  1328. {
  1329. MODIFY_REG(RCC->CCIPR, (USARTxSource >> 16U), (USARTxSource & 0x0000FFFFU));
  1330. }
  1331. /**
  1332. * @brief Configure LPUART1x clock source
  1333. * @rmtoll CCIPR LPUART1SEL LL_RCC_SetLPUARTClockSource
  1334. * @param LPUARTxSource This parameter can be one of the following values:
  1335. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_PCLK1
  1336. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_SYSCLK
  1337. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_HSI
  1338. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_LSE
  1339. * @retval None
  1340. */
  1341. __STATIC_INLINE void LL_RCC_SetLPUARTClockSource(uint32_t LPUARTxSource)
  1342. {
  1343. MODIFY_REG(RCC->CCIPR, RCC_CCIPR_LPUART1SEL, LPUARTxSource);
  1344. }
  1345. /**
  1346. * @brief Configure I2Cx clock source
  1347. * @rmtoll CCIPR I2CxSEL LL_RCC_SetI2CClockSource
  1348. * @param I2CxSource This parameter can be one of the following values:
  1349. * @arg @ref LL_RCC_I2C1_CLKSOURCE_PCLK1
  1350. * @arg @ref LL_RCC_I2C1_CLKSOURCE_SYSCLK
  1351. * @arg @ref LL_RCC_I2C1_CLKSOURCE_HSI
  1352. * @arg @ref LL_RCC_I2C3_CLKSOURCE_PCLK1 (*)
  1353. * @arg @ref LL_RCC_I2C3_CLKSOURCE_SYSCLK (*)
  1354. * @arg @ref LL_RCC_I2C3_CLKSOURCE_HSI (*)
  1355. *
  1356. * (*) value not defined in all devices.
  1357. * @retval None
  1358. */
  1359. __STATIC_INLINE void LL_RCC_SetI2CClockSource(uint32_t I2CxSource)
  1360. {
  1361. MODIFY_REG(RCC->CCIPR, ((I2CxSource >> 4U) & 0x000FF000U), ((I2CxSource << 4U) & 0x000FF000U));
  1362. }
  1363. /**
  1364. * @brief Configure LPTIMx clock source
  1365. * @rmtoll CCIPR LPTIMxSEL LL_RCC_SetLPTIMClockSource
  1366. * @param LPTIMxSource This parameter can be one of the following values:
  1367. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_PCLK1
  1368. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_LSI
  1369. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_HSI
  1370. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_LSE
  1371. * @retval None
  1372. */
  1373. __STATIC_INLINE void LL_RCC_SetLPTIMClockSource(uint32_t LPTIMxSource)
  1374. {
  1375. MODIFY_REG(RCC->CCIPR, RCC_CCIPR_LPTIM1SEL, LPTIMxSource);
  1376. }
  1377. #if defined(RCC_CCIPR_HSI48SEL)
  1378. #if defined(RNG)
  1379. /**
  1380. * @brief Configure RNG clock source
  1381. * @rmtoll CCIPR HSI48SEL LL_RCC_SetRNGClockSource
  1382. * @param RNGxSource This parameter can be one of the following values:
  1383. * @arg @ref LL_RCC_RNG_CLKSOURCE_PLL
  1384. * @arg @ref LL_RCC_RNG_CLKSOURCE_HSI48
  1385. * @retval None
  1386. */
  1387. __STATIC_INLINE void LL_RCC_SetRNGClockSource(uint32_t RNGxSource)
  1388. {
  1389. MODIFY_REG(RCC->CCIPR, RCC_CCIPR_HSI48SEL, RNGxSource);
  1390. }
  1391. #endif /* RNG */
  1392. #if defined(USB)
  1393. /**
  1394. * @brief Configure USB clock source
  1395. * @rmtoll CCIPR HSI48SEL LL_RCC_SetUSBClockSource
  1396. * @param USBxSource This parameter can be one of the following values:
  1397. * @arg @ref LL_RCC_RNG_CLKSOURCE_PLL
  1398. * @arg @ref LL_RCC_RNG_CLKSOURCE_HSI48
  1399. * @retval None
  1400. */
  1401. __STATIC_INLINE void LL_RCC_SetUSBClockSource(uint32_t USBxSource)
  1402. {
  1403. MODIFY_REG(RCC->CCIPR, RCC_CCIPR_HSI48SEL, USBxSource);
  1404. }
  1405. #endif /* USB */
  1406. #endif /* RCC_CCIPR_HSI48SEL */
  1407. /**
  1408. * @brief Get USARTx clock source
  1409. * @rmtoll CCIPR USARTxSEL LL_RCC_GetUSARTClockSource
  1410. * @param USARTx This parameter can be one of the following values:
  1411. * @arg @ref LL_RCC_USART1_CLKSOURCE (*)
  1412. * @arg @ref LL_RCC_USART2_CLKSOURCE
  1413. * @retval Returned value can be one of the following values:
  1414. * @arg @ref LL_RCC_USART1_CLKSOURCE_PCLK2 (*)
  1415. * @arg @ref LL_RCC_USART1_CLKSOURCE_SYSCLK (*)
  1416. * @arg @ref LL_RCC_USART1_CLKSOURCE_HSI (*)
  1417. * @arg @ref LL_RCC_USART1_CLKSOURCE_LSE (*)
  1418. * @arg @ref LL_RCC_USART2_CLKSOURCE_PCLK1
  1419. * @arg @ref LL_RCC_USART2_CLKSOURCE_SYSCLK
  1420. * @arg @ref LL_RCC_USART2_CLKSOURCE_HSI
  1421. * @arg @ref LL_RCC_USART2_CLKSOURCE_LSE
  1422. *
  1423. * (*) value not defined in all devices.
  1424. */
  1425. __STATIC_INLINE uint32_t LL_RCC_GetUSARTClockSource(uint32_t USARTx)
  1426. {
  1427. return (uint32_t)(READ_BIT(RCC->CCIPR, USARTx) | (USARTx << 16U));
  1428. }
  1429. /**
  1430. * @brief Get LPUARTx clock source
  1431. * @rmtoll CCIPR LPUART1SEL LL_RCC_GetLPUARTClockSource
  1432. * @param LPUARTx This parameter can be one of the following values:
  1433. * @arg @ref LL_RCC_LPUART1_CLKSOURCE
  1434. * @retval Returned value can be one of the following values:
  1435. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_PCLK1
  1436. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_SYSCLK
  1437. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_HSI
  1438. * @arg @ref LL_RCC_LPUART1_CLKSOURCE_LSE
  1439. */
  1440. __STATIC_INLINE uint32_t LL_RCC_GetLPUARTClockSource(uint32_t LPUARTx)
  1441. {
  1442. return (uint32_t)(READ_BIT(RCC->CCIPR, LPUARTx));
  1443. }
  1444. /**
  1445. * @brief Get I2Cx clock source
  1446. * @rmtoll CCIPR I2CxSEL LL_RCC_GetI2CClockSource
  1447. * @param I2Cx This parameter can be one of the following values:
  1448. * @arg @ref LL_RCC_I2C1_CLKSOURCE
  1449. * @arg @ref LL_RCC_I2C3_CLKSOURCE
  1450. * @retval Returned value can be one of the following values:
  1451. * @arg @ref LL_RCC_I2C1_CLKSOURCE_PCLK1
  1452. * @arg @ref LL_RCC_I2C1_CLKSOURCE_SYSCLK
  1453. * @arg @ref LL_RCC_I2C1_CLKSOURCE_HSI
  1454. * @arg @ref LL_RCC_I2C3_CLKSOURCE_PCLK1 (*)
  1455. * @arg @ref LL_RCC_I2C3_CLKSOURCE_SYSCLK (*)
  1456. * @arg @ref LL_RCC_I2C3_CLKSOURCE_HSI (*)
  1457. *
  1458. * (*) value not defined in all devices.
  1459. */
  1460. __STATIC_INLINE uint32_t LL_RCC_GetI2CClockSource(uint32_t I2Cx)
  1461. {
  1462. return (uint32_t)((READ_BIT(RCC->CCIPR, I2Cx) >> 4U) | (I2Cx << 4U));
  1463. }
  1464. /**
  1465. * @brief Get LPTIMx clock source
  1466. * @rmtoll CCIPR LPTIMxSEL LL_RCC_GetLPTIMClockSource
  1467. * @param LPTIMx This parameter can be one of the following values:
  1468. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE
  1469. * @retval Returned value can be one of the following values:
  1470. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_PCLK1
  1471. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_LSI
  1472. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_HSI
  1473. * @arg @ref LL_RCC_LPTIM1_CLKSOURCE_LSE
  1474. */
  1475. __STATIC_INLINE uint32_t LL_RCC_GetLPTIMClockSource(uint32_t LPTIMx)
  1476. {
  1477. return (uint32_t)(READ_BIT(RCC->CCIPR, LPTIMx));
  1478. }
  1479. #if defined(RCC_CCIPR_HSI48SEL)
  1480. #if defined(RNG)
  1481. /**
  1482. * @brief Get RNGx clock source
  1483. * @rmtoll CCIPR CLK48SEL LL_RCC_GetRNGClockSource
  1484. * @param RNGx This parameter can be one of the following values:
  1485. * @arg @ref LL_RCC_RNG_CLKSOURCE
  1486. * @retval Returned value can be one of the following values:
  1487. * @arg @ref LL_RCC_RNG_CLKSOURCE_PLL
  1488. * @arg @ref LL_RCC_RNG_CLKSOURCE_HSI48
  1489. */
  1490. __STATIC_INLINE uint32_t LL_RCC_GetRNGClockSource(uint32_t RNGx)
  1491. {
  1492. return (uint32_t)(READ_BIT(RCC->CCIPR, RNGx));
  1493. }
  1494. #endif /* RNG */
  1495. #if defined(USB)
  1496. /**
  1497. * @brief Get USBx clock source
  1498. * @rmtoll CCIPR CLK48SEL LL_RCC_GetUSBClockSource
  1499. * @param USBx This parameter can be one of the following values:
  1500. * @arg @ref LL_RCC_USB_CLKSOURCE
  1501. * @retval Returned value can be one of the following values:
  1502. * @arg @ref LL_RCC_USB_CLKSOURCE_PLL
  1503. * @arg @ref LL_RCC_USB_CLKSOURCE_HSI48
  1504. */
  1505. __STATIC_INLINE uint32_t LL_RCC_GetUSBClockSource(uint32_t USBx)
  1506. {
  1507. return (uint32_t)(READ_BIT(RCC->CCIPR, USBx));
  1508. }
  1509. #endif /* USB */
  1510. #endif /* RCC_CCIPR_HSI48SEL */
  1511. /**
  1512. * @}
  1513. */
  1514. /** @defgroup RCC_LL_EF_RTC RTC
  1515. * @{
  1516. */
  1517. /**
  1518. * @brief Set RTC Clock Source
  1519. * @note Once the RTC clock source has been selected, it cannot be changed any more unless
  1520. * the Backup domain is reset, or unless a failure is detected on LSE (LSECSSD is
  1521. * set). The RTCRST bit can be used to reset them.
  1522. * @rmtoll CSR RTCSEL LL_RCC_SetRTCClockSource
  1523. * @param Source This parameter can be one of the following values:
  1524. * @arg @ref LL_RCC_RTC_CLKSOURCE_NONE
  1525. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSE
  1526. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSI
  1527. * @arg @ref LL_RCC_RTC_CLKSOURCE_HSE
  1528. * @retval None
  1529. */
  1530. __STATIC_INLINE void LL_RCC_SetRTCClockSource(uint32_t Source)
  1531. {
  1532. MODIFY_REG(RCC->CSR, RCC_CSR_RTCSEL, Source);
  1533. }
  1534. /**
  1535. * @brief Get RTC Clock Source
  1536. * @rmtoll CSR RTCSEL LL_RCC_GetRTCClockSource
  1537. * @retval Returned value can be one of the following values:
  1538. * @arg @ref LL_RCC_RTC_CLKSOURCE_NONE
  1539. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSE
  1540. * @arg @ref LL_RCC_RTC_CLKSOURCE_LSI
  1541. * @arg @ref LL_RCC_RTC_CLKSOURCE_HSE
  1542. */
  1543. __STATIC_INLINE uint32_t LL_RCC_GetRTCClockSource(void)
  1544. {
  1545. return (uint32_t)(READ_BIT(RCC->CSR, RCC_CSR_RTCSEL));
  1546. }
  1547. /**
  1548. * @brief Enable RTC
  1549. * @rmtoll CSR RTCEN LL_RCC_EnableRTC
  1550. * @retval None
  1551. */
  1552. __STATIC_INLINE void LL_RCC_EnableRTC(void)
  1553. {
  1554. SET_BIT(RCC->CSR, RCC_CSR_RTCEN);
  1555. }
  1556. /**
  1557. * @brief Disable RTC
  1558. * @rmtoll CSR RTCEN LL_RCC_DisableRTC
  1559. * @retval None
  1560. */
  1561. __STATIC_INLINE void LL_RCC_DisableRTC(void)
  1562. {
  1563. CLEAR_BIT(RCC->CSR, RCC_CSR_RTCEN);
  1564. }
  1565. /**
  1566. * @brief Check if RTC has been enabled or not
  1567. * @rmtoll CSR RTCEN LL_RCC_IsEnabledRTC
  1568. * @retval State of bit (1 or 0).
  1569. */
  1570. __STATIC_INLINE uint32_t LL_RCC_IsEnabledRTC(void)
  1571. {
  1572. return ((READ_BIT(RCC->CSR, RCC_CSR_RTCEN) == RCC_CSR_RTCEN) ? 1UL : 0UL);
  1573. }
  1574. /**
  1575. * @brief Force the Backup domain reset
  1576. * @rmtoll CSR RTCRST LL_RCC_ForceBackupDomainReset
  1577. * @retval None
  1578. */
  1579. __STATIC_INLINE void LL_RCC_ForceBackupDomainReset(void)
  1580. {
  1581. SET_BIT(RCC->CSR, RCC_CSR_RTCRST);
  1582. }
  1583. /**
  1584. * @brief Release the Backup domain reset
  1585. * @rmtoll CSR RTCRST LL_RCC_ReleaseBackupDomainReset
  1586. * @retval None
  1587. */
  1588. __STATIC_INLINE void LL_RCC_ReleaseBackupDomainReset(void)
  1589. {
  1590. CLEAR_BIT(RCC->CSR, RCC_CSR_RTCRST);
  1591. }
  1592. /**
  1593. * @}
  1594. */
  1595. /** @defgroup RCC_LL_EF_PLL PLL
  1596. * @{
  1597. */
  1598. /**
  1599. * @brief Enable PLL
  1600. * @rmtoll CR PLLON LL_RCC_PLL_Enable
  1601. * @retval None
  1602. */
  1603. __STATIC_INLINE void LL_RCC_PLL_Enable(void)
  1604. {
  1605. SET_BIT(RCC->CR, RCC_CR_PLLON);
  1606. }
  1607. /**
  1608. * @brief Disable PLL
  1609. * @note Cannot be disabled if the PLL clock is used as the system clock
  1610. * @rmtoll CR PLLON LL_RCC_PLL_Disable
  1611. * @retval None
  1612. */
  1613. __STATIC_INLINE void LL_RCC_PLL_Disable(void)
  1614. {
  1615. CLEAR_BIT(RCC->CR, RCC_CR_PLLON);
  1616. }
  1617. /**
  1618. * @brief Check if PLL Ready
  1619. * @rmtoll CR PLLRDY LL_RCC_PLL_IsReady
  1620. * @retval State of bit (1 or 0).
  1621. */
  1622. __STATIC_INLINE uint32_t LL_RCC_PLL_IsReady(void)
  1623. {
  1624. return ((READ_BIT(RCC->CR, RCC_CR_PLLRDY) == RCC_CR_PLLRDY) ? 1UL : 0UL);
  1625. }
  1626. /**
  1627. * @brief Configure PLL used for SYSCLK Domain
  1628. * @rmtoll CFGR PLLSRC LL_RCC_PLL_ConfigDomain_SYS\n
  1629. * CFGR PLLMUL LL_RCC_PLL_ConfigDomain_SYS\n
  1630. * CFGR PLLDIV LL_RCC_PLL_ConfigDomain_SYS
  1631. * @param Source This parameter can be one of the following values:
  1632. * @arg @ref LL_RCC_PLLSOURCE_HSI
  1633. * @arg @ref LL_RCC_PLLSOURCE_HSE
  1634. * @param PLLMul This parameter can be one of the following values:
  1635. * @arg @ref LL_RCC_PLL_MUL_3
  1636. * @arg @ref LL_RCC_PLL_MUL_4
  1637. * @arg @ref LL_RCC_PLL_MUL_6
  1638. * @arg @ref LL_RCC_PLL_MUL_8
  1639. * @arg @ref LL_RCC_PLL_MUL_12
  1640. * @arg @ref LL_RCC_PLL_MUL_16
  1641. * @arg @ref LL_RCC_PLL_MUL_24
  1642. * @arg @ref LL_RCC_PLL_MUL_32
  1643. * @arg @ref LL_RCC_PLL_MUL_48
  1644. * @param PLLDiv This parameter can be one of the following values:
  1645. * @arg @ref LL_RCC_PLL_DIV_2
  1646. * @arg @ref LL_RCC_PLL_DIV_3
  1647. * @arg @ref LL_RCC_PLL_DIV_4
  1648. * @retval None
  1649. */
  1650. __STATIC_INLINE void LL_RCC_PLL_ConfigDomain_SYS(uint32_t Source, uint32_t PLLMul, uint32_t PLLDiv)
  1651. {
  1652. MODIFY_REG(RCC->CFGR, RCC_CFGR_PLLSRC | RCC_CFGR_PLLMUL | RCC_CFGR_PLLDIV, Source | PLLMul | PLLDiv);
  1653. }
  1654. /**
  1655. * @brief Configure PLL clock source
  1656. * @rmtoll CFGR PLLSRC LL_RCC_PLL_SetMainSource
  1657. * @param PLLSource This parameter can be one of the following values:
  1658. * @arg @ref LL_RCC_PLLSOURCE_HSI
  1659. * @arg @ref LL_RCC_PLLSOURCE_HSE
  1660. * @retval None
  1661. */
  1662. __STATIC_INLINE void LL_RCC_PLL_SetMainSource(uint32_t PLLSource)
  1663. {
  1664. MODIFY_REG(RCC->CFGR, RCC_CFGR_PLLSRC, PLLSource);
  1665. }
  1666. /**
  1667. * @brief Get the oscillator used as PLL clock source.
  1668. * @rmtoll CFGR PLLSRC LL_RCC_PLL_GetMainSource
  1669. * @retval Returned value can be one of the following values:
  1670. * @arg @ref LL_RCC_PLLSOURCE_HSI
  1671. * @arg @ref LL_RCC_PLLSOURCE_HSE
  1672. */
  1673. __STATIC_INLINE uint32_t LL_RCC_PLL_GetMainSource(void)
  1674. {
  1675. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLSRC));
  1676. }
  1677. /**
  1678. * @brief Get PLL multiplication Factor
  1679. * @rmtoll CFGR PLLMUL LL_RCC_PLL_GetMultiplicator
  1680. * @retval Returned value can be one of the following values:
  1681. * @arg @ref LL_RCC_PLL_MUL_3
  1682. * @arg @ref LL_RCC_PLL_MUL_4
  1683. * @arg @ref LL_RCC_PLL_MUL_6
  1684. * @arg @ref LL_RCC_PLL_MUL_8
  1685. * @arg @ref LL_RCC_PLL_MUL_12
  1686. * @arg @ref LL_RCC_PLL_MUL_16
  1687. * @arg @ref LL_RCC_PLL_MUL_24
  1688. * @arg @ref LL_RCC_PLL_MUL_32
  1689. * @arg @ref LL_RCC_PLL_MUL_48
  1690. */
  1691. __STATIC_INLINE uint32_t LL_RCC_PLL_GetMultiplicator(void)
  1692. {
  1693. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLMUL));
  1694. }
  1695. /**
  1696. * @brief Get Division factor for the main PLL and other PLL
  1697. * @rmtoll CFGR PLLDIV LL_RCC_PLL_GetDivider
  1698. * @retval Returned value can be one of the following values:
  1699. * @arg @ref LL_RCC_PLL_DIV_2
  1700. * @arg @ref LL_RCC_PLL_DIV_3
  1701. * @arg @ref LL_RCC_PLL_DIV_4
  1702. */
  1703. __STATIC_INLINE uint32_t LL_RCC_PLL_GetDivider(void)
  1704. {
  1705. return (uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLDIV));
  1706. }
  1707. /**
  1708. * @}
  1709. */
  1710. /** @defgroup RCC_LL_EF_FLAG_Management FLAG Management
  1711. * @{
  1712. */
  1713. /**
  1714. * @brief Clear LSI ready interrupt flag
  1715. * @rmtoll CICR LSIRDYC LL_RCC_ClearFlag_LSIRDY
  1716. * @retval None
  1717. */
  1718. __STATIC_INLINE void LL_RCC_ClearFlag_LSIRDY(void)
  1719. {
  1720. SET_BIT(RCC->CICR, RCC_CICR_LSIRDYC);
  1721. }
  1722. /**
  1723. * @brief Clear LSE ready interrupt flag
  1724. * @rmtoll CICR LSERDYC LL_RCC_ClearFlag_LSERDY
  1725. * @retval None
  1726. */
  1727. __STATIC_INLINE void LL_RCC_ClearFlag_LSERDY(void)
  1728. {
  1729. SET_BIT(RCC->CICR, RCC_CICR_LSERDYC);
  1730. }
  1731. /**
  1732. * @brief Clear MSI ready interrupt flag
  1733. * @rmtoll CICR MSIRDYC LL_RCC_ClearFlag_MSIRDY
  1734. * @retval None
  1735. */
  1736. __STATIC_INLINE void LL_RCC_ClearFlag_MSIRDY(void)
  1737. {
  1738. SET_BIT(RCC->CICR, RCC_CICR_MSIRDYC);
  1739. }
  1740. /**
  1741. * @brief Clear HSI ready interrupt flag
  1742. * @rmtoll CICR HSIRDYC LL_RCC_ClearFlag_HSIRDY
  1743. * @retval None
  1744. */
  1745. __STATIC_INLINE void LL_RCC_ClearFlag_HSIRDY(void)
  1746. {
  1747. SET_BIT(RCC->CICR, RCC_CICR_HSIRDYC);
  1748. }
  1749. /**
  1750. * @brief Clear HSE ready interrupt flag
  1751. * @rmtoll CICR HSERDYC LL_RCC_ClearFlag_HSERDY
  1752. * @retval None
  1753. */
  1754. __STATIC_INLINE void LL_RCC_ClearFlag_HSERDY(void)
  1755. {
  1756. SET_BIT(RCC->CICR, RCC_CICR_HSERDYC);
  1757. }
  1758. /**
  1759. * @brief Clear PLL ready interrupt flag
  1760. * @rmtoll CICR PLLRDYC LL_RCC_ClearFlag_PLLRDY
  1761. * @retval None
  1762. */
  1763. __STATIC_INLINE void LL_RCC_ClearFlag_PLLRDY(void)
  1764. {
  1765. SET_BIT(RCC->CICR, RCC_CICR_PLLRDYC);
  1766. }
  1767. #if defined(RCC_HSI48_SUPPORT)
  1768. /**
  1769. * @brief Clear HSI48 ready interrupt flag
  1770. * @rmtoll CICR HSI48RDYC LL_RCC_ClearFlag_HSI48RDY
  1771. * @retval None
  1772. */
  1773. __STATIC_INLINE void LL_RCC_ClearFlag_HSI48RDY(void)
  1774. {
  1775. SET_BIT(RCC->CICR, RCC_CICR_HSI48RDYC);
  1776. }
  1777. #endif /* RCC_HSI48_SUPPORT */
  1778. #if defined(RCC_HSECSS_SUPPORT)
  1779. /**
  1780. * @brief Clear Clock security system interrupt flag
  1781. * @rmtoll CICR CSSC LL_RCC_ClearFlag_HSECSS
  1782. * @retval None
  1783. */
  1784. __STATIC_INLINE void LL_RCC_ClearFlag_HSECSS(void)
  1785. {
  1786. SET_BIT(RCC->CICR, RCC_CICR_CSSC);
  1787. }
  1788. #endif /* RCC_HSECSS_SUPPORT */
  1789. /**
  1790. * @brief Clear LSE Clock security system interrupt flag
  1791. * @rmtoll CICR LSECSSC LL_RCC_ClearFlag_LSECSS
  1792. * @retval None
  1793. */
  1794. __STATIC_INLINE void LL_RCC_ClearFlag_LSECSS(void)
  1795. {
  1796. SET_BIT(RCC->CICR, RCC_CICR_LSECSSC);
  1797. }
  1798. /**
  1799. * @brief Check if LSI ready interrupt occurred or not
  1800. * @rmtoll CIFR LSIRDYF LL_RCC_IsActiveFlag_LSIRDY
  1801. * @retval State of bit (1 or 0).
  1802. */
  1803. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSIRDY(void)
  1804. {
  1805. return ((READ_BIT(RCC->CIFR, RCC_CIFR_LSIRDYF) == RCC_CIFR_LSIRDYF) ? 1UL : 0UL);
  1806. }
  1807. /**
  1808. * @brief Check if LSE ready interrupt occurred or not
  1809. * @rmtoll CIFR LSERDYF LL_RCC_IsActiveFlag_LSERDY
  1810. * @retval State of bit (1 or 0).
  1811. */
  1812. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSERDY(void)
  1813. {
  1814. return ((READ_BIT(RCC->CIFR, RCC_CIFR_LSERDYF) == RCC_CIFR_LSERDYF) ? 1UL : 0UL);
  1815. }
  1816. /**
  1817. * @brief Check if MSI ready interrupt occurred or not
  1818. * @rmtoll CIFR MSIRDYF LL_RCC_IsActiveFlag_MSIRDY
  1819. * @retval State of bit (1 or 0).
  1820. */
  1821. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_MSIRDY(void)
  1822. {
  1823. return ((READ_BIT(RCC->CIFR, RCC_CIFR_MSIRDYF) == RCC_CIFR_MSIRDYF) ? 1UL : 0UL);
  1824. }
  1825. /**
  1826. * @brief Check if HSI ready interrupt occurred or not
  1827. * @rmtoll CIFR HSIRDYF LL_RCC_IsActiveFlag_HSIRDY
  1828. * @retval State of bit (1 or 0).
  1829. */
  1830. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSIRDY(void)
  1831. {
  1832. return ((READ_BIT(RCC->CIFR, RCC_CIFR_HSIRDYF) == RCC_CIFR_HSIRDYF) ? 1UL : 0UL);
  1833. }
  1834. /**
  1835. * @brief Check if HSE ready interrupt occurred or not
  1836. * @rmtoll CIFR HSERDYF LL_RCC_IsActiveFlag_HSERDY
  1837. * @retval State of bit (1 or 0).
  1838. */
  1839. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSERDY(void)
  1840. {
  1841. return ((READ_BIT(RCC->CIFR, RCC_CIFR_HSERDYF) == RCC_CIFR_HSERDYF) ? 1UL : 0UL);
  1842. }
  1843. /**
  1844. * @brief Check if PLL ready interrupt occurred or not
  1845. * @rmtoll CIFR PLLRDYF LL_RCC_IsActiveFlag_PLLRDY
  1846. * @retval State of bit (1 or 0).
  1847. */
  1848. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PLLRDY(void)
  1849. {
  1850. return ((READ_BIT(RCC->CIFR, RCC_CIFR_PLLRDYF) == RCC_CIFR_PLLRDYF) ? 1UL : 0UL);
  1851. }
  1852. #if defined(RCC_HSI48_SUPPORT)
  1853. /**
  1854. * @brief Check if HSI48 ready interrupt occurred or not
  1855. * @rmtoll CIFR HSI48RDYF LL_RCC_IsActiveFlag_HSI48RDY
  1856. * @retval State of bit (1 or 0).
  1857. */
  1858. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSI48RDY(void)
  1859. {
  1860. return ((READ_BIT(RCC->CIFR, RCC_CIFR_HSI48RDYF) == RCC_CIFR_HSI48RDYF) ? 1UL : 0UL);
  1861. }
  1862. #endif /* RCC_HSI48_SUPPORT */
  1863. #if defined(RCC_HSECSS_SUPPORT)
  1864. /**
  1865. * @brief Check if Clock security system interrupt occurred or not
  1866. * @rmtoll CIFR CSSF LL_RCC_IsActiveFlag_HSECSS
  1867. * @retval State of bit (1 or 0).
  1868. */
  1869. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSECSS(void)
  1870. {
  1871. return ((READ_BIT(RCC->CIFR, RCC_CIFR_CSSF) == RCC_CIFR_CSSF) ? 1UL : 0UL);
  1872. }
  1873. #endif /* RCC_HSECSS_SUPPORT */
  1874. /**
  1875. * @brief Check if LSE Clock security system interrupt occurred or not
  1876. * @rmtoll CIFR LSECSSF LL_RCC_IsActiveFlag_LSECSS
  1877. * @retval State of bit (1 or 0).
  1878. */
  1879. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LSECSS(void)
  1880. {
  1881. return ((READ_BIT(RCC->CIFR, RCC_CIFR_LSECSSF) == RCC_CIFR_LSECSSF) ? 1UL : 0UL);
  1882. }
  1883. /**
  1884. * @brief Check if HSI Divider is enabled (it divides by 4)
  1885. * @rmtoll CR HSIDIVF LL_RCC_IsActiveFlag_HSIDIV
  1886. * @retval State of bit (1 or 0).
  1887. */
  1888. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_HSIDIV(void)
  1889. {
  1890. return ((READ_BIT(RCC->CR, RCC_CR_HSIDIVF) == RCC_CR_HSIDIVF) ? 1UL : 0UL);
  1891. }
  1892. #if defined(RCC_CSR_FWRSTF)
  1893. /**
  1894. * @brief Check if RCC flag FW reset is set or not.
  1895. * @rmtoll CSR FWRSTF LL_RCC_IsActiveFlag_FWRST
  1896. * @retval State of bit (1 or 0).
  1897. */
  1898. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_FWRST(void)
  1899. {
  1900. return ((READ_BIT(RCC->CSR, RCC_CSR_FWRSTF) == RCC_CSR_FWRSTF) ? 1UL : 0UL);
  1901. }
  1902. #endif /* RCC_CSR_FWRSTF */
  1903. /**
  1904. * @brief Check if RCC flag Independent Watchdog reset is set or not.
  1905. * @rmtoll CSR IWDGRSTF LL_RCC_IsActiveFlag_IWDGRST
  1906. * @retval State of bit (1 or 0).
  1907. */
  1908. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_IWDGRST(void)
  1909. {
  1910. return ((READ_BIT(RCC->CSR, RCC_CSR_IWDGRSTF) == RCC_CSR_IWDGRSTF) ? 1UL : 0UL);
  1911. }
  1912. /**
  1913. * @brief Check if RCC flag Low Power reset is set or not.
  1914. * @rmtoll CSR LPWRRSTF LL_RCC_IsActiveFlag_LPWRRST
  1915. * @retval State of bit (1 or 0).
  1916. */
  1917. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_LPWRRST(void)
  1918. {
  1919. return ((READ_BIT(RCC->CSR, RCC_CSR_LPWRRSTF) == RCC_CSR_LPWRRSTF) ? 1UL : 0UL);
  1920. }
  1921. /**
  1922. * @brief Check if RCC flag is set or not.
  1923. * @rmtoll CSR OBLRSTF LL_RCC_IsActiveFlag_OBLRST
  1924. * @retval State of bit (1 or 0).
  1925. */
  1926. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_OBLRST(void)
  1927. {
  1928. return ((READ_BIT(RCC->CSR, RCC_CSR_OBLRSTF) == RCC_CSR_OBLRSTF) ? 1UL : 0UL);
  1929. }
  1930. /**
  1931. * @brief Check if RCC flag Pin reset is set or not.
  1932. * @rmtoll CSR PINRSTF LL_RCC_IsActiveFlag_PINRST
  1933. * @retval State of bit (1 or 0).
  1934. */
  1935. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PINRST(void)
  1936. {
  1937. return ((READ_BIT(RCC->CSR, RCC_CSR_PINRSTF) == RCC_CSR_PINRSTF) ? 1UL : 0UL);
  1938. }
  1939. /**
  1940. * @brief Check if RCC flag POR/PDR reset is set or not.
  1941. * @rmtoll CSR PORRSTF LL_RCC_IsActiveFlag_PORRST
  1942. * @retval State of bit (1 or 0).
  1943. */
  1944. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_PORRST(void)
  1945. {
  1946. return ((READ_BIT(RCC->CSR, RCC_CSR_PORRSTF) == RCC_CSR_PORRSTF) ? 1UL : 0UL);
  1947. }
  1948. /**
  1949. * @brief Check if RCC flag Software reset is set or not.
  1950. * @rmtoll CSR SFTRSTF LL_RCC_IsActiveFlag_SFTRST
  1951. * @retval State of bit (1 or 0).
  1952. */
  1953. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_SFTRST(void)
  1954. {
  1955. return ((READ_BIT(RCC->CSR, RCC_CSR_SFTRSTF) == RCC_CSR_SFTRSTF) ? 1UL : 0UL);
  1956. }
  1957. /**
  1958. * @brief Check if RCC flag Window Watchdog reset is set or not.
  1959. * @rmtoll CSR WWDGRSTF LL_RCC_IsActiveFlag_WWDGRST
  1960. * @retval State of bit (1 or 0).
  1961. */
  1962. __STATIC_INLINE uint32_t LL_RCC_IsActiveFlag_WWDGRST(void)
  1963. {
  1964. return ((READ_BIT(RCC->CSR, RCC_CSR_WWDGRSTF) == RCC_CSR_WWDGRSTF) ? 1UL : 0UL);
  1965. }
  1966. /**
  1967. * @brief Set RMVF bit to clear the reset flags.
  1968. * @rmtoll CSR RMVF LL_RCC_ClearResetFlags
  1969. * @retval None
  1970. */
  1971. __STATIC_INLINE void LL_RCC_ClearResetFlags(void)
  1972. {
  1973. SET_BIT(RCC->CSR, RCC_CSR_RMVF);
  1974. }
  1975. /**
  1976. * @}
  1977. */
  1978. /** @defgroup RCC_LL_EF_IT_Management IT Management
  1979. * @{
  1980. */
  1981. /**
  1982. * @brief Enable LSI ready interrupt
  1983. * @rmtoll CIER LSIRDYIE LL_RCC_EnableIT_LSIRDY
  1984. * @retval None
  1985. */
  1986. __STATIC_INLINE void LL_RCC_EnableIT_LSIRDY(void)
  1987. {
  1988. SET_BIT(RCC->CIER, RCC_CIER_LSIRDYIE);
  1989. }
  1990. /**
  1991. * @brief Enable LSE ready interrupt
  1992. * @rmtoll CIER LSERDYIE LL_RCC_EnableIT_LSERDY
  1993. * @retval None
  1994. */
  1995. __STATIC_INLINE void LL_RCC_EnableIT_LSERDY(void)
  1996. {
  1997. SET_BIT(RCC->CIER, RCC_CIER_LSERDYIE);
  1998. }
  1999. /**
  2000. * @brief Enable MSI ready interrupt
  2001. * @rmtoll CIER MSIRDYIE LL_RCC_EnableIT_MSIRDY
  2002. * @retval None
  2003. */
  2004. __STATIC_INLINE void LL_RCC_EnableIT_MSIRDY(void)
  2005. {
  2006. SET_BIT(RCC->CIER, RCC_CIER_MSIRDYIE);
  2007. }
  2008. /**
  2009. * @brief Enable HSI ready interrupt
  2010. * @rmtoll CIER HSIRDYIE LL_RCC_EnableIT_HSIRDY
  2011. * @retval None
  2012. */
  2013. __STATIC_INLINE void LL_RCC_EnableIT_HSIRDY(void)
  2014. {
  2015. SET_BIT(RCC->CIER, RCC_CIER_HSIRDYIE);
  2016. }
  2017. /**
  2018. * @brief Enable HSE ready interrupt
  2019. * @rmtoll CIER HSERDYIE LL_RCC_EnableIT_HSERDY
  2020. * @retval None
  2021. */
  2022. __STATIC_INLINE void LL_RCC_EnableIT_HSERDY(void)
  2023. {
  2024. SET_BIT(RCC->CIER, RCC_CIER_HSERDYIE);
  2025. }
  2026. /**
  2027. * @brief Enable PLL ready interrupt
  2028. * @rmtoll CIER PLLRDYIE LL_RCC_EnableIT_PLLRDY
  2029. * @retval None
  2030. */
  2031. __STATIC_INLINE void LL_RCC_EnableIT_PLLRDY(void)
  2032. {
  2033. SET_BIT(RCC->CIER, RCC_CIER_PLLRDYIE);
  2034. }
  2035. #if defined(RCC_HSI48_SUPPORT)
  2036. /**
  2037. * @brief Enable HSI48 ready interrupt
  2038. * @rmtoll CIER HSI48RDYIE LL_RCC_EnableIT_HSI48RDY
  2039. * @retval None
  2040. */
  2041. __STATIC_INLINE void LL_RCC_EnableIT_HSI48RDY(void)
  2042. {
  2043. SET_BIT(RCC->CIER, RCC_CIER_HSI48RDYIE);
  2044. }
  2045. #endif /* RCC_HSI48_SUPPORT */
  2046. /**
  2047. * @brief Enable LSE clock security system interrupt
  2048. * @rmtoll CIER LSECSSIE LL_RCC_EnableIT_LSECSS
  2049. * @retval None
  2050. */
  2051. __STATIC_INLINE void LL_RCC_EnableIT_LSECSS(void)
  2052. {
  2053. SET_BIT(RCC->CIER, RCC_CIER_LSECSSIE);
  2054. }
  2055. /**
  2056. * @brief Disable LSI ready interrupt
  2057. * @rmtoll CIER LSIRDYIE LL_RCC_DisableIT_LSIRDY
  2058. * @retval None
  2059. */
  2060. __STATIC_INLINE void LL_RCC_DisableIT_LSIRDY(void)
  2061. {
  2062. CLEAR_BIT(RCC->CIER, RCC_CIER_LSIRDYIE);
  2063. }
  2064. /**
  2065. * @brief Disable LSE ready interrupt
  2066. * @rmtoll CIER LSERDYIE LL_RCC_DisableIT_LSERDY
  2067. * @retval None
  2068. */
  2069. __STATIC_INLINE void LL_RCC_DisableIT_LSERDY(void)
  2070. {
  2071. CLEAR_BIT(RCC->CIER, RCC_CIER_LSERDYIE);
  2072. }
  2073. /**
  2074. * @brief Disable MSI ready interrupt
  2075. * @rmtoll CIER MSIRDYIE LL_RCC_DisableIT_MSIRDY
  2076. * @retval None
  2077. */
  2078. __STATIC_INLINE void LL_RCC_DisableIT_MSIRDY(void)
  2079. {
  2080. CLEAR_BIT(RCC->CIER, RCC_CIER_MSIRDYIE);
  2081. }
  2082. /**
  2083. * @brief Disable HSI ready interrupt
  2084. * @rmtoll CIER HSIRDYIE LL_RCC_DisableIT_HSIRDY
  2085. * @retval None
  2086. */
  2087. __STATIC_INLINE void LL_RCC_DisableIT_HSIRDY(void)
  2088. {
  2089. CLEAR_BIT(RCC->CIER, RCC_CIER_HSIRDYIE);
  2090. }
  2091. /**
  2092. * @brief Disable HSE ready interrupt
  2093. * @rmtoll CIER HSERDYIE LL_RCC_DisableIT_HSERDY
  2094. * @retval None
  2095. */
  2096. __STATIC_INLINE void LL_RCC_DisableIT_HSERDY(void)
  2097. {
  2098. CLEAR_BIT(RCC->CIER, RCC_CIER_HSERDYIE);
  2099. }
  2100. /**
  2101. * @brief Disable PLL ready interrupt
  2102. * @rmtoll CIER PLLRDYIE LL_RCC_DisableIT_PLLRDY
  2103. * @retval None
  2104. */
  2105. __STATIC_INLINE void LL_RCC_DisableIT_PLLRDY(void)
  2106. {
  2107. CLEAR_BIT(RCC->CIER, RCC_CIER_PLLRDYIE);
  2108. }
  2109. #if defined(RCC_HSI48_SUPPORT)
  2110. /**
  2111. * @brief Disable HSI48 ready interrupt
  2112. * @rmtoll CIER HSI48RDYIE LL_RCC_DisableIT_HSI48RDY
  2113. * @retval None
  2114. */
  2115. __STATIC_INLINE void LL_RCC_DisableIT_HSI48RDY(void)
  2116. {
  2117. CLEAR_BIT(RCC->CIER, RCC_CIER_HSI48RDYIE);
  2118. }
  2119. #endif /* RCC_HSI48_SUPPORT */
  2120. /**
  2121. * @brief Disable LSE clock security system interrupt
  2122. * @rmtoll CIER LSECSSIE LL_RCC_DisableIT_LSECSS
  2123. * @retval None
  2124. */
  2125. __STATIC_INLINE void LL_RCC_DisableIT_LSECSS(void)
  2126. {
  2127. CLEAR_BIT(RCC->CIER, RCC_CIER_LSECSSIE);
  2128. }
  2129. /**
  2130. * @brief Checks if LSI ready interrupt source is enabled or disabled.
  2131. * @rmtoll CIER LSIRDYIE LL_RCC_IsEnabledIT_LSIRDY
  2132. * @retval State of bit (1 or 0).
  2133. */
  2134. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSIRDY(void)
  2135. {
  2136. return ((READ_BIT(RCC->CIER, RCC_CIER_LSIRDYIE) == RCC_CIER_LSIRDYIE) ? 1UL : 0UL);
  2137. }
  2138. /**
  2139. * @brief Checks if LSE ready interrupt source is enabled or disabled.
  2140. * @rmtoll CIER LSERDYIE LL_RCC_IsEnabledIT_LSERDY
  2141. * @retval State of bit (1 or 0).
  2142. */
  2143. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSERDY(void)
  2144. {
  2145. return ((READ_BIT(RCC->CIER, RCC_CIER_LSERDYIE) == RCC_CIER_LSERDYIE) ? 1UL : 0UL);
  2146. }
  2147. /**
  2148. * @brief Checks if MSI ready interrupt source is enabled or disabled.
  2149. * @rmtoll CIER MSIRDYIE LL_RCC_IsEnabledIT_MSIRDY
  2150. * @retval State of bit (1 or 0).
  2151. */
  2152. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_MSIRDY(void)
  2153. {
  2154. return ((READ_BIT(RCC->CIER, RCC_CIER_MSIRDYIE) == RCC_CIER_MSIRDYIE) ? 1UL : 0UL);
  2155. }
  2156. /**
  2157. * @brief Checks if HSI ready interrupt source is enabled or disabled.
  2158. * @rmtoll CIER HSIRDYIE LL_RCC_IsEnabledIT_HSIRDY
  2159. * @retval State of bit (1 or 0).
  2160. */
  2161. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_HSIRDY(void)
  2162. {
  2163. return ((READ_BIT(RCC->CIER, RCC_CIER_HSIRDYIE) == RCC_CIER_HSIRDYIE) ? 1UL : 0UL);
  2164. }
  2165. /**
  2166. * @brief Checks if HSE ready interrupt source is enabled or disabled.
  2167. * @rmtoll CIER HSERDYIE LL_RCC_IsEnabledIT_HSERDY
  2168. * @retval State of bit (1 or 0).
  2169. */
  2170. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_HSERDY(void)
  2171. {
  2172. return ((READ_BIT(RCC->CIER, RCC_CIER_HSERDYIE) == RCC_CIER_HSERDYIE) ? 1UL : 0UL);
  2173. }
  2174. /**
  2175. * @brief Checks if PLL ready interrupt source is enabled or disabled.
  2176. * @rmtoll CIER PLLRDYIE LL_RCC_IsEnabledIT_PLLRDY
  2177. * @retval State of bit (1 or 0).
  2178. */
  2179. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_PLLRDY(void)
  2180. {
  2181. return ((READ_BIT(RCC->CIER, RCC_CIER_PLLRDYIE) == RCC_CIER_PLLRDYIE) ? 1UL : 0UL);
  2182. }
  2183. #if defined(RCC_HSI48_SUPPORT)
  2184. /**
  2185. * @brief Checks if HSI48 ready interrupt source is enabled or disabled.
  2186. * @rmtoll CIER HSI48RDYIE LL_RCC_IsEnabledIT_HSI48RDY
  2187. * @retval State of bit (1 or 0).
  2188. */
  2189. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_HSI48RDY(void)
  2190. {
  2191. return ((READ_BIT(RCC->CIER, RCC_CIER_HSI48RDYIE) == RCC_CIER_HSI48RDYIE) ? 1UL : 0UL);
  2192. }
  2193. #endif /* RCC_HSI48_SUPPORT */
  2194. /**
  2195. * @brief Checks if LSECSS interrupt source is enabled or disabled.
  2196. * @rmtoll CIER LSECSSIE LL_RCC_IsEnabledIT_LSECSS
  2197. * @retval State of bit (1 or 0).
  2198. */
  2199. __STATIC_INLINE uint32_t LL_RCC_IsEnabledIT_LSECSS(void)
  2200. {
  2201. return ((READ_BIT(RCC->CIER, RCC_CIER_LSECSSIE) == RCC_CIER_LSECSSIE) ? 1UL : 0UL);
  2202. }
  2203. /**
  2204. * @}
  2205. */
  2206. #if defined(USE_FULL_LL_DRIVER)
  2207. /** @defgroup RCC_LL_EF_Init De-initialization function
  2208. * @{
  2209. */
  2210. ErrorStatus LL_RCC_DeInit(void);
  2211. /**
  2212. * @}
  2213. */
  2214. /** @defgroup RCC_LL_EF_Get_Freq Get system and peripherals clocks frequency functions
  2215. * @{
  2216. */
  2217. void LL_RCC_GetSystemClocksFreq(LL_RCC_ClocksTypeDef *RCC_Clocks);
  2218. uint32_t LL_RCC_GetUSARTClockFreq(uint32_t USARTxSource);
  2219. uint32_t LL_RCC_GetI2CClockFreq(uint32_t I2CxSource);
  2220. uint32_t LL_RCC_GetLPUARTClockFreq(uint32_t LPUARTxSource);
  2221. uint32_t LL_RCC_GetLPTIMClockFreq(uint32_t LPTIMxSource);
  2222. #if defined(USB_OTG_FS) || defined(USB)
  2223. uint32_t LL_RCC_GetUSBClockFreq(uint32_t USBxSource);
  2224. #endif /* USB_OTG_FS || USB */
  2225. /**
  2226. * @}
  2227. */
  2228. #endif /* USE_FULL_LL_DRIVER */
  2229. /**
  2230. * @}
  2231. */
  2232. /**
  2233. * @}
  2234. */
  2235. #endif /* RCC */
  2236. /**
  2237. * @}
  2238. */
  2239. #ifdef __cplusplus
  2240. }
  2241. #endif
  2242. #endif /* __STM32L0xx_LL_RCC_H */