CMU - Clock Management Unit

Description

Clock management unit (CMU) Peripheral API.

This module contains functions for the CMU peripheral of Silicon Labs 32-bit MCUs and SoCs. The CMU module controls oscillators, clocks gates, clock multiplexers, pre-scalers, calibration modules and wait-states.

Data Structures

struct  CMU_LFXOInit_TypeDef
 LFXO initialization structure.
 
struct  CMU_HFXOInit_TypeDef
 HFXO initialization structure.
 

Functions

CMU_AUXHFRCOBand_TypeDef CMU_AUXHFRCOBandGet (void)
 Get the AUXHFRCO band in use.
 
void CMU_AUXHFRCOBandSet (CMU_AUXHFRCOBand_TypeDef band)
 Set the AUXHFRCO band and the tuning value based on the value in the calibration table made during production.
 
uint32_t CMU_Calibrate (uint32_t HFCycles, CMU_Osc_TypeDef reference)
 Calibrate the clock.
 
void CMU_CalibrateConfig (uint32_t downCycles, CMU_Osc_TypeDef downSel, CMU_Osc_TypeDef upSel)
 Configure the clock calibration.
 
uint32_t CMU_CalibrateCountGet (void)
 Get the calibration count register.
 
void CMU_ClockEnable (CMU_Clock_TypeDef clock, bool enable)
 Enable/disable a clock.
 
CMU_ClkDiv_TypeDef CMU_ClockDivGet (CMU_Clock_TypeDef clock)
 Get the clock divisor/prescaler.
 
void CMU_ClockDivSet (CMU_Clock_TypeDef clock, CMU_ClkDiv_TypeDef div)
 Set the clock divisor/prescaler.
 
uint32_t CMU_ClockFreqGet (CMU_Clock_TypeDef clock)
 Get the clock frequency for a clock point.
 
void CMU_ClockSelectSet (CMU_Clock_TypeDef clock, CMU_Select_TypeDef ref)
 Select the reference clock/oscillator used for a clock branch.
 
CMU_Select_TypeDef CMU_ClockSelectGet (CMU_Clock_TypeDef clock)
 Get the currently selected reference clock used for a clock branch.
 
uint16_t CMU_LF_ClockPrecisionGet (CMU_Clock_TypeDef clock)
 Gets the precision (in PPM) of the specified low frequency clock branch.
 
void CMU_FreezeEnable (bool enable)
 CMU low frequency register synchronization freeze control.
 
CMU_HFRCOBand_TypeDef CMU_HFRCOBandGet (void)
 Get HFRCO band in use.
 
void CMU_HFRCOBandSet (CMU_HFRCOBand_TypeDef band)
 Set HFRCO band and the tuning value based on the value in the calibration table made during production.
 
uint32_t CMU_HFRCOStartupDelayGet (void)
 Get the HFRCO startup delay.
 
void CMU_HFRCOStartupDelaySet (uint32_t delay)
 Set the HFRCO startup delay.
 
void CMU_HFXOInit (const CMU_HFXOInit_TypeDef *hfxoInit)
 Set HFXO control registers.
 
uint32_t CMU_LCDClkFDIVGet (void)
 Get the LCD framerate divisor (FDIV) setting.
 
void CMU_LCDClkFDIVSet (uint32_t div)
 Set the LCD framerate divisor (FDIV) setting.
 
void CMU_LFXOInit (const CMU_LFXOInit_TypeDef *lfxoInit)
 Set LFXO control registers.
 
void CMU_LFXOPrecisionSet (uint16_t precision)
 Sets LFXO's crystal precision, in PPM.
 
void CMU_OscillatorEnable (CMU_Osc_TypeDef osc, bool enable, bool wait)
 Enable/disable oscillator.
 
uint32_t CMU_OscillatorTuningGet (CMU_Osc_TypeDef osc)
 Get the oscillator frequency tuning setting.
 
void CMU_OscillatorTuningSet (CMU_Osc_TypeDef osc, uint32_t val)
 Set the oscillator frequency tuning control.
 
void CMU_PCNTClockExternalSet (unsigned int instance, bool external)
 Select the PCNTn clock.
 
bool CMU_PCNTClockExternalGet (unsigned int instance)
 Determine if the currently selected PCNTn clock used is external or LFBCLK.
 
void CMU_UpdateWaitStates (uint32_t freq, int vscale)
 Configure various wait states to switch to a certain frequency and a certain voltage scale.
 
void CMU_CalibrateCont (bool enable)
 Configure continuous calibration mode.
 
void CMU_CalibrateStart (void)
 Start calibration.
 
void CMU_CalibrateStop (void)
 Stop the calibration counters.
 
uint32_t CMU_DivToLog2 (CMU_ClkDiv_TypeDef div)
 Convert dividend to logarithmic value.
 
void CMU_IntClear (uint32_t flags)
 Clear one or more pending CMU interrupts.
 
void CMU_IntDisable (uint32_t flags)
 Disable one or more CMU interrupts.
 
void CMU_IntEnable (uint32_t flags)
 Enable one or more CMU interrupts.
 
uint32_t CMU_IntGet (void)
 Get pending CMU interrupts.
 
uint32_t CMU_IntGetEnabled (void)
 Get enabled and pending CMU interrupt flags.
 
void CMU_IntSet (uint32_t flags)
 Set one or more pending CMU interrupts.
 
void CMU_Lock (void)
 Lock the CMU to protect some of its registers against unintended modification.
 
uint32_t CMU_Log2ToDiv (uint32_t log2)
 Convert logarithm of 2 prescaler to division factor.
 
void CMU_Unlock (void)
 Unlock the CMU so that writing to locked registers again is possible.
 
void syncReg (uint32_t mask)
 Wait for an ongoing sync of register(s) to low-frequency domain to complete.
 

Macros

#define cmuClkDiv_1   1
 Clock divisors.
 
#define cmuClkDiv_2   2
 Divide clock by 2.
 
#define cmuClkDiv_4   4
 Divide clock by 4.
 
#define cmuClkDiv_8   8
 Divide clock by 8.
 
#define cmuClkDiv_16   16
 Divide clock by 16.
 
#define cmuClkDiv_32   32
 Divide clock by 32.
 
#define cmuClkDiv_64   64
 Divide clock by 64.
 
#define cmuClkDiv_128   128
 Divide clock by 128.
 
#define cmuClkDiv_256   256
 Divide clock by 256.
 
#define cmuClkDiv_512   512
 Divide clock by 512.
 
#define cmuClkDiv_1024   1024
 Divide clock by 1024.
 
#define cmuClkDiv_2048   2048
 Divide clock by 2048.
 
#define cmuClkDiv_4096   4096
 Divide clock by 4096.
 
#define cmuClkDiv_8192   8192
 Divide clock by 8192.
 
#define cmuClkDiv_16384   16384
 Divide clock by 16384.
 
#define cmuClkDiv_32768   32768
 Divide clock by 32768.
 
#define CMU_LFXOINIT_DEFAULT
 Default LFXO initialization values.
 
#define CMU_LFXOINIT_EXTERNAL_CLOCK
 Default LFXO initialization for external clock.
 
#define CMU_HFXOINIT_DEFAULT
 Default HFXO initialization values for Platform 1 devices.
 
#define CMU_HFXOINIT_EXTERNAL_CLOCK
 Default HFXO initialization for external clock.
 

Typedefs

typedef uint32_t CMU_ClkDiv_TypeDef
 Clock divider configuration.
 

Enumerations

enum  CMU_HFRCOBand_TypeDef {
  cmuHFRCOBand_1MHz = _CMU_HFRCOCTRL_BAND_1MHZ,
  cmuHFRCOBand_7MHz = _CMU_HFRCOCTRL_BAND_7MHZ,
  cmuHFRCOBand_11MHz = _CMU_HFRCOCTRL_BAND_11MHZ,
  cmuHFRCOBand_14MHz = _CMU_HFRCOCTRL_BAND_14MHZ,
  cmuHFRCOBand_21MHz = _CMU_HFRCOCTRL_BAND_21MHZ,
  cmuHFRCOBand_28MHz = _CMU_HFRCOCTRL_BAND_28MHZ
}
 High-frequency system RCO bands.
 
