Detailed Description

Clock management unit (CMU) Peripheral API.

This module contains functions to control the CMU peripheral of Silicon Labs 32-bit MCUs and SoCs. The CMU controls oscillators and clocks.

Data Structures
struct	CMU_HFXOInit_TypeDef

struct	CMU_LFXOInit_TypeDef

Macros
#define	CMU_AUXHFRCO_MAX cmuAUXHFRCOFreq_38M0Hz

#define	CMU_AUXHFRCO_MIN cmuAUXHFRCOFreq_1M0Hz

#define	CMU_HFRCO_MAX cmuHFRCOFreq_38M0Hz

#define	CMU_HFRCO_MIN cmuHFRCOFreq_1M0Hz

#define	CMU_HFXOINIT_DEFAULT

#define	CMU_HFXOINIT_EXTERNAL_CLOCK

#define	CMU_LFXOINIT_DEFAULT

#define	CMU_LFXOINIT_EXTERNAL_CLOCK

#define	cmuClkDiv_1 1

#define	cmuClkDiv_1024 1024

#define	cmuClkDiv_128 128

#define	cmuClkDiv_16 16

#define	cmuClkDiv_16384 16384

#define	cmuClkDiv_2 2

#define	cmuClkDiv_2048 2048

#define	cmuClkDiv_256 256

#define	cmuClkDiv_32 32

#define	cmuClkDiv_32768 32768

#define	cmuClkDiv_4 4

#define	cmuClkDiv_4096 4096

#define	cmuClkDiv_512 512

#define	cmuClkDiv_64 64

#define	cmuClkDiv_8 8

#define	cmuClkDiv_8192 8192

Typedefs
typedef uint32_t	CMU_ClkDiv_TypeDef

typedef uint32_t	CMU_ClkPresc_TypeDef

Enumerations
enum	CMU_AUXHFRCOFreq_TypeDef { cmuAUXHFRCOFreq_1M0Hz = 1000000U, cmuAUXHFRCOFreq_2M0Hz = 2000000U, cmuAUXHFRCOFreq_4M0Hz = 4000000U, cmuAUXHFRCOFreq_7M0Hz = 7000000U, cmuAUXHFRCOFreq_13M0Hz = 13000000U, cmuAUXHFRCOFreq_16M0Hz = 16000000U, cmuAUXHFRCOFreq_19M0Hz = 19000000U, cmuAUXHFRCOFreq_26M0Hz = 26000000U, cmuAUXHFRCOFreq_32M0Hz = 32000000U, cmuAUXHFRCOFreq_38M0Hz = 38000000U, cmuAUXHFRCOFreq_UserDefined = 0 }

enum	CMU_Clock_TypeDef { cmuClock_HF, cmuClock_DBG, cmuClock_AUX, cmuClock_EXPORT, cmuClock_BUS, cmuClock_CRYPTO, cmuClock_CRYPTO0, cmuClock_CRYPTO1, cmuClock_LDMA, cmuClock_GPCRC, cmuClock_GPIO, cmuClock_HFLE, cmuClock_PRS, cmuClock_HFPER, cmuClock_USART0, cmuClock_USART1, cmuClock_USART2, cmuClock_USART3, cmuClock_TIMER0, cmuClock_TIMER1, cmuClock_WTIMER0, cmuClock_WTIMER1, cmuClock_CRYOTIMER, cmuClock_ACMP0, cmuClock_ACMP1, cmuClock_VDAC0, cmuClock_IDAC0, cmuClock_ADC0, cmuClock_I2C0, cmuClock_I2C1, cmuClock_CSEN_HF, cmuClock_TRNG0, cmuClock_CORE, cmuClock_LFA, cmuClock_LETIMER0, cmuClock_PCNT0, cmuClock_PCNT1, cmuClock_PCNT2, cmuClock_LESENSE, cmuClock_LFB, cmuClock_LEUART0, cmuClock_CSEN_LF, cmuClock_SYSTICK, cmuClock_LFE, cmuClock_RTCC }

enum	CMU_HFRCOFreq_TypeDef { cmuHFRCOFreq_1M0Hz = 1000000U, cmuHFRCOFreq_2M0Hz = 2000000U, cmuHFRCOFreq_4M0Hz = 4000000U, cmuHFRCOFreq_7M0Hz = 7000000U, cmuHFRCOFreq_13M0Hz = 13000000U, cmuHFRCOFreq_16M0Hz = 16000000U, cmuHFRCOFreq_19M0Hz = 19000000U, cmuHFRCOFreq_26M0Hz = 26000000U, cmuHFRCOFreq_32M0Hz = 32000000U, cmuHFRCOFreq_38M0Hz = 38000000U, cmuHFRCOFreq_UserDefined = 0 }

enum	CMU_HFXOTuningMode_TypeDef { cmuHFXOTuningMode_Auto = 0, cmuHFXOTuningMode_ShuntCommand = CMU_CMD_HFXOSHUNTOPTSTART, cmuHFXOTuningMode_PeakShuntCommand }

enum	CMU_Osc_TypeDef { cmuOsc_LFXO, cmuOsc_LFRCO, cmuOsc_HFXO, cmuOsc_HFRCO, cmuOsc_AUXHFRCO, cmuOsc_ULFRCO }

enum	CMU_OscMode_TypeDef { cmuOscMode_Crystal, cmuOscMode_AcCoupled, cmuOscMode_External }

enum	CMU_Select_TypeDef { cmuSelect_Error, cmuSelect_Disabled, cmuSelect_LFXO, cmuSelect_LFRCO, cmuSelect_HFXO, cmuSelect_HFRCO, cmuSelect_HFCLKLE, cmuSelect_AUXHFRCO, cmuSelect_HFCLK, cmuSelect_ULFRCO }

Functions
CMU_AUXHFRCOFreq_TypeDef	CMU_AUXHFRCOBandGet (void)
	Get current AUXHFRCO frequency. More...

void	CMU_AUXHFRCOBandSet (CMU_AUXHFRCOFreq_TypeDef setFreq)
	Set AUXHFRCO calibration for the selected target frequency. More...

static uint32_t	CMU_AUXHFRCODevinfoGet (CMU_AUXHFRCOFreq_TypeDef freq)
	Get a pointer to the AUXHFRCO frequency calibration word in DEVINFO. More...

__STATIC_INLINE CMU_AUXHFRCOFreq_TypeDef	CMU_AUXHFRCOFreqGet (void)
	Get current AUXHFRCO frequency. More...

__STATIC_INLINE void	CMU_AUXHFRCOFreqSet (CMU_AUXHFRCOFreq_TypeDef setFreq)
	Set AUXHFRCO calibration for the selected target frequency. More...

uint32_t	CMU_Calibrate (uint32_t HFCycles, CMU_Osc_TypeDef ref)
	Calibrate clock. More...

void	CMU_CalibrateConfig (uint32_t downCycles, CMU_Osc_TypeDef downSel, CMU_Osc_TypeDef upSel)
	Configure clock calibration. More...

__STATIC_INLINE void	CMU_CalibrateCont (bool enable)
	Configures continuous calibration mode. More...

uint32_t	CMU_CalibrateCountGet (void)
	Get calibration count register. More...

__STATIC_INLINE void	CMU_CalibrateStart (void)
	Starts calibration. More...

__STATIC_INLINE void	CMU_CalibrateStop (void)
	Stop the calibration counters.

CMU_ClkDiv_TypeDef	CMU_ClockDivGet (CMU_Clock_TypeDef clock)
	Get clock divisor/prescaler. More...

void	CMU_ClockDivSet (CMU_Clock_TypeDef clock, CMU_ClkDiv_TypeDef div)
	Set clock divisor/prescaler. More...

void	CMU_ClockEnable (CMU_Clock_TypeDef clock, bool enable)
	Enable/disable a clock. More...

uint32_t	CMU_ClockFreqGet (CMU_Clock_TypeDef clock)
	Get clock frequency for a clock point. More...

uint32_t	CMU_ClockPrescGet (CMU_Clock_TypeDef clock)
	Get clock prescaler. More...

void	CMU_ClockPrescSet (CMU_Clock_TypeDef clock, CMU_ClkPresc_TypeDef presc)
	Set clock prescaler. More...

CMU_Select_TypeDef	CMU_ClockSelectGet (CMU_Clock_TypeDef clock)
	Get currently selected reference clock used for a clock branch. More...

