stm32f0xx_hal_rcc.h 81 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686
  1. /**
  2. ******************************************************************************
  3. * @file stm32f0xx_hal_rcc.h
  4. * @author MCD Application Team
  5. * @brief Header file of RCC HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.
  10. * All rights reserved.</center></h2>
  11. *
  12. * This software component is licensed by ST under BSD 3-Clause license,
  13. * the "License"; You may not use this file except in compliance with the
  14. * License. You may obtain a copy of the License at:
  15. * opensource.org/licenses/BSD-3-Clause
  16. *
  17. ******************************************************************************
  18. */
  19. /* Define to prevent recursive inclusion -------------------------------------*/
  20. #ifndef __STM32F0xx_HAL_RCC_H
  21. #define __STM32F0xx_HAL_RCC_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /* Includes ------------------------------------------------------------------*/
  26. #include "stm32f0xx_hal_def.h"
  27. /** @addtogroup STM32F0xx_HAL_Driver
  28. * @{
  29. */
  30. /** @addtogroup RCC
  31. * @{
  32. */
  33. /** @addtogroup RCC_Private_Constants
  34. * @{
  35. */
  36. /** @defgroup RCC_Timeout RCC Timeout
  37. * @{
  38. */
  39. /* Disable Backup domain write protection state change timeout */
  40. #define RCC_DBP_TIMEOUT_VALUE (100U) /* 100 ms */
  41. /* LSE state change timeout */
  42. #define RCC_LSE_TIMEOUT_VALUE LSE_STARTUP_TIMEOUT
  43. #define CLOCKSWITCH_TIMEOUT_VALUE (5000U) /* 5 s */
  44. #define HSE_TIMEOUT_VALUE HSE_STARTUP_TIMEOUT
  45. #define HSI_TIMEOUT_VALUE (2U) /* 2 ms (minimum Tick + 1U) */
  46. #define LSI_TIMEOUT_VALUE (2U) /* 2 ms (minimum Tick + 1U) */
  47. #define PLL_TIMEOUT_VALUE (2U) /* 2 ms (minimum Tick + 1U) */
  48. #define HSI14_TIMEOUT_VALUE (2U) /* 2 ms (minimum Tick + 1U) */
  49. #if defined(RCC_HSI48_SUPPORT)
  50. #define HSI48_TIMEOUT_VALUE (2U) /* 2 ms (minimum Tick + 1U) */
  51. #endif /* RCC_HSI48_SUPPORT */
  52. /**
  53. * @}
  54. */
  55. /** @defgroup RCC_Register_Offset Register offsets
  56. * @{
  57. */
  58. #define RCC_OFFSET (RCC_BASE - PERIPH_BASE)
  59. #define RCC_CR_OFFSET 0x00
  60. #define RCC_CFGR_OFFSET 0x04
  61. #define RCC_CIR_OFFSET 0x08
  62. #define RCC_BDCR_OFFSET 0x20
  63. #define RCC_CSR_OFFSET 0x24
  64. /**
  65. * @}
  66. */
  67. /* CR register byte 2 (Bits[23:16]) base address */
  68. #define RCC_CR_BYTE2_ADDRESS ((uint32_t)(RCC_BASE + RCC_CR_OFFSET + 0x02U))
  69. /* CIR register byte 1 (Bits[15:8]) base address */
  70. #define RCC_CIR_BYTE1_ADDRESS ((uint32_t)(RCC_BASE + RCC_CIR_OFFSET + 0x01U))
  71. /* CIR register byte 2 (Bits[23:16]) base address */
  72. #define RCC_CIR_BYTE2_ADDRESS ((uint32_t)(RCC_BASE + RCC_CIR_OFFSET + 0x02U))
  73. /* Defines used for Flags */
  74. #define CR_REG_INDEX ((uint8_t)1U)
  75. #define CR2_REG_INDEX ((uint8_t)2U)
  76. #define BDCR_REG_INDEX ((uint8_t)3U)
  77. #define CSR_REG_INDEX ((uint8_t)4U)
  78. /* Bits position in in the CFGR register */
  79. #define RCC_CFGR_PLLMUL_BITNUMBER 18U
  80. #define RCC_CFGR_HPRE_BITNUMBER 4U
  81. #define RCC_CFGR_PPRE_BITNUMBER 8U
  82. /* Flags in the CFGR2 register */
  83. #define RCC_CFGR2_PREDIV_BITNUMBER 0
  84. /* Flags in the CR register */
  85. #define RCC_CR_HSIRDY_BitNumber 1
  86. #define RCC_CR_HSERDY_BitNumber 17
  87. #define RCC_CR_PLLRDY_BitNumber 25
  88. /* Flags in the CR2 register */
  89. #define RCC_CR2_HSI14RDY_BitNumber 1
  90. #define RCC_CR2_HSI48RDY_BitNumber 16
  91. /* Flags in the BDCR register */
  92. #define RCC_BDCR_LSERDY_BitNumber 1
  93. /* Flags in the CSR register */
  94. #define RCC_CSR_LSIRDY_BitNumber 1
  95. #define RCC_CSR_V18PWRRSTF_BitNumber 23
  96. #define RCC_CSR_RMVF_BitNumber 24
  97. #define RCC_CSR_OBLRSTF_BitNumber 25
  98. #define RCC_CSR_PINRSTF_BitNumber 26
  99. #define RCC_CSR_PORRSTF_BitNumber 27
  100. #define RCC_CSR_SFTRSTF_BitNumber 28
  101. #define RCC_CSR_IWDGRSTF_BitNumber 29
  102. #define RCC_CSR_WWDGRSTF_BitNumber 30
  103. #define RCC_CSR_LPWRRSTF_BitNumber 31
  104. /* Flags in the HSITRIM register */
  105. #define RCC_CR_HSITRIM_BitNumber 3
  106. #define RCC_HSI14TRIM_BIT_NUMBER 3
  107. #define RCC_FLAG_MASK ((uint8_t)0x1FU)
  108. /**
  109. * @}
  110. */
  111. /** @addtogroup RCC_Private_Macros
  112. * @{
  113. */
  114. #define IS_RCC_HSE(__HSE__) (((__HSE__) == RCC_HSE_OFF) || ((__HSE__) == RCC_HSE_ON) || \
  115. ((__HSE__) == RCC_HSE_BYPASS))
  116. #define IS_RCC_LSE(__LSE__) (((__LSE__) == RCC_LSE_OFF) || ((__LSE__) == RCC_LSE_ON) || \
  117. ((__LSE__) == RCC_LSE_BYPASS))
  118. #define IS_RCC_HSI(__HSI__) (((__HSI__) == RCC_HSI_OFF) || ((__HSI__) == RCC_HSI_ON))
  119. #define IS_RCC_HSI14(__HSI14__) (((__HSI14__) == RCC_HSI14_OFF) || ((__HSI14__) == RCC_HSI14_ON) || ((__HSI14__) == RCC_HSI14_ADC_CONTROL))
  120. #define IS_RCC_CALIBRATION_VALUE(__VALUE__) ((__VALUE__) <= 0x1FU)
  121. #define IS_RCC_LSI(__LSI__) (((__LSI__) == RCC_LSI_OFF) || ((__LSI__) == RCC_LSI_ON))
  122. #define IS_RCC_PLL(__PLL__) (((__PLL__) == RCC_PLL_NONE) || ((__PLL__) == RCC_PLL_OFF) || \
  123. ((__PLL__) == RCC_PLL_ON))
  124. #define IS_RCC_PREDIV(__PREDIV__) (((__PREDIV__) == RCC_PREDIV_DIV1) || ((__PREDIV__) == RCC_PREDIV_DIV2) || \
  125. ((__PREDIV__) == RCC_PREDIV_DIV3) || ((__PREDIV__) == RCC_PREDIV_DIV4) || \
  126. ((__PREDIV__) == RCC_PREDIV_DIV5) || ((__PREDIV__) == RCC_PREDIV_DIV6) || \
  127. ((__PREDIV__) == RCC_PREDIV_DIV7) || ((__PREDIV__) == RCC_PREDIV_DIV8) || \
  128. ((__PREDIV__) == RCC_PREDIV_DIV9) || ((__PREDIV__) == RCC_PREDIV_DIV10) || \
  129. ((__PREDIV__) == RCC_PREDIV_DIV11) || ((__PREDIV__) == RCC_PREDIV_DIV12) || \
  130. ((__PREDIV__) == RCC_PREDIV_DIV13) || ((__PREDIV__) == RCC_PREDIV_DIV14) || \
  131. ((__PREDIV__) == RCC_PREDIV_DIV15) || ((__PREDIV__) == RCC_PREDIV_DIV16))
  132. #define IS_RCC_PLL_MUL(__MUL__) (((__MUL__) == RCC_PLL_MUL2) || ((__MUL__) == RCC_PLL_MUL3) || \
  133. ((__MUL__) == RCC_PLL_MUL4) || ((__MUL__) == RCC_PLL_MUL5) || \
  134. ((__MUL__) == RCC_PLL_MUL6) || ((__MUL__) == RCC_PLL_MUL7) || \
  135. ((__MUL__) == RCC_PLL_MUL8) || ((__MUL__) == RCC_PLL_MUL9) || \
  136. ((__MUL__) == RCC_PLL_MUL10) || ((__MUL__) == RCC_PLL_MUL11) || \
  137. ((__MUL__) == RCC_PLL_MUL12) || ((__MUL__) == RCC_PLL_MUL13) || \
  138. ((__MUL__) == RCC_PLL_MUL14) || ((__MUL__) == RCC_PLL_MUL15) || \
  139. ((__MUL__) == RCC_PLL_MUL16))
  140. #define IS_RCC_CLOCKTYPE(__CLK__) ((((__CLK__) & RCC_CLOCKTYPE_SYSCLK) == RCC_CLOCKTYPE_SYSCLK) || \
  141. (((__CLK__) & RCC_CLOCKTYPE_HCLK) == RCC_CLOCKTYPE_HCLK) || \
  142. (((__CLK__) & RCC_CLOCKTYPE_PCLK1) == RCC_CLOCKTYPE_PCLK1))
  143. #define IS_RCC_HCLK(__HCLK__) (((__HCLK__) == RCC_SYSCLK_DIV1) || ((__HCLK__) == RCC_SYSCLK_DIV2) || \
  144. ((__HCLK__) == RCC_SYSCLK_DIV4) || ((__HCLK__) == RCC_SYSCLK_DIV8) || \
  145. ((__HCLK__) == RCC_SYSCLK_DIV16) || ((__HCLK__) == RCC_SYSCLK_DIV64) || \
  146. ((__HCLK__) == RCC_SYSCLK_DIV128) || ((__HCLK__) == RCC_SYSCLK_DIV256) || \
  147. ((__HCLK__) == RCC_SYSCLK_DIV512))
  148. #define IS_RCC_PCLK(__PCLK__) (((__PCLK__) == RCC_HCLK_DIV1) || ((__PCLK__) == RCC_HCLK_DIV2) || \
  149. ((__PCLK__) == RCC_HCLK_DIV4) || ((__PCLK__) == RCC_HCLK_DIV8) || \
  150. ((__PCLK__) == RCC_HCLK_DIV16))
  151. #define IS_RCC_MCO(__MCO__) ((__MCO__) == RCC_MCO)
  152. #define IS_RCC_RTCCLKSOURCE(__SOURCE__) (((__SOURCE__) == RCC_RTCCLKSOURCE_NO_CLK) || \
  153. ((__SOURCE__) == RCC_RTCCLKSOURCE_LSE) || \
  154. ((__SOURCE__) == RCC_RTCCLKSOURCE_LSI) || \
  155. ((__SOURCE__) == RCC_RTCCLKSOURCE_HSE_DIV32))
  156. #define IS_RCC_USART1CLKSOURCE(__SOURCE__) (((__SOURCE__) == RCC_USART1CLKSOURCE_PCLK1) || \
  157. ((__SOURCE__) == RCC_USART1CLKSOURCE_SYSCLK) || \
  158. ((__SOURCE__) == RCC_USART1CLKSOURCE_LSE) || \
  159. ((__SOURCE__) == RCC_USART1CLKSOURCE_HSI))
  160. #define IS_RCC_I2C1CLKSOURCE(__SOURCE__) (((__SOURCE__) == RCC_I2C1CLKSOURCE_HSI) || \
  161. ((__SOURCE__) == RCC_I2C1CLKSOURCE_SYSCLK))
  162. /**
  163. * @}
  164. */
  165. /* Exported types ------------------------------------------------------------*/
  166. /** @defgroup RCC_Exported_Types RCC Exported Types
  167. * @{
  168. */
  169. /**
  170. * @brief RCC PLL configuration structure definition
  171. */
  172. typedef struct
  173. {
  174. uint32_t PLLState; /*!< PLLState: The new state of the PLL.
  175. This parameter can be a value of @ref RCC_PLL_Config */
  176. uint32_t PLLSource; /*!< PLLSource: PLL entry clock source.
  177. This parameter must be a value of @ref RCC_PLL_Clock_Source */
  178. uint32_t PLLMUL; /*!< PLLMUL: Multiplication factor for PLL VCO input clock
  179. This parameter must be a value of @ref RCC_PLL_Multiplication_Factor*/
  180. uint32_t PREDIV; /*!< PREDIV: Predivision factor for PLL VCO input clock
  181. This parameter must be a value of @ref RCC_PLL_Prediv_Factor */
  182. } RCC_PLLInitTypeDef;
  183. /**
  184. * @brief RCC Internal/External Oscillator (HSE, HSI, LSE and LSI) configuration structure definition
  185. */
  186. typedef struct
  187. {
  188. uint32_t OscillatorType; /*!< The oscillators to be configured.
  189. This parameter can be a value of @ref RCC_Oscillator_Type */
  190. uint32_t HSEState; /*!< The new state of the HSE.
  191. This parameter can be a value of @ref RCC_HSE_Config */
  192. uint32_t LSEState; /*!< The new state of the LSE.
  193. This parameter can be a value of @ref RCC_LSE_Config */
  194. uint32_t HSIState; /*!< The new state of the HSI.
  195. This parameter can be a value of @ref RCC_HSI_Config */
  196. uint32_t HSICalibrationValue; /*!< The HSI calibration trimming value (default is RCC_HSICALIBRATION_DEFAULT).
  197. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x1FU */
  198. uint32_t HSI14State; /*!< The new state of the HSI14.
  199. This parameter can be a value of @ref RCC_HSI14_Config */
  200. uint32_t HSI14CalibrationValue; /*!< The HSI14 calibration trimming value (default is RCC_HSI14CALIBRATION_DEFAULT).
  201. This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x1FU */
  202. uint32_t LSIState; /*!< The new state of the LSI.
  203. This parameter can be a value of @ref RCC_LSI_Config */
  204. #if defined(RCC_HSI48_SUPPORT)
  205. uint32_t HSI48State; /*!< The new state of the HSI48.
  206. This parameter can be a value of @ref RCC_HSI48_Config */
  207. #endif /* RCC_HSI48_SUPPORT */
  208. RCC_PLLInitTypeDef PLL; /*!< PLL structure parameters */
  209. } RCC_OscInitTypeDef;
  210. /**
  211. * @brief RCC System, AHB and APB busses clock configuration structure definition
  212. */
  213. typedef struct
  214. {
  215. uint32_t ClockType; /*!< The clock to be configured.
  216. This parameter can be a value of @ref RCC_System_Clock_Type */
  217. uint32_t SYSCLKSource; /*!< The clock source (SYSCLKS) used as system clock.
  218. This parameter can be a value of @ref RCC_System_Clock_Source */
  219. uint32_t AHBCLKDivider; /*!< The AHB clock (HCLK) divider. This clock is derived from the system clock (SYSCLK).
  220. This parameter can be a value of @ref RCC_AHB_Clock_Source */
  221. uint32_t APB1CLKDivider; /*!< The APB1 clock (PCLK1) divider. This clock is derived from the AHB clock (HCLK).
  222. This parameter can be a value of @ref RCC_APB1_Clock_Source */
  223. } RCC_ClkInitTypeDef;
  224. /**
  225. * @}
  226. */
  227. /* Exported constants --------------------------------------------------------*/
  228. /** @defgroup RCC_Exported_Constants RCC Exported Constants
  229. * @{
  230. */
  231. /** @defgroup RCC_PLL_Clock_Source PLL Clock Source
  232. * @{
  233. */
  234. #define RCC_PLLSOURCE_HSE RCC_CFGR_PLLSRC_HSE_PREDIV /*!< HSE clock selected as PLL entry clock source */
  235. /**
  236. * @}
  237. */
  238. /** @defgroup RCC_Oscillator_Type Oscillator Type
  239. * @{
  240. */
  241. #define RCC_OSCILLATORTYPE_NONE (0x00000000U)
  242. #define RCC_OSCILLATORTYPE_HSE (0x00000001U)
  243. #define RCC_OSCILLATORTYPE_HSI (0x00000002U)
  244. #define RCC_OSCILLATORTYPE_LSE (0x00000004U)
  245. #define RCC_OSCILLATORTYPE_LSI (0x00000008U)
  246. #define RCC_OSCILLATORTYPE_HSI14 (0x00000010U)
  247. #if defined(RCC_HSI48_SUPPORT)
  248. #define RCC_OSCILLATORTYPE_HSI48 (0x00000020U)
  249. #endif /* RCC_HSI48_SUPPORT */
  250. /**
  251. * @}
  252. */
  253. /** @defgroup RCC_HSE_Config HSE Config
  254. * @{
  255. */
  256. #define RCC_HSE_OFF (0x00000000U) /*!< HSE clock deactivation */
  257. #define RCC_HSE_ON (0x00000001U) /*!< HSE clock activation */
  258. #define RCC_HSE_BYPASS (0x00000005U) /*!< External clock source for HSE clock */
  259. /**
  260. * @}
  261. */
  262. /** @defgroup RCC_LSE_Config LSE Config
  263. * @{
  264. */
  265. #define RCC_LSE_OFF (0x00000000U) /*!< LSE clock deactivation */
  266. #define RCC_LSE_ON (0x00000001U) /*!< LSE clock activation */
  267. #define RCC_LSE_BYPASS (0x00000005U) /*!< External clock source for LSE clock */
  268. /**
  269. * @}
  270. */
  271. /** @defgroup RCC_HSI_Config HSI Config
  272. * @{
  273. */
  274. #define RCC_HSI_OFF (0x00000000U) /*!< HSI clock deactivation */
  275. #define RCC_HSI_ON RCC_CR_HSION /*!< HSI clock activation */
  276. #define RCC_HSICALIBRATION_DEFAULT (0x10U) /* Default HSI calibration trimming value */
  277. /**
  278. * @}
  279. */
  280. /** @defgroup RCC_HSI14_Config RCC HSI14 Config
  281. * @{
  282. */
  283. #define RCC_HSI14_OFF (0x00000000U)
  284. #define RCC_HSI14_ON RCC_CR2_HSI14ON
  285. #define RCC_HSI14_ADC_CONTROL (~RCC_CR2_HSI14DIS)
  286. #define RCC_HSI14CALIBRATION_DEFAULT (0x10U) /* Default HSI14 calibration trimming value */
  287. /**
  288. * @}
  289. */
  290. /** @defgroup RCC_LSI_Config LSI Config
  291. * @{
  292. */
  293. #define RCC_LSI_OFF (0x00000000U) /*!< LSI clock deactivation */
  294. #define RCC_LSI_ON RCC_CSR_LSION /*!< LSI clock activation */
  295. /**
  296. * @}
  297. */
  298. #if defined(RCC_HSI48_SUPPORT)
  299. /** @defgroup RCC_HSI48_Config HSI48 Config
  300. * @{
  301. */
  302. #define RCC_HSI48_OFF ((uint8_t)0x00U)
  303. #define RCC_HSI48_ON ((uint8_t)0x01U)
  304. /**
  305. * @}
  306. */
  307. #endif /* RCC_HSI48_SUPPORT */
  308. /** @defgroup RCC_PLL_Config PLL Config
  309. * @{
  310. */
  311. #define RCC_PLL_NONE (0x00000000U) /*!< PLL is not configured */
  312. #define RCC_PLL_OFF (0x00000001U) /*!< PLL deactivation */
  313. #define RCC_PLL_ON (0x00000002U) /*!< PLL activation */
  314. /**
  315. * @}
  316. */
  317. /** @defgroup RCC_System_Clock_Type System Clock Type
  318. * @{
  319. */
  320. #define RCC_CLOCKTYPE_SYSCLK (0x00000001U) /*!< SYSCLK to configure */
  321. #define RCC_CLOCKTYPE_HCLK (0x00000002U) /*!< HCLK to configure */
  322. #define RCC_CLOCKTYPE_PCLK1 (0x00000004U) /*!< PCLK1 to configure */
  323. /**
  324. * @}
  325. */
  326. /** @defgroup RCC_System_Clock_Source System Clock Source
  327. * @{
  328. */
  329. #define RCC_SYSCLKSOURCE_HSI RCC_CFGR_SW_HSI /*!< HSI selected as system clock */
  330. #define RCC_SYSCLKSOURCE_HSE RCC_CFGR_SW_HSE /*!< HSE selected as system clock */
  331. #define RCC_SYSCLKSOURCE_PLLCLK RCC_CFGR_SW_PLL /*!< PLL selected as system clock */
  332. /**
  333. * @}
  334. */
  335. /** @defgroup RCC_System_Clock_Source_Status System Clock Source Status
  336. * @{
  337. */
  338. #define RCC_SYSCLKSOURCE_STATUS_HSI RCC_CFGR_SWS_HSI /*!< HSI used as system clock */
  339. #define RCC_SYSCLKSOURCE_STATUS_HSE RCC_CFGR_SWS_HSE /*!< HSE used as system clock */
  340. #define RCC_SYSCLKSOURCE_STATUS_PLLCLK RCC_CFGR_SWS_PLL /*!< PLL used as system clock */
  341. /**
  342. * @}
  343. */
  344. /** @defgroup RCC_AHB_Clock_Source AHB Clock Source
  345. * @{
  346. */
  347. #define RCC_SYSCLK_DIV1 RCC_CFGR_HPRE_DIV1 /*!< SYSCLK not divided */
  348. #define RCC_SYSCLK_DIV2 RCC_CFGR_HPRE_DIV2 /*!< SYSCLK divided by 2 */
  349. #define RCC_SYSCLK_DIV4 RCC_CFGR_HPRE_DIV4 /*!< SYSCLK divided by 4 */
  350. #define RCC_SYSCLK_DIV8 RCC_CFGR_HPRE_DIV8 /*!< SYSCLK divided by 8 */
  351. #define RCC_SYSCLK_DIV16 RCC_CFGR_HPRE_DIV16 /*!< SYSCLK divided by 16 */
  352. #define RCC_SYSCLK_DIV64 RCC_CFGR_HPRE_DIV64 /*!< SYSCLK divided by 64 */
  353. #define RCC_SYSCLK_DIV128 RCC_CFGR_HPRE_DIV128 /*!< SYSCLK divided by 128 */
  354. #define RCC_SYSCLK_DIV256 RCC_CFGR_HPRE_DIV256 /*!< SYSCLK divided by 256 */
  355. #define RCC_SYSCLK_DIV512 RCC_CFGR_HPRE_DIV512 /*!< SYSCLK divided by 512 */
  356. /**
  357. * @}
  358. */
  359. /** @defgroup RCC_APB1_Clock_Source RCC APB1 Clock Source
  360. * @{
  361. */
  362. #define RCC_HCLK_DIV1 RCC_CFGR_PPRE_DIV1 /*!< HCLK not divided */
  363. #define RCC_HCLK_DIV2 RCC_CFGR_PPRE_DIV2 /*!< HCLK divided by 2 */
  364. #define RCC_HCLK_DIV4 RCC_CFGR_PPRE_DIV4 /*!< HCLK divided by 4 */
  365. #define RCC_HCLK_DIV8 RCC_CFGR_PPRE_DIV8 /*!< HCLK divided by 8 */
  366. #define RCC_HCLK_DIV16 RCC_CFGR_PPRE_DIV16 /*!< HCLK divided by 16 */
  367. /**
  368. * @}
  369. */
  370. /** @defgroup RCC_RTC_Clock_Source RTC Clock Source
  371. * @{
  372. */
  373. #define RCC_RTCCLKSOURCE_NO_CLK (0x00000000U) /*!< No clock */
  374. #define RCC_RTCCLKSOURCE_LSE RCC_BDCR_RTCSEL_LSE /*!< LSE oscillator clock used as RTC clock */
  375. #define RCC_RTCCLKSOURCE_LSI RCC_BDCR_RTCSEL_LSI /*!< LSI oscillator clock used as RTC clock */
  376. #define RCC_RTCCLKSOURCE_HSE_DIV32 RCC_BDCR_RTCSEL_HSE /*!< HSE oscillator clock divided by 32 used as RTC clock */
  377. /**
  378. * @}
  379. */
  380. /** @defgroup RCC_PLL_Multiplication_Factor RCC PLL Multiplication Factor
  381. * @{
  382. */
  383. #define RCC_PLL_MUL2 RCC_CFGR_PLLMUL2
  384. #define RCC_PLL_MUL3 RCC_CFGR_PLLMUL3
  385. #define RCC_PLL_MUL4 RCC_CFGR_PLLMUL4
  386. #define RCC_PLL_MUL5 RCC_CFGR_PLLMUL5
  387. #define RCC_PLL_MUL6 RCC_CFGR_PLLMUL6
  388. #define RCC_PLL_MUL7 RCC_CFGR_PLLMUL7
  389. #define RCC_PLL_MUL8 RCC_CFGR_PLLMUL8
  390. #define RCC_PLL_MUL9 RCC_CFGR_PLLMUL9
  391. #define RCC_PLL_MUL10 RCC_CFGR_PLLMUL10
  392. #define RCC_PLL_MUL11 RCC_CFGR_PLLMUL11
  393. #define RCC_PLL_MUL12 RCC_CFGR_PLLMUL12
  394. #define RCC_PLL_MUL13 RCC_CFGR_PLLMUL13
  395. #define RCC_PLL_MUL14 RCC_CFGR_PLLMUL14
  396. #define RCC_PLL_MUL15 RCC_CFGR_PLLMUL15
  397. #define RCC_PLL_MUL16 RCC_CFGR_PLLMUL16
  398. /**
  399. * @}
  400. */
  401. /** @defgroup RCC_PLL_Prediv_Factor RCC PLL Prediv Factor
  402. * @{
  403. */
  404. #define RCC_PREDIV_DIV1 RCC_CFGR2_PREDIV_DIV1
  405. #define RCC_PREDIV_DIV2 RCC_CFGR2_PREDIV_DIV2
  406. #define RCC_PREDIV_DIV3 RCC_CFGR2_PREDIV_DIV3
  407. #define RCC_PREDIV_DIV4 RCC_CFGR2_PREDIV_DIV4
  408. #define RCC_PREDIV_DIV5 RCC_CFGR2_PREDIV_DIV5
  409. #define RCC_PREDIV_DIV6 RCC_CFGR2_PREDIV_DIV6
  410. #define RCC_PREDIV_DIV7 RCC_CFGR2_PREDIV_DIV7
  411. #define RCC_PREDIV_DIV8 RCC_CFGR2_PREDIV_DIV8
  412. #define RCC_PREDIV_DIV9 RCC_CFGR2_PREDIV_DIV9
  413. #define RCC_PREDIV_DIV10 RCC_CFGR2_PREDIV_DIV10
  414. #define RCC_PREDIV_DIV11 RCC_CFGR2_PREDIV_DIV11
  415. #define RCC_PREDIV_DIV12 RCC_CFGR2_PREDIV_DIV12
  416. #define RCC_PREDIV_DIV13 RCC_CFGR2_PREDIV_DIV13
  417. #define RCC_PREDIV_DIV14 RCC_CFGR2_PREDIV_DIV14
  418. #define RCC_PREDIV_DIV15 RCC_CFGR2_PREDIV_DIV15
  419. #define RCC_PREDIV_DIV16 RCC_CFGR2_PREDIV_DIV16
  420. /**
  421. * @}
  422. */
  423. /** @defgroup RCC_USART1_Clock_Source RCC USART1 Clock Source
  424. * @{
  425. */
  426. #define RCC_USART1CLKSOURCE_PCLK1 RCC_CFGR3_USART1SW_PCLK
  427. #define RCC_USART1CLKSOURCE_SYSCLK RCC_CFGR3_USART1SW_SYSCLK
  428. #define RCC_USART1CLKSOURCE_LSE RCC_CFGR3_USART1SW_LSE
  429. #define RCC_USART1CLKSOURCE_HSI RCC_CFGR3_USART1SW_HSI
  430. /**
  431. * @}
  432. */
  433. /** @defgroup RCC_I2C1_Clock_Source RCC I2C1 Clock Source
  434. * @{
  435. */
  436. #define RCC_I2C1CLKSOURCE_HSI RCC_CFGR3_I2C1SW_HSI
  437. #define RCC_I2C1CLKSOURCE_SYSCLK RCC_CFGR3_I2C1SW_SYSCLK
  438. /**
  439. * @}
  440. */
  441. /** @defgroup RCC_MCO_Index MCO Index
  442. * @{
  443. */
  444. #define RCC_MCO1 (0x00000000U)
  445. #define RCC_MCO RCC_MCO1 /*!< MCO1 to be compliant with other families with 2 MCOs*/
  446. /**
  447. * @}
  448. */
  449. /** @defgroup RCC_MCO_Clock_Source RCC MCO Clock Source
  450. * @{
  451. */
  452. #define RCC_MCO1SOURCE_NOCLOCK RCC_CFGR_MCO_NOCLOCK
  453. #define RCC_MCO1SOURCE_LSI RCC_CFGR_MCO_LSI
  454. #define RCC_MCO1SOURCE_LSE RCC_CFGR_MCO_LSE
  455. #define RCC_MCO1SOURCE_SYSCLK RCC_CFGR_MCO_SYSCLK
  456. #define RCC_MCO1SOURCE_HSI RCC_CFGR_MCO_HSI
  457. #define RCC_MCO1SOURCE_HSE RCC_CFGR_MCO_HSE
  458. #define RCC_MCO1SOURCE_PLLCLK_DIV2 RCC_CFGR_MCO_PLL
  459. #define RCC_MCO1SOURCE_HSI14 RCC_CFGR_MCO_HSI14
  460. /**
  461. * @}
  462. */
  463. /** @defgroup RCC_Interrupt Interrupts
  464. * @{
  465. */
  466. #define RCC_IT_LSIRDY ((uint8_t)RCC_CIR_LSIRDYF) /*!< LSI Ready Interrupt flag */
  467. #define RCC_IT_LSERDY ((uint8_t)RCC_CIR_LSERDYF) /*!< LSE Ready Interrupt flag */
  468. #define RCC_IT_HSIRDY ((uint8_t)RCC_CIR_HSIRDYF) /*!< HSI Ready Interrupt flag */
  469. #define RCC_IT_HSERDY ((uint8_t)RCC_CIR_HSERDYF) /*!< HSE Ready Interrupt flag */
  470. #define RCC_IT_PLLRDY ((uint8_t)RCC_CIR_PLLRDYF) /*!< PLL Ready Interrupt flag */
  471. #define RCC_IT_HSI14RDY ((uint8_t)RCC_CIR_HSI14RDYF) /*!< HSI14 Ready Interrupt flag */
  472. #if defined(RCC_CIR_HSI48RDYF)
  473. #define RCC_IT_HSI48RDY ((uint8_t)RCC_CIR_HSI48RDYF) /*!< HSI48 Ready Interrupt flag */
  474. #endif
  475. #define RCC_IT_CSS ((uint8_t)RCC_CIR_CSSF) /*!< Clock Security System Interrupt flag */
  476. /**
  477. * @}
  478. */
  479. /** @defgroup RCC_Flag Flags
  480. * Elements values convention: XXXYYYYYb
  481. * - YYYYY : Flag position in the register
  482. * - XXX : Register index
  483. * - 001: CR register
  484. * - 010: CR2 register
  485. * - 011: BDCR register
  486. * - 0100: CSR register
  487. * @{
  488. */
  489. /* Flags in the CR register */
  490. #define RCC_FLAG_HSIRDY ((uint8_t)((CR_REG_INDEX << 5U) | RCC_CR_HSIRDY_BitNumber))
  491. #define RCC_FLAG_HSERDY ((uint8_t)((CR_REG_INDEX << 5U) | RCC_CR_HSERDY_BitNumber))
  492. #define RCC_FLAG_PLLRDY ((uint8_t)((CR_REG_INDEX << 5U) | RCC_CR_PLLRDY_BitNumber))
  493. /* Flags in the CR2 register */
  494. #define RCC_FLAG_HSI14RDY ((uint8_t)((CR2_REG_INDEX << 5U) | RCC_CR2_HSI14RDY_BitNumber))
  495. /* Flags in the CSR register */
  496. #define RCC_FLAG_LSIRDY ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_LSIRDY_BitNumber))
  497. #if defined(RCC_CSR_V18PWRRSTF)
  498. #define RCC_FLAG_V18PWRRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_V18PWRRSTF_BitNumber))
  499. #endif
  500. #define RCC_FLAG_OBLRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_OBLRSTF_BitNumber))
  501. #define RCC_FLAG_PINRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_PINRSTF_BitNumber)) /*!< PIN reset flag */
  502. #define RCC_FLAG_PORRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_PORRSTF_BitNumber)) /*!< POR/PDR reset flag */
  503. #define RCC_FLAG_SFTRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_SFTRSTF_BitNumber)) /*!< Software Reset flag */
  504. #define RCC_FLAG_IWDGRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_IWDGRSTF_BitNumber)) /*!< Independent Watchdog reset flag */
  505. #define RCC_FLAG_WWDGRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_WWDGRSTF_BitNumber)) /*!< Window watchdog reset flag */
  506. #define RCC_FLAG_LPWRRST ((uint8_t)((CSR_REG_INDEX << 5U) | RCC_CSR_LPWRRSTF_BitNumber)) /*!< Low-Power reset flag */
  507. /* Flags in the BDCR register */
  508. #define RCC_FLAG_LSERDY ((uint8_t)((BDCR_REG_INDEX << 5U) | RCC_BDCR_LSERDY_BitNumber)) /*!< External Low Speed oscillator Ready */
  509. /**
  510. * @}
  511. */
  512. /**
  513. * @}
  514. */
  515. /* Exported macro ------------------------------------------------------------*/
  516. /** @defgroup RCC_Exported_Macros RCC Exported Macros
  517. * @{
  518. */
  519. /** @defgroup RCC_AHB_Clock_Enable_Disable RCC AHB Clock Enable Disable
  520. * @brief Enable or disable the AHB peripheral clock.
  521. * @note After reset, the peripheral clock (used for registers read/write access)
  522. * is disabled and the application software has to enable this clock before
  523. * using it.
  524. * @{
  525. */
  526. #define __HAL_RCC_GPIOA_CLK_ENABLE() do { \
  527. __IO uint32_t tmpreg; \
  528. SET_BIT(RCC->AHBENR, RCC_AHBENR_GPIOAEN);\
  529. /* Delay after an RCC peripheral clock enabling */\
  530. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_GPIOAEN);\
  531. UNUSED(tmpreg); \
  532. } while(0U)
  533. #define __HAL_RCC_GPIOB_CLK_ENABLE() do { \
  534. __IO uint32_t tmpreg; \
  535. SET_BIT(RCC->AHBENR, RCC_AHBENR_GPIOBEN);\
  536. /* Delay after an RCC peripheral clock enabling */\
  537. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_GPIOBEN);\
  538. UNUSED(tmpreg); \
  539. } while(0U)
  540. #define __HAL_RCC_GPIOC_CLK_ENABLE() do { \
  541. __IO uint32_t tmpreg; \
  542. SET_BIT(RCC->AHBENR, RCC_AHBENR_GPIOCEN);\
  543. /* Delay after an RCC peripheral clock enabling */\
  544. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_GPIOCEN);\
  545. UNUSED(tmpreg); \
  546. } while(0U)
  547. #define __HAL_RCC_GPIOF_CLK_ENABLE() do { \
  548. __IO uint32_t tmpreg; \
  549. SET_BIT(RCC->AHBENR, RCC_AHBENR_GPIOFEN);\
  550. /* Delay after an RCC peripheral clock enabling */\
  551. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_GPIOFEN);\
  552. UNUSED(tmpreg); \
  553. } while(0U)
  554. #define __HAL_RCC_CRC_CLK_ENABLE() do { \
  555. __IO uint32_t tmpreg; \
  556. SET_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN);\
  557. /* Delay after an RCC peripheral clock enabling */\
  558. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_CRCEN);\
  559. UNUSED(tmpreg); \
  560. } while(0U)
  561. #define __HAL_RCC_DMA1_CLK_ENABLE() do { \
  562. __IO uint32_t tmpreg; \
  563. SET_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN);\
  564. /* Delay after an RCC peripheral clock enabling */\
  565. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_DMA1EN);\
  566. UNUSED(tmpreg); \
  567. } while(0U)
  568. #define __HAL_RCC_SRAM_CLK_ENABLE() do { \
  569. __IO uint32_t tmpreg; \
  570. SET_BIT(RCC->AHBENR, RCC_AHBENR_SRAMEN);\
  571. /* Delay after an RCC peripheral clock enabling */\
  572. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_SRAMEN);\
  573. UNUSED(tmpreg); \
  574. } while(0U)
  575. #define __HAL_RCC_FLITF_CLK_ENABLE() do { \
  576. __IO uint32_t tmpreg; \
  577. SET_BIT(RCC->AHBENR, RCC_AHBENR_FLITFEN);\
  578. /* Delay after an RCC peripheral clock enabling */\
  579. tmpreg = READ_BIT(RCC->AHBENR, RCC_AHBENR_FLITFEN);\
  580. UNUSED(tmpreg); \
  581. } while(0U)
  582. #define __HAL_RCC_GPIOA_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_GPIOAEN))
  583. #define __HAL_RCC_GPIOB_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_GPIOBEN))
  584. #define __HAL_RCC_GPIOC_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_GPIOCEN))
  585. #define __HAL_RCC_GPIOF_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_GPIOFEN))
  586. #define __HAL_RCC_CRC_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_CRCEN))
  587. #define __HAL_RCC_DMA1_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_DMA1EN))
  588. #define __HAL_RCC_SRAM_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_SRAMEN))
  589. #define __HAL_RCC_FLITF_CLK_DISABLE() (RCC->AHBENR &= ~(RCC_AHBENR_FLITFEN))
  590. /**
  591. * @}
  592. */
  593. /** @defgroup RCC_AHB_Peripheral_Clock_Enable_Disable_Status AHB Peripheral Clock Enable Disable Status
  594. * @brief Get the enable or disable status of the AHB peripheral clock.
  595. * @note After reset, the peripheral clock (used for registers read/write access)
  596. * is disabled and the application software has to enable this clock before
  597. * using it.
  598. * @{
  599. */
  600. #define __HAL_RCC_GPIOA_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOAEN)) != RESET)
  601. #define __HAL_RCC_GPIOB_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOBEN)) != RESET)
  602. #define __HAL_RCC_GPIOC_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOCEN)) != RESET)
  603. #define __HAL_RCC_GPIOF_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOFEN)) != RESET)
  604. #define __HAL_RCC_CRC_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_CRCEN)) != RESET)
  605. #define __HAL_RCC_DMA1_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_DMA1EN)) != RESET)
  606. #define __HAL_RCC_SRAM_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_SRAMEN)) != RESET)
  607. #define __HAL_RCC_FLITF_IS_CLK_ENABLED() ((RCC->AHBENR & (RCC_AHBENR_FLITFEN)) != RESET)
  608. #define __HAL_RCC_GPIOA_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOAEN)) == RESET)
  609. #define __HAL_RCC_GPIOB_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOBEN)) == RESET)
  610. #define __HAL_RCC_GPIOC_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOCEN)) == RESET)
  611. #define __HAL_RCC_GPIOF_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_GPIOFEN)) == RESET)
  612. #define __HAL_RCC_CRC_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_CRCEN)) == RESET)
  613. #define __HAL_RCC_DMA1_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_DMA1EN)) == RESET)
  614. #define __HAL_RCC_SRAM_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_SRAMEN)) == RESET)
  615. #define __HAL_RCC_FLITF_IS_CLK_DISABLED() ((RCC->AHBENR & (RCC_AHBENR_FLITFEN)) == RESET)
  616. /**
  617. * @}
  618. */
  619. /** @defgroup RCC_APB1_Clock_Enable_Disable RCC APB1 Clock Enable Disable
  620. * @brief Enable or disable the Low Speed APB (APB1) peripheral clock.
  621. * @note After reset, the peripheral clock (used for registers read/write access)
  622. * is disabled and the application software has to enable this clock before
  623. * using it.
  624. * @{
  625. */
  626. #define __HAL_RCC_TIM3_CLK_ENABLE() do { \
  627. __IO uint32_t tmpreg; \
  628. SET_BIT(RCC->APB1ENR, RCC_APB1ENR_TIM3EN);\
  629. /* Delay after an RCC peripheral clock enabling */\
  630. tmpreg = READ_BIT(RCC->APB1ENR, RCC_APB1ENR_TIM3EN);\
  631. UNUSED(tmpreg); \
  632. } while(0U)
  633. #define __HAL_RCC_TIM14_CLK_ENABLE() do { \
  634. __IO uint32_t tmpreg; \
  635. SET_BIT(RCC->APB1ENR, RCC_APB1ENR_TIM14EN);\
  636. /* Delay after an RCC peripheral clock enabling */\
  637. tmpreg = READ_BIT(RCC->APB1ENR, RCC_APB1ENR_TIM14EN);\
  638. UNUSED(tmpreg); \
  639. } while(0U)
  640. #define __HAL_RCC_WWDG_CLK_ENABLE() do { \
  641. __IO uint32_t tmpreg; \
  642. SET_BIT(RCC->APB1ENR, RCC_APB1ENR_WWDGEN);\
  643. /* Delay after an RCC peripheral clock enabling */\
  644. tmpreg = READ_BIT(RCC->APB1ENR, RCC_APB1ENR_WWDGEN);\
  645. UNUSED(tmpreg); \
  646. } while(0U)
  647. #define __HAL_RCC_I2C1_CLK_ENABLE() do { \
  648. __IO uint32_t tmpreg; \
  649. SET_BIT(RCC->APB1ENR, RCC_APB1ENR_I2C1EN);\
  650. /* Delay after an RCC peripheral clock enabling */\
  651. tmpreg = READ_BIT(RCC->APB1ENR, RCC_APB1ENR_I2C1EN);\
  652. UNUSED(tmpreg); \
  653. } while(0U)
  654. #define __HAL_RCC_PWR_CLK_ENABLE() do { \
  655. __IO uint32_t tmpreg; \
  656. SET_BIT(RCC->APB1ENR, RCC_APB1ENR_PWREN);\
  657. /* Delay after an RCC peripheral clock enabling */\
  658. tmpreg = READ_BIT(RCC->APB1ENR, RCC_APB1ENR_PWREN);\
  659. UNUSED(tmpreg); \
  660. } while(0U)
  661. #define __HAL_RCC_TIM3_CLK_DISABLE() (RCC->APB1ENR &= ~(RCC_APB1ENR_TIM3EN))
  662. #define __HAL_RCC_TIM14_CLK_DISABLE() (RCC->APB1ENR &= ~(RCC_APB1ENR_TIM14EN))
  663. #define __HAL_RCC_WWDG_CLK_DISABLE() (RCC->APB1ENR &= ~(RCC_APB1ENR_WWDGEN))
  664. #define __HAL_RCC_I2C1_CLK_DISABLE() (RCC->APB1ENR &= ~(RCC_APB1ENR_I2C1EN))
  665. #define __HAL_RCC_PWR_CLK_DISABLE() (RCC->APB1ENR &= ~(RCC_APB1ENR_PWREN))
  666. /**
  667. * @}
  668. */
  669. /** @defgroup RCC_APB1_Peripheral_Clock_Enable_Disable_Status APB1 Peripheral Clock Enable Disable Status
  670. * @brief Get the enable or disable status of the APB1 peripheral clock.
  671. * @note After reset, the peripheral clock (used for registers read/write access)
  672. * is disabled and the application software has to enable this clock before
  673. * using it.
  674. * @{
  675. */
  676. #define __HAL_RCC_TIM3_IS_CLK_ENABLED() ((RCC->APB1ENR & (RCC_APB1ENR_TIM3EN)) != RESET)
  677. #define __HAL_RCC_TIM14_IS_CLK_ENABLED() ((RCC->APB1ENR & (RCC_APB1ENR_TIM14EN)) != RESET)
  678. #define __HAL_RCC_WWDG_IS_CLK_ENABLED() ((RCC->APB1ENR & (RCC_APB1ENR_WWDGEN)) != RESET)
  679. #define __HAL_RCC_I2C1_IS_CLK_ENABLED() ((RCC->APB1ENR & (RCC_APB1ENR_I2C1EN)) != RESET)
  680. #define __HAL_RCC_PWR_IS_CLK_ENABLED() ((RCC->APB1ENR & (RCC_APB1ENR_PWREN)) != RESET)
  681. #define __HAL_RCC_TIM3_IS_CLK_DISABLED() ((RCC->APB1ENR & (RCC_APB1ENR_TIM3EN)) == RESET)
  682. #define __HAL_RCC_TIM14_IS_CLK_DISABLED() ((RCC->APB1ENR & (RCC_APB1ENR_TIM14EN)) == RESET)
  683. #define __HAL_RCC_WWDG_IS_CLK_DISABLED() ((RCC->APB1ENR & (RCC_APB1ENR_WWDGEN)) == RESET)
  684. #define __HAL_RCC_I2C1_IS_CLK_DISABLED() ((RCC->APB1ENR & (RCC_APB1ENR_I2C1EN)) == RESET)
  685. #define __HAL_RCC_PWR_IS_CLK_DISABLED() ((RCC->APB1ENR & (RCC_APB1ENR_PWREN)) == RESET)
  686. /**
  687. * @}
  688. */
  689. /** @defgroup RCC_APB2_Clock_Enable_Disable RCC APB2 Clock Enable Disable
  690. * @brief Enable or disable the High Speed APB (APB2) peripheral clock.
  691. * @note After reset, the peripheral clock (used for registers read/write access)
  692. * is disabled and the application software has to enable this clock before
  693. * using it.
  694. * @{
  695. */
  696. #define __HAL_RCC_SYSCFG_CLK_ENABLE() do { \
  697. __IO uint32_t tmpreg; \
  698. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_SYSCFGEN);\
  699. /* Delay after an RCC peripheral clock enabling */\
  700. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_SYSCFGEN);\
  701. UNUSED(tmpreg); \
  702. } while(0U)
  703. #define __HAL_RCC_ADC1_CLK_ENABLE() do { \
  704. __IO uint32_t tmpreg; \
  705. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_ADC1EN);\
  706. /* Delay after an RCC peripheral clock enabling */\
  707. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_ADC1EN);\
  708. UNUSED(tmpreg); \
  709. } while(0U)
  710. #define __HAL_RCC_TIM1_CLK_ENABLE() do { \
  711. __IO uint32_t tmpreg; \
  712. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM1EN);\
  713. /* Delay after an RCC peripheral clock enabling */\
  714. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM1EN);\
  715. UNUSED(tmpreg); \
  716. } while(0U)
  717. #define __HAL_RCC_SPI1_CLK_ENABLE() do { \
  718. __IO uint32_t tmpreg; \
  719. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_SPI1EN);\
  720. /* Delay after an RCC peripheral clock enabling */\
  721. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_SPI1EN);\
  722. UNUSED(tmpreg); \
  723. } while(0U)
  724. #define __HAL_RCC_TIM16_CLK_ENABLE() do { \
  725. __IO uint32_t tmpreg; \
  726. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM16EN);\
  727. /* Delay after an RCC peripheral clock enabling */\
  728. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM16EN);\
  729. UNUSED(tmpreg); \
  730. } while(0U)
  731. #define __HAL_RCC_TIM17_CLK_ENABLE() do { \
  732. __IO uint32_t tmpreg; \
  733. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM17EN);\
  734. /* Delay after an RCC peripheral clock enabling */\
  735. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_TIM17EN);\
  736. UNUSED(tmpreg); \
  737. } while(0U)
  738. #define __HAL_RCC_USART1_CLK_ENABLE() do { \
  739. __IO uint32_t tmpreg; \
  740. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_USART1EN);\
  741. /* Delay after an RCC peripheral clock enabling */\
  742. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_USART1EN);\
  743. UNUSED(tmpreg); \
  744. } while(0U)
  745. #define __HAL_RCC_DBGMCU_CLK_ENABLE() do { \
  746. __IO uint32_t tmpreg; \
  747. SET_BIT(RCC->APB2ENR, RCC_APB2ENR_DBGMCUEN);\
  748. /* Delay after an RCC peripheral clock enabling */\
  749. tmpreg = READ_BIT(RCC->APB2ENR, RCC_APB2ENR_DBGMCUEN);\
  750. UNUSED(tmpreg); \
  751. } while(0U)
  752. #define __HAL_RCC_SYSCFG_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_SYSCFGEN))
  753. #define __HAL_RCC_ADC1_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_ADC1EN))
  754. #define __HAL_RCC_TIM1_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_TIM1EN))
  755. #define __HAL_RCC_SPI1_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_SPI1EN))
  756. #define __HAL_RCC_TIM16_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_TIM16EN))
  757. #define __HAL_RCC_TIM17_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_TIM17EN))
  758. #define __HAL_RCC_USART1_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_USART1EN))
  759. #define __HAL_RCC_DBGMCU_CLK_DISABLE() (RCC->APB2ENR &= ~(RCC_APB2ENR_DBGMCUEN))
  760. /**
  761. * @}
  762. */
  763. /** @defgroup RCC_APB2_Peripheral_Clock_Enable_Disable_Status APB2 Peripheral Clock Enable Disable Status
  764. * @brief Get the enable or disable status of the APB2 peripheral clock.
  765. * @note After reset, the peripheral clock (used for registers read/write access)
  766. * is disabled and the application software has to enable this clock before
  767. * using it.
  768. * @{
  769. */
  770. #define __HAL_RCC_SYSCFG_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_SYSCFGEN)) != RESET)
  771. #define __HAL_RCC_ADC1_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_ADC1EN)) != RESET)
  772. #define __HAL_RCC_TIM1_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM1EN)) != RESET)
  773. #define __HAL_RCC_SPI1_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_SPI1EN)) != RESET)
  774. #define __HAL_RCC_TIM16_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM16EN)) != RESET)
  775. #define __HAL_RCC_TIM17_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM17EN)) != RESET)
  776. #define __HAL_RCC_USART1_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_USART1EN)) != RESET)
  777. #define __HAL_RCC_DBGMCU_IS_CLK_ENABLED() ((RCC->APB2ENR & (RCC_APB2ENR_DBGMCUEN)) != RESET)
  778. #define __HAL_RCC_SYSCFG_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_SYSCFGEN)) == RESET)
  779. #define __HAL_RCC_ADC1_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_ADC1EN)) == RESET)
  780. #define __HAL_RCC_TIM1_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM1EN)) == RESET)
  781. #define __HAL_RCC_SPI1_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_SPI1EN)) == RESET)
  782. #define __HAL_RCC_TIM16_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM16EN)) == RESET)
  783. #define __HAL_RCC_TIM17_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_TIM17EN)) == RESET)
  784. #define __HAL_RCC_USART1_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_USART1EN)) == RESET)
  785. #define __HAL_RCC_DBGMCU_IS_CLK_DISABLED() ((RCC->APB2ENR & (RCC_APB2ENR_DBGMCUEN)) == RESET)
  786. /**
  787. * @}
  788. */
  789. /** @defgroup RCC_AHB_Force_Release_Reset RCC AHB Force Release Reset
  790. * @brief Force or release AHB peripheral reset.
  791. * @{
  792. */
  793. #define __HAL_RCC_AHB_FORCE_RESET() (RCC->AHBRSTR = 0xFFFFFFFFU)
  794. #define __HAL_RCC_GPIOA_FORCE_RESET() (RCC->AHBRSTR |= (RCC_AHBRSTR_GPIOARST))
  795. #define __HAL_RCC_GPIOB_FORCE_RESET() (RCC->AHBRSTR |= (RCC_AHBRSTR_GPIOBRST))
  796. #define __HAL_RCC_GPIOC_FORCE_RESET() (RCC->AHBRSTR |= (RCC_AHBRSTR_GPIOCRST))
  797. #define __HAL_RCC_GPIOF_FORCE_RESET() (RCC->AHBRSTR |= (RCC_AHBRSTR_GPIOFRST))
  798. #define __HAL_RCC_AHB_RELEASE_RESET() (RCC->AHBRSTR = 0x00000000U)
  799. #define __HAL_RCC_GPIOA_RELEASE_RESET() (RCC->AHBRSTR &= ~(RCC_AHBRSTR_GPIOARST))
  800. #define __HAL_RCC_GPIOB_RELEASE_RESET() (RCC->AHBRSTR &= ~(RCC_AHBRSTR_GPIOBRST))
  801. #define __HAL_RCC_GPIOC_RELEASE_RESET() (RCC->AHBRSTR &= ~(RCC_AHBRSTR_GPIOCRST))
  802. #define __HAL_RCC_GPIOF_RELEASE_RESET() (RCC->AHBRSTR &= ~(RCC_AHBRSTR_GPIOFRST))
  803. /**
  804. * @}
  805. */
  806. /** @defgroup RCC_APB1_Force_Release_Reset RCC APB1 Force Release Reset
  807. * @brief Force or release APB1 peripheral reset.
  808. * @{
  809. */
  810. #define __HAL_RCC_APB1_FORCE_RESET() (RCC->APB1RSTR = 0xFFFFFFFFU)
  811. #define __HAL_RCC_TIM3_FORCE_RESET() (RCC->APB1RSTR |= (RCC_APB1RSTR_TIM3RST))
  812. #define __HAL_RCC_TIM14_FORCE_RESET() (RCC->APB1RSTR |= (RCC_APB1RSTR_TIM14RST))
  813. #define __HAL_RCC_WWDG_FORCE_RESET() (RCC->APB1RSTR |= (RCC_APB1RSTR_WWDGRST))
  814. #define __HAL_RCC_I2C1_FORCE_RESET() (RCC->APB1RSTR |= (RCC_APB1RSTR_I2C1RST))
  815. #define __HAL_RCC_PWR_FORCE_RESET() (RCC->APB1RSTR |= (RCC_APB1RSTR_PWRRST))
  816. #define __HAL_RCC_APB1_RELEASE_RESET() (RCC->APB1RSTR = 0x00000000U)
  817. #define __HAL_RCC_TIM3_RELEASE_RESET() (RCC->APB1RSTR &= ~(RCC_APB1RSTR_TIM3RST))
  818. #define __HAL_RCC_TIM14_RELEASE_RESET() (RCC->APB1RSTR &= ~(RCC_APB1RSTR_TIM14RST))
  819. #define __HAL_RCC_WWDG_RELEASE_RESET() (RCC->APB1RSTR &= ~(RCC_APB1RSTR_WWDGRST))
  820. #define __HAL_RCC_I2C1_RELEASE_RESET() (RCC->APB1RSTR &= ~(RCC_APB1RSTR_I2C1RST))
  821. #define __HAL_RCC_PWR_RELEASE_RESET() (RCC->APB1RSTR &= ~(RCC_APB1RSTR_PWRRST))
  822. /**
  823. * @}
  824. */
  825. /** @defgroup RCC_APB2_Force_Release_Reset RCC APB2 Force Release Reset
  826. * @brief Force or release APB2 peripheral reset.
  827. * @{
  828. */
  829. #define __HAL_RCC_APB2_FORCE_RESET() (RCC->APB2RSTR = 0xFFFFFFFFU)
  830. #define __HAL_RCC_SYSCFG_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_SYSCFGRST))
  831. #define __HAL_RCC_ADC1_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_ADC1RST))
  832. #define __HAL_RCC_TIM1_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_TIM1RST))
  833. #define __HAL_RCC_SPI1_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_SPI1RST))
  834. #define __HAL_RCC_USART1_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_USART1RST))
  835. #define __HAL_RCC_TIM16_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_TIM16RST))
  836. #define __HAL_RCC_TIM17_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_TIM17RST))
  837. #define __HAL_RCC_DBGMCU_FORCE_RESET() (RCC->APB2RSTR |= (RCC_APB2RSTR_DBGMCURST))
  838. #define __HAL_RCC_APB2_RELEASE_RESET() (RCC->APB2RSTR = 0x00000000U)
  839. #define __HAL_RCC_SYSCFG_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_SYSCFGRST))
  840. #define __HAL_RCC_ADC1_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_ADC1RST))
  841. #define __HAL_RCC_TIM1_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_TIM1RST))
  842. #define __HAL_RCC_SPI1_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_SPI1RST))
  843. #define __HAL_RCC_USART1_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_USART1RST))
  844. #define __HAL_RCC_TIM16_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_TIM16RST))
  845. #define __HAL_RCC_TIM17_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_TIM17RST))
  846. #define __HAL_RCC_DBGMCU_RELEASE_RESET() (RCC->APB2RSTR &= ~(RCC_APB2RSTR_DBGMCURST))
  847. /**
  848. * @}
  849. */
  850. /** @defgroup RCC_HSI_Configuration HSI Configuration
  851. * @{
  852. */
  853. /** @brief Macros to enable or disable the Internal High Speed oscillator (HSI).
  854. * @note The HSI is stopped by hardware when entering STOP and STANDBY modes.
  855. * @note HSI can not be stopped if it is used as system clock source. In this case,
  856. * you have to select another source of the system clock then stop the HSI.
  857. * @note After enabling the HSI, the application software should wait on HSIRDY
  858. * flag to be set indicating that HSI clock is stable and can be used as
  859. * system clock source.
  860. * @note When the HSI is stopped, HSIRDY flag goes low after 6 HSI oscillator
  861. * clock cycles.
  862. */
  863. #define __HAL_RCC_HSI_ENABLE() SET_BIT(RCC->CR, RCC_CR_HSION)
  864. #define __HAL_RCC_HSI_DISABLE() CLEAR_BIT(RCC->CR, RCC_CR_HSION)
  865. /** @brief Macro to adjust the Internal High Speed oscillator (HSI) calibration value.
  866. * @note The calibration is used to compensate for the variations in voltage
  867. * and temperature that influence the frequency of the internal HSI RC.
  868. * @param _HSICALIBRATIONVALUE_ specifies the calibration trimming value.
  869. * (default is RCC_HSICALIBRATION_DEFAULT).
  870. * This parameter must be a number between 0 and 0x1F.
  871. */
  872. #define __HAL_RCC_HSI_CALIBRATIONVALUE_ADJUST(_HSICALIBRATIONVALUE_) \
  873. MODIFY_REG(RCC->CR, RCC_CR_HSITRIM, (uint32_t)(_HSICALIBRATIONVALUE_) << RCC_CR_HSITRIM_BitNumber)
  874. /**
  875. * @}
  876. */
  877. /** @defgroup RCC_LSI_Configuration LSI Configuration
  878. * @{
  879. */
  880. /** @brief Macro to enable the Internal Low Speed oscillator (LSI).
  881. * @note After enabling the LSI, the application software should wait on
  882. * LSIRDY flag to be set indicating that LSI clock is stable and can
  883. * be used to clock the IWDG and/or the RTC.
  884. */
  885. #define __HAL_RCC_LSI_ENABLE() SET_BIT(RCC->CSR, RCC_CSR_LSION)
  886. /** @brief Macro to disable the Internal Low Speed oscillator (LSI).
  887. * @note LSI can not be disabled if the IWDG is running.
  888. * @note When the LSI is stopped, LSIRDY flag goes low after 6 LSI oscillator
  889. * clock cycles.
  890. */
  891. #define __HAL_RCC_LSI_DISABLE() CLEAR_BIT(RCC->CSR, RCC_CSR_LSION)
  892. /**
  893. * @}
  894. */
  895. /** @defgroup RCC_HSE_Configuration HSE Configuration
  896. * @{
  897. */
  898. /**
  899. * @brief Macro to configure the External High Speed oscillator (HSE).
  900. * @note Transition HSE Bypass to HSE On and HSE On to HSE Bypass are not
  901. * supported by this macro. User should request a transition to HSE Off
  902. * first and then HSE On or HSE Bypass.
  903. * @note After enabling the HSE (RCC_HSE_ON or RCC_HSE_Bypass), the application
  904. * software should wait on HSERDY flag to be set indicating that HSE clock
  905. * is stable and can be used to clock the PLL and/or system clock.
  906. * @note HSE state can not be changed if it is used directly or through the
  907. * PLL as system clock. In this case, you have to select another source
  908. * of the system clock then change the HSE state (ex. disable it).
  909. * @note The HSE is stopped by hardware when entering STOP and STANDBY modes.
  910. * @note This function reset the CSSON bit, so if the clock security system(CSS)
  911. * was previously enabled you have to enable it again after calling this
  912. * function.
  913. * @param __STATE__ specifies the new state of the HSE.
  914. * This parameter can be one of the following values:
  915. * @arg @ref RCC_HSE_OFF turn OFF the HSE oscillator, HSERDY flag goes low after
  916. * 6 HSE oscillator clock cycles.
  917. * @arg @ref RCC_HSE_ON turn ON the HSE oscillator
  918. * @arg @ref RCC_HSE_BYPASS HSE oscillator bypassed with external clock
  919. */
  920. #define __HAL_RCC_HSE_CONFIG(__STATE__) \
  921. do{ \
  922. if ((__STATE__) == RCC_HSE_ON) \
  923. { \
  924. SET_BIT(RCC->CR, RCC_CR_HSEON); \
  925. } \
  926. else if ((__STATE__) == RCC_HSE_OFF) \
  927. { \
  928. CLEAR_BIT(RCC->CR, RCC_CR_HSEON); \
  929. CLEAR_BIT(RCC->CR, RCC_CR_HSEBYP); \
  930. } \
  931. else if ((__STATE__) == RCC_HSE_BYPASS) \
  932. { \
  933. SET_BIT(RCC->CR, RCC_CR_HSEBYP); \
  934. SET_BIT(RCC->CR, RCC_CR_HSEON); \
  935. } \
  936. else \
  937. { \
  938. CLEAR_BIT(RCC->CR, RCC_CR_HSEON); \
  939. CLEAR_BIT(RCC->CR, RCC_CR_HSEBYP); \
  940. } \
  941. }while(0U)
  942. /**
  943. * @brief Macro to configure the External High Speed oscillator (HSE) Predivision factor for PLL.
  944. * @note Predivision factor can not be changed if PLL is used as system clock
  945. * In this case, you have to select another source of the system clock, disable the PLL and
  946. * then change the HSE predivision factor.
  947. * @param __HSE_PREDIV_VALUE__ specifies the division value applied to HSE.
  948. * This parameter must be a number between RCC_HSE_PREDIV_DIV1 and RCC_HSE_PREDIV_DIV16.
  949. */
  950. #define __HAL_RCC_HSE_PREDIV_CONFIG(__HSE_PREDIV_VALUE__) \
  951. MODIFY_REG(RCC->CFGR2, RCC_CFGR2_PREDIV, (uint32_t)(__HSE_PREDIV_VALUE__))
  952. /**
  953. * @}
  954. */
  955. /** @defgroup RCC_LSE_Configuration LSE Configuration
  956. * @{
  957. */
  958. /**
  959. * @brief Macro to configure the External Low Speed oscillator (LSE).
  960. * @note Transitions LSE Bypass to LSE On and LSE On to LSE Bypass are not supported by this macro.
  961. * @note As the LSE is in the Backup domain and write access is denied to
  962. * this domain after reset, you have to enable write access using
  963. * @ref HAL_PWR_EnableBkUpAccess() function before to configure the LSE
  964. * (to be done once after reset).
  965. * @note After enabling the LSE (RCC_LSE_ON or RCC_LSE_BYPASS), the application
  966. * software should wait on LSERDY flag to be set indicating that LSE clock
  967. * is stable and can be used to clock the RTC.
  968. * @param __STATE__ specifies the new state of the LSE.
  969. * This parameter can be one of the following values:
  970. * @arg @ref RCC_LSE_OFF turn OFF the LSE oscillator, LSERDY flag goes low after
  971. * 6 LSE oscillator clock cycles.
  972. * @arg @ref RCC_LSE_ON turn ON the LSE oscillator.
  973. * @arg @ref RCC_LSE_BYPASS LSE oscillator bypassed with external clock.
  974. */
  975. #define __HAL_RCC_LSE_CONFIG(__STATE__) \
  976. do{ \
  977. if ((__STATE__) == RCC_LSE_ON) \
  978. { \
  979. SET_BIT(RCC->BDCR, RCC_BDCR_LSEON); \
  980. } \
  981. else if ((__STATE__) == RCC_LSE_OFF) \
  982. { \
  983. CLEAR_BIT(RCC->BDCR, RCC_BDCR_LSEON); \
  984. CLEAR_BIT(RCC->BDCR, RCC_BDCR_LSEBYP); \
  985. } \
  986. else if ((__STATE__) == RCC_LSE_BYPASS) \
  987. { \
  988. SET_BIT(RCC->BDCR, RCC_BDCR_LSEBYP); \
  989. SET_BIT(RCC->BDCR, RCC_BDCR_LSEON); \
  990. } \
  991. else \
  992. { \
  993. CLEAR_BIT(RCC->BDCR, RCC_BDCR_LSEON); \
  994. CLEAR_BIT(RCC->BDCR, RCC_BDCR_LSEBYP); \
  995. } \
  996. }while(0U)
  997. /**
  998. * @}
  999. */
  1000. /** @defgroup RCC_HSI14_Configuration RCC_HSI14_Configuration
  1001. * @{
  1002. */
  1003. /** @brief Macro to enable the Internal 14Mhz High Speed oscillator (HSI14).
  1004. * @note After enabling the HSI14 with @ref __HAL_RCC_HSI14_ENABLE(), the application software
  1005. * should wait on HSI14RDY flag to be set indicating that HSI clock is stable and can be
  1006. * used as system clock source. This is not necessary if @ref HAL_RCC_OscConfig() is used.
  1007. * clock cycles.
  1008. */
  1009. #define __HAL_RCC_HSI14_ENABLE() SET_BIT(RCC->CR2, RCC_CR2_HSI14ON)
  1010. /** @brief Macro to disable the Internal 14Mhz High Speed oscillator (HSI14).
  1011. * @note The HSI14 is stopped by hardware when entering STOP and STANDBY modes.
  1012. * @note HSI14 can not be stopped if it is used as system clock source. In this case,
  1013. * you have to select another source of the system clock then stop the HSI14.
  1014. * @note When the HSI14 is stopped, HSI14RDY flag goes low after 6 HSI14 oscillator
  1015. * clock cycles.
  1016. */
  1017. #define __HAL_RCC_HSI14_DISABLE() CLEAR_BIT(RCC->CR2, RCC_CR2_HSI14ON)
  1018. /** @brief Macro to enable the Internal 14Mhz High Speed oscillator (HSI14) used by ADC.
  1019. */
  1020. #define __HAL_RCC_HSI14ADC_ENABLE() CLEAR_BIT(RCC->CR2, RCC_CR2_HSI14DIS)
  1021. /** @brief Macro to disable the Internal 14Mhz High Speed oscillator (HSI14) used by ADC.
  1022. */
  1023. #define __HAL_RCC_HSI14ADC_DISABLE() SET_BIT(RCC->CR2, RCC_CR2_HSI14DIS)
  1024. /** @brief Macro to adjust the Internal 14Mhz High Speed oscillator (HSI) calibration value.
  1025. * @note The calibration is used to compensate for the variations in voltage
  1026. * and temperature that influence the frequency of the internal HSI14 RC.
  1027. * @param __HSI14CALIBRATIONVALUE__ specifies the calibration trimming value
  1028. * (default is RCC_HSI14CALIBRATION_DEFAULT).
  1029. * This parameter must be a number between 0 and 0x1F.
  1030. */
  1031. #define __HAL_RCC_HSI14_CALIBRATIONVALUE_ADJUST(__HSI14CALIBRATIONVALUE__) \
  1032. MODIFY_REG(RCC->CR2, RCC_CR2_HSI14TRIM, (uint32_t)(__HSI14CALIBRATIONVALUE__) << RCC_HSI14TRIM_BIT_NUMBER)
  1033. /**
  1034. * @}
  1035. */
  1036. /** @defgroup RCC_USARTx_Clock_Config RCC USARTx Clock Config
  1037. * @{
  1038. */
  1039. /** @brief Macro to configure the USART1 clock (USART1CLK).
  1040. * @param __USART1CLKSOURCE__ specifies the USART1 clock source.
  1041. * This parameter can be one of the following values:
  1042. * @arg @ref RCC_USART1CLKSOURCE_PCLK1 PCLK1 selected as USART1 clock
  1043. * @arg @ref RCC_USART1CLKSOURCE_HSI HSI selected as USART1 clock
  1044. * @arg @ref RCC_USART1CLKSOURCE_SYSCLK System Clock selected as USART1 clock
  1045. * @arg @ref RCC_USART1CLKSOURCE_LSE LSE selected as USART1 clock
  1046. */
  1047. #define __HAL_RCC_USART1_CONFIG(__USART1CLKSOURCE__) \
  1048. MODIFY_REG(RCC->CFGR3, RCC_CFGR3_USART1SW, (uint32_t)(__USART1CLKSOURCE__))
  1049. /** @brief Macro to get the USART1 clock source.
  1050. * @retval The clock source can be one of the following values:
  1051. * @arg @ref RCC_USART1CLKSOURCE_PCLK1 PCLK1 selected as USART1 clock
  1052. * @arg @ref RCC_USART1CLKSOURCE_HSI HSI selected as USART1 clock
  1053. * @arg @ref RCC_USART1CLKSOURCE_SYSCLK System Clock selected as USART1 clock
  1054. * @arg @ref RCC_USART1CLKSOURCE_LSE LSE selected as USART1 clock
  1055. */
  1056. #define __HAL_RCC_GET_USART1_SOURCE() ((uint32_t)(READ_BIT(RCC->CFGR3, RCC_CFGR3_USART1SW)))
  1057. /**
  1058. * @}
  1059. */
  1060. /** @defgroup RCC_I2Cx_Clock_Config RCC I2Cx Clock Config
  1061. * @{
  1062. */
  1063. /** @brief Macro to configure the I2C1 clock (I2C1CLK).
  1064. * @param __I2C1CLKSOURCE__ specifies the I2C1 clock source.
  1065. * This parameter can be one of the following values:
  1066. * @arg @ref RCC_I2C1CLKSOURCE_HSI HSI selected as I2C1 clock
  1067. * @arg @ref RCC_I2C1CLKSOURCE_SYSCLK System Clock selected as I2C1 clock
  1068. */
  1069. #define __HAL_RCC_I2C1_CONFIG(__I2C1CLKSOURCE__) \
  1070. MODIFY_REG(RCC->CFGR3, RCC_CFGR3_I2C1SW, (uint32_t)(__I2C1CLKSOURCE__))
  1071. /** @brief Macro to get the I2C1 clock source.
  1072. * @retval The clock source can be one of the following values:
  1073. * @arg @ref RCC_I2C1CLKSOURCE_HSI HSI selected as I2C1 clock
  1074. * @arg @ref RCC_I2C1CLKSOURCE_SYSCLK System Clock selected as I2C1 clock
  1075. */
  1076. #define __HAL_RCC_GET_I2C1_SOURCE() ((uint32_t)(READ_BIT(RCC->CFGR3, RCC_CFGR3_I2C1SW)))
  1077. /**
  1078. * @}
  1079. */
  1080. /** @defgroup RCC_PLL_Configuration PLL Configuration
  1081. * @{
  1082. */
  1083. /** @brief Macro to enable the main PLL.
  1084. * @note After enabling the main PLL, the application software should wait on
  1085. * PLLRDY flag to be set indicating that PLL clock is stable and can
  1086. * be used as system clock source.
  1087. * @note The main PLL is disabled by hardware when entering STOP and STANDBY modes.
  1088. */
  1089. #define __HAL_RCC_PLL_ENABLE() SET_BIT(RCC->CR, RCC_CR_PLLON)
  1090. /** @brief Macro to disable the main PLL.
  1091. * @note The main PLL can not be disabled if it is used as system clock source
  1092. */
  1093. #define __HAL_RCC_PLL_DISABLE() CLEAR_BIT(RCC->CR, RCC_CR_PLLON)
  1094. /** @brief Macro to configure the PLL clock source, multiplication and division factors.
  1095. * @note This function must be used only when the main PLL is disabled.
  1096. *
  1097. * @param __RCC_PLLSOURCE__ specifies the PLL entry clock source.
  1098. * This parameter can be one of the following values:
  1099. * @arg @ref RCC_PLLSOURCE_HSI HSI oscillator clock selected as PLL clock entry
  1100. * @arg @ref RCC_PLLSOURCE_HSE HSE oscillator clock selected as PLL clock entry
  1101. * @param __PLLMUL__ specifies the multiplication factor for PLL VCO output clock
  1102. * This parameter can be one of the following values:
  1103. * This parameter must be a number between RCC_PLL_MUL2 and RCC_PLL_MUL16.
  1104. * @param __PREDIV__ specifies the predivider factor for PLL VCO input clock
  1105. * This parameter must be a number between RCC_PREDIV_DIV1 and RCC_PREDIV_DIV16.
  1106. *
  1107. */
  1108. #define __HAL_RCC_PLL_CONFIG(__RCC_PLLSOURCE__ , __PREDIV__, __PLLMUL__) \
  1109. do { \
  1110. MODIFY_REG(RCC->CFGR2, RCC_CFGR2_PREDIV, (__PREDIV__)); \
  1111. MODIFY_REG(RCC->CFGR, RCC_CFGR_PLLMUL | RCC_CFGR_PLLSRC, (uint32_t)((__PLLMUL__)|(__RCC_PLLSOURCE__))); \
  1112. } while(0U)
  1113. /** @brief Get oscillator clock selected as PLL input clock
  1114. * @retval The clock source used for PLL entry. The returned value can be one
  1115. * of the following:
  1116. * @arg @ref RCC_PLLSOURCE_HSE HSE oscillator clock selected as PLL input clock
  1117. */
  1118. #define __HAL_RCC_GET_PLL_OSCSOURCE() ((uint32_t)(READ_BIT(RCC->CFGR, RCC_CFGR_PLLSRC)))
  1119. /**
  1120. * @}
  1121. */
  1122. /** @defgroup RCC_Get_Clock_source Get Clock source
  1123. * @{
  1124. */
  1125. /**
  1126. * @brief Macro to configure the system clock source.
  1127. * @param __SYSCLKSOURCE__ specifies the system clock source.
  1128. * This parameter can be one of the following values:
  1129. * @arg @ref RCC_SYSCLKSOURCE_HSI HSI oscillator is used as system clock source.
  1130. * @arg @ref RCC_SYSCLKSOURCE_HSE HSE oscillator is used as system clock source.
  1131. * @arg @ref RCC_SYSCLKSOURCE_PLLCLK PLL output is used as system clock source.
  1132. */
  1133. #define __HAL_RCC_SYSCLK_CONFIG(__SYSCLKSOURCE__) \
  1134. MODIFY_REG(RCC->CFGR, RCC_CFGR_SW, (__SYSCLKSOURCE__))
  1135. /** @brief Macro to get the clock source used as system clock.
  1136. * @retval The clock source used as system clock. The returned value can be one
  1137. * of the following:
  1138. * @arg @ref RCC_SYSCLKSOURCE_STATUS_HSI HSI used as system clock
  1139. * @arg @ref RCC_SYSCLKSOURCE_STATUS_HSE HSE used as system clock
  1140. * @arg @ref RCC_SYSCLKSOURCE_STATUS_PLLCLK PLL used as system clock
  1141. */
  1142. #define __HAL_RCC_GET_SYSCLK_SOURCE() ((uint32_t)(RCC->CFGR & RCC_CFGR_SWS))
  1143. /**
  1144. * @}
  1145. */
  1146. /** @defgroup RCCEx_MCOx_Clock_Config RCC Extended MCOx Clock Config
  1147. * @{
  1148. */
  1149. #if defined(RCC_CFGR_MCOPRE)
  1150. /** @brief Macro to configure the MCO clock.
  1151. * @param __MCOCLKSOURCE__ specifies the MCO clock source.
  1152. * This parameter can be one of the following values:
  1153. * @arg @ref RCC_MCO1SOURCE_NOCLOCK No clock selected as MCO clock
  1154. * @arg @ref RCC_MCO1SOURCE_SYSCLK System Clock selected as MCO clock
  1155. * @arg @ref RCC_MCO1SOURCE_HSI HSI oscillator clock selected as MCO clock
  1156. * @arg @ref RCC_MCO1SOURCE_HSE HSE selected as MCO clock
  1157. * @arg @ref RCC_MCO1SOURCE_LSI LSI selected as MCO clock
  1158. * @arg @ref RCC_MCO1SOURCE_LSE LSE selected as MCO clock
  1159. * @arg @ref RCC_MCO1SOURCE_HSI14 HSI14 selected as MCO clock
  1160. @if STM32F042x6
  1161. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1162. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1163. @elseif STM32F048xx
  1164. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1165. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1166. @elseif STM32F071xB
  1167. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1168. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1169. @elseif STM32F072xB
  1170. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1171. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1172. @elseif STM32F078xx
  1173. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1174. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1175. @elseif STM32F091xC
  1176. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1177. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1178. @elseif STM32F098xx
  1179. * @arg @ref RCC_MCO1SOURCE_HSI48 HSI48 selected as MCO clock
  1180. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1181. @elseif STM32F030x6
  1182. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1183. @elseif STM32F030xC
  1184. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1185. @elseif STM32F031x6
  1186. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1187. @elseif STM32F038xx
  1188. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1189. @elseif STM32F070x6
  1190. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1191. @elseif STM32F070xB
  1192. * @arg @ref RCC_MCO1SOURCE_PLLCLK PLLCLK selected as MCO clock
  1193. @endif
  1194. * @arg @ref RCC_MCO1SOURCE_PLLCLK_DIV2 PLLCLK Divided by 2 selected as MCO clock
  1195. * @param __MCODIV__ specifies the MCO clock prescaler.
  1196. * This parameter can be one of the following values:
  1197. * @arg @ref RCC_MCODIV_1 MCO clock source is divided by 1
  1198. * @arg @ref RCC_MCODIV_2 MCO clock source is divided by 2
  1199. * @arg @ref RCC_MCODIV_4 MCO clock source is divided by 4
  1200. * @arg @ref RCC_MCODIV_8 MCO clock source is divided by 8
  1201. * @arg @ref RCC_MCODIV_16 MCO clock source is divided by 16
  1202. * @arg @ref RCC_MCODIV_32 MCO clock source is divided by 32
  1203. * @arg @ref RCC_MCODIV_64 MCO clock source is divided by 64
  1204. * @arg @ref RCC_MCODIV_128 MCO clock source is divided by 128
  1205. */
  1206. #else
  1207. /** @brief Macro to configure the MCO clock.
  1208. * @param __MCOCLKSOURCE__ specifies the MCO clock source.
  1209. * This parameter can be one of the following values:
  1210. * @arg @ref RCC_MCO1SOURCE_NOCLOCK No clock selected as MCO clock
  1211. * @arg @ref RCC_MCO1SOURCE_SYSCLK System Clock selected as MCO clock
  1212. * @arg @ref RCC_MCO1SOURCE_HSI HSI selected as MCO clock
  1213. * @arg @ref RCC_MCO1SOURCE_HSE HSE selected as MCO clock
  1214. * @arg @ref RCC_MCO1SOURCE_LSI LSI selected as MCO clock
  1215. * @arg @ref RCC_MCO1SOURCE_LSE LSE selected as MCO clock
  1216. * @arg @ref RCC_MCO1SOURCE_HSI14 HSI14 selected as MCO clock
  1217. * @arg @ref RCC_MCO1SOURCE_PLLCLK_DIV2 PLLCLK Divided by 2 selected as MCO clock
  1218. * @param __MCODIV__ specifies the MCO clock prescaler.
  1219. * This parameter can be one of the following values:
  1220. * @arg @ref RCC_MCODIV_1 No division applied on MCO clock source
  1221. */
  1222. #endif
  1223. #if defined(RCC_CFGR_MCOPRE)
  1224. #define __HAL_RCC_MCO1_CONFIG(__MCOCLKSOURCE__, __MCODIV__) \
  1225. MODIFY_REG(RCC->CFGR, (RCC_CFGR_MCO | RCC_CFGR_MCOPRE), ((__MCOCLKSOURCE__) | (__MCODIV__)))
  1226. #else
  1227. #define __HAL_RCC_MCO1_CONFIG(__MCOCLKSOURCE__, __MCODIV__) \
  1228. MODIFY_REG(RCC->CFGR, RCC_CFGR_MCO, (__MCOCLKSOURCE__))
  1229. #endif
  1230. /**
  1231. * @}
  1232. */
  1233. /** @defgroup RCC_RTC_Clock_Configuration RCC RTC Clock Configuration
  1234. * @{
  1235. */
  1236. /** @brief Macro to configure the RTC clock (RTCCLK).
  1237. * @note As the RTC clock configuration bits are in the Backup domain and write
  1238. * access is denied to this domain after reset, you have to enable write
  1239. * access using the Power Backup Access macro before to configure
  1240. * the RTC clock source (to be done once after reset).
  1241. * @note Once the RTC clock is configured it cannot be changed unless the
  1242. * Backup domain is reset using @ref __HAL_RCC_BACKUPRESET_FORCE() macro, or by
  1243. * a Power On Reset (POR).
  1244. *
  1245. * @param __RTC_CLKSOURCE__ specifies the RTC clock source.
  1246. * This parameter can be one of the following values:
  1247. * @arg @ref RCC_RTCCLKSOURCE_NO_CLK No clock selected as RTC clock
  1248. * @arg @ref RCC_RTCCLKSOURCE_LSE LSE selected as RTC clock
  1249. * @arg @ref RCC_RTCCLKSOURCE_LSI LSI selected as RTC clock
  1250. * @arg @ref RCC_RTCCLKSOURCE_HSE_DIV32 HSE clock divided by 32
  1251. * @note If the LSE or LSI is used as RTC clock source, the RTC continues to
  1252. * work in STOP and STANDBY modes, and can be used as wakeup source.
  1253. * However, when the LSI clock and HSE clock divided by 32 is used as RTC clock source,
  1254. * the RTC cannot be used in STOP and STANDBY modes.
  1255. * @note The system must always be configured so as to get a PCLK frequency greater than or
  1256. * equal to the RTCCLK frequency for a proper operation of the RTC.
  1257. */
  1258. #define __HAL_RCC_RTC_CONFIG(__RTC_CLKSOURCE__) MODIFY_REG(RCC->BDCR, RCC_BDCR_RTCSEL, (__RTC_CLKSOURCE__))
  1259. /** @brief Macro to get the RTC clock source.
  1260. * @retval The clock source can be one of the following values:
  1261. * @arg @ref RCC_RTCCLKSOURCE_NO_CLK No clock selected as RTC clock
  1262. * @arg @ref RCC_RTCCLKSOURCE_LSE LSE selected as RTC clock
  1263. * @arg @ref RCC_RTCCLKSOURCE_LSI LSI selected as RTC clock
  1264. * @arg @ref RCC_RTCCLKSOURCE_HSE_DIV32 HSE clock divided by 32
  1265. */
  1266. #define __HAL_RCC_GET_RTC_SOURCE() (READ_BIT(RCC->BDCR, RCC_BDCR_RTCSEL))
  1267. /** @brief Macro to enable the the RTC clock.
  1268. * @note These macros must be used only after the RTC clock source was selected.
  1269. */
  1270. #define __HAL_RCC_RTC_ENABLE() SET_BIT(RCC->BDCR, RCC_BDCR_RTCEN)
  1271. /** @brief Macro to disable the the RTC clock.
  1272. * @note These macros must be used only after the RTC clock source was selected.
  1273. */
  1274. #define __HAL_RCC_RTC_DISABLE() CLEAR_BIT(RCC->BDCR, RCC_BDCR_RTCEN)
  1275. /** @brief Macro to force the Backup domain reset.
  1276. * @note This function resets the RTC peripheral (including the backup registers)
  1277. * and the RTC clock source selection in RCC_BDCR register.
  1278. */
  1279. #define __HAL_RCC_BACKUPRESET_FORCE() SET_BIT(RCC->BDCR, RCC_BDCR_BDRST)
  1280. /** @brief Macros to release the Backup domain reset.
  1281. */
  1282. #define __HAL_RCC_BACKUPRESET_RELEASE() CLEAR_BIT(RCC->BDCR, RCC_BDCR_BDRST)
  1283. /**
  1284. * @}
  1285. */
  1286. /** @defgroup RCC_Flags_Interrupts_Management Flags Interrupts Management
  1287. * @brief macros to manage the specified RCC Flags and interrupts.
  1288. * @{
  1289. */
  1290. /** @brief Enable RCC interrupt.
  1291. * @param __INTERRUPT__ specifies the RCC interrupt sources to be enabled.
  1292. * This parameter can be any combination of the following values:
  1293. * @arg @ref RCC_IT_LSIRDY LSI ready interrupt
  1294. * @arg @ref RCC_IT_LSERDY LSE ready interrupt
  1295. * @arg @ref RCC_IT_HSIRDY HSI ready interrupt
  1296. * @arg @ref RCC_IT_HSERDY HSE ready interrupt
  1297. * @arg @ref RCC_IT_PLLRDY main PLL ready interrupt
  1298. * @arg @ref RCC_IT_HSI14RDY HSI14 ready interrupt
  1299. @if STM32F042x6
  1300. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1301. @elseif STM32F048xx
  1302. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1303. @elseif STM32F071xB
  1304. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1305. @elseif STM32F072xB
  1306. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1307. @elseif STM32F078xx
  1308. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1309. @elseif STM32F091xC
  1310. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1311. @elseif STM32F098xx
  1312. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1313. @endif
  1314. */
  1315. #define __HAL_RCC_ENABLE_IT(__INTERRUPT__) (*(__IO uint8_t *) RCC_CIR_BYTE1_ADDRESS |= (__INTERRUPT__))
  1316. /** @brief Disable RCC interrupt.
  1317. * @param __INTERRUPT__ specifies the RCC interrupt sources to be disabled.
  1318. * This parameter can be any combination of the following values:
  1319. * @arg @ref RCC_IT_LSIRDY LSI ready interrupt
  1320. * @arg @ref RCC_IT_LSERDY LSE ready interrupt
  1321. * @arg @ref RCC_IT_HSIRDY HSI ready interrupt
  1322. * @arg @ref RCC_IT_HSERDY HSE ready interrupt
  1323. * @arg @ref RCC_IT_PLLRDY main PLL ready interrupt
  1324. * @arg @ref RCC_IT_HSI14RDY HSI14 ready interrupt
  1325. @if STM32F042x6
  1326. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1327. @elseif STM32F048xx
  1328. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1329. @elseif STM32F071xB
  1330. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1331. @elseif STM32F072xB
  1332. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1333. @elseif STM32F078xx
  1334. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1335. @elseif STM32F091xC
  1336. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1337. @elseif STM32F098xx
  1338. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1339. @endif
  1340. */
  1341. #define __HAL_RCC_DISABLE_IT(__INTERRUPT__) (*(__IO uint8_t *) RCC_CIR_BYTE1_ADDRESS &= (uint8_t)(~(__INTERRUPT__)))
  1342. /** @brief Clear the RCC's interrupt pending bits.
  1343. * @param __INTERRUPT__ specifies the interrupt pending bit to clear.
  1344. * This parameter can be any combination of the following values:
  1345. * @arg @ref RCC_IT_LSIRDY LSI ready interrupt.
  1346. * @arg @ref RCC_IT_LSERDY LSE ready interrupt.
  1347. * @arg @ref RCC_IT_HSIRDY HSI ready interrupt.
  1348. * @arg @ref RCC_IT_HSERDY HSE ready interrupt.
  1349. * @arg @ref RCC_IT_PLLRDY Main PLL ready interrupt.
  1350. * @arg @ref RCC_IT_CSS Clock Security System interrupt
  1351. * @arg @ref RCC_IT_HSI14RDY HSI14 ready interrupt
  1352. @if STM32F042x6
  1353. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1354. @elseif STM32F048xx
  1355. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1356. @elseif STM32F071xB
  1357. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1358. @elseif STM32F072xB
  1359. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1360. @elseif STM32F078xx
  1361. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1362. @elseif STM32F091xC
  1363. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1364. @elseif STM32F098xx
  1365. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1366. @endif
  1367. */
  1368. #define __HAL_RCC_CLEAR_IT(__INTERRUPT__) (*(__IO uint8_t *) RCC_CIR_BYTE2_ADDRESS = (__INTERRUPT__))
  1369. /** @brief Check the RCC's interrupt has occurred or not.
  1370. * @param __INTERRUPT__ specifies the RCC interrupt source to check.
  1371. * This parameter can be one of the following values:
  1372. * @arg @ref RCC_IT_LSIRDY LSI ready interrupt.
  1373. * @arg @ref RCC_IT_LSERDY LSE ready interrupt.
  1374. * @arg @ref RCC_IT_HSIRDY HSI ready interrupt.
  1375. * @arg @ref RCC_IT_HSERDY HSE ready interrupt.
  1376. * @arg @ref RCC_IT_PLLRDY Main PLL ready interrupt.
  1377. * @arg @ref RCC_IT_CSS Clock Security System interrupt
  1378. * @arg @ref RCC_IT_HSI14RDY HSI14 ready interrupt enable
  1379. @if STM32F042x6
  1380. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1381. @elseif STM32F048xx
  1382. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1383. @elseif STM32F071xB
  1384. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1385. @elseif STM32F072xB
  1386. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1387. @elseif STM32F078xx
  1388. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1389. @elseif STM32F091xC
  1390. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1391. @elseif STM32F098xx
  1392. * @arg @ref RCC_IT_HSI48RDY HSI48 ready interrupt
  1393. @endif
  1394. * @retval The new state of __INTERRUPT__ (TRUE or FALSE).
  1395. */
  1396. #define __HAL_RCC_GET_IT(__INTERRUPT__) ((RCC->CIR & (__INTERRUPT__)) == (__INTERRUPT__))
  1397. /** @brief Set RMVF bit to clear the reset flags.
  1398. * The reset flags are RCC_FLAG_PINRST, RCC_FLAG_PORRST, RCC_FLAG_SFTRST,
  1399. * RCC_FLAG_OBLRST, RCC_FLAG_IWDGRST, RCC_FLAG_WWDGRST, RCC_FLAG_LPWRRST
  1400. */
  1401. #define __HAL_RCC_CLEAR_RESET_FLAGS() (RCC->CSR |= RCC_CSR_RMVF)
  1402. /** @brief Check RCC flag is set or not.
  1403. * @param __FLAG__ specifies the flag to check.
  1404. * This parameter can be one of the following values:
  1405. * @arg @ref RCC_FLAG_HSIRDY HSI oscillator clock ready.
  1406. * @arg @ref RCC_FLAG_HSERDY HSE oscillator clock ready.
  1407. * @arg @ref RCC_FLAG_PLLRDY Main PLL clock ready.
  1408. * @arg @ref RCC_FLAG_HSI14RDY HSI14 oscillator clock ready
  1409. @if STM32F038xx
  1410. * @arg @ref RCC_FLAG_V18PWRRST Reset flag of the 1.8 V domain
  1411. @elseif STM32F042x6
  1412. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1413. @elseif STM32F048xx
  1414. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1415. * @arg @ref RCC_FLAG_V18PWRRST Reset flag of the 1.8 V domain
  1416. @elseif STM32F058xx
  1417. * @arg @ref RCC_FLAG_V18PWRRST Reset flag of the 1.8 V domain
  1418. @elseif STM32F071xB
  1419. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1420. @elseif STM32F072xB
  1421. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1422. @elseif STM32F078xx
  1423. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1424. * @arg @ref RCC_FLAG_V18PWRRST Reset flag of the 1.8 V domain
  1425. @elseif STM32F091xC
  1426. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1427. @elseif STM32F098xx
  1428. * @arg @ref RCC_FLAG_HSI48RDY HSI48 oscillator clock ready
  1429. * @arg @ref RCC_FLAG_V18PWRRST Reset flag of the 1.8 V domain
  1430. @endif
  1431. * @arg @ref RCC_FLAG_LSERDY LSE oscillator clock ready.
  1432. * @arg @ref RCC_FLAG_LSIRDY LSI oscillator clock ready.
  1433. * @arg @ref RCC_FLAG_OBLRST Option Byte Load reset
  1434. * @arg @ref RCC_FLAG_PINRST Pin reset.
  1435. * @arg @ref RCC_FLAG_PORRST POR/PDR reset.
  1436. * @arg @ref RCC_FLAG_SFTRST Software reset.
  1437. * @arg @ref RCC_FLAG_IWDGRST Independent Watchdog reset.
  1438. * @arg @ref RCC_FLAG_WWDGRST Window Watchdog reset.
  1439. * @arg @ref RCC_FLAG_LPWRRST Low Power reset.
  1440. * @retval The new state of __FLAG__ (TRUE or FALSE).
  1441. */
  1442. #define __HAL_RCC_GET_FLAG(__FLAG__) (((((__FLAG__) >> 5U) == CR_REG_INDEX)? RCC->CR : \
  1443. (((__FLAG__) >> 5U) == CR2_REG_INDEX)? RCC->CR2 : \
  1444. (((__FLAG__) >> 5U) == BDCR_REG_INDEX) ? RCC->BDCR : \
  1445. RCC->CSR) & (1U << ((__FLAG__) & RCC_FLAG_MASK)))
  1446. /**
  1447. * @}
  1448. */
  1449. /**
  1450. * @}
  1451. */
  1452. /* Include RCC HAL Extension module */
  1453. #include "stm32f0xx_hal_rcc_ex.h"
  1454. /* Exported functions --------------------------------------------------------*/
  1455. /** @addtogroup RCC_Exported_Functions
  1456. * @{
  1457. */
  1458. /** @addtogroup RCC_Exported_Functions_Group1
  1459. * @{
  1460. */
  1461. /* Initialization and de-initialization functions ******************************/
  1462. HAL_StatusTypeDef HAL_RCC_DeInit(void);
  1463. HAL_StatusTypeDef HAL_RCC_OscConfig(RCC_OscInitTypeDef *RCC_OscInitStruct);
  1464. HAL_StatusTypeDef HAL_RCC_ClockConfig(RCC_ClkInitTypeDef *RCC_ClkInitStruct, uint32_t FLatency);
  1465. /**
  1466. * @}
  1467. */
  1468. /** @addtogroup RCC_Exported_Functions_Group2
  1469. * @{
  1470. */
  1471. /* Peripheral Control functions ************************************************/
  1472. void HAL_RCC_MCOConfig(uint32_t RCC_MCOx, uint32_t RCC_MCOSource, uint32_t RCC_MCODiv);
  1473. void HAL_RCC_EnableCSS(void);
  1474. /* CSS NMI IRQ handler */
  1475. void HAL_RCC_NMI_IRQHandler(void);
  1476. /* User Callbacks in non blocking mode (IT mode) */
  1477. void HAL_RCC_CSSCallback(void);
  1478. void HAL_RCC_DisableCSS(void);
  1479. uint32_t HAL_RCC_GetSysClockFreq(void);
  1480. uint32_t HAL_RCC_GetHCLKFreq(void);
  1481. uint32_t HAL_RCC_GetPCLK1Freq(void);
  1482. void HAL_RCC_GetOscConfig(RCC_OscInitTypeDef *RCC_OscInitStruct);
  1483. void HAL_RCC_GetClockConfig(RCC_ClkInitTypeDef *RCC_ClkInitStruct, uint32_t *pFLatency);
  1484. /**
  1485. * @}
  1486. */
  1487. /**
  1488. * @}
  1489. */
  1490. /**
  1491. * @}
  1492. */
  1493. /**
  1494. * @}
  1495. */
  1496. #ifdef __cplusplus
  1497. }
  1498. #endif
  1499. #endif /* __STM32F0xx_HAL_RCC_H */
  1500. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/