Time
[RTC Exported Functions]

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

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

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

TimeFormat and Hours should follow the same format TR PM LL_RTC_TIME_Config
TR HT LL_RTC_TIME_Config
TR HU LL_RTC_TIME_Config
TR MNT LL_RTC_TIME_Config
TR MNU LL_RTC_TIME_Config
TR ST LL_RTC_TIME_Config
TR SU LL_RTC_TIME_Config

Parameters:

RTCx	RTC Instance
Format12_24	This parameter can be one of the following values: LL_RTC_TIME_FORMAT_AM_OR_24 LL_RTC_TIME_FORMAT_PM
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

Return values:

None

Definition at line 1304 of file stm32l4xx_ll_rtc.h.

Subtract 1 hour (winter time change)

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before. CR SUB1H LL_RTC_TIME_DecHour

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1379 of file stm32l4xx_ll_rtc.h.

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

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before. CR BCK LL_RTC_TIME_DisableDayLightStore

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1356 of file stm32l4xx_ll_rtc.h.

Memorize whether the daylight saving time change has been performed.

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before. CR BCK LL_RTC_TIME_EnableDayLightStore

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1344 of file stm32l4xx_ll_rtc.h.

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

Note:

if shadow mode is disabled (BYPSHAD=0), need to check if RSF flag is set before reading this bit

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

helper macros __LL_RTC_GET_HOUR, __LL_RTC_GET_MINUTE and __LL_RTC_GET_SECOND are available to get independently each parameter. TR HT LL_RTC_TIME_Get
TR HU LL_RTC_TIME_Get
TR MNT LL_RTC_TIME_Get
TR MNU LL_RTC_TIME_Get
TR ST LL_RTC_TIME_Get
TR SU LL_RTC_TIME_Get

Parameters:

RTCx	RTC Instance

Return values:

Combination

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

Definition at line 1332 of file stm32l4xx_ll_rtc.h.

Get time format (AM or PM notation)

Note:

if shadow mode is disabled (BYPSHAD=0), need to check if RSF flag is set before reading this bit

Read either RTC_SSR or RTC_TR locks the values in the higher-order calendar shadow registers until RTC_DR is read (LL_RTC_ReadReg(RTC, DR)). TR PM LL_RTC_TIME_GetFormat

Parameters:

RTCx	RTC Instance

Return values:

Returned

value can be one of the following values: LL_RTC_TIME_FORMAT_AM_OR_24 LL_RTC_TIME_FORMAT_PM

Definition at line 1164 of file stm32l4xx_ll_rtc.h.

Get Hours in BCD format.

Note:

if shadow mode is disabled (BYPSHAD=0), need to check if RSF flag is set before reading this bit

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert hour from BCD to Binary format TR HT LL_RTC_TIME_GetHour
TR HU LL_RTC_TIME_GetHour

Parameters:

RTCx	RTC Instance

Return values:

Value

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

Definition at line 1199 of file stm32l4xx_ll_rtc.h.

Get Minutes in BCD format.

Note:

if shadow mode is disabled (BYPSHAD=0), need to check if RSF flag is set before reading this bit

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert minute from BCD to Binary format TR MNT LL_RTC_TIME_GetMinute
TR MNU LL_RTC_TIME_GetMinute

Parameters:

RTCx	RTC Instance

Return values:

Value

between Min_Data=0x00 and Max_Data=0x59

Definition at line 1237 of file stm32l4xx_ll_rtc.h.

Get Seconds in BCD format.

Note:

if shadow mode is disabled (BYPSHAD=0), need to check if RSF flag is set before reading this bit

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert Seconds from BCD to Binary format TR ST LL_RTC_TIME_GetSecond
TR SU LL_RTC_TIME_GetSecond

Parameters:

RTCx	RTC Instance

Return values:

Value

between Min_Data=0x00 and Max_Data=0x59

Definition at line 1275 of file stm32l4xx_ll_rtc.h.

Get Sub second value in the synchronous prescaler counter.

Note:

You can use both SubSeconds value and SecondFraction (PREDIV_S through LL_RTC_GetSynchPrescaler function) terms returned to convert Calendar SubSeconds value in second fraction ratio with time unit following generic 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. SSR SS LL_RTC_TIME_GetSubSecond

Parameters:

RTCx	RTC Instance

Return values:

Sub	second value (number between 0 and 65535)

Definition at line 1409 of file stm32l4xx_ll_rtc.h.

Add 1 hour (summer time change)

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before. CR ADD1H LL_RTC_TIME_IncHour

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1391 of file stm32l4xx_ll_rtc.h.

Check if RTC Day Light Saving stored operation has been enabled or not CR BCK LL_RTC_TIME_IsDayLightStoreEnabled.

Parameters:

RTCx	RTC Instance

Return values:

State

of bit (1 or 0).

Definition at line 1367 of file stm32l4xx_ll_rtc.h.

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

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

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

Parameters:

RTCx	RTC Instance
TimeFormat	This parameter can be one of the following values: LL_RTC_TIME_FORMAT_AM_OR_24 LL_RTC_TIME_FORMAT_PM

Return values:

None

Definition at line 1147 of file stm32l4xx_ll_rtc.h.

Set Hours in BCD format.

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

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

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert hour from binary to BCD format TR HT LL_RTC_TIME_SetHour
TR HU LL_RTC_TIME_SetHour

Parameters:

RTCx	RTC Instance
Hours	Value between Min_Data=0x01 and Max_Data=0x12 or between Min_Data=0x00 and Max_Data=0x23

Return values:

None

Definition at line 1180 of file stm32l4xx_ll_rtc.h.

Set Minutes in BCD format.

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

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

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert Minutes from binary to BCD format TR MNT LL_RTC_TIME_SetMinute
TR MNU LL_RTC_TIME_SetMinute

Parameters:

RTCx	RTC Instance
Minutes	Value between Min_Data=0x00 and Max_Data=0x59

Return values:

None

Definition at line 1218 of file stm32l4xx_ll_rtc.h.

Set Seconds in BCD format.

Note:

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

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

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert Seconds from binary to BCD format TR ST LL_RTC_TIME_SetSecond
TR SU LL_RTC_TIME_SetSecond

Parameters:

RTCx	RTC Instance
Seconds	Value between Min_Data=0x00 and Max_Data=0x59

Return values:

None

Definition at line 1256 of file stm32l4xx_ll_rtc.h.

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

Note:

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

Bit is write-protected. LL_RTC_DisableWriteProtection function should be called before.

When REFCKON is set, firmware must not write to Shift control register. SHIFTR ADD1S LL_RTC_TIME_Synchronize
SHIFTR SUBFS LL_RTC_TIME_Synchronize

Parameters:

RTCx	RTC Instance
ShiftSecond	This parameter can be one of the following values: LL_RTC_SHIFT_SECOND_DELAY LL_RTC_SHIFT_SECOND_ADVANCE
Fraction	Number of Seconds Fractions (any value from 0 to 0x7FFF)

Return values:

None

Definition at line 1428 of file stm32l4xx_ll_rtc.h.