Functions
Configuration functions
Peripheral Driver » LL Driver » RTC » Functions

## Functions
__STATIC_INLINE void | ll_rtc_enable (rtc_regs_t *RTCx)
| Enable RTC counter. More...
__STATIC_INLINE void | ll_rtc_disable (rtc_regs_t *RTCx)
| Disable RTC counter. More...
__STATIC_INLINE uint32_t | ll_rtc_is_enabled (rtc_regs_t *RTCx)
| Check if the RTC peripheral is enabled or disabled. More...
__STATIC_INLINE void | ll_rtc_reload_counter (rtc_regs_t *RTCx, uint32_t counter)
| Reloads RTC counter. More...
__STATIC_INLINE void | ll_rtc_start_value_set_and_request (rtc_regs_t *RTCx, uint32_t start_value)
| Reloads RTC counter and request. More...
__STATIC_INLINE void | ll_rtc_reload_alarm (rtc_regs_t *RTCx, uint32_t value)
| Reloads RTC alarm. More...
__STATIC_INLINE void | ll_rtc_alarm_value_set_and_request (rtc_regs_t *RTCx, uint32_t alarm_value)
| Reloads RTC alarm and request. More...
__STATIC_INLINE void | ll_rtc_reload_tick (rtc_regs_t *RTCx, uint32_t tick)
| Reloads RTC perd_alarm. More...
__STATIC_INLINE void | ll_rtc_tick_value_set_and_request (rtc_regs_t *RTCx, uint32_t alarm_value)
| Reloads RTC tick and request. More...
__STATIC_INLINE uint32_t | ll_rtc_get_write_counter (rtc_regs_t *RTCx)
| Read the RTC counter config value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_read_counter (rtc_regs_t *RTCx)
| Read the RTC counter current value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_write_alarm (rtc_regs_t *RTCx)
| Read the RTC counter config alarm value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_read_alarm (rtc_regs_t *RTCx)
| Read the RTC counter current alarm value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_write_tick (rtc_regs_t *RTCx)
| Read the RTC counter config tick value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_read_tick (rtc_regs_t *RTCx)
| Read the RTC counter current tick value. More...
__STATIC_INLINE uint32_t | ll_rtc_get_wrapcnt (rtc_regs_t *RTCx)
| Get the RTC wrap-around value. More...
__STATIC_INLINE uint32_t | ll_rtc_is_busy (rtc_regs_t *RTCx)
| The RTC is busy. More...
__STATIC_INLINE uint32_t | ll_rtc_is_running (rtc_regs_t *RTCx)
| The RTC is running. More...
__STATIC_INLINE void | ll_rtc_clear_wrap_and_request (rtc_regs_t *RTCx)
| CLear RTC wrap. More...
__STATIC_INLINE void | ll_rtc_set_clock_div (rtc_regs_t *RTCx, uint32_t div)
| Select the RTC clock divider. More...
__STATIC_INLINE void | ll_rtc_set_alarm (rtc_regs_t *RTCx, uint32_t value)
| Set RTC alarm. More...
__STATIC_INLINE void | ll_rtc_it_enable_alarm (rtc_regs_t *RTCx)
| Enable RTC alarm interrupt. More...
__STATIC_INLINE void | ll_rtc_disable_alarm (rtc_regs_t *RTCx)
| Disable RTC alarm. More...
__STATIC_INLINE void | ll_rtc_it_disable_alarm (rtc_regs_t *RTCx)
| Disable RTC alarm interrupt. More...
__STATIC_INLINE uint32_t | ll_rtc_it_is_enabled_alarm (rtc_regs_t *RTCx)
| Check if the RTC alarm interrupt is enabled or disabled. More...
__STATIC_INLINE void | ll_rtc_set_tick_mode (rtc_regs_t *RTCx, uint8_t tick_mode)
| Set RTCx alarm_mode. More...
__STATIC_INLINE void | ll_rtc_it_enable_tick (rtc_regs_t *RTCx)
| Enable RTC tick interrupt. More...
__STATIC_INLINE void | ll_rtc_disable_tick (rtc_regs_t *RTCx)
| Disable RTCx tick. More...
__STATIC_INLINE void | ll_rtc_it_disable_tick (rtc_regs_t *RTCx)
| Disable RTC tick interrupt. More...
__STATIC_INLINE uint32_t | ll_rtc_it_is_enabled_tick (rtc_regs_t *RTCx)
| Check if the RTC alarm interrupt is enabled or disabled. More...
__STATIC_INLINE void | ll_rtc_reload_tick_and_request (rtc_regs_t *RTCx, uint32_t tick_reload)
| Reloads RTCx tick counter and request. More...
__STATIC_INLINE void | ll_rtc_restart_tick (rtc_regs_t *RTCx)
| Restart RTCx tick counter and request. More...
__STATIC_INLINE void | ll_rtc_it_enable_wrap (rtc_regs_t *RTCx)
| Enable RTC wrap interrupt. More...
__STATIC_INLINE void | ll_rtc_it_disable_wrap (rtc_regs_t *RTCx)
| Disable RTC wrap interrupt. More...
__STATIC_INLINE uint32_t | ll_rtc_it_is_enabled_wrap (rtc_regs_t *RTCx)
| Check if the RTC wrap interrupt is enabled or disabled. More...

## Detailed Description

## Function Documentation

## ◆ ll_rtc_alarm_value_set_and_request()

__STATIC_INLINE void ll_rtc_alarm_value_set_and_request | ( | rtc_regs_t * | RTCx,
|  | uint32_t | alarm_value
| ) |  |

Reloads RTC alarm and request.

Register|BitsName --------|-------- RTC_ALARM_W | ALARM_VAL_LOAD RTC_CFG0 | ALARM_VALUE

Parameters

  RTCx | RTC instance
  alarm_value | RTC alarm value

Return values

  None |

Definition at line 222 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_clear_wrap_and_request()

__STATIC_INLINE void ll_rtc_clear_wrap_and_request | ( | rtc_regs_t * | RTCx | ) |

CLear RTC wrap.

Register|BitsName --------|-------- RTC_CFG0 | Wrap counter clear

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 409 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_disable()

__STATIC_INLINE void ll_rtc_disable | ( | rtc_regs_t * | RTCx | ) |

Disable RTC counter.

Register|BitsName --------|-------- RTC_CFG0 | EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 140 of file ll_rtc.h.

## ◆ ll_rtc_disable_alarm()

__STATIC_INLINE void ll_rtc_disable_alarm | ( | rtc_regs_t * | RTCx | ) |

Disable RTC alarm.

Register|BitsName --------|-------- RTC_TIMER_CTL | ALARM_DISBALE

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 480 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_disable_tick()

__STATIC_INLINE void ll_rtc_disable_tick | ( | rtc_regs_t * | RTCx | ) |

Disable RTCx tick.

Register|BitsName --------|-------- RTCx_TIMER_CTL | TICK_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 566 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_enable()

__STATIC_INLINE void ll_rtc_enable | ( | rtc_regs_t * | RTCx | ) |

Enable RTC counter.

Register|BitsName --------|-------- RTC_CFG0 | EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 125 of file ll_rtc.h.

## ◆ ll_rtc_get_read_alarm()

__STATIC_INLINE uint32_t ll_rtc_get_read_alarm | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter current alarm value.

Register|BitsName --------|-------- RTC_ALARM_R | CAL_ALARM

Parameters

  RTCx | RTC instance

Return values

  Value | for current alarm which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 317 of file ll_rtc.h.

## ◆ ll_rtc_get_read_counter()

__STATIC_INLINE uint32_t ll_rtc_get_read_counter | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter current value.

Register|BitsName --------|-------- RTC_TIMER_R | TIMER_VAL_READ

Parameters

  RTCx | RTC instance

Return values

  Value | for current counter which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 287 of file ll_rtc.h.

## ◆ ll_rtc_get_read_tick()

