Date

Functions
__STATIC_INLINE void	LL_RTC_DATE_SetYear (RTC_TypeDef *RTCx, uint32_t Year)
	Set Year in BCD format. More...
__STATIC_INLINE uint32_t	LL_RTC_DATE_GetYear (RTC_TypeDef *RTCx)
	Get Year in BCD format. More...
__STATIC_INLINE void	LL_RTC_DATE_SetWeekDay (RTC_TypeDef *RTCx, uint32_t WeekDay)
	Set Week day RTC_DR WDU LL_RTC_DATE_SetWeekDay. More...
__STATIC_INLINE uint32_t	LL_RTC_DATE_GetWeekDay (RTC_TypeDef *RTCx)
	Get Week day. More...
__STATIC_INLINE void	LL_RTC_DATE_SetMonth (RTC_TypeDef *RTCx, uint32_t Month)
	Set Month in BCD format. More...
__STATIC_INLINE uint32_t	LL_RTC_DATE_GetMonth (RTC_TypeDef *RTCx)
	Get Month in BCD format. More...
__STATIC_INLINE void	LL_RTC_DATE_SetDay (RTC_TypeDef *RTCx, uint32_t Day)
	Set Day in BCD format. More...
__STATIC_INLINE uint32_t	LL_RTC_DATE_GetDay (RTC_TypeDef *RTCx)
	Get Day in BCD format. More...
__STATIC_INLINE void	LL_RTC_DATE_Config (RTC_TypeDef *RTCx, uint32_t WeekDay, uint32_t Day, uint32_t Month, uint32_t Year)
	Set date (WeekDay, Day, Month and Year) in BCD format 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. More...
__STATIC_INLINE uint32_t	LL_RTC_DATE_Get (RTC_TypeDef *RTCx)
	Get date (WeekDay, Day, Month and Year) in BCD format. More...

Detailed Description

Function Documentation

LL_RTC_DATE_Config()

__STATIC_INLINE void LL_RTC_DATE_Config	(	RTC_TypeDef *	RTCx,
		uint32_t	WeekDay,
		uint32_t	Day,
		uint32_t	Month,
		uint32_t	Year
	)

Set date (WeekDay, Day, Month and Year) in BCD format 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

RTCx	RTC Instance
WeekDay	This parameter can be one of the following values: LL_RTC_WEEKDAY_MONDAY LL_RTC_WEEKDAY_TUESDAY LL_RTC_WEEKDAY_WEDNESDAY LL_RTC_WEEKDAY_THURSDAY LL_RTC_WEEKDAY_FRIDAY LL_RTC_WEEKDAY_SATURDAY LL_RTC_WEEKDAY_SUNDAY
Day	Value between Min_Data=0x01 and Max_Data=0x31
Month	This parameter can be one of the following values: LL_RTC_MONTH_JANUARY LL_RTC_MONTH_FEBRUARY LL_RTC_MONTH_MARCH LL_RTC_MONTH_APRIL LL_RTC_MONTH_MAY LL_RTC_MONTH_JUNE LL_RTC_MONTH_JULY LL_RTC_MONTH_AUGUST LL_RTC_MONTH_SEPTEMBER LL_RTC_MONTH_OCTOBER LL_RTC_MONTH_NOVEMBER LL_RTC_MONTH_DECEMBER
Year	Value between Min_Data=0x00 and Max_Data=0x99

Return values

None

Definition at line 1837 of file stm32l4xx_ll_rtc.h.

{
  register uint32_t temp = 0U;

  temp = (WeekDay << RTC_DR_WDU_Pos)                                                        | \
         (((Year & 0xF0U) << (RTC_DR_YT_Pos - 4U)) | ((Year & 0x0FU) << RTC_DR_YU_Pos))   | \
         (((Month & 0xF0U) << (RTC_DR_MT_Pos - 4U)) | ((Month & 0x0FU) << RTC_DR_MU_Pos)) | \
         (((Day & 0xF0U) << (RTC_DR_DT_Pos - 4U)) | ((Day & 0x0FU) << RTC_DR_DU_Pos));

  MODIFY_REG(RTCx->DR, (RTC_DR_WDU | RTC_DR_MT | RTC_DR_MU | RTC_DR_DT | RTC_DR_DU | RTC_DR_YT | RTC_DR_YU), temp);
}

LL_RTC_DATE_Get()

__STATIC_INLINE uint32_t LL_RTC_DATE_Get

(

RTC_TypeDef *

RTCx

)

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

