| /** |
| ****************************************************************************** |
| * @file stm32f2xx_ll_rtc.c |
| * @author MCD Application Team |
| * @brief RTC LL module driver. |
| ****************************************************************************** |
| * @attention |
| * |
| * <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2> |
| * |
| * Redistribution and use in source and binary forms, with or without modification, |
| * are permitted provided that the following conditions are met: |
| * 1. Redistributions of source code must retain the above copyright notice, |
| * this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright notice, |
| * this list of conditions and the following disclaimer in the documentation |
| * and/or other materials provided with the distribution. |
| * 3. Neither the name of STMicroelectronics nor the names of its contributors |
| * may be used to endorse or promote products derived from this software |
| * without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE |
| * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE |
| * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR |
| * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER |
| * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| * |
| ****************************************************************************** |
| */ |
| #if defined(USE_FULL_LL_DRIVER) |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32f2xx_ll_rtc.h" |
| #include "stm32f2xx_ll_cortex.h" |
| #ifdef USE_FULL_ASSERT |
| #include "stm32_assert.h" |
| #else |
| #define assert_param(expr) ((void)0U) |
| #endif |
| |
| /** @addtogroup STM32F2xx_LL_Driver |
| * @{ |
| */ |
| |
| #if defined(RTC) |
| |
| /** @addtogroup RTC_LL |
| * @{ |
| */ |
| |
| /* Private types -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private constants ---------------------------------------------------------*/ |
| /** @addtogroup RTC_LL_Private_Constants |
| * @{ |
| */ |
| /* Default values used for prescaler */ |
| #define RTC_ASYNCH_PRESC_DEFAULT 0x0000007FU |
| #define RTC_SYNCH_PRESC_DEFAULT 0x000000FFU |
| |
| /* Values used for timeout */ |
| #define RTC_INITMODE_TIMEOUT 1000U /* 1s when tick set to 1ms */ |
| #define RTC_SYNCHRO_TIMEOUT 1000U /* 1s when tick set to 1ms */ |
| /** |
| * @} |
| */ |
| |
| /* Private macros ------------------------------------------------------------*/ |
| /** @addtogroup RTC_LL_Private_Macros |
| * @{ |
| */ |
| |
| #define IS_LL_RTC_HOURFORMAT(__VALUE__) (((__VALUE__) == LL_RTC_HOURFORMAT_24HOUR) \ |
| || ((__VALUE__) == LL_RTC_HOURFORMAT_AMPM)) |
| |
| #define IS_LL_RTC_ASYNCH_PREDIV(__VALUE__) ((__VALUE__) <= 0x7FU) |
| |
| #define IS_LL_RTC_SYNCH_PREDIV(__VALUE__) ((__VALUE__) <= 0x1FFFU) |
| |
| #define IS_LL_RTC_FORMAT(__VALUE__) (((__VALUE__) == LL_RTC_FORMAT_BIN) \ |
| || ((__VALUE__) == LL_RTC_FORMAT_BCD)) |
| |
| #define IS_LL_RTC_TIME_FORMAT(__VALUE__) (((__VALUE__) == LL_RTC_TIME_FORMAT_AM_OR_24) \ |
| || ((__VALUE__) == LL_RTC_TIME_FORMAT_PM)) |
| |
| #define IS_LL_RTC_HOUR12(__HOUR__) (((__HOUR__) > 0U) && ((__HOUR__) <= 12U)) |
| #define IS_LL_RTC_HOUR24(__HOUR__) ((__HOUR__) <= 23U) |
| #define IS_LL_RTC_MINUTES(__MINUTES__) ((__MINUTES__) <= 59U) |
| #define IS_LL_RTC_SECONDS(__SECONDS__) ((__SECONDS__) <= 59U) |
| |
| #define IS_LL_RTC_WEEKDAY(__VALUE__) (((__VALUE__) == LL_RTC_WEEKDAY_MONDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_TUESDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_WEDNESDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_THURSDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_FRIDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_SATURDAY) \ |
| || ((__VALUE__) == LL_RTC_WEEKDAY_SUNDAY)) |
| |
| #define IS_LL_RTC_DAY(__DAY__) (((__DAY__) >= 1U) && ((__DAY__) <= 31U)) |
| |
| #define IS_LL_RTC_MONTH(__VALUE__) (((__VALUE__) == LL_RTC_MONTH_JANUARY) \ |
| || ((__VALUE__) == LL_RTC_MONTH_FEBRUARY) \ |
| || ((__VALUE__) == LL_RTC_MONTH_MARCH) \ |
| || ((__VALUE__) == LL_RTC_MONTH_APRIL) \ |
| || ((__VALUE__) == LL_RTC_MONTH_MAY) \ |
| || ((__VALUE__) == LL_RTC_MONTH_JUNE) \ |
| || ((__VALUE__) == LL_RTC_MONTH_JULY) \ |
| || ((__VALUE__) == LL_RTC_MONTH_AUGUST) \ |
| || ((__VALUE__) == LL_RTC_MONTH_SEPTEMBER) \ |
| || ((__VALUE__) == LL_RTC_MONTH_OCTOBER) \ |
| || ((__VALUE__) == LL_RTC_MONTH_NOVEMBER) \ |
| || ((__VALUE__) == LL_RTC_MONTH_DECEMBER)) |
| |
| #define IS_LL_RTC_YEAR(__YEAR__) ((__YEAR__) <= 99U) |
| |
| #define IS_LL_RTC_ALMA_MASK(__VALUE__) (((__VALUE__) == LL_RTC_ALMA_MASK_NONE) \ |
| || ((__VALUE__) == LL_RTC_ALMA_MASK_DATEWEEKDAY) \ |
| || ((__VALUE__) == LL_RTC_ALMA_MASK_HOURS) \ |
| || ((__VALUE__) == LL_RTC_ALMA_MASK_MINUTES) \ |
| || ((__VALUE__) == LL_RTC_ALMA_MASK_SECONDS) \ |
| || ((__VALUE__) == LL_RTC_ALMA_MASK_ALL)) |
| |
| #define IS_LL_RTC_ALMB_MASK(__VALUE__) (((__VALUE__) == LL_RTC_ALMB_MASK_NONE) \ |
| || ((__VALUE__) == LL_RTC_ALMB_MASK_DATEWEEKDAY) \ |
| || ((__VALUE__) == LL_RTC_ALMB_MASK_HOURS) \ |
| || ((__VALUE__) == LL_RTC_ALMB_MASK_MINUTES) \ |
| || ((__VALUE__) == LL_RTC_ALMB_MASK_SECONDS) \ |
| || ((__VALUE__) == LL_RTC_ALMB_MASK_ALL)) |
| |
| |
| #define IS_LL_RTC_ALMA_DATE_WEEKDAY_SEL(__SEL__) (((__SEL__) == LL_RTC_ALMA_DATEWEEKDAYSEL_DATE) || \ |
| ((__SEL__) == LL_RTC_ALMA_DATEWEEKDAYSEL_WEEKDAY)) |
| |
| #define IS_LL_RTC_ALMB_DATE_WEEKDAY_SEL(__SEL__) (((__SEL__) == LL_RTC_ALMB_DATEWEEKDAYSEL_DATE) || \ |
| ((__SEL__) == LL_RTC_ALMB_DATEWEEKDAYSEL_WEEKDAY)) |
| |
| |
| /** |
| * @} |
| */ |
| /* Private function prototypes -----------------------------------------------*/ |
| /* Exported functions --------------------------------------------------------*/ |
| /** @addtogroup RTC_LL_Exported_Functions |
| * @{ |
| */ |
| |
| /** @addtogroup RTC_LL_EF_Init |
| * @{ |
| */ |
| |
| /** |
| * @brief De-Initializes the RTC registers to their default reset values. |
| * @note This function doesn't reset the RTC Clock source and RTC Backup Data |
| * registers. |
| * @param RTCx RTC Instance |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC registers are de-initialized |
| * - ERROR: RTC registers are not de-initialized |
| */ |
| ErrorStatus LL_RTC_DeInit(RTC_TypeDef *RTCx) |
| { |
| ErrorStatus status = ERROR; |
| |
| /* Check the parameter */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Set Initialization mode */ |
| if (LL_RTC_EnterInitMode(RTCx) != ERROR) |
| { |
| /* Reset TR, DR and CR registers */ |
| LL_RTC_WriteReg(RTCx, TR, 0x00000000U); |
| #if defined(RTC_WAKEUP_SUPPORT) |
| LL_RTC_WriteReg(RTCx, WUTR, RTC_WUTR_WUT); |
| #endif /* RTC_WAKEUP_SUPPORT */ |
| LL_RTC_WriteReg(RTCx, DR , (RTC_DR_WDU_0 | RTC_DR_MU_0 | RTC_DR_DU_0)); |
| /* Reset All CR bits except CR[2:0] */ |
| #if defined(RTC_WAKEUP_SUPPORT) |
| LL_RTC_WriteReg(RTCx, CR, (LL_RTC_ReadReg(RTCx, CR) & RTC_CR_WUCKSEL)); |
| #else |
| LL_RTC_WriteReg(RTCx, CR, 0x00000000U); |
| #endif /* RTC_WAKEUP_SUPPORT */ |
| LL_RTC_WriteReg(RTCx, PRER, (RTC_PRER_PREDIV_A | RTC_SYNCH_PRESC_DEFAULT)); |
| LL_RTC_WriteReg(RTCx, ALRMAR, 0x00000000U); |
| LL_RTC_WriteReg(RTCx, ALRMBR, 0x00000000U); |
| |
| /* Reset ISR register and exit initialization mode */ |
| LL_RTC_WriteReg(RTCx, ISR, 0x00000000U); |
| |
| /* Reset Tamper and alternate functions configuration register */ |
| LL_RTC_WriteReg(RTCx, TAFCR, 0x00000000U); |
| |
| /* Wait till the RTC RSF flag is set */ |
| status = LL_RTC_WaitForSynchro(RTCx); |
| } |
| |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return status; |
| } |
| |
| /** |
| * @brief Initializes the RTC registers according to the specified parameters |
| * in RTC_InitStruct. |
| * @param RTCx RTC Instance |
| * @param RTC_InitStruct pointer to a @ref LL_RTC_InitTypeDef structure that contains |
| * the configuration information for the RTC peripheral. |
| * @note The RTC Prescaler register is write protected and can be written in |
| * initialization mode only. |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC registers are initialized |
| * - ERROR: RTC registers are not initialized |
| */ |
| ErrorStatus LL_RTC_Init(RTC_TypeDef *RTCx, LL_RTC_InitTypeDef *RTC_InitStruct) |
| { |
| ErrorStatus status = ERROR; |
| |
| /* Check the parameters */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| assert_param(IS_LL_RTC_HOURFORMAT(RTC_InitStruct->HourFormat)); |
| assert_param(IS_LL_RTC_ASYNCH_PREDIV(RTC_InitStruct->AsynchPrescaler)); |
| assert_param(IS_LL_RTC_SYNCH_PREDIV(RTC_InitStruct->SynchPrescaler)); |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Set Initialization mode */ |
| if (LL_RTC_EnterInitMode(RTCx) != ERROR) |
| { |
| /* Set Hour Format */ |
| LL_RTC_SetHourFormat(RTCx, RTC_InitStruct->HourFormat); |
| |
| /* Configure Synchronous and Asynchronous prescaler factor */ |
| LL_RTC_SetSynchPrescaler(RTCx, RTC_InitStruct->SynchPrescaler); |
| LL_RTC_SetAsynchPrescaler(RTCx, RTC_InitStruct->AsynchPrescaler); |
| |
| /* Exit Initialization mode */ |
| LL_RTC_DisableInitMode(RTCx); |
| |
| status = SUCCESS; |
| } |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return status; |
| } |
| |
| /** |
| * @brief Set each @ref LL_RTC_InitTypeDef field to default value. |
| * @param RTC_InitStruct pointer to a @ref LL_RTC_InitTypeDef structure which will be initialized. |
| * @retval None |
| */ |
| void LL_RTC_StructInit(LL_RTC_InitTypeDef *RTC_InitStruct) |
| { |
| /* Set RTC_InitStruct fields to default values */ |
| RTC_InitStruct->HourFormat = LL_RTC_HOURFORMAT_24HOUR; |
| RTC_InitStruct->AsynchPrescaler = RTC_ASYNCH_PRESC_DEFAULT; |
| RTC_InitStruct->SynchPrescaler = RTC_SYNCH_PRESC_DEFAULT; |
| } |
| |
| /** |
| * @brief Set the RTC current time. |
| * @param RTCx RTC Instance |
| * @param RTC_Format This parameter can be one of the following values: |
| * @arg @ref LL_RTC_FORMAT_BIN |
| * @arg @ref LL_RTC_FORMAT_BCD |
| * @param RTC_TimeStruct pointer to a RTC_TimeTypeDef structure that contains |
| * the time configuration information for the RTC. |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC Time register is configured |
| * - ERROR: RTC Time register is not configured |
| */ |
| ErrorStatus LL_RTC_TIME_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_TimeTypeDef *RTC_TimeStruct) |
| { |
| ErrorStatus status = ERROR; |
| |
| /* Check the parameters */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| assert_param(IS_LL_RTC_FORMAT(RTC_Format)); |
| |
| if (RTC_Format == LL_RTC_FORMAT_BIN) |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(RTC_TimeStruct->Hours)); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_TimeStruct->TimeFormat)); |
| } |
| else |
| { |
| RTC_TimeStruct->TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(RTC_TimeStruct->Hours)); |
| } |
| assert_param(IS_LL_RTC_MINUTES(RTC_TimeStruct->Minutes)); |
| assert_param(IS_LL_RTC_SECONDS(RTC_TimeStruct->Seconds)); |
| } |
| else |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(__LL_RTC_CONVERT_BCD2BIN(RTC_TimeStruct->Hours))); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_TimeStruct->TimeFormat)); |
| } |
| else |
| { |
| RTC_TimeStruct->TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(__LL_RTC_CONVERT_BCD2BIN(RTC_TimeStruct->Hours))); |
| } |
| assert_param(IS_LL_RTC_MINUTES(__LL_RTC_CONVERT_BCD2BIN(RTC_TimeStruct->Minutes))); |
| assert_param(IS_LL_RTC_SECONDS(__LL_RTC_CONVERT_BCD2BIN(RTC_TimeStruct->Seconds))); |
| } |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Set Initialization mode */ |
| if (LL_RTC_EnterInitMode(RTCx) != ERROR) |
| { |
| /* Check the input parameters format */ |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_TIME_Config(RTCx, RTC_TimeStruct->TimeFormat, RTC_TimeStruct->Hours, |
| RTC_TimeStruct->Minutes, RTC_TimeStruct->Seconds); |
| } |
| else |
| { |
| LL_RTC_TIME_Config(RTCx, RTC_TimeStruct->TimeFormat, __LL_RTC_CONVERT_BIN2BCD(RTC_TimeStruct->Hours), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_TimeStruct->Minutes), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_TimeStruct->Seconds)); |
| } |
| |
| /* Exit Initialization mode */ |
| LL_RTC_DisableInitMode(RTC); |
| |
| status = SUCCESS; |
| } |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return status; |
| } |
| |
| /** |
| * @brief Set each @ref LL_RTC_TimeTypeDef field to default value (Time = 00h:00min:00sec). |
| * @param RTC_TimeStruct pointer to a @ref LL_RTC_TimeTypeDef structure which will be initialized. |
| * @retval None |
| */ |
| void LL_RTC_TIME_StructInit(LL_RTC_TimeTypeDef *RTC_TimeStruct) |
| { |
| /* Time = 00h:00min:00sec */ |
| RTC_TimeStruct->TimeFormat = LL_RTC_TIME_FORMAT_AM_OR_24; |
| RTC_TimeStruct->Hours = 0U; |
| RTC_TimeStruct->Minutes = 0U; |
| RTC_TimeStruct->Seconds = 0U; |
| } |
| |
| /** |
| * @brief Set the RTC current date. |
| * @param RTCx RTC Instance |
| * @param RTC_Format This parameter can be one of the following values: |
| * @arg @ref LL_RTC_FORMAT_BIN |
| * @arg @ref LL_RTC_FORMAT_BCD |
| * @param RTC_DateStruct pointer to a RTC_DateTypeDef structure that contains |
| * the date configuration information for the RTC. |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC Day register is configured |
| * - ERROR: RTC Day register is not configured |
| */ |
| ErrorStatus LL_RTC_DATE_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_DateTypeDef *RTC_DateStruct) |
| { |
| ErrorStatus status = ERROR; |
| |
| /* Check the parameters */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| assert_param(IS_LL_RTC_FORMAT(RTC_Format)); |
| |
| if ((RTC_Format == LL_RTC_FORMAT_BIN) && ((RTC_DateStruct->Month & 0x10U) == 0x10U)) |
| { |
| RTC_DateStruct->Month = (RTC_DateStruct->Month & (uint32_t)~(0x10U)) + 0x0AU; |
| } |
| if (RTC_Format == LL_RTC_FORMAT_BIN) |
| { |
| assert_param(IS_LL_RTC_YEAR(RTC_DateStruct->Year)); |
| assert_param(IS_LL_RTC_MONTH(RTC_DateStruct->Month)); |
| assert_param(IS_LL_RTC_DAY(RTC_DateStruct->Day)); |
| } |
| else |
| { |
| assert_param(IS_LL_RTC_YEAR(__LL_RTC_CONVERT_BCD2BIN(RTC_DateStruct->Year))); |
| assert_param(IS_LL_RTC_MONTH(__LL_RTC_CONVERT_BCD2BIN(RTC_DateStruct->Month))); |
| assert_param(IS_LL_RTC_DAY(__LL_RTC_CONVERT_BCD2BIN(RTC_DateStruct->Day))); |
| } |
| assert_param(IS_LL_RTC_WEEKDAY(RTC_DateStruct->WeekDay)); |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Set Initialization mode */ |
| if (LL_RTC_EnterInitMode(RTCx) != ERROR) |
| { |
| /* Check the input parameters format */ |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_DATE_Config(RTCx, RTC_DateStruct->WeekDay, RTC_DateStruct->Day, RTC_DateStruct->Month, RTC_DateStruct->Year); |
| } |
| else |
| { |
| LL_RTC_DATE_Config(RTCx, RTC_DateStruct->WeekDay, __LL_RTC_CONVERT_BIN2BCD(RTC_DateStruct->Day), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_DateStruct->Month), __LL_RTC_CONVERT_BIN2BCD(RTC_DateStruct->Year)); |
| } |
| |
| /* Exit Initialization mode */ |
| LL_RTC_DisableInitMode(RTC); |
| |
| status = SUCCESS; |
| } |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return status; |
| } |
| |
| /** |
| * @brief Set each @ref LL_RTC_DateTypeDef field to default value (date = Monday, January 01 xx00) |
| * @param RTC_DateStruct pointer to a @ref LL_RTC_DateTypeDef structure which will be initialized. |
| * @retval None |
| */ |
| void LL_RTC_DATE_StructInit(LL_RTC_DateTypeDef *RTC_DateStruct) |
| { |
| /* Monday, January 01 xx00 */ |
| RTC_DateStruct->WeekDay = LL_RTC_WEEKDAY_MONDAY; |
| RTC_DateStruct->Day = 1U; |
| RTC_DateStruct->Month = LL_RTC_MONTH_JANUARY; |
| RTC_DateStruct->Year = 0U; |
| } |
| |
| /** |
| * @brief Set the RTC Alarm A. |
| * @note The Alarm register can only be written when the corresponding Alarm |
| * is disabled (Use @ref LL_RTC_ALMA_Disable function). |
| * @param RTCx RTC Instance |
| * @param RTC_Format This parameter can be one of the following values: |
| * @arg @ref LL_RTC_FORMAT_BIN |
| * @arg @ref LL_RTC_FORMAT_BCD |
| * @param RTC_AlarmStruct pointer to a @ref LL_RTC_AlarmTypeDef structure that |
| * contains the alarm configuration parameters. |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: ALARMA registers are configured |
| * - ERROR: ALARMA registers are not configured |
| */ |
| ErrorStatus LL_RTC_ALMA_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_AlarmTypeDef *RTC_AlarmStruct) |
| { |
| /* Check the parameters */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| assert_param(IS_LL_RTC_FORMAT(RTC_Format)); |
| assert_param(IS_LL_RTC_ALMA_MASK(RTC_AlarmStruct->AlarmMask)); |
| assert_param(IS_LL_RTC_ALMA_DATE_WEEKDAY_SEL(RTC_AlarmStruct->AlarmDateWeekDaySel)); |
| |
| if (RTC_Format == LL_RTC_FORMAT_BIN) |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(RTC_AlarmStruct->AlarmTime.Hours)); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_AlarmStruct->AlarmTime.TimeFormat)); |
| } |
| else |
| { |
| RTC_AlarmStruct->AlarmTime.TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(RTC_AlarmStruct->AlarmTime.Hours)); |
| } |
| assert_param(IS_LL_RTC_MINUTES(RTC_AlarmStruct->AlarmTime.Minutes)); |
| assert_param(IS_LL_RTC_SECONDS(RTC_AlarmStruct->AlarmTime.Seconds)); |
| |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMA_DATEWEEKDAYSEL_DATE) |
| { |
| assert_param(IS_LL_RTC_DAY(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| else |
| { |
| assert_param(IS_LL_RTC_WEEKDAY(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| } |
| else |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Hours))); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_AlarmStruct->AlarmTime.TimeFormat)); |
| } |
| else |
| { |
| RTC_AlarmStruct->AlarmTime.TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Hours))); |
| } |
| |
| assert_param(IS_LL_RTC_MINUTES(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Minutes))); |
| assert_param(IS_LL_RTC_SECONDS(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Seconds))); |
| |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMA_DATEWEEKDAYSEL_DATE) |
| { |
| assert_param(IS_LL_RTC_DAY(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmDateWeekDay))); |
| } |
| else |
| { |
| assert_param(IS_LL_RTC_WEEKDAY(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmDateWeekDay))); |
| } |
| } |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Select weekday selection */ |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMA_DATEWEEKDAYSEL_DATE) |
| { |
| /* Set the date for ALARM */ |
| LL_RTC_ALMA_DisableWeekday(RTCx); |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_ALMA_SetDay(RTCx, RTC_AlarmStruct->AlarmDateWeekDay); |
| } |
| else |
| { |
| LL_RTC_ALMA_SetDay(RTCx, __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| } |
| else |
| { |
| /* Set the week day for ALARM */ |
| LL_RTC_ALMA_EnableWeekday(RTCx); |
| LL_RTC_ALMA_SetWeekDay(RTCx, RTC_AlarmStruct->AlarmDateWeekDay); |
| } |
| |
| /* Configure the Alarm register */ |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_ALMA_ConfigTime(RTCx, RTC_AlarmStruct->AlarmTime.TimeFormat, RTC_AlarmStruct->AlarmTime.Hours, |
| RTC_AlarmStruct->AlarmTime.Minutes, RTC_AlarmStruct->AlarmTime.Seconds); |
| } |
| else |
| { |
| LL_RTC_ALMA_ConfigTime(RTCx, RTC_AlarmStruct->AlarmTime.TimeFormat, |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Hours), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Minutes), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Seconds)); |
| } |
| /* Set ALARM mask */ |
| LL_RTC_ALMA_SetMask(RTCx, RTC_AlarmStruct->AlarmMask); |
| |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return SUCCESS; |
| } |
| |
| /** |
| * @brief Set the RTC Alarm B. |
| * @note The Alarm register can only be written when the corresponding Alarm |
| * is disabled (@ref LL_RTC_ALMB_Disable function). |
| * @param RTCx RTC Instance |
| * @param RTC_Format This parameter can be one of the following values: |
| * @arg @ref LL_RTC_FORMAT_BIN |
| * @arg @ref LL_RTC_FORMAT_BCD |
| * @param RTC_AlarmStruct pointer to a @ref LL_RTC_AlarmTypeDef structure that |
| * contains the alarm configuration parameters. |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: ALARMB registers are configured |
| * - ERROR: ALARMB registers are not configured |
| */ |
| ErrorStatus LL_RTC_ALMB_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_AlarmTypeDef *RTC_AlarmStruct) |
| { |
| /* Check the parameters */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| assert_param(IS_LL_RTC_FORMAT(RTC_Format)); |
| assert_param(IS_LL_RTC_ALMB_MASK(RTC_AlarmStruct->AlarmMask)); |
| assert_param(IS_LL_RTC_ALMB_DATE_WEEKDAY_SEL(RTC_AlarmStruct->AlarmDateWeekDaySel)); |
| |
| if (RTC_Format == LL_RTC_FORMAT_BIN) |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(RTC_AlarmStruct->AlarmTime.Hours)); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_AlarmStruct->AlarmTime.TimeFormat)); |
| } |
| else |
| { |
| RTC_AlarmStruct->AlarmTime.TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(RTC_AlarmStruct->AlarmTime.Hours)); |
| } |
| assert_param(IS_LL_RTC_MINUTES(RTC_AlarmStruct->AlarmTime.Minutes)); |
| assert_param(IS_LL_RTC_SECONDS(RTC_AlarmStruct->AlarmTime.Seconds)); |
| |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMB_DATEWEEKDAYSEL_DATE) |
| { |
| assert_param(IS_LL_RTC_DAY(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| else |
| { |
| assert_param(IS_LL_RTC_WEEKDAY(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| } |
| else |
| { |
| if (LL_RTC_GetHourFormat(RTCx) != LL_RTC_HOURFORMAT_24HOUR) |
| { |
| assert_param(IS_LL_RTC_HOUR12(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Hours))); |
| assert_param(IS_LL_RTC_TIME_FORMAT(RTC_AlarmStruct->AlarmTime.TimeFormat)); |
| } |
| else |
| { |
| RTC_AlarmStruct->AlarmTime.TimeFormat = 0x00U; |
| assert_param(IS_LL_RTC_HOUR24(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Hours))); |
| } |
| |
| assert_param(IS_LL_RTC_MINUTES(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Minutes))); |
| assert_param(IS_LL_RTC_SECONDS(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmTime.Seconds))); |
| |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMB_DATEWEEKDAYSEL_DATE) |
| { |
| assert_param(IS_LL_RTC_DAY(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmDateWeekDay))); |
| } |
| else |
| { |
| assert_param(IS_LL_RTC_WEEKDAY(__LL_RTC_CONVERT_BCD2BIN(RTC_AlarmStruct->AlarmDateWeekDay))); |
| } |
| } |
| |
| /* Disable the write protection for RTC registers */ |
| LL_RTC_DisableWriteProtection(RTCx); |
| |
| /* Select weekday selection */ |
| if (RTC_AlarmStruct->AlarmDateWeekDaySel == LL_RTC_ALMB_DATEWEEKDAYSEL_DATE) |
| { |
| /* Set the date for ALARM */ |
| LL_RTC_ALMB_DisableWeekday(RTCx); |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_ALMB_SetDay(RTCx, RTC_AlarmStruct->AlarmDateWeekDay); |
| } |
| else |
| { |
| LL_RTC_ALMB_SetDay(RTCx, __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmDateWeekDay)); |
| } |
| } |
| else |
| { |
| /* Set the week day for ALARM */ |
| LL_RTC_ALMB_EnableWeekday(RTCx); |
| LL_RTC_ALMB_SetWeekDay(RTCx, RTC_AlarmStruct->AlarmDateWeekDay); |
| } |
| |
| /* Configure the Alarm register */ |
| if (RTC_Format != LL_RTC_FORMAT_BIN) |
| { |
| LL_RTC_ALMB_ConfigTime(RTCx, RTC_AlarmStruct->AlarmTime.TimeFormat, RTC_AlarmStruct->AlarmTime.Hours, |
| RTC_AlarmStruct->AlarmTime.Minutes, RTC_AlarmStruct->AlarmTime.Seconds); |
| } |
| else |
| { |
| LL_RTC_ALMB_ConfigTime(RTCx, RTC_AlarmStruct->AlarmTime.TimeFormat, |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Hours), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Minutes), |
| __LL_RTC_CONVERT_BIN2BCD(RTC_AlarmStruct->AlarmTime.Seconds)); |
| } |
| /* Set ALARM mask */ |
| LL_RTC_ALMB_SetMask(RTCx, RTC_AlarmStruct->AlarmMask); |
| |
| /* Enable the write protection for RTC registers */ |
| LL_RTC_EnableWriteProtection(RTCx); |
| |
| return SUCCESS; |
| } |
| |
| /** |
| * @brief Set each @ref LL_RTC_AlarmTypeDef of ALARMA field to default value (Time = 00h:00mn:00sec / |
| * Day = 1st day of the month/Mask = all fields are masked). |
| * @param RTC_AlarmStruct pointer to a @ref LL_RTC_AlarmTypeDef structure which will be initialized. |
| * @retval None |
| */ |
| void LL_RTC_ALMA_StructInit(LL_RTC_AlarmTypeDef *RTC_AlarmStruct) |
| { |
| /* Alarm Time Settings : Time = 00h:00mn:00sec */ |
| RTC_AlarmStruct->AlarmTime.TimeFormat = LL_RTC_ALMA_TIME_FORMAT_AM; |
| RTC_AlarmStruct->AlarmTime.Hours = 0U; |
| RTC_AlarmStruct->AlarmTime.Minutes = 0U; |
| RTC_AlarmStruct->AlarmTime.Seconds = 0U; |
| |
| /* Alarm Day Settings : Day = 1st day of the month */ |
| RTC_AlarmStruct->AlarmDateWeekDaySel = LL_RTC_ALMA_DATEWEEKDAYSEL_DATE; |
| RTC_AlarmStruct->AlarmDateWeekDay = 1U; |
| |
| /* Alarm Masks Settings : Mask = all fields are not masked */ |
| RTC_AlarmStruct->AlarmMask = LL_RTC_ALMA_MASK_NONE; |
| } |
| |
| /** |
| * @brief Set each @ref LL_RTC_AlarmTypeDef of ALARMA field to default value (Time = 00h:00mn:00sec / |
| * Day = 1st day of the month/Mask = all fields are masked). |
| * @param RTC_AlarmStruct pointer to a @ref LL_RTC_AlarmTypeDef structure which will be initialized. |
| * @retval None |
| */ |
| void LL_RTC_ALMB_StructInit(LL_RTC_AlarmTypeDef *RTC_AlarmStruct) |
| { |
| /* Alarm Time Settings : Time = 00h:00mn:00sec */ |
| RTC_AlarmStruct->AlarmTime.TimeFormat = LL_RTC_ALMB_TIME_FORMAT_AM; |
| RTC_AlarmStruct->AlarmTime.Hours = 0U; |
| RTC_AlarmStruct->AlarmTime.Minutes = 0U; |
| RTC_AlarmStruct->AlarmTime.Seconds = 0U; |
| |
| /* Alarm Day Settings : Day = 1st day of the month */ |
| RTC_AlarmStruct->AlarmDateWeekDaySel = LL_RTC_ALMB_DATEWEEKDAYSEL_DATE; |
| RTC_AlarmStruct->AlarmDateWeekDay = 1U; |
| |
| /* Alarm Masks Settings : Mask = all fields are not masked */ |
| RTC_AlarmStruct->AlarmMask = LL_RTC_ALMB_MASK_NONE; |
| } |
| |
| /** |
| * @brief Enters the RTC Initialization mode. |
| * @note The RTC Initialization mode is write protected, use the |
| * @ref LL_RTC_DisableWriteProtection before calling this function. |
| * @param RTCx RTC Instance |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC is in Init mode |
| * - ERROR: RTC is not in Init mode |
| */ |
| ErrorStatus LL_RTC_EnterInitMode(RTC_TypeDef *RTCx) |
| { |
| __IO uint32_t timeout = RTC_INITMODE_TIMEOUT; |
| ErrorStatus status = SUCCESS; |
| uint32_t tmp = 0U; |
| |
| /* Check the parameter */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| |
| /* Check if the Initialization mode is set */ |
| if (LL_RTC_IsActiveFlag_INIT(RTCx) == 0U) |
| { |
| /* Set the Initialization mode */ |
| LL_RTC_EnableInitMode(RTCx); |
| |
| /* Wait till RTC is in INIT state and if Time out is reached exit */ |
| tmp = LL_RTC_IsActiveFlag_INIT(RTCx); |
| while ((timeout != 0U) && (tmp != 1U)) |
| { |
| if (LL_SYSTICK_IsActiveCounterFlag() == 1U) |
| { |
| timeout --; |
| } |
| tmp = LL_RTC_IsActiveFlag_INIT(RTCx); |
| if (timeout == 0U) |
| { |
| status = ERROR; |
| } |
| } |
| } |
| return status; |
| } |
| |
| /** |
| * @brief Exit the RTC Initialization mode. |
| * @note When the initialization sequence is complete, the calendar restarts |
| * counting after 4 RTCCLK cycles. |
| * @note The RTC Initialization mode is write protected, use the |
| * @ref LL_RTC_DisableWriteProtection before calling this function. |
| * @param RTCx RTC Instance |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC exited from in Init mode |
| * - ERROR: Not applicable |
| */ |
| ErrorStatus LL_RTC_ExitInitMode(RTC_TypeDef *RTCx) |
| { |
| /* Check the parameter */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| |
| /* Disable initialization mode */ |
| LL_RTC_DisableInitMode(RTCx); |
| |
| return SUCCESS; |
| } |
| |
| /** |
| * @brief Waits until the RTC Time and Day registers (RTC_TR and RTC_DR) are |
| * synchronized with RTC APB clock. |
| * @note The RTC Resynchronization mode is write protected, use the |
| * @ref LL_RTC_DisableWriteProtection before calling this function. |
| * @note To read the calendar through the shadow registers after Calendar |
| * initialization, calendar update or after wakeup from low power modes |
| * the software must first clear the RSF flag. |
| * The software must then wait until it is set again before reading |
| * the calendar, which means that the calendar registers have been |
| * correctly copied into the RTC_TR and RTC_DR shadow registers. |
| * @param RTCx RTC Instance |
| * @retval An ErrorStatus enumeration value: |
| * - SUCCESS: RTC registers are synchronised |
| * - ERROR: RTC registers are not synchronised |
| */ |
| ErrorStatus LL_RTC_WaitForSynchro(RTC_TypeDef *RTCx) |
| { |
| __IO uint32_t timeout = RTC_SYNCHRO_TIMEOUT; |
| ErrorStatus status = SUCCESS; |
| uint32_t tmp = 0U; |
| |
| /* Check the parameter */ |
| assert_param(IS_RTC_ALL_INSTANCE(RTCx)); |
| |
| /* Clear RSF flag */ |
| LL_RTC_ClearFlag_RS(RTCx); |
| |
| /* Wait the registers to be synchronised */ |
| tmp = LL_RTC_IsActiveFlag_RS(RTCx); |
| while ((timeout != 0U) && (tmp != 0U)) |
| { |
| if (LL_SYSTICK_IsActiveCounterFlag() == 1U) |
| { |
| timeout--; |
| } |
| tmp = LL_RTC_IsActiveFlag_RS(RTCx); |
| if (timeout == 0U) |
| { |
| status = ERROR; |
| } |
| } |
| |
| if (status != ERROR) |
| { |
| timeout = RTC_SYNCHRO_TIMEOUT; |
| tmp = LL_RTC_IsActiveFlag_RS(RTCx); |
| while ((timeout != 0U) && (tmp != 1U)) |
| { |
| if (LL_SYSTICK_IsActiveCounterFlag() == 1U) |
| { |
| timeout--; |
| } |
| tmp = LL_RTC_IsActiveFlag_RS(RTCx); |
| if (timeout == 0U) |
| { |
| status = ERROR; |
| } |
| } |
| } |
| |
| return (status); |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* defined(RTC) */ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* USE_FULL_LL_DRIVER */ |
| |
| /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |