BURTC - Backup RTC#

Backup Real Time Counter (BURTC) Peripheral API.

This module contains functions to control the BURTC peripheral of Silicon Labs 32-bit MCUs. The Backup Real Time Counter allows timekeeping in all energy modes. The Backup RTC is also available when the system is in backup mode.

Modules#

BURTC_Init_TypeDef

Functions#

void
BURTC_Init(const BURTC_Init_TypeDef *burtcInit)

Initialize BURTC.

void
BURTC_Enable(bool enable)

Enable or Disable BURTC peripheral.

void
BURTC_CompareSet(unsigned int comp, uint32_t value)

Set BURTC compare channel.

uint32_t
BURTC_CompareGet(unsigned int comp)

Get the BURTC compare value.

void
BURTC_CounterReset(void)

Reset counter.

void
BURTC_Reset(void)

Restore BURTC to reset state.

void
BURTC_IntClear(uint32_t flags)

Clear one or more pending BURTC interrupts.

void
BURTC_IntDisable(uint32_t flags)

Disable one or more BURTC interrupts.

void
BURTC_IntEnable(uint32_t flags)

Enable one or more BURTC interrupts.

uint32_t
BURTC_IntGet(void)

Get pending BURTC interrupt flags.

uint32_t
BURTC_IntGetEnabled(void)

Get enabled and pending BURTC interrupt flags.

void
BURTC_IntSet(uint32_t flags)

Set one or more pending BURTC interrupts from SW.

uint32_t
BURTC_Status(void)

Status of BURTC RAM, timestamp and LP Mode.

void
BURTC_SyncWait(void)

Wait for the BURTC to complete all synchronization of register changes and commands.

void
BURTC_Start(void)

Start BURTC counter.

void
BURTC_Stop(void)

Stop the BURTC counter.

uint32_t
BURTC_CounterGet(void)

Get BURTC counter.

void
BURTC_Lock(void)

Lock BURTC registers, which will protect from writing new config settings.

void
BURTC_Unlock(void)

Unlock BURTC registers, which will enable write access to change configuration.

Macros#

#define
burtcClkDiv_1 1

BURTC clock divisors.

#define
burtcClkDiv_2 2

Divide clock by 2.

#define
burtcClkDiv_4 4

Divide clock by 4.

#define
burtcClkDiv_8 8

Divide clock by 8.

#define
burtcClkDiv_16 16

Divide clock by 16.

#define
burtcClkDiv_32 32

Divide clock by 32.

#define
burtcClkDiv_64 64

Divide clock by 64.

#define
burtcClkDiv_128 128

Divide clock by 128.

#define
BURTC_INIT_DEFAULT undefined

Default configuration for BURTC init structure.

Function Documentation#

BURTC_Init#

void BURTC_Init (const BURTC_Init_TypeDef * burtcInit)

Initialize BURTC.

Parameters
[in]burtcInit

A pointer to the BURTC initialization structure.

Configures the BURTC peripheral.

Note

  • Before initialization, BURTC module must first be enabled by clearing the reset bit in the RMU, i.e., 

    *   RMU_ResetControl(rmuResetBU, rmuResetModeClear);
*

    Compare channel 0 must be configured outside this function, before initialization if enable is set to true. The counter will always be reset.


Definition at line 123 of file platform/emlib/src/em_burtc.c

BURTC_Enable#

void BURTC_Enable (bool enable)

Enable or Disable BURTC peripheral.

Parameters
[in]enable

true to enable, false to disable.


Definition at line 225 of file platform/emlib/src/em_burtc.c

BURTC_CompareSet#

void BURTC_CompareSet (unsigned int comp, uint32_t value)

Set BURTC compare channel.

Parameters
[in]comp

Compare the channel index, must be 0 for current devices.

[in]value

New compare value.


Definition at line 281 of file platform/emlib/src/em_burtc.c

BURTC_CompareGet#

uint32_t BURTC_CompareGet (unsigned int comp)

Get the BURTC compare value.

Parameters
[in]comp

Compare the channel index value, must be 0 for Giant/Leopard Gecko.

Returns

  • The currently configured value for this compare channel.


Definition at line 311 of file platform/emlib/src/em_burtc.c

BURTC_CounterReset#

void BURTC_CounterReset (void )

Reset counter.

Parameters
N/A

Definition at line 326 of file platform/emlib/src/em_burtc.c

BURTC_Reset#

void BURTC_Reset (void )

Restore BURTC to reset state.

Parameters
N/A

Note

  • Before accessing the BURTC, BURSTEN in RMU->CTRL must be cleared. LOCK will not be reset to default value, as this will disable access to core BURTC registers.


Definition at line 347 of file platform/emlib/src/em_burtc.c

BURTC_IntClear#

void BURTC_IntClear (uint32_t flags)

Clear one or more pending BURTC interrupts.

Parameters
[in]flags

BURTC interrupt sources to clear. Use a set of interrupt flags OR-ed together to clear multiple interrupt sources for the BURTC module (BURTC_IFS_nnn).


Definition at line 174 of file platform/emlib/inc/em_burtc.h

BURTC_IntDisable#

void BURTC_IntDisable (uint32_t flags)

Disable one or more BURTC interrupts.

Parameters
[in]flags

