LL RTC Constants

Alarm A and alarm B

group RTC_LL_EC_ALM

Defines

LL_RTC_ALARM_A 0U

Alarm A

LL_RTC_ALARM_B 1U

Alarm B

RTC alarm A date weekday

group RTC_LL_EC_ALMA_WEEKDAY_SELECTION

Defines

LL_RTC_ALMA_DATEWEEKDAYSEL_DATE 0U

Alarm A Date is selected

LL_RTC_ALMA_DATEWEEKDAYSEL_WEEKDAY RTC_ALRMAR_WDSEL

Alarm A WeekDay is selected

RTC alarm B date weekday

group RTC_LL_EC_ALMB_WEEKDAY_SELECTION

Defines

LL_RTC_ALMB_DATEWEEKDAYSEL_DATE 0U

Alarm B Date is selected

LL_RTC_ALMB_DATEWEEKDAYSEL_WEEKDAY RTC_ALRMBR_WDSEL

Alarm B WeekDay is selected

Timestamp flags defines

group RTC_LL_EC_TIMESTAMP_FLAGS

Timestamp flags defines.

Defines

LL_RTC_SR_TSOVF RTC_SR_TSOVF

Timestamp overflow event

LL_RTC_SR_TSF RTC_SR_TSF

Timestamp event

Clear flags defines

group RTC_LL_EC_CLEAR_FLAG

Flags defines which can be used with LL_RTC_WRITE_REG function.

Defines

LL_RTC_SCR_SSRUF RTC_SCR_CSSRUF

Clear SSR underflow event

LL_RTC_SCR_TSOVF RTC_SCR_CTSOVF

Clear timestamp overflow event

LL_RTC_SCR_TSF RTC_SCR_CTSF

Clear timestamp event

LL_RTC_SCR_WUTF RTC_SCR_CWUTF

Clear wake-up timer event

LL_RTC_SCR_ALRBF RTC_SCR_CALRBF

Clear alarm B event

LL_RTC_SCR_ALRAF RTC_SCR_CALRAF

Clear alarm A event

Get flags defines

group RTC_LL_EC_GET_FLAG

Flags defines which can be used with LL_RTC_READ_REG function.

Defines

LL_RTC_ICSR_RECALPF RTC_ICSR_RECALPF

Recalibration pending event

LL_RTC_ICSR_INITF RTC_ICSR_INITF

Initialization flag

LL_RTC_ICSR_RSF RTC_ICSR_RSF

Registers synchronization event

LL_RTC_ICSR_INITS RTC_ICSR_INITS

Initialization status event

LL_RTC_ICSR_SHPF RTC_ICSR_SHPF

Shift operation pending event

LL_RTC_ICSR_WUTWF RTC_ICSR_WUTWF

Wake-up timer write event

BCD defines

group RTC_LL_EC_BCD

BCD defines which can be used with LL_RTC_READ_REG and LL_RTC_WRITE_REG functions.

Defines

LL_RTC_ICSR_BCDU_2 RTC_ICSR_BCDU_2

1s calendar increment is generated each time SS[9:0]

LL_RTC_ICSR_BCDU_1 RTC_ICSR_BCDU_1

1s calendar increment is generated each time SS[8:0]

LL_RTC_ICSR_BCDU_0 RTC_ICSR_BCDU_0

1s calendar increment is generated each time SS[7:0]

LL_RTC_ICSR_BIN_1 RTC_ICSR_BIN_1

Free-running Binary mode (BCD mode disabled)

LL_RTC_ICSR_BIN_0 RTC_ICSR_BIN_0

Free-running BCD calendar mode (Binary mode disabled)

IT defines

group RTC_LL_EC_IT

IT defines which can be used with LL_RTC_READ_REG and LL_RTC_WRITE_REG functions.

Defines

LL_RTC_CR_TSIE RTC_CR_TSIE

Timestamp on internal event enable

LL_RTC_CR_WUTIE RTC_CR_WUTIE

Wake-up timer interrupt enable

LL_RTC_CR_ALRBIE RTC_CR_ALRBIE

Alarm B interrupt enable

LL_RTC_CR_ALRAIE RTC_CR_ALRAIE

Alarm A interrupt enable

Weekday

group RTC_LL_EC_WEEKDAY

Defines

LL_RTC_WEEKDAY_MONDAY (uint32_t)0x01

Monday

LL_RTC_WEEKDAY_TUESDAY (uint32_t)0x02

Tuesday

LL_RTC_WEEKDAY_WEDNESDAY (uint32_t)0x03

Wednesday

LL_RTC_WEEKDAY_THURSDAY (uint32_t)0x04

Thursday

LL_RTC_WEEKDAY_FRIDAY (uint32_t)0x05

Friday

LL_RTC_WEEKDAY_SATURDAY (uint32_t)0x06

Saturday

LL_RTC_WEEKDAY_SUNDAY (uint32_t)0x07

Sunday

Month

group RTC_LL_EC_MONTH

Defines

LL_RTC_MONTH_JANUARY (uint32_t)0x01

January

LL_RTC_MONTH_FEBRUARY (uint32_t)0x02

February

LL_RTC_MONTH_MARCH (uint32_t)0x03

March

LL_RTC_MONTH_APRIL (uint32_t)0x04

April

LL_RTC_MONTH_MAY (uint32_t)0x05

May

LL_RTC_MONTH_JUNE (uint32_t)0x06

June

LL_RTC_MONTH_JULY (uint32_t)0x07

July

LL_RTC_MONTH_AUGUST (uint32_t)0x08

August

LL_RTC_MONTH_SEPTEMBER (uint32_t)0x09

September

LL_RTC_MONTH_OCTOBER (uint32_t)0x10

October

LL_RTC_MONTH_NOVEMBER (uint32_t)0x11

November

LL_RTC_MONTH_DECEMBER (uint32_t)0x12

December

Hour format

group RTC_LL_EC_HOUR_FORMAT

Defines

LL_RTC_HOUR_FORMAT_24HOUR 0U

24 hour/day format

LL_RTC_HOUR_FORMAT_AMPM RTC_CR_FMT

AM/PM hour format

Reference clock

group RTC_LL_EC_REF_CLOCK

Defines

LL_RTC_REF_CLOCK_DISABLE 0U

Reference clock detection disabled

LL_RTC_REF_CLOCK_ENABLE RTC_CR_REFCKON

Reference clock detection enabled

Shadow register

group RTC_LL_EC_SHADOW_REGISTER

Defines

LL_RTC_SHADOW_REG_KEEP 0U

Bypass shadow register disabled

LL_RTC_SHADOW_REG_BYPASS RTC_CR_BYPSHAD

Bypass shadow register enabled

Backup register for daylight saving time

group RTC_LL_EC_BKP_REGISTER

Defines

LL_RTC_BKP_REGISTER_UNSET 0U

Daylight time change has not been performed

LL_RTC_BKP_REGISTER_SET RTC_CR_BKP

Daylight time change has been performed

Alarm output

group RTC_LL_EC_ALARMOUT

Defines

LL_RTC_ALARMOUT_DISABLE 0U

Output disabled

LL_RTC_ALARMOUT_ALARM_A RTC_CR_OSEL_0

Alarm A output enabled

LL_RTC_ALARMOUT_ALARM_B RTC_CR_OSEL_1

Alarm B output enabled

LL_RTC_ALARMOUT_WAKEUP RTC_CR_OSEL

Wake-up output enabled

Alarm output type

group RTC_LL_EC_ALARM_OUTPUTTYPE

Defines

LL_RTC_ALARM_OUTPUTTYPE_PUSHPULL 0U

RTC_ALARM is push-pull output

LL_RTC_ALARM_OUTPUTTYPE_OPENDRAIN RTC_CR_TAMPALRM_TYPE

RTC_ALARM is open-drain output

Alarm output pull-up

group RTC_LL_EC_ALARM_OUTPUT_PULLUP

Defines

LL_RTC_ALARM_OUTPUT_PULLUP_NONE 0U

No pull-up is applied on TAMPALRM output

LL_RTC_ALARM_OUTPUT_PULLUP_ON RTC_CR_TAMPALRM_PU

A pull-up is applied on TAMPALRM output

Alarm output remap

group RTC_LL_EC_ALARM_OUTPUT_REMAP

Defines

LL_RTC_ALARM_OUTPUT_REMAP_NONE 0U

RTC_OUT2 output disabled

LL_RTC_ALARM_OUTPUT_REMAP_POS1 RTC_CR_OUT2EN

RTC_OUT2 output enabled

Output polarity pin

group RTC_LL_EC_OUTPUTPOLARITY_PIN

Defines

LL_RTC_OUTPUTPOLARITY_PIN_HIGH 0U

Pin is high when selected TAMPALRM is asserted

LL_RTC_OUTPUTPOLARITY_PIN_LOW RTC_CR_POL

Pin is low when selected TAMPALRM is asserted

Time format

group RTC_LL_EC_TIME_FORMAT

Defines

LL_RTC_TIME_FORMAT_AM_24H 0U

AM or 24-hour format

LL_RTC_TIME_FORMAT_PM RTC_TR_PM

PM

Shift second

group RTC_LL_EC_SHIFT_SECOND

Defines

LL_RTC_SHIFT_SECOND_DELAY 0U

Delay (seconds) = SUBFS / (PREDIV_S + 1)

LL_RTC_SHIFT_SECOND_ADVANCE RTC_SHIFTR_ADD1S

Advance (seconds) = (1-(SUBFS/(PREDIV_S+1)))

ALARMA mask

group RTC_LL_EC_ALMA_MASK

Defines

LL_RTC_ALMA_MASK_NONE 0U

No masks applied on alarm A

LL_RTC_ALMA_MASK_DATEWEEKDAY RTC_ALRMAR_MSK4

Date/day ignored in alarm A comparison

LL_RTC_ALMA_MASK_HOURS RTC_ALRMAR_MSK3

Hours ignored in alarm A comparison

LL_RTC_ALMA_MASK_MINUTES RTC_ALRMAR_MSK2

Minutes ignored in alarm A comparison

LL_RTC_ALMA_MASK_SECONDS RTC_ALRMAR_MSK1

Seconds ignored in alarm A comparison

LL_RTC_ALMA_MASK_ALL (RTC_ALRMAR_MSK4 | RTC_ALRMAR_MSK3 | RTC_ALRMAR_MSK2 | RTC_ALRMAR_MSK1)

Masks all

ALARMA time format

group RTC_LL_EC_ALMA_TIME_FORMAT

Defines

LL_RTC_ALMA_TIME_FORMAT_AM_24H 0U

AM or 24-hour format

LL_RTC_ALMA_TIME_FORMAT_PM RTC_ALRMAR_PM

PM

RTC alarm auto clear

group RTC_LL_EC_ALMA_AUTOCLR

Defines

LL_RTC_ALM_AUTOCLR_NO 0U

Alarm autoclear disabled

LL_RTC_ALM_AUTOCLR_YES RTC_CR_ALRAFCLR

Alarm autoclear enabled

RTC alarm sub seconds with binary mode auto clear definitions

group RTC_LL_EC_ALMA_SUBSECONDBIN_AUTOCLR

Defines

LL_RTC_ALMA_SUBSECONDBIN_AUTOCLR_NO 0UL

The synchronous binary counter \ (SS[31:0] in RTC_SSR) is free-running

LL_RTC_ALMA_SUBSECONDBIN_AUTOCLR_YES RTC_ALRMASSR_SSCLR

The synchronous binary counter (SS[31:0] \ in RTC_SSR) is running from 0xFFFF FFFF to \ -> SS[31:0] value and is automatically \ reloaded with 0xFFFF FFFF when reaching \ RTC_ALRABINR -> SS[31:0]

ALARMB mask

group RTC_LL_EC_ALMB_MASK

Defines

LL_RTC_ALMB_MASK_NONE 0U

No masks applied on Alarm B

LL_RTC_ALMB_MASK_DATEWEEKDAY RTC_ALRMBR_MSK4

Date/day ignored in alarm B comparison

LL_RTC_ALMB_MASK_HOURS RTC_ALRMBR_MSK3

Hours ignored in alarm B comparison

LL_RTC_ALMB_MASK_MINUTES RTC_ALRMBR_MSK2

Minutes ignored in alarm B comparison

LL_RTC_ALMB_MASK_SECONDS RTC_ALRMBR_MSK1

Seconds ignored in alarm B comparison

LL_RTC_ALMB_MASK_ALL (RTC_ALRMBR_MSK4 | RTC_ALRMBR_MSK3 | RTC_ALRMBR_MSK2 | RTC_ALRMBR_MSK1)

Masks all

ALARMB time format

group RTC_LL_EC_ALMB_TIME_FORMAT