void	CMU_ClockSelectSet (CMU_Clock_TypeDef clock, CMU_Select_TypeDef ref)
	Select reference clock/oscillator used for a clock branch. More...

__STATIC_INLINE uint32_t	CMU_DivToLog2 (CMU_ClkDiv_TypeDef div)
	Convert dividend to logarithmic value. Only works for even numbers equal to 2^n. More...

void	CMU_FreezeEnable (bool enable)
	CMU low frequency register synchronization freeze control. More...

CMU_HFRCOFreq_TypeDef	CMU_HFRCOBandGet (void)
	Get current HFRCO frequency. More...

void	CMU_HFRCOBandSet (CMU_HFRCOFreq_TypeDef setFreq)
	Set HFRCO calibration for the selected target frequency. More...

static uint32_t	CMU_HFRCODevinfoGet (CMU_HFRCOFreq_TypeDef freq)
	Get a pointer to the HFRCO frequency calibration word in DEVINFO. More...

__STATIC_INLINE CMU_HFRCOFreq_TypeDef	CMU_HFRCOFreqGet (void)
	Get current HFRCO frequency. More...

__STATIC_INLINE void	CMU_HFRCOFreqSet (CMU_HFRCOFreq_TypeDef setFreq)
	Set HFRCO calibration for the selected target frequency. More...

uint32_t	CMU_HFRCOStartupDelayGet (void)

void	CMU_HFRCOStartupDelaySet (uint32_t delay)

void	CMU_HFXOAutostartEnable (uint32_t userSel, bool enEM0EM1Start, bool enEM0EM1StartSel)
	Enable or disable HFXO autostart. More...

void	CMU_HFXOInit (const CMU_HFXOInit_TypeDef *hfxoInit)
	Set HFXO control registers. More...

__STATIC_INLINE void	CMU_IntClear (uint32_t flags)
	Clear one or more pending CMU interrupts. More...

__STATIC_INLINE void	CMU_IntDisable (uint32_t flags)
	Disable one or more CMU interrupts. More...

__STATIC_INLINE void	CMU_IntEnable (uint32_t flags)
	Enable one or more CMU interrupts. More...

__STATIC_INLINE uint32_t	CMU_IntGet (void)
	Get pending CMU interrupts. More...

__STATIC_INLINE uint32_t	CMU_IntGetEnabled (void)
	Get enabled and pending CMU interrupt flags. More...

__STATIC_INLINE void	CMU_IntSet (uint32_t flags)
	Set one or more pending CMU interrupts. More...

uint32_t	CMU_LCDClkFDIVGet (void)
	Get the LCD framerate divisor (FDIV) setting. More...

void	CMU_LCDClkFDIVSet (uint32_t div)
	Set the LCD framerate divisor (FDIV) setting. More...

void	CMU_LFXOInit (const CMU_LFXOInit_TypeDef *lfxoInit)
	Set LFXO control registers. More...

__STATIC_INLINE void	CMU_Lock (void)
	Lock the CMU in order to protect some of its registers against unintended modification. More...

__STATIC_INLINE uint32_t	CMU_Log2ToDiv (uint32_t log2)
	Convert logarithm of 2 prescaler to division factor. More...

void	CMU_OscillatorEnable (CMU_Osc_TypeDef osc, bool enable, bool wait)
	Enable/disable oscillator. More...

uint32_t	CMU_OscillatorTuningGet (CMU_Osc_TypeDef osc)
	Get oscillator frequency tuning setting. More...

bool	CMU_OscillatorTuningOptimize (CMU_Osc_TypeDef osc, CMU_HFXOTuningMode_TypeDef mode, bool wait)
	Start and optionally wait for oscillator tuning optimization. More...

void	CMU_OscillatorTuningSet (CMU_Osc_TypeDef osc, uint32_t val)
	Set the oscillator frequency tuning control. More...

bool	CMU_OscillatorTuningWait (CMU_Osc_TypeDef osc, CMU_HFXOTuningMode_TypeDef mode)
	Wait for oscillator tuning optimization. More...

bool	CMU_PCNTClockExternalGet (unsigned int instance)
	Determine if currently selected PCNTn clock used is external or LFBCLK. More...

void	CMU_PCNTClockExternalSet (unsigned int instance, bool external)
	Select PCNTn clock. More...

__STATIC_INLINE uint32_t	CMU_PrescToLog2 (CMU_ClkPresc_TypeDef presc)
	Convert prescaler dividend to logarithmic value. Only works for even numbers equal to 2^n. More...

__STATIC_INLINE void	CMU_Unlock (void)
	Unlock the CMU so that writing to locked registers again is possible.

Macro Definition Documentation

#define CMU_HFXOINIT_DEFAULT

Value:

{                                                                               \
  true,         /* Low-power mode for EFM32 */                                  \
  false,        /* @deprecated no longer in use */                              \
  false,        /* @deprecated no longer in use */                              \
  false,        /* @deprecated no longer in use */                              \
  _CMU_HFXOSTARTUPCTRL_CTUNE_DEFAULT,                                           \
  _CMU_HFXOSTEADYSTATECTRL_CTUNE_DEFAULT,                                       \
  _CMU_HFXOSTEADYSTATECTRL_REGISH_DEFAULT,                                      \
  0x20,         /* Matching errata fix in CHIP_Init() */                        \
  0x7,          /* Recommended steady-state osc core bias current */            \
  0x6,          /* Recommended peak detection threshold */                      \
  _CMU_HFXOTIMEOUTCTRL_SHUNTOPTTIMEOUT_DEFAULT,                                 \
  0xA,          /* Recommended peak detection timeout  */                       \
  0x4,          /* Recommended steady timeout */                                \
  _CMU_HFXOTIMEOUTCTRL_STARTUPTIMEOUT_DEFAULT,                                  \
  cmuOscMode_Crystal,                                                           \
}

Default HFXO initialization values for Platform 2 devices which contain a separate HFXOCTRL register.

Definition at line 1122 of file em_cmu.h.

#define CMU_HFXOINIT_EXTERNAL_CLOCK

Value:

{                                                                               \
  true,         /* Low-power mode */                                            \
  false,        /* @deprecated no longer in use */                              \
  false,        /* @deprecated no longer in use */                              \
  false,        /* @deprecated no longer in use */                              \
  0,            /* Startup CTUNE=0 recommended for external clock */            \
  0,            /* Steady  CTUNE=0 recommended for external clock */            \
  _CMU_HFXOSTEADYSTATECTRL_REGISH_DEFAULT,                                      \
  0,            /* Startup IBTRIMXOCORE=0 recommended for external clock */     \
  0,            /* Steady  IBTRIMXOCORE=0 recommended for external clock */     \
  0x6,          /* Recommended peak detection threshold */                      \
  _CMU_HFXOTIMEOUTCTRL_SHUNTOPTTIMEOUT_DEFAULT,                                 \
  0x0,          /* Peak-detect not recommended for external clock usage */      \
  _CMU_HFXOTIMEOUTCTRL_STEADYTIMEOUT_2CYCLES,  /* Minimal steady timeout */     \
  _CMU_HFXOTIMEOUTCTRL_STARTUPTIMEOUT_2CYCLES, /* Minimal startup timeout */    \
  cmuOscMode_External,                                                          \
}

Definition at line 1141 of file em_cmu.h.

#define CMU_LFXOINIT_DEFAULT

Value:

{                                                                             \
    _CMU_LFXOCTRL_TUNING_DEFAULT,   /* Default CTUNE value, 0 */                \
    _CMU_LFXOCTRL_GAIN_DEFAULT,     /* Default gain, 2 */                       \
    _CMU_LFXOCTRL_TIMEOUT_DEFAULT,  /* Default start-up delay, 32k cycles */    \
    cmuOscMode_Crystal,             /* Crystal oscillator */                    \
  }

Default LFXO initialization values for platform 2 devices which contain a separate LFXOCTRL register.

Definition at line 1040 of file em_cmu.h.

#define CMU_LFXOINIT_EXTERNAL_CLOCK

Value:

{                                                                             \
    0,                              /* No CTUNE value needed */                 \
    0,                              /* No LFXO startup gain */                  \
    _CMU_LFXOCTRL_TIMEOUT_2CYCLES,  /* Minimal lfxo start-up delay, 2 cycles */ \
    cmuOscMode_External,            /* External digital clock */                \
  }

Definition at line 1047 of file em_cmu.h.

#define cmuClkDiv_1 1

Clock divisors. These values are valid for prescalers. Divide clock by 1.

Definition at line 149 of file em_cmu.h.

Referenced by CAPLESENSE_setupCMU(), CMU_ClockDivGet(), CMU_ClockDivSet(), and RETARGET_SerialInit().

#define cmuClkDiv_1024 1024

Divide clock by 1024.

Definition at line 159 of file em_cmu.h.

#define cmuClkDiv_128 128

Divide clock by 128.

Definition at line 156 of file em_cmu.h.

Referenced by CMU_ClockDivSet(), and CMU_LCDClkFDIVSet().

#define cmuClkDiv_16 16

Divide clock by 16.

Definition at line 153 of file em_cmu.h.

Referenced by CMU_ClockDivGet(), CMU_ClockDivSet(), and CMU_ClockFreqGet().

#define cmuClkDiv_16384 16384

Divide clock by 16384.

Definition at line 163 of file em_cmu.h.

#define cmuClkDiv_2 2

Divide clock by 2.

Definition at line 150 of file em_cmu.h.

#define cmuClkDiv_2048 2048

Divide clock by 2048.

Definition at line 160 of file em_cmu.h.

#define cmuClkDiv_256 256

Divide clock by 256.

Definition at line 157 of file em_cmu.h.

Referenced by UDELAY_Calibrate().

#define cmuClkDiv_32 32

Divide clock by 32.

Definition at line 154 of file em_cmu.h.

#define cmuClkDiv_32768 32768

Divide clock by 32768.

Definition at line 164 of file em_cmu.h.

Referenced by CMU_ClockDivSet().

#define cmuClkDiv_4 4

Divide clock by 4.

Definition at line 151 of file em_cmu.h.

#define cmuClkDiv_4096 4096

Divide clock by 4096.

Definition at line 161 of file em_cmu.h.

#define cmuClkDiv_512 512

Divide clock by 512.

Definition at line 158 of file em_cmu.h.

Referenced by CMU_ClockDivSet().

#define cmuClkDiv_64 64

Divide clock by 64.

Definition at line 155 of file em_cmu.h.

#define cmuClkDiv_8 8

Divide clock by 8.

Definition at line 152 of file em_cmu.h.

Referenced by CMU_ClockDivSet().

#define cmuClkDiv_8192 8192

Divide clock by 8192.

Definition at line 162 of file em_cmu.h.

Typedef Documentation

typedef uint32_t CMU_ClkDiv_TypeDef

Clock divider configuration

Definition at line 167 of file em_cmu.h.

typedef uint32_t CMU_ClkPresc_TypeDef

Clockprescaler configuration

Definition at line 171 of file em_cmu.h.

Enumeration Type Documentation

enum CMU_AUXHFRCOFreq_TypeDef

AUX High frequency RCO bands

Enumerator
cmuAUXHFRCOFreq_1M0Hz	1MHz RC band
cmuAUXHFRCOFreq_2M0Hz	2MHz RC band
cmuAUXHFRCOFreq_4M0Hz	4MHz RC band
cmuAUXHFRCOFreq_7M0Hz	7MHz RC band
cmuAUXHFRCOFreq_13M0Hz	13MHz RC band
cmuAUXHFRCOFreq_16M0Hz	16MHz RC band
cmuAUXHFRCOFreq_19M0Hz	19MHz RC band
cmuAUXHFRCOFreq_26M0Hz	26MHz RC band
cmuAUXHFRCOFreq_32M0Hz	32MHz RC band
cmuAUXHFRCOFreq_38M0Hz	38MHz RC band

Definition at line 237 of file em_cmu.h.

enum CMU_Clock_TypeDef

Clock points in CMU. Please refer to CMU overview in reference manual.

Enumerator
cmuClock_HF	High frequency clock
cmuClock_DBG	Debug clock
cmuClock_AUX	AUX clock
cmuClock_EXPORT	Export clock
cmuClock_BUS	High frequency bus clock.
cmuClock_CRYPTO	Cryptography accelerator clock.
cmuClock_CRYPTO0	Cryptography accelerator 0 clock.
cmuClock_CRYPTO1	Cryptography accelerator 1 clock.
cmuClock_LDMA	Direct memory access controller clock.
cmuClock_GPCRC	General purpose cyclic redundancy checksum clock.
cmuClock_GPIO	General purpose input/output clock.
cmuClock_HFLE	Low energy clock divided down from HFBUSCLK.
cmuClock_PRS	Peripheral reflex system clock.
cmuClock_HFPER	High frequency peripheral clock
cmuClock_USART0	Universal sync/async receiver/transmitter 0 clock.
cmuClock_USART1	Universal sync/async receiver/transmitter 1 clock.
cmuClock_USART2	Universal sync/async receiver/transmitter 2 clock.
cmuClock_USART3	Universal sync/async receiver/transmitter 3 clock.
cmuClock_TIMER0	Timer 0 clock.
cmuClock_TIMER1	Timer 1 clock.
cmuClock_WTIMER0	Wide Timer 0 clock.
cmuClock_WTIMER1	Wide Timer 1 clock.
cmuClock_CRYOTIMER	CRYOtimer clock.
cmuClock_ACMP0	Analog comparator 0 clock.
cmuClock_ACMP1	Analog comparator 1 clock.
cmuClock_VDAC0	Voltage digital to analog converter 0 clock.
cmuClock_IDAC0	Current digital to analog converter 0 clock.
cmuClock_ADC0	Analog to digital converter 0 clock.
cmuClock_I2C0	I2C 0 clock.
cmuClock_I2C1	I2C 1 clock.
cmuClock_CSEN_HF	Capacitive Sense HF clock
cmuClock_TRNG0	True random number generator clock
cmuClock_CORE	Core clock
cmuClock_LFA	Low frequency A clock
cmuClock_LETIMER0	Low energy timer 0 clock.
cmuClock_PCNT0	Pulse counter 0 clock.
cmuClock_PCNT1	Pulse counter 1 clock.
cmuClock_PCNT2	Pulse counter 2 clock.
cmuClock_LESENSE	LESENSE clock.
cmuClock_LFB	Low frequency B clock
cmuClock_LEUART0	Low energy universal asynchronous receiver/transmitter 0 clock.
cmuClock_CSEN_LF	Capacitive Sense LF clock.
cmuClock_SYSTICK	Cortex SYSTICK LF clock.
cmuClock_LFE	Low frequency A clock
cmuClock_RTCC	Real time counter and calendar clock.

Definition at line 257 of file em_cmu.h.

enum CMU_HFRCOFreq_TypeDef

High frequency system RCO bands

Enumerator
cmuHFRCOFreq_1M0Hz	1MHz RC band
cmuHFRCOFreq_2M0Hz	2MHz RC band
cmuHFRCOFreq_4M0Hz	4MHz RC band
cmuHFRCOFreq_7M0Hz	7MHz RC band
cmuHFRCOFreq_13M0Hz	13MHz RC band
cmuHFRCOFreq_16M0Hz	16MHz RC band
cmuHFRCOFreq_19M0Hz	19MHz RC band
cmuHFRCOFreq_26M0Hz	26MHz RC band
cmuHFRCOFreq_32M0Hz	32MHz RC band
cmuHFRCOFreq_38M0Hz	38MHz RC band

Definition at line 217 of file em_cmu.h.

enum CMU_HFXOTuningMode_TypeDef

HFXO tuning modes

Enumerator
cmuHFXOTuningMode_ShuntCommand	Run shunt current optimization only
cmuHFXOTuningMode_PeakShuntCommand	Run peak and shunt current optimization

Definition at line 997 of file em_cmu.h.

enum CMU_Osc_TypeDef

Oscillator types.

Enumerator
cmuOsc_LFXO	Low frequency crystal oscillator.
cmuOsc_LFRCO	Low frequency RC oscillator.
cmuOsc_HFXO	High frequency crystal oscillator.
cmuOsc_HFRCO	High frequency RC oscillator.
cmuOsc_AUXHFRCO	Auxiliary high frequency RC oscillator.
cmuOsc_ULFRCO	Ultra low frequency RC oscillator.

Definition at line 935 of file em_cmu.h.

enum CMU_OscMode_TypeDef

Oscillator modes.

Enumerator
cmuOscMode_Crystal	Crystal oscillator.
cmuOscMode_AcCoupled	AC coupled buffer.
cmuOscMode_External	External digital clock.

Definition at line 954 of file em_cmu.h.

enum CMU_Select_TypeDef

Selectable clock sources.

Enumerator
cmuSelect_Error	Usage error.
cmuSelect_Disabled	Clock selector disabled.
cmuSelect_LFXO	Low frequency crystal oscillator.
cmuSelect_LFRCO	Low frequency RC oscillator.
cmuSelect_HFXO	High frequency crystal oscillator.
cmuSelect_HFRCO	High frequency RC oscillator.
cmuSelect_HFCLKLE	High frequency LE clock divided by 2 or 4.
cmuSelect_AUXHFRCO	Auxilliary clock source can be used for debug clock
cmuSelect_HFCLK	Divided HFCLK on Giant for debug clock, undivided on Tiny Gecko and for USBC (not used on Gecko)
cmuSelect_ULFRCO	Ultra low frequency RC oscillator.

Definition at line 962 of file em_cmu.h.

Function Documentation

CMU_AUXHFRCOFreq_TypeDef CMU_AUXHFRCOBandGet ( void )

Get current AUXHFRCO frequency.

Returns: AUXHFRCO frequency

Definition at line 828 of file em_cmu.c.

Referenced by CMU_AUXHFRCOFreqGet().

void CMU_AUXHFRCOBandSet ( CMU_AUXHFRCOFreq_TypeDef setFreq )

Set AUXHFRCO calibration for the selected target frequency.

Parameters

[in] setFreq AUXHFRCO frequency to set

Definition at line 843 of file em_cmu.c.

References _CMU_AUXHFRCOCTRL_CLKDIV_MASK, _CMU_SYNCBUSY_AUXHFRCOBSY_SHIFT, BUS_RegBitRead(), CMU, CMU_AUXHFRCOCTRL_CLKDIV_DIV1, CMU_AUXHFRCOCTRL_CLKDIV_DIV2, CMU_AUXHFRCOCTRL_CLKDIV_DIV4, CMU_AUXHFRCODevinfoGet(), cmuAUXHFRCOFreq_1M0Hz, cmuAUXHFRCOFreq_2M0Hz, and cmuAUXHFRCOFreq_4M0Hz.

Referenced by CMU_AUXHFRCOFreqSet().

static uint32_t CMU_AUXHFRCODevinfoGet ( CMU_AUXHFRCOFreq_TypeDef freq )

static

Get a pointer to the AUXHFRCO frequency calibration word in DEVINFO.

Parameters

[in] freq Frequency in Hz

Returns: AUXHFRCO calibration word for a given frequency

Definition at line 782 of file em_cmu.c.

References cmuAUXHFRCOFreq_13M0Hz, cmuAUXHFRCOFreq_16M0Hz, cmuAUXHFRCOFreq_19M0Hz, cmuAUXHFRCOFreq_1M0Hz, cmuAUXHFRCOFreq_26M0Hz, cmuAUXHFRCOFreq_2M0Hz, cmuAUXHFRCOFreq_32M0Hz, cmuAUXHFRCOFreq_38M0Hz, cmuAUXHFRCOFreq_4M0Hz, cmuAUXHFRCOFreq_7M0Hz, and DEVINFO.

Referenced by CMU_AUXHFRCOBandSet().

__STATIC_INLINE CMU_AUXHFRCOFreq_TypeDef CMU_AUXHFRCOFreqGet ( void )

Get current AUXHFRCO frequency.

Deprecated:: Deprecated function. New code should use CMU_AUXHFRCOBandGet().

Returns: AUXHFRCO frequency

Definition at line 1540 of file em_cmu.h.

References CMU_AUXHFRCOBandGet().

__STATIC_INLINE void CMU_AUXHFRCOFreqSet ( CMU_AUXHFRCOFreq_TypeDef setFreq )

Set AUXHFRCO calibration for the selected target frequency.

Deprecated:: Deprecated function. New code should use CMU_AUXHFRCOBandSet().

Parameters

[in] setFreq AUXHFRCO frequency to set

Definition at line 1556 of file em_cmu.h.

References CMU_AUXHFRCOBandSet().

uint32_t CMU_Calibrate	(	uint32_t	HFCycles,
		CMU_Osc_TypeDef	ref
	)

Calibrate clock.

Run a calibration for HFCLK against a selectable reference clock. Please refer to the reference manual, CMU chapter, for further details.

Note: This function will not return until calibration measurement is completed.

Parameters

[in]	HFCycles	The number of HFCLK cycles to run calibration. Increasing this number increases precision, but the calibration will take more time.
[in]	ref	The reference clock used to compare HFCLK with.

Returns: The number of ticks the reference clock after HFCycles ticks on the HF clock.

Definition at line 904 of file em_cmu.c.

References _CMU_CALCNT_CALCNT_MASK, _CMU_CALCNT_CALCNT_SHIFT, _CMU_STATUS_CALRDY_SHIFT, BUS_RegBitRead(), CMU, CMU_CALCTRL_UPSEL_AUXHFRCO, CMU_CALCTRL_UPSEL_HFRCO, CMU_CALCTRL_UPSEL_HFXO, CMU_CALCTRL_UPSEL_LFRCO, CMU_CALCTRL_UPSEL_LFXO, CMU_CMD_CALSTART, cmuOsc_AUXHFRCO, cmuOsc_HFRCO, cmuOsc_HFXO, cmuOsc_LFRCO, and cmuOsc_LFXO.

void CMU_CalibrateConfig	(	uint32_t	downCycles,
		CMU_Osc_TypeDef	downSel,
		CMU_Osc_TypeDef	upSel
	)

Configure clock calibration.

Configure a calibration for a selectable clock source against another selectable reference clock. Refer to the reference manual, CMU chapter, for further details.

Note: After configuration, a call to CMU_CalibrateStart() is required, and the resulting calibration value can be read out with the CMU_CalibrateCountGet() function call.

Parameters

[in]	downCycles	The number of downSel clock cycles to run calibration. Increasing this number increases precision, but the calibration will take more time.
[in]	downSel	The clock which will be counted down downCycles
[in]	upSel	The reference clock, the number of cycles generated by this clock will be counted and added up, the result can be given with the CMU_CalibrateCountGet() function call.

Definition at line 985 of file em_cmu.c.

References _CMU_CALCNT_CALCNT_MASK, _CMU_CALCNT_CALCNT_SHIFT, _CMU_CALCTRL_DOWNSEL_MASK, _CMU_CALCTRL_UPSEL_MASK, CMU, CMU_CALCTRL_DOWNSEL_AUXHFRCO, CMU_CALCTRL_DOWNSEL_HFRCO, CMU_CALCTRL_DOWNSEL_HFXO, CMU_CALCTRL_DOWNSEL_LFRCO, CMU_CALCTRL_DOWNSEL_LFXO, CMU_CALCTRL_UPSEL_AUXHFRCO, CMU_CALCTRL_UPSEL_HFRCO, CMU_CALCTRL_UPSEL_HFXO, CMU_CALCTRL_UPSEL_LFRCO, CMU_CALCTRL_UPSEL_LFXO, cmuOsc_AUXHFRCO, cmuOsc_HFRCO, cmuOsc_HFXO, cmuOsc_LFRCO, and cmuOsc_LFXO.

__STATIC_INLINE void CMU_CalibrateCont ( bool enable )

Configures continuous calibration mode.

Parameters

[in] enable If true, enables continuous calibration, if false disables continuous calibrartion

Definition at line 1268 of file em_cmu.h.

References _CMU_CALCTRL_CONT_SHIFT, BUS_RegBitWrite(), and CMU.

uint32_t CMU_CalibrateCountGet ( void )

Get calibration count register.

Note: If continuous calibrartion mode is active, calibration busy will almost always be off, and we just need to read the value, where the normal case would be that this function call has been triggered by the CALRDY interrupt flag.

Returns: Calibration count, the number of UPSEL clocks (see CMU_CalibrateConfig) in the period of DOWNSEL oscillator clock cycles configured by a previous write operation to CMU->CALCNT

Definition at line 1072 of file em_cmu.c.

References _CMU_CALCTRL_CONT_SHIFT, _CMU_STATUS_CALRDY_SHIFT, BUS_RegBitRead(), and CMU.