__STATIC_INLINE uint32_t ll_rtc_get_read_tick | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter current tick value.

Register|BitsName --------|-------- RTC_TICK_R | TICK_RD

Parameters

  RTCx | RTC instance

Return values

  Value | for current tick which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 347 of file ll_rtc.h.

## ◆ ll_rtc_get_wrapcnt()

__STATIC_INLINE uint32_t ll_rtc_get_wrapcnt | ( | rtc_regs_t * | RTCx | ) |

Get the RTC wrap-around value.

Note
  The value should be read multiple times until get the same value in at least two reads.

Register|BitsName --------|-------- RTC_STAT | WRAP_CNT

Parameters

  RTCx | RTC instance

Return values

  Value | between Min_Data=0 and Max_Data=0xF

Definition at line 363 of file ll_rtc.h.

## ◆ ll_rtc_get_write_alarm()

__STATIC_INLINE uint32_t ll_rtc_get_write_alarm | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter config alarm value.

Register|BitsName --------|-------- RTC_ALARM_W | CAL_ALARM

Parameters

  RTCx | RTC instance

Return values

  Value | for current alarm which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 302 of file ll_rtc.h.

## ◆ ll_rtc_get_write_counter()

__STATIC_INLINE uint32_t ll_rtc_get_write_counter | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter config value.

Register|BitsName --------|-------- RTC_TIMER_W | TIMER_VAL_READ

Parameters

  RTCx | RTC instance

Return values

  Value | for current counter which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 272 of file ll_rtc.h.

## ◆ ll_rtc_get_write_tick()

__STATIC_INLINE uint32_t ll_rtc_get_write_tick | ( | rtc_regs_t * | RTCx | ) |

Read the RTC counter config tick value.

Register|BitsName --------|-------- RTC_TICK_W | TICK_SET

Parameters

  RTCx | RTC instance

Return values

  Value | for current tick which should ranging between 0 ~ 0xFFFF_FFFF

Definition at line 332 of file ll_rtc.h.

## ◆ ll_rtc_is_busy()

__STATIC_INLINE uint32_t ll_rtc_is_busy | ( | rtc_regs_t * | RTCx | ) |

The RTC is busy.

Register|BitsName --------|-------- RTC_STAT | BUSY

Parameters

  RTCx | RTC instance

Return values

  Value | between Min_Data=0 and Max_Data=0xF

Definition at line 378 of file ll_rtc.h.

## ◆ ll_rtc_is_enabled()

__STATIC_INLINE uint32_t ll_rtc_is_enabled | ( | rtc_regs_t * | RTCx | ) |

Check if the RTC peripheral is enabled or disabled.

Register|BitsName --------|-------- RTC_CFG0 | EN

Parameters

  RTCx | RTC instance

Return values

  State | of bit (1 or 0).

Definition at line 155 of file ll_rtc.h.

## ◆ ll_rtc_is_running()

__STATIC_INLINE uint32_t ll_rtc_is_running | ( | rtc_regs_t * | RTCx | ) |

The RTC is running.

Register|BitsName --------|-------- RTC_STAT | RUNNING

Parameters

  RTCx | RTC instance

Return values

  Value | between Min_Data=0 and Max_Data=0xF

Definition at line 393 of file ll_rtc.h.

## ◆ ll_rtc_it_disable_alarm()

__STATIC_INLINE void ll_rtc_it_disable_alarm | ( | rtc_regs_t * | RTCx | ) |

Disable RTC alarm interrupt.

Register|BitsName --------|-------- RTC_INT_EN | ALARM_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 495 of file ll_rtc.h.

## ◆ ll_rtc_it_disable_tick()

__STATIC_INLINE void ll_rtc_it_disable_tick | ( | rtc_regs_t * | RTCx | ) |

Disable RTC tick interrupt.

Register|BitsName --------|-------- RTC_INT_EN | TICK0_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 581 of file ll_rtc.h.

## ◆ ll_rtc_it_disable_wrap()