Note

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

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

Parameters

RTCx	RTC Instance

Return values

Combination

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

Definition at line 1865 of file stm32l4xx_ll_rtc.h.

{
  register uint32_t temp = 0U;

  temp = READ_BIT(RTCx->DR, (RTC_DR_WDU | RTC_DR_MT | RTC_DR_MU | RTC_DR_DT | RTC_DR_DU | RTC_DR_YT | RTC_DR_YU));
  return (uint32_t)((((temp & RTC_DR_WDU) >> RTC_DR_WDU_Pos) << RTC_OFFSET_WEEKDAY) | \
                    (((((temp & RTC_DR_DT) >> RTC_DR_DT_Pos) << 4U) | ((temp & RTC_DR_DU) >> RTC_DR_DU_Pos)) << RTC_OFFSET_DAY) | \
                    (((((temp & RTC_DR_MT) >> RTC_DR_MT_Pos) << 4U) | ((temp & RTC_DR_MU) >> RTC_DR_MU_Pos)) << RTC_OFFSET_MONTH) | \
                    ((((temp & RTC_DR_YT) >> RTC_DR_YT_Pos) << 4U) | ((temp & RTC_DR_YU) >> RTC_DR_YU_Pos)));
}

LL_RTC_DATE_GetDay()

__STATIC_INLINE uint32_t LL_RTC_DATE_GetDay

(

RTC_TypeDef *

RTCx

)

Get Day in BCD format.

Note

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert Day from BCD to Binary format RTC_DR DT LL_RTC_DATE_GetDay
RTC_DR DU LL_RTC_DATE_GetDay

Parameters

RTCx	RTC Instance

Return values

Value

between Min_Data=0x01 and Max_Data=0x31

Definition at line 1797 of file stm32l4xx_ll_rtc.h.

{
  return ((READ_BIT(RTCx->DR, (RTC_DR_DT | RTC_DR_DU))) >> RTC_DR_DU_Pos);
}

LL_RTC_DATE_GetMonth()

__STATIC_INLINE uint32_t LL_RTC_DATE_GetMonth

(

RTC_TypeDef *

RTCx

)

Get Month in BCD format.

Note

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert Month from BCD to Binary format RTC_DR MT LL_RTC_DATE_GetMonth
RTC_DR MU LL_RTC_DATE_GetMonth

Parameters

RTCx	RTC Instance

Return values

Returned

value can be one of the following values: LL_RTC_MONTH_JANUARY LL_RTC_MONTH_FEBRUARY LL_RTC_MONTH_MARCH LL_RTC_MONTH_APRIL LL_RTC_MONTH_MAY LL_RTC_MONTH_JUNE LL_RTC_MONTH_JULY LL_RTC_MONTH_AUGUST LL_RTC_MONTH_SEPTEMBER LL_RTC_MONTH_OCTOBER LL_RTC_MONTH_NOVEMBER LL_RTC_MONTH_DECEMBER

Definition at line 1767 of file stm32l4xx_ll_rtc.h.

{
  return ((READ_BIT(RTCx->DR, (RTC_DR_MT | RTC_DR_MU))) >> RTC_DR_MU_Pos);
}

LL_RTC_DATE_GetWeekDay()

__STATIC_INLINE uint32_t LL_RTC_DATE_GetWeekDay

(

RTC_TypeDef *

RTCx

)

Get Week day.

Note

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

Parameters

RTCx	RTC Instance

Return values

Returned

value can be one of the following values: LL_RTC_WEEKDAY_MONDAY LL_RTC_WEEKDAY_TUESDAY LL_RTC_WEEKDAY_WEDNESDAY LL_RTC_WEEKDAY_THURSDAY LL_RTC_WEEKDAY_FRIDAY LL_RTC_WEEKDAY_SATURDAY LL_RTC_WEEKDAY_SUNDAY

Definition at line 1713 of file stm32l4xx_ll_rtc.h.

{
  return (uint32_t)(READ_BIT(RTCx->DR, RTC_DR_WDU) >> RTC_DR_WDU_Pos);
}

LL_RTC_DATE_GetYear()

__STATIC_INLINE uint32_t LL_RTC_DATE_GetYear

(

RTC_TypeDef *

RTCx

)

Get Year in BCD format.

Note

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

helper macro __LL_RTC_CONVERT_BCD2BIN is available to convert Year from BCD to Binary format RTC_DR YT LL_RTC_DATE_GetYear
RTC_DR YU LL_RTC_DATE_GetYear