enum  CMU_AUXHFRCOBand_TypeDef {
  cmuAUXHFRCOBand_1MHz = _CMU_AUXHFRCOCTRL_BAND_1MHZ,
  cmuAUXHFRCOBand_7MHz = _CMU_AUXHFRCOCTRL_BAND_7MHZ,
  cmuAUXHFRCOBand_11MHz = _CMU_AUXHFRCOCTRL_BAND_11MHZ,
  cmuAUXHFRCOBand_14MHz = _CMU_AUXHFRCOCTRL_BAND_14MHZ,
  cmuAUXHFRCOBand_21MHz = _CMU_AUXHFRCOCTRL_BAND_21MHZ,
  cmuAUXHFRCOBand_28MHz = _CMU_AUXHFRCOCTRL_BAND_28MHZ
}
 AUX high-frequency RCO bands.
 
enum  CMU_Clock_TypeDef {
  cmuClock_HF,
  cmuClock_DBG,
  cmuClock_AUX,
  cmuClock_HFPER,
  cmuClock_USART0,
  cmuClock_USART1,
  cmuClock_USART2,
  cmuClock_UART0,
  cmuClock_UART1,
  cmuClock_TIMER0,
  cmuClock_TIMER1,
  cmuClock_TIMER2,
  cmuClock_TIMER3,
  cmuClock_ACMP0,
  cmuClock_ACMP1,
  cmuClock_PRS,
  cmuClock_DAC0,
  cmuClock_GPIO,
  cmuClock_VCMP,
  cmuClock_ADC0,
  cmuClock_I2C0,
  cmuClock_I2C1,
  cmuClock_CORE,
  cmuClock_AES,
  cmuClock_DMA,
  cmuClock_HFLE,
  cmuClock_EBI,
  cmuClock_USB,
  cmuClock_LFA,
  cmuClock_RTC,
  cmuClock_LETIMER0,
  cmuClock_LCDpre,
  cmuClock_LCD,
  cmuClock_PCNT0,
  cmuClock_PCNT1,
  cmuClock_PCNT2,
  cmuClock_LESENSE,
  cmuClock_LFB,
  cmuClock_LEUART0,
  cmuClock_LEUART1
}
 Clock points in CMU.
 
enum  CMU_Osc_TypeDef {
  cmuOsc_LFXO,
  cmuOsc_LFRCO,
  cmuOsc_HFXO,
  cmuOsc_HFRCO,
  cmuOsc_AUXHFRCO,
  cmuOsc_ULFRCO
}
 Oscillator types.
 
enum  CMU_OscMode_TypeDef {
  cmuOscMode_Crystal,
  cmuOscMode_AcCoupled,
  cmuOscMode_External
}
 Oscillator modes.
 
enum  CMU_Select_TypeDef {
  cmuSelect_Error,
  cmuSelect_Disabled,
  cmuSelect_LFXO,
  cmuSelect_LFRCO,
  cmuSelect_HFXO,
  cmuSelect_HFRCO,
  cmuSelect_HFCLKLE,
  cmuSelect_AUXHFRCO,
  cmuSelect_HFSRCCLK,
  cmuSelect_HFCLK,
  cmuSelect_ULFRCO
}
 Selectable clock sources.
 
enum  CMU_LFXOBoost_TypeDef {
  cmuLfxoBoost70 = 0x0,
  cmuLfxoBoost100 = 0x2
}
 LFXO Boost values.
 

Function Documentation

◆ CMU_AUXHFRCOBandGet()

CMU_AUXHFRCOBand_TypeDef CMU_AUXHFRCOBandGet ( void  )

Get the AUXHFRCO band in use.

Returns
AUXHFRCO band in use.

