ch32v20x_rcc.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264
  1. /********************************** (C) COPYRIGHT *******************************
  2. * File Name : ch32v20x_rcc.h
  3. * Author : WCH
  4. * Version : V1.0.0
  5. * Date : 2024/02/21
  6. * Description : This file provides all the RCC firmware functions.
  7. *********************************************************************************
  8. * Copyright (c) 2021 Nanjing Qinheng Microelectronics Co., Ltd.
  9. * Attention: This software (modified or not) and binary are used for
  10. * microcontroller manufactured by Nanjing Qinheng Microelectronics.
  11. *******************************************************************************/
  12. #ifndef __CH32V20x_RCC_H
  13. #define __CH32V20x_RCC_H
  14. #ifdef __cplusplus
  15. extern "C" {
  16. #endif
  17. #include "ch32v20x.h"
  18. /* RCC_Exported_Types */
  19. typedef struct
  20. {
  21. uint32_t SYSCLK_Frequency; /* returns SYSCLK clock frequency expressed in Hz */
  22. uint32_t HCLK_Frequency; /* returns HCLK clock frequency expressed in Hz */
  23. uint32_t PCLK1_Frequency; /* returns PCLK1 clock frequency expressed in Hz */
  24. uint32_t PCLK2_Frequency; /* returns PCLK2 clock frequency expressed in Hz */
  25. uint32_t ADCCLK_Frequency; /* returns ADCCLK clock frequency expressed in Hz */
  26. } RCC_ClocksTypeDef;
  27. /* HSE_configuration */
  28. #define RCC_HSE_OFF ((uint32_t)0x00000000)
  29. #define RCC_HSE_ON ((uint32_t)0x00010000)
  30. #define RCC_HSE_Bypass ((uint32_t)0x00040000)
  31. /* PLL_entry_clock_source */
  32. #define RCC_PLLSource_HSI_Div2 ((uint32_t)0x00000000)
  33. #define RCC_PLLSource_HSE_Div1 ((uint32_t)0x00010000)
  34. #define RCC_PLLSource_HSE_Div2 ((uint32_t)0x00030000)
  35. /* PLL_multiplication_factor for other CH32V20x */
  36. #define RCC_PLLMul_2 ((uint32_t)0x00000000)
  37. #define RCC_PLLMul_3 ((uint32_t)0x00040000)
  38. #define RCC_PLLMul_4 ((uint32_t)0x00080000)
  39. #define RCC_PLLMul_5 ((uint32_t)0x000C0000)
  40. #define RCC_PLLMul_6 ((uint32_t)0x00100000)
  41. #define RCC_PLLMul_7 ((uint32_t)0x00140000)
  42. #define RCC_PLLMul_8 ((uint32_t)0x00180000)
  43. #define RCC_PLLMul_9 ((uint32_t)0x001C0000)
  44. #define RCC_PLLMul_10 ((uint32_t)0x00200000)
  45. #define RCC_PLLMul_11 ((uint32_t)0x00240000)
  46. #define RCC_PLLMul_12 ((uint32_t)0x00280000)
  47. #define RCC_PLLMul_13 ((uint32_t)0x002C0000)
  48. #define RCC_PLLMul_14 ((uint32_t)0x00300000)
  49. #define RCC_PLLMul_15 ((uint32_t)0x00340000)
  50. #define RCC_PLLMul_16 ((uint32_t)0x00380000)
  51. #define RCC_PLLMul_18 ((uint32_t)0x003C0000)
  52. /* System_clock_source */
  53. #define RCC_SYSCLKSource_HSI ((uint32_t)0x00000000)
  54. #define RCC_SYSCLKSource_HSE ((uint32_t)0x00000001)
  55. #define RCC_SYSCLKSource_PLLCLK ((uint32_t)0x00000002)
  56. /* AHB_clock_source */
  57. #define RCC_SYSCLK_Div1 ((uint32_t)0x00000000)
  58. #define RCC_SYSCLK_Div2 ((uint32_t)0x00000080)
  59. #define RCC_SYSCLK_Div4 ((uint32_t)0x00000090)
  60. #define RCC_SYSCLK_Div8 ((uint32_t)0x000000A0)
  61. #define RCC_SYSCLK_Div16 ((uint32_t)0x000000B0)
  62. #define RCC_SYSCLK_Div64 ((uint32_t)0x000000C0)
  63. #define RCC_SYSCLK_Div128 ((uint32_t)0x000000D0)
  64. #define RCC_SYSCLK_Div256 ((uint32_t)0x000000E0)
  65. #define RCC_SYSCLK_Div512 ((uint32_t)0x000000F0)
  66. /* APB1_APB2_clock_source */
  67. #define RCC_HCLK_Div1 ((uint32_t)0x00000000)
  68. #define RCC_HCLK_Div2 ((uint32_t)0x00000400)
  69. #define RCC_HCLK_Div4 ((uint32_t)0x00000500)
  70. #define RCC_HCLK_Div8 ((uint32_t)0x00000600)
  71. #define RCC_HCLK_Div16 ((uint32_t)0x00000700)
  72. /* RCC_Interrupt_source */
  73. #define RCC_IT_LSIRDY ((uint8_t)0x01)
  74. #define RCC_IT_LSERDY ((uint8_t)0x02)
  75. #define RCC_IT_HSIRDY ((uint8_t)0x04)
  76. #define RCC_IT_HSERDY ((uint8_t)0x08)
  77. #define RCC_IT_PLLRDY ((uint8_t)0x10)
  78. #define RCC_IT_CSS ((uint8_t)0x80)
  79. /* USB_Device_clock_source */
  80. #define RCC_USBCLKSource_PLLCLK_Div1 ((uint8_t)0x00)
  81. #define RCC_USBCLKSource_PLLCLK_Div2 ((uint8_t)0x01)
  82. #define RCC_USBCLKSource_PLLCLK_Div3 ((uint8_t)0x02)
  83. #if defined (CH32V20x_D8) || defined (CH32V20x_D8W)
  84. #define RCC_USBCLKSource_PLLCLK_Div5 ((uint8_t)0x03)
  85. #endif
  86. /* ADC_clock_source */
  87. #define RCC_PCLK2_Div2 ((uint32_t)0x00000000)
  88. #define RCC_PCLK2_Div4 ((uint32_t)0x00004000)
  89. #define RCC_PCLK2_Div6 ((uint32_t)0x00008000)
  90. #define RCC_PCLK2_Div8 ((uint32_t)0x0000C000)
  91. /* LSE_configuration */
  92. #define RCC_LSE_OFF ((uint8_t)0x00)
  93. #define RCC_LSE_ON ((uint8_t)0x01)
  94. #define RCC_LSE_Bypass ((uint8_t)0x04)
  95. /* RTC_clock_source */
  96. #define RCC_RTCCLKSource_LSE ((uint32_t)0x00000100)
  97. #define RCC_RTCCLKSource_LSI ((uint32_t)0x00000200)
  98. #if defined(CH32V20x_D8) || defined(CH32V20x_D8W)
  99. #define RCC_RTCCLKSource_HSE_Div512 ((uint32_t)0x00000300)
  100. #else
  101. #define RCC_RTCCLKSource_HSE_Div128 ((uint32_t)0x00000300)
  102. #endif
  103. /* AHB_peripheral */
  104. #define RCC_AHBPeriph_DMA1 ((uint32_t)0x00000001)
  105. #define RCC_AHBPeriph_DMA2 ((uint32_t)0x00000002)
  106. #define RCC_AHBPeriph_SRAM ((uint32_t)0x00000004)
  107. #define RCC_AHBPeriph_CRC ((uint32_t)0x00000040)
  108. #define RCC_AHBPeriph_FSMC ((uint32_t)0x00000100)
  109. #define RCC_AHBPeriph_RNG ((uint32_t)0x00000200)
  110. #define RCC_AHBPeriph_SDIO ((uint32_t)0x00000400)
  111. #define RCC_AHBPeriph_USBHS ((uint32_t)0x00000800)
  112. #define RCC_AHBPeriph_USBFS ((uint32_t)0x00001000)
  113. #define RCC_AHBPeriph_OTG_FS RCC_AHBPeriph_USBFS
  114. #ifdef CH32V20x_D8W
  115. #define RCC_AHBPeriph_BLE_CRC ((uint32_t)0x00030040)
  116. #endif
  117. /* APB2_peripheral */
  118. #define RCC_APB2Periph_AFIO ((uint32_t)0x00000001)
  119. #define RCC_APB2Periph_GPIOA ((uint32_t)0x00000004)
  120. #define RCC_APB2Periph_GPIOB ((uint32_t)0x00000008)
  121. #define RCC_APB2Periph_GPIOC ((uint32_t)0x00000010)
  122. #define RCC_APB2Periph_GPIOD ((uint32_t)0x00000020)
  123. #define RCC_APB2Periph_GPIOE ((uint32_t)0x00000040)
  124. #define RCC_APB2Periph_ADC1 ((uint32_t)0x00000200)
  125. #define RCC_APB2Periph_ADC2 ((uint32_t)0x00000400)
  126. #define RCC_APB2Periph_TIM1 ((uint32_t)0x00000800)
  127. #define RCC_APB2Periph_SPI1 ((uint32_t)0x00001000)
  128. #define RCC_APB2Periph_TIM8 ((uint32_t)0x00002000)
  129. #define RCC_APB2Periph_USART1 ((uint32_t)0x00004000)
  130. #define RCC_APB2Periph_TIM9 ((uint32_t)0x00080000)
  131. #define RCC_APB2Periph_TIM10 ((uint32_t)0x00100000)
  132. /* APB1_peripheral */
  133. #define RCC_APB1Periph_TIM2 ((uint32_t)0x00000001)
  134. #define RCC_APB1Periph_TIM3 ((uint32_t)0x00000002)
  135. #define RCC_APB1Periph_TIM4 ((uint32_t)0x00000004)
  136. #define RCC_APB1Periph_TIM5 ((uint32_t)0x00000008)
  137. #define RCC_APB1Periph_TIM6 ((uint32_t)0x00000010)
  138. #define RCC_APB1Periph_TIM7 ((uint32_t)0x00000020)
  139. #define RCC_APB1Periph_UART6 ((uint32_t)0x00000040)
  140. #define RCC_APB1Periph_UART7 ((uint32_t)0x00000080)
  141. #define RCC_APB1Periph_UART8 ((uint32_t)0x00000100)
  142. #define RCC_APB1Periph_WWDG ((uint32_t)0x00000800)
  143. #define RCC_APB1Periph_SPI2 ((uint32_t)0x00004000)
  144. #define RCC_APB1Periph_SPI3 ((uint32_t)0x00008000)
  145. #define RCC_APB1Periph_USART2 ((uint32_t)0x00020000)
  146. #define RCC_APB1Periph_USART3 ((uint32_t)0x00040000)
  147. #define RCC_APB1Periph_UART4 ((uint32_t)0x00080000)
  148. #define RCC_APB1Periph_UART5 ((uint32_t)0x00100000)
  149. #define RCC_APB1Periph_I2C1 ((uint32_t)0x00200000)
  150. #define RCC_APB1Periph_I2C2 ((uint32_t)0x00400000)
  151. #define RCC_APB1Periph_USB ((uint32_t)0x00800000)
  152. #define RCC_APB1Periph_CAN1 ((uint32_t)0x02000000)
  153. #define RCC_APB1Periph_CAN2 ((uint32_t)0x04000000)
  154. #define RCC_APB1Periph_BKP ((uint32_t)0x08000000)
  155. #define RCC_APB1Periph_PWR ((uint32_t)0x10000000)
  156. #define RCC_APB1Periph_DAC ((uint32_t)0x20000000)
  157. /* Clock_source_to_output_on_MCO_pin */
  158. #define RCC_MCO_NoClock ((uint8_t)0x00)
  159. #define RCC_MCO_SYSCLK ((uint8_t)0x04)
  160. #define RCC_MCO_HSI ((uint8_t)0x05)
  161. #define RCC_MCO_HSE ((uint8_t)0x06)
  162. #define RCC_MCO_PLLCLK_Div2 ((uint8_t)0x07)
  163. /* RCC_Flag */
  164. #define RCC_FLAG_HSIRDY ((uint8_t)0x21)
  165. #define RCC_FLAG_HSERDY ((uint8_t)0x31)
  166. #define RCC_FLAG_PLLRDY ((uint8_t)0x39)
  167. #define RCC_FLAG_LSERDY ((uint8_t)0x41)
  168. #define RCC_FLAG_LSIRDY ((uint8_t)0x61)
  169. #define RCC_FLAG_PINRST ((uint8_t)0x7A)
  170. #define RCC_FLAG_PORRST ((uint8_t)0x7B)
  171. #define RCC_FLAG_SFTRST ((uint8_t)0x7C)
  172. #define RCC_FLAG_IWDGRST ((uint8_t)0x7D)
  173. #define RCC_FLAG_WWDGRST ((uint8_t)0x7E)
  174. #define RCC_FLAG_LPWRRST ((uint8_t)0x7F)
  175. /* SysTick_clock_source */
  176. #define SysTick_CLKSource_HCLK_Div8 ((uint32_t)0xFFFFFFFB)
  177. #define SysTick_CLKSource_HCLK ((uint32_t)0x00000004)
  178. /* USBFS_clock_source */
  179. #define RCC_USBPLL_Div1 ((uint32_t)0x00)
  180. #define RCC_USBPLL_Div2 ((uint32_t)0x01)
  181. #define RCC_USBPLL_Div3 ((uint32_t)0x02)
  182. #define RCC_USBPLL_Div4 ((uint32_t)0x03)
  183. #define RCC_USBPLL_Div5 ((uint32_t)0x04)
  184. #define RCC_USBPLL_Div6 ((uint32_t)0x05)
  185. #define RCC_USBPLL_Div7 ((uint32_t)0x06)
  186. #define RCC_USBPLL_Div8 ((uint32_t)0x07)
  187. /* ETH_clock_source */
  188. #if defined(CH32V20x_D8) || defined(CH32V20x_D8W)
  189. #define RCC_ETHCLK_Div1 ((uint32_t)0x00)
  190. #define RCC_ETHCLK_Div2 ((uint32_t)0x01)
  191. #endif
  192. void RCC_DeInit(void);
  193. void RCC_HSEConfig(uint32_t RCC_HSE);
  194. ErrorStatus RCC_WaitForHSEStartUp(void);
  195. void RCC_AdjustHSICalibrationValue(uint8_t HSICalibrationValue);
  196. void RCC_HSICmd(FunctionalState NewState);
  197. void RCC_PLLConfig(uint32_t RCC_PLLSource, uint32_t RCC_PLLMul);
  198. void RCC_PLLCmd(FunctionalState NewState);
  199. void RCC_SYSCLKConfig(uint32_t RCC_SYSCLKSource);
  200. uint8_t RCC_GetSYSCLKSource(void);
  201. void RCC_HCLKConfig(uint32_t RCC_SYSCLK);
  202. void RCC_PCLK1Config(uint32_t RCC_HCLK);
  203. void RCC_PCLK2Config(uint32_t RCC_HCLK);
  204. void RCC_ITConfig(uint8_t RCC_IT, FunctionalState NewState);
  205. void RCC_USBCLKConfig(uint32_t RCC_USBCLKSource);
  206. void RCC_ADCCLKConfig(uint32_t RCC_PCLK2);
  207. void RCC_LSEConfig(uint8_t RCC_LSE);
  208. void RCC_LSICmd(FunctionalState NewState);
  209. void RCC_RTCCLKConfig(uint32_t RCC_RTCCLKSource);
  210. void RCC_RTCCLKCmd(FunctionalState NewState);
  211. void RCC_GetClocksFreq(RCC_ClocksTypeDef *RCC_Clocks);
  212. void RCC_AHBPeriphClockCmd(uint32_t RCC_AHBPeriph, FunctionalState NewState);
  213. void RCC_APB2PeriphClockCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);
  214. void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);
  215. void RCC_APB2PeriphResetCmd(uint32_t RCC_APB2Periph, FunctionalState NewState);
  216. void RCC_APB1PeriphResetCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);
  217. void RCC_BackupResetCmd(FunctionalState NewState);
  218. void RCC_ClockSecuritySystemCmd(FunctionalState NewState);
  219. void RCC_MCOConfig(uint8_t RCC_MCO);
  220. FlagStatus RCC_GetFlagStatus(uint8_t RCC_FLAG);
  221. void RCC_ClearFlag(void);
  222. ITStatus RCC_GetITStatus(uint8_t RCC_IT);
  223. void RCC_ClearITPendingBit(uint8_t RCC_IT);
  224. void RCC_ADCCLKADJcmd(FunctionalState NewState);
  225. FlagStatus RCC_USB5PRE_JUDGE();
  226. #if defined(CH32V20x_D8) || defined(CH32V20x_D8W)
  227. void RCC_ETHDIVConfig(uint32_t RCC_ETHPRE_Div);
  228. #endif
  229. #ifdef __cplusplus
  230. }
  231. #endif
  232. #endif