gd32f10x_rcu.c 41 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193
  1. /*!
  2. \file gd32f10x_rcu.c
  3. \brief RCU driver
  4. \version 2014-12-26, V1.0.0, firmware for GD32F10x
  5. \version 2017-06-20, V2.0.0, firmware for GD32F10x
  6. \version 2018-07-31, V2.1.0, firmware for GD32F10x
  7. */
  8. /*
  9. Copyright (c) 2018, GigaDevice Semiconductor Inc.
  10. All rights reserved.
  11. Redistribution and use in source and binary forms, with or without modification,
  12. are permitted provided that the following conditions are met:
  13. 1. Redistributions of source code must retain the above copyright notice, this
  14. list of conditions and the following disclaimer.
  15. 2. Redistributions in binary form must reproduce the above copyright notice,
  16. this list of conditions and the following disclaimer in the documentation
  17. and/or other materials provided with the distribution.
  18. 3. Neither the name of the copyright holder nor the names of its contributors
  19. may be used to endorse or promote products derived from this software without
  20. specific prior written permission.
  21. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  22. AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  23. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  24. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  25. INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  26. NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  27. PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  28. WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  29. ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
  30. OF SUCH DAMAGE.
  31. */
  32. #include "gd32f10x_rcu.h"
  33. /* define clock source */
  34. #define SEL_IRC8M ((uint16_t)0U)
  35. #define SEL_HXTAL ((uint16_t)1U)
  36. #define SEL_PLL ((uint16_t)2U)
  37. /* define startup timeout count */
  38. #define OSC_STARTUP_TIMEOUT ((uint32_t)0xFFFFFU)
  39. #define LXTAL_STARTUP_TIMEOUT ((uint32_t)0x3FFFFFFU)
  40. /*!
  41. \brief deinitialize the RCU
  42. \param[in] none
  43. \param[out] none
  44. \retval none
  45. */
  46. void rcu_deinit(void)
  47. {
  48. /* enable IRC8M */
  49. RCU_CTL |= RCU_CTL_IRC8MEN;
  50. rcu_osci_stab_wait(RCU_IRC8M);
  51. /* reset CFG0 register */
  52. #if (defined(GD32F10X_MD) || defined(GD32F10X_HD) || defined(GD32F10X_XD))
  53. RCU_CFG0 &= ~(RCU_CFG0_SCS | RCU_CFG0_AHBPSC | RCU_CFG0_APB1PSC | RCU_CFG0_APB2PSC |
  54. RCU_CFG0_ADCPSC | RCU_CFG0_PLLSEL | RCU_CFG0_PREDV0 | RCU_CFG0_PLLMF |
  55. RCU_CFG0_USBDPSC | RCU_CFG0_CKOUT0SEL | RCU_CFG0_PLLMF_4 | RCU_CFG0_ADCPSC_2);
  56. #elif defined(GD32F10X_CL)
  57. RCU_CFG0 &= ~(RCU_CFG0_SCS | RCU_CFG0_AHBPSC | RCU_CFG0_APB1PSC | RCU_CFG0_APB2PSC |
  58. RCU_CFG0_ADCPSC | RCU_CFG0_PLLSEL | RCU_CFG0_PREDV0_LSB | RCU_CFG0_PLLMF |
  59. RCU_CFG0_USBFSPSC | RCU_CFG0_CKOUT0SEL | RCU_CFG0_ADCPSC_2 | RCU_CFG0_PLLMF_4);
  60. #endif /* GD32F10X_MD and GD32F10X_HD and GD32F10X_XD */
  61. /* reset CTL register */
  62. RCU_CTL &= ~(RCU_CTL_HXTALEN | RCU_CTL_CKMEN | RCU_CTL_PLLEN);
  63. RCU_CTL &= ~RCU_CTL_HXTALBPS;
  64. #ifdef GD32F10X_CL
  65. RCU_CTL &= ~(RCU_CTL_PLL1EN | RCU_CTL_PLL2EN);
  66. #endif /* GD32F10X_CL */
  67. /* reset INT and CFG1 register */
  68. #if (defined(GD32F10X_MD) || defined(GD32F10X_HD) || defined(GD32F10X_XD))
  69. RCU_INT = 0x009f0000U;
  70. #elif defined(GD32F10X_CL)
  71. RCU_INT = 0x00ff0000U;
  72. RCU_CFG1 &= ~(RCU_CFG1_PREDV0 | RCU_CFG1_PREDV1 | RCU_CFG1_PLL1MF | RCU_CFG1_PLL2MF |
  73. RCU_CFG1_PREDV0SEL | RCU_CFG1_I2S1SEL | RCU_CFG1_I2S2SEL);
  74. #endif /* GD32F10X_MD and GD32F10X_HD and GD32F10X_XD */
  75. }
  76. /*!
  77. \brief enable the peripherals clock
  78. \param[in] periph: RCU peripherals, refer to rcu_periph_enum
  79. only one parameter can be selected which is shown as below:
  80. \arg RCU_GPIOx (x=A,B,C,D,E,F,G): GPIO ports clock
  81. \arg RCU_AF : alternate function clock
  82. \arg RCU_CRC: CRC clock
  83. \arg RCU_DMAx (x=0,1): DMA clock
  84. \arg RCU_ENET: ENET clock(CL series available)
  85. \arg RCU_ENETTX: ENETTX clock(CL series available)
  86. \arg RCU_ENETRX: ENETRX clock(CL series available)
  87. \arg RCU_USBD: USBD clock(HD,XD series available)
  88. \arg RCU_USBFS: USBFS clock(CL series available)
  89. \arg RCU_EXMC: EXMC clock
  90. \arg RCU_TIMERx (x=0,1,2,3,4,5,6,7,8,9,10,11,12,13,TIMER8..13 are only available for XD series): TIMER clock
  91. \arg RCU_WWDGT: WWDGT clock
  92. \arg RCU_SPIx (x=0,1,2): SPI clock
  93. \arg RCU_USARTx (x=0,1,2): USART clock
  94. \arg RCU_UARTx (x=3,4): UART clock
  95. \arg RCU_I2Cx (x=0,1): I2C clock
  96. \arg RCU_CANx (x=0,1,CAN1 is only available for CL series): CAN clock
  97. \arg RCU_PMU: PMU clock
  98. \arg RCU_DAC: DAC clock
  99. \arg RCU_RTC: RTC clock
  100. \arg RCU_ADCx (x=0,1,2,ADC2 is not available for CL series): ADC clock
  101. \arg RCU_SDIO: SDIO clock(not available for CL series)
  102. \arg RCU_BKPI: BKP interface clock
  103. \param[out] none
  104. \retval none
  105. */
  106. void rcu_periph_clock_enable(rcu_periph_enum periph)
  107. {
  108. RCU_REG_VAL(periph) |= BIT(RCU_BIT_POS(periph));
  109. }
  110. /*!
  111. \brief disable the peripherals clock
  112. \param[in] periph: RCU peripherals, refer to rcu_periph_enum
  113. only one parameter can be selected which is shown as below:
  114. \arg RCU_GPIOx (x=A,B,C,D,E,F,G): GPIO ports clock
  115. \arg RCU_AF: alternate function clock
  116. \arg RCU_CRC: CRC clock
  117. \arg RCU_DMAx (x=0,1): DMA clock
  118. \arg RCU_ENET: ENET clock(CL series available)
  119. \arg RCU_ENETTX: ENETTX clock(CL series available)
  120. \arg RCU_ENETRX: ENETRX clock(CL series available)
  121. \arg RCU_USBD: USBD clock(HD,XD series available)
  122. \arg RCU_USBFS: USBFS clock(CL series available)
  123. \arg RCU_EXMC: EXMC clock
  124. \arg RCU_TIMERx (x=0,1,2,3,4,5,6,7,8,9,10,11,12,13,TIMER8..13 are only available for XD series): TIMER clock
  125. \arg RCU_WWDGT: WWDGT clock
  126. \arg RCU_SPIx (x=0,1,2): SPI clock
  127. \arg RCU_USARTx (x=0,1,2): USART clock
  128. \arg RCU_UARTx (x=3,4): UART clock
  129. \arg RCU_I2Cx (x=0,1): I2C clock
  130. \arg RCU_CANx (x=0,1,CAN1 is only available for CL series): CAN clock
  131. \arg RCU_PMU: PMU clock
  132. \arg RCU_DAC: DAC clock
  133. \arg RCU_RTC: RTC clock
  134. \arg RCU_ADCx (x=0,1,2,ADC2 is not available for CL series): ADC clock
  135. \arg RCU_SDIO: SDIO clock(not available for CL series)
  136. \arg RCU_BKPI: BKP interface clock
  137. \param[out] none
  138. \retval none
  139. */
  140. void rcu_periph_clock_disable(rcu_periph_enum periph)
  141. {
  142. RCU_REG_VAL(periph) &= ~BIT(RCU_BIT_POS(periph));
  143. }
  144. /*!
  145. \brief enable the peripherals clock when sleep mode
  146. \param[in] periph: RCU peripherals, refer to rcu_periph_sleep_enum
  147. only one parameter can be selected which is shown as below:
  148. \arg RCU_FMC_SLP: FMC clock
  149. \arg RCU_SRAM_SLP: SRAM clock
  150. \param[out] none
  151. \retval none
  152. */
  153. void rcu_periph_clock_sleep_enable(rcu_periph_sleep_enum periph)
  154. {
  155. RCU_REG_VAL(periph) |= BIT(RCU_BIT_POS(periph));
  156. }
  157. /*!
  158. \brief disable the peripherals clock when sleep mode
  159. \param[in] periph: RCU peripherals, refer to rcu_periph_sleep_enum
  160. only one parameter can be selected which is shown as below:
  161. \arg RCU_FMC_SLP: FMC clock
  162. \arg RCU_SRAM_SLP: SRAM clock
  163. \param[out] none
  164. \retval none
  165. */
  166. void rcu_periph_clock_sleep_disable(rcu_periph_sleep_enum periph)
  167. {
  168. RCU_REG_VAL(periph) &= ~BIT(RCU_BIT_POS(periph));
  169. }
  170. /*!
  171. \brief reset the peripherals
  172. \param[in] periph_reset: RCU peripherals reset, refer to rcu_periph_reset_enum
  173. only one parameter can be selected which is shown as below:
  174. \arg RCU_GPIOxRST (x=A,B,C,D,E,F,G): reset GPIO ports
  175. \arg RCU_AFRST : reset alternate function clock
  176. \arg RCU_ENETRST: reset ENET(CL series available)
  177. \arg RCU_USBDRST: reset USBD(HD,XD series available)
  178. \arg RCU_USBFSRST: reset USBFS(CL series available)
  179. \arg RCU_TIMERxRST (x=0,1,2,3,4,5,6,7,8,9,10,11,12,13,TIMER8..13 are only available for XD series): reset TIMER
  180. \arg RCU_WWDGTRST: reset WWDGT
  181. \arg RCU_SPIxRST (x=0,1,2): reset SPI
  182. \arg RCU_USARTxRST (x=0,1,2): reset USART
  183. \arg RCU_UARTxRST (x=3,4): reset UART
  184. \arg RCU_I2CxRST (x=0,1): reset I2C
  185. \arg RCU_CANxRST (x=0,1,CAN1 is only available for CL series): reset CAN
  186. \arg RCU_PMURST: reset PMU
  187. \arg RCU_DACRST: reset DAC
  188. \arg RCU_ADCxRST (x=0,1,2, ADC2 is not available for CL series): reset ADC
  189. \arg RCU_BKPIRST: reset BKPI
  190. \param[out] none
  191. \retval none
  192. */
  193. void rcu_periph_reset_enable(rcu_periph_reset_enum periph_reset)
  194. {
  195. RCU_REG_VAL(periph_reset) |= BIT(RCU_BIT_POS(periph_reset));
  196. }
  197. /*!
  198. \brief disable reset the peripheral
  199. \param[in] periph_reset: RCU peripherals reset, refer to rcu_periph_reset_enum
  200. only one parameter can be selected which is shown as below:
  201. \arg RCU_GPIOxRST (x=A,B,C,D,E,F,G): reset GPIO ports
  202. \arg RCU_AFRST : reset alternate function clock
  203. \arg RCU_ENETRST: reset ENET(CL series available)
  204. \arg RCU_USBDRST: reset USBD(HD,XD series available)
  205. \arg RCU_USBFSRST: reset USBFS(CL series available)
  206. \arg RCU_TIMERxRST (x=0,1,2,3,4,5,6,7,8,9,10,11,12,13,TIMER8..13 are only available for XD series): reset TIMER
  207. \arg RCU_WWDGTRST: reset WWDGT
  208. \arg RCU_SPIxRST (x=0,1,2): reset SPI
  209. \arg RCU_USARTxRST (x=0,1,2): reset USART
  210. \arg RCU_UARTxRST (x=3,4): reset UART
  211. \arg RCU_I2CxRST (x=0,1): reset I2C
  212. \arg RCU_CANxRST (x=0,1,CAN1 is only available for CL series): reset CAN
  213. \arg RCU_PMURST: reset PMU
  214. \arg RCU_DACRST: reset DAC
  215. \arg RCU_ADCxRST (x=0,1,2, ADC2 is not available for CL series): reset ADC
  216. \arg RCU_BKPIRST: reset BKPI
  217. \param[out] none
  218. \retval none
  219. */
  220. void rcu_periph_reset_disable(rcu_periph_reset_enum periph_reset)
  221. {
  222. RCU_REG_VAL(periph_reset) &= ~BIT(RCU_BIT_POS(periph_reset));
  223. }
  224. /*!
  225. \brief reset the BKP domain
  226. \param[in] none
  227. \param[out] none
  228. \retval none
  229. */
  230. void rcu_bkp_reset_enable(void)
  231. {
  232. RCU_BDCTL |= RCU_BDCTL_BKPRST;
  233. }
  234. /*!
  235. \brief disable the BKP domain reset
  236. \param[in] none
  237. \param[out] none
  238. \retval none
  239. */
  240. void rcu_bkp_reset_disable(void)
  241. {
  242. RCU_BDCTL &= ~RCU_BDCTL_BKPRST;
  243. }
  244. /*!
  245. \brief configure the system clock source
  246. \param[in] ck_sys: system clock source select
  247. only one parameter can be selected which is shown as below:
  248. \arg RCU_CKSYSSRC_IRC8M: select CK_IRC8M as the CK_SYS source
  249. \arg RCU_CKSYSSRC_HXTAL: select CK_HXTAL as the CK_SYS source
  250. \arg RCU_CKSYSSRC_PLL: select CK_PLL as the CK_SYS source
  251. \param[out] none
  252. \retval none
  253. */
  254. void rcu_system_clock_source_config(uint32_t ck_sys)
  255. {
  256. uint32_t reg;
  257. reg = RCU_CFG0;
  258. /* reset the SCS bits and set according to ck_sys */
  259. reg &= ~RCU_CFG0_SCS;
  260. RCU_CFG0 = (reg | ck_sys);
  261. }
  262. /*!
  263. \brief get the system clock source
  264. \param[in] none
  265. \param[out] none
  266. \retval which clock is selected as CK_SYS source
  267. \arg RCU_SCSS_IRC8M: CK_IRC8M is selected as the CK_SYS source
  268. \arg RCU_SCSS_HXTAL: CK_HXTAL is selected as the CK_SYS source
  269. \arg RCU_SCSS_PLL: CK_PLL is selected as the CK_SYS source
  270. */
  271. uint32_t rcu_system_clock_source_get(void)
  272. {
  273. return (RCU_CFG0 & RCU_CFG0_SCSS);
  274. }
  275. /*!
  276. \brief configure the AHB clock prescaler selection
  277. \param[in] ck_ahb: AHB clock prescaler selection
  278. only one parameter can be selected which is shown as below:
  279. \arg RCU_AHB_CKSYS_DIVx, x=1, 2, 4, 8, 16, 64, 128, 256, 512
  280. \param[out] none
  281. \retval none
  282. */
  283. void rcu_ahb_clock_config(uint32_t ck_ahb)
  284. {
  285. uint32_t reg;
  286. reg = RCU_CFG0;
  287. /* reset the AHBPSC bits and set according to ck_ahb */
  288. reg &= ~RCU_CFG0_AHBPSC;
  289. RCU_CFG0 = (reg | ck_ahb);
  290. }
  291. /*!
  292. \brief configure the APB1 clock prescaler selection
  293. \param[in] ck_apb1: APB1 clock prescaler selection
  294. only one parameter can be selected which is shown as below:
  295. \arg RCU_APB1_CKAHB_DIV1: select CK_AHB as CK_APB1
  296. \arg RCU_APB1_CKAHB_DIV2: select CK_AHB/2 as CK_APB1
  297. \arg RCU_APB1_CKAHB_DIV4: select CK_AHB/4 as CK_APB1
  298. \arg RCU_APB1_CKAHB_DIV8: select CK_AHB/8 as CK_APB1
  299. \arg RCU_APB1_CKAHB_DIV16: select CK_AHB/16 as CK_APB1
  300. \param[out] none
  301. \retval none
  302. */
  303. void rcu_apb1_clock_config(uint32_t ck_apb1)
  304. {
  305. uint32_t reg;
  306. reg = RCU_CFG0;
  307. /* reset the APB1PSC and set according to ck_apb1 */
  308. reg &= ~RCU_CFG0_APB1PSC;
  309. RCU_CFG0 = (reg | ck_apb1);
  310. }
  311. /*!
  312. \brief configure the APB2 clock prescaler selection
  313. \param[in] ck_apb2: APB2 clock prescaler selection
  314. only one parameter can be selected which is shown as below:
  315. \arg RCU_APB2_CKAHB_DIV1: select CK_AHB as CK_APB2
  316. \arg RCU_APB2_CKAHB_DIV2: select CK_AHB/2 as CK_APB2
  317. \arg RCU_APB2_CKAHB_DIV4: select CK_AHB/4 as CK_APB2
  318. \arg RCU_APB2_CKAHB_DIV8: select CK_AHB/8 as CK_APB2
  319. \arg RCU_APB2_CKAHB_DIV16: select CK_AHB/16 as CK_APB2
  320. \param[out] none
  321. \retval none
  322. */
  323. void rcu_apb2_clock_config(uint32_t ck_apb2)
  324. {
  325. uint32_t reg;
  326. reg = RCU_CFG0;
  327. /* reset the APB2PSC and set according to ck_apb2 */
  328. reg &= ~RCU_CFG0_APB2PSC;
  329. RCU_CFG0 = (reg | ck_apb2);
  330. }
  331. /*!
  332. \brief configure the CK_OUT0 clock source
  333. \param[in] ckout0_src: CK_OUT0 clock source selection
  334. only one parameter can be selected which is shown as below:
  335. \arg RCU_CKOUT0SRC_NONE: no clock selected
  336. \arg RCU_CKOUT0SRC_CKSYS: system clock selected
  337. \arg RCU_CKOUT0SRC_IRC8M: high speed 8M internal oscillator clock selected
  338. \arg RCU_CKOUT0SRC_HXTAL: HXTAL selected
  339. \arg RCU_CKOUT0SRC_CKPLL_DIV2: CK_PLL/2 selected
  340. \arg RCU_CKOUT0SRC_CKPLL1: CK_PLL1 selected
  341. \arg RCU_CKOUT0SRC_CKPLL2_DIV2: CK_PLL2/2 selected
  342. \arg RCU_CKOUT0SRC_EXT1: EXT1 selected
  343. \arg RCU_CKOUT0SRC_CKPLL2: PLL2 selected
  344. \param[out] none
  345. \retval none
  346. */
  347. void rcu_ckout0_config(uint32_t ckout0_src)
  348. {
  349. uint32_t reg;
  350. reg = RCU_CFG0;
  351. /* reset the CKOUT0SRC, set according to ckout0_src */
  352. reg &= ~RCU_CFG0_CKOUT0SEL;
  353. RCU_CFG0 = (reg | ckout0_src);
  354. }
  355. /*!
  356. \brief configure the main PLL clock
  357. \param[in] pll_src: PLL clock source selection
  358. only one parameter can be selected which is shown as below:
  359. \arg RCU_PLLSRC_IRC8M_DIV2: IRC8M/2 clock selected as source clock of PLL
  360. \arg RCU_PLLSRC_HXTAL: HXTAL selected as source clock of PLL
  361. \param[in] pll_mul: PLL clock multiplication factor
  362. only one parameter can be selected which is shown as below:
  363. \arg RCU_PLL_MULx (XD series x = 2..32, CL series x = 2..14, 6.5, 16..32)
  364. \param[out] none
  365. \retval none
  366. */
  367. void rcu_pll_config(uint32_t pll_src, uint32_t pll_mul)
  368. {
  369. uint32_t reg = 0U;
  370. reg = RCU_CFG0;
  371. /* PLL clock source and multiplication factor configuration */
  372. reg &= ~(RCU_CFG0_PLLSEL | RCU_CFG0_PLLMF | RCU_CFG0_PLLMF_4);
  373. reg |= (pll_src | pll_mul);
  374. RCU_CFG0 = reg;
  375. }
  376. #if (defined(GD32F10X_MD) || defined(GD32F10X_HD) || defined(GD32F10X_XD))
  377. /*!
  378. \brief configure the PREDV0 division factor
  379. \param[in] predv0_div: PREDV0 division factor
  380. only one parameter can be selected which is shown as below:
  381. \arg RCU_PREDV0_DIVx, x = 1,2
  382. \param[out] none
  383. \retval none
  384. */
  385. void rcu_predv0_config(uint32_t predv0_div)
  386. {
  387. uint32_t reg = 0U;
  388. reg = RCU_CFG0;
  389. /* reset PREDV0 bit */
  390. reg &= ~RCU_CFG0_PREDV0;
  391. if(RCU_PREDV0_DIV2 == predv0_div){
  392. /* set the PREDV0 bit */
  393. reg |= RCU_CFG0_PREDV0;
  394. }
  395. RCU_CFG0 = reg;
  396. }
  397. #elif defined(GD32F10X_CL)
  398. /*!
  399. \brief configure the PREDV0 division factor and clock source
  400. \param[in] predv0_source: PREDV0 input clock source selection
  401. only one parameter can be selected which is shown as below:
  402. \arg RCU_PREDV0SRC_HXTAL: HXTAL selected as PREDV0 input source clock
  403. \arg RCU_PREDV0SRC_CKPLL1: CK_PLL1 selected as PREDV0 input source clock
  404. \param[in] predv0_div: PREDV0 division factor
  405. only one parameter can be selected which is shown as below:
  406. \arg RCU_PREDV0_DIVx, x = 1..16
  407. \param[out] none
  408. \retval none
  409. */
  410. void rcu_predv0_config(uint32_t predv0_source, uint32_t predv0_div)
  411. {
  412. uint32_t reg = 0U;
  413. reg = RCU_CFG1;
  414. /* reset PREDV0SEL and PREDV0 bits */
  415. reg &= ~(RCU_CFG1_PREDV0SEL | RCU_CFG1_PREDV0);
  416. /* set the PREDV0SEL and PREDV0 division factor */
  417. reg |= (predv0_source | predv0_div);
  418. RCU_CFG1 = reg;
  419. }
  420. /*!
  421. \brief configure the PREDV1 division factor
  422. \param[in] predv1_div: PREDV1 division factor
  423. only one parameter can be selected which is shown as below:
  424. \arg RCU_PREDV1_DIVx, x = 1..16
  425. \param[out] none
  426. \retval none
  427. */
  428. void rcu_predv1_config(uint32_t predv1_div)
  429. {
  430. uint32_t reg = 0U;
  431. reg = RCU_CFG1;
  432. /* reset the PREDV1 bits */
  433. reg &= ~RCU_CFG1_PREDV1;
  434. /* set the PREDV1 division factor */
  435. reg |= predv1_div;
  436. RCU_CFG1 = reg;
  437. }
  438. /*!
  439. \brief configure the PLL1 clock
  440. \param[in] pll_mul: PLL clock multiplication factor
  441. only one parameter can be selected which is shown as below:
  442. \arg RCU_PLL1_MULx (x = 8..16, 20)
  443. \param[out] none
  444. \retval none
  445. */
  446. void rcu_pll1_config(uint32_t pll_mul)
  447. {
  448. RCU_CFG1 &= ~RCU_CFG1_PLL1MF;
  449. RCU_CFG1 |= pll_mul;
  450. }
  451. /*!
  452. \brief configure the PLL2 clock
  453. \param[in] pll_mul: PLL clock multiplication factor
  454. only one parameter can be selected which is shown as below:
  455. \arg RCU_PLL2_MULx (x = 8..16, 20)
  456. \param[out] none
  457. \retval none
  458. */
  459. void rcu_pll2_config(uint32_t pll_mul)
  460. {
  461. RCU_CFG1 &= ~RCU_CFG1_PLL2MF;
  462. RCU_CFG1 |= pll_mul;
  463. }
  464. #endif /* GD32F10X_MD and GD32F10X_HD and GD32F10X_XD */
  465. /*!
  466. \brief configure the ADC prescaler factor
  467. \param[in] adc_psc: ADC prescaler factor
  468. only one parameter can be selected which is shown as below:
  469. \arg RCU_CKADC_CKAPB2_DIV2: ADC prescaler select CK_APB2/2
  470. \arg RCU_CKADC_CKAPB2_DIV4: ADC prescaler select CK_APB2/4
  471. \arg RCU_CKADC_CKAPB2_DIV6: ADC prescaler select CK_APB2/6
  472. \arg RCU_CKADC_CKAPB2_DIV8: ADC prescaler select CK_APB2/8
  473. \arg RCU_CKADC_CKAPB2_DIV12: ADC prescaler select CK_APB2/12
  474. \arg RCU_CKADC_CKAPB2_DIV16: ADC prescaler select CK_APB2/16
  475. \param[out] none
  476. \retval none
  477. */
  478. void rcu_adc_clock_config(uint32_t adc_psc)
  479. {
  480. uint32_t reg0;
  481. /* reset the ADCPSC bits */
  482. reg0 = RCU_CFG0;
  483. reg0 &= ~(RCU_CFG0_ADCPSC_2 | RCU_CFG0_ADCPSC);
  484. /* set the ADC prescaler factor */
  485. switch(adc_psc){
  486. case RCU_CKADC_CKAPB2_DIV2:
  487. case RCU_CKADC_CKAPB2_DIV4:
  488. case RCU_CKADC_CKAPB2_DIV6:
  489. case RCU_CKADC_CKAPB2_DIV8:
  490. reg0 |= (adc_psc << 14);
  491. break;
  492. case RCU_CKADC_CKAPB2_DIV12:
  493. case RCU_CKADC_CKAPB2_DIV16:
  494. adc_psc &= ~BIT(2);
  495. reg0 |= (adc_psc << 14 | RCU_CFG0_ADCPSC_2);
  496. break;
  497. default:
  498. break;
  499. }
  500. /* set the register */
  501. RCU_CFG0 = reg0;
  502. }
  503. /*!
  504. \brief configure the USBD/USBFS prescaler factor
  505. \param[in] usb_psc: USB prescaler factor
  506. only one parameter can be selected which is shown as below:
  507. \arg RCU_CKUSB_CKPLL_DIV1_5: USBD/USBFS prescaler select CK_PLL/1.5
  508. \arg RCU_CKUSB_CKPLL_DIV1: USBD/USBFS prescaler select CK_PLL/1
  509. \arg RCU_CKUSB_CKPLL_DIV2_5: USBD/USBFS prescaler select CK_PLL/2.5
  510. \arg RCU_CKUSB_CKPLL_DIV2: USBD/USBFS prescaler select CK_PLL/2
  511. \param[out] none
  512. \retval none
  513. */
  514. void rcu_usb_clock_config(uint32_t usb_psc)
  515. {
  516. uint32_t reg;
  517. reg = RCU_CFG0;
  518. /* configure the USBD/USBFS prescaler factor */
  519. #if (defined(GD32F10X_MD) || defined(GD32F10X_HD) || defined(GD32F10X_XD))
  520. reg &= ~RCU_CFG0_USBDPSC;
  521. #elif defined(GD32F10X_CL)
  522. reg &= ~RCU_CFG0_USBFSPSC;
  523. #endif /* GD32F10X_MD and GD32F10X_HD and GD32F10X_XD */
  524. RCU_CFG0 = (reg | usb_psc);
  525. }
  526. /*!
  527. \brief configure the RTC clock source selection
  528. \param[in] rtc_clock_source: RTC clock source selection
  529. only one parameter can be selected which is shown as below:
  530. \arg RCU_RTCSRC_NONE: no clock selected
  531. \arg RCU_RTCSRC_LXTAL: CK_LXTAL selected as RTC source clock
  532. \arg RCU_RTCSRC_IRC40K: CK_IRC40K selected as RTC source clock
  533. \arg RCU_RTCSRC_HXTAL_DIV_128: CK_HXTAL/128 selected as RTC source clock
  534. \param[out] none
  535. \retval none
  536. */
  537. void rcu_rtc_clock_config(uint32_t rtc_clock_source)
  538. {
  539. uint32_t reg;
  540. reg = RCU_BDCTL;
  541. /* reset the RTCSRC bits and set according to rtc_clock_source */
  542. reg &= ~RCU_BDCTL_RTCSRC;
  543. RCU_BDCTL = (reg | rtc_clock_source);
  544. }
  545. #ifdef GD32F10X_CL
  546. /*!
  547. \brief configure the I2S1 clock source selection
  548. \param[in] i2s_clock_source: I2S1 clock source selection
  549. only one parameter can be selected which is shown as below:
  550. \arg RCU_I2S1SRC_CKSYS: System clock selected as I2S1 source clock
  551. \arg RCU_I2S1SRC_CKPLL2_MUL2: CK_PLL2x2 selected as I2S1 source clock
  552. \param[out] none
  553. \retval none
  554. */
  555. void rcu_i2s1_clock_config(uint32_t i2s_clock_source)
  556. {
  557. uint32_t reg;
  558. reg = RCU_CFG1;
  559. /* reset the I2S1SEL bit and set according to i2s_clock_source */
  560. reg &= ~RCU_CFG1_I2S1SEL;
  561. RCU_CFG1 = (reg | i2s_clock_source);
  562. }
  563. /*!
  564. \brief configure the I2S2 clock source selection
  565. \param[in] i2s_clock_source: I2S2 clock source selection
  566. only one parameter can be selected which is shown as below:
  567. \arg RCU_I2S2SRC_CKSYS: system clock selected as I2S2 source clock
  568. \arg RCU_I2S2SRC_CKPLL2_MUL2: CK_PLL2x2 selected as I2S2 source clock
  569. \param[out] none
  570. \retval none
  571. */
  572. void rcu_i2s2_clock_config(uint32_t i2s_clock_source)
  573. {
  574. uint32_t reg;
  575. reg = RCU_CFG1;
  576. /* reset the I2S2SEL bit and set according to i2s_clock_source */
  577. reg &= ~RCU_CFG1_I2S2SEL;
  578. RCU_CFG1 = (reg | i2s_clock_source);
  579. }
  580. #endif /* GD32F10X_CL */
  581. /*!
  582. \brief get the clock stabilization and periphral reset flags
  583. \param[in] flag: the clock stabilization and periphral reset flags, refer to rcu_flag_enum
  584. only one parameter can be selected which is shown as below:
  585. \arg RCU_FLAG_IRC8MSTB: IRC8M stabilization flag
  586. \arg RCU_FLAG_HXTALSTB: HXTAL stabilization flag
  587. \arg RCU_FLAG_PLLSTB: PLL stabilization flag
  588. \arg RCU_FLAG_PLL1STB: PLL1 stabilization flag(CL series only)
  589. \arg RCU_FLAG_PLL2STB: PLL2 stabilization flag(CL series only)
  590. \arg RCU_FLAG_LXTALSTB: LXTAL stabilization flag
  591. \arg RCU_FLAG_IRC40KSTB: IRC40K stabilization flag
  592. \arg RCU_FLAG_EPRST: external PIN reset flag
  593. \arg RCU_FLAG_PORRST: power reset flag
  594. \arg RCU_FLAG_SWRST: software reset flag
  595. \arg RCU_FLAG_FWDGTRST: free watchdog timer reset flag
  596. \arg RCU_FLAG_WWDGTRST: window watchdog timer reset flag
  597. \arg RCU_FLAG_LPRST: low-power reset flag
  598. \param[out] none
  599. \retval FlagStatus: SET or RESET
  600. */
  601. FlagStatus rcu_flag_get(rcu_flag_enum flag)
  602. {
  603. /* get the rcu flag */
  604. if(RESET != (RCU_REG_VAL(flag) & BIT(RCU_BIT_POS(flag)))){
  605. return SET;
  606. }else{
  607. return RESET;
  608. }
  609. }
  610. /*!
  611. \brief clear all the reset flag
  612. \param[in] none
  613. \param[out] none
  614. \retval none
  615. */
  616. void rcu_all_reset_flag_clear(void)
  617. {
  618. RCU_RSTSCK |= RCU_RSTSCK_RSTFC;
  619. }
  620. /*!
  621. \brief get the clock stabilization interrupt and ckm flags
  622. \param[in] int_flag: interrupt and ckm flags, refer to rcu_int_flag_enum
  623. only one parameter can be selected which is shown as below:
  624. \arg RCU_INT_FLAG_IRC40KSTB: IRC40K stabilization interrupt flag
  625. \arg RCU_INT_FLAG_LXTALSTB: LXTAL stabilization interrupt flag
  626. \arg RCU_INT_FLAG_IRC8MSTB: IRC8M stabilization interrupt flag
  627. \arg RCU_INT_FLAG_HXTALSTB: HXTAL stabilization interrupt flag
  628. \arg RCU_INT_FLAG_PLLSTB: PLL stabilization interrupt flag
  629. \arg RCU_INT_FLAG_PLL1STB: PLL1 stabilization interrupt flag(CL series only)
  630. \arg RCU_INT_FLAG_PLL2STB: PLL2 stabilization interrupt flag(CL series only)
  631. \arg RCU_INT_FLAG_CKM: HXTAL clock stuck interrupt flag
  632. \param[out] none
  633. \retval FlagStatus: SET or RESET
  634. */
  635. FlagStatus rcu_interrupt_flag_get(rcu_int_flag_enum int_flag)
  636. {
  637. /* get the rcu interrupt flag */
  638. if(RESET != (RCU_REG_VAL(int_flag) & BIT(RCU_BIT_POS(int_flag)))){
  639. return SET;
  640. }else{
  641. return RESET;
  642. }
  643. }
  644. /*!
  645. \brief clear the interrupt flags
  646. \param[in] int_flag_clear: clock stabilization and stuck interrupt flags clear, refer to rcu_int_flag_clear_enum
  647. only one parameter can be selected which is shown as below:
  648. \arg RCU_INT_FLAG_IRC40KSTB_CLR: IRC40K stabilization interrupt flag clear
  649. \arg RCU_INT_FLAG_LXTALSTB_CLR: LXTAL stabilization interrupt flag clear
  650. \arg RCU_INT_FLAG_IRC8MSTB_CLR: IRC8M stabilization interrupt flag clear
  651. \arg RCU_INT_FLAG_HXTALSTB_CLR: HXTAL stabilization interrupt flag clear
  652. \arg RCU_INT_FLAG_PLLSTB_CLR: PLL stabilization interrupt flag clear
  653. \arg RCU_INT_FLAG_PLL1STB_CLR: PLL1 stabilization interrupt flag clear(CL series only)
  654. \arg RCU_INT_FLAG_PLL2STB_CLR: PLL2 stabilization interrupt flag clear(CL series only)
  655. \arg RCU_INT_FLAG_CKM_CLR: clock stuck interrupt flag clear
  656. \param[out] none
  657. \retval none
  658. */
  659. void rcu_interrupt_flag_clear(rcu_int_flag_clear_enum int_flag_clear)
  660. {
  661. RCU_REG_VAL(int_flag_clear) |= BIT(RCU_BIT_POS(int_flag_clear));
  662. }
  663. /*!
  664. \brief enable the stabilization interrupt
  665. \param[in] stab_int: clock stabilization interrupt, refer to rcu_int_enum
  666. Only one parameter can be selected which is shown as below:
  667. \arg RCU_INT_IRC40KSTB: IRC40K stabilization interrupt enable
  668. \arg RCU_INT_LXTALSTB: LXTAL stabilization interrupt enable
  669. \arg RCU_INT_IRC8MSTB: IRC8M stabilization interrupt enable
  670. \arg RCU_INT_HXTALSTB: HXTAL stabilization interrupt enable
  671. \arg RCU_INT_PLLSTB: PLL stabilization interrupt enable
  672. \arg RCU_INT_PLL1STB: PLL1 stabilization interrupt enable(CL series only)
  673. \arg RCU_INT_PLL2STB: PLL2 stabilization interrupt enable(CL series only)
  674. \param[out] none
  675. \retval none
  676. */
  677. void rcu_interrupt_enable(rcu_int_enum stab_int)
  678. {
  679. RCU_REG_VAL(stab_int) |= BIT(RCU_BIT_POS(stab_int));
  680. }
  681. /*!
  682. \brief disable the stabilization interrupt
  683. \param[in] stab_int: clock stabilization interrupt, refer to rcu_int_enum
  684. only one parameter can be selected which is shown as below:
  685. \arg RCU_INT_IRC40KSTB: IRC40K stabilization interrupt enable
  686. \arg RCU_INT_LXTALSTB: LXTAL stabilization interrupt enable
  687. \arg RCU_INT_IRC8MSTB: IRC8M stabilization interrupt enable
  688. \arg RCU_INT_HXTALSTB: HXTAL stabilization interrupt enable
  689. \arg RCU_INT_PLLSTB: PLL stabilization interrupt enable
  690. \arg RCU_INT_PLL1STB: PLL1 stabilization interrupt enable(CL series only)
  691. \arg RCU_INT_PLL2STB: PLL2 stabilization interrupt enable(CL series only)
  692. \param[out] none
  693. \retval none
  694. */
  695. void rcu_interrupt_disable(rcu_int_enum stab_int)
  696. {
  697. RCU_REG_VAL(stab_int) &= ~BIT(RCU_BIT_POS(stab_int));
  698. }
  699. /*!
  700. \brief wait for oscillator stabilization flags is SET or oscillator startup is timeout
  701. \param[in] osci: oscillator types, refer to rcu_osci_type_enum
  702. only one parameter can be selected which is shown as below:
  703. \arg RCU_HXTAL: high speed crystal oscillator(HXTAL)
  704. \arg RCU_LXTAL: low speed crystal oscillator(LXTAL)
  705. \arg RCU_IRC8M: internal 8M RC oscillators(IRC8M)
  706. \arg RCU_IRC40K: internal 40K RC oscillator(IRC40K)
  707. \arg RCU_PLL_CK: phase locked loop(PLL)
  708. \arg RCU_PLL1_CK: phase locked loop 1(CL series only)
  709. \arg RCU_PLL2_CK: phase locked loop 2(CL series only)
  710. \param[out] none
  711. \retval ErrStatus: SUCCESS or ERROR
  712. */
  713. ErrStatus rcu_osci_stab_wait(rcu_osci_type_enum osci)
  714. {
  715. uint32_t stb_cnt = 0U;
  716. ErrStatus reval = ERROR;
  717. FlagStatus osci_stat = RESET;
  718. switch(osci){
  719. /* wait HXTAL stable */
  720. case RCU_HXTAL:
  721. while((RESET == osci_stat) && (HXTAL_STARTUP_TIMEOUT != stb_cnt)){
  722. osci_stat = rcu_flag_get(RCU_FLAG_HXTALSTB);
  723. stb_cnt++;
  724. }
  725. /* check whether flag is set or not */
  726. if(RESET != rcu_flag_get(RCU_FLAG_HXTALSTB)){
  727. reval = SUCCESS;
  728. }
  729. break;
  730. /* wait LXTAL stable */
  731. case RCU_LXTAL:
  732. while((RESET == osci_stat) && (LXTAL_STARTUP_TIMEOUT != stb_cnt)){
  733. osci_stat = rcu_flag_get(RCU_FLAG_LXTALSTB);
  734. stb_cnt++;
  735. }
  736. /* check whether flag is set or not */
  737. if(RESET != rcu_flag_get(RCU_FLAG_LXTALSTB)){
  738. reval = SUCCESS;
  739. }
  740. break;
  741. /* wait IRC8M stable */
  742. case RCU_IRC8M:
  743. while((RESET == osci_stat) && (IRC8M_STARTUP_TIMEOUT != stb_cnt)){
  744. osci_stat = rcu_flag_get(RCU_FLAG_IRC8MSTB);
  745. stb_cnt++;
  746. }
  747. /* check whether flag is set or not */
  748. if(RESET != rcu_flag_get(RCU_FLAG_IRC8MSTB)){
  749. reval = SUCCESS;
  750. }
  751. break;
  752. /* wait IRC40K stable */
  753. case RCU_IRC40K:
  754. while((RESET == osci_stat) && (OSC_STARTUP_TIMEOUT != stb_cnt)){
  755. osci_stat = rcu_flag_get(RCU_FLAG_IRC40KSTB);
  756. stb_cnt++;
  757. }
  758. /* check whether flag is set or not */
  759. if(RESET != rcu_flag_get(RCU_FLAG_IRC40KSTB)){
  760. reval = SUCCESS;
  761. }
  762. break;
  763. /* wait PLL stable */
  764. case RCU_PLL_CK:
  765. while((RESET == osci_stat) && (OSC_STARTUP_TIMEOUT != stb_cnt)){
  766. osci_stat = rcu_flag_get(RCU_FLAG_PLLSTB);
  767. stb_cnt++;
  768. }
  769. /* check whether flag is set or not */
  770. if(RESET != rcu_flag_get(RCU_FLAG_PLLSTB)){
  771. reval = SUCCESS;
  772. }
  773. break;
  774. #ifdef GD32F10X_CL
  775. /* wait PLL1 stable */
  776. case RCU_PLL1_CK:
  777. while((RESET == osci_stat) && (OSC_STARTUP_TIMEOUT != stb_cnt)){
  778. osci_stat = rcu_flag_get(RCU_FLAG_PLL1STB);
  779. stb_cnt++;
  780. }
  781. /* check whether flag is set or not */
  782. if(RESET != rcu_flag_get(RCU_FLAG_PLL1STB)){
  783. reval = SUCCESS;
  784. }
  785. break;
  786. /* wait PLL2 stable */
  787. case RCU_PLL2_CK:
  788. while((RESET == osci_stat) && (OSC_STARTUP_TIMEOUT != stb_cnt)){
  789. osci_stat = rcu_flag_get(RCU_FLAG_PLL2STB);
  790. stb_cnt++;
  791. }
  792. /* check whether flag is set or not */
  793. if(RESET != rcu_flag_get(RCU_FLAG_PLL2STB)){
  794. reval = SUCCESS;
  795. }
  796. break;
  797. #endif /* GD32F10X_CL */
  798. default:
  799. break;
  800. }
  801. /* return value */
  802. return reval;
  803. }
  804. /*!
  805. \brief turn on the oscillator
  806. \param[in] osci: oscillator types, refer to rcu_osci_type_enum
  807. only one parameter can be selected which is shown as below:
  808. \arg RCU_HXTAL: high speed crystal oscillator(HXTAL)
  809. \arg RCU_LXTAL: low speed crystal oscillator(LXTAL)
  810. \arg RCU_IRC8M: internal 8M RC oscillators(IRC8M)
  811. \arg RCU_IRC40K: internal 40K RC oscillator(IRC40K)
  812. \arg RCU_PLL_CK: phase locked loop(PLL)
  813. \arg RCU_PLL1_CK: phase locked loop 1(CL series only)
  814. \arg RCU_PLL2_CK: phase locked loop 2(CL series only)
  815. \param[out] none
  816. \retval none
  817. */
  818. void rcu_osci_on(rcu_osci_type_enum osci)
  819. {
  820. RCU_REG_VAL(osci) |= BIT(RCU_BIT_POS(osci));
  821. }
  822. /*!
  823. \brief turn off the oscillator
  824. \param[in] osci: oscillator types, refer to rcu_osci_type_enum
  825. only one parameter can be selected which is shown as below:
  826. \arg RCU_HXTAL: high speed crystal oscillator(HXTAL)
  827. \arg RCU_LXTAL: low speed crystal oscillator(LXTAL)
  828. \arg RCU_IRC8M: internal 8M RC oscillators(IRC8M)
  829. \arg RCU_IRC40K: internal 40K RC oscillator(IRC40K)
  830. \arg RCU_PLL_CK: phase locked loop(PLL)
  831. \arg RCU_PLL1_CK: phase locked loop 1(CL series only)
  832. \arg RCU_PLL2_CK: phase locked loop 2(CL series only)
  833. \param[out] none
  834. \retval none
  835. */
  836. void rcu_osci_off(rcu_osci_type_enum osci)
  837. {
  838. RCU_REG_VAL(osci) &= ~BIT(RCU_BIT_POS(osci));
  839. }
  840. /*!
  841. \brief enable the oscillator bypass mode, HXTALEN or LXTALEN must be reset before it
  842. \param[in] osci: oscillator types, refer to rcu_osci_type_enum
  843. only one parameter can be selected which is shown as below:
  844. \arg RCU_HXTAL: high speed crystal oscillator(HXTAL)
  845. \arg RCU_LXTAL: low speed crystal oscillator(LXTAL)
  846. \param[out] none
  847. \retval none
  848. */
  849. void rcu_osci_bypass_mode_enable(rcu_osci_type_enum osci)
  850. {
  851. uint32_t reg;
  852. switch(osci){
  853. /* enable HXTAL to bypass mode */
  854. case RCU_HXTAL:
  855. reg = RCU_CTL;
  856. RCU_CTL &= ~RCU_CTL_HXTALEN;
  857. RCU_CTL = (reg | RCU_CTL_HXTALBPS);
  858. break;
  859. /* enable LXTAL to bypass mode */
  860. case RCU_LXTAL:
  861. reg = RCU_BDCTL;
  862. RCU_BDCTL &= ~RCU_BDCTL_LXTALEN;
  863. RCU_BDCTL = (reg | RCU_BDCTL_LXTALBPS);
  864. break;
  865. case RCU_IRC8M:
  866. case RCU_IRC40K:
  867. case RCU_PLL_CK:
  868. #ifdef GD32F10X_CL
  869. case RCU_PLL1_CK:
  870. case RCU_PLL2_CK:
  871. #endif /* GD32F10X_CL */
  872. break;
  873. default:
  874. break;
  875. }
  876. }
  877. /*!
  878. \brief disable the oscillator bypass mode, HXTALEN or LXTALEN must be reset before it
  879. \param[in] osci: oscillator types, refer to rcu_osci_type_enum
  880. only one parameter can be selected which is shown as below:
  881. \arg RCU_HXTAL: high speed crystal oscillator(HXTAL)
  882. \arg RCU_LXTAL: low speed crystal oscillator(LXTAL)
  883. \param[out] none
  884. \retval none
  885. */
  886. void rcu_osci_bypass_mode_disable(rcu_osci_type_enum osci)
  887. {
  888. uint32_t reg;
  889. switch(osci){
  890. /* disable HXTAL to bypass mode */
  891. case RCU_HXTAL:
  892. reg = RCU_CTL;
  893. RCU_CTL &= ~RCU_CTL_HXTALEN;
  894. RCU_CTL = (reg & ~RCU_CTL_HXTALBPS);
  895. break;
  896. /* disable LXTAL to bypass mode */
  897. case RCU_LXTAL:
  898. reg = RCU_BDCTL;
  899. RCU_BDCTL &= ~RCU_BDCTL_LXTALEN;
  900. RCU_BDCTL = (reg & ~RCU_BDCTL_LXTALBPS);
  901. break;
  902. case RCU_IRC8M:
  903. case RCU_IRC40K:
  904. case RCU_PLL_CK:
  905. #ifdef GD32F10X_CL
  906. case RCU_PLL1_CK:
  907. case RCU_PLL2_CK:
  908. #endif /* GD32F10X_CL */
  909. break;
  910. default:
  911. break;
  912. }
  913. }
  914. /*!
  915. \brief enable the HXTAL clock monitor
  916. \param[in] none
  917. \param[out] none
  918. \retval none
  919. */
  920. void rcu_hxtal_clock_monitor_enable(void)
  921. {
  922. RCU_CTL |= RCU_CTL_CKMEN;
  923. }
  924. /*!
  925. \brief disable the HXTAL clock monitor
  926. \param[in] none
  927. \param[out] none
  928. \retval none
  929. */
  930. void rcu_hxtal_clock_monitor_disable(void)
  931. {
  932. RCU_CTL &= ~RCU_CTL_CKMEN;
  933. }
  934. /*!
  935. \brief set the IRC8M adjust value
  936. \param[in] irc8m_adjval: IRC8M adjust value, must be between 0 and 0x1F
  937. \param[out] none
  938. \retval none
  939. */
  940. void rcu_irc8m_adjust_value_set(uint32_t irc8m_adjval)
  941. {
  942. uint32_t reg;
  943. reg = RCU_CTL;
  944. /* reset the IRC8MADJ bits and set according to irc8m_adjval */
  945. reg &= ~RCU_CTL_IRC8MADJ;
  946. RCU_CTL = (reg | ((irc8m_adjval & 0x1FU) << 3));
  947. }
  948. /*!
  949. \brief deep-sleep mode voltage select
  950. \param[in] dsvol: deep sleep mode voltage
  951. only one parameter can be selected which is shown as below:
  952. \arg RCU_DEEPSLEEP_V_1_2: the core voltage is 1.2V
  953. \arg RCU_DEEPSLEEP_V_1_1: the core voltage is 1.1V
  954. \arg RCU_DEEPSLEEP_V_1_0: the core voltage is 1.0V
  955. \arg RCU_DEEPSLEEP_V_0_9: the core voltage is 0.9V
  956. \param[out] none
  957. \retval none
  958. */
  959. void rcu_deepsleep_voltage_set(uint32_t dsvol)
  960. {
  961. dsvol &= RCU_DSV_DSLPVS;
  962. RCU_DSV = dsvol;
  963. }
  964. /*!
  965. \brief get the system clock, bus and peripheral clock frequency
  966. \param[in] clock: the clock frequency which to get
  967. only one parameter can be selected which is shown as below:
  968. \arg CK_SYS: system clock frequency
  969. \arg CK_AHB: AHB clock frequency
  970. \arg CK_APB1: APB1 clock frequency
  971. \arg CK_APB2: APB2 clock frequency
  972. \param[out] none
  973. \retval clock frequency of system, AHB, APB1, APB2
  974. */
  975. uint32_t rcu_clock_freq_get(rcu_clock_freq_enum clock)
  976. {
  977. uint32_t sws, ck_freq = 0U;
  978. uint32_t cksys_freq, ahb_freq, apb1_freq, apb2_freq;
  979. uint32_t pllsel, predv0sel, pllmf,ck_src, idx, clk_exp;
  980. #ifdef GD32F10X_CL
  981. uint32_t predv0, predv1, pll1mf;
  982. #endif /* GD32F10X_CL */
  983. /* exponent of AHB, APB1 and APB2 clock divider */
  984. uint8_t ahb_exp[16] = {0, 0, 0, 0, 0, 0, 0, 0, 1, 2, 3, 4, 6, 7, 8, 9};
  985. uint8_t apb1_exp[8] = {0, 0, 0, 0, 1, 2, 3, 4};
  986. uint8_t apb2_exp[8] = {0, 0, 0, 0, 1, 2, 3, 4};
  987. sws = GET_BITS(RCU_CFG0, 2, 3);
  988. switch(sws){
  989. /* IRC8M is selected as CK_SYS */
  990. case SEL_IRC8M:
  991. cksys_freq = IRC8M_VALUE;
  992. break;
  993. /* HXTAL is selected as CK_SYS */
  994. case SEL_HXTAL:
  995. cksys_freq = HXTAL_VALUE;
  996. break;
  997. /* PLL is selected as CK_SYS */
  998. case SEL_PLL:
  999. /* PLL clock source selection, HXTAL or IRC8M/2 */
  1000. pllsel = (RCU_CFG0 & RCU_CFG0_PLLSEL);
  1001. if(RCU_PLLSRC_HXTAL == pllsel) {
  1002. /* PLL clock source is HXTAL */
  1003. ck_src = HXTAL_VALUE;
  1004. #if (defined(GD32F10X_MD) || defined(GD32F10X_HD) || defined(GD32F10X_XD))
  1005. predv0sel = (RCU_CFG0 & RCU_CFG0_PREDV0);
  1006. /* PREDV0 input source clock divided by 2 */
  1007. if(RCU_CFG0_PREDV0 == predv0sel){
  1008. ck_src = HXTAL_VALUE/2U;
  1009. }
  1010. #elif defined(GD32F10X_CL)
  1011. predv0sel = (RCU_CFG1 & RCU_CFG1_PREDV0SEL);
  1012. /* source clock use PLL1 */
  1013. if(RCU_PREDV0SRC_CKPLL1 == predv0sel){
  1014. predv1 = (uint32_t)((RCU_CFG1 & RCU_CFG1_PREDV1) >> 4) + 1U;
  1015. pll1mf = (uint32_t)((RCU_CFG1 & RCU_CFG1_PLL1MF) >> 8) + 2U;
  1016. if(17U == pll1mf){
  1017. pll1mf = 20U;
  1018. }
  1019. ck_src = (ck_src / predv1) * pll1mf;
  1020. }
  1021. predv0 = (RCU_CFG1 & RCU_CFG1_PREDV0) + 1U;
  1022. ck_src /= predv0;
  1023. #endif /* GD32F10X_HD and GD32F10X_XD */
  1024. }else{
  1025. /* PLL clock source is IRC8M/2 */
  1026. ck_src = IRC8M_VALUE/2U;
  1027. }
  1028. /* PLL multiplication factor */
  1029. pllmf = GET_BITS(RCU_CFG0, 18, 21);
  1030. if((RCU_CFG0 & RCU_CFG0_PLLMF_4)){
  1031. pllmf |= 0x10U;
  1032. }
  1033. if(pllmf < 15U){
  1034. pllmf += 2U;
  1035. }else{
  1036. pllmf += 1U;
  1037. }
  1038. cksys_freq = ck_src * pllmf;
  1039. #ifdef GD32F10X_CL
  1040. if(15U == pllmf){
  1041. /* PLL source clock multiply by 6.5 */
  1042. cksys_freq = ck_src * 6U + ck_src / 2U;
  1043. }
  1044. #endif /* GD32F10X_CL */
  1045. break;
  1046. /* IRC8M is selected as CK_SYS */
  1047. default:
  1048. cksys_freq = IRC8M_VALUE;
  1049. break;
  1050. }
  1051. /* calculate AHB clock frequency */
  1052. idx = GET_BITS(RCU_CFG0, 4, 7);
  1053. clk_exp = ahb_exp[idx];
  1054. ahb_freq = cksys_freq >> clk_exp;
  1055. /* calculate APB1 clock frequency */
  1056. idx = GET_BITS(RCU_CFG0, 8, 10);
  1057. clk_exp = apb1_exp[idx];
  1058. apb1_freq = ahb_freq >> clk_exp;
  1059. /* calculate APB2 clock frequency */
  1060. idx = GET_BITS(RCU_CFG0, 11, 13);
  1061. clk_exp = apb2_exp[idx];
  1062. apb2_freq = ahb_freq >> clk_exp;
  1063. /* return the clocks frequency */
  1064. switch(clock){
  1065. case CK_SYS:
  1066. ck_freq = cksys_freq;
  1067. break;
  1068. case CK_AHB:
  1069. ck_freq = ahb_freq;
  1070. break;
  1071. case CK_APB1:
  1072. ck_freq = apb1_freq;
  1073. break;
  1074. case CK_APB2:
  1075. ck_freq = apb2_freq;
  1076. break;
  1077. default:
  1078. break;
  1079. }
  1080. return ck_freq;
  1081. }