◆ CMU_AUXHFRCOBandSet()

void CMU_AUXHFRCOBandSet ( CMU_AUXHFRCOBand_TypeDef  band)

Set the AUXHFRCO band and the tuning value based on the value in the calibration table made during production.

Parameters
[in]bandAUXHFRCO band to activate.

◆ CMU_Calibrate()

uint32_t CMU_Calibrate ( uint32_t  HFCycles,
CMU_Osc_TypeDef  reference 
)

Calibrate the clock.

Run a calibration for HFCLK against a selectable reference clock. See the reference manual, CMU chapter, for more details.

Note
This function will not return until the calibration measurement is completed.
Parameters
[in]HFCyclesThe number of HFCLK cycles to run the calibration. Increasing this number increases precision but the calibration will take more time.
[in]referenceThe reference clock used to compare HFCLK.
Returns
The number of ticks the reference clock after HFCycles ticks on the HF clock.

◆ CMU_CalibrateConfig()

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

Configure the clock calibration.

Configure a calibration for a selectable clock source against another selectable reference clock. See the reference manual, CMU chapter, for more 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]downCyclesThe number of downSel clock cycles to run the calibration. Increasing this number increases precision but the calibration will take more time.
[in]downSelThe clock, which will be counted down downCycles.
[in]upSelThe reference clock; the number of cycles generated by this clock will be counted and added up and the result can be given with the CMU_CalibrateCountGet() function call.

◆ CMU_CalibrateCountGet()

uint32_t CMU_CalibrateCountGet ( void  )

Get the calibration count register.

Note
If continuous calibration mode is active, calibration busy will almost always be off and only the value needs to be read. In a normal case, this function call is triggered by the CALRDY interrupt flag.
Returns
The calibration count, the number of UPSEL clocks in the period of DOWNSEL oscillator clock cycles configured by a previous write operation to CMU->CALCNT.

◆ CMU_ClockEnable()

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 has no effect. Avoid accessing module registers of a module with a disabled clock.

Note
If enabling/disabling an 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. See CMU_FreezeEnable() for a suggestion on how to reduce the stalling time in some use cases.

HFCLKLE prescaler is automatically modified when peripherals with clock domain HFBUSCLK is chosen based on the maximum HFLE frequency allowed.

Parameters
[in]clockThe clock to enable/disable. Notice that not all defined clock points have separate enable/disable control. See the CMU overview in the reference manual.
[in]enable
  • true - enable specified clock.
  • false - disable specified clock.

◆ CMU_ClockDivGet()

CMU_ClkDiv_TypeDef CMU_ClockDivGet ( CMU_Clock_TypeDef  clock)

Get the clock divisor/prescaler.

Parameters
[in]clockA clock point to get the divisor/prescaler for. Notice that not all clock points have a divisor/prescaler. See the CMU overview in the reference manual.
Returns
The current clock point divisor/prescaler. 1 is returned if clock specifies a clock point without a divisor/prescaler.

◆ CMU_ClockDivSet()

void CMU_ClockDivSet ( CMU_Clock_TypeDef  clock,
CMU_ClkDiv_TypeDef  div 
)

Set the clock divisor/prescaler.

Note
If setting an 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. See CMU_FreezeEnable() for a suggestion on how to reduce the stalling time in some use cases.

HFCLKLE prescaler is automatically modified when peripherals with clock domain HFBUSCLK is chosen based on the maximum HFLE frequency allowed.

Parameters
[in]clockClock point to set divisor/prescaler for. Notice that not all clock points have a divisor/prescaler. See the CMU overview in the reference manual.
[in]divThe clock divisor to use (<= cmuClkDiv_512).

◆ CMU_ClockFreqGet()

uint32_t CMU_ClockFreqGet ( CMU_Clock_TypeDef  clock)

Get the clock frequency for a clock point.

Parameters
[in]clockA clock point to fetch the frequency for.
Returns
The current frequency in Hz.

◆ CMU_ClockSelectSet()

