em_cmu.c 60 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162
  1. /***************************************************************************//**
  2. * @file
  3. * @brief Clock management unit (CMU) Peripheral API
  4. * @author Energy Micro AS
  5. * @version 3.0.0
  6. *******************************************************************************
  7. * @section License
  8. * <b>(C) Copyright 2012 Energy Micro AS, http://www.energymicro.com</b>
  9. *******************************************************************************
  10. *
  11. * Permission is granted to anyone to use this software for any purpose,
  12. * including commercial applications, and to alter it and redistribute it
  13. * freely, subject to the following restrictions:
  14. *
  15. * 1. The origin of this software must not be misrepresented; you must not
  16. * claim that you wrote the original software.
  17. * 2. Altered source versions must be plainly marked as such, and must not be
  18. * misrepresented as being the original software.
  19. * 3. This notice may not be removed or altered from any source distribution.
  20. *
  21. * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Energy Micro AS has no
  22. * obligation to support this Software. Energy Micro AS is providing the
  23. * Software "AS IS", with no express or implied warranties of any kind,
  24. * including, but not limited to, any implied warranties of merchantability
  25. * or fitness for any particular purpose or warranties against infringement
  26. * of any proprietary rights of a third party.
  27. *
  28. * Energy Micro AS will not be liable for any consequential, incidental, or
  29. * special damages, or any other relief, or for any claim by any third party,
  30. * arising from your use of this Software.
  31. *
  32. ******************************************************************************/
  33. #include "em_part.h"
  34. #include "em_cmu.h"
  35. #include "em_assert.h"
  36. #include "em_bitband.h"
  37. #include "em_emu.h"
  38. /***************************************************************************//**
  39. * @addtogroup EM_Library
  40. * @{
  41. ******************************************************************************/
  42. /***************************************************************************//**
  43. * @addtogroup CMU
  44. * @brief Clock management unit (CMU) Peripheral API
  45. * @{
  46. ******************************************************************************/
  47. /*******************************************************************************
  48. ****************************** DEFINES ************************************
  49. ******************************************************************************/
  50. /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
  51. /** Maximum allowed core frequency when using 0 wait states on flash access. */
  52. #define CMU_MAX_FREQ_0WS 16000000
  53. /** Maximum allowed core frequency when using 1 wait states on flash access */
  54. #define CMU_MAX_FREQ_1WS 32000000
  55. /** Maximum frequency before HFLE needs to be enabled on Giant Gecko */
  56. #define CMU_MAX_FREQ_HFLE 32000000
  57. /** Low frequency A group identifier */
  58. #define CMU_LFA 0
  59. /** Low frequency B group identifier */
  60. #define CMU_LFB 1
  61. /** @endcond */
  62. /*******************************************************************************
  63. ************************** LOCAL FUNCTIONS ********************************
  64. ******************************************************************************/
  65. /** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
  66. /***************************************************************************//**
  67. * @brief
  68. * Configure flash access wait states to most conservative setting for
  69. * this target. Retain SCBTP setting.
  70. ******************************************************************************/
  71. static void CMU_FlashWaitStateMax(void)
  72. {
  73. uint32_t cfg;
  74. cfg = MSC->READCTRL;
  75. switch(cfg & _MSC_READCTRL_MODE_MASK)
  76. {
  77. case MSC_READCTRL_MODE_WS1:
  78. case MSC_READCTRL_MODE_WS0:
  79. #if defined(_EFM32_GIANT_FAMILY)
  80. case MSC_READCTRL_MODE_WS2:
  81. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS2;
  82. #else
  83. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS1;
  84. #endif
  85. break;
  86. case MSC_READCTRL_MODE_WS1SCBTP:
  87. case MSC_READCTRL_MODE_WS0SCBTP:
  88. #if defined(_EFM32_GIANT_FAMILY)
  89. case MSC_READCTRL_MODE_WS2SCBTP:
  90. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS2SCBTP;
  91. #else
  92. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS1SCBTP;
  93. #endif
  94. break;
  95. }
  96. MSC->READCTRL = cfg;
  97. }
  98. /***************************************************************************//**
  99. * @brief Convert dividend to prescaler logarithmic value. Only works for even
  100. * numbers equal to 2^n
  101. * @param[in] div Unscaled dividend,
  102. * @return Base 2 logarithm of input, as used by fixed prescalers
  103. ******************************************************************************/
  104. __STATIC_INLINE uint32_t CMU_DivToLog2(CMU_ClkDiv_TypeDef div)
  105. {
  106. uint32_t log2;
  107. /* Prescalers take argument of 32768 or less */
  108. EFM_ASSERT((div>0) && (div <= 32768));
  109. /* Count leading zeroes and "reverse" result, Cortex-M3 intrinsic */
  110. log2 = (31 - __CLZ(div));
  111. return log2;
  112. }
  113. /***************************************************************************//**
  114. * @brief Convert logarithm of 2 prescaler to division factor
  115. * @param[in] log2
  116. * @return Dividend
  117. ******************************************************************************/
  118. __STATIC_INLINE uint32_t CMU_Log2ToDiv(uint32_t log2)
  119. {
  120. return 1<<log2;
  121. }
  122. /***************************************************************************//**
  123. * @brief
  124. * Configure flash access wait states in order to support given HFCORECLK
  125. * frequency.
  126. *
  127. * @param[in] hfcoreclk
  128. * HFCORECLK frequency that flash access wait states must be configured for.
  129. ******************************************************************************/
  130. static void CMU_FlashWaitStateControl(uint32_t hfcoreclk)
  131. {
  132. uint32_t cfg;
  133. cfg = MSC->READCTRL;
  134. #if defined(_EFM32_GIANT_FAMILY)
  135. if (hfcoreclk > CMU_MAX_FREQ_1WS)
  136. {
  137. switch(cfg & _MSC_READCTRL_MODE_MASK)
  138. {
  139. case MSC_READCTRL_MODE_WS0SCBTP:
  140. case MSC_READCTRL_MODE_WS1SCBTP:
  141. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS2SCBTP;
  142. break;
  143. case MSC_READCTRL_MODE_WS0:
  144. case MSC_READCTRL_MODE_WS1:
  145. default:
  146. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS2;
  147. break;
  148. }
  149. }
  150. #endif
  151. if ((hfcoreclk > CMU_MAX_FREQ_0WS) && (hfcoreclk <= CMU_MAX_FREQ_1WS))
  152. {
  153. switch (cfg & _MSC_READCTRL_MODE_MASK)
  154. {
  155. #if defined(_EFM32_GIANT_FAMILY)
  156. case MSC_READCTRL_MODE_WS2SCBTP:
  157. #endif
  158. case MSC_READCTRL_MODE_WS0SCBTP:
  159. case MSC_READCTRL_MODE_WS1SCBTP:
  160. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS1SCBTP;
  161. break;
  162. default:
  163. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS1;
  164. break;
  165. }
  166. }
  167. if (hfcoreclk <= CMU_MAX_FREQ_0WS)
  168. {
  169. switch (cfg & _MSC_READCTRL_MODE_MASK)
  170. {
  171. #if defined(_EFM32_GIANT_FAMILY)
  172. case MSC_READCTRL_MODE_WS2SCBTP:
  173. #endif
  174. case MSC_READCTRL_MODE_WS1SCBTP:
  175. case MSC_READCTRL_MODE_WS0SCBTP:
  176. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS0SCBTP;
  177. break;
  178. default:
  179. cfg = (cfg & ~_MSC_READCTRL_MODE_MASK) | MSC_READCTRL_MODE_WS0;
  180. break;
  181. }
  182. }
  183. MSC->READCTRL = cfg;
  184. }
  185. #if defined(USB_PRESENT)
  186. /***************************************************************************//**
  187. * @brief
  188. * Get the USBC frequency
  189. *
  190. * @return
  191. * USBC frequency in Hz
  192. ******************************************************************************/
  193. static uint32_t CMU_USBCClkGet(void)
  194. {
  195. uint32_t ret;
  196. CMU_Select_TypeDef clk;
  197. /* Get selected clock source */
  198. clk = CMU_ClockSelectGet(cmuClock_USBC);
  199. switch(clk)
  200. {
  201. case cmuSelect_LFXO:
  202. ret = SystemLFXOClockGet();
  203. break;
  204. case cmuSelect_LFRCO:
  205. ret = SystemLFRCOClockGet();
  206. break;
  207. case cmuSelect_HFCLK:
  208. ret = SystemHFClockGet();
  209. break;
  210. default:
  211. /* Clock is not enabled */
  212. ret = 0;
  213. break;
  214. }
  215. return ret;
  216. }
  217. #endif
  218. /***************************************************************************//**
  219. * @brief
  220. * Get the AUX clock frequency. Used by MSC flash programming and LESENSE,
  221. * by default also as debug clock.
  222. *
  223. * @return
  224. * AUX Frequency in Hz
  225. ******************************************************************************/
  226. static uint32_t CMU_AUXClkGet(void)
  227. {
  228. uint32_t ret;
  229. #if defined (_EFM32_GECKO_FAMILY)
  230. /* Gecko has a fixed 14Mhz AUXHFRCO clock */
  231. ret = 14000000;
  232. #else
  233. switch(CMU->AUXHFRCOCTRL & _CMU_AUXHFRCOCTRL_BAND_MASK)
  234. {
  235. case CMU_AUXHFRCOCTRL_BAND_1MHZ:
  236. ret = 1000000;
  237. break;
  238. case CMU_AUXHFRCOCTRL_BAND_7MHZ:
  239. ret = 7000000;
  240. break;
  241. case CMU_AUXHFRCOCTRL_BAND_11MHZ:
  242. ret = 11000000;
  243. break;
  244. case CMU_AUXHFRCOCTRL_BAND_14MHZ:
  245. ret = 14000000;
  246. break;
  247. case CMU_AUXHFRCOCTRL_BAND_21MHZ:
  248. ret = 21000000;
  249. break;
  250. case CMU_AUXHFRCOCTRL_BAND_28MHZ:
  251. ret = 28000000;
  252. break;
  253. default:
  254. ret = 0;
  255. break;
  256. }
  257. #endif
  258. return ret;
  259. }
  260. /***************************************************************************//**
  261. * @brief
  262. * Get the Debug Trace clock frequency
  263. *
  264. * @return
  265. * Debug Trace frequency in Hz
  266. ******************************************************************************/
  267. static uint32_t CMU_DBGClkGet(void)
  268. {
  269. uint32_t ret;
  270. CMU_Select_TypeDef clk;
  271. /* Get selected clock source */
  272. clk = CMU_ClockSelectGet(cmuClock_DBG);
  273. switch(clk)
  274. {
  275. case cmuSelect_HFCLK:
  276. ret = SystemHFClockGet();
  277. #if defined(_EFM32_GIANT_FAMILY)
  278. /* Giant Gecko has an additional divider, not used by USBC */
  279. ret = ret / (1 + ((CMU->CTRL & _CMU_CTRL_HFCLKDIV_MASK) >>
  280. _CMU_CTRL_HFCLKDIV_SHIFT));
  281. #endif
  282. break;
  283. case cmuSelect_AUXHFRCO:
  284. ret = CMU_AUXClkGet();
  285. break;
  286. default:
  287. EFM_ASSERT(0);
  288. ret = 0;
  289. break;
  290. }
  291. return ret;
  292. }
  293. /***************************************************************************//**
  294. * @brief
  295. * Get the LFnCLK frequency based on current configuration.
  296. *
  297. * @param[in] lfClkBranch
  298. * LF branch, 0 = LFA, 1 = LFB, ...
  299. *
  300. * @return
  301. * The LFnCLK frequency in Hz. If no LFnCLK is selected (disabled), 0 is
  302. * returned.
  303. ******************************************************************************/
  304. static uint32_t CMU_LFClkGet(unsigned int lfClkBranch)
  305. {
  306. uint32_t ret;
  307. EFM_ASSERT(lfClkBranch == CMU_LFA || lfClkBranch == CMU_LFB);
  308. switch ((CMU->LFCLKSEL >> (lfClkBranch * 2)) & 0x3)
  309. {
  310. case _CMU_LFCLKSEL_LFA_LFRCO:
  311. ret = SystemLFRCOClockGet();
  312. break;
  313. case _CMU_LFCLKSEL_LFA_LFXO:
  314. ret = SystemLFXOClockGet();
  315. break;
  316. case _CMU_LFCLKSEL_LFA_HFCORECLKLEDIV2:
  317. #if defined (_EFM32_GIANT_FAMILY)
  318. /* Giant Gecko can use a /4 divider (and must if >32MHz) or HFLE is set */
  319. if(((CMU->HFCORECLKDIV & _CMU_HFCORECLKDIV_HFCORECLKLEDIV_MASK) == CMU_HFCORECLKDIV_HFCORECLKLEDIV_DIV4)||
  320. (CMU->CTRL & CMU_CTRL_HFLE))
  321. {
  322. ret = SystemCoreClockGet() / 4;
  323. }
  324. else
  325. {
  326. ret = SystemCoreClockGet() / 2;
  327. }
  328. #else
  329. ret = SystemCoreClockGet() / 2;
  330. #endif
  331. break;
  332. case _CMU_LFCLKSEL_LFA_DISABLED:
  333. #if defined (_EFM32_GIANT_FAMILY) || defined (_EFM32_TINY_FAMILY)
  334. /* Check LF Extended bit setting for ULFRCO clock */
  335. if(CMU->LFCLKSEL >> (_CMU_LFCLKSEL_LFAE_SHIFT + lfClkBranch * 4))
  336. {
  337. ret = SystemULFRCOClockGet();
  338. }
  339. else
  340. {
  341. ret = 0;
  342. }
  343. #else
  344. ret = 0;
  345. #endif
  346. break;
  347. default:
  348. ret = 0;
  349. break;
  350. }
  351. return ret;
  352. }
  353. /***************************************************************************//**
  354. * @brief
  355. * Wait for ongoing sync of register(s) to low frequency domain to complete.
  356. *
  357. * @param[in] mask
  358. * Bitmask corresponding to SYNCBUSY register defined bits, indicating
  359. * registers that must complete any ongoing synchronization.
  360. ******************************************************************************/
  361. __STATIC_INLINE void CMU_Sync(uint32_t mask)
  362. {
  363. /* Avoid deadlock if modifying the same register twice when freeze mode is */
  364. /* activated. */
  365. if (CMU->FREEZE & CMU_FREEZE_REGFREEZE)
  366. return;
  367. /* Wait for any pending previous write operation to have been completed */
  368. /* in low frequency domain */
  369. while (CMU->SYNCBUSY & mask)
  370. ;
  371. }
  372. /** @endcond */
  373. /*******************************************************************************
  374. ************************** GLOBAL FUNCTIONS *******************************
  375. ******************************************************************************/
  376. /***************************************************************************//**
  377. * @brief
  378. * Calibrate clock.
  379. *
  380. * @details
  381. * Run a calibration for HFCLK against a selectable reference clock. Please
  382. * refer to the EFM32 reference manual, CMU chapter, for further details.
  383. *
  384. * @note
  385. * This function will not return until calibration measurement is completed.
  386. *
  387. * @param[in] HFCycles
  388. * The number of HFCLK cycles to run calibration. Increasing this number
  389. * increases precision, but the calibration will take more time.
  390. *
  391. * @param[in] ref
  392. * The reference clock used to compare HFCLK with.
  393. *
  394. * @return
  395. * The number of ticks the reference clock after HFCycles ticks on the HF
  396. * clock.
  397. ******************************************************************************/
  398. uint32_t CMU_Calibrate(uint32_t HFCycles, CMU_Osc_TypeDef ref)
  399. {
  400. EFM_ASSERT(HFCycles <= (_CMU_CALCNT_CALCNT_MASK >> _CMU_CALCNT_CALCNT_SHIFT));
  401. /* Set reference clock source */
  402. switch (ref)
  403. {
  404. case cmuOsc_LFXO:
  405. CMU->CALCTRL = CMU_CALCTRL_UPSEL_LFXO;
  406. break;
  407. case cmuOsc_LFRCO:
  408. CMU->CALCTRL = CMU_CALCTRL_UPSEL_LFRCO;
  409. break;
  410. case cmuOsc_HFXO:
  411. CMU->CALCTRL = CMU_CALCTRL_UPSEL_HFXO;
  412. break;
  413. case cmuOsc_HFRCO:
  414. CMU->CALCTRL = CMU_CALCTRL_UPSEL_HFRCO;
  415. break;
  416. case cmuOsc_AUXHFRCO:
  417. CMU->CALCTRL = CMU_CALCTRL_UPSEL_AUXHFRCO;
  418. break;
  419. default:
  420. EFM_ASSERT(0);
  421. return 0;
  422. }
  423. /* Set top value */
  424. CMU->CALCNT = HFCycles;
  425. /* Start calibration */
  426. CMU->CMD = CMU_CMD_CALSTART;
  427. /* Wait until calibration completes */
  428. while (CMU->STATUS & CMU_STATUS_CALBSY)
  429. ;
  430. return CMU->CALCNT;
  431. }
  432. #if defined (_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  433. /***************************************************************************//**
  434. * @brief
  435. * Configure clock calibration
  436. *
  437. * @details
  438. * Configure a calibration for a selectable clock source against another
  439. * selectable reference clock.
  440. * Refer to the EFM32 reference manual, CMU chapter, for further details.
  441. *
  442. * @note
  443. * After configuration, a call to CMU_CalibrateStart() is required, and
  444. * the resulting calibration value can be read out with the
  445. * CMU_CalibrateCountGet() function call.
  446. *
  447. * @param[in] downCycles
  448. * The number of downSel clock cycles to run calibration. Increasing this
  449. * number increases precision, but the calibration will take more time.
  450. *
  451. * @param[in] downSel
  452. * The clock which will be counted down downCycles
  453. *
  454. * @param[in] upSel
  455. * The reference clock, the number of cycles generated by this clock will
  456. * be counted and added up, the result can be given with the
  457. * CMU_CalibrateCountGet() function call.
  458. ******************************************************************************/
  459. void CMU_CalibrateConfig(uint32_t downCycles, CMU_Osc_TypeDef downSel,
  460. CMU_Osc_TypeDef upSel)
  461. {
  462. /* Keep untouched configuration settings */
  463. uint32_t calCtrl = CMU->CALCTRL & ~(_CMU_CALCTRL_UPSEL_MASK | _CMU_CALCTRL_DOWNSEL_MASK);
  464. /* 20 bits of precision to calibration count register */
  465. EFM_ASSERT(downCycles <= (_CMU_CALCNT_CALCNT_MASK >> _CMU_CALCNT_CALCNT_SHIFT));
  466. /* Set down counting clock source - down counter */
  467. switch (downSel)
  468. {
  469. case cmuOsc_LFXO:
  470. calCtrl |= CMU_CALCTRL_DOWNSEL_LFXO;
  471. break;
  472. case cmuOsc_LFRCO:
  473. calCtrl |= CMU_CALCTRL_DOWNSEL_LFRCO;
  474. break;
  475. case cmuOsc_HFXO:
  476. calCtrl |= CMU_CALCTRL_DOWNSEL_HFXO;
  477. break;
  478. case cmuOsc_HFRCO:
  479. calCtrl |= CMU_CALCTRL_DOWNSEL_HFRCO;
  480. break;
  481. case cmuOsc_AUXHFRCO:
  482. calCtrl |= CMU_CALCTRL_DOWNSEL_AUXHFRCO;
  483. break;
  484. default:
  485. EFM_ASSERT(0);
  486. }
  487. /* Set top value to be counted down by the downSel clock */
  488. CMU->CALCNT = downCycles;
  489. /* Set reference clock source - up counter */
  490. switch (upSel)
  491. {
  492. case cmuOsc_LFXO:
  493. calCtrl |= CMU_CALCTRL_UPSEL_LFXO;
  494. break;
  495. case cmuOsc_LFRCO:
  496. calCtrl |= CMU_CALCTRL_UPSEL_LFRCO;
  497. break;
  498. case cmuOsc_HFXO:
  499. calCtrl |= CMU_CALCTRL_UPSEL_HFXO;
  500. break;
  501. case cmuOsc_HFRCO:
  502. calCtrl |= CMU_CALCTRL_UPSEL_HFRCO;
  503. break;
  504. case cmuOsc_AUXHFRCO:
  505. calCtrl |= CMU_CALCTRL_UPSEL_AUXHFRCO;
  506. break;
  507. default:
  508. EFM_ASSERT(0);
  509. }
  510. CMU->CALCTRL = calCtrl;
  511. }
  512. #endif
  513. /***************************************************************************//**
  514. * @brief
  515. * Get clock divisor/prescaler.
  516. *
  517. * @param[in] clock
  518. * Clock point to get divisor/prescaler for. Notice that not all clock points
  519. * have a divisor/prescaler. Please refer to CMU overview in reference manual.
  520. *
  521. * @return
  522. * The current clock point divisor/prescaler. 1 is returned
  523. * if @p clock specifies a clock point without a divisor/prescaler.
  524. ******************************************************************************/
  525. CMU_ClkDiv_TypeDef CMU_ClockDivGet(CMU_Clock_TypeDef clock)
  526. {
  527. uint32_t divReg;
  528. CMU_ClkDiv_TypeDef ret;
  529. /* Get divisor reg id */
  530. divReg = (clock >> CMU_DIV_REG_POS) & CMU_DIV_REG_MASK;
  531. switch (divReg)
  532. {
  533. #if defined(_EFM32_GIANT_FAMILY)
  534. case CMU_HFCLKDIV_REG:
  535. ret = 1 + ((CMU->CTRL & _CMU_CTRL_HFCLKDIV_MASK) >>
  536. _CMU_CTRL_HFCLKDIV_SHIFT);
  537. break;
  538. #endif
  539. case CMU_HFPERCLKDIV_REG:
  540. ret = (CMU_ClkDiv_TypeDef)((CMU->HFPERCLKDIV &
  541. _CMU_HFPERCLKDIV_HFPERCLKDIV_MASK) >>
  542. _CMU_HFPERCLKDIV_HFPERCLKDIV_SHIFT);
  543. ret = CMU_Log2ToDiv(ret);
  544. break;
  545. case CMU_HFCORECLKDIV_REG:
  546. ret = (CMU_ClkDiv_TypeDef)((CMU->HFCORECLKDIV &
  547. _CMU_HFCORECLKDIV_HFCORECLKDIV_MASK) >>
  548. _CMU_HFCORECLKDIV_HFCORECLKDIV_SHIFT);
  549. ret = CMU_Log2ToDiv(ret);
  550. break;
  551. case CMU_LFAPRESC0_REG:
  552. switch (clock)
  553. {
  554. case cmuClock_RTC:
  555. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFAPRESC0 & _CMU_LFAPRESC0_RTC_MASK) >>
  556. _CMU_LFAPRESC0_RTC_SHIFT));
  557. ret = CMU_Log2ToDiv(ret);
  558. break;
  559. #if defined(_CMU_LFAPRESC0_LETIMER0_MASK)
  560. case cmuClock_LETIMER0:
  561. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFAPRESC0 & _CMU_LFAPRESC0_LETIMER0_MASK) >>
  562. _CMU_LFAPRESC0_LETIMER0_SHIFT));
  563. ret = CMU_Log2ToDiv(ret);
  564. break;
  565. #endif
  566. #if defined(_CMU_LFPRESC0_LCD_MASK)
  567. case cmuClock_LCDpre:
  568. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFAPRESC0 & _CMU_LFAPRESC0_LCD_MASK) >>
  569. _CMU_LFAPRESC0_LCD_SHIFT) + cmuClkDiv_16);
  570. ret = CMU_Log2ToDiv(ret);
  571. break;
  572. #endif
  573. #if defined(_CMU_LFAPRESC0_LESENSE_MASK)
  574. case cmuClock_LESENSE:
  575. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFAPRESC0 & _CMU_LFAPRESC0_LESENSE_MASK) >>
  576. _CMU_LFAPRESC0_LESENSE_SHIFT));
  577. ret = CMU_Log2ToDiv(ret);
  578. break;
  579. #endif
  580. default:
  581. EFM_ASSERT(0);
  582. ret = cmuClkDiv_1;
  583. break;
  584. }
  585. break;
  586. case CMU_LFBPRESC0_REG:
  587. switch (clock)
  588. {
  589. #if defined(_CMU_LFPRESC0_LEUART0_MASK)
  590. case cmuClock_LEUART0:
  591. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFBPRESC0 & _CMU_LFBPRESC0_LEUART0_MASK) >>
  592. _CMU_LFBPRESC0_LEUART0_SHIFT));
  593. ret = CMU_Log2ToDiv(ret);
  594. break;
  595. #endif
  596. #if defined(_CMU_LFPRESC0_LEUART1_MASK)
  597. case cmuClock_LEUART1:
  598. ret = (CMU_ClkDiv_TypeDef)(((CMU->LFBPRESC0 & _CMU_LFBPRESC0_LEUART1_MASK) >>
  599. _CMU_LFBPRESC0_LEUART1_SHIFT));
  600. ret = CMU_Log2ToDiv(ret);
  601. break;
  602. #endif
  603. default:
  604. EFM_ASSERT(0);
  605. ret = cmuClkDiv_1;
  606. break;
  607. }
  608. break;
  609. default:
  610. EFM_ASSERT(0);
  611. ret = cmuClkDiv_1;
  612. break;
  613. }
  614. return(ret);
  615. }
  616. /***************************************************************************//**
  617. * @brief
  618. * Set clock divisor/prescaler.
  619. *
  620. * @note
  621. * If setting a LF clock prescaler, synchronization into the low frequency
  622. * domain is required. If the same register is modified before a previous
  623. * update has completed, this function will stall until the previous
  624. * synchronization has completed. Please refer to CMU_FreezeEnable() for
  625. * a suggestion on how to reduce stalling time in some use cases.
  626. *
  627. * @param[in] clock
  628. * Clock point to set divisor/prescaler for. Notice that not all clock points
  629. * have a divisor/prescaler, please refer to CMU overview in the reference
  630. * manual.
  631. *
  632. * @param[in] div
  633. * The clock divisor to use (<= cmuClkDiv_512).
  634. ******************************************************************************/
  635. void CMU_ClockDivSet(CMU_Clock_TypeDef clock, CMU_ClkDiv_TypeDef div)
  636. {
  637. uint32_t freq;
  638. uint32_t divReg;
  639. /* Get divisor reg id */
  640. divReg = (clock >> CMU_DIV_REG_POS) & CMU_DIV_REG_MASK;
  641. switch (divReg)
  642. {
  643. #if defined (_EFM32_GIANT_FAMILY)
  644. case CMU_HFCLKDIV_REG:
  645. EFM_ASSERT((div>=cmuClkDiv_1) && (div<=cmuClkDiv_8));
  646. /* Configure worst case wait states for flash access before setting divisor */
  647. CMU_FlashWaitStateMax();
  648. /* Set divider */
  649. CMU->CTRL = (CMU->CTRL & ~_CMU_CTRL_HFCLKDIV_MASK) |
  650. ((div-1) << _CMU_CTRL_HFCLKDIV_SHIFT);
  651. /* Update CMSIS core clock variable */
  652. /* (The function will update the global variable) */
  653. freq = SystemCoreClockGet();
  654. /* Optimize flash access wait state setting for current core clk */
  655. CMU_FlashWaitStateControl(freq);
  656. break;
  657. #endif
  658. case CMU_HFPERCLKDIV_REG:
  659. EFM_ASSERT((div >= cmuClkDiv_1) && (div <= cmuClkDiv_512));
  660. /* Convert to correct scale */
  661. div = CMU_DivToLog2(div);
  662. CMU->HFPERCLKDIV = (CMU->HFPERCLKDIV & ~_CMU_HFPERCLKDIV_HFPERCLKDIV_MASK) |
  663. (div << _CMU_HFPERCLKDIV_HFPERCLKDIV_SHIFT);
  664. break;
  665. case CMU_HFCORECLKDIV_REG:
  666. EFM_ASSERT(div <= cmuClkDiv_512);
  667. /* Configure worst case wait states for flash access before setting divisor */
  668. CMU_FlashWaitStateMax();
  669. /* Convert to correct scale */
  670. div = CMU_DivToLog2(div);
  671. CMU->HFCORECLKDIV = (CMU->HFCORECLKDIV & ~_CMU_HFCORECLKDIV_HFCORECLKDIV_MASK) |
  672. (div << _CMU_HFCORECLKDIV_HFCORECLKDIV_SHIFT);
  673. /* Update CMSIS core clock variable */
  674. /* (The function will update the global variable) */
  675. freq = SystemCoreClockGet();
  676. /* Optimize flash access wait state setting for current core clk */
  677. CMU_FlashWaitStateControl(freq);
  678. break;
  679. case CMU_LFAPRESC0_REG:
  680. switch (clock)
  681. {
  682. case cmuClock_RTC:
  683. EFM_ASSERT(div <= cmuClkDiv_32768);
  684. /* LF register about to be modified require sync. busy check */
  685. CMU_Sync(CMU_SYNCBUSY_LFAPRESC0);
  686. /* Convert to correct scale */
  687. div = CMU_DivToLog2(div);
  688. CMU->LFAPRESC0 = (CMU->LFAPRESC0 & ~_CMU_LFAPRESC0_RTC_MASK) |
  689. (div << _CMU_LFAPRESC0_RTC_SHIFT);
  690. break;
  691. #if defined(_CMU_LFAPRESC0_LETIMER0_MASK)
  692. case cmuClock_LETIMER0:
  693. EFM_ASSERT(div <= cmuClkDiv_32768);
  694. /* LF register about to be modified require sync. busy check */
  695. CMU_Sync(CMU_SYNCBUSY_LFAPRESC0);
  696. /* Convert to correct scale */
  697. div = CMU_DivToLog2(div);
  698. CMU->LFAPRESC0 = (CMU->LFAPRESC0 & ~_CMU_LFAPRESC0_LETIMER0_MASK) |
  699. (div << _CMU_LFAPRESC0_LETIMER0_SHIFT);
  700. break;
  701. #endif
  702. #if defined(LCD_PRESENT)
  703. case cmuClock_LCDpre:
  704. EFM_ASSERT((div >= cmuClkDiv_16) && (div <= cmuClkDiv_128));
  705. /* LF register about to be modified require sync. busy check */
  706. CMU_Sync(CMU_SYNCBUSY_LFAPRESC0);
  707. /* Convert to correct scale */
  708. div = CMU_DivToLog2(div);
  709. CMU->LFAPRESC0 = (CMU->LFAPRESC0 & ~_CMU_LFAPRESC0_LCD_MASK) |
  710. ((div - cmuClkDiv_16) << _CMU_LFAPRESC0_LCD_SHIFT);
  711. break;
  712. #endif /* defined(LCD_PRESENT) */
  713. #if defined(LESENSE_PRESENT)
  714. case cmuClock_LESENSE:
  715. EFM_ASSERT(div <= cmuClkDiv_8);
  716. /* LF register about to be modified require sync. busy check */
  717. CMU_Sync(CMU_SYNCBUSY_LFAPRESC0);
  718. /* Convert to correct scale */
  719. div = CMU_DivToLog2(div);
  720. CMU->LFAPRESC0 = (CMU->LFAPRESC0 & ~_CMU_LFAPRESC0_LESENSE_MASK) |
  721. (div << _CMU_LFAPRESC0_LESENSE_SHIFT);
  722. break;
  723. #endif /* defined(LESENSE_PRESENT) */
  724. default:
  725. EFM_ASSERT(0);
  726. break;
  727. }
  728. break;
  729. case CMU_LFBPRESC0_REG:
  730. switch (clock)
  731. {
  732. #if defined(_CMU_LFBPRESC0_LEUART0_MASK)
  733. case cmuClock_LEUART0:
  734. EFM_ASSERT(div <= cmuClkDiv_8);
  735. /* LF register about to be modified require sync. busy check */
  736. CMU_Sync(CMU_SYNCBUSY_LFBPRESC0);
  737. /* Convert to correct scale */
  738. div = CMU_DivToLog2(div);
  739. CMU->LFBPRESC0 = (CMU->LFBPRESC0 & ~_CMU_LFBPRESC0_LEUART0_MASK) |
  740. (((uint32_t)div) << _CMU_LFBPRESC0_LEUART0_SHIFT);
  741. break;
  742. #endif
  743. #if defined(_CMU_LFBPRESC0_LEUART1_MASK)
  744. case cmuClock_LEUART1:
  745. EFM_ASSERT(div <= cmuClkDiv_8);
  746. /* LF register about to be modified require sync. busy check */
  747. CMU_Sync(CMU_SYNCBUSY_LFBPRESC0);
  748. /* Convert to correct scale */
  749. div = CMU_DivToLog2(div);
  750. CMU->LFBPRESC0 = (CMU->LFBPRESC0 & ~_CMU_LFBPRESC0_LEUART1_MASK) |
  751. (((uint32_t)div) << _CMU_LFBPRESC0_LEUART1_SHIFT);
  752. break;
  753. #endif
  754. default:
  755. EFM_ASSERT(0);
  756. break;
  757. }
  758. break;
  759. default:
  760. EFM_ASSERT(0);
  761. break;
  762. }
  763. }
  764. /***************************************************************************//**
  765. * @brief
  766. * Enable/disable a clock.
  767. *
  768. * @details
  769. * In general, module clocking is disabled after a reset. If a module
  770. * clock is disabled, the registers of that module are not accessible and
  771. * reading from such registers may return undefined values. Writing to
  772. * registers of clock disabled modules have no effect. One should normally
  773. * avoid accessing module registers of a module with a disabled clock.
  774. *
  775. * @note
  776. * If enabling/disabling a LF clock, synchronization into the low frequency
  777. * domain is required. If the same register is modified before a previous
  778. * update has completed, this function will stall until the previous
  779. * synchronization has completed. Please refer to CMU_FreezeEnable() for
  780. * a suggestion on how to reduce stalling time in some use cases.
  781. *
  782. * @param[in] clock
  783. * The clock to enable/disable. Notice that not all defined clock
  784. * points have separate enable/disable control, please refer to CMU overview
  785. * in reference manual.
  786. *
  787. * @param[in] enable
  788. * @li true - enable specified clock.
  789. * @li false - disable specified clock.
  790. ******************************************************************************/
  791. void CMU_ClockEnable(CMU_Clock_TypeDef clock, bool enable)
  792. {
  793. volatile uint32_t *reg;
  794. uint32_t bit;
  795. uint32_t sync = 0;
  796. /* Identify enable register */
  797. switch ((clock >> CMU_EN_REG_POS) & CMU_EN_REG_MASK)
  798. {
  799. case CMU_HFPERCLKDIV_EN_REG:
  800. reg = &(CMU->HFPERCLKDIV);
  801. break;
  802. case CMU_HFPERCLKEN0_EN_REG:
  803. reg = &(CMU->HFPERCLKEN0);
  804. break;
  805. case CMU_HFCORECLKEN0_EN_REG:
  806. reg = &(CMU->HFCORECLKEN0);
  807. break;
  808. case CMU_LFACLKEN0_EN_REG:
  809. reg = &(CMU->LFACLKEN0);
  810. sync = CMU_SYNCBUSY_LFACLKEN0;
  811. break;
  812. case CMU_LFBCLKEN0_EN_REG:
  813. reg = &(CMU->LFBCLKEN0);
  814. sync = CMU_SYNCBUSY_LFBCLKEN0;
  815. break;
  816. case CMU_PCNT_EN_REG:
  817. reg = &(CMU->PCNTCTRL);
  818. break;
  819. default: /* Cannot enable/disable clock point */
  820. EFM_ASSERT(0);
  821. return;
  822. }
  823. /* Get bit position used to enable/disable */
  824. bit = (clock >> CMU_EN_BIT_POS) & CMU_EN_BIT_MASK;
  825. /* LF synchronization required? */
  826. if (sync)
  827. {
  828. CMU_Sync(sync);
  829. }
  830. /* Set/clear bit as requested */
  831. BITBAND_Peripheral(reg, bit, (unsigned int)enable);
  832. }
  833. /***************************************************************************//**
  834. * @brief
  835. * Get clock frequency for a clock point.
  836. *
  837. * @param[in] clock
  838. * Clock point to fetch frequency for.
  839. *
  840. * @return
  841. * The current frequency in Hz.
  842. ******************************************************************************/
  843. uint32_t CMU_ClockFreqGet(CMU_Clock_TypeDef clock)
  844. {
  845. uint32_t ret;
  846. switch(clock & (CMU_CLK_BRANCH_MASK << CMU_CLK_BRANCH_POS))
  847. {
  848. case (CMU_HF_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  849. {
  850. ret = SystemHFClockGet();
  851. #if defined(_EFM32_GIANT_FAMILY)
  852. /* Giant Gecko has an additional divider, not used by USBC */
  853. ret = ret / (1 + ((CMU->CTRL & _CMU_CTRL_HFCLKDIV_MASK) >>
  854. _CMU_CTRL_HFCLKDIV_SHIFT));
  855. #endif
  856. } break;
  857. #if defined(_CMU_HFPERCLKEN0_USART0_MASK) || \
  858. defined(_CMU_HFPERCLKEN0_USART1_MASK) || \
  859. defined(_CMU_HFPERCLKEN0_USART2_MASK) || \
  860. defined(_CMU_HFPERCLKEN0_UART0_MASK) || \
  861. defined(_CMU_HFPERCLKEN0_UART1_MASK) || \
  862. defined(_CMU_HFPERCLKEN0_TIMER0_MASK) || \
  863. defined(_CMU_HFPERCLKEN0_TIMER1_MASK) || \
  864. defined(_CMU_HFPERCLKEN0_TIMER2_MASK) || \
  865. defined(_CMU_HFPERCLKEN0_TIMER3_MASK) || \
  866. defined(_CMU_HFPERCLKEN0_ACMP0_MASK) || \
  867. defined(_CMU_HFPERCLKEN0_ACMP1_MASK) || \
  868. defined(_CMU_HFPERCLKEN0_DAC0_MASK) || \
  869. defined(_CMU_HFPERCLKEN0_ADC0_MASK) || \
  870. defined(_CMU_HFPERCLKEN0_I2C0_MASK) || \
  871. defined(_CMU_HFPERCLKEN0_I2C1_MASK) || \
  872. defined(PRS_PRESENT) || \
  873. defined(VCMP_PRESENT)|| \
  874. defined(GPIO_PRESENT)
  875. case (CMU_HFPER_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  876. {
  877. ret = SystemHFClockGet();
  878. #if defined (_EFM32_GIANT_FAMILY)
  879. /* Leopard/Giant Gecko has an additional divider */
  880. ret = ret / (1 + ((CMU->CTRL & _CMU_CTRL_HFCLKDIV_MASK) >>
  881. _CMU_CTRL_HFCLKDIV_SHIFT));
  882. #endif
  883. ret >>= (CMU->HFPERCLKDIV & _CMU_HFPERCLKDIV_HFPERCLKDIV_MASK) >>
  884. _CMU_HFPERCLKDIV_HFPERCLKDIV_SHIFT;
  885. } break;
  886. #endif
  887. #if defined(AES_PRESENT) || \
  888. defined(DMA_PRESENT) || \
  889. defined(EBI_PRESENT) || \
  890. defined(USB_PRESENT)
  891. case (CMU_HFCORE_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  892. {
  893. ret = SystemCoreClockGet();
  894. } break;
  895. #endif
  896. case (CMU_LFA_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  897. {
  898. ret = CMU_LFClkGet(CMU_LFA);
  899. } break;
  900. #if defined(_CMU_LFACLKEN0_RTC_MASK)
  901. case (CMU_RTC_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  902. {
  903. ret = CMU_LFClkGet(CMU_LFA);
  904. ret >>= (CMU->LFAPRESC0 & _CMU_LFAPRESC0_RTC_MASK) >>
  905. _CMU_LFAPRESC0_RTC_SHIFT;
  906. } break;
  907. #endif
  908. #if defined(_CMU_LFACLKEN0_LETIMER0_MASK)
  909. case (CMU_LETIMER_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  910. {
  911. ret = CMU_LFClkGet(CMU_LFA);
  912. ret >>= (CMU->LFAPRESC0 & _CMU_LFAPRESC0_LETIMER0_MASK) >>
  913. _CMU_LFAPRESC0_LETIMER0_SHIFT;
  914. } break;
  915. #endif
  916. #if defined(_CMU_LFACLKEN0_LCD_MASK)
  917. case (CMU_LCDPRE_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  918. {
  919. ret = CMU_LFClkGet(CMU_LFA);
  920. ret >>= (CMU->LFAPRESC0 & _CMU_LFAPRESC0_LCD_MASK) >>
  921. _CMU_LFAPRESC0_LCD_SHIFT;
  922. } break;
  923. case (CMU_LCD_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  924. {
  925. ret = CMU_LFClkGet(CMU_LFA);
  926. ret >>= (CMU->LFAPRESC0 & _CMU_LFAPRESC0_LCD_MASK) >>
  927. _CMU_LFAPRESC0_LCD_SHIFT;
  928. ret /= (1 + ((CMU->LCDCTRL & _CMU_LCDCTRL_FDIV_MASK) >>
  929. _CMU_LCDCTRL_FDIV_SHIFT));
  930. } break;
  931. #endif
  932. #if defined(_CMU_LFACLKEN0_LESENSE_MASK)
  933. case (CMU_LESENSE_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  934. {
  935. ret = CMU_LFClkGet(CMU_LFA);
  936. ret >>= (CMU->LFAPRESC0 & _CMU_LFAPRESC0_LESENSE_MASK) >>
  937. _CMU_LFAPRESC0_LESENSE_SHIFT;
  938. } break;
  939. #endif
  940. case (CMU_LFB_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  941. {
  942. ret = CMU_LFClkGet(CMU_LFB);
  943. } break;
  944. #if defined(_CMU_LFBCLKEN0_LEUART0_MASK)
  945. case (CMU_LEUART0_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  946. {
  947. ret = CMU_LFClkGet(CMU_LFB);
  948. ret >>= (CMU->LFBPRESC0 & _CMU_LFBPRESC0_LEUART0_MASK) >>
  949. _CMU_LFBPRESC0_LEUART0_SHIFT;
  950. } break;
  951. #endif
  952. #if defined(_CMU_LFBCLKEN0_LEUART1_MASK)
  953. case (CMU_LEUART1_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  954. {
  955. ret = CMU_LFClkGet(CMU_LFB);
  956. ret >>= (CMU->LFBPRESC0 & _CMU_LFBPRESC0_LEUART1_MASK) >>
  957. _CMU_LFBPRESC0_LEUART1_SHIFT;
  958. } break;
  959. #endif
  960. case (CMU_DBG_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  961. {
  962. ret = CMU_DBGClkGet();
  963. } break;
  964. case (CMU_AUX_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  965. {
  966. ret = CMU_AUXClkGet();
  967. } break;
  968. #if defined(USB_PRESENT)
  969. case (CMU_USBC_CLK_BRANCH << CMU_CLK_BRANCH_POS):
  970. {
  971. ret = CMU_USBCClkGet();
  972. } break;
  973. #endif
  974. default:
  975. {
  976. EFM_ASSERT(0);
  977. ret = 0;
  978. } break;
  979. }
  980. return ret;
  981. }
  982. /**************************************************************************//**
  983. * @brief
  984. * Get currently selected reference clock used for a clock branch.
  985. *
  986. * @param[in] clock
  987. * Clock branch to fetch selected ref. clock for. One of:
  988. * @li #cmuClock_HF
  989. * @li #cmuClock_LFA
  990. * @li #cmuClock_LFB
  991. * @li #cmuClock_USBC
  992. * @li #cmuClock_DBG
  993. *
  994. * @return
  995. * Reference clock used for clocking selected branch, #cmuSelect_Error if
  996. * invalid @p clock provided.
  997. *****************************************************************************/
  998. CMU_Select_TypeDef CMU_ClockSelectGet(CMU_Clock_TypeDef clock)
  999. {
  1000. CMU_Select_TypeDef ret = cmuSelect_Disabled;
  1001. uint32_t selReg;
  1002. selReg = (clock >> CMU_SEL_REG_POS) & CMU_SEL_REG_MASK;
  1003. switch (selReg)
  1004. {
  1005. case CMU_HFCLKSEL_REG:
  1006. switch (CMU->STATUS & (CMU_STATUS_HFRCOSEL | CMU_STATUS_HFXOSEL |
  1007. CMU_STATUS_LFRCOSEL | CMU_STATUS_LFXOSEL))
  1008. {
  1009. case CMU_STATUS_LFXOSEL:
  1010. ret = cmuSelect_LFXO;
  1011. break;
  1012. case CMU_STATUS_LFRCOSEL:
  1013. ret = cmuSelect_LFRCO;
  1014. break;
  1015. case CMU_STATUS_HFXOSEL:
  1016. ret = cmuSelect_HFXO;
  1017. break;
  1018. default:
  1019. ret = cmuSelect_HFRCO;
  1020. break;
  1021. }
  1022. break;
  1023. case CMU_LFACLKSEL_REG:
  1024. switch (CMU->LFCLKSEL & _CMU_LFCLKSEL_LFA_MASK)
  1025. {
  1026. case _CMU_LFCLKSEL_LFA_LFRCO:
  1027. ret = cmuSelect_LFRCO;
  1028. break;
  1029. case _CMU_LFCLKSEL_LFA_LFXO:
  1030. ret = cmuSelect_LFXO;
  1031. break;
  1032. case _CMU_LFCLKSEL_LFA_HFCORECLKLEDIV2:
  1033. ret = cmuSelect_CORELEDIV2;
  1034. break;
  1035. default:
  1036. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1037. if (CMU->LFCLKSEL & _CMU_LFCLKSEL_LFAE_MASK)
  1038. {
  1039. ret = cmuSelect_ULFRCO;
  1040. break;
  1041. }
  1042. #else
  1043. ret = cmuSelect_Disabled;
  1044. #endif
  1045. break;
  1046. }
  1047. break;
  1048. case CMU_LFBCLKSEL_REG:
  1049. switch (CMU->LFCLKSEL & _CMU_LFCLKSEL_LFB_MASK)
  1050. {
  1051. case _CMU_LFCLKSEL_LFB_LFRCO:
  1052. ret = cmuSelect_LFRCO;
  1053. break;
  1054. case _CMU_LFCLKSEL_LFB_LFXO:
  1055. ret = cmuSelect_LFXO;
  1056. break;
  1057. case _CMU_LFCLKSEL_LFB_HFCORECLKLEDIV2:
  1058. ret = cmuSelect_CORELEDIV2;
  1059. break;
  1060. default:
  1061. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1062. if (CMU->LFCLKSEL & _CMU_LFCLKSEL_LFBE_MASK)
  1063. {
  1064. ret = cmuSelect_ULFRCO;
  1065. break;
  1066. }
  1067. #else
  1068. ret = cmuSelect_Disabled;
  1069. #endif
  1070. break;
  1071. }
  1072. break;
  1073. case CMU_DBGCLKSEL_REG:
  1074. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1075. switch(CMU->CTRL & _CMU_CTRL_DBGCLK_MASK)
  1076. {
  1077. case CMU_CTRL_DBGCLK_AUXHFRCO:
  1078. ret = cmuSelect_AUXHFRCO;
  1079. break;
  1080. case CMU_CTRL_DBGCLK_HFCLK:
  1081. ret = cmuSelect_HFCLK;
  1082. break;
  1083. }
  1084. #endif
  1085. #if defined(_EFM32_GECKO_FAMILY)
  1086. ret = cmuSelect_AUXHFRCO;
  1087. #endif
  1088. break;
  1089. #if defined(USB_PRESENT)
  1090. case CMU_USBCCLKSEL_REG:
  1091. switch(CMU->STATUS & (CMU_STATUS_USBCHFCLKSEL |
  1092. CMU_STATUS_USBCLFXOSEL |
  1093. CMU_STATUS_USBCLFRCOSEL))
  1094. {
  1095. case CMU_STATUS_USBCHFCLKSEL:
  1096. ret = cmuSelect_HFCLK;
  1097. break;
  1098. case CMU_STATUS_USBCLFXOSEL:
  1099. ret = cmuSelect_LFXO;
  1100. break;
  1101. case CMU_STATUS_USBCLFRCOSEL:
  1102. ret = cmuSelect_LFRCO;
  1103. break;
  1104. default:
  1105. ret = cmuSelect_Disabled;
  1106. break;
  1107. }
  1108. break;
  1109. #endif
  1110. default:
  1111. EFM_ASSERT(0);
  1112. ret = cmuSelect_Error;
  1113. break;
  1114. }
  1115. return ret;
  1116. }
  1117. /**************************************************************************//**
  1118. * @brief
  1119. * Select reference clock/oscillator used for a clock branch.
  1120. *
  1121. * @details
  1122. * Notice that if a selected reference is not enabled prior to selecting its
  1123. * use, it will be enabled, and this function will wait for the selected
  1124. * oscillator to be stable. It will however NOT be disabled if another
  1125. * reference clock is selected later.
  1126. *
  1127. * This feature is particularly important if selecting a new reference
  1128. * clock for the clock branch clocking the core, otherwise the system
  1129. * may halt.
  1130. *
  1131. * @param[in] clock
  1132. * Clock branch to select reference clock for. One of:
  1133. * @li #cmuClock_HF
  1134. * @li #cmuClock_LFA
  1135. * @li #cmuClock_LFB
  1136. * @li #cmuClock_USBC
  1137. * @li #cmuClock_DBG
  1138. *
  1139. * @param[in] ref
  1140. * Reference selected for clocking, please refer to reference manual for
  1141. * for details on which reference is available for a specific clock branch.
  1142. * @li #cmuSelect_HFRCO
  1143. * @li #cmuSelect_LFRCO
  1144. * @li #cmuSelect_HFXO
  1145. * @li #cmuSelect_LFXO
  1146. * @li #cmuSelect_CORELEDIV2
  1147. * @li #cmuSelect_AUXHFRC
  1148. * @li #cmuSelect_HFCLK
  1149. * @li #cmuSelect_ULFRCO
  1150. *****************************************************************************/
  1151. void CMU_ClockSelectSet(CMU_Clock_TypeDef clock, CMU_Select_TypeDef ref)
  1152. {
  1153. uint32_t select = cmuOsc_HFRCO;
  1154. CMU_Osc_TypeDef osc = cmuOsc_HFRCO;
  1155. uint32_t freq;
  1156. uint32_t selReg;
  1157. uint32_t lfShift;
  1158. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1159. uint32_t lfExtendedShift;
  1160. uint32_t lfExtended = 0;
  1161. #endif
  1162. uint32_t tmp;
  1163. selReg = (clock >> CMU_SEL_REG_POS) & CMU_SEL_REG_MASK;
  1164. switch (selReg)
  1165. {
  1166. case CMU_HFCLKSEL_REG:
  1167. switch (ref)
  1168. {
  1169. case cmuSelect_LFXO:
  1170. select = CMU_CMD_HFCLKSEL_LFXO;
  1171. osc = cmuOsc_LFXO;
  1172. break;
  1173. case cmuSelect_LFRCO:
  1174. select = CMU_CMD_HFCLKSEL_LFRCO;
  1175. osc = cmuOsc_LFRCO;
  1176. break;
  1177. case cmuSelect_HFXO:
  1178. select = CMU_CMD_HFCLKSEL_HFXO;
  1179. osc = cmuOsc_HFXO;
  1180. #if defined(_EFM32_GIANT_FAMILY)
  1181. /* Adjust HFXO buffer current for high frequencies, enable HFLE for */
  1182. /* frequencies above 32MHz */
  1183. if(SystemHFXOClockGet() > CMU_MAX_FREQ_HFLE)
  1184. {
  1185. CMU->CTRL = (CMU->CTRL & ~_CMU_CTRL_HFXOBUFCUR_MASK) |
  1186. CMU_CTRL_HFXOBUFCUR_BOOSTABOVE32MHZ |
  1187. /* Must have HFLE enabled to access some LE peripherals >=32MHz */
  1188. CMU_CTRL_HFLE;
  1189. } else {
  1190. /* This can happen if the user configures the EFM32_HFXO_FREQ to */
  1191. /* use another oscillator frequency */
  1192. CMU->CTRL = (CMU->CTRL & ~_CMU_CTRL_HFXOBUFCUR_MASK) |
  1193. CMU_CTRL_HFXOBUFCUR_BOOSTUPTO32MHZ;
  1194. }
  1195. #endif
  1196. break;
  1197. case cmuSelect_HFRCO:
  1198. select = CMU_CMD_HFCLKSEL_HFRCO;
  1199. osc = cmuOsc_HFRCO;
  1200. break;
  1201. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1202. case cmuSelect_ULFRCO:
  1203. /* ULFRCO cannot be used as HFCLK */
  1204. EFM_ASSERT(0);
  1205. break;
  1206. #endif
  1207. default:
  1208. EFM_ASSERT(0);
  1209. return;
  1210. }
  1211. /* Ensure selected oscillator is enabled, waiting for it to stabilize */
  1212. CMU_OscillatorEnable(osc, true, true);
  1213. /* Configure worst case wait states for flash access before selecting */
  1214. CMU_FlashWaitStateMax();
  1215. /* Switch to selected oscillator */
  1216. CMU->CMD = select;
  1217. /* Keep EMU module informed */
  1218. EMU_UpdateOscConfig();
  1219. /* Update CMSIS core clock variable */
  1220. /* (The function will update the global variable) */
  1221. freq = SystemCoreClockGet();
  1222. /* Optimize flash access wait state setting for currently selected core clk */
  1223. CMU_FlashWaitStateControl(freq);
  1224. break;
  1225. case CMU_LFACLKSEL_REG:
  1226. case CMU_LFBCLKSEL_REG:
  1227. if (selReg == CMU_LFACLKSEL_REG)
  1228. {
  1229. lfShift = _CMU_LFCLKSEL_LFA_SHIFT;
  1230. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1231. lfExtendedShift = _CMU_LFCLKSEL_LFAE_SHIFT;
  1232. #endif
  1233. }
  1234. else
  1235. {
  1236. lfShift = _CMU_LFCLKSEL_LFB_SHIFT;
  1237. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1238. lfExtendedShift = _CMU_LFCLKSEL_LFBE_SHIFT;
  1239. #endif
  1240. }
  1241. switch (ref)
  1242. {
  1243. case cmuSelect_Disabled:
  1244. tmp = _CMU_LFCLKSEL_LFA_DISABLED;
  1245. break;
  1246. case cmuSelect_LFXO:
  1247. /* Ensure selected oscillator is enabled, waiting for it to stabilize */
  1248. CMU_OscillatorEnable(cmuOsc_LFXO, true, true);
  1249. tmp = _CMU_LFCLKSEL_LFA_LFXO;
  1250. break;
  1251. case cmuSelect_LFRCO:
  1252. /* Ensure selected oscillator is enabled, waiting for it to stabilize */
  1253. CMU_OscillatorEnable(cmuOsc_LFRCO, true, true);
  1254. tmp = _CMU_LFCLKSEL_LFA_LFRCO;
  1255. break;
  1256. case cmuSelect_CORELEDIV2:
  1257. /* Ensure HFCORE to LE clocking is enabled */
  1258. BITBAND_Peripheral(&(CMU->HFCORECLKEN0), _CMU_HFCORECLKEN0_LE_SHIFT, 1);
  1259. tmp = _CMU_LFCLKSEL_LFA_HFCORECLKLEDIV2;
  1260. #if defined(_EFM32_GIANT_FAMILY)
  1261. /* If core frequency is > 32MHz on Giant/Leopard, enable HFLE and DIV4 */
  1262. freq = SystemCoreClockGet();
  1263. if(freq > CMU_MAX_FREQ_HFLE)
  1264. {
  1265. /* Enable CMU HFLE */
  1266. BITBAND_Peripheral(&(CMU->CTRL), _CMU_CTRL_HFLE_SHIFT, 1);
  1267. /* Enable DIV4 factor for peripheral clock */
  1268. BITBAND_Peripheral(&(CMU->HFCORECLKDIV),
  1269. _CMU_HFCORECLKDIV_HFCORECLKLEDIV_SHIFT, 1);
  1270. }
  1271. #endif
  1272. break;
  1273. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1274. case cmuSelect_ULFRCO:
  1275. /* ULFRCO is always enabled */
  1276. tmp = _CMU_LFCLKSEL_LFA_DISABLED;
  1277. lfExtended = 1;
  1278. break;
  1279. #endif
  1280. default:
  1281. /* Illegal clock source for LFA/LFB selected */
  1282. EFM_ASSERT(0);
  1283. return;
  1284. }
  1285. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1286. CMU->LFCLKSEL = (CMU->LFCLKSEL & ~((_CMU_LFCLKSEL_LFA_MASK | _CMU_LFCLKSEL_LFAE_MASK) << lfShift)) |
  1287. (tmp << lfShift) | (lfExtended << lfExtendedShift);
  1288. #else
  1289. CMU->LFCLKSEL = (CMU->LFCLKSEL & ~(_CMU_LFCLKSEL_LFA_MASK << lfShift)) |
  1290. (tmp << lfShift);
  1291. #endif
  1292. break;
  1293. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1294. case CMU_DBGCLKSEL_REG:
  1295. switch(ref)
  1296. {
  1297. case cmuSelect_AUXHFRCO:
  1298. /* Select AUXHFRCO as debug clock */
  1299. CMU->CTRL = (CMU->CTRL & ~(_CMU_CTRL_DBGCLK_MASK))| CMU_CTRL_DBGCLK_AUXHFRCO;
  1300. break;
  1301. case cmuSelect_HFCLK:
  1302. /* Select divided HFCLK as debug clock */
  1303. CMU->CTRL = (CMU->CTRL & ~(_CMU_CTRL_DBGCLK_MASK))| CMU_CTRL_DBGCLK_HFCLK;
  1304. break;
  1305. default:
  1306. /* Illegal clock source for debug selected */
  1307. EFM_ASSERT(0);
  1308. return;
  1309. }
  1310. break;
  1311. #endif
  1312. #if defined(USB_PRESENT)
  1313. case CMU_USBCCLKSEL_REG:
  1314. switch(ref)
  1315. {
  1316. case cmuSelect_HFCLK:
  1317. /* Select undivided HFCLK as clock source for USB */
  1318. /* Oscillator must already be enabled, if not the core had stopped */
  1319. CMU->CMD = CMU_CMD_USBCCLKSEL_HFCLKNODIV;
  1320. /* Wait until clock is activated */
  1321. while((CMU->STATUS & CMU_STATUS_USBCHFCLKSEL)==0);
  1322. break;
  1323. case cmuSelect_LFXO:
  1324. /* Select LFXO as clock source for USB, can only be used in sleep mode */
  1325. /* Ensure selected oscillator is enabled, waiting for it to stabilize */
  1326. CMU_OscillatorEnable(cmuOsc_LFXO, true, true);
  1327. /* Switch oscillator */
  1328. CMU->CMD = CMU_CMD_USBCCLKSEL_LFXO;
  1329. /* Wait until clock is activated */
  1330. while((CMU->STATUS & CMU_STATUS_USBCLFXOSEL)==0);
  1331. break;
  1332. case cmuSelect_LFRCO:
  1333. /* Select LFRCO as clock source for USB, can only be used in sleep mode */
  1334. /* Ensure selected oscillator is enabled, waiting for it to stabilize */
  1335. CMU_OscillatorEnable(cmuOsc_LFRCO, true, true);
  1336. /* Switch oscillator */
  1337. CMU->CMD = CMU_CMD_USBCCLKSEL_LFRCO;
  1338. /* Wait until clock is activated */
  1339. while((CMU->STATUS & CMU_STATUS_USBCLFRCOSEL)==0);
  1340. break;
  1341. default:
  1342. /* Illegal clock source for USB */
  1343. EFM_ASSERT(0);
  1344. return;
  1345. }
  1346. /* Wait until clock has been activated */
  1347. break;
  1348. #endif
  1349. default:
  1350. EFM_ASSERT(0);
  1351. break;
  1352. }
  1353. }
  1354. /**************************************************************************//**
  1355. * @brief
  1356. * CMU low frequency register synchronization freeze control.
  1357. *
  1358. * @details
  1359. * Some CMU registers requires synchronization into the low frequency (LF)
  1360. * domain. The freeze feature allows for several such registers to be
  1361. * modified before passing them to the LF domain simultaneously (which
  1362. * takes place when the freeze mode is disabled).
  1363. *
  1364. * Another usage scenario of this feature, is when using an API (such
  1365. * as the CMU API) for modifying several bit fields consecutively in the
  1366. * same register. If freeze mode is enabled during this sequence, stalling
  1367. * can be avoided.
  1368. *
  1369. * @note
  1370. * When enabling freeze mode, this function will wait for all current
  1371. * ongoing CMU synchronization to LF domain to complete (Normally
  1372. * synchronization will not be in progress.) However for this reason, when
  1373. * using freeze mode, modifications of registers requiring LF synchronization
  1374. * should be done within one freeze enable/disable block to avoid unecessary
  1375. * stalling.
  1376. *
  1377. * @param[in] enable
  1378. * @li true - enable freeze, modified registers are not propagated to the
  1379. * LF domain
  1380. * @li false - disable freeze, modified registers are propagated to LF
  1381. * domain
  1382. *****************************************************************************/
  1383. void CMU_FreezeEnable(bool enable)
  1384. {
  1385. if (enable)
  1386. {
  1387. /* Wait for any ongoing LF synchronization to complete. This is just to */
  1388. /* protect against the rare case when a user */
  1389. /* - modifies a register requiring LF sync */
  1390. /* - then enables freeze before LF sync completed */
  1391. /* - then modifies the same register again */
  1392. /* since modifying a register while it is in sync progress should be */
  1393. /* avoided. */
  1394. while (CMU->SYNCBUSY)
  1395. ;
  1396. CMU->FREEZE = CMU_FREEZE_REGFREEZE;
  1397. }
  1398. else
  1399. {
  1400. CMU->FREEZE = 0;
  1401. }
  1402. }
  1403. #if defined(_EFM32_TINY_FAMILY) || defined(_EFM32_GIANT_FAMILY)
  1404. /***************************************************************************//**
  1405. * @brief
  1406. * Get AUXHFRCO band in use.
  1407. *
  1408. * @return
  1409. * AUXHFRCO band in use.
  1410. ******************************************************************************/
  1411. CMU_AUXHFRCOBand_TypeDef CMU_AUXHFRCOBandGet(void)
  1412. {
  1413. return (CMU_AUXHFRCOBand_TypeDef)((CMU->AUXHFRCOCTRL & _CMU_AUXHFRCOCTRL_BAND_MASK) >>
  1414. _CMU_AUXHFRCOCTRL_BAND_SHIFT);
  1415. }
  1416. /***************************************************************************//**
  1417. * @brief
  1418. * Set AUIXHFRCO band and the tuning value based on the value in the
  1419. * calibration table made during production.
  1420. *
  1421. * @param[in] band
  1422. * AUXHFRCO band to activate.
  1423. ******************************************************************************/
  1424. void CMU_AUXHFRCOBandSet(CMU_AUXHFRCOBand_TypeDef band)
  1425. {
  1426. uint32_t tuning;
  1427. /* Read tuning value from calibration table */
  1428. switch (band)
  1429. {
  1430. case cmuAUXHFRCOBand_1MHz:
  1431. tuning = (DEVINFO->AUXHFRCOCAL0 & _DEVINFO_AUXHFRCOCAL0_BAND1_MASK) >>
  1432. _DEVINFO_AUXHFRCOCAL0_BAND1_SHIFT;
  1433. break;
  1434. case cmuAUXHFRCOBand_7MHz:
  1435. tuning = (DEVINFO->AUXHFRCOCAL0 & _DEVINFO_AUXHFRCOCAL0_BAND7_MASK) >>
  1436. _DEVINFO_AUXHFRCOCAL0_BAND7_SHIFT;
  1437. break;
  1438. case cmuAUXHFRCOBand_11MHz:
  1439. tuning = (DEVINFO->AUXHFRCOCAL0 & _DEVINFO_AUXHFRCOCAL0_BAND11_MASK) >>
  1440. _DEVINFO_AUXHFRCOCAL0_BAND11_SHIFT;
  1441. break;
  1442. case cmuAUXHFRCOBand_14MHz:
  1443. tuning = (DEVINFO->AUXHFRCOCAL0 & _DEVINFO_AUXHFRCOCAL0_BAND14_MASK) >>
  1444. _DEVINFO_AUXHFRCOCAL0_BAND14_SHIFT;
  1445. break;
  1446. case cmuAUXHFRCOBand_21MHz:
  1447. tuning = (DEVINFO->AUXHFRCOCAL1 & _DEVINFO_AUXHFRCOCAL1_BAND21_MASK) >>
  1448. _DEVINFO_AUXHFRCOCAL1_BAND21_SHIFT;
  1449. break;
  1450. case cmuAUXHFRCOBand_28MHz:
  1451. tuning = (DEVINFO->AUXHFRCOCAL1 & _DEVINFO_AUXHFRCOCAL1_BAND28_MASK) >>
  1452. _DEVINFO_AUXHFRCOCAL1_BAND28_SHIFT;
  1453. break;
  1454. default:
  1455. EFM_ASSERT(0);
  1456. return;
  1457. }
  1458. /* Set band/tuning */
  1459. CMU->AUXHFRCOCTRL = (CMU->AUXHFRCOCTRL &
  1460. ~(_CMU_AUXHFRCOCTRL_BAND_MASK | _CMU_AUXHFRCOCTRL_TUNING_MASK)) |
  1461. (band << _CMU_AUXHFRCOCTRL_BAND_SHIFT) |
  1462. (tuning << _CMU_AUXHFRCOCTRL_TUNING_SHIFT);
  1463. }
  1464. #endif
  1465. /***************************************************************************//**
  1466. * @brief
  1467. * Get HFRCO band in use.
  1468. *
  1469. * @return
  1470. * HFRCO band in use.
  1471. ******************************************************************************/
  1472. CMU_HFRCOBand_TypeDef CMU_HFRCOBandGet(void)
  1473. {
  1474. return (CMU_HFRCOBand_TypeDef)((CMU->HFRCOCTRL & _CMU_HFRCOCTRL_BAND_MASK) >>
  1475. _CMU_HFRCOCTRL_BAND_SHIFT);
  1476. }
  1477. /***************************************************************************//**
  1478. * @brief
  1479. * Set HFRCO band and the tuning value based on the value in the calibration
  1480. * table made during production.
  1481. *
  1482. * @param[in] band
  1483. * HFRCO band to activate.
  1484. ******************************************************************************/
  1485. void CMU_HFRCOBandSet(CMU_HFRCOBand_TypeDef band)
  1486. {
  1487. uint32_t tuning;
  1488. uint32_t freq;
  1489. CMU_Select_TypeDef osc;
  1490. /* Read tuning value from calibration table */
  1491. switch (band)
  1492. {
  1493. case cmuHFRCOBand_1MHz:
  1494. tuning = (DEVINFO->HFRCOCAL0 & _DEVINFO_HFRCOCAL0_BAND1_MASK) >>
  1495. _DEVINFO_HFRCOCAL0_BAND1_SHIFT;
  1496. break;
  1497. case cmuHFRCOBand_7MHz:
  1498. tuning = (DEVINFO->HFRCOCAL0 & _DEVINFO_HFRCOCAL0_BAND7_MASK) >>
  1499. _DEVINFO_HFRCOCAL0_BAND7_SHIFT;
  1500. break;
  1501. case cmuHFRCOBand_11MHz:
  1502. tuning = (DEVINFO->HFRCOCAL0 & _DEVINFO_HFRCOCAL0_BAND11_MASK) >>
  1503. _DEVINFO_HFRCOCAL0_BAND11_SHIFT;
  1504. break;
  1505. case cmuHFRCOBand_14MHz:
  1506. tuning = (DEVINFO->HFRCOCAL0 & _DEVINFO_HFRCOCAL0_BAND14_MASK) >>
  1507. _DEVINFO_HFRCOCAL0_BAND14_SHIFT;
  1508. break;
  1509. case cmuHFRCOBand_21MHz:
  1510. tuning = (DEVINFO->HFRCOCAL1 & _DEVINFO_HFRCOCAL1_BAND21_MASK) >>
  1511. _DEVINFO_HFRCOCAL1_BAND21_SHIFT;
  1512. break;
  1513. case cmuHFRCOBand_28MHz:
  1514. tuning = (DEVINFO->HFRCOCAL1 & _DEVINFO_HFRCOCAL1_BAND28_MASK) >>
  1515. _DEVINFO_HFRCOCAL1_BAND28_SHIFT;
  1516. break;
  1517. default:
  1518. EFM_ASSERT(0);
  1519. return;
  1520. }
  1521. /* If HFRCO is used for core clock, we have to consider flash access WS. */
  1522. osc = CMU_ClockSelectGet(cmuClock_HF);
  1523. if (osc == cmuSelect_HFRCO)
  1524. {
  1525. /* Configure worst case wait states for flash access before setting divider */
  1526. CMU_FlashWaitStateMax();
  1527. }
  1528. /* Set band/tuning */
  1529. CMU->HFRCOCTRL = (CMU->HFRCOCTRL &
  1530. ~(_CMU_HFRCOCTRL_BAND_MASK | _CMU_HFRCOCTRL_TUNING_MASK)) |
  1531. (band << _CMU_HFRCOCTRL_BAND_SHIFT) |
  1532. (tuning << _CMU_HFRCOCTRL_TUNING_SHIFT);
  1533. /* If HFRCO is used for core clock, optimize flash WS */
  1534. if (osc == cmuSelect_HFRCO)
  1535. {
  1536. /* Update CMSIS core clock variable and get current core clock */
  1537. /* (The function will update the global variable) */
  1538. /* NOTE! We need at least 21 cycles before setting zero wait state to flash */
  1539. /* (i.e. WS0) when going from the 28MHz to 1MHz in the HFRCO band */
  1540. freq = SystemCoreClockGet();
  1541. /* Optimize flash access wait state setting for current core clk */
  1542. CMU_FlashWaitStateControl(freq);
  1543. }
  1544. }
  1545. /***************************************************************************//**
  1546. * @brief
  1547. * Get the HFRCO startup delay.
  1548. *
  1549. * @details
  1550. * Please refer to the reference manual for further details.
  1551. *
  1552. * @return
  1553. * The startup delay in use.
  1554. ******************************************************************************/
  1555. uint32_t CMU_HFRCOStartupDelayGet(void)
  1556. {
  1557. return((CMU->HFRCOCTRL & _CMU_HFRCOCTRL_SUDELAY_MASK) >>
  1558. _CMU_HFRCOCTRL_SUDELAY_SHIFT);
  1559. }
  1560. /***************************************************************************//**
  1561. * @brief
  1562. * Set the HFRCO startup delay.
  1563. *
  1564. * @details
  1565. * Please refer to the reference manual for further details.
  1566. *
  1567. * @param[in] delay
  1568. * The startup delay to set (<= 31).
  1569. ******************************************************************************/
  1570. void CMU_HFRCOStartupDelaySet(uint32_t delay)
  1571. {
  1572. EFM_ASSERT(delay <= 31);
  1573. delay &= (_CMU_HFRCOCTRL_SUDELAY_MASK >> _CMU_HFRCOCTRL_SUDELAY_SHIFT);
  1574. CMU->HFRCOCTRL = (CMU->HFRCOCTRL & ~(_CMU_HFRCOCTRL_SUDELAY_MASK)) |
  1575. (delay << _CMU_HFRCOCTRL_SUDELAY_SHIFT);
  1576. }
  1577. /***************************************************************************//**
  1578. * @brief
  1579. * Get the LCD framerate divisor (FDIV) setting.
  1580. *
  1581. * @return
  1582. * The LCD framerate divisor.
  1583. ******************************************************************************/
  1584. uint32_t CMU_LCDClkFDIVGet(void)
  1585. {
  1586. #if defined(LCD_PRESENT)
  1587. return((CMU->LCDCTRL & _CMU_LCDCTRL_FDIV_MASK) >> _CMU_LCDCTRL_FDIV_SHIFT);
  1588. #else
  1589. return 0;
  1590. #endif /* defined(LCD_PRESENT) */
  1591. }
  1592. /***************************************************************************//**
  1593. * @brief
  1594. * Set the LCD framerate divisor (FDIV) setting.
  1595. *
  1596. * @note
  1597. * The FDIV field (CMU LCDCTRL register) should only be modified while the
  1598. * LCD module is clock disabled (CMU LFACLKEN0.LCD bit is 0). This function
  1599. * will NOT modify FDIV if the LCD module clock is enabled. Please refer to
  1600. * CMU_ClockEnable() for disabling/enabling LCD clock.
  1601. *
  1602. * @param[in] div
  1603. * The FDIV setting to use.
  1604. ******************************************************************************/
  1605. void CMU_LCDClkFDIVSet(uint32_t div)
  1606. {
  1607. #if defined(LCD_PRESENT)
  1608. EFM_ASSERT(div <= cmuClkDiv_128);
  1609. /* Do not allow modification if LCD clock enabled */
  1610. if (CMU->LFACLKEN0 & CMU_LFACLKEN0_LCD)
  1611. {
  1612. return;
  1613. }
  1614. div <<= _CMU_LCDCTRL_FDIV_SHIFT;
  1615. div &= _CMU_LCDCTRL_FDIV_MASK;
  1616. CMU->LCDCTRL = (CMU->LCDCTRL & ~_CMU_LCDCTRL_FDIV_MASK) | div;
  1617. #else
  1618. (void)div; /* Unused parameter */
  1619. #endif /* defined(LCD_PRESENT) */
  1620. }
  1621. /***************************************************************************//**
  1622. * @brief
  1623. * Enable/disable oscillator.
  1624. *
  1625. * @param[in] osc
  1626. * The oscillator to enable/disable.
  1627. *
  1628. * @param[in] enable
  1629. * @li true - enable specified oscillator.
  1630. * @li false - disable specified oscillator.
  1631. *
  1632. * @param[in] wait
  1633. * Only used if @p enable is true.
  1634. * @li true - wait for oscillator start-up time to timeout before returning.
  1635. * @li false - do not wait for oscillator start-up time to timeout before
  1636. * returning.
  1637. ******************************************************************************/
  1638. void CMU_OscillatorEnable(CMU_Osc_TypeDef osc, bool enable, bool wait)
  1639. {
  1640. uint32_t status;
  1641. uint32_t enBit;
  1642. uint32_t disBit;
  1643. switch (osc)
  1644. {
  1645. case cmuOsc_HFRCO:
  1646. enBit = CMU_OSCENCMD_HFRCOEN;
  1647. disBit = CMU_OSCENCMD_HFRCODIS;
  1648. status = CMU_STATUS_HFRCORDY;
  1649. break;
  1650. case cmuOsc_HFXO:
  1651. enBit = CMU_OSCENCMD_HFXOEN;
  1652. disBit = CMU_OSCENCMD_HFXODIS;
  1653. status = CMU_STATUS_HFXORDY;
  1654. break;
  1655. case cmuOsc_AUXHFRCO:
  1656. enBit = CMU_OSCENCMD_AUXHFRCOEN;
  1657. disBit = CMU_OSCENCMD_AUXHFRCODIS;
  1658. status = CMU_STATUS_AUXHFRCORDY;
  1659. break;
  1660. case cmuOsc_LFRCO:
  1661. enBit = CMU_OSCENCMD_LFRCOEN;
  1662. disBit = CMU_OSCENCMD_LFRCODIS;
  1663. status = CMU_STATUS_LFRCORDY;
  1664. break;
  1665. case cmuOsc_LFXO:
  1666. enBit = CMU_OSCENCMD_LFXOEN;
  1667. disBit = CMU_OSCENCMD_LFXODIS;
  1668. status = CMU_STATUS_LFXORDY;
  1669. break;
  1670. #if defined _CMU_LFCLKSEL_LFAE_ULFRCO
  1671. case cmuOsc_ULFRCO:
  1672. /* ULFRCO is always enabled, and cannot be turned off */
  1673. return;
  1674. #endif
  1675. default:
  1676. /* Undefined clock source */
  1677. EFM_ASSERT(0);
  1678. return;
  1679. }
  1680. if (enable)
  1681. {
  1682. CMU->OSCENCMD = enBit;
  1683. /* Wait for clock to stabilize if requested */
  1684. if (wait)
  1685. {
  1686. while (!(CMU->STATUS & status))
  1687. ;
  1688. }
  1689. }
  1690. else
  1691. {
  1692. CMU->OSCENCMD = disBit;
  1693. }
  1694. /* Keep EMU module informed */
  1695. EMU_UpdateOscConfig();
  1696. }
  1697. /***************************************************************************//**
  1698. * @brief
  1699. * Get oscillator frequency tuning setting.
  1700. *
  1701. * @param[in] osc
  1702. * Oscillator to get tuning value for, one of:
  1703. * @li #cmuOsc_LFRCO
  1704. * @li #cmuOsc_HFRCO
  1705. * @li #cmuOsc_AUXHFRCO
  1706. *
  1707. * @return
  1708. * The oscillator frequency tuning setting in use.
  1709. ******************************************************************************/
  1710. uint32_t CMU_OscillatorTuningGet(CMU_Osc_TypeDef osc)
  1711. {
  1712. uint32_t ret;
  1713. switch (osc)
  1714. {
  1715. case cmuOsc_LFRCO:
  1716. ret = (CMU->LFRCOCTRL & _CMU_LFRCOCTRL_TUNING_MASK) >>
  1717. _CMU_LFRCOCTRL_TUNING_SHIFT;
  1718. break;
  1719. case cmuOsc_HFRCO:
  1720. ret = (CMU->HFRCOCTRL & _CMU_HFRCOCTRL_TUNING_MASK) >>
  1721. _CMU_HFRCOCTRL_TUNING_SHIFT;
  1722. break;
  1723. case cmuOsc_AUXHFRCO:
  1724. ret = (CMU->AUXHFRCOCTRL & _CMU_AUXHFRCOCTRL_TUNING_MASK) >>
  1725. _CMU_AUXHFRCOCTRL_TUNING_SHIFT;
  1726. break;
  1727. default:
  1728. EFM_ASSERT(0);
  1729. ret = 0;
  1730. break;
  1731. }
  1732. return(ret);
  1733. }
  1734. /***************************************************************************//**
  1735. * @brief
  1736. * Set the oscillator frequency tuning control.
  1737. *
  1738. * @note
  1739. * Oscillator tuning is done during production, and the tuning value is
  1740. * automatically loaded after a reset. Changing the tuning value from the
  1741. * calibrated value is for more advanced use.
  1742. *
  1743. * @param[in] osc
  1744. * Oscillator to set tuning value for, one of:
  1745. * @li #cmuOsc_LFRCO
  1746. * @li #cmuOsc_HFRCO
  1747. * @li #cmuOsc_AUXHFRCO
  1748. *
  1749. * @param[in] val
  1750. * The oscillator frequency tuning setting to use.
  1751. ******************************************************************************/
  1752. void CMU_OscillatorTuningSet(CMU_Osc_TypeDef osc, uint32_t val)
  1753. {
  1754. switch (osc)
  1755. {
  1756. case cmuOsc_LFRCO:
  1757. EFM_ASSERT(val <= (_CMU_LFRCOCTRL_TUNING_MASK >> _CMU_LFRCOCTRL_TUNING_SHIFT));
  1758. val &= (_CMU_LFRCOCTRL_TUNING_MASK >> _CMU_LFRCOCTRL_TUNING_SHIFT);
  1759. CMU->LFRCOCTRL = (CMU->LFRCOCTRL & ~(_CMU_LFRCOCTRL_TUNING_MASK)) |
  1760. (val << _CMU_LFRCOCTRL_TUNING_SHIFT);
  1761. break;
  1762. case cmuOsc_HFRCO:
  1763. EFM_ASSERT(val <= (_CMU_HFRCOCTRL_TUNING_MASK >> _CMU_HFRCOCTRL_TUNING_SHIFT));
  1764. val &= (_CMU_HFRCOCTRL_TUNING_MASK >> _CMU_HFRCOCTRL_TUNING_SHIFT);
  1765. CMU->HFRCOCTRL = (CMU->HFRCOCTRL & ~(_CMU_HFRCOCTRL_TUNING_MASK)) |
  1766. (val << _CMU_HFRCOCTRL_TUNING_SHIFT);
  1767. break;
  1768. case cmuOsc_AUXHFRCO:
  1769. EFM_ASSERT(val <= (_CMU_AUXHFRCOCTRL_TUNING_MASK >> _CMU_AUXHFRCOCTRL_TUNING_SHIFT));
  1770. val <<= _CMU_AUXHFRCOCTRL_TUNING_SHIFT;
  1771. val &= _CMU_AUXHFRCOCTRL_TUNING_MASK;
  1772. CMU->AUXHFRCOCTRL = (CMU->AUXHFRCOCTRL & ~(_CMU_AUXHFRCOCTRL_TUNING_MASK)) | val;
  1773. break;
  1774. default:
  1775. EFM_ASSERT(0);
  1776. break;
  1777. }
  1778. }
  1779. /**************************************************************************//**
  1780. * @brief
  1781. * Determine if currently selected PCNTn clock used is external or LFBCLK.
  1782. *
  1783. * @param[in] inst
  1784. * PCNT instance number to get currently selected clock source for.
  1785. *
  1786. * @return
  1787. * @li true - selected clock is external clock.
  1788. * @li false - selected clock is LFBCLK.
  1789. *****************************************************************************/
  1790. bool CMU_PCNTClockExternalGet(unsigned int inst)
  1791. {
  1792. bool ret;
  1793. uint32_t setting;
  1794. switch (inst)
  1795. {
  1796. #if defined(_CMU_PCNTCTRL_PCNT0CLKEN_MASK)
  1797. case 0:
  1798. setting = CMU->PCNTCTRL & CMU_PCNTCTRL_PCNT0CLKSEL_PCNT0S0;
  1799. break;
  1800. #if defined(_CMU_PCNTCTRL_PCNT1CLKEN_MASK)
  1801. case 1:
  1802. setting = CMU->PCNTCTRL & CMU_PCNTCTRL_PCNT1CLKSEL_PCNT1S0;
  1803. break;
  1804. #if defined(_CMU_PCNTCTRL_PCNT2CLKEN_MASK)
  1805. case 2:
  1806. setting = CMU->PCNTCTRL & CMU_PCNTCTRL_PCNT2CLKSEL_PCNT2S0;
  1807. break;
  1808. #endif
  1809. #endif
  1810. #endif
  1811. default:
  1812. setting = 0;
  1813. break;
  1814. }
  1815. if (setting)
  1816. {
  1817. ret = true;
  1818. }
  1819. else
  1820. {
  1821. ret = false;
  1822. }
  1823. return ret;
  1824. }
  1825. /**************************************************************************//**
  1826. * @brief
  1827. * Select PCNTn clock.
  1828. *
  1829. * @param[in] inst
  1830. * PCNT instance number to set selected clock source for.
  1831. *
  1832. * @param[in] external
  1833. * Set to true to select external clock, false to select LFBCLK.
  1834. *****************************************************************************/
  1835. void CMU_PCNTClockExternalSet(unsigned int inst, bool external)
  1836. {
  1837. #if defined(PCNT_PRESENT)
  1838. uint32_t setting = 0;
  1839. EFM_ASSERT(inst < PCNT_COUNT);
  1840. if (external)
  1841. {
  1842. setting = 1;
  1843. }
  1844. BITBAND_Peripheral(&(CMU->PCNTCTRL), (inst * 2) + 1, setting);
  1845. #else
  1846. (void)inst; /* Unused parameter */
  1847. (void)external; /* Unused parameter */
  1848. #endif
  1849. }
  1850. /** @} (end addtogroup CMU) */
  1851. /** @} (end addtogroup EM_Library) */