Parameters

RTCx	RTC Instance

Return values

Value

between Min_Data=0x00 and Max_Data=0x99

Definition at line 1674 of file stm32l4xx_ll_rtc.h.

{
  return ((READ_BIT(RTCx->DR, (RTC_DR_YT | RTC_DR_YU))) >> RTC_DR_YU_Pos);
}

LL_RTC_DATE_SetDay()

__STATIC_INLINE void LL_RTC_DATE_SetDay	(	RTC_TypeDef *	RTCx,
		uint32_t	Day
	)

Set Day in BCD format.

Note

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert Day from binary to BCD format RTC_DR DT LL_RTC_DATE_SetDay
RTC_DR DU LL_RTC_DATE_SetDay

Parameters

RTCx	RTC Instance
Day	Value between Min_Data=0x01 and Max_Data=0x31

Return values

None

Definition at line 1781 of file stm32l4xx_ll_rtc.h.

{
  MODIFY_REG(RTCx->DR, (RTC_DR_DT | RTC_DR_DU),
             (((Day & 0xF0U) << (RTC_DR_DT_Pos - 4U)) | ((Day & 0x0FU) << RTC_DR_DU_Pos)));
}

LL_RTC_DATE_SetMonth()

__STATIC_INLINE void LL_RTC_DATE_SetMonth	(	RTC_TypeDef *	RTCx,
		uint32_t	Month
	)

Set Month in BCD format.

Note

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert Month from binary to BCD format RTC_DR MT LL_RTC_DATE_SetMonth
RTC_DR MU LL_RTC_DATE_SetMonth

Parameters

RTCx	RTC Instance
Month	This parameter can be one of the following values: LL_RTC_MONTH_JANUARY LL_RTC_MONTH_FEBRUARY LL_RTC_MONTH_MARCH LL_RTC_MONTH_APRIL LL_RTC_MONTH_MAY LL_RTC_MONTH_JUNE LL_RTC_MONTH_JULY LL_RTC_MONTH_AUGUST LL_RTC_MONTH_SEPTEMBER LL_RTC_MONTH_OCTOBER LL_RTC_MONTH_NOVEMBER LL_RTC_MONTH_DECEMBER

Return values

None

Definition at line 1739 of file stm32l4xx_ll_rtc.h.

{
  MODIFY_REG(RTCx->DR, (RTC_DR_MT | RTC_DR_MU),
             (((Month & 0xF0U) << (RTC_DR_MT_Pos - 4U)) | ((Month & 0x0FU) << RTC_DR_MU_Pos)));
}

LL_RTC_DATE_SetWeekDay()

__STATIC_INLINE void LL_RTC_DATE_SetWeekDay	(	RTC_TypeDef *	RTCx,
		uint32_t	WeekDay
	)

Set Week day RTC_DR WDU LL_RTC_DATE_SetWeekDay.

Parameters

RTCx	RTC Instance
WeekDay	This parameter can be one of the following values: LL_RTC_WEEKDAY_MONDAY LL_RTC_WEEKDAY_TUESDAY LL_RTC_WEEKDAY_WEDNESDAY LL_RTC_WEEKDAY_THURSDAY LL_RTC_WEEKDAY_FRIDAY LL_RTC_WEEKDAY_SATURDAY LL_RTC_WEEKDAY_SUNDAY

Return values

None

Definition at line 1693 of file stm32l4xx_ll_rtc.h.

{
  MODIFY_REG(RTCx->DR, RTC_DR_WDU, WeekDay << RTC_DR_WDU_Pos);
}

LL_RTC_DATE_SetYear()

__STATIC_INLINE void LL_RTC_DATE_SetYear	(	RTC_TypeDef *	RTCx,
		uint32_t	Year
	)

Set Year in BCD format.

Note

helper macro __LL_RTC_CONVERT_BIN2BCD is available to convert Year from binary to BCD format RTC_DR YT LL_RTC_DATE_SetYear
RTC_DR YU LL_RTC_DATE_SetYear

Parameters

RTCx	RTC Instance
Year	Value between Min_Data=0x00 and Max_Data=0x99

Return values

None

Definition at line 1658 of file stm32l4xx_ll_rtc.h.

{
  MODIFY_REG(RTCx->DR, (RTC_DR_YT | RTC_DR_YU),
             (((Year & 0xF0U) << (RTC_DR_YT_Pos - 4U)) | ((Year & 0x0FU) << RTC_DR_YU_Pos)));
}