void CMU_ClockSelectSet ( CMU_Clock_TypeDef  clock,
CMU_Select_TypeDef  ref 
)

Select the 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.

Note
HFCLKLE prescaler is automatically modified when peripherals with clock domain HFBUSCLK is chosen based on the maximum HFLE frequency allowed.
Parameters
[in]clockA clock branch to select reference clock for. One of:
[in]refA reference selected for clocking. See the reference manual for details about references available for a specific clock branch.

◆ CMU_ClockSelectGet()

CMU_Select_TypeDef CMU_ClockSelectGet ( CMU_Clock_TypeDef  clock)

Get the currently selected reference clock used for a clock branch.

Parameters
[in]clockClock branch to fetch selected ref. clock for. One of:
Returns
The reference clock used for clocking the selected branch, cmuSelect_Error if invalid clock provided.

◆ CMU_LF_ClockPrecisionGet()

uint16_t CMU_LF_ClockPrecisionGet ( CMU_Clock_TypeDef  clock)

Gets the precision (in PPM) of the specified low frequency clock branch.

Parameters
[in]clockClock branch.
Returns
Precision, in PPM, of the specified clock branch.
Note
This function is only for internal usage.
The current implementation of this function is used to determine if the clock has a precision <= 500 ppm or not (which is the minimum required for BLE). Future version of this function should provide more accurate precision numbers to allow for further optimizations from the stacks.

◆ CMU_FreezeEnable()

void CMU_FreezeEnable ( bool  enable)

CMU low frequency register synchronization freeze control.

Some CMU registers require 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 use case for this feature is 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 unnecessary stalling.
Parameters
[in]enable
  • true - enable freeze, modified registers are not propagated to the LF domain
  • false - disable freeze, modified registers are propagated to the LF domain

◆ CMU_HFRCOBandGet()

CMU_HFRCOBand_TypeDef CMU_HFRCOBandGet ( void  )

Get HFRCO band in use.

Returns
HFRCO band in use.

◆ CMU_HFRCOBandSet()

void CMU_HFRCOBandSet ( CMU_HFRCOBand_TypeDef  band)

Set HFRCO band and the tuning value based on the value in the calibration table made during production.

Note
HFCLKLE prescaler is automatically modified based on the maximum HFLE frequency allowed.
Parameters
[in]bandHFRCO band to activate.

◆ CMU_HFRCOStartupDelayGet()

uint32_t CMU_HFRCOStartupDelayGet ( void  )

Get the HFRCO startup delay.

See the reference manual for more details.

Returns
The startup delay in use.

◆ CMU_HFRCOStartupDelaySet()

void CMU_HFRCOStartupDelaySet ( uint32_t  delay)

Set the HFRCO startup delay.

See the reference manual for more details.

Parameters
[in]delayThe startup delay to set (<= 31).

◆ CMU_HFXOInit()

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 crystal data sheet. This function disables the HFXO to ensure a valid state before update.
Parameters
[in]hfxoInitHFXO setup parameters.

◆ CMU_LCDClkFDIVGet()

uint32_t CMU_LCDClkFDIVGet ( void  )

Get the LCD framerate divisor (FDIV) setting.

Returns
The LCD framerate divisor.

◆ CMU_LCDClkFDIVSet()

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. See CMU_ClockEnable() for disabling/enabling LCD clock.
Parameters
[in]divThe FDIV setting to use.

◆ CMU_LFXOInit()

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 crystal data sheet. This function disables the LFXO when necessary to ensure a valid state before update.
Parameters
[in]lfxoInitLFXO setup parameters.

◆ CMU_LFXOPrecisionSet()

void CMU_LFXOPrecisionSet ( uint16_t  precision)

Sets LFXO's crystal precision, in PPM.

Note
LFXO precision should be obtained from a crystal datasheet.
Parameters
[in]precisionLFXO's crystal precision, in PPM.

◆ CMU_OscillatorEnable()

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. In other words, 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]oscThe oscillator to enable/disable.
[in]enable
  • true - enable specified oscillator.
  • false - disable specified oscillator.