Defines

LL_RTC_ALMB_TIME_FORMAT_AM_24H 0U

AM or 24-hour format

LL_RTC_ALMB_TIME_FORMAT_PM RTC_ALRMBR_PM

PM

Alarm sub seconds with binary mode auto clear definitions

group RTC_LL_EC_ALMB_SUBSECONDBIN_AUTOCLR

Defines

LL_RTC_ALMB_SUBSECONDBIN_AUTOCLR_NO 0UL

The synchronous binary counter \ (SS[31:0] in RTC_SSR) is free-running

LL_RTC_ALMB_SUBSECONDBIN_AUTOCLR_YES RTC_ALRMBSSR_SSCLR

The synchronous binary counter \ (SS[31:0] in RTC_SSR) is running \ from 0xFFFF FFFF to RTC_ALRABINR -> SS[31:0]\ value and is automatically reloaded with \ 0xFFFF FFFF when reaching \ RTC_ALRABINR -> SS[31:0]

Timestamp edge

group RTC_LL_EC_TIMESTAMP_EDGE

Defines

LL_RTC_TIMESTAMP_EDGE_RISING 0U

RTC_TS input rising edge generates a time-stamp event

LL_RTC_TIMESTAMP_EDGE_FALLING RTC_CR_TSEDGE

RTC_TS input falling edge generates a time-stamp event

Timestamp pin source enable

group RTC_LL_EC_TIMESTAMP_PIN_ENABLE

Defines

LL_RTC_TIMESTAMP_PIN_DISABLE 0U

Timestamp disabled

LL_RTC_TIMESTAMP_PIN_ENABLE RTC_CR_TSE

Timestamp enabled

Timestamp tamper source enable

group RTC_LL_EC_TIMESTAMP_TAMPER_ENABLE

Defines

LL_RTC_TIMESTAMP_TAMPER_DISABLE 0U

Disable timestamp on tamper detection event

LL_RTC_TIMESTAMP_TAMPER_ENABLE RTC_CR_TAMPTS

Enable timestamp on tamper detection event

Timestamp time format

group RTC_LL_EC_TS_TIME_FORMAT

Defines

LL_RTC_TS_TIME_FORMAT_AM_24H 0U

AM or 24-hour format

LL_RTC_TS_TIME_FORMAT_PM RTC_TSTR_PM

PM

Wakeup clock div

group RTC_LL_EC_WAKEUPCLOCK_DIV

Defines

LL_RTC_WAKEUPCLOCK_DIV_16 0U

RTC/16 clock is selected

LL_RTC_WAKEUPCLOCK_DIV_8 RTC_CR_WUCKSEL_0

RTC/8 clock is selected

LL_RTC_WAKEUPCLOCK_DIV_4 RTC_CR_WUCKSEL_1

RTC/4 clock is selected

LL_RTC_WAKEUPCLOCK_DIV_2 (RTC_CR_WUCKSEL_1 | RTC_CR_WUCKSEL_0)

RTC/2 clock is selected

LL_RTC_WAKEUPCLOCK_CKSPRE RTC_CR_WUCKSEL_2

ck_spre (usually 1 Hz) clock is selected

LL_RTC_WAKEUPCLOCK_CKSPRE_WUT (RTC_CR_WUCKSEL_2 | RTC_CR_WUCKSEL_1)

ck_spre (usually 1 Hz) clock is selected and 2exp16 is added to the WUT counter value

Tamper event output

group RTC_LL_EC_TAMPER_OUTPUT

Defines

LL_RTC_OUTPUT_TAMPER_DISABLE 0U

Disable Tamper detection output

LL_RTC_OUTPUT_TAMPER_ENABLE RTC_CR_TAMPOE

Enable Tamper detection output

Calibration frequency output

group RTC_LL_EC_CALIB_FREQUENCY_OUTPUT

Defines

LL_RTC_CALIB_FREQUENCY_512HZ 0U

Calibration output is 512 Hz

LL_RTC_CALIB_FREQUENCY_1HZ RTC_CR_COSEL

Calibration output is 1 Hz

Calibration output

group RTC_LL_EC_CALIB_OUTPUT

Defines

LL_RTC_CALIB_OUTPUT_NONE 0U

Calibration output disabled

LL_RTC_CALIB_OUTPUT_ENABLE RTC_CR_COE

Calibration output enabled with current configuration

LL_RTC_CALIB_OUTPUT_1HZ (RTC_CR_COE | RTC_CR_COSEL)

Calibration output is 1 Hz

LL_RTC_CALIB_OUTPUT_512HZ RTC_CR_COE

Calibration output is 512 Hz

Calibration pulse insertion

group RTC_LL_EC_CALIB_INSERTPULSE

Defines

LL_RTC_CALIB_INSERTPULSE_NONE 0U

No RTCCLK pulses are added

LL_RTC_CALIB_INSERTPULSE_SET RTC_CALR_CALP

One RTCCLK pulse is effectively inserted every 2exp11 pulses (frequency increased by 488.5 ppm)

Calibration period

group RTC_LL_EC_CALIB_PERIOD

Defines

LL_RTC_CALIB_PERIOD_32SEC 0U

Use a 32-second calibration cycle period

LL_RTC_CALIB_PERIOD_16SEC RTC_CALR_CALW16

Use a 16-second calibration cycle period

LL_RTC_CALIB_PERIOD_8SEC RTC_CALR_CALW8

Use an 8-second calibration cycle period

Calibration low power

group RTC_LL_EC_CALIB_LOWPOWER

Defines

LL_RTC_CALIB_LOWPOWER_NONE 0U

High-consumption mode

LL_RTC_CALIB_LOWPOWER_SET RTC_CALR_LPCAL

Ultra-low consumption mode

Binary mode (sub second register)

group RTC_LL_EC_BINARY_MODE

Defines

LL_RTC_BINARY_NONE 0U

Free-running BCD calendar mode (Binary mode disabled)

LL_RTC_BINARY_ONLY RTC_ICSR_BIN_0

Free-running Binary mode (BCD mode disabled)

LL_RTC_BINARY_MIX RTC_ICSR_BIN_1

Free-running BCD calendar and Binary mode enabled

Calendar second incrementation in binary mix mode

group RTC_LL_EC_BINARY_MIX_BCDU

Defines

LL_RTC_BINARY_MIX_BCDU_SHIFT RTC_ICSR_BCDU_Pos
LL_RTC_BINARY_MIX_BCDU_0 0U

1s calendar increment is generated each time SS[7:0] = 0