BURTC interrupt sources to disable. Use a set of interrupt flags OR-ed together to disable multiple interrupt sources for the BURTC module (BURTC_IFS_nnn).


Definition at line 192 of file platform/emlib/inc/em_burtc.h

BURTC_IntEnable#

void BURTC_IntEnable (uint32_t flags)

Enable one or more BURTC interrupts.

Parameters
[in]flags

BURTC interrupt sources to enable. Use a set of interrupt flags OR-ed together to set multiple interrupt sources for the BURTC module (BURTC_IFS_nnn).

Note

  • Depending on use, a pending interrupt may already be set prior to enabling the interrupt. Consider using BURTC_IntClear() prior to enabling if a pending interrupt should be ignored.


Definition at line 215 of file platform/emlib/inc/em_burtc.h

BURTC_IntGet#

uint32_t BURTC_IntGet (void )

Get pending BURTC interrupt flags.

Parameters
N/A

Note

  • This function does not clear the event bits.

Returns

  • Pending BURTC interrupt sources. Returns a set of interrupt flags OR-ed together for multiple interrupt sources in the BURTC module (BURTC_IFS_nnn).


Definition at line 235 of file platform/emlib/inc/em_burtc.h

BURTC_IntGetEnabled#

uint32_t BURTC_IntGetEnabled (void )

Get enabled and pending BURTC interrupt flags.

Parameters
N/A

Note

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

Returns

  • Pending BURTC interrupt sources that is also enabled. Returns a set of interrupt flags OR-ed together for multiple interrupt sources in the BURTC module (BURTC_IFS_nnn).


Definition at line 252 of file platform/emlib/inc/em_burtc.h

BURTC_IntSet#

void BURTC_IntSet (uint32_t flags)

Set one or more pending BURTC interrupts from SW.

Parameters
[in]flags

BURTC interrupt sources to set to pending. Use a set of interrupt flags OR-ed together to set multiple interrupt sources for the BURTC module (BURTC_IFS_nnn).


Definition at line 272 of file platform/emlib/inc/em_burtc.h

BURTC_Status#

uint32_t BURTC_Status (void )

Status of BURTC RAM, timestamp and LP Mode.

Parameters
N/A

Returns

  • A mask logically OR-ed status bits


Definition at line 287 of file platform/emlib/inc/em_burtc.h

BURTC_SyncWait#

void BURTC_SyncWait (void )

Wait for the BURTC to complete all synchronization of register changes and commands.

Parameters
N/A

Definition at line 308 of file platform/emlib/inc/em_burtc.h

BURTC_Start#

void BURTC_Start (void )

Start BURTC counter.

Parameters
N/A

This function will send a start command to the BURTC peripheral. The BURTC peripheral will use some LF clock ticks before the command is executed. The BURTC_SyncWait() function can be used to wait for the start command to be executed.

Note

  • This function requires the BURTC to be enabled.


Definition at line 334 of file platform/emlib/inc/em_burtc.h

BURTC_Stop#

void BURTC_Stop (void )

Stop the BURTC counter.

Parameters
N/A

This function will send a stop command to the BURTC peripheral. The BURTC peripheral will use some LF clock ticks before the command is executed. The BURTC_SyncWait() function can be used to wait for the stop command to be executed.

Note

  • This function requires the BURTC to be enabled.


Definition at line 352 of file platform/emlib/inc/em_burtc.h

BURTC_CounterGet#

uint32_t BURTC_CounterGet (void )

Get BURTC counter.

Parameters
N/A

Returns

  • BURTC counter value


Definition at line 365 of file platform/emlib/inc/em_burtc.h

BURTC_Lock#

void BURTC_Lock (void )

Lock BURTC registers, which will protect from writing new config settings.

Parameters
N/A

Definition at line 442 of file platform/emlib/inc/em_burtc.h

BURTC_Unlock#

void BURTC_Unlock (void )

Unlock BURTC registers, which will enable write access to change configuration.

Parameters
N/A

Definition at line 451 of file platform/emlib/inc/em_burtc.h

Macro Definition Documentation#

burtcClkDiv_1#

#define burtcClkDiv_1
Value:
1

BURTC clock divisors.

These values are valid for the BURTC prescaler. Divide clock by 1.


Definition at line 55 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_2#

#define burtcClkDiv_2
Value:
2

Divide clock by 2.


Definition at line 56 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_4#

#define burtcClkDiv_4
Value:
4

Divide clock by 4.


Definition at line 57 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_8#

#define burtcClkDiv_8
Value:
8

Divide clock by 8.


Definition at line 58 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_16#

#define burtcClkDiv_16
Value:
16

Divide clock by 16.


Definition at line 59 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_32#

#define burtcClkDiv_32
Value:
32

Divide clock by 32.


Definition at line 60 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_64#

#define burtcClkDiv_64
Value:
64

Divide clock by 64.


Definition at line 61 of file platform/emlib/inc/em_burtc.h

burtcClkDiv_128#

#define burtcClkDiv_128
Value:
128

Divide clock by 128.


Definition at line 62 of file platform/emlib/inc/em_burtc.h

BURTC_INIT_DEFAULT#

#define BURTC_INIT_DEFAULT
Value:
{ \
true, \
false, \
1, \
0, \
false, \
false, \
}

Default configuration for BURTC init structure.


Definition at line 150 of file platform/emlib/inc/em_burtc.h