__STATIC_INLINE void CMU_CalibrateStart ( void )

Starts calibration.

Note: This call is usually invoked after CMU_CalibrateConfig() and possibly CMU_CalibrateCont()

Definition at line 1282 of file em_cmu.h.

References CMU, and CMU_CMD_CALSTART.

CMU_ClkDiv_TypeDef CMU_ClockDivGet ( CMU_Clock_TypeDef clock )

Get clock divisor/prescaler.

Parameters

[in] clock Clock point to get divisor/prescaler for. Notice that not all clock points have a divisor/prescaler. Please refer to CMU overview in reference manual.

Returns: The current clock point divisor/prescaler. 1 is returned if clock specifies a clock point without a divisor/prescaler.

Definition at line 1112 of file em_cmu.c.

References _CMU_LFAPRESC0_LESENSE_MASK, _CMU_LFAPRESC0_LESENSE_SHIFT, _CMU_LFAPRESC0_LETIMER0_MASK, _CMU_LFAPRESC0_LETIMER0_SHIFT, _CMU_LFBPRESC0_LEUART0_MASK, _CMU_LFBPRESC0_LEUART0_SHIFT, CMU, CMU_ClockPrescGet(), CMU_DivToLog2(), CMU_Log2ToDiv(), cmuClkDiv_1, cmuClkDiv_16, cmuClock_LESENSE, cmuClock_LETIMER0, and cmuClock_LEUART0.

Referenced by UDELAY_Calibrate().

void CMU_ClockDivSet	(	CMU_Clock_TypeDef	clock,
		CMU_ClkDiv_TypeDef	div
	)

Set clock divisor/prescaler.

Note: If setting a LF clock prescaler, synchronization into the low frequency domain is required. If the same register is modified before a previous update has completed, this function will stall until the previous synchronization has completed. Please refer to CMU_FreezeEnable() for a suggestion on how to reduce stalling time in some use cases.

Parameters

[in]	clock	Clock point to set divisor/prescaler for. Notice that not all clock points have a divisor/prescaler, please refer to CMU overview in the reference manual.
[in]	div	The clock divisor to use (<= cmuClkDiv_512).

Definition at line 1244 of file em_cmu.c.

References _CMU_LFAPRESC0_LESENSE_MASK, _CMU_LFAPRESC0_LESENSE_SHIFT, _CMU_LFAPRESC0_LETIMER0_MASK, _CMU_LFAPRESC0_LETIMER0_SHIFT, _CMU_LFBPRESC0_LEUART0_MASK, _CMU_LFBPRESC0_LEUART0_SHIFT, CMU, CMU_ClockPrescSet(), CMU_DivToLog2(), CMU_SYNCBUSY_LFAPRESC0, CMU_SYNCBUSY_LFBPRESC0, cmuClkDiv_1, cmuClkDiv_128, cmuClkDiv_16, cmuClkDiv_32768, cmuClkDiv_512, cmuClkDiv_8, cmuClock_LESENSE, cmuClock_LETIMER0, cmuClock_LEUART0, SystemCoreClockGet(), and SystemHFClockGet().

Referenced by CAPLESENSE_setupCMU(), RETARGET_SerialInit(), RTCDRV_Init(), SegmentLCD_Init(), UARTDRV_InitLeuart(), and UDELAY_Calibrate().

void CMU_ClockEnable	(	CMU_Clock_TypeDef	clock,
		bool	enable
	)

Enable/disable a clock.

In general, module clocking is disabled after a reset. If a module clock is disabled, the registers of that module are not accessible and reading from such registers may return undefined values. Writing to registers of clock disabled modules have no effect. One should normally avoid accessing module registers of a module with a disabled clock.

Note: If enabling/disabling a LF clock, synchronization into the low frequency domain is required. If the same register is modified before a previous update has completed, this function will stall until the previous synchronization has completed. Please refer to CMU_FreezeEnable() for a suggestion on how to reduce stalling time in some use cases.

Parameters

[in]	clock	The clock to enable/disable. Notice that not all defined clock points have separate enable/disable control, please refer to CMU overview in reference manual.
[in]	enable	true - enable specified clock. false - disable specified clock.

Definition at line 1453 of file em_cmu.c.

References BUS_RegBitWrite(), CMU, CMU_ClockFreqGet(), CMU_SYNCBUSY_LFACLKEN0, CMU_SYNCBUSY_LFBCLKEN0, CMU_SYNCBUSY_LFECLKEN0, and cmuClock_HFLE.

Referenced by adcInit(), BOARD_init(), BSP_BccDeInit(), BSP_BccInit(), BSP_BusControlModeSet(), BSP_EbiInit(), BSP_McuBoard_Init(), CAPLESENSE_setupCMU(), CAPSENSE_Init(), DMADRV_DeInit(), ezradio_hal_GpioInit(), I2CSPM_Init(), ICM20648_spiInit(), LDMA_DeInit(), LDMA_Init(), MIC_init(), MICROSD_Init(), MICROSD_PowerOff(), MICROSD_PowerOn(), MSDD_Init(), RETARGET_SerialInit(), RTCDRV_DeInit(), RTCDRV_Init(), SegmentLCD_Disable(), SegmentLCD_Init(), setupOscillators(), SPI_TFT_Init(), SPIDRV_DeInit(), SPIDRV_Init(), TOUCH_Init(), UARTDRV_DeInit(), UARTDRV_InitLeuart(), UARTDRV_InitUart(), UDELAY_Calibrate(), USTIMER_DeInit(), USTIMER_Init(), VDDCHECK_Disable(), and VDDCHECK_Init().

uint32_t CMU_ClockFreqGet ( CMU_Clock_TypeDef clock )

Get clock frequency for a clock point.

Parameters

[in] clock Clock point to fetch frequency for.

Returns: The current frequency in Hz.

Definition at line 1550 of file em_cmu.c.

References _CMU_HFCOREPRESC_PRESC_MASK, _CMU_HFCOREPRESC_PRESC_SHIFT, _CMU_HFEXPPRESC_PRESC_MASK, _CMU_HFEXPPRESC_PRESC_SHIFT, _CMU_HFPERPRESC_PRESC_MASK, _CMU_HFPERPRESC_PRESC_SHIFT, _CMU_LFAPRESC0_LESENSE_MASK, _CMU_LFAPRESC0_LESENSE_SHIFT, _CMU_LFAPRESC0_LETIMER0_MASK, _CMU_LFAPRESC0_LETIMER0_SHIFT, _CMU_LFBPRESC0_CSEN_MASK, _CMU_LFBPRESC0_CSEN_SHIFT, _CMU_LFBPRESC0_LEUART0_MASK, _CMU_LFBPRESC0_LEUART0_SHIFT, CMU, CMU_DivToLog2(), CMU_Log2ToDiv(), cmuClkDiv_16, cmuClock_LFA, cmuClock_LFB, cmuClock_LFE, SystemCoreClockGet(), and SystemHFClockGet().

Referenced by ADC_PrescaleCalc(), ADC_TimebaseCalc(), BSP_TraceSwoSetup(), CMU_ClockEnable(), CMU_ClockPrescSet(), CMU_ClockSelectSet(), CMU_HFRCOBandSet(), I2C_BusFreqGet(), I2C_BusFreqSet(), LESENSE_ScanFreqSet(), LEUART_BaudrateGet(), LEUART_BaudrateSet(), MIC_init(), MSC_Init(), UARTDRV_InitLeuart(), USART_BaudrateAsyncSet(), USART_BaudrateGet(), USART_BaudrateSyncSet(), USTIMER_Init(), UTIL_init(), and VDAC_PrescaleCalc().

uint32_t CMU_ClockPrescGet ( CMU_Clock_TypeDef clock )

Get clock prescaler.

Parameters

[in] clock Clock point to get the prescaler for. Notice that not all clock points have a prescaler. Please refer to CMU overview in reference manual.

Returns: The prescaler value of the current clock point. 0 is returned if clock specifies a clock point without a prescaler.

Definition at line 1746 of file em_cmu.c.