__STATIC_INLINE void ll_rtc_it_disable_wrap | ( | rtc_regs_t * | RTCx | ) |

Disable RTC wrap interrupt.

Register|BitsName --------|-------- RTC_TIMER_CTL | WRAP_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 661 of file ll_rtc.h.

## ◆ ll_rtc_it_enable_alarm()

__STATIC_INLINE void ll_rtc_it_enable_alarm | ( | rtc_regs_t * | RTCx | ) |

Enable RTC alarm interrupt.

Register|BitsName --------|-------- RTC_TIMER_CTL | ALARM_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 465 of file ll_rtc.h.

## ◆ ll_rtc_it_enable_tick()

__STATIC_INLINE void ll_rtc_it_enable_tick | ( | rtc_regs_t * | RTCx | ) |

Enable RTC tick interrupt.

Register|BitsName --------|-------- RTC_INT_EN | TICK_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 551 of file ll_rtc.h.

## ◆ ll_rtc_it_enable_wrap()

__STATIC_INLINE void ll_rtc_it_enable_wrap | ( | rtc_regs_t * | RTCx | ) |

Enable RTC wrap interrupt.

Register|BitsName --------|-------- RTC_TIMER_CTL | WRAP_INT_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 646 of file ll_rtc.h.

## ◆ ll_rtc_it_is_enabled_alarm()

__STATIC_INLINE uint32_t ll_rtc_it_is_enabled_alarm | ( | rtc_regs_t * | RTCx | ) |

Check if the RTC alarm interrupt is enabled or disabled.

Register|BitsName --------|-------- RTC_TIMER_CTL | ALARM_INT_EN

Parameters

  RTCx | RTC instance

Return values

  State | of bit (1 or 0).

Definition at line 510 of file ll_rtc.h.

## ◆ ll_rtc_it_is_enabled_tick()

__STATIC_INLINE uint32_t ll_rtc_it_is_enabled_tick | ( | rtc_regs_t * | RTCx | ) |

Check if the RTC alarm interrupt is enabled or disabled.

Register|BitsName --------|-------- RTC_TIMER_CTL | TICK_EN RTC_INT_EN | TICK_INT_EN

Parameters

  RTCx | RTC instance

Return values

  State | of bit (1 or 0).

Definition at line 597 of file ll_rtc.h.

## ◆ ll_rtc_it_is_enabled_wrap()

__STATIC_INLINE uint32_t ll_rtc_it_is_enabled_wrap | ( | rtc_regs_t * | RTCx | ) |

Check if the RTC wrap interrupt is enabled or disabled.

Register|BitsName --------|-------- RTC_TIMER_CTL | WRAP_INT_EN

Parameters

  RTCx | RTC instance

Return values

  State | of bit (1 or 0).

Definition at line 676 of file ll_rtc.h.

## ◆ ll_rtc_reload_alarm()

__STATIC_INLINE void ll_rtc_reload_alarm | ( | rtc_regs_t * | RTCx,
|  | uint32_t | value
| ) |  |

Reloads RTC alarm.

Register|BitsName --------|-------- RTC_TIMER_W | ALARM_VAL_LOAD

Parameters

  RTCx | RTC instance
  value | RTC alarm value

Return values

  None |

Definition at line 205 of file ll_rtc.h.

## ◆ ll_rtc_reload_counter()

__STATIC_INLINE void ll_rtc_reload_counter | ( | rtc_regs_t * | RTCx,
|  | uint32_t | counter
| ) |  |

Reloads RTC counter.

Register|BitsName --------|-------- RTC_TIMER_W | TIMER_VALUE

Parameters

  RTCx | RTC instance
  counter | RTC counter

Return values

  None |

Definition at line 171 of file ll_rtc.h.

## ◆ ll_rtc_reload_tick()

__STATIC_INLINE void ll_rtc_reload_tick | ( | rtc_regs_t * | RTCx,
|  | uint32_t | tick
| ) |  |

Reloads RTC perd_alarm.