LL_RTC_BINARY_MIX_BCDU_1 (0x1UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[8:0] = 0

LL_RTC_BINARY_MIX_BCDU_2 (0x2UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[9:0] = 0

LL_RTC_BINARY_MIX_BCDU_3 (0x3UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[10:0] = 0

LL_RTC_BINARY_MIX_BCDU_4 (0x4UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[11:0] = 0

LL_RTC_BINARY_MIX_BCDU_5 (0x5UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[12:0] = 0

LL_RTC_BINARY_MIX_BCDU_6 (0x6UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[13:0] = 0

LL_RTC_BINARY_MIX_BCDU_7 (0x7UL << RTC_ICSR_BCDU_Pos)

1s calendar increment is generated each time SS[14:0] = 0

RTC privilege attributes configuration items

group RTC_privilege_attributes_configuration_items

Defines

HAL_RTC_PRIV_ITEM_ALRAPRIV LL_RTC_PRIV_ITEM_ALRAPRIV

Privilege attribute of alarm A and underflow protection

HAL_RTC_PRIV_ITEM_ALRBPRIV LL_RTC_PRIV_ITEM_ALRBPRIV

Privilege attribute of alarm B protection

HAL_RTC_PRIV_ITEM_WUTPRIV LL_RTC_PRIV_ITEM_WUTPRIV

Privilege attribute of wake-up timer protection

HAL_RTC_PRIV_ITEM_TSPRIV LL_RTC_PRIV_ITEM_TSPRIV

Privilege attribute of timestamp protection

HAL_RTC_PRIV_ITEM_CALPRIV LL_RTC_PRIV_ITEM_CALPRIV

Privilege attribute of shift register, daylight saving, calibration and reference clock protection

HAL_RTC_PRIV_ITEM_INITPRIV LL_RTC_PRIV_ITEM_INITPRIV

Privilege attribute of initialization protection

HAL_RTC_PRIV_ITEM_PRIV LL_RTC_PRIV_ITEM_PRIV

Privilege attribute of RTC global protection

HAL_RTC_PRIV_ITEM_ALL LL_RTC_PRIV_ITEM_ALL

Privilege attribute of all RTC resources

LL_RTC_ATTR_NPRIV 0UL

Non-privileged attribute

LL_RTC_ATTR_PRIV 1UL

Privileged attribute

LL_RTC_PRIV_ITEM_ALRAPRIV RTC_PRIVCFGR_ALRAPRIV

Privilege attribute of Alarm A and underflow protection

LL_RTC_PRIV_ITEM_ALRBPRIV RTC_PRIVCFGR_ALRBPRIV

Privilege attribute of Alarm B protection

LL_RTC_PRIV_ITEM_WUTPRIV RTC_PRIVCFGR_WUTPRIV

Privilege attribute of Wake-up timer protection

LL_RTC_PRIV_ITEM_TSPRIV RTC_PRIVCFGR_TSPRIV

Privilege attribute of Timestamp protection

LL_RTC_PRIV_ITEM_CALPRIV RTC_PRIVCFGR_CALPRIV

Privilege attribute of Shift register, daylightcalibration and reference clock protection

LL_RTC_PRIV_ITEM_INITPRIV RTC_PRIVCFGR_INITPRIV

Privilege attribute of Initialization protection

LL_RTC_PRIV_ITEM_PRIV RTC_PRIVCFGR_PRIV

Privilege attribute of RTC global protection

LL_RTC_PRIV_ITEM_ALL

(RTC_PRIVCFGR_ALRAPRIV | RTC_PRIVCFGR_ALRBPRIV | RTC_PRIVCFGR_WUTPRIV | \

RTC_PRIVCFGR_TSPRIV | RTC_PRIVCFGR_CALPRIV | RTC_PRIVCFGR_INITPRIV | \

RTC_PRIVCFGR_PRIV )


All RTC resources configuration item

Defines

LL_RTC_WAKEUP_TIMER_IT_DISABLE 0U

Wake-up timer interrupt disable

LL_RTC_WAKEUP_TIMER_IT_ENABLE RTC_CR_WUTIE

Wake-up timer interrupt enable

Defines

LL_RTC_ALMA_IT_DISABLE 0U

Alarm A interrupt disable

LL_RTC_ALMA_IT_ENABLE RTC_CR_ALRAIE

Alarm A interrupt enable

Defines

LL_RTC_ALMB_IT_DISABLE 0U

Alarm B interrupt disable

LL_RTC_ALMB_IT_ENABLE RTC_CR_ALRBIE

Alarm B interrupt enable

Defines

LL_RTC_TIMESTAMP_IT_DISABLE 0U

Timestamp interrupt disable

LL_RTC_TIMESTAMP_IT_ENABLE RTC_CR_TSIE

Timestamp interrupt enable

Defines

LL_RTC_SSRU_IT_DISABLE 0U

SSR underflow interrupt disable

LL_RTC_SSRU_IT_ENABLE RTC_CR_SSRUIE

SSR underflow interrupt enable

LL RTC Macros

group RTC_LL_Exported_Macros

Defines

LL_RTC_GET_BCDU ( value ) (((value) & RTC_ICSR_BCDU))

Helper macro to retrieve the value of BCD update.

Parameters :
Return values :

Value – of the BCD update in mixed mode

LL_RTC_GET_BIN ( value ) (((value) & RTC_ICSR_BIN))

Helper macro to retrieve the mode of RTC.

Parameters :
Return values :

Mode – of the RTC can be one of the value:

Defines

LL_RTC_WRITE_REG ( reg , value ) STM32_WRITE_REG(RTC->reg, (value))

Write a value in RTC register.

Parameters :

  • reg – Register to be written

  • value – Value to be written in the register

LL_RTC_READ_REG ( reg ) STM32_READ_REG(RTC->reg)

Read a value in RTC register.

Parameters :

  • reg – Register to be read

Return values :

Register – value

Defines

LL_RTC_CONVERT_BIN2BCD ( value ) ((uint32_t)((((value) / 10U) << 4U) | ((value) % 10U)))

Helper macro to convert a value from 2 digit decimal format to BCD format.

Parameters :

  • value – Byte to be converted

Return values :

Converted – byte

LL_RTC_CONVERT_BCD2BIN ( value )

((uint32_t)((((uint32_t)((value) & (uint32_t)0xF0U) >> \

(uint32_t)0x4U) * 10U) + ((value) & (uint32_t)0x0FU)))


Helper macro to convert a value from BCD format to 2 digit decimal format.

Parameters :

  • value – BCD value to be converted

Return values :

Converted – byte

Defines

LL_RTC_GET_ASYNCH_PRESCALER ( value ) (((value) & RTC_PRER_PREDIV_A) >> RTC_PRER_PREDIV_A_Pos)

Helper macro to retrieve the value of the asynchronous prescaler.

Parameters :
Return values :

Value – of the asynchronous prescaler

LL_RTC_GET_SYNCH_PRESCALER ( value ) (((value) & RTC_PRER_PREDIV_S) >> RTC_PRER_PREDIV_S_Pos)

Helper macro to retrieve the value of the synchronous prescaler.

Parameters :
Return values :

Value – of the synchronous prescaler

Defines

LL_RTC_GET_CALENDAR_HOUR_FORMAT ( value ) (((value) & RTC_CR_FMT))

Helper macro to retrieve the calendar format value.

Parameters :

  • value – CR register value

Return values :

Mode – of the RTC can be one of the value:

LL_RTC_GET_SHADOW_REG_BYPASS ( value ) (((value) & RTC_CR_BYPSHAD))

Helper macro to retrieve the state of the bypass shadow register.

Parameters :

  • value – CR register value

Return values :

Mode – of the RTC can be one of the value:

Defines

LL_RTC_GET_WEEKDAY ( rtc_date ) (((rtc_date) >> RTC_OFFSET_WEEKDAY ) & 0x000000FFU)

Helper macro to retrieve weekday.

Parameters :
Return values :

Returned – value can be one of the following values:

LL_RTC_GET_YEAR ( rtc_date ) ((rtc_date) & 0x000000FFU)

Helper macro to retrieve Year in BCD format.

Parameters :
Return values :

Year – in BCD format (0x00 … 0x99)

LL_RTC_GET_MONTH ( rtc_date ) (((rtc_date) >> RTC_OFFSET_MONTH ) & 0x000000FFU)

Helper macro to retrieve Month in BCD format.

Parameters :
Return values :

Returned – value can be one of the following values:

LL_RTC_GET_DAY ( rtc_date ) (((rtc_date) >> RTC_OFFSET_DAY ) & 0x000000FFU)

Helper macro to retrieve Day in BCD format.

Parameters :
Return values :

Day – in BCD format (0x01 … 0x31)

Defines

LL_RTC_GET_HOUR ( rtc_time ) (((rtc_time) >> RTC_OFFSET_HOUR ) & 0x000000FFU)

Helper macro to retrieve hour in BCD format.

Parameters :
Return values :

Hours – in BCD format (0x01…0x12 or between Min_Data=0x00 and Max_Data=0x23)

LL_RTC_GET_MINUTE ( rtc_time ) (((rtc_time) >> RTC_OFFSET_MINUTE ) & 0x000000FFU)

Helper macro to retrieve minute in BCD format.

Parameters :
Return values :

Minutes – in BCD format (0x00…0x59)

LL_RTC_GET_SECOND ( rtc_time ) ((rtc_time) & 0x000000FFU)

Helper macro to retrieve second in BCD format.

Parameters :
Return values :

Seconds – in BCD format (0x00…0x59)

LL_RTC_GET_FORMAT ( rtc_time ) (((rtc_time) >> RTC_OFFSET_FORMAT ) & 0x0000000FU)

Helper macro to retrieve format.

Parameters :
Return values :

Format –

Defines

LL_RTC_GET_OUTPUT_POLARITY ( value ) (((value) & RTC_CR_TAMPALRM_TYPE) >> RTC_CR_TAMPALRM_TYPE_Pos)

Helper macro to retrieve the output polarity from the CR register.

Parameters :

  • value – CR register value

Return values :

Returned – value can be one of the following values:

LL_RTC_GET_OUTPUT_TYPE ( value ) (((value) & RTC_CR_TAMPALRM_TYPE) >> RTC_CR_TAMPALRM_TYPE_Pos)

Helper macro to retrieve the output type from the CR register.

Parameters :

  • value – CR register value

Return values :

Returned – value can be one of the following values:

LL_RTC_GET_OUTPUT_PULLUP ( value ) (((value) & RTC_CR_POL) >> RTC_CR_POL_Pos)

Helper macro to retrieve the output pull-up status from the CR register.

Parameters :

  • value – CR register value

Return values :

Returned – value can be one of the following values:

Defines

LL_RTC_GET_ALARM_HOUR ( rtc_alarm_time_date )

(((rtc_alarm_time_date) & \

(RTC_ALRMAR_HU_Msk | RTC_ALRMAR_HT_Msk)) >> RTC_ALRMAR_HU_Pos)


Helper macro to retrieve alarm hour in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Hours – in BCD format (0x01…0x12 or between Min_Data=0x00 and Max_Data=0x23)

LL_RTC_GET_ALARM_MINUTE ( rtc_alarm_time_date )

(((rtc_alarm_time_date) & \

(RTC_ALRMAR_MNU_Msk | RTC_ALRMAR_MNT_Msk)) >>\

RTC_ALRMAR_MNU_Pos )


Helper macro to retrieve alarm minute in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Minutes – in BCD format (0x00…0x59)

LL_RTC_GET_ALARM_SECOND ( rtc_alarm_time_date )

(((rtc_alarm_time_date) & \

(RTC_ALRMAR_SU_Msk | RTC_ALRMAR_ST_Msk)) \

>> RTC_ALRMAR_SU_Pos )


Helper macro to retrieve alarm second in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Seconds – in BCD format (0x00…0x59)

LL_RTC_GET_ALARM_FORMAT ( rtc_alarm_time_date ) (((rtc_alarm_time_date) & (RTC_ALRMAR_PM_Msk)))

Helper macro to retrieve alarm time format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Format –

LL_RTC_GET_ALARM_DAY ( rtc_alarm_time_date )

(((rtc_alarm_time_date) & (RTC_ALRMAR_DU_Msk | RTC_ALRMAR_DT_Msk))\

>> RTC_ALRMAR_DU_Pos )


Helper macro to retrieve alarm day in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Day – in BCD format (0x00…0x31)

LL_RTC_GET_ALARM_DAY_WDAY_SEL ( rtc_alarm_time_date ) (((rtc_alarm_time_date) & (RTC_ALRMAR_WDSEL_Msk)))

Helper macro to retrieve alarm weekday selection in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Day – weekday selection

LL_RTC_GET_ALARM_MASKS ( rtc_alarm_time_date )

((rtc_alarm_time_date) & (RTC_ALRMAR_MSK4 | RTC_ALRMAR_MSK3 | \

RTC_ALRMAR_MSK2 | RTC_ALRMAR_MSK1))


Helper macro to retrieve alarm mask selection in BCD format.

Parameters :

  • rtc_alarm_time_date – Alarm time and date returned

Return values :

Alarm – mask selection

LL_RTC_ALARM_GET_SS ( rtc_alarm_ss ) ((rtc_alarm_ss) & 0xFFFFU)

Helper macro to retrieve alarm subsecond in BCD format.

Parameters :

  • rtc_alarm_ss – Alarm subseconds mask and value returned

Return values :

Alarm – subseconds

LL_RTC_ALARM_GET_MASK_SS ( rtc_alarm_ss ) (((rtc_alarm_ss)>> RTC_OFFSET_ALR_MASK_SUBS_SECONDS ) & 0xFFU)

Helper macro to retrieve alarm subsecond mask selection in BCD format.

Parameters :

  • rtc_alarm_ss – Alarm subseconds mask and value returned

Return values :

Alarm – subseconds mask selection

LL_RTC_ALARM_A_GET_FLAG ( rtc_flags ) ((((rtc_flags) & RTC_SR_ALRAF) == RTC_SR_ALRAF) ? 1U : 0U)

Helper macro to retrieve the alarm A flag.

Parameters :

  • rtc_flags – Flags retrieved from RTC_SR register

Return values :

  • 0U – when the alarm flag A is unset

  • 1U – when the alarm flag A is set

LL_RTC_ALARM_B_GET_FLAG ( rtc_flags ) ((((rtc_flags) & RTC_SR_ALRBF) == RTC_SR_ALRBF) ? 1U : 0U)

Helper macro to retrieve the alarm B flag.

Parameters :

  • rtc_flags – Flags retrieved from RTC_SR register

Return values :

  • 0U – when the alarm flag B is unset

  • 1U – when the alarm flag B is set

LL_RTC_WAKEUP_GET_FLAG ( rtc_flags ) ((((rtc_flags) & RTC_SR_WUTF) == RTC_SR_WUTF) ? 1U : 0U)

Helper macro to retrieve the wake-up timer flag.

Parameters :

  • rtc_flags – Flags retrieved from RTC_SR

Return values :

  • 0U – when the wake-up timer flag is unset

  • 1U – when the wake-up timer flag is set

LL_RTC_TIMESTAMP_GET_FLAG ( rtc_flags ) ((((rtc_flags) & RTC_SR_TSF) == RTC_SR_TSF) ? 1U : 0U)

Helper macro to retrieve the timestamp flag.

Parameters :

  • rtc_flags – Timestamp flags retrieved from RTC_SR

Return values :

  • 0U – when the timestamp is unset

  • 1U – when the timestamp is set

LL_RTC_SSRU_GET_FLAG ( rtc_flags ) ((((rtc_flags) & RTC_SR_SSRUF) == RTC_SR_SSRUF) ? 1U : 0U)

Helper macro to retrieve the SSR underflow flag.

Parameters :

  • rtc_flags – SSRU flags retrieved from RTC_SR

Return values :

  • 0U – when the SRRU flag is unset

  • 1U – when the SRRU flag is set

Defines

LL_RTC_GET_WAKEUP_AUTORELOAD ( value ) (((value) & RTC_WUTR_WUT) >> RTC_WUTR_WUT_Pos)

Helper macro to retrieve the value of the wake-up auto-reload value.

Parameters :

  • value – WUTR register value

Return values :

Returned – value between 0x0 and 0xFFFF

LL_RTC_GET_WAKEUP_AUTOCLEAR ( value ) (((value) & RTC_WUTR_WUTOCLR) >> RTC_WUTR_WUTOCLR_Pos)

Helper macro to retrieve the value of the auto-clear value.

Parameters :

  • value – WUTR register value

Return values :

Returned – value between 0x0 and 0xFFFF

LL RTC Functions

group RTC_LL_Exported_Functions

Functions

void LL_RTC_SetHourFormat ( uint32_t HourFormat )

Set Hours format (24 hour/day or AM/PM hour format).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR FMT LL_RTC_SetHourFormat

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :

HourFormat – This parameter can be one of the following values:

uint32_t LL_RTC_GetHourFormat ( void )

Get Hours format (24 hour/day or AM/PM hour format).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR FMT LL_RTC_GetHourFormat

Return values :

Returned – value can be one of the following values:

void LL_RTC_SetAlarmOutEvent ( uint32_t AlarmOutput )

Select the flag to be routed to RTC_ALARM output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OSEL LL_RTC_SetAlarmOutEvent

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Parameters :

AlarmOutput – This parameter can be one of the following values:

uint32_t LL_RTC_GetAlarmOutEvent ( void )

Get the flag to be routed to RTC_ALARM output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OSEL LL_RTC_GetAlarmOutEvent

Return values :

Returned – value can be one of the following values:

void LL_RTC_SetAlarmOutputType ( uint32_t Output )

Set RTC_ALARM output type (ALARM in push-pull or open-drain output).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPALRM_TYPE LL_RTC_SetAlarmOutputType

Parameters :

Output – This parameter can be one of the following values:

uint32_t LL_RTC_GetAlarmOutputType ( void )

Get RTC_ALARM output type (ALARM in push-pull or open-drain output).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPALRM_TYPE LL_RTC_GetAlarmOutputType

Return values :

Returned – value can be one of the following values:

void LL_RTC_EnableInitMode ( void )

Enable initialization mode.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR INIT LL_RTC_EnableInitMode

Note

Initialization mode is used to program time and date register (RTC_TR and RTC_DR) and prescaler register (RTC_PRER) Counters are stopped and start counting from the new value when INIT is reset

void LL_RTC_DisableInitMode ( void )

Disable initialization mode (Free-running mode).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR INIT LL_RTC_DisableInitMode

void LL_RTC_SetBinaryMode ( uint32_t BinaryMode )

Set Binary mode (Sub Second Register).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BIN LL_RTC_SetBinaryMode

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :

BinaryMode – can be one of the following values:

uint32_t LL_RTC_GetBinaryMode ( void )

Get Binary mode (Sub Second Register).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BIN LL_RTC_GetBinaryMode

Return values :

This – parameter can be one of the following values:

void LL_RTC_SetBinMixBCDU ( uint32_t BinMixBcdU )

Set Binary Mix mode BCDU.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BCDU LL_RTC_SetBinMixBCDU

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :

BinMixBcdU – can be one of the following values:

uint32_t LL_RTC_GetBinMixBCDU ( void )

Get Binary Mix mode BCDU.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BCDU LL_RTC_GetBinMixBCDU

Return values :

This – parameter can be one of the following values:

void LL_RTC_SetConfigBinaryMode ( uint32_t BinaryMode , uint32_t BinMixBcdU )

Set Binary mode (Sub Second Register) and Mix mode BCDU.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BIN LL_RTC_SetConfigBinaryMode

RTC_ICSR BCDU LL_RTC_SetConfigBinaryMode

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :
uint32_t LL_RTC_GetConfigBinaryMode ( void )

Get Binary mode (Sub Second Register) and Mix mode BCDU.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR BIN LL_RTC_GetConfigBinaryMode

RTC_ICSR BCDU LL_RTC_GetConfigBinaryMode

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Return values :

A – combination one of the following values:

void LL_RTC_SetOutputPolarity ( uint32_t Polarity )

Set Output polarity.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR POL LL_RTC_SetOutputPolarity

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Parameters :

Polarity – This parameter can be one of the following values:

uint32_t LL_RTC_GetOutputPolarity ( void )

Get Output polarity.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR POL LL_RTC_GetOutputPolarity

Return values :

Returned – value can be one of the following values:

void LL_RTC_EnableBypassShadowReg ( void )

Enable bypass of the shadow registers.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BYPSHAD LL_RTC_EnableBypassShadowReg

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

When bypass enable, Calendar values (when reading from RTC_SSR, RTC_TR, and RTC_DR) are taken directly from the calendar counters

Note

If the frequency of the APB clock is less than seven times the frequency of RTCCLK, BYPSHAD must be set to 1

void LL_RTC_DisableBypassShadowReg ( void )

Disable bypass of the shadow registers.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BYPSHAD LL_RTC_DisableBypassShadowReg

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

uint32_t LL_RTC_IsEnabledBypassShadowReg ( void )

Check if the bypass of the shadow registers is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BYPSHAD LL_RTC_IsEnabledBypassShadowReg

Return values :

State – of bit (1 or 0)

void LL_RTC_SetHourFormatAndShadowRegBypass ( uint32_t HourFormat , uint32_t Bypass )

Set Hours format (24 hour/day or AM/PM hour format) and bypass shadow registers.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR FMT LL_RTC_SetHourFormatAndShadowRegBypass

RTC_CR BYPSHAD LL_RTC_SetHourFormatAndShadowRegBypass

Note

Bits are write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :
void LL_RTC_EnableRefClock ( void )

Enable RTC_REFIN reference clock detection (50 or 60 Hz).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR REFCKON LL_RTC_EnableRefClock

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

void LL_RTC_DisableRefClock ( void )

Disable RTC_REFIN reference clock detection (50 or 60 Hz).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR REFCKON LL_RTC_DisableRefClock

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

uint32_t LL_RTC_IsEnabledRefClock ( void )

Check if reference clock is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR REFCKON LL_RTC_IsEnabledRefClock

Return values :

State – of bit (1 or 0)

void LL_RTC_SetPrescalers ( uint32_t AsynchPrescaler , uint32_t SynchPrescaler )

Set the different prescalers factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_A LL_RTC_SetPrescalers

RTC_PRER PREDIV_S LL_RTC_SetPrescalers

Parameters :

  • AsynchPrescaler – Value between Min_Data = 0 and Max_Data = 0x7F

  • SynchPrescaler – Value between Min_Data = 0 and Max_Data = 0x7FFF

uint32_t LL_RTC_GetPrescalers ( void )

Get the different prescalers factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_A LL_RTC_GetPrescalers

RTC_PRER PREDIV_S LL_RTC_GetPrescalers

Return values :

AsynchPrescaler – Value between Min_Data = 0 and Max_Data = 0x7F and SynchPrescaler Value between Min_Data = 0 and Max_Data = 0x7FFF

void LL_RTC_SetAsynchPrescaler ( uint32_t AsynchPrescaler )

Set Asynchronous prescaler factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_A LL_RTC_SetAsynchPrescaler

Parameters :

AsynchPrescaler – Value between Min_Data = 0 and Max_Data = 0x7F

void LL_RTC_SetSynchPrescaler ( uint32_t SynchPrescaler )

Set Synchronous prescaler factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_S LL_RTC_SetSynchPrescaler

Parameters :

SynchPrescaler – Value between Min_Data = 0 and Max_Data = 0x7FFF

uint32_t LL_RTC_GetAsynchPrescaler ( void )

Get Asynchronous prescaler factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_A LL_RTC_GetAsynchPrescaler

Return values :

Value – between Min_Data = 0 and Max_Data = 0x7F

uint32_t LL_RTC_GetSynchPrescaler ( void )

Get Synchronous prescaler factor.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_PRER PREDIV_S LL_RTC_GetSynchPrescaler

Return values :

Value – between Min_Data = 0 and Max_Data = 0x7FFF

void LL_RTC_EnableWriteProtection ( void )

Enable the write protection for RTC registers.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WPR KEY LL_RTC_EnableWriteProtection

void LL_RTC_DisableWriteProtection ( void )

Disable the write protection for RTC registers.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WPR KEY LL_RTC_DisableWriteProtection

void LL_RTC_EnableTamperOutput ( void )

Enable tamper output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPOE LL_RTC_EnableTamperOutput

Note

When the tamper output is enabled, all external and internal tamper flags are ORed and routed to the TAMPALRM output

void LL_RTC_DisableTamperOutput ( void )

Disable tamper output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPOE LL_RTC_DisableTamperOutput

uint32_t LL_RTC_IsEnabledTamperOutput ( void )

Check if tamper output is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPOE LL_RTC_IsEnabledTamperOutput

Return values :

State – of bit (1 or 0)

void LL_RTC_EnableAlarmPullUp ( void )

Enable internal pull-up in output mode.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPALRM_PU LL_RTC_EnableAlarmPullUp

void LL_RTC_DisableAlarmPullUp ( void )

Disable internal pull-up in output mode.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPALRM_PU LL_RTC_DisableAlarmPullUp

uint32_t LL_RTC_IsEnabledAlarmPullUp ( void )

Check if internal pull-up in output mode is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPALRM_PU LL_RTC_IsEnabledAlarmPullUp

Return values :

State – of bit (1 or 0)

void LL_RTC_EnableOutput2 ( void )

Enable RTC_OUT2 output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_EnableOutput2

Note

RTC_OUT2 mapping depends on both OSEL ( LL_RTC_SetAlarmOutEvent) and COE ( LL_RTC_CAL_SetOutputFreq) settings

void LL_RTC_DisableOutput2 ( void )

Disable RTC_OUT2 output.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_DisableOutput2

uint32_t LL_RTC_IsEnabledOutput2 ( void )

Check if RTC_OUT2 output is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_IsEnabledOutput2

Return values :

State – of bit (1 or 0)

void LL_RTC_EnableOutput ( uint32_t Output )

Enable the output of the calibration signal or tampalarm signal.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_EnableOutput

RTC_CR TAMPOE LL_RTC_EnableOutput

RTC_CR OSEL LL_RTC_EnableOutput

RTC_CR COE LL_RTC_EnableOutput

RTC_CR COSEL LL_RTC_EnableOutput

Parameters :

Output – This parameter can be one of the following values:

void LL_RTC_DisableOutput ( void )

Disable the output of the calibration signal or tampalarm signal.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_DisableOutput

RTC_CR TAMPOE LL_RTC_DisableOutput

RTC_CR OSEL LL_RTC_DisableOutput

RTC_CR COE LL_RTC_DisableOutput

RTC_CR COSEL LL_RTC_DisableOutput

uint32_t LL_RTC_IsEnabledOutput ( void )

Get the output status of the calibration signal or tampalarm signal.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_IsEnabledOutput

RTC_CR TAMPOE LL_RTC_IsEnabledOutput

RTC_CR OSEL LL_RTC_IsEnabledOutput

RTC_CR COE LL_RTC_IsEnabledOutput

RTC_CR COSEL LL_RTC_IsEnabledOutput

Return values :

  • 0 – output disabled

  • 1 – output enabled

uint32_t LL_RTC_IsEnabledDetailedOutput ( const uint32_t Output )

Get the output detailed status of the calibration signal or tampalarm signal.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR OUT2EN LL_RTC_IsEnabledDetailedOutput

RTC_CR AMPOE LL_RTC_IsEnabledDetailedOutput

RTC_CR OSEL LL_RTC_IsEnabledDetailedOutput

RTC_CR COE LL_RTC_IsEnabledDetailedOutput

RTC_CR COSEL LL_RTC_IsEnabledDetailedOutput

Parameters :

Output – This parameter can be one of the following values:

Return values :

0 – output disabled, 1 output enabled

void LL_RTC_ConfigTampalarm ( uint32_t Polarity , uint32_t Type , uint32_t PullUp )

Configure the Output polarity and pull-up.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR POL LL_RTC_ConfigTampalarm

RTC_CR TAMPALRM_TYPE LL_RTC_ConfigTampalarm

RTC_CR TAMPALRM_PU LL_RTC_ConfigTampalarm

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Parameters :

Functions

void LL_RTC_TIME_SetFormat ( uint32_t TimeFormat )

Set time format (AM/24-hour or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR PM LL_RTC_TIME_SetFormat

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Parameters :

TimeFormat – This parameter can be one of the following values:

uint32_t LL_RTC_TIME_GetFormat ( void )

Get time format (AM/24-hour or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR PM LL_RTC_TIME_GetFormat

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read ( LL_RTC_READ_REG(DR))

Return values :

Returned – value can be one of the following values:

void LL_RTC_TIME_SetHour ( uint32_t Hours )

Set Hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR HT LL_RTC_TIME_SetHour

RTC_TR HU LL_RTC_TIME_SetHour

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert hour from binary to BCD format

Parameters :

Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

uint32_t LL_RTC_TIME_GetHour ( void )

Get Hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR HT LL_RTC_TIME_GetHour

RTC_TR HU LL_RTC_TIME_GetHour

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read ( LL_RTC_READ_REG(DR))

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert hour from BCD to Binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

void LL_RTC_TIME_SetMinute ( uint32_t Minutes )

Set Minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR MNT LL_RTC_TIME_SetMinute

RTC_TR MNU LL_RTC_TIME_SetMinute

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Minutes from binary to BCD format

Parameters :

Minutes – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_TIME_GetMinute ( void )

Get Minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR MNT LL_RTC_TIME_GetMinute

RTC_TR MNU LL_RTC_TIME_GetMinute

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read ( LL_RTC_READ_REG(DR))

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert minute from BCD to Binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_TIME_SetSecond ( uint32_t Seconds )

Set Seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR ST LL_RTC_TIME_SetSecond

RTC_TR SU LL_RTC_TIME_SetSecond

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Seconds from binary to BCD format

Parameters :

Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_TIME_GetSecond ( void )

Get Seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR ST LL_RTC_TIME_GetSecond

RTC_TR SU LL_RTC_TIME_GetSecond

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read ( LL_RTC_READ_REG(DR))

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Seconds from BCD to Binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_TIME_Config ( uint32_t Format12_24 , uint32_t Hours , uint32_t Minutes , uint32_t Seconds )

Set time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR PM LL_RTC_TIME_Config

RTC_TR HT LL_RTC_TIME_Config

RTC_TR HU LL_RTC_TIME_Config

RTC_TR MNT LL_RTC_TIME_Config

RTC_TR MNU LL_RTC_TIME_Config

RTC_TR ST LL_RTC_TIME_Config

RTC_TR SU LL_RTC_TIME_Config

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

It can be written in initialization mode only ( LL_RTC_EnableInitMode function)

Note

TimeFormat and Hours must preferably follow the same format

Parameters :

  • Format12_24 – This parameter can be one of the following values:

  • Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

  • Minutes – Value between Min_Data=0x00 and Max_Data=0x59

  • Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_TIME_Get ( void )

Get time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR HT LL_RTC_TIME_Get

RTC_TR HU LL_RTC_TIME_Get

RTC_TR MNT LL_RTC_TIME_Get

RTC_TR MNU LL_RTC_TIME_Get

RTC_TR ST LL_RTC_TIME_Get

RTC_TR SU LL_RTC_TIME_Get

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read ( LL_RTC_READ_REG(DR))

Note

helper macros LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of hours, minutes and seconds (Format: 0x00HHMMSS)

uint32_t LL_RTC_TIME_GetTimeAndFormat ( void )

Get time (hour, minute and second) in BCD format and time format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TR PM LL_RTC_TIME_GetTimeAndFormat

RTC_TR HT LL_RTC_TIME_GetTimeAndFormat

RTC_TR HU LL_RTC_TIME_GetTimeAndFormat

RTC_TR MNT LL_RTC_TIME_GetTimeAndFormat

RTC_TR MNU LL_RTC_TIME_GetTimeAndFormat

RTC_TR ST LL_RTC_TIME_GetTimeAndFormat

RTC_TR SU LL_RTC_TIME_GetTimeAndFormat

Note

helper macros LL_RTC_GET_FORMAT LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of format, hours, minutes and seconds (Format: 0x0FHHMMSS)

void LL_RTC_TIME_EnableDayLightStore ( void )

Memorize whether the daylight saving time change has been performed.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BKP LL_RTC_TIME_EnableDayLightStore

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_TIME_DisableDayLightStore ( void )

Disable memorization whether the daylight saving time change has been performed.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BKP LL_RTC_TIME_DisableDayLightStore

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

uint32_t LL_RTC_TIME_IsEnabledDayLightStore ( void )

Check if RTC Day Light Saving stored operation is enabled or not.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR BKP LL_RTC_TIME_IsEnabledDayLightStore

Return values :

State – of bit (1 or 0)

void LL_RTC_TIME_DecHour ( void )

Subtract 1 hour (winter time change).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR SUB1H LL_RTC_TIME_DecHour

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_TIME_IncHour ( void )

Add 1 hour (summer time change).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ADD1H LL_RTC_TIME_IncHour

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

uint32_t LL_RTC_TIME_GetSubSecond ( void )

Get Sub second value in the synchronous prescaler counter.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SSR SS LL_RTC_TIME_GetSubSecond

Note

Use both SubSeconds value and SecondFraction (PREDIV_S through the LL_RTC_GetSynchPrescaler function) terms returned to convert the calendar SubSeconds value to a second fraction ratio with the following time unit formula: ==> Seconds fraction ratio * time_unit= [(SecondFraction-SubSeconds)/(SecondFraction+1)] * time_unit This conversion can be performed only if no shift operation is pending (ie. SHFP=0) when PREDIV_S >= SS

Return values :

If – binary mode is none, Value between Min_Data=0x0 and Max_Data=0x7FFF else Value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

void LL_RTC_TIME_Synchronize ( uint32_t ShiftSecond , uint32_t Fraction )

Synchronize to a remote clock with a high degree of precision.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SHIFTR ADD1S LL_RTC_TIME_Synchronize

RTC_SHIFTR SUBFS LL_RTC_TIME_Synchronize

Note

This operation effectively subtracts from (delays) or advance the clock of a fraction of a second

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

Note

When REFCKON is set, firmware must not write to Shift control register

Parameters :

Functions

void LL_RTC_DATE_SetYear ( uint32_t Year )

Set Year in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR YT LL_RTC_DATE_SetYear

RTC_DR YU LL_RTC_DATE_SetYear

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Year from binary to BCD format

Parameters :

Year – Value between Min_Data=0x00 and Max_Data=0x99

uint32_t LL_RTC_DATE_GetYear ( void )

Get Year in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR YT LL_RTC_DATE_GetYear

RTC_DR YU LL_RTC_DATE_GetYear

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Year from BCD to Binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x99

void LL_RTC_DATE_SetWeekDay ( uint32_t WeekDay )

Set weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR WDU LL_RTC_DATE_SetWeekDay

Parameters :

WeekDay – This parameter can be one of the following values:

uint32_t LL_RTC_DATE_GetWeekDay ( void )

Get weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR WDU LL_RTC_DATE_GetWeekDay

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Return values :

Returned – value can be one of the following values:

void LL_RTC_DATE_SetMonth ( uint32_t Month )

Set Month in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR MT LL_RTC_DATE_SetMonth

RTC_DR MU LL_RTC_DATE_SetMonth

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Month from binary to BCD format

Parameters :

Month – This parameter can be one of the following values:

uint32_t LL_RTC_DATE_GetMonth ( void )

Get Month in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR MT LL_RTC_DATE_GetMonth

RTC_DR MU LL_RTC_DATE_GetMonth

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Month from BCD to Binary format

Return values :

Returned – value can be one of the following values:

void LL_RTC_DATE_SetDay ( uint32_t Day )

Set Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR DT LL_RTC_DATE_SetDay

RTC_DR DU LL_RTC_DATE_SetDay

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Day from binary to BCD format

Parameters :

Day – Value between Min_Data=0x01 and Max_Data=0x31

uint32_t LL_RTC_DATE_GetDay ( void )

Get Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR DT LL_RTC_DATE_GetDay

RTC_DR DU LL_RTC_DATE_GetDay

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Day from BCD to Binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x31

void LL_RTC_DATE_Config ( uint32_t WeekDay , uint32_t Day , uint32_t Month , uint32_t Year )

Set date (WeekDay, Day, Month and Year) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR WDU LL_RTC_DATE_Config

RTC_DR MT LL_RTC_DATE_Config

RTC_DR MU LL_RTC_DATE_Config

RTC_DR DT LL_RTC_DATE_Config

RTC_DR DU LL_RTC_DATE_Config

RTC_DR YT LL_RTC_DATE_Config

RTC_DR YU LL_RTC_DATE_Config

Parameters :
uint32_t LL_RTC_DATE_Get ( void )

Get date (WeekDay, Day, Month and Year) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_DR WDU LL_RTC_DATE_Get

RTC_DR MT LL_RTC_DATE_Get

RTC_DR MU LL_RTC_DATE_Get

RTC_DR DT LL_RTC_DATE_Get

RTC_DR DU LL_RTC_DATE_Get

RTC_DR YT LL_RTC_DATE_Get

RTC_DR YU LL_RTC_DATE_Get

Note

if RTC shadow registers are not bypassed (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Note

helper macros LL_RTC_GET_WEEKDAY, LL_RTC_GET_YEAR, LL_RTC_GET_MONTH, and LL_RTC_GET_DAY are available to get independently each parameter

Return values :

Combination – of WeekDay, Day, Month and Year (Format: 0xWWDDMMYY)

Functions

void LL_RTC_ALM_SetBinAutoClr ( uint32_t Alarm , uint32_t BinaryAutoClr )

Set alarm A or B Binary mode auto clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SSCLR LL_RTC_ALM_SetBinAutoClr

RTC_ALRMASSR SSCLR LL_RTC_ALM_SetBinAutoClr

Note

This register can be written only when ALRAE or ALRBE is reset in RTC_CR register, or in initialization mode

Note

SSCLR must be kept to 0 when BCD or mixed mode is used (BIN = 00, 10 or 11).

Parameters :
uint32_t LL_RTC_ALM_GetBinAutoClr ( const uint32_t Alarm )

Get alarm A or B Binary mode auto clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SSCLR LL_RTC_ALM_GetBinAutoClr

RTC_ALRMASSR SSCLR LL_RTC_ALM_GetBinAutoClr

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALM_SetFlagAutoClr ( uint32_t Alarm , uint32_t AutoClr )

Set alarm A or B flag automatic clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBFCLR LL_RTC_ALM_SetFlagAutoClr

RTC_CR ALRAFCLR LL_RTC_ALM_SetFlagAutoClr

Note

This register can be written only when ALRAE or ALRBE is reset in RTC_CR register, or in initialization mode

Parameters :
uint32_t LL_RTC_ALM_GetFlagAutoClr ( const uint32_t Alarm )

Get alarm A or B flag automatic clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBFCLR LL_RTC_ALM_GetFlagAutoClr

RTC_CR ALRAFCLR LL_RTC_ALM_GetFlagAutoClr

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALM_SetConfigDateTime ( uint32_t Alarm , uint32_t Mask , uint32_t DayWeekDaySelection , uint32_t Day , uint32_t Format12_24 , uint32_t Hours , uint32_t Minutes , uint32_t Seconds )

Set alarm A or B Time (hour, minute and second) in BCD format, time format, Day (weekday or day), weekday or day selection and masks.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR PM LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR HT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR HU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MNT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MNU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR ST LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR SU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MSK4 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MSK3 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MSK2 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR MSK1 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR WDSEL LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR DT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMBR DU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR PM LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR HT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR HU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MNT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MNU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR ST LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR SU LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MSK4 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MSK3 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MSK2 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR MSK1 LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR WDSEL LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR DT LL_RTC_ALM_SetConfigDateTime

RTC_ALRMAR DU LL_RTC_ALM_SetConfigDateTime

Note

This register can be written only when ALRAE or ALRBE is reset in RTC_CR register, or in initialization mode

Parameters :
uint32_t LL_RTC_ALM_GetConfigDateTime ( const uint32_t Alarm )

Get alarm A or B Time (hour, minute and second) in BCD format, time format, Day (weekday or day), weekday or day selection and masks.

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

Content – of the RTC_ALRMAR or RTC_ALRMBR register

void LL_RTC_ALM_SetConfigSubSecond ( uint32_t Alarm , uint32_t Mask , uint32_t Subsecond )

Set alarm A or B sub seconds mask and value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR MASKSS LL_RTC_ALM_SetConfigSubSecond

RTC_ALRMBSSR SS LL_RTC_ALM_SetConfigSubSecond

RTC_ALRMASSR MASKSS LL_RTC_ALM_SetConfigSubSecond

RTC_ALRMASSR SS LL_RTC_ALM_SetConfigSubSecond

Note

This register can be written only when ALRAE or ALRBE is reset in RTC_CR register, or in initialization mode

Parameters :

  • Alarm – This parameter can be one of the following values:

  • Mask – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F

  • Subsecond – Value between Min_Data=0x00 and Max_Data=0x7FFF

uint32_t LL_RTC_ALM_GetConfigSubSecond ( const uint32_t Alarm )

Get alarm A or B sub seconds mask and value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR MASKSS LL_RTC_ALM_GetConfigSubSecond

RTC_ALRMASSR SS LL_RTC_ALM_GetConfigSubSecond

RTC_ALRMBSSR MASKSS LL_RTC_ALM_GetConfigSubSecond

RTC_ALRMBSSR SS LL_RTC_ALM_GetConfigSubSecond

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

Mask – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F Subsecond Value between Min_Data=0x00 and Max_Data=0x7FFF Result is given in the form 0x00MMSSSS

void LL_RTC_ALM_Start ( uint32_t Alarm , uint32_t Interruption )

Start alarm A or B.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_ALM_Start

RTC_CR ALRBE LL_RTC_ALM_Start

RTC_CR ALRAIE LL_RTC_ALM_Start

RTC_CR ALRAE LL_RTC_ALM_Start

Parameters :
void LL_RTC_ALM_Stop ( uint32_t Alarm )

Stop alarm A or B.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_ALM_Stop

RTC_CR ALRBE LL_RTC_ALM_Stop

RTC_CR ALRAIE LL_RTC_ALM_Stop

RTC_CR ALRAE LL_RTC_ALM_Stop

Parameters :

Alarm – This parameter can be one of the following values:

uint32_t LL_RTC_ALM_IsStarted ( const uint32_t Alarm )

Is alarm A or B Enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_ALM_IsStarted

RTC_CR ALRBE LL_RTC_ALM_IsStarted

RTC_CR ALRAIE LL_RTC_ALM_IsStarted

RTC_CR ALRAIE LL_RTC_ALM_IsStarted

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

State – of bit (1 or 0)

void LL_RTC_ALM_SetBinarySubSecond ( uint32_t Alarm , uint32_t Subsecond )

Set alarm A or B Sub seconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRABINR SS LL_RTC_ALM_SetBinarySubSecond

RTC_ALRBBINR SS LL_RTC_ALM_SetBinarySubSecond

Parameters :

  • Alarm – This parameter can be one of the following values:

  • Subsecond – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0x7FFF else Value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

uint32_t LL_RTC_ALM_GetBinarySubSecond ( const uint32_t Alarm )

Get alarm A or B Sub seconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRABINR SS LL_RTC_ALM_GetBinarySubSecond

RTC_ALRBBINR SS LL_RTC_ALM_GetBinarySubSecond

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

If – binary mode is none, Value between Min_Data=0x0 and Max_Data=0x7FFF else Value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

void LL_RTC_ALM_SetSubSecondMask ( uint32_t Alarm , uint32_t Mask )

Set alarm A or B Sub seconds mask.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR MASKSS LL_RTC_ALM_SetSubSecondMask

RTC_ALRMBSSR MASKSS LL_RTC_ALM_SetSubSecondMask

Note

This register can be written only when ALRAE or ALRBE is reset in RTC_CR register, or in initialization mode

Parameters :

  • Alarm – This parameter can be one of the following values:

  • Mask – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F

uint32_t LL_RTC_ALM_GetSubSecondMask ( const uint32_t Alarm )

Get alarm A or B sub seconds mask.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR MASKSS LL_RTC_ALM_GetSubSecondMask

RTC_ALRMBSSR MASKSS LL_RTC_ALM_GetSubSecondMask

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

Mask – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F

Functions

void LL_RTC_ALMA_Enable ( void )

Enable alarm A.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRAE LL_RTC_ALMA_Enable

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_ALMA_Disable ( void )

Disable alarm A.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRAE LL_RTC_ALMA_Disable

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_ALMA_SetMask ( uint32_t Mask )

Specify the alarm A masks.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR MSK4 LL_RTC_ALMA_SetMask

RTC_ALRMAR MSK3 LL_RTC_ALMA_SetMask

RTC_ALRMAR MSK2 LL_RTC_ALMA_SetMask

RTC_ALRMAR MSK1 LL_RTC_ALMA_SetMask

Parameters :

Mask – This parameter can be a combination of the following values:

uint32_t LL_RTC_ALMA_GetMask ( void )

Get the alarm A masks.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR MSK4 LL_RTC_ALMA_GetMask

RTC_ALRMAR MSK3 LL_RTC_ALMA_GetMask

RTC_ALRMAR MSK2 LL_RTC_ALMA_GetMask

RTC_ALRMAR MSK1 LL_RTC_ALMA_GetMask

Return values :

Returned – value can be a combination of the following values:

void LL_RTC_ALMA_EnableWeekday ( void )

Enable alarm A weekday selection (DU[3:0] represents the weekday. DT[1:0] is ignored).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR WDSEL LL_RTC_ALMA_EnableWeekday

void LL_RTC_ALMA_DisableWeekday ( void )

Disable alarm A weekday selection (DU[3:0] represents the date).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR WDSEL LL_RTC_ALMA_DisableWeekday

uint32_t LL_RTC_ALMA_IsEnabledWeekday ( void )

Check whether alarm A weekday selection is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR WDSEL LL_RTC_ALMA_IsEnabledWeekday

Return values :

State – of bit (1 or 0)

void LL_RTC_ALMA_SetDay ( uint32_t Day )

Set alarm A Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR DT LL_RTC_ALMA_SetDay

RTC_ALRMAR DU LL_RTC_ALMA_SetDay

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Day from binary to BCD format

Parameters :

Day – Value between Min_Data=0x01 and Max_Data=0x31

uint32_t LL_RTC_ALMA_GetDay ( void )

Get alarm A Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR DT LL_RTC_ALMA_GetDay

RTC_ALRMAR DU LL_RTC_ALMA_GetDay

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Day from BCD to Binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x31

void LL_RTC_ALMA_SetWeekDay ( uint32_t WeekDay )

Set alarm A Weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR DU LL_RTC_ALMA_SetWeekDay

Note

DU in weekday mode only if WDSEL is enabled

Parameters :

WeekDay – This parameter can be one of the following values:

uint32_t LL_RTC_ALMA_GetWeekDay ( void )

Get alarm A Weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR DU LL_RTC_ALMA_GetWeekDay

Note

DU in weekday mode only if WDSEL is enabled

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALMA_SetTimeFormat ( uint32_t TimeFormat )

Set alarm A time format (AM/24-hour or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR PM LL_RTC_ALMA_SetTimeFormat

Parameters :

TimeFormat – This parameter can be one of the following values:

uint32_t LL_RTC_ALMA_GetTimeFormat ( void )

Get alarm A time format (AM or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR PM LL_RTC_ALMA_GetTimeFormat

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALMA_SetHour ( uint32_t Hours )

Set alarm A Hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR HT LL_RTC_ALMA_SetHour

RTC_ALRMAR HU LL_RTC_ALMA_SetHour

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Hours from binary to BCD format

Parameters :

Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

uint32_t LL_RTC_ALMA_GetHour ( void )

Get alarm A Hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR HT LL_RTC_ALMA_GetHour

RTC_ALRMAR HU LL_RTC_ALMA_GetHour

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Hours from BCD to Binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

void LL_RTC_ALMA_SetMinute ( uint32_t Minutes )

Set alarm A Minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR MNT LL_RTC_ALMA_SetMinute

RTC_ALRMAR MNU LL_RTC_ALMA_SetMinute

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Minutes from binary to BCD format

Parameters :

Minutes – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMA_GetMinute ( void )

Get alarm A Minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR MNT LL_RTC_ALMA_GetMinute

RTC_ALRMAR MNU LL_RTC_ALMA_GetMinute

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Minutes from BCD to Binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_ALMA_SetSecond ( uint32_t Seconds )

Set alarm A Seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR ST LL_RTC_ALMA_SetSecond

RTC_ALRMAR SU LL_RTC_ALMA_SetSecond

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Seconds from binary to BCD format

Parameters :

Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMA_GetSecond ( void )

Get alarm A Seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR ST LL_RTC_ALMA_GetSecond

RTC_ALRMAR SU LL_RTC_ALMA_GetSecond

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Seconds from BCD to Binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_ALMA_ConfigTime ( uint32_t Format12_24 , uint32_t Hours , uint32_t Minutes , uint32_t Seconds )

Set alarm A Time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR PM LL_RTC_ALMA_ConfigTime

RTC_ALRMAR HT LL_RTC_ALMA_ConfigTime

RTC_ALRMAR HU LL_RTC_ALMA_ConfigTime

RTC_ALRMAR MNT LL_RTC_ALMA_ConfigTime

RTC_ALRMAR MNU LL_RTC_ALMA_ConfigTime

RTC_ALRMAR ST LL_RTC_ALMA_ConfigTime

RTC_ALRMAR SU LL_RTC_ALMA_ConfigTime

Parameters :

  • Format12_24 – This parameter can be one of the following values:

  • Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

  • Minutes – Value between Min_Data=0x00 and Max_Data=0x59

  • Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMA_GetTime ( void )

Get alarm A Time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMAR HT LL_RTC_ALMA_GetTime

RTC_ALRMAR HU LL_RTC_ALMA_GetTime

RTC_ALRMAR MNT LL_RTC_ALMA_GetTime

RTC_ALRMAR MNU LL_RTC_ALMA_GetTime

RTC_ALRMAR ST LL_RTC_ALMA_GetTime

RTC_ALRMAR SU LL_RTC_ALMA_GetTime

Note

helper macros LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of hours, minutes and seconds

void LL_RTC_ALMA_SetSubSecondMask ( uint32_t Mask )

Set alarm A Mask the most-significant bits starting at this bit.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR MASKSS LL_RTC_ALMA_SetSubSecondMask

Note

This register can be written only when ALRAE is reset in RTC_CR register, or in initialization mode

Parameters :

Mask – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F

uint32_t LL_RTC_ALMA_GetSubSecondMask ( void )

Get alarm A Mask the most-significant bits starting at this bit.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR MASKSS LL_RTC_ALMA_GetSubSecondMask

Return values :

If – binary mode is none, Value between Min_Data=0x0 and Max_Data=0xF else Value between Min_Data=0x0 and Max_Data=0x3F

void LL_RTC_ALMA_SetBinAutoClr ( uint32_t BinaryAutoClr )

Set alarm A Binary mode auto clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR SSCLR LL_RTC_ALMA_SetBinAutoClr

Note

This register can be written only when ALRAE is reset in RTC_CR register, or in initialization mode

Note

SSCLR must be kept to 0 when BCD or mixed mode is used (BIN = 00, 10 or 11).

Parameters :

BinaryAutoClr – This parameter can be one of the following values:

uint32_t LL_RTC_ALMA_GetBinAutoClr ( void )

Get alarm A Binary mode auto clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR SSCLR LL_RTC_ALMA_GetBinAutoClr

Return values :

It – can be one of the following values:

void LL_RTC_ALMA_SetSubSecond ( uint32_t Subsecond )

Set alarm A Sub seconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR SS LL_RTC_ALMA_SetSubSecond

Parameters :

Subsecond – If binary mode is none, Value between Min_Data=0x0 and Max_Data=0x7FFF else Value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

uint32_t LL_RTC_ALMA_GetSubSecond ( void )

Get alarm A Sub seconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMASSR SS LL_RTC_ALMA_GetSubSecond

Return values :

If – binary mode is none, Value between Min_Data=0x0 and Max_Data=0x7FFF else Value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

Functions

void LL_RTC_ALMB_Enable ( void )

Enable alarm B.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBE LL_RTC_ALMB_Enable

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_ALMB_Disable ( void )

Disable alarm B.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBE LL_RTC_ALMB_Disable

Note

Bit is write-protected. LL_RTC_DisableWriteProtection function must preferably be called before

void LL_RTC_ALMB_SetMask ( uint32_t Mask )

Specify the alarm B masks.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR MSK4 LL_RTC_ALMB_SetMask

RTC_ALRMBR MSK3 LL_RTC_ALMB_SetMask

RTC_ALRMBR MSK2 LL_RTC_ALMB_SetMask

RTC_ALRMBR MSK1 LL_RTC_ALMB_SetMask

Parameters :

Mask – This parameter can be a combination of the following values:

uint32_t LL_RTC_ALMB_GetMask ( void )

Get the alarm B masks.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR MSK4 LL_RTC_ALMB_GetMask

RTC_ALRMBR MSK3 LL_RTC_ALMB_GetMask

RTC_ALRMBR MSK2 LL_RTC_ALMB_GetMask

RTC_ALRMBR MSK1 LL_RTC_ALMB_GetMask

Return values :

Returned – value can be a combination of the following values:

void LL_RTC_ALMB_EnableWeekday ( void )

Enable alarm B weekday selection (DU[3:0] represents the weekday. DT[1:0] is ignored).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR WDSEL LL_RTC_ALMB_EnableWeekday

void LL_RTC_ALMB_DisableWeekday ( void )

Disable alarm B weekday selection (DU[3:0] represents the date).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR WDSEL LL_RTC_ALMB_DisableWeekday

uint32_t LL_RTC_ALMB_IsEnabledWeekday ( void )

Check whether alarm B weekday selection is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR WDSEL LL_RTC_ALMB_IsEnabledWeekday

Return values :

State – of bit (1 or 0)

void LL_RTC_ALMB_SetDay ( uint32_t Day )

Set alarm B Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR DT LL_RTC_ALMB_SetDay

RTC_ALRMBR DU LL_RTC_ALMB_SetDay

Note

helper macro LL_RTC_CONVERT_BIN2BCD is available to convert Day from binary to BCD format

Parameters :

Day – Value between Min_Data=0x01 and Max_Data=0x31

uint32_t LL_RTC_ALMB_GetDay ( void )

Get alarm B Day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR DT LL_RTC_ALMB_GetDay

RTC_ALRMBR DU LL_RTC_ALMB_GetDay

Note

helper macro LL_RTC_CONVERT_BCD2BIN is available to convert Day from BCD to Binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x31

void LL_RTC_ALMB_SetWeekDay ( uint32_t WeekDay )

Set alarm B Weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR DU LL_RTC_ALMB_SetWeekDay

Parameters :

WeekDay – This parameter can be one of the following values:

uint32_t LL_RTC_ALMB_GetWeekDay ( void )

Get alarm B Weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR DU LL_RTC_ALMB_GetWeekDay

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALMB_SetTimeFormat ( uint32_t TimeFormat )

Set alarm B time format (AM/24-hour or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR PM LL_RTC_ALMB_SetTimeFormat

Parameters :

TimeFormat – This parameter can be one of the following values:

uint32_t LL_RTC_ALMB_GetTimeFormat ( void )

Get alarm B time format (AM/24-hour or PM notation).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR PM LL_RTC_ALMB_GetTimeFormat

Return values :

Returned – value can be one of the following values:

void LL_RTC_ALMB_SetHour ( uint32_t Hours )

Set alarm B hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR HT LL_RTC_ALMB_SetHour

RTC_ALRMBR HU LL_RTC_ALMB_SetHour

Note

Helper macro LL_RTC_CONVERT_BIN2BCD is available to convert hours from binary to BCD format

Parameters :

Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

uint32_t LL_RTC_ALMB_GetHour ( void )

Get alarm B hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR HT LL_RTC_ALMB_GetHour

RTC_ALRMBR HU LL_RTC_ALMB_GetHour

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert hours from BCD to binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

void LL_RTC_ALMB_SetMinute ( uint32_t Minutes )

Set alarm B minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR MNT LL_RTC_ALMB_SetMinute

RTC_ALRMBR MNU LL_RTC_ALMB_SetMinute

Note

Helper macro LL_RTC_CONVERT_BIN2BCD is available to convert minutes from binary to BCD format

Parameters :

Minutes – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMB_GetMinute ( void )

Get alarm B minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR MNT LL_RTC_ALMB_GetMinute

RTC_ALRMBR MNU LL_RTC_ALMB_GetMinute

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert minutes from BCD to binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_ALMB_SetSecond ( uint32_t Seconds )

Set alarm B seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR ST LL_RTC_ALMB_SetSecond

RTC_ALRMBR SU LL_RTC_ALMB_SetSecond

Note

Helper macro LL_RTC_CONVERT_BIN2BCD is available to convert seconds from binary to BCD format

Parameters :

Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMB_GetSecond ( void )

Get alarm B seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR ST LL_RTC_ALMB_GetSecond

RTC_ALRMBR SU LL_RTC_ALMB_GetSecond

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert seconds from BCD to binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

void LL_RTC_ALMB_ConfigTime ( uint32_t Format12_24 , uint32_t Hours , uint32_t Minutes , uint32_t Seconds )

Set alarm B time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR PM LL_RTC_ALMB_ConfigTime

RTC_ALRMBR HT LL_RTC_ALMB_ConfigTime

RTC_ALRMBR HU LL_RTC_ALMB_ConfigTime

RTC_ALRMBR MNT LL_RTC_ALMB_ConfigTime

RTC_ALRMBR MNU LL_RTC_ALMB_ConfigTime

RTC_ALRMBR ST LL_RTC_ALMB_ConfigTime

RTC_ALRMBR SU LL_RTC_ALMB_ConfigTime

Parameters :

  • Format12_24 – This parameter can be one of the following values:

  • Hours – Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

  • Minutes – Value between Min_Data=0x00 and Max_Data=0x59

  • Seconds – Value between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_ALMB_GetTime ( void )

Get alarm B time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBR HT LL_RTC_ALMB_GetTime

RTC_ALRMBR HU LL_RTC_ALMB_GetTime

RTC_ALRMBR MNT LL_RTC_ALMB_GetTime

RTC_ALRMBR MNU LL_RTC_ALMB_GetTime

RTC_ALRMBR ST LL_RTC_ALMB_GetTime

RTC_ALRMBR SU LL_RTC_ALMB_GetTime

Note

Helper macros LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of hours, minutes and seconds

void LL_RTC_ALMB_SetSubSecondMask ( uint32_t Mask )

Set alarm B mask for the most significant bits starting at this bit.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR MASKSS LL_RTC_ALMB_SetSubSecondMask

Note

This register can be written only when ALRBE is reset in RTC_CR register or in initialization mode.

Parameters :

Mask – If binary mode is not enabled, value between Min_Data=0x0 and Max_Data=0xF else value between Min_Data=0x0 and Max_Data=0x3F

uint32_t LL_RTC_ALMB_GetSubSecondMask ( void )

Get alarm B mask for the most significant bits starting at this bit.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR MASKSS LL_RTC_ALMB_GetSubSecondMask

Return values :

If – binary mode is not enabled, value between Min_Data=0x0 and Max_Data=0xF else value between Min_Data=0x0 and Max_Data=0x3F

void LL_RTC_ALMB_SetBinAutoClr ( uint32_t BinaryAutoClr )

Set alarm B binary mode auto-clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SSCLR LL_RTC_ALMB_SetBinAutoClr

Note

This register can be written only when ALRBE is reset in RTC_CR register or in initialization mode.

Note

SSCLR must be kept at 0 when BCD or mixed mode is used (BIN = 00, 10 or 11).

Parameters :

BinaryAutoClr – This parameter can be one of the following values:

uint32_t LL_RTC_ALMB_GetBinAutoClr ( void )

Get alarm B binary mode auto-clear.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SSCLR LL_RTC_ALMB_GetBinAutoClr

Return values :

It – can be one of the following values:

void LL_RTC_ALMB_SetSubSecond ( uint32_t Subsecond )

Set alarm B subseconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SS LL_RTC_ALMB_SetSubSecond

Parameters :

Subsecond – If binary mode is not enabled, value between Min_Data=0x0 and Max_Data=0x7FFF else value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

uint32_t LL_RTC_ALMB_GetSubSecond ( void )

Get alarm B subseconds value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ALRMBSSR SS LL_RTC_ALMB_GetSubSecond

Return values :

If – binary mode is not enabled, value between Min_Data=0x0 and Max_Data=0x7FFF else value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

Functions

void LL_RTC_TS_Enable ( void )

Enable timestamp.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSE LL_RTC_TS_Enable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_TS_Disable ( void )

Disable timestamp.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSE LL_RTC_TS_Disable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

uint32_t LL_RTC_TS_IsEnabled ( void )

Check whether timestamp is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSE LL_RTC_TS_IsEnabled

Return values :

State – of bit (1 or 0)

void LL_RTC_TS_SetActiveEdge ( uint32_t Edge )

Set timestamp event active edge.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSEDGE LL_RTC_TS_SetActiveEdge

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

TSE must be reset when TSEDGE is changed to avoid unwanted TSF setting

Parameters :

Edge – This parameter can be one of the following values:

uint32_t LL_RTC_TS_GetActiveEdge ( void )

Get timestamp event active edge.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSEDGE LL_RTC_TS_GetActiveEdge

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Return values :

Returned – value can be one of the following values:

uint32_t LL_RTC_TS_GetTimeFormat ( void )

Get timestamp AM/PM notation (AM or 24-hour format).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR PM LL_RTC_TS_GetTimeFormat

Return values :

Returned – value can be one of the following values:

uint32_t LL_RTC_TS_GetHour ( void )

Get timestamp hours in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR HT LL_RTC_TS_GetHour

RTC_TSTR HU LL_RTC_TS_GetHour

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert hours from BCD to binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

uint32_t LL_RTC_TS_GetMinute ( void )

Get timestamp minutes in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR MNT LL_RTC_TS_GetMinute

RTC_TSTR MNU LL_RTC_TS_GetMinute

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert minutes from BCD to binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_TS_GetSecond ( void )

Get timestamp seconds in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR ST LL_RTC_TS_GetSecond

RTC_TSTR SU LL_RTC_TS_GetSecond

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert seconds from BCD to binary format

Return values :

Value – between Min_Data=0x00 and Max_Data=0x59

uint32_t LL_RTC_TS_GetTime ( void )

Get timestamp time (hour, minute and second) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR HT LL_RTC_TS_GetTime

RTC_TSTR HU LL_RTC_TS_GetTime

RTC_TSTR MNT LL_RTC_TS_GetTime

RTC_TSTR MNU LL_RTC_TS_GetTime

RTC_TSTR ST LL_RTC_TS_GetTime

RTC_TSTR SU LL_RTC_TS_GetTime

Note

Helper macros LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of hours, minutes and seconds

uint32_t LL_RTC_TS_GetTimeAndFormat ( void )

Get timestamp time (hour, minute and second) in BCD format and time format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSTR PM LL_RTC_TS_GetTimeAndFormat

RTC_TSTR HT LL_RTC_TS_GetTimeAndFormat

RTC_TSTR HU LL_RTC_TS_GetTimeAndFormat

RTC_TSTR MNT LL_RTC_TS_GetTimeAndFormat

RTC_TSTR MNU LL_RTC_TS_GetTimeAndFormat

RTC_TSTR ST LL_RTC_TS_GetTimeAndFormat

RTC_TSTR SU LL_RTC_TS_GetTimeAndFormat

Note

Helper macros LL_RTC_GET_FORMAT, LL_RTC_GET_HOUR, LL_RTC_GET_MINUTE, and LL_RTC_GET_SECOND are available to get independently each parameter

Return values :

Combination – of format, hours, minutes and seconds (Format: 0x0FHHMMSS)

uint32_t LL_RTC_TS_GetWeekDay ( void )

Get timestamp weekday.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSDR WDU LL_RTC_TS_GetWeekDay

Return values :

Returned – value can be one of the following values:

uint32_t LL_RTC_TS_GetMonth ( void )

Get timestamp month in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSDR MT LL_RTC_TS_GetMonth

RTC_TSDR MU LL_RTC_TS_GetMonth

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert month from BCD to binary format

Return values :

Returned – value can be one of the following values:

uint32_t LL_RTC_TS_GetDay ( void )

Get timestamp day in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSDR DT LL_RTC_TS_GetDay

RTC_TSDR DU LL_RTC_TS_GetDay

Note

Helper macro LL_RTC_CONVERT_BCD2BIN is available to convert day from BCD to binary format

Return values :

Value – between Min_Data=0x01 and Max_Data=0x31

uint32_t LL_RTC_TS_GetDate ( void )

Get timestamp date (weekday, day and month) in BCD format.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSDR WDU LL_RTC_TS_GetDate

RTC_TSDR MT LL_RTC_TS_GetDate

RTC_TSDR MU LL_RTC_TS_GetDate

RTC_TSDR DT LL_RTC_TS_GetDate

RTC_TSDR DU LL_RTC_TS_GetDate

Note

Helper macros LL_RTC_GET_WEEKDAY, LL_RTC_GET_MONTH, and LL_RTC_GET_DAY are available to get independently each parameter

Return values :

Combination – of weekday, day and month

uint32_t LL_RTC_TS_GetSubSecond ( void )

Get timestamp subsecond value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_TSSSR SS LL_RTC_TS_GetSubSecond

Return values :

If – binary mode is not enabled, value between Min_Data=0x0 and Max_Data=0x7FFF else value between Min_Data=0x0 and Max_Data=0xFFFFFFFF

void LL_RTC_TS_EnableOnTamper ( void )

Enable timestamp on tamper detection event.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPTS LL_RTC_TS_EnableOnTamper

void LL_RTC_TS_DisableOnTamper ( void )

Disable timestamp on tamper detection event.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TAMPTS LL_RTC_TS_DisableOnTamper

uint32_t LL_RTC_TS_IsEnabledOnTamper ( void )

Check whether timestamp on tamper detection is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSE LL_RTC_TS_IsEnabledOnTamper

Return values :

State – of bit (1 or 0)

Functions

void LL_RTC_WAKEUP_Enable ( void )

Enable wake-up timer.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTE LL_RTC_WAKEUP_Enable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_WAKEUP_Disable ( void )

Disable wake-up timer.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTE LL_RTC_WAKEUP_Disable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

uint32_t LL_RTC_WAKEUP_IsEnabled ( void )

Check whether wake-up timer is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTE LL_RTC_WAKEUP_IsEnabled

Return values :

State – of bit (1 or 0)

void LL_RTC_WAKEUP_Start ( uint32_t Interruption )

Start wake-up timer in interruption or polling mode.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTE LL_RTC_WAKEUP_Start

RTC_CR WUTIE LL_RTC_WAKEUP_Start

Parameters :

Interruption – This parameter can be one of the following values:

void LL_RTC_WAKEUP_Stop ( void )

Stop wake-up timer.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTE LL_RTC_WAKEUP_Stop

RTC_CR WUTIE LL_RTC_WAKEUP_Stop

void LL_RTC_WAKEUP_SetClock ( uint32_t WakeupClock )

Select wake-up clock.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUCKSEL LL_RTC_WAKEUP_SetClock

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RTC_CR WUTE bit = 0 and RTC_ICSR WUTWF bit = 1

Parameters :

WakeupClock – This parameter can be one of the following values:

uint32_t LL_RTC_WAKEUP_GetClock ( void )

Get wake-up clock.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUCKSEL LL_RTC_WAKEUP_GetClock

Return values :

Returned – value can be one of the following values:

void LL_RTC_WAKEUP_SetAutoReload ( uint32_t Value )

Set wake-up auto-reload value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WUTR WUT LL_RTC_WAKEUP_SetAutoReload

Note

Bit can be written only when WUTWF is set to 1 in RTC_ICSR

Parameters :

Value – Value between Min_Data=0x00 and Max_Data=0xFFFF

uint32_t LL_RTC_WAKEUP_GetAutoReload ( void )

Get wake-up auto-reload value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WUTR WUT LL_RTC_WAKEUP_GetAutoReload

Return values :

Value – between Min_Data=0x00 and Max_Data=0xFFFF

void LL_RTC_WAKEUP_SetAutoClear ( uint32_t Value )

Set wake-up auto-reload clear value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WUTR WUTOCLR LL_RTC_WAKEUP_SetAutoClear

Note

Bit can be written only when WUTWF is set to 1 in RTC_ICSR

Parameters :

Value – Value between Min_Data=0x00 and Max_Data=0xFFFF

uint32_t LL_RTC_WAKEUP_GetAutoClear ( void )

Get wake-up auto-reload clear value.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WUTR WUTOCLR LL_RTC_WAKEUP_GetAutoClear

Return values :

Value – between Min_Data=0x00 and Max_Data=0xFFFF

void LL_RTC_WAKEUP_Config ( uint32_t Reload , uint32_t Clear )

Set wake-up auto-reload and auto-reload clear values.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_WUTR WUTOCLR LL_RTC_WAKEUP_Config

RTC_WUTR WUT LL_RTC_WAKEUP_Config

Note

Bit can be written only when WUTWF is set to 1 in RTC_ICSR

Parameters :

  • Reload – Value between Min_Data=0x00 and Max_Data=0xFFFF

  • Clear – Value between Min_Data=0x00 and Max_Data=0xFFFF

Functions

void LL_RTC_CAL_SetOutputFreq ( uint32_t Frequency )

Set calibration output frequency (1 Hz or 512 Hz).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR COE LL_RTC_CAL_SetOutputFreq

RTC_CR COSEL LL_RTC_CAL_SetOutputFreq

Note

Bits are write-protected. Call LL_RTC_DisableWriteProtection before.

Parameters :

Frequency – This parameter can be one of the following values:

uint32_t LL_RTC_CAL_GetOutputFreq ( void )

Get calibration output frequency (1 Hz or 512 Hz).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR COE LL_RTC_CAL_GetOutputFreq

RTC_CR COSEL LL_RTC_CAL_GetOutputFreq

Return values :

Returned – value can be one of the following values:

void LL_RTC_CAL_SetPulse ( uint32_t Pulse )

Insert or do not insert one RTCCLK pulse every 2exp11 pulses (frequency increased by 488.5 ppm).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALP LL_RTC_CAL_SetPulse

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RECALPF is set to 0 in RTC_ICSR

Parameters :

Pulse – This parameter can be one of the following values:

uint32_t LL_RTC_CAL_IsPulseInserted ( void )

Check whether one RTCCLK has been inserted every 2exp11 pulses (frequency increased by 488.5 ppm).

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALP LL_RTC_CAL_IsPulseInserted

Return values :

State – of bit (1 or 0)

void LL_RTC_CAL_SetPeriod ( uint32_t Period )

Set the calibration cycle period.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALW8 LL_RTC_CAL_SetPeriod

RTC_CALR CALW16 LL_RTC_CAL_SetPeriod

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RECALPF is set to 0 in RTC_ICSR

Parameters :

Period – This parameter can be one of the following values:

uint32_t LL_RTC_CAL_GetPeriod ( void )

Get the calibration cycle period.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALW8 LL_RTC_CAL_GetPeriod

RTC_CALR CALW16 LL_RTC_CAL_GetPeriod

Return values :

Returned – value can be one of the following values:

void LL_RTC_CAL_SetMinus ( uint32_t CalibMinus )

Set calibration minus.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALM LL_RTC_CAL_SetMinus

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RECALPF is set to 0 in RTC_ICSR

Parameters :

CalibMinus – Value between Min_Data=0x00 and Max_Data=0x1FF

uint32_t LL_RTC_CAL_GetMinus ( void )

Get calibration minus.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALM LL_RTC_CAL_GetMinus

Return values :

Value – between Min_Data=0x00 and Max_Data=0x1FF

void LL_RTC_CAL_SetSmoothCalibration ( uint32_t SmoothCalibPeriod , uint32_t SmoothCalibPlusPulses , uint32_t SmoothCalibMinusPulsesValue )

Set smooth calibration.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALP LL_RTC_CAL_SetSmoothCalibration

RTC_CALR CALW8 LL_RTC_CAL_SetSmoothCalibration

RTC_CALR CALW16 LL_RTC_CAL_SetSmoothCalibration

RTC_CALR CALM LL_RTC_CAL_SetSmoothCalibration

Parameters :
uint32_t LL_RTC_CAL_IsEnabledSmoothCalibration ( void )

Check if the smooth calibration is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR CALP LL_RTC_CAL_IsEnabledSmoothCalibration

RTC_CALR CALM LL_RTC_CAL_IsEnabledSmoothCalibration

Return values :

State – of bit (1 or 0)

void LL_RTC_CAL_LowPower_Enable ( void )

Enable calibration low power.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR LPCAL LL_RTC_CAL_LowPower_Enable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RECALPF is set to 0

void LL_RTC_CAL_LowPower_Disable ( void )

Disable calibration low power.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR LPCAL LL_RTC_CAL_LowPower_Disable

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

Note

Bit can be written only when RECALPF is set to 0

uint32_t LL_RTC_CAL_LowPower_IsEnabled ( void )

Check whether calibration low power is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CALR LPCAL LL_RTC_CAL_LowPower_IsEnabled

Return values :

State – of bit (1 or 0)

Functions

uint32_t LL_RTC_IsActiveFlag_RECALP ( void )

Get Recalibration pending flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR RECALPF LL_RTC_IsActiveFlag_RECALP

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_TS ( void )

Get timestamp flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR TSF LL_RTC_IsActiveFlag_TS

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_TSOV ( void )

Get timestamp overflow flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR TSOVF LL_RTC_IsActiveFlag_TSOV

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_WUT ( void )

Get wake-up timer flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR WUTF LL_RTC_IsActiveFlag_WUT

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_ALRA ( void )

Get alarm A flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR ALRAF LL_RTC_IsActiveFlag_ALRA

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_ALRB ( void )

Get alarm B flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR ALRBF LL_RTC_IsActiveFlag_ALRB

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_ALR ( const uint32_t Alarm )

Get selected alarm flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR ALRBF LL_RTC_IsActiveFlag_ALR

RTC_SR ALRAF LL_RTC_IsActiveFlag_ALR

Parameters :

Alarm – This parameter can be one of the following values:

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_SSRU ( void )

Get SSR Underflow flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR SSRUF LL_RTC_IsActiveFlag_SSRU

Return values :

State – of bit (1 or 0)

void LL_RTC_ClearFlag_TS ( void )

Clear Timestamp flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SR CTSF LL_RTC_ClearFlag_TS

void LL_RTC_ClearFlag_TSOV ( void )

Clear Timestamp overflow flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CTSOVF LL_RTC_ClearFlag_TSOV

void LL_RTC_ClearFlag_WUT ( void )

Clear wake-up timer flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CWUTF LL_RTC_ClearFlag_WUT

void LL_RTC_ClearFlag_ALRA ( void )

Clear alarm A flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CALRAF LL_RTC_ClearFlag_ALRA

void LL_RTC_ClearFlag_ALRB ( void )

Clear alarm B flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CALRBF LL_RTC_ClearFlag_ALRB

void LL_RTC_ClearFlag_ALR ( uint32_t Alarm )

Clear the selected alarm flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CALRBF LL_RTC_ClearFlag_ALR

RTC_SCR CALRAF LL_RTC_ClearFlag_ALR

Parameters :

Alarm – This parameter can be one of the following values:

void LL_RTC_ClearFlag_SSRU ( void )

Clear SSR Underflow flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_SCR CSSRUF LL_RTC_ClearFlag_SSRU

uint32_t LL_RTC_IsActiveFlag_INIT ( void )

Get Initialization flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR INITF LL_RTC_IsActiveFlag_INIT

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_RS ( void )

Get Registers synchronization flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR RSF LL_RTC_IsActiveFlag_RS

Return values :

State – of bit (1 or 0)

void LL_RTC_ClearFlag_RS ( void )

Clear Registers synchronization flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR RSF LL_RTC_ClearFlag_RS

uint32_t LL_RTC_IsActiveFlag_INITS ( void )

Get Initialization status flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR INITS LL_RTC_IsActiveFlag_INITS

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_SHP ( void )

Get Shift operation pending flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR SHPF LL_RTC_IsActiveFlag_SHP

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_WUTW ( void )

Get wake-up timer write flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_ICSR WUTWF LL_RTC_IsActiveFlag_WUTW

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_ALRAM ( void )

Get alarm A masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR ALRAMF LL_RTC_IsActiveFlag_ALRAM

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_SSRUM ( void )

Get SSR Underflow masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR SSRUMF LL_RTC_IsActiveFlag_SSRUM

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_ALRBM ( void )

Get alarm B masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR ALRBMF LL_RTC_IsActiveFlag_ALRBM

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_WUTM ( void )

Get wake-up timer masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR WUTMF LL_RTC_IsActiveFlag_WUTM

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_TSM ( void )

Get timestamp masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR TSMF LL_RTC_IsActiveFlag_TSM

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsActiveFlag_TSOVM ( void )

Get timestamp overflow masked flag.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_MISR TSOVMF LL_RTC_IsActiveFlag_TSOVM

Return values :

State – of bit (1 or 0)

Functions

void LL_RTC_SetPrivAttr ( uint32_t item , uint32_t priv_attr )

Set privilege attribute configuration.

Reference Manual to LL API cross reference (Register Field Functions)

PRIVCFGR ALRAPRIV LL_RTC_SetPrivAttr

PRIVCFGR ALRBPRIV LL_RTC_SetPrivAttr

PRIVCFGR WUTPRIV LL_RTC_SetPrivAttr

PRIVCFGR TSPRIV LL_RTC_SetPrivAttr

PRIVCFGR CALPRIV LL_RTC_SetPrivAttr

PRIVCFGR INITPRIV LL_RTC_SetPrivAttr

PRIVCFGR PRIV LL_RTC_SetPrivAttr

Parameters :
uint32_t LL_RTC_GetPrivAttr ( uint32_t item )

Get privilege attribute configuration.

Reference Manual to LL API cross reference (Register Field Functions)

PRIVCFGR ALRAPRIV LL_RTC_GetPrivAttr

PRIVCFGR ALRBPRIV LL_RTC_GetPrivAttr

PRIVCFGR WUTPRIV LL_RTC_GetPrivAttr

PRIVCFGR TSPRIV LL_RTC_GetPrivAttr

PRIVCFGR CALPRIV LL_RTC_GetPrivAttr

PRIVCFGR INITPRIV LL_RTC_GetPrivAttr

PRIVCFGR PRIV LL_RTC_GetPrivAttr

Parameters :

item – This parameter can be one of the following values:

Return values :

Status – of bit (1 or 0).

  • 1: Privileged attribute enabled for the item.

  • 0: Non-privileged attribute for the item.

Functions

void LL_RTC_EnableIT_TS ( void )

Enable timestamp interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSIE LL_RTC_EnableIT_TS

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_DisableIT_TS ( void )

Disable timestamp interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSIE LL_RTC_DisableIT_TS

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_EnableIT_WUT ( void )

Enable wake-up timer interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTIE LL_RTC_EnableIT_WUT

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_DisableIT_WUT ( void )

Disable wake-up timer interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTIE LL_RTC_DisableIT_WUT

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_EnableIT_ALRB ( void )

Enable alarm B interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_EnableIT_ALRB

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_DisableIT_ALRB ( void )

Disable alarm B interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_DisableIT_ALRB

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_EnableIT_ALRA ( void )

Enable alarm A interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRAIE LL_RTC_EnableIT_ALRA

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_DisableIT_ALRA ( void )

Disable alarm A interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRAIE LL_RTC_DisableIT_ALRA

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_EnableIT_SSRU ( void )

Enable SSR underflow interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR SSRUIE LL_RTC_EnableIT_SSRU

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

void LL_RTC_DisableIT_SSRU ( void )

Disable SSR underflow interrupt.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR SSRUIE LL_RTC_DisableIT_SSRU

Note

Bit is write-protected. Call LL_RTC_DisableWriteProtection before.

uint32_t LL_RTC_IsEnabledIT_TS ( void )

Check whether timestamp interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR TSIE LL_RTC_IsEnabledIT_TS

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsEnabledIT_WUT ( void )

Check whether wake-up timer interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR WUTIE LL_RTC_IsEnabledIT_WUT

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsEnabledIT_ALRA ( void )

Check whether alarm A interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRAIE LL_RTC_IsEnabledIT_ALRA

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsEnabledIT_ALRB ( void )

Check whether alarm B interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR ALRBIE LL_RTC_IsEnabledIT_ALRB

Return values :

State – of bit (1 or 0)

uint32_t LL_RTC_IsEnabledIT_SSRU ( void )

Check whether SSR underflow interrupt is enabled.

Reference Manual to LL API cross reference (Register Field Functions)

RTC_CR SSRUIE LL_RTC_IsEnabledIT_SSRU

Return values :

State – of bit (1 or 0)