[in]waitOnly 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.

◆ CMU_OscillatorTuningGet()

uint32_t CMU_OscillatorTuningGet ( CMU_Osc_TypeDef  osc)

Get the oscillator frequency tuning setting.

Parameters
[in]oscAn oscillator to get tuning value for, one of the following:
Returns
The oscillator frequency tuning setting in use.

◆ CMU_OscillatorTuningSet()

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 reset. Changing the tuning value from the calibrated value is for more advanced use. Certain oscillators also have build-in tuning optimization.
Parameters
[in]oscAn oscillator to set tuning value for, one of the following:
[in]valThe oscillator frequency tuning setting to use.

◆ CMU_PCNTClockExternalSet()

void CMU_PCNTClockExternalSet ( unsigned int  instance,
bool  external 
)

Select the PCNTn clock.

Parameters
[in]instancePCNT instance number to set selected clock source for.
[in]externalSet to true to select the external clock, false to select LFBCLK.

◆ CMU_PCNTClockExternalGet()

bool CMU_PCNTClockExternalGet ( unsigned int  instance)

Determine if the currently selected PCNTn clock used is external or LFBCLK.

Parameters
[in]instancePCNT instance number to get currently selected clock source for.
Returns
  • true - selected clock is external clock.
  • false - selected clock is LFBCLK.

◆ CMU_UpdateWaitStates()

void CMU_UpdateWaitStates ( uint32_t  freq,
int  vscale 
)

Configure various wait states to switch to a certain frequency and a certain voltage scale.

This function will set up the necessary flash, bus, and RAM wait states. Updating the wait state configuration must be done before increasing the clock frequency and it must be done after decreasing the clock frequency. Updating the wait state configuration must be done before core voltage is decreased and it must be done after a core voltage is increased.

Parameters
[in]freqThe core clock frequency to configure wait-states.
[in]vscaleThe voltage scale to configure wait-states. Expected values are 0 or 2, higher number is lower voltage.
  • 0 = 1.2 V (VSCALE2)
  • 2 = 1.0 V (VSCALE0)

◆ CMU_CalibrateCont()

void CMU_CalibrateCont ( bool  enable)
inline

Configure continuous calibration mode.

Parameters
[in]enableIf true, enables continuous calibration, if false disables continuous calibration.

◆ CMU_CalibrateStart()

void CMU_CalibrateStart ( void  )
inline

Start calibration.

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

◆ CMU_CalibrateStop()

void CMU_CalibrateStop ( void  )
inline

Stop the calibration counters.

◆ CMU_DivToLog2()

uint32_t CMU_DivToLog2 ( CMU_ClkDiv_TypeDef  div)
inline

Convert dividend to logarithmic value.

It only works for even numbers equal to 2^n.

Parameters
[in]divAn unscaled dividend.
Returns
Logarithm of 2, as used by fixed prescalers.

◆ CMU_IntClear()

void CMU_IntClear ( uint32_t  flags)
inline

Clear one or more pending CMU interrupts.

Parameters
[in]flagsCMU interrupt sources to clear.

◆ CMU_IntDisable()

void CMU_IntDisable ( uint32_t  flags)
inline

Disable one or more CMU interrupts.

Parameters
[in]flagsCMU interrupt sources to disable.

◆ CMU_IntEnable()

void CMU_IntEnable ( uint32_t  flags)
inline

Enable one or more CMU interrupts.

Note
Depending on use case, a pending interrupt may already be set prior to enabling the interrupt. Consider using CMU_IntClear() prior to enabling if the pending interrupt should be ignored.
Parameters
[in]flagsCMU interrupt sources to enable.

◆ CMU_IntGet()

uint32_t CMU_IntGet ( void  )
inline

Get pending CMU interrupts.

Returns
CMU interrupt sources pending.

◆ CMU_IntGetEnabled()

uint32_t CMU_IntGetEnabled ( void  )
inline

Get enabled and pending CMU interrupt flags.

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

Note
This function does not clear event bits.
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

