stm32f0xx_hal_rcc.h 82 KB

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