Register|BitsName --------|-------- RTC_TIMER_W | ALARM_VAL_LOAD

Parameters

  RTCx | RTC instance
  tick | RTC tick value

Return values

  None |

Definition at line 239 of file ll_rtc.h.

## ◆ ll_rtc_reload_tick_and_request()

__STATIC_INLINE void ll_rtc_reload_tick_and_request | ( | rtc_regs_t * | RTCx,
|  | uint32_t | tick_reload
| ) |  |

Reloads RTCx tick counter and request.

Register|BitsName --------|-------- RTCx_TIMER_W | TIMER_VALUE RTCx_CFG0 | VAL_LOAD

Parameters

  RTCx | RTC instance
  tick_reload | RTC tick counter

Return values

  None |

Definition at line 615 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_restart_tick()

__STATIC_INLINE void ll_rtc_restart_tick | ( | rtc_regs_t * | RTCx | ) |

Restart RTCx tick counter and request.

Register|BitsName --------|-------- RTCx_CFG0 | RTC_CFG0_TICK_EN

Parameters

  RTCx | RTC instance

Return values

  None |

Definition at line 631 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_set_alarm()

__STATIC_INLINE void ll_rtc_set_alarm | ( | rtc_regs_t * | RTCx,
|  | uint32_t | value
| ) |  |

Set RTC alarm.

Register|BitsName --------|-------- RTC_TIMER_CTL | ALARM_EN

Parameters

  RTCx | RTC instance
  value | RTC alarm value

Return values

  None |

Definition at line 449 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_set_clock_div()

__STATIC_INLINE void ll_rtc_set_clock_div | ( | rtc_regs_t * | RTCx,
|  | uint32_t | div
| ) |  |

Select the RTC clock divider.

Register|BitsName --------|-------- RTC_CFG1 | CLK_SEL

Parameters

  RTCx | RTC instance
  div | This parameter can be one of the following values: LL_RTC_DIV_NONE LL_RTC_DIV_2 LL_RTC_DIV_4 LL_RTC_DIV_8 LL_RTC_DIV_16 LL_RTC_DIV_32 LL_RTC_DIV_64 LL_RTC_DIV_128

Return values

  None |

Definition at line 433 of file ll_rtc.h.

## ◆ ll_rtc_set_tick_mode()

__STATIC_INLINE void ll_rtc_set_tick_mode | ( | rtc_regs_t * | RTCx,
|  | uint8_t | tick_mode
| ) |  |

Set RTCx alarm_mode.

Register|BitsName --------|-------- RTCx_TIMER_CTL | TICK_EN

Parameters

  RTCx | RTC instance
  tick_mode | This parameter can be a one of the following values: LL_RTC_TIMER_TICK_TYPE_SINGLE LL_RTC_TIMER_TICK_TYPE_AUTO

Return values

  None |

Definition at line 529 of file ll_rtc.h.

## ◆ ll_rtc_start_value_set_and_request()

__STATIC_INLINE void ll_rtc_start_value_set_and_request | ( | rtc_regs_t * | RTCx,
|  | uint32_t | start_value
| ) |  |

Reloads RTC counter and request.

Register|BitsName --------|-------- RTC_TIMER_W | TIMER_VALUE RTC_CFG0 | VAL_LOAD

Parameters

  RTCx | RTC instance
  start_value | RTC counter

Return values

  None |

Definition at line 188 of file ll_rtc.h.

References READ_CFG0_CFG.

## ◆ ll_rtc_tick_value_set_and_request()

__STATIC_INLINE void ll_rtc_tick_value_set_and_request | ( | rtc_regs_t * | RTCx,
|  | uint32_t | alarm_value
| ) |  |

Reloads RTC tick and request.

Register|BitsName --------|-------- RTC_TICK_W | TICK_VAL_LOAD RTC_CFG0 | TICK_VALUE

Parameters

  RTCx | RTC instance
  alarm_value | RTC tick value

Return values

  None |

Definition at line 256 of file ll_rtc.h.

References READ_CFG0_CFG.