◆ CMU_IntSet()

void CMU_IntSet ( uint32_t  flags)
inline

Set one or more pending CMU interrupts.

Parameters
[in]flagsCMU interrupt sources to set to pending.

◆ CMU_Lock()

void CMU_Lock ( void  )
inline

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

See 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.

◆ CMU_Log2ToDiv()

uint32_t CMU_Log2ToDiv ( uint32_t  log2)
inline

Convert logarithm of 2 prescaler to division factor.

Parameters
[in]log2Logarithm of 2, as used by fixed prescalers.
Returns
Dividend.

◆ CMU_Unlock()

void CMU_Unlock ( void  )
inline

Unlock the CMU so that writing to locked registers again is possible.

◆ syncReg()

void syncReg ( uint32_t  mask)
inline

Wait for an ongoing sync of register(s) to low-frequency domain to complete.

Parameters
[in]maskA bitmask corresponding to SYNCBUSY register defined bits, indicating registers that must complete any ongoing synchronization.

Macro Definition Documentation

◆ cmuClkDiv_1

#define cmuClkDiv_1   1

Clock divisors.

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

◆ cmuClkDiv_2

#define cmuClkDiv_2   2

Divide clock by 2.

◆ cmuClkDiv_4

#define cmuClkDiv_4   4

Divide clock by 4.

◆ cmuClkDiv_8

#define cmuClkDiv_8   8

Divide clock by 8.

◆ cmuClkDiv_16

#define cmuClkDiv_16   16

Divide clock by 16.

◆ cmuClkDiv_32

#define cmuClkDiv_32   32

Divide clock by 32.

◆ cmuClkDiv_64

#define cmuClkDiv_64   64

Divide clock by 64.

◆ cmuClkDiv_128

#define cmuClkDiv_128   128

Divide clock by 128.

◆ cmuClkDiv_256

#define cmuClkDiv_256   256

Divide clock by 256.

◆ cmuClkDiv_512

#define cmuClkDiv_512   512

Divide clock by 512.

◆ cmuClkDiv_1024

#define cmuClkDiv_1024   1024

Divide clock by 1024.

◆ cmuClkDiv_2048

#define cmuClkDiv_2048   2048

Divide clock by 2048.

◆ cmuClkDiv_4096

#define cmuClkDiv_4096   4096

Divide clock by 4096.

◆ cmuClkDiv_8192

#define cmuClkDiv_8192   8192

Divide clock by 8192.

◆ cmuClkDiv_16384

#define cmuClkDiv_16384   16384

Divide clock by 16384.

◆ cmuClkDiv_32768

#define cmuClkDiv_32768   32768

Divide clock by 32768.

◆ CMU_LFXOINIT_DEFAULT

#define CMU_LFXOINIT_DEFAULT
Value:
{ \
cmuLfxoBoost70, \
_CMU_CTRL_LFXOTIMEOUT_DEFAULT, \
cmuOscMode_Crystal, \
}

Default LFXO initialization values.

◆ CMU_LFXOINIT_EXTERNAL_CLOCK

#define CMU_LFXOINIT_EXTERNAL_CLOCK
Value:
{ \
cmuLfxoBoost70, \
_CMU_CTRL_LFXOTIMEOUT_8CYCLES, \
cmuOscMode_External, \
}

Default LFXO initialization for external clock.

◆ CMU_HFXOINIT_DEFAULT

#define CMU_HFXOINIT_DEFAULT
Value:
{ \
_CMU_CTRL_HFXOBOOST_DEFAULT, /* 100% HFXO boost */ \
_CMU_CTRL_HFXOTIMEOUT_DEFAULT, /* 16 K startup delay */ \
false, /* Disable glitch detector */ \
cmuOscMode_Crystal, /* Crystal oscillator */ \
}

Default HFXO initialization values for Platform 1 devices.

◆ CMU_HFXOINIT_EXTERNAL_CLOCK