References _CMU_HFCOREPRESC_PRESC_MASK, _CMU_HFCOREPRESC_PRESC_SHIFT, _CMU_HFEXPPRESC_PRESC_MASK, _CMU_HFEXPPRESC_PRESC_SHIFT, _CMU_HFPERPRESC_PRESC_MASK, _CMU_HFPERPRESC_PRESC_SHIFT, _CMU_HFPRESC_HFCLKLEPRESC_MASK, _CMU_HFPRESC_HFCLKLEPRESC_SHIFT, _CMU_HFPRESC_PRESC_MASK, _CMU_HFPRESC_PRESC_SHIFT, _CMU_LFAPRESC0_LESENSE_MASK, _CMU_LFAPRESC0_LESENSE_SHIFT, _CMU_LFAPRESC0_LETIMER0_MASK, _CMU_LFAPRESC0_LETIMER0_SHIFT, _CMU_LFBPRESC0_CSEN_MASK, _CMU_LFBPRESC0_CSEN_SHIFT, _CMU_LFBPRESC0_LEUART0_MASK, _CMU_LFBPRESC0_LEUART0_SHIFT, _CMU_LFEPRESC0_RTCC_DIV1, CMU, CMU_Log2ToDiv(), cmuClock_CSEN_LF, cmuClock_LESENSE, cmuClock_LETIMER0, cmuClock_LEUART0, and cmuClock_RTCC.

Referenced by CMU_ClockDivGet().

void CMU_ClockPrescSet	(	CMU_Clock_TypeDef	clock,
		CMU_ClkPresc_TypeDef	presc
	)

Set clock prescaler.

Note: If setting a LF clock prescaler, synchronization into the low frequency domain is required. If the same register is modified before a previous update has completed, this function will stall until the previous synchronization has completed. Please refer to CMU_FreezeEnable() for a suggestion on how to reduce stalling time in some use cases.

Parameters

[in]	clock	Clock point to set prescaler for. Notice that not all clock points have a prescaler, please refer to CMU overview in the reference manual.
[in]	presc	The clock prescaler to use.

Definition at line 1894 of file em_cmu.c.

References _CMU_HFCOREPRESC_PRESC_MASK, _CMU_HFCOREPRESC_PRESC_SHIFT, _CMU_HFEXPPRESC_PRESC_MASK, _CMU_HFEXPPRESC_PRESC_SHIFT, _CMU_HFPERPRESC_PRESC_MASK, _CMU_HFPERPRESC_PRESC_SHIFT, _CMU_HFPRESC_HFCLKLEPRESC_MASK, _CMU_HFPRESC_HFCLKLEPRESC_SHIFT, _CMU_HFPRESC_PRESC_MASK, _CMU_HFPRESC_PRESC_SHIFT, _CMU_LFAPRESC0_LESENSE_MASK, _CMU_LFAPRESC0_LESENSE_SHIFT, _CMU_LFAPRESC0_LETIMER0_MASK, _CMU_LFAPRESC0_LETIMER0_SHIFT, _CMU_LFBPRESC0_CSEN_MASK, _CMU_LFBPRESC0_CSEN_SHIFT, _CMU_LFBPRESC0_LEUART0_MASK, _CMU_LFBPRESC0_LEUART0_SHIFT, _CMU_LFEPRESC0_RTCC_MASK, _CMU_LFEPRESC0_RTCC_SHIFT, CMU, CMU_ClockFreqGet(), CMU_PrescToLog2(), CMU_SYNCBUSY_LFAPRESC0, CMU_SYNCBUSY_LFBPRESC0, CMU_SYNCBUSY_LFEPRESC0, cmuClock_CSEN_LF, cmuClock_HFLE, cmuClock_LESENSE, cmuClock_LETIMER0, cmuClock_LEUART0, cmuClock_RTCC, and SystemCoreClockGet().

Referenced by CMU_ClockDivSet().

CMU_Select_TypeDef CMU_ClockSelectGet ( CMU_Clock_TypeDef clock )

Get currently selected reference clock used for a clock branch.

Parameters

[in]

clock

Clock branch to fetch selected ref. clock for. One of:

Returns: Reference clock used for clocking selected branch, cmuSelect_Error if invalid clock provided.

Definition at line 2146 of file em_cmu.c.

References _CMU_DBGCLKSEL_DBG_MASK, _CMU_HFCLKSTATUS_SELECTED_MASK, _CMU_LFACLKSEL_LFA_MASK, _CMU_LFBCLKSEL_LFB_MASK, _CMU_LFECLKSEL_LFE_MASK, CMU, CMU_DBGCLKSEL_DBG_AUXHFRCO, CMU_DBGCLKSEL_DBG_HFCLK, CMU_HFCLKSTATUS_SELECTED_HFXO, CMU_HFCLKSTATUS_SELECTED_LFRCO, CMU_HFCLKSTATUS_SELECTED_LFXO, CMU_LFACLKSEL_LFA_LFRCO, CMU_LFACLKSEL_LFA_LFXO, CMU_LFACLKSEL_LFA_ULFRCO, CMU_LFBCLKSEL_LFB_HFCLKLE, CMU_LFBCLKSEL_LFB_LFRCO, CMU_LFBCLKSEL_LFB_LFXO, CMU_LFBCLKSEL_LFB_ULFRCO, CMU_LFECLKSEL_LFE_LFRCO, CMU_LFECLKSEL_LFE_LFXO, CMU_LFECLKSEL_LFE_ULFRCO, cmuSelect_AUXHFRCO, cmuSelect_Disabled, cmuSelect_Error, cmuSelect_HFCLK, cmuSelect_HFCLKLE, cmuSelect_HFRCO, cmuSelect_HFXO, cmuSelect_LFRCO, cmuSelect_LFXO, and cmuSelect_ULFRCO.

Referenced by CMU_HFRCOBandSet(), CMU_HFXOInit(), CMU_LFXOInit(), and UDELAY_Calibrate().

void CMU_ClockSelectSet	(	CMU_Clock_TypeDef	clock,
		CMU_Select_TypeDef	ref
	)

Select reference clock/oscillator used for a clock branch.

Notice that if a selected reference is not enabled prior to selecting its use, it will be enabled, and this function will wait for the selected oscillator to be stable. It will however NOT be disabled if another reference clock is selected later.

This feature is particularly important if selecting a new reference clock for the clock branch clocking the core, otherwise the system may halt.

Parameters

[in]	clock	Clock branch to select reference clock for. One of: cmuClock_HF cmuClock_LFA cmuClock_LFB cmuClock_DBG
[in]	ref	Reference selected for clocking, please refer to reference manual for for details on which reference is available for a specific clock branch. cmuSelect_HFRCO cmuSelect_LFRCO cmuSelect_HFXO cmuSelect_LFXO cmuSelect_HFCLKLE cmuSelect_AUXHFRCO cmuSelect_HFCLK cmuSelect_ULFRCO #cmuSelect_PLFRCO

Definition at line 2521 of file em_cmu.c.

References _CMU_HFBUSCLKEN0_LE_SHIFT, _CMU_LFACLKSEL_LFA_DISABLED, _CMU_LFACLKSEL_LFA_LFRCO, _CMU_LFACLKSEL_LFA_LFXO, _CMU_LFACLKSEL_LFA_ULFRCO, _CMU_LFBCLKSEL_LFB_HFCLKLE, BUS_RegBitWrite(), CMU, CMU_ClockFreqGet(), CMU_DBGCLKSEL_DBG_AUXHFRCO, CMU_DBGCLKSEL_DBG_HFCLK, CMU_HFCLKSEL_HF_HFRCO, CMU_HFCLKSEL_HF_HFXO, CMU_HFCLKSEL_HF_LFRCO, CMU_HFCLKSEL_HF_LFXO, CMU_HFRCOBandGet(), CMU_OscillatorEnable(), cmuClock_HF, cmuClock_HFLE, cmuOsc_HFRCO, cmuOsc_HFXO, cmuOsc_LFRCO, cmuOsc_LFXO, cmuSelect_AUXHFRCO, cmuSelect_Disabled, cmuSelect_HFCLK, cmuSelect_HFCLKLE, cmuSelect_HFRCO, cmuSelect_HFXO, cmuSelect_LFRCO, cmuSelect_LFXO, cmuSelect_ULFRCO, EMU_VScaleEM01ByClock(), EMU_VScaleWait(), SystemCoreClockGet(), and SystemHFXOClockGet().

Referenced by BSP_BccInit(), CAPLESENSE_setupCMU(), MIC_init(), RETARGET_SerialInit(), RTCDRV_Init(), SegmentLCD_Init(), setupOscillators(), UARTDRV_InitLeuart(), and UDELAY_Calibrate().

