stm32l0xx_hal_rcc.h 74 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614
  1. /**
  2. ******************************************************************************
  3. * @file stm32l0xx_hal_rcc.h
  4. * @author MCD Application Team
  5. * @version V1.7.0
  6. * @date 31-May-2016
  7. * @brief Header file of RCC HAL module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32L0xx_HAL_RCC_H
  39. #define __STM32L0xx_HAL_RCC_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #include "stm32l0xx_hal_def.h"
  45. /** @addtogroup STM32L0xx_HAL_Driver
  46. * @{
  47. */
  48. /** @defgroup RCC RCC
  49. * @{
  50. */
  51. /** @defgroup RCC_Exported_Types RCC Exported Types
  52. * @{
  53. */
  54. /**
  55. * @brief RCC PLL configuration structure definition
  56. */
  57. typedef struct
  58. {
  59. uint32_t PLLState; /*!< The new state of the PLL.
  60. This parameter can be a value of @ref RCC_PLL_Config */
  61. uint32_t PLLSource; /*!< RCC_PLLSource: PLL entry clock source.
  62. This parameter must be a value of @ref RCC_PLL_Clock_Source */
  63. uint32_t PLLMUL; /*!< PLLMUL: Multiplication factor for PLL VCO output clock
  64. This parameter must of @ref RCC_PLLMultiplication_Factor */
  65. uint32_t PLLDIV; /*!< PLLDIV: Division factor for main system clock (SYSCLK)
  66. This parameter must be a value of @ref RCC_PLLDivider_Factor */
  67. }RCC_PLLInitTypeDef;
  68. /**
  69. * @brief RCC Internal/External Oscillator (HSE, HSI, LSE and LSI) configuration structure definition
  70. */
  71. typedef struct
  72. {
  73. uint32_t OscillatorType; /*!< The oscillators to be configured.
  74. This parameter can be a value of @ref RCC_Oscillator_Type */
  75. uint32_t HSEState; /*!< The new state of the HSE.
  76. This parameter can be a value of @ref RCC_HSE_Config */
  77. uint32_t LSEState; /*!< The new state of the LSE.
  78. This parameter can be a value of @ref RCC_LSE_Config */
  79. uint32_t HSIState; /*!< The new state of the HSI.
  80. This parameter can be a value of @ref RCC_HSI_Config */
  81. uint32_t HSICalibrationValue; /*!< The calibration trimming value.
  82. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x1F */
  83. uint32_t LSIState; /*!< The new state of the LSI.
  84. This parameter can be a value of @ref RCC_LSI_Config */
  85. #if !defined (STM32L031xx) && !defined (STM32L041xx) && !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) && \
  86. !defined (STM32L011xx) && !defined (STM32L021xx)
  87. uint32_t HSI48State; /*!< The new state of the HSI48.
  88. This parameter can be a value of @ref RCC_HSI48_Config */
  89. #endif
  90. uint32_t MSIState; /*!< The new state of the MSI.
  91. This parameter can be a value of @ref RCC_MSI_Config */
  92. uint32_t MSICalibrationValue; /*!< The calibration trimming value.
  93. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFF */
  94. uint32_t MSIClockRange; /*!< The MSI frequency range.
  95. This parameter can be a value of @ref RCC_MSI_Clock_Range */
  96. RCC_PLLInitTypeDef PLL; /*!< PLL structure parameters */
  97. }RCC_OscInitTypeDef;
  98. /**
  99. * @brief RCC System, AHB and APB busses clock configuration structure definition
  100. */
  101. typedef struct
  102. {
  103. uint32_t ClockType; /*!< The clock to be configured.
  104. This parameter can be a value of @ref RCC_System_Clock_Type */
  105. uint32_t SYSCLKSource; /*!< The clock source (SYSCLKS) used as system clock.
  106. This parameter can be a value of @ref RCC_System_Clock_Source */
  107. uint32_t AHBCLKDivider; /*!< The AHB clock (HCLK) divider. This clock is derived from the system clock (SYSCLK).
  108. This parameter can be a value of @ref RCC_AHB_Clock_Source */
  109. uint32_t APB1CLKDivider; /*!< The APB1 clock (PCLK1) divider. This clock is derived from the AHB clock (HCLK).
  110. This parameter can be a value of @ref RCC_APB1_APB2_Clock_Source */
  111. uint32_t APB2CLKDivider; /*!< The APB2 clock (PCLK2) divider. This clock is derived from the AHB clock (HCLK).
  112. This parameter can be a value of @ref RCC_APB1_APB2_Clock_Source */
  113. }RCC_ClkInitTypeDef;
  114. /**
  115. * @}
  116. */
  117. /* Private constants --------------------------------------------------------*/
  118. /** @addtogroup RCC_Private
  119. * @brief RCC registers bit address in the alias region
  120. * @{
  121. */
  122. #define RCC_OFFSET (RCC_BASE - PERIPH_BASE)
  123. /* --- CR Register ---*/
  124. /* Alias word address of HSION bit */
  125. #define RCC_CR_OFFSET (RCC_OFFSET + 0x00U)
  126. /* --- CFGR Register ---*/
  127. /* Alias word address of I2SSRC bit */
  128. #define RCC_CFGR_OFFSET (RCC_OFFSET + 0x08U)
  129. /* --- CSR Register ---*/
  130. #define RCC_CSR_OFFSET (RCC_OFFSET + 0x74U)
  131. /* CR register byte 3 (Bits[23:16]) base address */
  132. #define RCC_CR_BYTE2_ADDRESS ((uint32_t)0x40023802U)
  133. /* CIER register byte 0 (Bits[0:8]) base address */
  134. #define CIER_BYTE0_ADDRESS ((uint32_t)(RCC_BASE + 0x10U + 0x00U))
  135. /**
  136. * @}
  137. */
  138. /* Exported constants --------------------------------------------------------*/
  139. /** @defgroup RCC_Exported_Constants RCC Exported Constants
  140. * @{
  141. */
  142. /** @defgroup RCC_Timeout_Value Timeout Values
  143. * @{
  144. */
  145. #define RCC_DBP_TIMEOUT_VALUE ((uint32_t)100U) /* 100 ms */
  146. #define RCC_LSE_TIMEOUT_VALUE LSE_STARTUP_TIMEOUT
  147. #define RCC_HSE_TIMEOUT_VALUE HSE_STARTUP_TIMEOUT
  148. /**
  149. * @}
  150. */
  151. /** @defgroup RCC_Oscillator_Type Oscillator Type
  152. * @{
  153. */
  154. #define RCC_OSCILLATORTYPE_NONE ((uint32_t)0x00000000U) /*!< Oscillator configuration unchanged */
  155. #define RCC_OSCILLATORTYPE_HSE ((uint32_t)0x00000001U) /*!< HSE to configure */
  156. #define RCC_OSCILLATORTYPE_HSI ((uint32_t)0x00000002U) /*!< HSI to configure */
  157. #define RCC_OSCILLATORTYPE_LSE ((uint32_t)0x00000004U) /*!< LSE to configure */
  158. #define RCC_OSCILLATORTYPE_LSI ((uint32_t)0x00000008U) /*!< LSI to configure */
  159. #define RCC_OSCILLATORTYPE_MSI ((uint32_t)0x00000010U) /*!< MSI to configure */
  160. #if !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx)
  161. #define RCC_OSCILLATORTYPE_HSI48 ((uint32_t)0x00000020U)
  162. #endif /* !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) */
  163. /**
  164. * @}
  165. */
  166. /** @defgroup RCC_HSE_Config RCC HSE Config
  167. * @{
  168. */
  169. #define RCC_HSE_OFF ((uint32_t)0x00000000U)
  170. #define RCC_HSE_ON RCC_CR_HSEON
  171. #define RCC_HSE_BYPASS ((uint32_t)(RCC_CR_HSEBYP | RCC_CR_HSEON))
  172. /**
  173. * @}
  174. */
  175. /** @defgroup RCC_LSE_Config RCC LSE Config
  176. * @{
  177. */
  178. #define RCC_LSE_OFF ((uint32_t)0x00000000U)
  179. #define RCC_LSE_ON RCC_CSR_LSEON
  180. #define RCC_LSE_BYPASS ((uint32_t)(RCC_CSR_LSEBYP | RCC_CSR_LSEON))
  181. /**
  182. * @}
  183. */
  184. /** @defgroup RCC_LSI_Config RCC LSI Config
  185. * @{
  186. */
  187. #define RCC_LSI_OFF ((uint8_t)0x00U)
  188. #define RCC_LSI_ON ((uint8_t)0x01U)
  189. #define RCC_MSICALIBRATION_DEFAULT ((uint32_t)0) /* Default MSI calibration trimming value */
  190. /**
  191. * @}
  192. */
  193. /** @defgroup RCC_MSI_Config RCC MSI Config
  194. * @{
  195. */
  196. #define RCC_MSI_OFF ((uint8_t)0x00U)
  197. #define RCC_MSI_ON ((uint8_t)0x01U)
  198. #define RCC_HSICALIBRATION_DEFAULT ((uint32_t)0x10U) /* Default HSI calibration trimming value */
  199. /**
  200. * @}
  201. */
  202. #if !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx)
  203. /** @defgroup RCC_HSI48_Config RCC HSI48 Configuration
  204. * @{
  205. */
  206. #define RCC_HSI48_OFF ((uint8_t)0x00U)
  207. #define RCC_HSI48_ON ((uint8_t)0x01U)
  208. /**
  209. * @}
  210. */
  211. #endif /* !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) */
  212. /** @defgroup RCC_PLL_Config RCC PLL Config
  213. * @{
  214. */
  215. #define RCC_PLL_NONE ((uint8_t)0x00U)
  216. #define RCC_PLL_OFF ((uint8_t)0x01U)
  217. #define RCC_PLL_ON ((uint8_t)0x02U)
  218. /**
  219. * @}
  220. */
  221. /** @defgroup RCC_PLL_Clock_Source RCC PLL Clock Source
  222. * @{
  223. */
  224. #define RCC_PLLSOURCE_HSI RCC_CFGR_PLLSRC_HSI
  225. #define RCC_PLLSOURCE_HSE RCC_CFGR_PLLSRC_HSE
  226. /**
  227. * @}
  228. */
  229. /** @defgroup RCC_PLLMultiplication_Factor RCC PLL Multipliers
  230. * @{
  231. */
  232. #define RCC_PLLMUL_3 RCC_CFGR_PLLMUL3
  233. #define RCC_PLLMUL_4 RCC_CFGR_PLLMUL4
  234. #define RCC_PLLMUL_6 RCC_CFGR_PLLMUL6
  235. #define RCC_PLLMUL_8 RCC_CFGR_PLLMUL8
  236. #define RCC_PLLMUL_12 RCC_CFGR_PLLMUL12
  237. #define RCC_PLLMUL_16 RCC_CFGR_PLLMUL16
  238. #define RCC_PLLMUL_24 RCC_CFGR_PLLMUL24
  239. #define RCC_PLLMUL_32 RCC_CFGR_PLLMUL32
  240. #define RCC_PLLMUL_48 RCC_CFGR_PLLMUL48
  241. /**
  242. * @}
  243. */
  244. /** @defgroup RCC_PLLDivider_Factor RCC PLL Dividers
  245. * @{
  246. */
  247. #define RCC_PLLDIV_2 RCC_CFGR_PLLDIV2
  248. #define RCC_PLLDIV_3 RCC_CFGR_PLLDIV3
  249. #define RCC_PLLDIV_4 RCC_CFGR_PLLDIV4
  250. /**
  251. * @}
  252. */
  253. /** @defgroup RCC_MSI_Clock_Range RCC MSI Clock Range
  254. * @{
  255. */
  256. #define RCC_MSIRANGE_0 RCC_ICSCR_MSIRANGE_0 /*!< MSI = 65.536 KHz */
  257. #define RCC_MSIRANGE_1 RCC_ICSCR_MSIRANGE_1 /*!< MSI = 131.072 KHz */
  258. #define RCC_MSIRANGE_2 RCC_ICSCR_MSIRANGE_2 /*!< MSI = 262.144 KHz */
  259. #define RCC_MSIRANGE_3 RCC_ICSCR_MSIRANGE_3 /*!< MSI = 524.288 KHz */
  260. #define RCC_MSIRANGE_4 RCC_ICSCR_MSIRANGE_4 /*!< MSI = 1.048 MHz */
  261. #define RCC_MSIRANGE_5 RCC_ICSCR_MSIRANGE_5 /*!< MSI = 2.097 MHz */
  262. #define RCC_MSIRANGE_6 RCC_ICSCR_MSIRANGE_6 /*!< MSI = 4.194 MHz */
  263. /**
  264. * @}
  265. */
  266. /** @defgroup RCC_System_Clock_Type RCC System Clock Type
  267. * @{
  268. */
  269. #define RCC_CLOCKTYPE_SYSCLK ((uint32_t)0x00000001U) /*!< SYSCLK to configure */
  270. #define RCC_CLOCKTYPE_HCLK ((uint32_t)0x00000002U) /*!< HCLK to configure */
  271. #define RCC_CLOCKTYPE_PCLK1 ((uint32_t)0x00000004U) /*!< PCLK1 to configure */
  272. #define RCC_CLOCKTYPE_PCLK2 ((uint32_t)0x00000008U) /*!< PCLK2 to configure */
  273. /**
  274. * @}
  275. */
  276. /** @defgroup RCC_System_Clock_Source RCC System Clock Source
  277. * @{
  278. */
  279. #define RCC_SYSCLKSOURCE_MSI RCC_CFGR_SW_MSI /*!< MSI selection as system clock */
  280. #define RCC_SYSCLKSOURCE_HSI RCC_CFGR_SW_HSI /*!< HSI selection as system clock */
  281. #define RCC_SYSCLKSOURCE_HSE RCC_CFGR_SW_HSE /*!< HSE selection as system clock */
  282. #define RCC_SYSCLKSOURCE_PLLCLK RCC_CFGR_SW_PLL /*!< PLL selection as system clock */
  283. /**
  284. * @}
  285. */
  286. /** @defgroup RCC_System_Clock_SOURCE_Status RCC System Clock Source Status
  287. * @{
  288. */
  289. #define RCC_SYSCLKSOURCE_STATUS_MSI RCC_CFGR_SWS_MSI /*!< MSI used as system clock */
  290. #define RCC_SYSCLKSOURCE_STATUS_HSI RCC_CFGR_SWS_HSI /*!< HSI used as system clock */
  291. #define RCC_SYSCLKSOURCE_STATUS_HSE RCC_CFGR_SWS_HSE /*!< HSE used as system clock */
  292. #define RCC_SYSCLKSOURCE_STATUS_PLLCLK RCC_CFGR_SWS_PLL /*!< PLL used as system clock */
  293. /**
  294. * @}
  295. */
  296. /** @defgroup RCC_AHB_Clock_Source RCC AHB Clock Source
  297. * @{
  298. */
  299. #define RCC_SYSCLK_DIV1 RCC_CFGR_HPRE_DIV1 /*!< SYSCLK not divided */
  300. #define RCC_SYSCLK_DIV2 RCC_CFGR_HPRE_DIV2 /*!< SYSCLK divided by 2 */
  301. #define RCC_SYSCLK_DIV4 RCC_CFGR_HPRE_DIV4 /*!< SYSCLK divided by 4 */
  302. #define RCC_SYSCLK_DIV8 RCC_CFGR_HPRE_DIV8 /*!< SYSCLK divided by 8 */
  303. #define RCC_SYSCLK_DIV16 RCC_CFGR_HPRE_DIV16 /*!< SYSCLK divided by 16 */
  304. #define RCC_SYSCLK_DIV64 RCC_CFGR_HPRE_DIV64 /*!< SYSCLK divided by 64 */
  305. #define RCC_SYSCLK_DIV128 RCC_CFGR_HPRE_DIV128 /*!< SYSCLK divided by 128 */
  306. #define RCC_SYSCLK_DIV256 RCC_CFGR_HPRE_DIV256 /*!< SYSCLK divided by 256 */
  307. #define RCC_SYSCLK_DIV512 RCC_CFGR_HPRE_DIV512 /*!< SYSCLK divided by 512 */
  308. /**
  309. * @}
  310. */
  311. /** @defgroup RCC_APB1_APB2_Clock_Source RCC APB1 APB2 Clock Source
  312. * @{
  313. */
  314. #define RCC_HCLK_DIV1 RCC_CFGR_PPRE1_DIV1 /*!< HCLK not divided */
  315. #define RCC_HCLK_DIV2 RCC_CFGR_PPRE1_DIV2 /*!< HCLK divided by 2 */
  316. #define RCC_HCLK_DIV4 RCC_CFGR_PPRE1_DIV4 /*!< HCLK divided by 4 */
  317. #define RCC_HCLK_DIV8 RCC_CFGR_PPRE1_DIV8 /*!< HCLK divided by 8 */
  318. #define RCC_HCLK_DIV16 RCC_CFGR_PPRE1_DIV16 /*!< HCLK divided by 16 */
  319. /**
  320. * @}
  321. */
  322. /** @defgroup RCC_RTC_Clock_Source RCC RTC Clock Source
  323. * @{
  324. */
  325. #define RCC_RTCCLKSOURCE_NO_CLK ((uint32_t)0x00000000U)
  326. #define RCC_RTCCLKSOURCE_LSE RCC_CSR_RTCSEL_LSE
  327. #define RCC_RTCCLKSOURCE_LSI RCC_CSR_RTCSEL_LSI
  328. #define RCC_RTCCLKSOURCE_HSE_DIVX RCC_CSR_RTCSEL_HSE
  329. #define RCC_RTCCLKSOURCE_HSE_DIV2 RCC_CSR_RTCSEL_HSE
  330. #define RCC_RTCCLKSOURCE_HSE_DIV4 ((uint32_t)RCC_CSR_RTCSEL_HSE | RCC_CR_RTCPRE_0)
  331. #define RCC_RTCCLKSOURCE_HSE_DIV8 ((uint32_t)RCC_CSR_RTCSEL_HSE | RCC_CR_RTCPRE_1)
  332. #define RCC_RTCCLKSOURCE_HSE_DIV16 ((uint32_t)RCC_CSR_RTCSEL_HSE | RCC_CR_RTCPRE)
  333. #define RCC_RTC_HSE_DIV_2 (uint32_t)0x00000000U /*!< HSE is divided by 2 for RTC clock */
  334. #define RCC_RTC_HSE_DIV_4 RCC_CR_RTCPRE_0 /*!< HSE is divided by 4 for RTC clock */
  335. #define RCC_RTC_HSE_DIV_8 RCC_CR_RTCPRE_1 /*!< HSE is divided by 8 for RTC clock */
  336. #define RCC_RTC_HSE_DIV_16 RCC_CR_RTCPRE /*!< HSE is divided by 16 for RTC clock */
  337. /**
  338. * @}
  339. */
  340. /** @defgroup RCC_MCO1_Clock_Source RCC MCO1 Clock Source
  341. * @{
  342. */
  343. #define RCC_MCO1SOURCE_NOCLOCK RCC_CFGR_MCO_NOCLOCK
  344. #define RCC_MCO1SOURCE_SYSCLK RCC_CFGR_MCO_SYSCLK
  345. #define RCC_MCO1SOURCE_HSI RCC_CFGR_MCO_HSI
  346. #define RCC_MCO1SOURCE_MSI RCC_CFGR_MCO_MSI
  347. #define RCC_MCO1SOURCE_HSE RCC_CFGR_MCO_HSE
  348. #define RCC_MCO1SOURCE_PLLCLK RCC_CFGR_MCO_PLL
  349. #define RCC_MCO1SOURCE_LSI RCC_CFGR_MCO_LSI
  350. #define RCC_MCO1SOURCE_LSE RCC_CFGR_MCO_LSE
  351. #if !defined (STM32L031xx) && !defined (STM32L041xx) && !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) \
  352. && !defined (STM32L011xx) && !defined (STM32L021xx)
  353. #define RCC_MCO1SOURCE_HSI48 RCC_CFGR_MCO_HSI48
  354. #endif
  355. /**
  356. * @}
  357. */
  358. /** @defgroup RCC_MCOPrescaler RCC MCO Prescaler
  359. * @{
  360. */
  361. #define RCC_MCODIV_1 RCC_CFGR_MCO_PRE_1
  362. #define RCC_MCODIV_2 RCC_CFGR_MCO_PRE_2
  363. #define RCC_MCODIV_4 RCC_CFGR_MCO_PRE_4
  364. #define RCC_MCODIV_8 RCC_CFGR_MCO_PRE_8
  365. #define RCC_MCODIV_16 RCC_CFGR_MCO_PRE_16
  366. /**
  367. * @}
  368. */
  369. /** @defgroup RCC_MCO_Index RCC MCO Index
  370. * @{
  371. */
  372. #define RCC_MCO1 ((uint32_t)0x00000000U)
  373. #define RCC_MCO2 ((uint32_t)0x00000001U)
  374. #if defined(STM32L031xx) || defined(STM32L041xx) || defined(STM32L073xx) || defined(STM32L083xx) || \
  375. defined(STM32L072xx) || defined(STM32L082xx) || defined(STM32L071xx) || defined(STM32L081xx)
  376. #define RCC_MCO3 ((uint32_t)0x00000002U)
  377. #endif
  378. /**
  379. * @}
  380. */
  381. /** @defgroup RCC_Interrupt RCC Interruptions
  382. * @{
  383. */
  384. #define RCC_IT_LSIRDY RCC_CIFR_LSIRDYF
  385. #define RCC_IT_LSERDY RCC_CIFR_LSERDYF
  386. #define RCC_IT_HSIRDY RCC_CIFR_HSIRDYF
  387. #define RCC_IT_HSERDY RCC_CIFR_HSERDYF
  388. #define RCC_IT_PLLRDY RCC_CIFR_PLLRDYF
  389. #define RCC_IT_MSIRDY RCC_CIFR_MSIRDYF
  390. #define RCC_IT_CSSLSE RCC_CIFR_CSSLSEF
  391. #define RCC_IT_CSSHSE RCC_CIFR_CSSHSEF
  392. #if !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx)
  393. #define RCC_IT_HSI48RDY RCC_CIFR_HSI48RDYF
  394. #endif /* !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) */
  395. /**
  396. * @}
  397. */
  398. /** @defgroup RCC_Flag RCC Flag
  399. * Elements values convention: 0XXYYYYYb
  400. * - YYYYY : Flag position in the register
  401. * - 0XX : Register index
  402. * - 01: CR register
  403. * - 10: CSR register
  404. * - 11: CRRCR register
  405. * @{
  406. */
  407. /* Flags in the CR register */
  408. #define RCC_FLAG_HSIRDY ((uint8_t)0x22U)
  409. #define RCC_FLAG_HSIDIV ((uint8_t)0x24U)
  410. #define RCC_FLAG_MSIRDY ((uint8_t)0x29U)
  411. #define RCC_FLAG_HSERDY ((uint8_t)0x31U)
  412. #define RCC_FLAG_PLLRDY ((uint8_t)0x39U)
  413. /* Flags in the CSR register */
  414. #define RCC_FLAG_LSERDY ((uint8_t)0x49U)
  415. #define RCC_FLAG_LSECSS ((uint8_t)0x4EU)
  416. #define RCC_FLAG_LSIRDY ((uint8_t)0x41U)
  417. #define RCC_FLAG_FWRST ((uint8_t)0x58U)
  418. #define RCC_FLAG_OBLRST ((uint8_t)0x59U)
  419. #define RCC_FLAG_PINRST ((uint8_t)0x5AU)
  420. #define RCC_FLAG_PORRST ((uint8_t)0x5BU)
  421. #define RCC_FLAG_SFTRST ((uint8_t)0x5CU)
  422. #define RCC_FLAG_IWDGRST ((uint8_t)0x5DU)
  423. #define RCC_FLAG_WWDGRST ((uint8_t)0x5EU)
  424. #define RCC_FLAG_LPWRRST ((uint8_t)0x5FU)
  425. #if !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx)
  426. /* Flags in the CRRCR register */
  427. #define RCC_FLAG_HSI48RDY ((uint8_t)0x61U)
  428. #endif /* !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) */
  429. /**
  430. * @}
  431. */
  432. /**
  433. * @}
  434. */
  435. /* Exported macro ------------------------------------------------------------*/
  436. /** @defgroup RCC_Exported_Macros RCC Exported Macros
  437. * @{
  438. */
  439. /** @defgroup RCC_AHB_Peripheral_Clock_Enable_Disable AHB Peripheral Clock Enable Disable
  440. * @brief Enable or disable the AHB peripheral clock.
  441. * @note After reset, the peripheral clock (used for registers read/write access)
  442. * is disabled and the application software has to enable this clock before
  443. * using it.
  444. * @{
  445. */
  446. #define __HAL_RCC_DMA1_CLK_ENABLE() do { \
  447. __IO uint32_t tmpreg; \
  448. SET_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN);\
  449. /* Delay after an RCC peripheral clock enabling */ \
  450. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN);\
  451. UNUSED(tmpreg); \
  452. } while(0)
  453. #define __HAL_RCC_MIF_CLK_ENABLE() do { \
  454. __IO uint32_t tmpreg; \
  455. SET_BIT(RCC->AHBENR, RCC_AHBENR_MIFEN);\
  456. /* Delay after an RCC peripheral clock enabling */ \
  457. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_MIFEN);\
  458. UNUSED(tmpreg); \
  459. } while(0)
  460. #define __HAL_RCC_CRC_CLK_ENABLE() do { \
  461. __IO uint32_t tmpreg; \
  462. SET_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN);\
  463. /* Delay after an RCC peripheral clock enabling */ \
  464. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN);\
  465. UNUSED(tmpreg); \
  466. } while(0)
  467. #define __HAL_RCC_DMA1_CLK_DISABLE() CLEAR_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN)
  468. #define __HAL_RCC_MIF_CLK_DISABLE() CLEAR_BIT(RCC->AHBENR, RCC_AHBENR_MIFEN)
  469. #define __HAL_RCC_CRC_CLK_DISABLE() CLEAR_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN)
  470. /**
  471. * @}
  472. */
  473. /** @defgroup RCC_IOPORT_Clock_Enable_Disable IOPORT Peripheral Clock Enable Disable
  474. * @brief Enable or disable the IOPORT peripheral clock.
  475. * @note After reset, the peripheral clock (used for registers read/write access)
  476. * is disabled and the application software has to enable this clock before
  477. * using it.
  478. * @{
  479. */
  480. #define __HAL_RCC_GPIOA_CLK_ENABLE() do { \
  481. __IO uint32_t tmpreg; \
  482. SET_BIT(RCC->IOPENR, RCC_IOPENR_GPIOAEN);\
  483. /* Delay after an RCC peripheral clock enabling */ \
  484. tmpreg = READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOAEN);\
  485. UNUSED(tmpreg); \
  486. } while(0)
  487. #define __HAL_RCC_GPIOB_CLK_ENABLE() do { \
  488. __IO uint32_t tmpreg; \
  489. SET_BIT(RCC->IOPENR, RCC_IOPENR_GPIOBEN);\
  490. /* Delay after an RCC peripheral clock enabling */ \
  491. tmpreg = READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOBEN);\
  492. UNUSED(tmpreg); \
  493. } while(0)
  494. #define __HAL_RCC_GPIOC_CLK_ENABLE() do { \
  495. __IO uint32_t tmpreg; \
  496. SET_BIT(RCC->IOPENR, RCC_IOPENR_GPIOCEN);\
  497. /* Delay after an RCC peripheral clock enabling */ \
  498. tmpreg = READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOCEN);\
  499. UNUSED(tmpreg); \
  500. } while(0)
  501. #define __HAL_RCC_GPIOH_CLK_ENABLE() do { \
  502. __IO uint32_t tmpreg; \
  503. SET_BIT(RCC->IOPENR, RCC_IOPENR_GPIOHEN);\
  504. /* Delay after an RCC peripheral clock enabling */ \
  505. tmpreg = READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOHEN);\
  506. UNUSED(tmpreg); \
  507. } while(0)
  508. #define __HAL_RCC_GPIOA_CLK_DISABLE() CLEAR_BIT(RCC->IOPENR, RCC_IOPENR_GPIOAEN)
  509. #define __HAL_RCC_GPIOB_CLK_DISABLE() CLEAR_BIT(RCC->IOPENR, RCC_IOPENR_GPIOBEN)
  510. #define __HAL_RCC_GPIOC_CLK_DISABLE() CLEAR_BIT(RCC->IOPENR, RCC_IOPENR_GPIOCEN)
  511. #define __HAL_RCC_GPIOH_CLK_DISABLE() CLEAR_BIT(RCC->IOPENR, RCC_IOPENR_GPIOHEN)
  512. /**
  513. * @}
  514. */
  515. /** @defgroup RCC_APB1_Clock_Enable_Disable APB1 Peripheral Clock Enable Disable
  516. * @brief Enable or disable the Low Speed APB (APB1) peripheral clock.
  517. * @note After reset, the peripheral clock (used for registers read/write access)
  518. * is disabled and the application software has to enable this clock before
  519. * using it.
  520. * @{
  521. */
  522. #define __HAL_RCC_WWDG_CLK_ENABLE() SET_BIT(RCC->APB1ENR, (RCC_APB1ENR_WWDGEN))
  523. #define __HAL_RCC_PWR_CLK_ENABLE() SET_BIT(RCC->APB1ENR, (RCC_APB1ENR_PWREN))
  524. #define __HAL_RCC_WWDG_CLK_DISABLE() CLEAR_BIT(RCC->APB1ENR, (RCC_APB1ENR_WWDGEN))
  525. #define __HAL_RCC_PWR_CLK_DISABLE() CLEAR_BIT(RCC->APB1ENR, (RCC_APB1ENR_PWREN))
  526. /**
  527. * @}
  528. */
  529. /** @defgroup RCC_APB2_Clock_Enable_Disable APB2 Peripheral Clock Enable Disable
  530. * @brief Enable or disable the High Speed APB (APB2) peripheral clock.
  531. * @note After reset, the peripheral clock (used for registers read/write access)
  532. * is disabled and the application software has to enable this clock before
  533. * using it.
  534. * @{
  535. */
  536. #define __HAL_RCC_SYSCFG_CLK_ENABLE() SET_BIT(RCC->APB2ENR, (RCC_APB2ENR_SYSCFGEN))
  537. #define __HAL_RCC_DBGMCU_CLK_ENABLE() SET_BIT(RCC->APB2ENR, (RCC_APB2ENR_DBGMCUEN))
  538. #define __HAL_RCC_SYSCFG_CLK_DISABLE() CLEAR_BIT(RCC->APB2ENR, (RCC_APB2ENR_SYSCFGEN))
  539. #define __HAL_RCC_DBGMCU_CLK_DISABLE() CLEAR_BIT(RCC->APB2ENR, (RCC_APB2ENR_DBGMCUEN))
  540. /**
  541. * @}
  542. */
  543. /** @defgroup RCC_AHB_Peripheral_Clock_Enable_Disable_Status AHB Peripheral Clock Enabled or Disabled Status
  544. * @brief Check whether the AHB peripheral clock is enabled or not.
  545. * @note After reset, the peripheral clock (used for registers read/write access)
  546. * is disabled and the application software has to enable this clock before
  547. * using it.
  548. * @{
  549. */
  550. #define __HAL_RCC_DMA1_IS_CLK_ENABLED() (READ_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN) != RESET)
  551. #define __HAL_RCC_MIF_IS_CLK_ENABLED() (READ_BIT(RCC->AHBENR, RCC_AHBENR_MIFEN) != RESET)
  552. #define __HAL_RCC_CRC_IS_CLK_ENABLED() (READ_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN) != RESET)
  553. /**
  554. * @}
  555. */
  556. /** @defgroup RCC_IOPORT_Peripheral_Clock_Enable_Disable_Status IOPORT Peripheral Clock Enabled or Disabled Status
  557. * @brief Check whether the IOPORT peripheral clock is enabled or not.
  558. * @note After reset, the peripheral clock (used for registers read/write access)
  559. * is disabled and the application software has to enable this clock before
  560. * using it.
  561. * @{
  562. */
  563. #define __HAL_RCC_GPIOA_IS_CLK_ENABLED() (READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOAEN) != RESET)
  564. #define __HAL_RCC_GPIOB_IS_CLK_ENABLED() (READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOBEN) != RESET)
  565. #define __HAL_RCC_GPIOC_IS_CLK_ENABLED() (READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOCEN) != RESET)
  566. #define __HAL_RCC_GPIOH_IS_CLK_ENABLED() (READ_BIT(RCC->IOPENR, RCC_IOPENR_GPIOHEN) != RESET)
  567. /**
  568. * @}
  569. */
  570. /** @defgroup RCC_APB1_Clock_Enable_Disable_Status APB1 Peripheral Clock Enabled or Disabled Status
  571. * @brief Check whether the APB1 peripheral clock is enabled or not.
  572. * @note After reset, the peripheral clock (used for registers read/write access)
  573. * is disabled and the application software has to enable this clock before
  574. * using it.
  575. * @{
  576. */
  577. #define __HAL_RCC_WWDG_IS_CLK_ENABLED() (READ_BIT(RCC->APB1ENR, RCC_APB1ENR_WWDGEN) != RESET)
  578. #define __HAL_RCC_PWR_IS_CLK_ENABLED() (READ_BIT(RCC->APB1ENR, RCC_APB1ENR_PWREN) != RESET)
  579. /**
  580. * @}
  581. */
  582. /** @defgroup RCC_APB2_Clock_Enable_Disable_Status APB2 Peripheral Clock Enabled or Disabled Status
  583. * @brief Check whether the APB2 peripheral clock is enabled or not.
  584. * @note After reset, the peripheral clock (used for registers read/write access)
  585. * is disabled and the application software has to enable this clock before
  586. * using it.
  587. * @{
  588. */
  589. #define __HAL_RCC_SYSCFG_IS_CLK_ENABLED() (READ_BIT(RCC->APB2ENR, RCC_APB2ENR_SYSCFGEN) != RESET)
  590. #define __HAL_RCC_DBGMCU_IS_CLK_ENABLED() (READ_BIT(RCC->APB2ENR, RCC_APB2ENR_DBGMCUEN) != RESET)
  591. /**
  592. * @}
  593. */
  594. /** @defgroup RCC_AHB_Force_Release_Reset AHB Peripheral Force Release Reset
  595. * @brief Force or release AHB peripheral reset.
  596. * @{
  597. */
  598. #define __HAL_RCC_AHB_FORCE_RESET() (RCC->AHBRSTR = 0xFFFFFFFFU)
  599. #define __HAL_RCC_DMA1_FORCE_RESET() SET_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_DMA1RST))
  600. #define __HAL_RCC_MIF_FORCE_RESET() SET_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_MIFRST))
  601. #define __HAL_RCC_CRC_FORCE_RESET() SET_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_CRCRST))
  602. #define __HAL_RCC_AHB_RELEASE_RESET() (RCC->AHBRSTR = 0x00U)
  603. #define __HAL_RCC_CRC_RELEASE_RESET() CLEAR_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_CRCRST))
  604. #define __HAL_RCC_DMA1_RELEASE_RESET() CLEAR_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_DMA1RST))
  605. #define __HAL_RCC_MIF_RELEASE_RESET() CLEAR_BIT(RCC->AHBRSTR, (RCC_AHBRSTR_MIFRST))
  606. /**
  607. * @}
  608. */
  609. /** @defgroup RCC_IOPORT_Force_Release_Reset IOPORT Peripheral Force Release Reset
  610. * @brief Force or release IOPORT peripheral reset.
  611. * @{
  612. */
  613. #define __HAL_RCC_IOP_FORCE_RESET() (RCC->IOPRSTR = 0xFFFFFFFFU)
  614. #define __HAL_RCC_GPIOA_FORCE_RESET() SET_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOARST))
  615. #define __HAL_RCC_GPIOB_FORCE_RESET() SET_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOBRST))
  616. #define __HAL_RCC_GPIOC_FORCE_RESET() SET_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOCRST))
  617. #define __HAL_RCC_GPIOH_FORCE_RESET() SET_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOHRST))
  618. #define __HAL_RCC_IOP_RELEASE_RESET() (RCC->IOPRSTR = 0x00U)
  619. #define __HAL_RCC_GPIOA_RELEASE_RESET() CLEAR_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOARST))
  620. #define __HAL_RCC_GPIOB_RELEASE_RESET() CLEAR_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOBRST))
  621. #define __HAL_RCC_GPIOC_RELEASE_RESET() CLEAR_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOCRST))
  622. #define __HAL_RCC_GPIOH_RELEASE_RESET() CLEAR_BIT(RCC->IOPRSTR, (RCC_IOPRSTR_GPIOHRST))
  623. /**
  624. * @}
  625. */
  626. /** @defgroup RCC_APB1_Force_Release_Reset APB1 Peripheral Force Release Reset
  627. * @brief Force or release APB1 peripheral reset.
  628. * @{
  629. */
  630. #define __HAL_RCC_APB1_FORCE_RESET() (RCC->APB1RSTR = 0xFFFFFFFFU)
  631. #define __HAL_RCC_WWDG_FORCE_RESET() SET_BIT(RCC->APB1RSTR, (RCC_APB1RSTR_WWDGRST))
  632. #define __HAL_RCC_PWR_FORCE_RESET() SET_BIT(RCC->APB1RSTR, (RCC_APB1RSTR_PWRRST))
  633. #define __HAL_RCC_APB1_RELEASE_RESET() (RCC->APB1RSTR = 0x00U)
  634. #define __HAL_RCC_WWDG_RELEASE_RESET() CLEAR_BIT(RCC->APB1RSTR, (RCC_APB1RSTR_WWDGRST))
  635. #define __HAL_RCC_PWR_RELEASE_RESET() CLEAR_BIT(RCC->APB1RSTR, (RCC_APB1RSTR_PWRRST))
  636. /**
  637. * @}
  638. */
  639. /** @defgroup RCC_APB2_Force_Release_Reset APB2 Peripheral Force Release Reset
  640. * @brief Force or release APB2 peripheral reset.
  641. * @{
  642. */
  643. #define __HAL_RCC_APB2_FORCE_RESET() (RCC->APB2RSTR = 0xFFFFFFFFU)
  644. #define __HAL_RCC_DBGMCU_FORCE_RESET() SET_BIT(RCC->APB2RSTR, (RCC_APB2RSTR_DBGMCURST))
  645. #define __HAL_RCC_SYSCFG_FORCE_RESET() SET_BIT(RCC->APB2RSTR, (RCC_APB2RSTR_SYSCFGRST))
  646. #define __HAL_RCC_APB2_RELEASE_RESET() (RCC->APB2RSTR = 0x00U)
  647. #define __HAL_RCC_DBGMCU_RELEASE_RESET() CLEAR_BIT(RCC->APB2RSTR, (RCC_APB2RSTR_DBGMCURST))
  648. #define __HAL_RCC_SYSCFG_RELEASE_RESET() CLEAR_BIT(RCC->APB2RSTR, (RCC_APB2RSTR_SYSCFGRST))
  649. /**
  650. * @}
  651. */
  652. /** @defgroup RCC_AHB_Clock_Sleep_Enable_Disable AHB Peripheral Clock Sleep Enable Disable
  653. * @brief Enable or disable the AHB peripheral clock during Low Power (Sleep) mode.
  654. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  655. * power consumption.
  656. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  657. * @note By default, all peripheral activated clocks remain enabled during SLEEP mode.
  658. * @{
  659. */
  660. #define __HAL_RCC_CRC_CLK_SLEEP_ENABLE() SET_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_CRCSMEN))
  661. #define __HAL_RCC_MIF_CLK_SLEEP_ENABLE() SET_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_MIFSMEN))
  662. #define __HAL_RCC_SRAM_CLK_SLEEP_ENABLE() SET_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_SRAMSMEN))
  663. #define __HAL_RCC_DMA1_CLK_SLEEP_ENABLE() SET_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_DMA1SMEN))
  664. #define __HAL_RCC_CRC_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_CRCSMEN))
  665. #define __HAL_RCC_MIF_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_MIFSMEN))
  666. #define __HAL_RCC_SRAM_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_SRAMSMEN))
  667. #define __HAL_RCC_DMA1_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->AHBSMENR, (RCC_AHBSMENR_DMA1SMEN))
  668. /**
  669. * @}
  670. */
  671. /** @defgroup RCC_IOPORT_Clock_Sleep_Enable_Disable IOPORT Peripheral Clock Sleep Enable Disable
  672. * @brief Enable or disable the IOPORT peripheral clock during Low Power (Sleep) mode.
  673. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  674. * power consumption.
  675. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  676. * @note By default, all peripheral activated clocks remain enabled during SLEEP mode.
  677. * @{
  678. */
  679. #define __HAL_RCC_GPIOA_CLK_SLEEP_ENABLE() SET_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOASMEN))
  680. #define __HAL_RCC_GPIOB_CLK_SLEEP_ENABLE() SET_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOBSMEN))
  681. #define __HAL_RCC_GPIOC_CLK_SLEEP_ENABLE() SET_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOCSMEN))
  682. #define __HAL_RCC_GPIOH_CLK_SLEEP_ENABLE() SET_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOHSMEN))
  683. #define __HAL_RCC_GPIOA_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOASMEN))
  684. #define __HAL_RCC_GPIOB_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOBSMEN))
  685. #define __HAL_RCC_GPIOC_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOCSMEN))
  686. #define __HAL_RCC_GPIOH_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->IOPSMENR, (RCC_IOPSMENR_GPIOHSMEN))
  687. /**
  688. * @}
  689. */
  690. /** @defgroup RCC_APB1_Clock_Sleep_Enable_Disable APB1 Peripheral Clock Sleep Enable Disable
  691. * @brief Enable or disable the APB1 peripheral clock during Low Power (Sleep) mode.
  692. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  693. * power consumption.
  694. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  695. * @note By default, all peripheral activated clocks remain enabled during SLEEP mode.
  696. * @{
  697. */
  698. #define __HAL_RCC_WWDG_CLK_SLEEP_ENABLE() SET_BIT(RCC->APB1SMENR, (RCC_APB1SMENR_WWDGSMEN))
  699. #define __HAL_RCC_PWR_CLK_SLEEP_ENABLE() SET_BIT(RCC->APB1SMENR, (RCC_APB1SMENR_PWRSMEN))
  700. #define __HAL_RCC_WWDG_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->APB1SMENR, (RCC_APB1SMENR_WWDGSMEN))
  701. #define __HAL_RCC_PWR_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->APB1SMENR, (RCC_APB1SMENR_PWRSMEN))
  702. /**
  703. * @}
  704. */
  705. /** @defgroup RCC_APB2_Clock_Sleep_Enable_Disable APB2 Peripheral Clock Sleep Enable Disable
  706. * @brief Enable or disable the APB2 peripheral clock during Low Power (Sleep) mode.
  707. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  708. * power consumption.
  709. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  710. * @note By default, all peripheral activated clocks remain enabled during SLEEP mode.
  711. * @{
  712. */
  713. #define __HAL_RCC_SYSCFG_CLK_SLEEP_ENABLE() SET_BIT(RCC->APB2SMENR, (RCC_APB2SMENR_SYSCFGSMEN))
  714. #define __HAL_RCC_DBGMCU_CLK_SLEEP_ENABLE() SET_BIT(RCC->APB2SMENR, (RCC_APB2SMENR_DBGMCUSMEN))
  715. #define __HAL_RCC_SYSCFG_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->APB2SMENR, (RCC_APB2SMENR_SYSCFGSMEN))
  716. #define __HAL_RCC_DBGMCU_CLK_SLEEP_DISABLE() CLEAR_BIT(RCC->APB2SMENR, (RCC_APB2SMENR_DBGMCUSMEN))
  717. /**
  718. * @}
  719. */
  720. /** @defgroup RCC_AHB_Clock_Sleep_Enable_Disable_Status AHB Peripheral Clock Sleep Enabled or Disabled Status
  721. * @brief Check whether the AHB peripheral clock during Low Power (Sleep) mode is enabled or not.
  722. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  723. * power consumption.
  724. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  725. * @note By default, all peripheral clocks are enabled during SLEEP mode.
  726. * @{
  727. */
  728. #define __HAL_RCC_CRC_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->AHBSMENR, RCC_AHBSMENR_CRCSMEN) != RESET)
  729. #define __HAL_RCC_MIF_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->AHBSMENR, RCC_AHBSMENR_MIFSMEN) != RESET)
  730. #define __HAL_RCC_SRAM_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->AHBSMENR, RCC_AHBSMENR_SRAMSMEN) != RESET)
  731. #define __HAL_RCC_DMA1_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->AHBSMENR, RCC_AHBSMENR_DMA1SMEN) != RESET)
  732. /**
  733. * @}
  734. */
  735. /** @defgroup RCC_IOPORT_Clock_Sleep_Enable_Disable_Status IOPORT Peripheral Clock Sleep Enabled or Disabled Status
  736. * @brief Check whether the IOPORT peripheral clock during Low Power (Sleep) mode is enabled or not.
  737. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  738. * power consumption.
  739. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  740. * @note By default, all peripheral clocks are enabled during SLEEP mode.
  741. * @{
  742. */
  743. #define __HAL_RCC_GPIOA_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->IOPSMENR, RCC_IOPSMENR_GPIOASMEN) != RESET)
  744. #define __HAL_RCC_GPIOB_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->IOPSMENR, RCC_IOPSMENR_GPIOBSMEN) != RESET)
  745. #define __HAL_RCC_GPIOC_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->IOPSMENR, RCC_IOPSMENR_GPIOCSMEN) != RESET)
  746. #define __HAL_RCC_GPIOH_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->IOPSMENR, RCC_IOPSMENR_GPIOHSMEN) != RESET)
  747. /**
  748. * @}
  749. */
  750. /** @defgroup RCC_APB1_Clock_Sleep_Enable_Disable_Status APB1 Peripheral Clock Sleep Enabled or Disabled Status
  751. * @brief Check whether the APB1 peripheral clock during Low Power (Sleep) mode is enabled or not.
  752. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  753. * power consumption.
  754. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  755. * @note By default, all peripheral clocks are enabled during SLEEP mode.
  756. * @{
  757. */
  758. #define __HAL_RCC_WWDG_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->APB1SMENR, RCC_APB1SMENR_WWDGSMEN) != RESET)
  759. #define __HAL_RCC_PWR_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->APB1SMENR, RCC_APB1SMENR_PWRSMEN) != RESET)
  760. /**
  761. * @}
  762. */
  763. /** @defgroup RCC_APB2_Clock_Sleep_Enable_Disable_Status APB2 Peripheral Clock Sleep Enabled or Disabled Status
  764. * @brief Check whether the APB2 peripheral clock during Low Power (Sleep) mode is enabled or not.
  765. * @note Peripheral clock gating in SLEEP mode can be used to further reduce
  766. * power consumption.
  767. * @note After wakeup from SLEEP mode, the peripheral clock is enabled again.
  768. * @note By default, all peripheral clocks are enabled during SLEEP mode.
  769. * @{
  770. */
  771. #define __HAL_RCC_SYSCFG_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->APB2SMENR, RCC_APB2SMENR_SYSCFGSMEN) != RESET)
  772. #define __HAL_RCC_DBGMCU_IS_CLK_SLEEP_ENABLED() (READ_BIT(RCC->APB2SMENR, RCC_APB2SMENR_DBGMCUSMEN) != RESET)
  773. /**
  774. * @}
  775. */
  776. /** @defgroup RCC_Backup_Domain_Reset RCC Backup Domain Reset
  777. * @{
  778. */
  779. /** @brief Macros to force or release the Backup domain reset.
  780. * @note This function resets the RTC peripheral (including the backup registers)
  781. * and the RTC clock source selection in RCC_CSR register.
  782. * @note The BKPSRAM is not affected by this reset.
  783. */
  784. #define __HAL_RCC_BACKUPRESET_FORCE() SET_BIT(RCC->CSR, RCC_CSR_RTCRST)
  785. #define __HAL_RCC_BACKUPRESET_RELEASE() CLEAR_BIT(RCC->CSR, RCC_CSR_RTCRST)
  786. /**
  787. * @}
  788. */
  789. /** @defgroup RCC_RTC_Clock_Configuration RCC RTC Clock Configuration
  790. * @{
  791. */
  792. /** @brief Macros to enable or disable the the RTC clock.
  793. * @note These macros must be used only after the RTC clock source was selected.
  794. */
  795. #define __HAL_RCC_RTC_ENABLE() SET_BIT(RCC->CSR, RCC_CSR_RTCEN)
  796. #define __HAL_RCC_RTC_DISABLE() CLEAR_BIT(RCC->CSR, RCC_CSR_RTCEN)
  797. /**
  798. * @}
  799. */
  800. /** @brief Macros to enable or disable the Internal High Speed oscillator (HSI).
  801. * @note The HSI is stopped by hardware when entering STOP and STANDBY modes.
  802. * It is used (enabled by hardware) as system clock source after startup
  803. * from Reset, wakeup from STOP and STANDBY mode, or in case of failure
  804. * of the HSE used directly or indirectly as system clock (if the Clock
  805. * Security System CSS is enabled).
  806. * @note HSI can not be stopped if it is used as system clock source. In this case,
  807. * you have to select another source of the system clock then stop the HSI.
  808. * @note After enabling the HSI, the application software should wait on HSIRDY
  809. * flag to be set indicating that HSI clock is stable and can be used as
  810. * system clock source.
  811. * @note When the HSI is stopped, HSIRDY flag goes low after 6 HSI oscillator
  812. * clock cycles.
  813. */
  814. #define __HAL_RCC_HSI_ENABLE() SET_BIT(RCC->CR, RCC_CR_HSION)
  815. #define __HAL_RCC_HSI_DISABLE() CLEAR_BIT(RCC->CR, RCC_CR_HSION)
  816. /** @brief Macro to adjust the Internal High Speed oscillator (HSI) calibration value.
  817. * @note The calibration is used to compensate for the variations in voltage
  818. * and temperature that influence the frequency of the internal HSI RC.
  819. * @param __HSICalibrationValue__: specifies the calibration trimming value.
  820. * This parameter must be a number between 0 and 0x1F.
  821. */
  822. #define __HAL_RCC_HSI_CALIBRATIONVALUE_ADJUST(__HSICalibrationValue__) (MODIFY_REG(RCC->ICSCR,\
  823. RCC_ICSCR_HSITRIM, (uint32_t)(__HSICalibrationValue__) << 8U))
  824. /** @brief Macro to enable or disable the Internal High Speed oscillator (HSI).
  825. * @note After enabling the HSI, the application software should wait on
  826. * HSIRDY flag to be set indicating that HSI clock is stable and can
  827. * be used to clock the PLL and/or system clock.
  828. * @note HSI can not be stopped if it is used directly or through the PLL
  829. * as system clock. In this case, you have to select another source
  830. * of the system clock then stop the HSI.
  831. * @note The HSI is stopped by hardware when entering STOP and STANDBY modes.
  832. * @param __STATE__: specifies the new state of the HSI.
  833. * This parameter can be one of the following values:
  834. * @arg RCC_HSI_OFF: turn OFF the HSI oscillator
  835. * @arg RCC_HSI_ON: turn ON the HSI oscillator
  836. * @arg RCC_HSI_DIV4: turn ON the HSI oscillator and divide it by 4
  837. * @note When the HSI is stopped, HSIRDY flag goes low after 6 HSI oscillator
  838. * clock cycles.
  839. */
  840. #define __HAL_RCC_HSI_CONFIG(__STATE__) \
  841. MODIFY_REG(RCC->CR, RCC_CR_HSION | RCC_CR_HSIDIVEN , (uint32_t)(__STATE__))
  842. /**
  843. * @brief Macros to enable or disable the Internal Multi Speed oscillator (MSI).
  844. * @note The MSI is stopped by hardware when entering STOP and STANDBY modes.
  845. * It is used (enabled by hardware) as system clock source after
  846. * startup from Reset, wakeup from STOP and STANDBY mode, or in case
  847. * of failure of the HSE used directly or indirectly as system clock
  848. * (if the Clock Security System CSS is enabled).
  849. * @note MSI can not be stopped if it is used as system clock source.
  850. * In this case, you have to select another source of the system
  851. * clock then stop the MSI.
  852. * @note After enabling the MSI, the application software should wait on
  853. * MSIRDY flag to be set indicating that MSI clock is stable and can
  854. * be used as system clock source.
  855. * @note When the MSI is stopped, MSIRDY flag goes low after 6 MSI oscillator
  856. * clock cycles.
  857. */
  858. #define __HAL_RCC_MSI_ENABLE() SET_BIT(RCC->CR, RCC_CR_MSION)
  859. #define __HAL_RCC_MSI_DISABLE() CLEAR_BIT(RCC->CR, RCC_CR_MSION)
  860. /** @brief Macro Adjusts the Internal Multi Speed oscillator (MSI) calibration value.
  861. * @note The calibration is used to compensate for the variations in voltage
  862. * and temperature that influence the frequency of the internal MSI RC.
  863. * Refer to the Application Note AN3300 for more details on how to
  864. * calibrate the MSI.
  865. * @param __MSICalibrationValue__: specifies the calibration trimming value.
  866. * This parameter must be a number between 0 and 0xFF.
  867. */
  868. #define __HAL_RCC_MSI_CALIBRATIONVALUE_ADJUST(__MSICalibrationValue__) (MODIFY_REG(RCC->ICSCR,\
  869. RCC_ICSCR_MSITRIM, (uint32_t)(__MSICalibrationValue__) << 24U))
  870. /**
  871. * @brief Macro to configures the Internal Multi Speed oscillator (MSI) clock range.
  872. * @note After restart from Reset or wakeup from STANDBY, the MSI clock is
  873. * around 2.097 MHz. The MSI clock does not change after wake-up from
  874. * STOP mode.
  875. * @note The MSI clock range can be modified on the fly.
  876. * @param __RCC_MSIRange__: specifies the MSI Clock range.
  877. * This parameter must be one of the following values:
  878. * @arg RCC_MSIRANGE_0: MSI clock is around 65.536 KHz
  879. * @arg RCC_MSIRANGE_1: MSI clock is around 131.072 KHz
  880. * @arg RCC_MSIRANGE_2: MSI clock is around 262.144 KHz
  881. * @arg RCC_MSIRANGE_3: MSI clock is around 524.288 KHz
  882. * @arg RCC_MSIRANGE_4: MSI clock is around 1.048 MHz
  883. * @arg RCC_MSIRANGE_5: MSI clock is around 2.097 MHz (default after Reset or wake-up from STANDBY)
  884. * @arg RCC_MSIRANGE_6: MSI clock is around 4.194 MHz
  885. */
  886. #define __HAL_RCC_MSI_RANGE_CONFIG(__RCC_MSIRange__) (MODIFY_REG(RCC->ICSCR,\
  887. RCC_ICSCR_MSIRANGE, (uint32_t)(__RCC_MSIRange__) ))
  888. /** @brief Macro to get the Internal Multi Speed oscillator (__MSI__) clock range in run mode
  889. * @retval MSI clock range.
  890. * This parameter must be one of the following values:
  891. * @arg RCC_MSIRANGE_0: MSI clock is around 65.536 KHz
  892. * @arg RCC_MSIRANGE_1: MSI clock is around 131.072 KHz
  893. * @arg RCC_MSIRANGE_2: MSI clock is around 262.144 KHz
  894. * @arg RCC_MSIRANGE_3: MSI clock is around 524.288 KHz
  895. * @arg RCC_MSIRANGE_4: MSI clock is around 1.048 MHz
  896. * @arg RCC_MSIRANGE_5: MSI clock is around 2.097 MHz (default after Reset or wake-up from STANDBY)
  897. * @arg RCC_MSIRANGE_6: MSI clock is around 4.194 MHz
  898. */
  899. #define __HAL_RCC_GET_MSI_RANGE() \
  900. ((uint32_t)(READ_BIT(RCC->ICSCR, RCC_ICSCR_MSIRANGE) >> 12U))
  901. /** @brief Macros to enable or disable the Internal Low Speed oscillator (LSI).
  902. * @note After enabling the LSI, the application software should wait on
  903. * LSIRDY flag to be set indicating that LSI clock is stable and can
  904. * be used to clock the IWDG and/or the RTC.
  905. * @note LSI can not be disabled if the IWDG is running.
  906. * @note When the LSI is stopped, LSIRDY flag goes low after 6 LSI oscillator
  907. * clock cycles.
  908. */
  909. #define __HAL_RCC_LSI_ENABLE() SET_BIT(RCC->CSR, RCC_CSR_LSION)
  910. #define __HAL_RCC_LSI_DISABLE() CLEAR_BIT(RCC->CSR, RCC_CSR_LSION)
  911. /**
  912. * @brief Macro to configure the External High Speed oscillator (HSE).
  913. * @note Transition HSE Bypass to HSE On and HSE On to HSE Bypass are not
  914. * supported by this macro. User should request a transition to HSE Off
  915. * first and then HSE On or HSE Bypass.
  916. * @note After enabling the HSE (RCC_HSE_ON or RCC_HSE_Bypass), the application
  917. * software should wait on HSERDY flag to be set indicating that HSE clock
  918. * is stable and can be used to clock the PLL and/or system clock.
  919. * @note HSE state can not be changed if it is used directly or through the
  920. * PLL as system clock. In this case, you have to select another source
  921. * of the system clock then change the HSE state (ex. disable it).
  922. * @note The HSE is stopped by hardware when entering STOP and STANDBY modes.
  923. * @note This function reset the CSSON bit, so if the clock security system(CSS)
  924. * was previously enabled you have to enable it again after calling this
  925. * function.
  926. * @param __STATE__: specifies the new state of the HSE.
  927. * This parameter can be one of the following values:
  928. * @arg RCC_HSE_OFF: turn OFF the HSE oscillator, HSERDY flag goes low after
  929. * 6 HSE oscillator clock cycles.
  930. * @arg RCC_HSE_ON: turn ON the HSE oscillator.
  931. * @arg RCC_HSE_BYPASS: HSE oscillator bypassed with external clock.
  932. */
  933. #define __HAL_RCC_HSE_CONFIG(__STATE__) \
  934. do { \
  935. __IO uint32_t tmpreg; \
  936. if((__STATE__) == RCC_HSE_ON) \
  937. { \
  938. SET_BIT(RCC->CR, RCC_CR_HSEON); \
  939. } \
  940. else if((__STATE__) == RCC_HSE_BYPASS) \
  941. { \
  942. CLEAR_BIT(RCC->CR, RCC_CR_HSEON); \
  943. SET_BIT(RCC->CR, RCC_CR_HSEBYP); \
  944. SET_BIT(RCC->CR, RCC_CR_HSEON); \
  945. } \
  946. else \
  947. { \
  948. CLEAR_BIT(RCC->CR, RCC_CR_HSEON); \
  949. /* Delay after an RCC peripheral clock */ \
  950. tmpreg = READ_BIT(RCC->CR, RCC_CR_HSEON); \
  951. UNUSED(tmpreg); \
  952. CLEAR_BIT(RCC->CR, RCC_CR_HSEBYP); \
  953. } \
  954. } while(0)
  955. /**
  956. * @brief Macro to configure the External Low Speed oscillator (LSE).
  957. * @note Transitions LSE Bypass to LSE On and LSE On to LSE Bypass are not
  958. * supported by this macro. User should request a transition to LSE Off
  959. * first and then LSE On or LSE Bypass.
  960. * @note As the LSE is in the Backup domain and write access is denied to
  961. * this domain after reset, you have to enable write access using
  962. * HAL_PWR_EnableBkUpAccess() function before to configure the LSE
  963. * (to be done once after reset).
  964. * @note After enabling the LSE (RCC_LSE_ON or RCC_LSE_BYPASS), the application
  965. * software should wait on LSERDY flag to be set indicating that LSE clock
  966. * is stable and can be used to clock the RTC.
  967. * @param __STATE__: specifies the new state of the LSE.
  968. * This parameter can be one of the following values:
  969. * @arg RCC_LSE_OFF: turn OFF the LSE oscillator, LSERDY flag goes low after
  970. * 6 LSE oscillator clock cycles.
  971. * @arg RCC_LSE_ON: turn ON the LSE oscillator.
  972. * @arg RCC_LSE_BYPASS: LSE oscillator bypassed with external clock.
  973. */
  974. #define __HAL_RCC_LSE_CONFIG(__STATE__) \
  975. do { \
  976. if((__STATE__) == RCC_LSE_ON) \
  977. { \
  978. SET_BIT(RCC->CSR, RCC_CSR_LSEON); \
  979. } \
  980. else if((__STATE__) == RCC_LSE_OFF) \
  981. { \
  982. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEON); \
  983. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEBYP); \
  984. } \
  985. else if((__STATE__) == RCC_LSE_BYPASS) \
  986. { \
  987. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEON); \
  988. SET_BIT(RCC->CSR, RCC_CSR_LSEBYP); \
  989. SET_BIT(RCC->CSR, RCC_CSR_LSEON); \
  990. } \
  991. else \
  992. { \
  993. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEON); \
  994. CLEAR_BIT(RCC->CSR, RCC_CSR_LSEBYP); \
  995. } \
  996. } while(0)
  997. /**
  998. * @brief Configures or Get the RTC and LCD clock (RTCCLK / LCDCLK).
  999. * @note As the RTC clock configuration bits are in the RTC domain and write
  1000. * access is denied to this domain after reset, you have to enable write
  1001. * access using PWR_RTCAccessCmd(ENABLE) function before to configure
  1002. * the RTC clock source (to be done once after reset).
  1003. * @note Once the RTC clock is configured it cannot be changed unless the RTC
  1004. * is reset using RCC_RTCResetCmd function, or by a Power On Reset (POR)
  1005. * @note The RTC clock (RTCCLK) is used also to clock the LCD (LCDCLK).
  1006. *
  1007. * @param __RTCCLKSOURCE__: specifies the RTC clock source.
  1008. * This parameter can be one of the following values:
  1009. * @arg RCC_RTCCLKSOURCE_LSE: LSE selected as RTC clock
  1010. * @arg RCC_RTCCLKSOURCE_LSI: LSI selected as RTC clock
  1011. * @arg RCC_RTCCLKSOURCE_HSE_DIV2: HSE divided by 2 selected as RTC clock
  1012. * @arg RCC_RTCCLKSOURCE_HSE_DIV4: HSE divided by 4 selected as RTC clock
  1013. * @arg RCC_RTCCLKSOURCE_HSE_DIV8: HSE divided by 8 selected as RTC clock
  1014. * @arg RCC_RTCCLKSOURCE_HSE_DIV16: HSE divided by 16 selected as RTC clock
  1015. *
  1016. * @note If the LSE or LSI is used as RTC clock source, the RTC continues to
  1017. * work in STOP and STANDBY modes, and can be used as wakeup source.
  1018. * However, when the HSE clock is used as RTC clock source, the RTC
  1019. * cannot be used in STOP and STANDBY modes.
  1020. * @note The maximum input clock frequency for RTC is 1MHz (when using HSE as
  1021. * RTC clock source).
  1022. */
  1023. #define __HAL_RCC_RTC_CLKPRESCALER(__RTCCLKSOURCE__) (((__RTCCLKSOURCE__) & RCC_CSR_RTCSEL) == RCC_CSR_RTCSEL) ? \
  1024. MODIFY_REG(RCC->CR, RCC_CR_RTCPRE, (uint32_t)((__RTCCLKSOURCE__) & RCC_CR_RTCPRE)) : \
  1025. CLEAR_BIT(RCC->CR, RCC_CR_RTCPRE)
  1026. #define __HAL_RCC_RTC_CONFIG(__RTCCLKSOURCE__) do { __HAL_RCC_RTC_CLKPRESCALER(__RTCCLKSOURCE__); \
  1027. MODIFY_REG( RCC->CSR, RCC_CSR_RTCSEL, (uint32_t)((__RTCCLKSOURCE__) & RCC_CSR_RTCSEL)); \
  1028. } while (0)
  1029. /**
  1030. * @brief Get the RTC and LCD clock (RTCCLK / LCDCLK).
  1031. *
  1032. * @retval The clock source can be one of the following values:
  1033. * @arg RCC_RTCCLKSOURCE_NO_CLK: No clock selected as RTC clock
  1034. * @arg RCC_RTCCLKSOURCE_LSE: LSE selected as RTC clock
  1035. * @arg RCC_RTCCLKSOURCE_LSI: LSI selected as RTC clock
  1036. * @arg RCC_RTCCLKSOURCE_HSE_DIVX: HSE divided by X selected as RTC clock (X can be retrieved thanks to @ref __HAL_RCC_GET_RTC_HSE_PRESCALER()
  1037. *
  1038. */
  1039. #define __HAL_RCC_GET_RTC_SOURCE() ((uint32_t)(READ_BIT(RCC->CSR, RCC_CSR_RTCSEL)))
  1040. /**
  1041. * @brief Get the RTC and LCD HSE clock divider (RTCCLK / LCDCLK).
  1042. *
  1043. * @retval Returned value can be one of the following values:
  1044. * @arg RCC_RTC_HSE_DIV_2: HSE divided by 2 selected as RTC clock
  1045. * @arg RCC_RTC_HSE_DIV_4: HSE divided by 4 selected as RTC clock
  1046. * @arg RCC_RTC_HSE_DIV_8: HSE divided by 8 selected as RTC clock
  1047. * @arg RCC_RTC_HSE_DIV_16: HSE divided by 16 selected as RTC clock
  1048. *
  1049. */
  1050. #define __HAL_RCC_GET_RTC_HSE_PRESCALER() ((uint32_t)(READ_BIT(RCC->CR, RCC_CR_RTCPRE)))
  1051. /** @brief Macros to enable or disable the main PLL.
  1052. * @note After enabling the main PLL, the application software should wait on
  1053. * PLLRDY flag to be set indicating that PLL clock is stable and can
  1054. * be used as system clock source.
  1055. * @note The main PLL can not be disabled if it is used as system clock source
  1056. * @note The main PLL is disabled by hardware when entering STOP and STANDBY modes.
  1057. */
  1058. #define __HAL_RCC_PLL_ENABLE() SET_BIT(RCC->CR, RCC_CR_PLLON)
  1059. #define __HAL_RCC_PLL_DISABLE() CLEAR_BIT(RCC->CR, RCC_CR_PLLON)
  1060. /** @brief Macro to configure the main PLL clock source, multiplication and division factors.
  1061. * @note This function must be used only when the main PLL is disabled.
  1062. * @param __RCC_PLLSOURCE__: specifies the PLL entry clock source.
  1063. * This parameter can be one of the following values:
  1064. * @arg RCC_PLLSOURCE_HSI: HSI oscillator clock selected as PLL clock entry
  1065. * @arg RCC_PLLSOURCE_HSE: HSE oscillator clock selected as PLL clock entry
  1066. * @param __PLLMUL__: specifies the multiplication factor to generate the PLL VCO clock
  1067. * This parameter must be one of the following values:
  1068. * @arg RCC_CFGR_PLLMUL3: PLLVCO = PLL clock entry x 3
  1069. * @arg RCC_CFGR_PLLMUL4: PLLVCO = PLL clock entry x 4
  1070. * @arg RCC_CFGR_PLLMUL6: PLLVCO = PLL clock entry x 6
  1071. * @arg RCC_CFGR_PLLMUL8: PLLVCO = PLL clock entry x 8
  1072. * @arg RCC_CFGR_PLLMUL12: PLLVCO = PLL clock entry x 12
  1073. * @arg RCC_CFGR_PLLMUL16: PLLVCO = PLL clock entry x 16
  1074. * @arg RCC_CFGR_PLLMUL24: PLLVCO = PLL clock entry x 24
  1075. * @arg RCC_CFGR_PLLMUL32: PLLVCO = PLL clock entry x 32
  1076. * @arg RCC_CFGR_PLLMUL48: PLLVCO = PLL clock entry x 48
  1077. * @note The PLL VCO clock frequency must not exceed 96 MHz when the product is in
  1078. * Range 1, 48 MHz when the product is in Range 2 and 24 MHz when the product is
  1079. * in Range 3.
  1080. * @param __PLLDIV__: specifies the PLL output clock division from PLL VCO clock
  1081. * This parameter must be one of the following values:
  1082. * @arg RCC_PLLDIV_2: PLL clock output = PLLVCO / 2
  1083. * @arg RCC_PLLDIV_3: PLL clock output = PLLVCO / 3
  1084. * @arg RCC_PLLDIV_4: PLL clock output = PLLVCO / 4
  1085. */
  1086. #define __HAL_RCC_PLL_CONFIG(__RCC_PLLSOURCE__ , __PLLMUL__ ,__PLLDIV__ ) \
  1087. MODIFY_REG(RCC->CFGR, RCC_CFGR_PLLMUL | RCC_CFGR_PLLDIV | RCC_CFGR_PLLSRC, (uint32_t)((__PLLMUL__)| (__PLLDIV__)| (__RCC_PLLSOURCE__)))
  1088. /** @brief Macro to get the oscillator used as PLL clock source.
  1089. * @retval The oscillator used as PLL clock source. The returned value can be one
  1090. * of the following:
  1091. * - RCC_PLLSOURCE_HSI: HSI oscillator is used as PLL clock source.
  1092. * - RCC_PLLSOURCE_HSE: HSE oscillator is used as PLL clock source.
  1093. */
  1094. #define __HAL_RCC_GET_PLL_OSCSOURCE() ((uint32_t)(RCC->CFGR & RCC_CFGR_PLLSRC))
  1095. /**
  1096. * @brief Macro to configure the system clock source.
  1097. * @param __SYSCLKSOURCE__: specifies the system clock source.
  1098. * This parameter can be one of the following values:
  1099. * - RCC_SYSCLKSOURCE_MSI: MSI oscillator is used as system clock source.
  1100. * - RCC_SYSCLKSOURCE_HSI: HSI oscillator is used as system clock source.
  1101. * - RCC_SYSCLKSOURCE_HSE: HSE oscillator is used as system clock source.
  1102. * - RCC_SYSCLKSOURCE_PLLCLK: PLL output is used as system clock source.
  1103. * @retval None
  1104. */
  1105. #define __HAL_RCC_SYSCLK_CONFIG(__SYSCLKSOURCE__) \
  1106. MODIFY_REG(RCC->CFGR, RCC_CFGR_SW, (__SYSCLKSOURCE__))
  1107. /** @brief Macro to get the clock source used as system clock.
  1108. * @retval The clock source used as system clock. The returned value can be one
  1109. * of the following:
  1110. * - RCC_SYSCLKSOURCE_STATUS_MSI: MSI used as system clock.
  1111. * - RCC_SYSCLKSOURCE_STATUS_HSI: HSI used as system clock.
  1112. * - RCC_SYSCLKSOURCE_STATUS_HSE: HSE used as system clock.
  1113. * - RCC_SYSCLKSOURCE_STATUS_PLLCLK: PLL used as system clock.
  1114. */
  1115. #define __HAL_RCC_GET_SYSCLK_SOURCE() ((uint32_t)(RCC->CFGR & RCC_CFGR_SWS))
  1116. /** @brief Macro to configure the MCO clock.
  1117. * @param __MCOCLKSOURCE__ specifies the MCO clock source.
  1118. * This parameter can be one of the following values:
  1119. * @arg RCC_CFGR_MCO_HSI: HSI clock selected as MCO source
  1120. * @arg RCC_CFGR_MCO_MSI: MSI clock selected as MCO source
  1121. * @arg RCC_CFGR_MCO_HSE: HSE clock selected as MCO source
  1122. * @arg RCC_CFGR_MCO_PLL: PLL clock selected as MCO source
  1123. * @arg RCC_CFGR_MCO_LSI: LSI clock selected as MCO source
  1124. * @arg RCC_CFGR_MCO_LSE: LSE clock selected as MCO source
  1125. * @param __MCODIV__ specifies the MCO clock prescaler.
  1126. * This parameter can be one of the following values:
  1127. * @arg RCC_CFGR_MCO_PRE_1: no division applied to MCO clock
  1128. * @arg RCC_CFGR_MCO_PRE_2: division by 2 applied to MCO clock
  1129. * @arg RCC_CFGR_MCO_PRE_4: division by 4 applied to MCO clock
  1130. * @arg RCC_CFGR_MCO_PRE_8: division by 8 applied to MCO clock
  1131. * @arg RCC_CFGR_MCO_PRE_16: division by 16 applied to MCO clock
  1132. */
  1133. #define __HAL_RCC_MCO1_CONFIG(__MCOCLKSOURCE__, __MCODIV__) \
  1134. MODIFY_REG(RCC->CFGR, (RCC_CFGR_MCOSEL | RCC_CFGR_MCO_PRE), ((__MCOCLKSOURCE__) | (__MCODIV__)))
  1135. /** @defgroup RCC_Flags_Interrupts_Management RCC Flags Interrupts Management
  1136. * @brief macros to manage the specified RCC Flags and interrupts.
  1137. * @{
  1138. */
  1139. /** @brief Enable RCC interrupt (Perform Byte access to RCC_CIER[0:7] bits to enable
  1140. * the selected interrupts).
  1141. * @note The CSS interrupt doesn't have an enable bit; once the CSS is enabled
  1142. * and if the HSE clock fails, the CSS interrupt occurs and an NMI is
  1143. * automatically generated. The NMI will be executed indefinitely, and
  1144. * since NMI has higher priority than any other IRQ (and main program)
  1145. * the application will be stacked in the NMI ISR unless the CSS interrupt
  1146. * pending bit is cleared.
  1147. * @param __INTERRUPT__: specifies the RCC interrupt sources to be enabled.
  1148. * This parameter can be any combination of the following values:
  1149. * @arg RCC_IT_LSIRDY: LSI ready interrupt
  1150. * @arg RCC_IT_LSERDY: LSE ready interrupt
  1151. * @arg RCC_IT_HSIRDY: HSI ready interrupt
  1152. * @arg RCC_IT_HSERDY: HSE ready interrupt
  1153. * @arg RCC_IT_PLLRDY: PLL ready interrupt
  1154. * @arg RCC_IT_MSIRDY: MSI ready interrupt
  1155. * @arg RCC_IT_CSSLSE: LSE CSS interrupt
  1156. * @arg RCC_IT_HSI48RDY: HSI48 ready interrupt
  1157. */
  1158. #define __HAL_RCC_ENABLE_IT(__INTERRUPT__) SET_BIT(RCC->CIER, (__INTERRUPT__))
  1159. /** @brief Disable RCC interrupt (Perform Byte access to RCC_CIER[0:7] bits to disable
  1160. * the selected interrupts).
  1161. * @note The CSS interrupt doesn't have an enable bit; once the CSS is enabled
  1162. * and if the HSE clock fails, the CSS interrupt occurs and an NMI is
  1163. * automatically generated. The NMI will be executed indefinitely, and
  1164. * since NMI has higher priority than any other IRQ (and main program)
  1165. * the application will be stacked in the NMI ISR unless the CSS interrupt
  1166. * pending bit is cleared.
  1167. * @param __INTERRUPT__: specifies the RCC interrupt sources to be disabled.
  1168. * This parameter can be any combination of the following values:
  1169. * @arg RCC_IT_LSIRDY: LSI ready interrupt
  1170. * @arg RCC_IT_LSERDY: LSE ready interrupt
  1171. * @arg RCC_IT_HSIRDY: HSI ready interrupt
  1172. * @arg RCC_IT_HSERDY: HSE ready interrupt
  1173. * @arg RCC_IT_PLLRDY: PLL ready interrupt
  1174. * @arg RCC_IT_MSIRDY: MSI ready interrupt
  1175. * @arg RCC_IT_HSI48RDY: HSI48 ready interrupt
  1176. * @arg RCC_IT_CSSLSE: LSE CSS interrupt
  1177. */
  1178. #define __HAL_RCC_DISABLE_IT(__INTERRUPT__) CLEAR_BIT(RCC->CIER, (__INTERRUPT__))
  1179. /** @brief Clear the RCC's interrupt pending bits (Perform Byte access to RCC_CIR[23:16]
  1180. * bits to clear the selected interrupt pending bits.
  1181. * @param __INTERRUPT__: specifies the interrupt pending bit to clear.
  1182. * This parameter can be any combination of the following values:
  1183. * @arg RCC_IT_LSIRDY: LSI ready interrupt
  1184. * @arg RCC_IT_LSERDY: LSE ready interrupt
  1185. * @arg RCC_IT_HSIRDY: HSI ready interrupt
  1186. * @arg RCC_IT_HSERDY: HSE ready interrupt
  1187. * @arg RCC_IT_PLLRDY: PLL ready interrupt
  1188. * @arg RCC_IT_MSIRDY: MSI ready interrupt
  1189. * @arg RCC_IT_HSI48RDY: HSI48 ready interrupt
  1190. * @arg RCC_IT_CSSLSE: LSE CSS interrupt
  1191. * @arg RCC_IT_CSSHSE: Clock Security System interrupt
  1192. */
  1193. #define __HAL_RCC_CLEAR_IT(__INTERRUPT__) (RCC->CICR = (__INTERRUPT__))
  1194. /** @brief Check the RCC's interrupt has occurred or not.
  1195. * @param __INTERRUPT__: specifies the RCC interrupt source to check.
  1196. * This parameter can be one of the following values:
  1197. * @arg RCC_IT_LSIRDY: LSI ready interrupt
  1198. * @arg RCC_IT_LSERDY: LSE ready interrupt
  1199. * @arg RCC_IT_HSIRDY: HSI ready interrupt
  1200. * @arg RCC_IT_HSERDY: HSE ready interrupt
  1201. * @arg RCC_IT_PLLRDY: PLL ready interrupt
  1202. * @arg RCC_IT_MSIRDY: MSI ready interrupt
  1203. * @arg RCC_IT_CSSLSE: LSE CSS interrupt
  1204. * @arg RCC_IT_CSSHSE: Clock Security System interrupt
  1205. * @retval The new state of __INTERRUPT__ (TRUE or FALSE).
  1206. */
  1207. #define __HAL_RCC_GET_IT(__INTERRUPT__) ((RCC->CIFR & (__INTERRUPT__)) == (__INTERRUPT__))
  1208. /** @brief Set RMVF bit to clear the reset flags.
  1209. * The reset flags are: RCC_FLAG_OBLRST, RCC_FLAG_PINRST, RCC_FLAG_PORRST,
  1210. * RCC_FLAG_SFTRST, RCC_FLAG_IWDGRST, RCC_FLAG_WWDGRST, RCC_FLAG_LPWRRST.
  1211. */
  1212. #define __HAL_RCC_CLEAR_RESET_FLAGS() (RCC->CSR |= RCC_CSR_RMVF)
  1213. /** @brief Check RCC flag is set or not.
  1214. * @param __FLAG__: specifies the flag to check.
  1215. * This parameter can be one of the following values:
  1216. * @arg RCC_FLAG_HSIRDY: HSI oscillator clock ready
  1217. * @arg RCC_FLAG_HSIDIV: HSI clock divider flag
  1218. * @arg RCC_FLAG_MSIRDY: MSI oscillator clock ready
  1219. * @arg RCC_FLAG_HSERDY: HSE oscillator clock ready
  1220. * @arg RCC_FLAG_PLLRDY: PLL clock ready
  1221. * @arg RCC_FLAG_LSECSS: LSE oscillator clock CSS detected
  1222. * @arg RCC_FLAG_LSERDY: LSE oscillator clock ready
  1223. * @arg RCC_FLAG_LSIRDY: LSI oscillator clock ready
  1224. * @arg RCC_FLAG_FWRST: Firewall reset
  1225. * @arg RCC_FLAG_OBLRST: Option Byte Loader (OBL) reset
  1226. * @arg RCC_FLAG_PINRST: Pin reset
  1227. * @arg RCC_FLAG_PORRST: POR/PDR reset
  1228. * @arg RCC_FLAG_SFTRST: Software reset
  1229. * @arg RCC_FLAG_IWDGRST: Independent Watchdog reset
  1230. * @arg RCC_FLAG_WWDGRST: Window Watchdog reset
  1231. * @arg RCC_FLAG_LPWRRST: Low Power reset
  1232. * @retval The new state of __FLAG__ (TRUE or FALSE).
  1233. */
  1234. #define __HAL_RCC_GET_FLAG(__FLAG__) (((((((__FLAG__) >> 5U) == 1U)? RCC->CR :((((__FLAG__) >> 5U) == 2U) ? RCC->CSR :((((__FLAG__) >> 5U) == 3U)? \
  1235. RCC->CRRCR :RCC->CIFR))) & ((uint32_t)1U << ((__FLAG__) & RCC_FLAG_MASK))) != 0U ) ? 1U : 0U )
  1236. /**
  1237. * @}
  1238. */
  1239. /**
  1240. * @}
  1241. */
  1242. /* Private constants ---------------------------------------------------------*/
  1243. /** @defgroup RCC_Private_Constants RCC Private Constants
  1244. * @{
  1245. */
  1246. /* Defines used for Flags */
  1247. #define RCC_FLAG_MASK ((uint8_t)0x1FU)
  1248. /**
  1249. * @}
  1250. */
  1251. /* Private macros ------------------------------------------------------------*/
  1252. /** @addtogroup RCC_Private_Macros
  1253. * @{
  1254. */
  1255. #if !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx)
  1256. #define IS_RCC_OSCILLATORTYPE(__OSCILLATOR__) ((__OSCILLATOR__) <= 0x3FU)
  1257. #else
  1258. #define IS_RCC_OSCILLATORTYPE(__OSCILLATOR__) ((__OSCILLATOR__) <= 0x1FU)
  1259. #endif /* !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) */
  1260. #define IS_RCC_HSE(__HSE__) (((__HSE__) == RCC_HSE_OFF) || ((__HSE__) == RCC_HSE_ON) || \
  1261. ((__HSE__) == RCC_HSE_BYPASS))
  1262. #define IS_RCC_LSE(__LSE__) (((__LSE__) == RCC_LSE_OFF) || ((__LSE__) == RCC_LSE_ON) || \
  1263. ((__LSE__) == RCC_LSE_BYPASS))
  1264. #define IS_RCC_MSI_CLOCK_RANGE(__RANGE__) (((__RANGE__) == RCC_MSIRANGE_0) || \
  1265. ((__RANGE__) == RCC_MSIRANGE_1) || \
  1266. ((__RANGE__) == RCC_MSIRANGE_2) || \
  1267. ((__RANGE__) == RCC_MSIRANGE_3) || \
  1268. ((__RANGE__) == RCC_MSIRANGE_4) || \
  1269. ((__RANGE__) == RCC_MSIRANGE_5) || \
  1270. ((__RANGE__) == RCC_MSIRANGE_6))
  1271. #define IS_RCC_LSI(__LSI__) (((__LSI__) == RCC_LSI_OFF) || ((__LSI__) == RCC_LSI_ON))
  1272. #define IS_RCC_MSI(__MSI__) (((__MSI__) == RCC_MSI_OFF) || ((__MSI__) == RCC_MSI_ON))
  1273. #define IS_RCC_HSI48(__HSI48__) (((__HSI48__) == RCC_HSI48_OFF) || ((__HSI48__) == RCC_HSI48_ON))
  1274. #define IS_RCC_PLL(__PLL__) (((__PLL__) == RCC_PLL_NONE) ||((__PLL__) == RCC_PLL_OFF) || ((__PLL__) == RCC_PLL_ON))
  1275. #define IS_RCC_PLLSOURCE(__SOURCE__) (((__SOURCE__) == RCC_PLLSOURCE_HSI) || \
  1276. ((__SOURCE__) == RCC_PLLSOURCE_HSE))
  1277. #define IS_RCC_PLL_MUL(__MUL__) (((__MUL__) == RCC_PLLMUL_3) || ((__MUL__) == RCC_PLLMUL_4) || \
  1278. ((__MUL__) == RCC_PLLMUL_6) || ((__MUL__) == RCC_PLLMUL_8) || \
  1279. ((__MUL__) == RCC_PLLMUL_12) || ((__MUL__) == RCC_PLLMUL_16) || \
  1280. ((__MUL__) == RCC_PLLMUL_24) || ((__MUL__) == RCC_PLLMUL_32) || \
  1281. ((__MUL__) == RCC_PLLMUL_48))
  1282. #define IS_RCC_PLL_DIV(__DIV__) (((__DIV__) == RCC_PLLDIV_2) || ((__DIV__) == RCC_PLLDIV_3) || \
  1283. ((__DIV__) == RCC_PLLDIV_4))
  1284. #define IS_RCC_CLOCKTYPE(__CLK__) ((1U <= (__CLK__)) && ((__CLK__) <= 15U))
  1285. #define IS_RCC_SYSCLKSOURCE(__SOURCE__) (((__SOURCE__) == RCC_SYSCLKSOURCE_HSI) || \
  1286. ((__SOURCE__) == RCC_SYSCLKSOURCE_HSE) || \
  1287. ((__SOURCE__) == RCC_SYSCLKSOURCE_MSI) || \
  1288. ((__SOURCE__) == RCC_SYSCLKSOURCE_PLLCLK))
  1289. #define IS_RCC_HCLK(__HCLK__) (((__HCLK__) == RCC_SYSCLK_DIV1) || ((__HCLK__) == RCC_SYSCLK_DIV2) || \
  1290. ((__HCLK__) == RCC_SYSCLK_DIV4) || ((__HCLK__) == RCC_SYSCLK_DIV8) || \
  1291. ((__HCLK__) == RCC_SYSCLK_DIV16) || ((__HCLK__) == RCC_SYSCLK_DIV64) || \
  1292. ((__HCLK__) == RCC_SYSCLK_DIV128) || ((__HCLK__) == RCC_SYSCLK_DIV256) || \
  1293. ((__HCLK__) == RCC_SYSCLK_DIV512))
  1294. #define IS_RCC_PCLK(__PCLK__) (((__PCLK__) == RCC_HCLK_DIV1) || ((__PCLK__) == RCC_HCLK_DIV2) || \
  1295. ((__PCLK__) == RCC_HCLK_DIV4) || ((__PCLK__) == RCC_HCLK_DIV8) || \
  1296. ((__PCLK__) == RCC_HCLK_DIV16))
  1297. #define IS_RCC_RTCCLKSOURCE(__SOURCE__) (((__SOURCE__) == RCC_RTCCLKSOURCE_LSE) || \
  1298. ((__SOURCE__) == RCC_RTCCLKSOURCE_LSI) || \
  1299. ((__SOURCE__) == RCC_RTCCLKSOURCE_HSE_DIV2) || \
  1300. ((__SOURCE__) == RCC_RTCCLKSOURCE_HSE_DIV4) || \
  1301. ((__SOURCE__) == RCC_RTCCLKSOURCE_HSE_DIV8) || \
  1302. ((__SOURCE__) == RCC_RTCCLKSOURCE_HSE_DIV16))
  1303. #if !defined (STM32L031xx) && !defined (STM32L041xx) && !defined(STM32L051xx) && !defined(STM32L061xx) && !defined(STM32L071xx) && !defined(STM32L081xx) \
  1304. && !defined (STM32L011xx) && !defined (STM32L021xx)
  1305. #define IS_RCC_MCO1SOURCE(__SOURCE__) (((__SOURCE__) == RCC_MCO1SOURCE_NOCLOCK) || ((__SOURCE__) == RCC_MCO1SOURCE_SYSCLK) || \
  1306. ((__SOURCE__) == RCC_MCO1SOURCE_HSI) || ((__SOURCE__) == RCC_MCO1SOURCE_MSI) || \
  1307. ((__SOURCE__) == RCC_MCO1SOURCE_HSE) || ((__SOURCE__) == RCC_MCO1SOURCE_PLLCLK) || \
  1308. ((__SOURCE__) == RCC_MCO1SOURCE_LSI) || ((__SOURCE__) == RCC_MCO1SOURCE_LSE) || \
  1309. ((__SOURCE__) == RCC_MCO1SOURCE_HSI48))
  1310. #else
  1311. #define IS_RCC_MCO1SOURCE(__SOURCE__) (((__SOURCE__) == RCC_MCO1SOURCE_NOCLOCK) || ((__SOURCE__) == RCC_MCO1SOURCE_SYSCLK) || \
  1312. ((__SOURCE__) == RCC_MCO1SOURCE_HSI) || ((__SOURCE__) == RCC_MCO1SOURCE_MSI) || \
  1313. ((__SOURCE__) == RCC_MCO1SOURCE_HSE) || ((__SOURCE__) == RCC_MCO1SOURCE_PLLCLK) || \
  1314. ((__SOURCE__) == RCC_MCO1SOURCE_LSI) || ((__SOURCE__) == RCC_MCO1SOURCE_LSE))
  1315. #endif
  1316. #define IS_RCC_MCODIV(__DIV__) (((__DIV__) == RCC_MCODIV_1) || \
  1317. ((__DIV__) == RCC_MCODIV_2) || \
  1318. ((__DIV__) == RCC_MCODIV_4) || \
  1319. ((__DIV__) == RCC_MCODIV_8) || \
  1320. ((__DIV__) == RCC_MCODIV_16))
  1321. #if defined(STM32L031xx) || defined(STM32L041xx) || defined(STM32L073xx) || defined(STM32L083xx) || \
  1322. defined(STM32L072xx) || defined(STM32L082xx) || defined(STM32L071xx) || defined(STM32L081xx)
  1323. #define IS_RCC_MCO(__MCOx__) (((__MCOx__) == RCC_MCO1) || ((__MCOx__) == RCC_MCO2) || ((__MCOx__) == RCC_MCO3))
  1324. #else
  1325. #define IS_RCC_MCO(__MCOx__) (((__MCOx__) == RCC_MCO1) || ((__MCOx__) == RCC_MCO2))
  1326. #endif
  1327. #define IS_RCC_CALIBRATION_VALUE(__VALUE__) ((__VALUE__) <= 0x1F)
  1328. #define IS_RCC_MSICALIBRATION_VALUE(__VALUE__) ((__VALUE__) <= 0xFF)
  1329. /**
  1330. * @}
  1331. */
  1332. /* Include RCC HAL Extension module */
  1333. #include "stm32l0xx_hal_rcc_ex.h"
  1334. /** @defgroup RCC_Exported_Functions RCC Exported Functions
  1335. * @{
  1336. */
  1337. /** @defgroup RCC_Exported_Functions_Group1 Initialization and de-initialization functions
  1338. * @{
  1339. */
  1340. void HAL_RCC_DeInit(void);
  1341. HAL_StatusTypeDef HAL_RCC_OscConfig(RCC_OscInitTypeDef *RCC_OscInitStruct);
  1342. HAL_StatusTypeDef HAL_RCC_ClockConfig(RCC_ClkInitTypeDef *RCC_ClkInitStruct, uint32_t FLatency);
  1343. /**
  1344. * @}
  1345. */
  1346. /** @defgroup RCC_Exported_Functions_Group2 Peripheral Control functions
  1347. * @{
  1348. */
  1349. void HAL_RCC_MCOConfig(uint32_t RCC_MCOx, uint32_t RCC_MCOSource, uint32_t RCC_MCODiv);
  1350. #if !defined (STM32L011xx) && !defined (STM32L021xx)
  1351. void HAL_RCC_EnableCSS(void);
  1352. #endif
  1353. uint32_t HAL_RCC_GetSysClockFreq(void);
  1354. uint32_t HAL_RCC_GetHCLKFreq(void);
  1355. uint32_t HAL_RCC_GetPCLK1Freq(void);
  1356. uint32_t HAL_RCC_GetPCLK2Freq(void);
  1357. void HAL_RCC_GetOscConfig(RCC_OscInitTypeDef *RCC_OscInitStruct);
  1358. void HAL_RCC_GetClockConfig(RCC_ClkInitTypeDef *RCC_ClkInitStruct, uint32_t *pFLatency);
  1359. /* CSS NMI IRQ handler */
  1360. void HAL_RCC_NMI_IRQHandler(void);
  1361. /* User Callbacks in non blocking mode (IT mode) */
  1362. void HAL_RCC_CSSCallback(void);
  1363. /**
  1364. * @}
  1365. */
  1366. /**
  1367. * @}
  1368. */
  1369. /**
  1370. * @}
  1371. */
  1372. /**
  1373. * @}
  1374. */
  1375. #ifdef __cplusplus
  1376. }
  1377. #endif
  1378. #endif /* __STM32l0xx_HAL_RCC_H */
  1379. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/