#define CMU_HFXOINIT_EXTERNAL_CLOCK
Value:
{ \
0, /* Minimal HFXO boost, 50% */ \
_CMU_CTRL_HFXOTIMEOUT_8CYCLES, /* Minimal startup delay, 8 cycles */ \
false, /* Disable glitch detector */ \
cmuOscMode_External, /* External digital clock */ \
}

Default HFXO initialization for external clock.

Typedef Documentation

◆ CMU_ClkDiv_TypeDef

typedef uint32_t CMU_ClkDiv_TypeDef

Clock divider configuration.

Enumeration Type Documentation

◆ CMU_HFRCOBand_TypeDef

High-frequency system RCO bands.

Enumerator
cmuHFRCOBand_1MHz 

1 MHz HFRCO band

cmuHFRCOBand_7MHz 

7 MHz HFRCO band

cmuHFRCOBand_11MHz 

11 MHz HFRCO band

cmuHFRCOBand_14MHz 

14 MHz HFRCO band

cmuHFRCOBand_21MHz 

21 MHz HFRCO band

cmuHFRCOBand_28MHz 

28 MHz HFRCO band

◆ CMU_AUXHFRCOBand_TypeDef

AUX high-frequency RCO bands.

Enumerator
cmuAUXHFRCOBand_1MHz 

1 MHz RC band

cmuAUXHFRCOBand_7MHz 

7 MHz RC band

cmuAUXHFRCOBand_11MHz 

11 MHz RC band

cmuAUXHFRCOBand_14MHz 

14 MHz RC band

cmuAUXHFRCOBand_21MHz 

21 MHz RC band

cmuAUXHFRCOBand_28MHz 

28 MHz RC band

◆ CMU_Clock_TypeDef

Clock points in CMU.

See CMU overview in the reference manual.

Enumerator
cmuClock_HF 

High-frequency clock.

cmuClock_DBG 

Debug clock.

cmuClock_AUX 

AUX 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_UART0 

Universal async receiver/transmitter 0 clock.

cmuClock_UART1 

Universal async receiver/transmitter 1 clock.

cmuClock_TIMER0 

Timer 0 clock.

cmuClock_TIMER1 

Timer 1 clock.

cmuClock_TIMER2 

Timer 2 clock.

cmuClock_TIMER3 

Timer 3 clock.

cmuClock_ACMP0 

Analog comparator 0 clock.

cmuClock_ACMP1 

Analog comparator 1 clock.

cmuClock_PRS 

Peripheral-reflex system clock.

cmuClock_DAC0 

Digital-to-analog converter 0 clock.

cmuClock_GPIO 

General-purpose input/output clock.

cmuClock_VCMP 

Voltage comparator clock.

cmuClock_ADC0 

Analog-to-digital converter 0 clock.

cmuClock_I2C0 

I2C 0 clock.

cmuClock_I2C1 

I2C 1 clock.

cmuClock_CORE 

Core clock.

cmuClock_AES 

Advanced encryption standard accelerator clock.

cmuClock_DMA 

Direct memory access controller clock.

cmuClock_HFLE 

Low-energy clock divided down from HFCORECLK.

cmuClock_EBI 

External bus interface clock.

cmuClock_USB 

USB clock.

cmuClock_LFA 

Low-frequency A clock.

cmuClock_RTC 

Real time counter clock.

cmuClock_LETIMER0 

Low-energy timer 0 clock.

cmuClock_LCDpre 

Liquid crystal display, pre FDIV clock.

cmuClock_LCD 

Liquid crystal display clock.

Note that FDIV prescaler must be set by special API.

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_LEUART1 

Low-energy universal asynchronous receiver/transmitter 1 clock.

◆ 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.

◆ CMU_OscMode_TypeDef

Oscillator modes.

Enumerator
cmuOscMode_Crystal 

Crystal oscillator.

cmuOscMode_AcCoupled 

AC-coupled buffer.

cmuOscMode_External 

External digital clock.

◆ 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_HFSRCCLK 

High-frequency source 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.

◆ CMU_LFXOBoost_TypeDef

LFXO Boost values.