Functions
__STATIC_INLINE void	LL_RTC_TIME_SetFormat (RTC_TypeDef *RTCx, uint32_t TimeFormat)
	Set time format (AM/24-hour or PM notation)
__STATIC_INLINE uint32_t	LL_RTC_TIME_GetFormat (RTC_TypeDef *RTCx)
	Get time format (AM or PM notation)
__STATIC_INLINE void	LL_RTC_TIME_SetHour (RTC_TypeDef *RTCx, uint32_t Hours)
	Set Hours in BCD format.
__STATIC_INLINE uint32_t	LL_RTC_TIME_GetHour (RTC_TypeDef *RTCx)
	Get Hours in BCD format.
__STATIC_INLINE void	LL_RTC_TIME_SetMinute (RTC_TypeDef *RTCx, uint32_t Minutes)
	Set Minutes in BCD format.
__STATIC_INLINE uint32_t	LL_RTC_TIME_GetMinute (RTC_TypeDef *RTCx)
	Get Minutes in BCD format.
__STATIC_INLINE void	LL_RTC_TIME_SetSecond (RTC_TypeDef *RTCx, uint32_t Seconds)
	Set Seconds in BCD format.
__STATIC_INLINE uint32_t	LL_RTC_TIME_GetSecond (RTC_TypeDef *RTCx)
	Get Seconds in BCD format.
__STATIC_INLINE void	LL_RTC_TIME_Config (RTC_TypeDef *RTCx, uint32_t Format12_24, uint32_t Hours, uint32_t Minutes, uint32_t Seconds)
	Set time (hour, minute and second) in BCD format.
__STATIC_INLINE uint32_t	LL_RTC_TIME_Get (RTC_TypeDef *RTCx)
	Get time (hour, minute and second) in BCD format.
__STATIC_INLINE void	LL_RTC_TIME_EnableDayLightStore (RTC_TypeDef *RTCx)
	Memorize whether the daylight saving time change has been performed.
__STATIC_INLINE void	LL_RTC_TIME_DisableDayLightStore (RTC_TypeDef *RTCx)
	Disable memorization whether the daylight saving time change has been performed.
__STATIC_INLINE uint32_t	LL_RTC_TIME_IsDayLightStoreEnabled (RTC_TypeDef *RTCx)
	Check if RTC Day Light Saving stored operation has been enabled or not.
__STATIC_INLINE void	LL_RTC_TIME_DecHour (RTC_TypeDef *RTCx)
	Subtract 1 hour (winter time change)
__STATIC_INLINE void	LL_RTC_TIME_IncHour (RTC_TypeDef *RTCx)
	Add 1 hour (summer time change)
__STATIC_INLINE uint32_t	LL_RTC_TIME_GetSubSecond (RTC_TypeDef *RTCx)
	Get Sub second value in the synchronous prescaler counter.
__STATIC_INLINE void	LL_RTC_TIME_Synchronize (RTC_TypeDef *RTCx, uint32_t ShiftSecond, uint32_t Fraction)
	Synchronize to a remote clock with a high degree of precision.

Function Documentation

__STATIC_INLINE void LL_RTC_TIME_Config	(	RTC_TypeDef *	RTCx,
		uint32_t	Format12_24,
		uint32_t	Hours,
		uint32_t	Minutes,
		uint32_t	Seconds
	)

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

Reference Manual to LL API cross reference:: 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

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 1668 of file stm32l4xx_ll_rtc.h.

Referenced by LL_RTC_TIME_Init().

__STATIC_INLINE void LL_RTC_TIME_DecHour ( RTC_TypeDef * RTCx )

Subtract 1 hour (winter time change)

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

Reference Manual to LL API cross reference:: RTC_CR SUB1H LL_RTC_TIME_DecHour

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1748 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_DisableDayLightStore ( RTC_TypeDef * RTCx )

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

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

Reference Manual to LL API cross reference:: RTC_CR BKP LL_RTC_TIME_DisableDayLightStore

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1725 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_EnableDayLightStore ( RTC_TypeDef * RTCx )

