Collaboration diagram for Time:

Functions
__STATIC_INLINE void	LL_RTC_TIME_SetFormat (RTC_TypeDef *RTCx, uint32_t TimeFormat)
	Set time format (AM/24-hour or PM notation) More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_GetFormat (RTC_TypeDef *RTCx)
	Get time format (AM or PM notation) More...

__STATIC_INLINE void	LL_RTC_TIME_SetHour (RTC_TypeDef *RTCx, uint32_t Hours)
	Set Hours in BCD format. More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_GetHour (RTC_TypeDef *RTCx)
	Get Hours in BCD format. More...

__STATIC_INLINE void	LL_RTC_TIME_SetMinute (RTC_TypeDef *RTCx, uint32_t Minutes)
	Set Minutes in BCD format. More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_GetMinute (RTC_TypeDef *RTCx)
	Get Minutes in BCD format. More...

__STATIC_INLINE void	LL_RTC_TIME_SetSecond (RTC_TypeDef *RTCx, uint32_t Seconds)
	Set Seconds in BCD format. More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_GetSecond (RTC_TypeDef *RTCx)
	Get Seconds in BCD format. More...

__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. More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_Get (RTC_TypeDef *RTCx)
	Get time (hour, minute and second) in BCD format. More...

__STATIC_INLINE void	LL_RTC_TIME_EnableDayLightStore (RTC_TypeDef *RTCx)
	Memorize whether the daylight saving time change has been performed. More...

__STATIC_INLINE void	LL_RTC_TIME_DisableDayLightStore (RTC_TypeDef *RTCx)
	Disable memorization whether the daylight saving time change has been performed. More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_IsDayLightStoreEnabled (RTC_TypeDef *RTCx)
	Check if RTC Day Light Saving stored operation has been enabled or not @rmtoll CR BKP LL_RTC_TIME_IsDayLightStoreEnabled. More...

__STATIC_INLINE void	LL_RTC_TIME_DecHour (RTC_TypeDef *RTCx)
	Subtract 1 hour (winter time change) More...

__STATIC_INLINE void	LL_RTC_TIME_IncHour (RTC_TypeDef *RTCx)
	Add 1 hour (summer time change) More...

__STATIC_INLINE uint32_t	LL_RTC_TIME_GetSubSecond (RTC_TypeDef *RTCx)
	Get subseconds value in the synchronous prescaler counter. More...

__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. More...

Detailed Description

Function Documentation

◆ LL_RTC_TIME_Config()

__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 @rmtoll 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 1174 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_DecHour()

__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. @rmtoll CR SUB1H LL_RTC_TIME_DecHour

Parameters

RTCx	RTC Instance

Return values

None

Definition at line 1249 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_DisableDayLightStore()

__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. @rmtoll CR BKP LL_RTC_TIME_DisableDayLightStore

Parameters

RTCx	RTC Instance

Return values

None

Definition at line 1226 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_EnableDayLightStore()

__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. @rmtoll CR BKP LL_RTC_TIME_EnableDayLightStore

Parameters

RTCx	RTC Instance

Return values

None

Definition at line 1214 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_Get()

__STATIC_INLINE uint32_t LL_RTC_TIME_Get ( RTC_TypeDef * RTCx )

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

Note: if RTC shadow registers are not bypassed (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. @rmtoll 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 1202 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_GetFormat()

__STATIC_INLINE uint32_t LL_RTC_TIME_GetFormat ( RTC_TypeDef * RTCx )

Get time format (AM or PM notation)

Note: if RTC shadow registers are not bypassed (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)). @rmtoll 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 1043 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_GetHour()

__STATIC_INLINE uint32_t LL_RTC_TIME_GetHour ( RTC_TypeDef * RTCx )

Get Hours in BCD format.

Note: if RTC shadow registers are not bypassed (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 @rmtoll 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 1078 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_GetMinute()

__STATIC_INLINE uint32_t LL_RTC_TIME_GetMinute ( RTC_TypeDef * RTCx )

Get Minutes in BCD format.

Note: if RTC shadow registers are not bypassed (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 @rmtoll 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 1113 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_GetSecond()

__STATIC_INLINE uint32_t LL_RTC_TIME_GetSecond ( RTC_TypeDef * RTCx )

Get Seconds in BCD format.

Note: if RTC shadow registers are not bypassed (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 @rmtoll 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 1148 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_GetSubSecond()

__STATIC_INLINE uint32_t LL_RTC_TIME_GetSubSecond ( RTC_TypeDef * RTCx )

Get subseconds 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. @rmtoll SSR SS LL_RTC_TIME_GetSubSecond

Parameters

RTCx	RTC Instance

Return values

Subseconds value (number between 0 and 65535)

Definition at line 1280 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_IncHour()

__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. @rmtoll CR ADD1H LL_RTC_TIME_IncHour

Parameters

RTCx	RTC Instance

Return values

None

Definition at line 1261 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_IsDayLightStoreEnabled()

__STATIC_INLINE uint32_t LL_RTC_TIME_IsDayLightStoreEnabled ( RTC_TypeDef * RTCx )

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

Parameters

RTCx	RTC Instance

Return values

State of bit (1 or 0).

Definition at line 1237 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_SetFormat()

__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) @rmtoll 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 1026 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_SetHour()

__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 @rmtoll 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 1059 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_SetMinute()

__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 @rmtoll 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 1094 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_SetSecond()

__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 @rmtoll 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 1129 of file stm32f4xx_ll_rtc.h.

◆ LL_RTC_TIME_Synchronize()

__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. @rmtoll 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 1299 of file stm32f4xx_ll_rtc.h.

Functions

Detailed Description

Function Documentation

◆ LL_RTC_TIME_Config()

◆ LL_RTC_TIME_DecHour()

◆ LL_RTC_TIME_DisableDayLightStore()

◆ LL_RTC_TIME_EnableDayLightStore()

◆ LL_RTC_TIME_Get()

◆ LL_RTC_TIME_GetFormat()

◆ LL_RTC_TIME_GetHour()

◆ LL_RTC_TIME_GetMinute()

◆ LL_RTC_TIME_GetSecond()

◆ LL_RTC_TIME_GetSubSecond()

◆ LL_RTC_TIME_IncHour()

◆ LL_RTC_TIME_IsDayLightStoreEnabled()

◆ LL_RTC_TIME_SetFormat()

◆ LL_RTC_TIME_SetHour()

◆ LL_RTC_TIME_SetMinute()

◆ LL_RTC_TIME_SetSecond()

◆ LL_RTC_TIME_Synchronize()