__STATIC_INLINE uint32_t CMU_DivToLog2 ( CMU_ClkDiv_TypeDef div )

Convert dividend to logarithmic value. Only works for even numbers equal to 2^n.

Parameters

[in] div Unscaled dividend.

Returns: Logarithm of 2, as used by fixed prescalers.

Definition at line 1311 of file em_cmu.h.

Referenced by CMU_ClockDivGet(), CMU_ClockDivSet(), CMU_ClockFreqGet(), and RTCDRV_Init().

void CMU_FreezeEnable ( bool enable )

CMU low frequency register synchronization freeze control.

Some CMU registers requires synchronization into the low frequency (LF) domain. The freeze feature allows for several such registers to be modified before passing them to the LF domain simultaneously (which takes place when the freeze mode is disabled).

Another usage scenario of this feature, is when using an API (such as the CMU API) for modifying several bit fields consecutively in the same register. If freeze mode is enabled during this sequence, stalling can be avoided.

Note: When enabling freeze mode, this function will wait for all current ongoing CMU synchronization to LF domain to complete (Normally synchronization will not be in progress.) However for this reason, when using freeze mode, modifications of registers requiring LF synchronization should be done within one freeze enable/disable block to avoid unecessary stalling.

Parameters

[in]

enable

true - enable freeze, modified registers are not propagated to the LF domain
false - disable freeze, modified registers are propagated to LF domain

Definition at line 3000 of file em_cmu.c.

References CMU, and CMU_FREEZE_REGFREEZE.

CMU_HFRCOFreq_TypeDef CMU_HFRCOBandGet ( void )

Get current HFRCO frequency.

Returns: HFRCO frequency

Definition at line 3181 of file em_cmu.c.

References SystemHfrcoFreq.

Referenced by CMU_ClockSelectSet(), and CMU_HFRCOFreqGet().

void CMU_HFRCOBandSet ( CMU_HFRCOFreq_TypeDef setFreq )

Set HFRCO calibration for the selected target frequency.

Parameters

[in] setFreq HFRCO frequency to set

Definition at line 3194 of file em_cmu.c.

References _CMU_HFRCOCTRL_CLKDIV_MASK, _CMU_SYNCBUSY_HFRCOBSY_SHIFT, BUS_RegBitRead(), CMU, CMU_ClockFreqGet(), CMU_ClockSelectGet(), CMU_HFRCOCTRL_CLKDIV_DIV1, CMU_HFRCOCTRL_CLKDIV_DIV2, CMU_HFRCOCTRL_CLKDIV_DIV4, CMU_HFRCODevinfoGet(), cmuClock_HF, cmuClock_HFLE, cmuHFRCOFreq_1M0Hz, cmuHFRCOFreq_2M0Hz, cmuHFRCOFreq_4M0Hz, cmuSelect_HFRCO, EMU_VScaleEM01ByClock(), SystemCoreClockGet(), and SystemHfrcoFreq.

Referenced by CMU_HFRCOFreqSet().

static uint32_t CMU_HFRCODevinfoGet ( CMU_HFRCOFreq_TypeDef freq )

static

Get a pointer to the HFRCO frequency calibration word in DEVINFO.

Parameters

[in] freq Frequency in Hz

Returns: HFRCO calibration word for a given frequency

Definition at line 3137 of file em_cmu.c.

References cmuHFRCOFreq_13M0Hz, cmuHFRCOFreq_16M0Hz, cmuHFRCOFreq_19M0Hz, cmuHFRCOFreq_1M0Hz, cmuHFRCOFreq_26M0Hz, cmuHFRCOFreq_2M0Hz, cmuHFRCOFreq_32M0Hz, cmuHFRCOFreq_38M0Hz, cmuHFRCOFreq_4M0Hz, cmuHFRCOFreq_7M0Hz, and DEVINFO.

Referenced by CMU_HFRCOBandSet().

__STATIC_INLINE CMU_HFRCOFreq_TypeDef CMU_HFRCOFreqGet ( void )

Get current HFRCO frequency.

Deprecated:: Deprecated function. New code should use CMU_HFRCOBandGet().

Returns: HFRCO frequency

Definition at line 1506 of file em_cmu.h.

References CMU_HFRCOBandGet().

__STATIC_INLINE void CMU_HFRCOFreqSet ( CMU_HFRCOFreq_TypeDef setFreq )

Set HFRCO calibration for the selected target frequency.

Deprecated:: Deprecated function. New code should use CMU_HFRCOBandSet().

Parameters

[in] setFreq HFRCO frequency to set

Definition at line 1522 of file em_cmu.h.

References CMU_HFRCOBandSet().

void CMU_HFXOAutostartEnable	(	uint32_t	userSel,
		bool	enEM0EM1Start,
		bool	enEM0EM1StartSel
	)

Enable or disable HFXO autostart.

Parameters

[in]	userSel	Additional user specified enable bit.
[in]	enEM0EM1Start	If true, HFXO is automatically started upon entering EM0/EM1 entry from EM2/EM3. HFXO selection has to be handled by the user. If false, HFXO is not started automatically when entering EM0/EM1.
[in]	enEM0EM1StartSel	If true, HFXO is automatically started and immediately selected upon entering EM0/EM1 entry from EM2/EM3. Note that this option stalls the use of HFSRCCLK until HFXO becomes ready. If false, HFXO is not started or selected automatically when entering EM0/EM1.

Definition at line 3330 of file em_cmu.c.

References _CMU_HFXOCTRL_AUTOSTARTEM0EM1_MASK, _CMU_HFXOCTRL_AUTOSTARTSELEM0EM1_MASK, CMU, CMU_HFXOCTRL_AUTOSTARTEM0EM1, CMU_HFXOCTRL_AUTOSTARTSELEM0EM1, and SystemHFXOClockGet().

void CMU_HFXOInit ( const CMU_HFXOInit_TypeDef * hfxoInit )

Set HFXO control registers.

Note: HFXO configuration should be obtained from a configuration tool, app note or xtal datasheet. This function disables the HFXO to ensure a valid state before update.

Parameters

[in] hfxoInit HFXO setup parameters

Definition at line 3379 of file em_cmu.c.

__STATIC_INLINE void CMU_IntClear ( uint32_t flags )

Clear one or more pending CMU interrupts.

Parameters

[in] flags CMU interrupt sources to clear.

Definition at line 1332 of file em_cmu.h.

References CMU.

__STATIC_INLINE void CMU_IntDisable ( uint32_t flags )

Disable one or more CMU interrupts.

Parameters

[in] flags CMU interrupt sources to disable.

Definition at line 1345 of file em_cmu.h.

References CMU.

__STATIC_INLINE void CMU_IntEnable ( uint32_t flags )

Enable one or more CMU interrupts.

Note: Depending on the use, a pending interrupt may already be set prior to enabling the interrupt. Consider using CMU_IntClear() prior to enabling if such a pending interrupt should be ignored.

Parameters

[in] flags CMU interrupt sources to enable.

Definition at line 1363 of file em_cmu.h.

References CMU.

__STATIC_INLINE uint32_t CMU_IntGet ( void )

Get pending CMU interrupts.

Returns: CMU interrupt sources pending.

Definition at line 1376 of file em_cmu.h.

References CMU.

__STATIC_INLINE uint32_t CMU_IntGetEnabled ( void )

Get enabled and pending CMU interrupt flags.

Useful for handling more interrupt sources in the same interrupt handler.

Note: The event bits are not cleared by the use of this function.

Returns

Pending and enabled CMU interrupt sources The return value is the bitwise AND of

the enabled interrupt sources in CMU_IEN and
the pending interrupt flags CMU_IF

Definition at line 1398 of file em_cmu.h.

References CMU.

__STATIC_INLINE void CMU_IntSet ( uint32_t flags )

Set one or more pending CMU interrupts.

Parameters

[in] flags CMU interrupt sources to set to pending.

Definition at line 1414 of file em_cmu.h.

References CMU.

uint32_t CMU_LCDClkFDIVGet ( void )

Get the LCD framerate divisor (FDIV) setting.

Returns: The LCD framerate divisor.

Definition at line 3479 of file em_cmu.c.

References CMU.

void CMU_LCDClkFDIVSet ( uint32_t div )

Set the LCD framerate divisor (FDIV) setting.

