RTC Private Functions

Functions
HAL_StatusTypeDef	RTC_EnterInitMode (RTC_HandleTypeDef *hrtc)
	Enter the RTC Initialization mode. More...
HAL_StatusTypeDef	RTC_ExitInitMode (RTC_HandleTypeDef *hrtc)
	Exit the RTC Initialization mode. More...
uint8_t	RTC_ByteToBcd2 (uint8_t Value)
	Convert a 2 digit decimal to BCD format. More...
uint8_t	RTC_Bcd2ToByte (uint8_t Value)
	Convert from 2 digit BCD to Binary. More...

Detailed Description

Function Documentation

RTC_Bcd2ToByte()

uint8_t RTC_Bcd2ToByte

(

uint8_t

Value

)

Convert from 2 digit BCD to Binary.

Parameters

Value

BCD value to be converted

Return values

Converted

word

Definition at line 1874 of file stm32l4xx_hal_rtc.c.

{
  uint8_t tmp;
  tmp = ((Value & 0xF0U) >> 4U) * 10U;
  return (tmp + (Value & 0x0FU));
}

RTC_ByteToBcd2()

uint8_t RTC_ByteToBcd2

(

uint8_t

Value

)

Convert a 2 digit decimal to BCD format.

Parameters

Value

Byte to be converted

Return values

Converted

byte

Definition at line 1855 of file stm32l4xx_hal_rtc.c.

{
  uint32_t bcdhigh = 0U;
  uint8_t temp = Value;

  while (temp >= 10U)
  {
    bcdhigh++;
    temp -= 10U;
  }

  return ((uint8_t)(bcdhigh << 4U) | temp);
}

RTC_EnterInitMode()

HAL_StatusTypeDef RTC_EnterInitMode

(

RTC_HandleTypeDef *

hrtc

)

Enter the RTC Initialization mode.

Note

The RTC Initialization mode is write protected, use the __HAL_RTC_WRITEPROTECTION_DISABLE() before calling this function.

Parameters

hrtc	RTC handle

Return values

HAL

status

Definition at line 1761 of file stm32l4xx_hal_rtc.c.

{
  uint32_t tickstart;
  HAL_StatusTypeDef status = HAL_OK;

  /* Check if the Initialization mode is set */
#if defined(STM32L412xx) || defined(STM32L422xx)
  if ((hrtc->Instance->ICSR & RTC_ICSR_INITF) == 0U)
  {
    /* Set the Initialization mode */
    SET_BIT(hrtc->Instance->ICSR, RTC_ICSR_INIT);

    tickstart = HAL_GetTick();
    /* Wait till RTC is in INIT state and if Time out is reached exit */
    while ((READ_BIT(hrtc->Instance->ICSR, RTC_ICSR_INITF) == 0U) && (status != HAL_TIMEOUT))
    {
      if ((HAL_GetTick()  - tickstart) > RTC_TIMEOUT_VALUE)
      {
        status = HAL_TIMEOUT;
        hrtc->State = HAL_RTC_STATE_TIMEOUT;
      }
    }
  }
#else /* #if defined(STM32L412xx) || defined(STM32L422xx) */
  if ((hrtc->Instance->ISR & RTC_ISR_INITF) == 0U)
  {
    /* Set the Initialization mode */
    hrtc->Instance->ISR = (uint32_t)RTC_INIT_MASK;

    tickstart = HAL_GetTick();
    /* Wait till RTC is in INIT state and if Time out is reached exit */
    while ((READ_BIT(hrtc->Instance->ISR, RTC_ISR_INITF) == 0U) && (status != HAL_TIMEOUT))
    {
      if ((HAL_GetTick()  - tickstart) > RTC_TIMEOUT_VALUE)
      {
        status = HAL_TIMEOUT;
        hrtc->State = HAL_RTC_STATE_TIMEOUT;
      }
    }
  }
#endif /* #if defined(STM32L412xx) || defined(STM32L422xx) */

  return status;
}

RTC_ExitInitMode()

HAL_StatusTypeDef RTC_ExitInitMode

(

RTC_HandleTypeDef *

hrtc

)

Exit the RTC Initialization mode.

Parameters

hrtc	RTC handle

Return values

HAL

status

Definition at line 1811 of file stm32l4xx_hal_rtc.c.

{
  HAL_StatusTypeDef status = HAL_OK;

  /* Exit Initialization mode */
#if defined(STM32L412xx) || defined(STM32L422xx)
  CLEAR_BIT(RTC->ICSR, RTC_ICSR_INIT);
#else
  /* Exit Initialization mode */
  CLEAR_BIT(RTC->ISR, RTC_ISR_INIT);
#endif

  /* If CR_BYPSHAD bit = 0, wait for synchro */
  if (READ_BIT(RTC->CR, RTC_CR_BYPSHAD) == 0U)
  {
    if (HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
    {
      hrtc->State = HAL_RTC_STATE_TIMEOUT;
      status = HAL_TIMEOUT;
    }
  }
  else /* WA 2.9.6 Calendar initialization may fail in case of consecutive INIT mode entry */
  {
    /* Clear BYPSHAD bit */
    CLEAR_BIT(RTC->CR, RTC_CR_BYPSHAD);
    if (HAL_RTC_WaitForSynchro(hrtc) != HAL_OK)
    {
      hrtc->State = HAL_RTC_STATE_TIMEOUT;
      status = HAL_TIMEOUT;
    }
    /* Restore BYPSHAD bit */
    SET_BIT(RTC->CR, RTC_CR_BYPSHAD);
  }

  return status;
}