Memorize whether the daylight saving time change has been performed.

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

Reference Manual to LL API cross reference:: RTC_CR BKP LL_RTC_TIME_EnableDayLightStore

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1713 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_Get ( RTC_TypeDef * RTCx )

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.

Reference Manual to LL API cross reference:: 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

Parameters:

RTCx	RTC Instance

Return values:

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

Definition at line 1696 of file stm32l4xx_ll_rtc.h.

References RTC_OFFSET_HOUR, and RTC_OFFSET_MINUTE.

__STATIC_INLINE uint32_t LL_RTC_TIME_GetFormat ( RTC_TypeDef * RTCx )

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

Reference Manual to LL API cross reference:: RTC_TR PM LL_RTC_TIME_GetFormat

Parameters:

RTCx	RTC Instance

Return values:

Returned

value can be one of the following values:

Definition at line 1537 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_GetHour ( RTC_TypeDef * RTCx )

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

Reference Manual to LL API cross reference:: RTC_TR HT LL_RTC_TIME_GetHour
RTC_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 1572 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_GetMinute ( RTC_TypeDef * RTCx )

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

Reference Manual to LL API cross reference:: RTC_TR MNT LL_RTC_TIME_GetMinute
RTC_TR MNU LL_RTC_TIME_GetMinute

Parameters:

RTCx	RTC Instance

Return values:

Value between Min_Data=0x00 and Max_Data=0x59

Definition at line 1607 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_GetSecond ( RTC_TypeDef * RTCx )

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

Reference Manual to LL API cross reference:: RTC_TR ST LL_RTC_TIME_GetSecond
RTC_TR SU LL_RTC_TIME_GetSecond

Parameters:

RTCx	RTC Instance

Return values:

Value between Min_Data=0x00 and Max_Data=0x59

Definition at line 1642 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_GetSubSecond ( RTC_TypeDef * RTCx )

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.

Reference Manual to LL API cross reference:: RTC_SSR SS LL_RTC_TIME_GetSubSecond

Parameters:

RTCx	RTC Instance

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

Definition at line 1779 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_IncHour ( RTC_TypeDef * RTCx )

Add 1 hour (summer time change)

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

Reference Manual to LL API cross reference:: RTC_CR ADD1H LL_RTC_TIME_IncHour

Parameters:

RTCx	RTC Instance

Return values:

None

Definition at line 1760 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE uint32_t LL_RTC_TIME_IsDayLightStoreEnabled ( RTC_TypeDef * RTCx )

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

Reference Manual to LL API cross reference:: RTC_CR BKP LL_RTC_TIME_IsDayLightStoreEnabled

Parameters:

RTCx	RTC Instance

Return values:

State of bit (1 or 0).

Definition at line 1736 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_SetFormat	(	RTC_TypeDef *	RTCx,
		uint32_t	TimeFormat
	)

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)

Reference Manual to LL API cross reference:: RTC_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 1520 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_SetHour	(	RTC_TypeDef *	RTCx,
		uint32_t	Hours
	)

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

Reference Manual to LL API cross reference:: RTC_TR HT LL_RTC_TIME_SetHour
RTC_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 1553 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_SetMinute	(	RTC_TypeDef *	RTCx,
		uint32_t	Minutes
	)

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

Reference Manual to LL API cross reference:: RTC_TR MNT LL_RTC_TIME_SetMinute
RTC_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 1588 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_SetSecond	(	RTC_TypeDef *	RTCx,
		uint32_t	Seconds
	)

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

Reference Manual to LL API cross reference:: RTC_TR ST LL_RTC_TIME_SetSecond
RTC_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 1623 of file stm32l4xx_ll_rtc.h.

__STATIC_INLINE void LL_RTC_TIME_Synchronize	(	RTC_TypeDef *	RTCx,
		uint32_t	ShiftSecond,
		uint32_t	Fraction
	)

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.

Reference Manual to LL API cross reference:: RTC_SHIFTR ADD1S LL_RTC_TIME_Synchronize
RTC_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 1798 of file stm32l4xx_ll_rtc.h.

Functions

Function Documentation