Note: The FDIV field (CMU LCDCTRL register) should only be modified while the LCD module is clock disabled (CMU LFACLKEN0.LCD bit is 0). This function will NOT modify FDIV if the LCD module clock is enabled. Please refer to CMU_ClockEnable() for disabling/enabling LCD clock.

Parameters

[in] div The FDIV setting to use.

Definition at line 3502 of file em_cmu.c.

References CMU, and cmuClkDiv_128.

Referenced by SegmentLCD_Init().

void CMU_LFXOInit ( const CMU_LFXOInit_TypeDef * lfxoInit )

Set LFXO control registers.

Note: LFXO configuration should be obtained from a configuration tool, app note or xtal datasheet. This function disables the LFXO to ensure a valid state before update.

Parameters

[in] lfxoInit LFXO setup parameters

Definition at line 3534 of file em_cmu.c.

References _CMU_LFXOCTRL_GAIN_MASK, _CMU_LFXOCTRL_GAIN_SHIFT, _CMU_LFXOCTRL_MODE_MASK, _CMU_LFXOCTRL_MODE_SHIFT, _CMU_LFXOCTRL_TIMEOUT_MASK, _CMU_LFXOCTRL_TIMEOUT_SHIFT, _CMU_LFXOCTRL_TUNING_MASK, _CMU_LFXOCTRL_TUNING_SHIFT, BUS_RegBitWrite(), BUS_RegMaskedWrite(), CMU, CMU_ClockSelectGet(), CMU_OscillatorEnable(), cmuClock_HF, cmuOsc_LFXO, cmuSelect_LFXO, CMU_LFXOInit_TypeDef::ctune, EMU, CMU_LFXOInit_TypeDef::gain, CMU_LFXOInit_TypeDef::mode, and CMU_LFXOInit_TypeDef::timeout.

__STATIC_INLINE void CMU_Lock ( void )

Lock the CMU in order to protect some of its registers against unintended modification.

Please refer to the reference manual for CMU registers that will be locked.

Note: If locking the CMU registers, they must be unlocked prior to using any CMU API functions modifying CMU registers protected by the lock.

Definition at line 1433 of file em_cmu.h.

References CMU, and CMU_LOCK_LOCKKEY_LOCK.

Referenced by EMU_EnterEM3().

__STATIC_INLINE uint32_t CMU_Log2ToDiv ( uint32_t log2 )

Convert logarithm of 2 prescaler to division factor.

Parameters

[in] log2 Logarithm of 2, as used by fixed prescalers.

Returns: Dividend.

Definition at line 1449 of file em_cmu.h.

Referenced by CMU_ClockDivGet(), CMU_ClockFreqGet(), CMU_ClockPrescGet(), and CMU_PrescToLog2().

void CMU_OscillatorEnable	(	CMU_Osc_TypeDef	osc,
		bool	enable,
		bool	wait
	)

Enable/disable oscillator.

Note: WARNING: When this function is called to disable either cmuOsc_LFXO or cmuOsc_HFXO the LFXOMODE or HFXOMODE fields of the CMU_CTRL register are reset to the reset value. I.e. if external clock sources are selected in either LFXOMODE or HFXOMODE fields, the configuration will be cleared and needs to be reconfigured if needed later.

Parameters

[in]	osc	The oscillator to enable/disable.
[in]	enable	true - enable specified oscillator. false - disable specified oscillator.
[in]	wait	Only used if `enable` is true. true - wait for oscillator start-up time to timeout before returning. false - do not wait for oscillator start-up time to timeout before returning.

Definition at line 3594 of file em_cmu.c.

References _CMU_HFXOCTRL_MODE_MASK, _CMU_HFXOCTRL_PEAKDETSHUNTOPTMODE_MASK, _CMU_STATUS_AUXHFRCOENS_SHIFT, _CMU_STATUS_AUXHFRCORDY_SHIFT, _CMU_STATUS_HFRCOENS_SHIFT, _CMU_STATUS_HFRCORDY_SHIFT, _CMU_STATUS_HFXOENS_SHIFT, _CMU_STATUS_HFXORDY_SHIFT, _CMU_STATUS_LFRCOENS_SHIFT, _CMU_STATUS_LFRCORDY_SHIFT, _CMU_STATUS_LFXOENS_SHIFT, _CMU_STATUS_LFXORDY_SHIFT, BUS_RegBitRead(), CMU, CMU_HFXOCTRL_MODE_EXTCLK, CMU_HFXOCTRL_PEAKDETSHUNTOPTMODE_AUTOCMD, CMU_HFXOCTRL_PEAKDETSHUNTOPTMODE_CMD, CMU_OSCENCMD_AUXHFRCODIS, CMU_OSCENCMD_AUXHFRCOEN, CMU_OSCENCMD_HFRCODIS, CMU_OSCENCMD_HFRCOEN, CMU_OSCENCMD_HFXODIS, CMU_OSCENCMD_HFXOEN, CMU_OSCENCMD_LFRCODIS, CMU_OSCENCMD_LFRCOEN, CMU_OSCENCMD_LFXODIS, CMU_OSCENCMD_LFXOEN, CMU_OscillatorTuningGet(), CMU_OscillatorTuningOptimize(), CMU_OscillatorTuningSet(), CMU_OscillatorTuningWait(), cmuHFXOTuningMode_ShuntCommand, cmuOsc_AUXHFRCO, cmuOsc_HFRCO, cmuOsc_HFXO, cmuOsc_LFRCO, and cmuOsc_LFXO.

Referenced by CMU_ClockSelectSet(), CMU_HFXOInit(), CMU_LFXOInit(), DBG_SWOEnable(), setupOscillators(), and UDELAY_Calibrate().

uint32_t CMU_OscillatorTuningGet ( CMU_Osc_TypeDef osc )

Get oscillator frequency tuning setting.

Parameters

[in]

osc

Oscillator to get tuning value for, one of:

cmuOsc_LFRCO
cmuOsc_HFRCO
cmuOsc_AUXHFRCO
cmuOsc_HFXO if CMU_HFXOCTRL_PEAKDETSHUNTOPTMODE is defined

Returns: The oscillator frequency tuning setting in use.

Definition at line 3772 of file em_cmu.c.

References _CMU_AUXHFRCOCTRL_TUNING_MASK, _CMU_AUXHFRCOCTRL_TUNING_SHIFT, _CMU_HFRCOCTRL_TUNING_MASK, _CMU_HFRCOCTRL_TUNING_SHIFT, _CMU_HFXOTRIMSTATUS_IBTRIMXOCORE_MASK, _CMU_HFXOTRIMSTATUS_REGISH_MASK, _CMU_LFRCOCTRL_TUNING_MASK, _CMU_LFRCOCTRL_TUNING_SHIFT, CMU, cmuOsc_AUXHFRCO, cmuOsc_HFRCO, cmuOsc_HFXO, and cmuOsc_LFRCO.

Referenced by CMU_OscillatorEnable().

bool CMU_OscillatorTuningOptimize	(	CMU_Osc_TypeDef	osc,
		CMU_HFXOTuningMode_TypeDef	mode,
		bool	wait
	)

Start and optionally wait for oscillator tuning optimization.

Parameters

[in]	osc	Oscillator to set tuning value for, one of: cmuOsc_HFXO
[in]	mode	Tuning optimization mode.
[in]	wait	Wait for tuning optimization to complete. true - wait for tuning optimization to complete. false - return without waiting.

Returns: Returns false on invalid parameters or oscillator error status.

Definition at line 3982 of file em_cmu.c.

References CMU, CMU_IFC_HFXOPEAKDETERR, CMU_OscillatorTuningWait(), and cmuOsc_HFXO.

Referenced by CMU_OscillatorEnable().

void CMU_OscillatorTuningSet	(	CMU_Osc_TypeDef	osc,
		uint32_t	val
	)

Set the oscillator frequency tuning control.

Note: Oscillator tuning is done during production, and the tuning value is automatically loaded after a reset. Changing the tuning value from the calibrated value is for more advanced use. Certain oscillators also have build-in tuning optimization.

Parameters

[in]	osc	Oscillator to set tuning value for, one of: cmuOsc_LFRCO cmuOsc_HFRCO cmuOsc_AUXHFRCO cmuOsc_HFXO if PEAKDETSHUNTOPTMODE is available. Note that CMD mode is set.
[in]	val	The oscillator frequency tuning setting to use.