/**
|
******************************************************************************
|
* @file stm32f1xx_ll_rtc.h
|
* @author MCD Application Team
|
* @brief Header file of RTC LL module.
|
******************************************************************************
|
* @attention
|
*
|
* <h2><center>© Copyright (c) 2016 STMicroelectronics.
|
* All rights reserved.</center></h2>
|
*
|
* This software component is licensed by ST under BSD 3-Clause license,
|
* the "License"; You may not use this file except in compliance with the
|
* License. You may obtain a copy of the License at:
|
* opensource.org/licenses/BSD-3-Clause
|
*
|
******************************************************************************
|
*/
|
|
/* Define to prevent recursive inclusion -------------------------------------*/
|
#ifndef __STM32F1xx_LL_RTC_H
|
#define __STM32F1xx_LL_RTC_H
|
|
#ifdef __cplusplus
|
extern "C" {
|
#endif
|
|
/* Includes ------------------------------------------------------------------*/
|
#include "stm32f1xx.h"
|
|
/** @addtogroup STM32F1xx_LL_Driver
|
* @{
|
*/
|
|
#if defined(RTC)
|
|
/** @defgroup RTC_LL RTC
|
* @{
|
*/
|
|
/* Private types -------------------------------------------------------------*/
|
/* Private variables ---------------------------------------------------------*/
|
/* Private constants ---------------------------------------------------------*/
|
|
/* Private macros ------------------------------------------------------------*/
|
#if defined(USE_FULL_LL_DRIVER)
|
/** @defgroup RTC_LL_Private_Macros RTC Private Macros
|
* @{
|
*/
|
/**
|
* @}
|
*/
|
#endif /*USE_FULL_LL_DRIVER*/
|
|
/* Exported types ------------------------------------------------------------*/
|
#if defined(USE_FULL_LL_DRIVER)
|
/** @defgroup RTC_LL_ES_INIT RTC Exported Init structure
|
* @{
|
*/
|
|
/**
|
* @brief RTC Init structures definition
|
*/
|
typedef struct
|
{
|
uint32_t AsynchPrescaler; /*!< Specifies the RTC Asynchronous Predivider value.
|
This parameter must be a number between Min_Data = 0x00 and Max_Data = 0xFFFFF
|
|
This feature can be modified afterwards using unitary function
|
@ref LL_RTC_SetAsynchPrescaler(). */
|
|
uint32_t OutPutSource; /*!< Specifies which signal will be routed to the RTC Tamper pin.
|
This parameter can be a value of @ref LL_RTC_Output_Source
|
|
This feature can be modified afterwards using unitary function
|
@ref LL_RTC_SetOutputSource(). */
|
|
} LL_RTC_InitTypeDef;
|
|
/**
|
* @brief RTC Time structure definition
|
*/
|
typedef struct
|
{
|
uint8_t Hours; /*!< Specifies the RTC Time Hours.
|
This parameter must be a number between Min_Data = 0 and Max_Data = 23 */
|
|
uint8_t Minutes; /*!< Specifies the RTC Time Minutes.
|
This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
|
|
uint8_t Seconds; /*!< Specifies the RTC Time Seconds.
|
This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
|
} LL_RTC_TimeTypeDef;
|
|
|
/**
|
* @brief RTC Alarm structure definition
|
*/
|
typedef struct
|
{
|
LL_RTC_TimeTypeDef AlarmTime; /*!< Specifies the RTC Alarm Time members. */
|
|
} LL_RTC_AlarmTypeDef;
|
|
/**
|
* @}
|
*/
|
#endif /* USE_FULL_LL_DRIVER */
|
|
/* Exported constants --------------------------------------------------------*/
|
/** @defgroup RTC_LL_Exported_Constants RTC Exported Constants
|
* @{
|
*/
|
|
#if defined(USE_FULL_LL_DRIVER)
|
/** @defgroup RTC_LL_EC_FORMAT FORMAT
|
* @{
|
*/
|
#define LL_RTC_FORMAT_BIN (0x000000000U) /*!< Binary data format */
|
#define LL_RTC_FORMAT_BCD (0x000000001U) /*!< BCD data format */
|
/**
|
* @}
|
*/
|
#endif /* USE_FULL_LL_DRIVER */
|
|
/** @defgroup RTC_LL_EC_BKP BACKUP
|
* @{
|
*/
|
#if RTC_BKP_NUMBER > 0
|
#define LL_RTC_BKP_DR1 (0x00000001U)
|
#define LL_RTC_BKP_DR2 (0x00000002U)
|
#define LL_RTC_BKP_DR3 (0x00000003U)
|
#define LL_RTC_BKP_DR4 (0x00000004U)
|
#define LL_RTC_BKP_DR5 (0x00000005U)
|
#define LL_RTC_BKP_DR6 (0x00000006U)
|
#define LL_RTC_BKP_DR7 (0x00000007U)
|
#define LL_RTC_BKP_DR8 (0x00000008U)
|
#define LL_RTC_BKP_DR9 (0x00000009U)
|
#define LL_RTC_BKP_DR10 (0x0000000AU)
|
#endif /* RTC_BKP_NUMBER > 0 */
|
#if RTC_BKP_NUMBER > 10
|
#define LL_RTC_BKP_DR11 (0x0000000BU)
|
#define LL_RTC_BKP_DR12 (0x0000000CU)
|
#define LL_RTC_BKP_DR13 (0x0000000DU)
|
#define LL_RTC_BKP_DR14 (0x0000000EU)
|
#define LL_RTC_BKP_DR15 (0x0000000FU)
|
#define LL_RTC_BKP_DR16 (0x00000010U)
|
#define LL_RTC_BKP_DR17 (0x00000011U)
|
#define LL_RTC_BKP_DR18 (0x00000012U)
|
#define LL_RTC_BKP_DR19 (0x00000013U)
|
#define LL_RTC_BKP_DR20 (0x00000014U)
|
#define LL_RTC_BKP_DR21 (0x00000015U)
|
#define LL_RTC_BKP_DR22 (0x00000016U)
|
#define LL_RTC_BKP_DR23 (0x00000017U)
|
#define LL_RTC_BKP_DR24 (0x00000018U)
|
#define LL_RTC_BKP_DR25 (0x00000019U)
|
#define LL_RTC_BKP_DR26 (0x0000001AU)
|
#define LL_RTC_BKP_DR27 (0x0000001BU)
|
#define LL_RTC_BKP_DR28 (0x0000001CU)
|
#define LL_RTC_BKP_DR29 (0x0000001DU)
|
#define LL_RTC_BKP_DR30 (0x0000001EU)
|
#define LL_RTC_BKP_DR31 (0x0000001FU)
|
#define LL_RTC_BKP_DR32 (0x00000020U)
|
#define LL_RTC_BKP_DR33 (0x00000021U)
|
#define LL_RTC_BKP_DR34 (0x00000022U)
|
#define LL_RTC_BKP_DR35 (0x00000023U)
|
#define LL_RTC_BKP_DR36 (0x00000024U)
|
#define LL_RTC_BKP_DR37 (0x00000025U)
|
#define LL_RTC_BKP_DR38 (0x00000026U)
|
#define LL_RTC_BKP_DR39 (0x00000027U)
|
#define LL_RTC_BKP_DR40 (0x00000028U)
|
#define LL_RTC_BKP_DR41 (0x00000029U)
|
#define LL_RTC_BKP_DR42 (0x0000002AU)
|
#endif /* RTC_BKP_NUMBER > 10 */
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EC_TAMPLEVEL Tamper Active Level
|
* @{
|
*/
|
#define LL_RTC_TAMPER_ACTIVELEVEL_LOW BKP_CR_TPAL /*!< A high level on the TAMPER pin resets all data backup registers (if TPE bit is set) */
|
#define LL_RTC_TAMPER_ACTIVELEVEL_HIGH (0x00000000U) /*!< A low level on the TAMPER pin resets all data backup registers (if TPE bit is set) */
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup LL_RTC_Output_Source Clock Source to output on the Tamper Pin
|
* @{
|
*/
|
#define LL_RTC_CALIB_OUTPUT_NONE (0x00000000U) /*!< Calibration output disabled */
|
#define LL_RTC_CALIB_OUTPUT_RTCCLOCK BKP_RTCCR_CCO /*!< Calibration output is RTC Clock with a frequency divided by 64 on the TAMPER Pin */
|
#define LL_RTC_CALIB_OUTPUT_ALARM BKP_RTCCR_ASOE /*!< Calibration output is Alarm pulse signal on the TAMPER pin */
|
#define LL_RTC_CALIB_OUTPUT_SECOND (BKP_RTCCR_ASOS | BKP_RTCCR_ASOE) /*!< Calibration output is Second pulse signal on the TAMPER pin*/
|
/**
|
* @}
|
*/
|
|
/**
|
* @}
|
*/
|
|
/* Exported macro ------------------------------------------------------------*/
|
/** @defgroup RTC_LL_Exported_Macros RTC Exported Macros
|
* @{
|
*/
|
|
/** @defgroup RTC_LL_EM_WRITE_READ Common Write and read registers Macros
|
* @{
|
*/
|
|
/**
|
* @brief Write a value in RTC register
|
* @param __INSTANCE__ RTC Instance
|
* @param __REG__ Register to be written
|
* @param __VALUE__ Value to be written in the register
|
* @retval None
|
*/
|
#define LL_RTC_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
|
|
/**
|
* @brief Read a value in RTC register
|
* @param __INSTANCE__ RTC Instance
|
* @param __REG__ Register to be read
|
* @retval Register value
|
*/
|
#define LL_RTC_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EM_Convert Convert helper Macros
|
* @{
|
*/
|
|
/**
|
* @brief Helper macro to convert a value from 2 digit decimal format to BCD format
|
* @param __VALUE__ Byte to be converted
|
* @retval Converted byte
|
*/
|
#define __LL_RTC_CONVERT_BIN2BCD(__VALUE__) (uint8_t)((((__VALUE__) / 10U) << 4U) | ((__VALUE__) % 10U))
|
|
/**
|
* @brief Helper macro to convert a value from BCD format to 2 digit decimal format
|
* @param __VALUE__ BCD value to be converted
|
* @retval Converted byte
|
*/
|
#define __LL_RTC_CONVERT_BCD2BIN(__VALUE__) (uint8_t)(((uint8_t)((__VALUE__) & (uint8_t)0xF0U) >> (uint8_t)0x4U) * 10U + ((__VALUE__) & (uint8_t)0x0FU))
|
|
/**
|
* @}
|
*/
|
|
/**
|
* @}
|
*/
|
|
/* Exported functions --------------------------------------------------------*/
|
/** @defgroup RTC_LL_Exported_Functions RTC Exported Functions
|
* @{
|
*/
|
|
/** @defgroup RTC_LL_EF_Configuration Configuration
|
* @{
|
*/
|
|
/**
|
* @brief Set Asynchronous prescaler factor
|
* @rmtoll PRLH PRL LL_RTC_SetAsynchPrescaler\n
|
* @rmtoll PRLL PRL LL_RTC_SetAsynchPrescaler\n
|
* @param RTCx RTC Instance
|
* @param AsynchPrescaler Value between Min_Data = 0 and Max_Data = 0xFFFFF
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_SetAsynchPrescaler(RTC_TypeDef *RTCx, uint32_t AsynchPrescaler)
|
{
|
MODIFY_REG(RTCx->PRLH, RTC_PRLH_PRL, (AsynchPrescaler >> 16));
|
MODIFY_REG(RTCx->PRLL, RTC_PRLL_PRL, (AsynchPrescaler & RTC_PRLL_PRL));
|
}
|
|
/**
|
* @brief Get Asynchronous prescaler factor
|
* @rmtoll DIVH DIV LL_RTC_GetDivider\n
|
* @rmtoll DIVL DIV LL_RTC_GetDivider\n
|
* @param RTCx RTC Instance
|
* @retval Value between Min_Data = 0 and Max_Data = 0xFFFFF
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_GetDivider(RTC_TypeDef *RTCx)
|
{
|
register uint16_t Highprescaler = 0, Lowprescaler = 0;
|
Highprescaler = READ_REG(RTCx->DIVH & RTC_DIVH_RTC_DIV);
|
Lowprescaler = READ_REG(RTCx->DIVL & RTC_DIVL_RTC_DIV);
|
|
return (((uint32_t) Highprescaler << 16U) | Lowprescaler);
|
}
|
|
/**
|
* @brief Set Output Source
|
* @rmtoll RTCCR CCO LL_RTC_SetOutputSource
|
* @rmtoll RTCCR ASOE LL_RTC_SetOutputSource
|
* @rmtoll RTCCR ASOS LL_RTC_SetOutputSource
|
* @param BKPx BKP Instance
|
* @param OutputSource This parameter can be one of the following values:
|
* @arg @ref LL_RTC_CALIB_OUTPUT_NONE
|
* @arg @ref LL_RTC_CALIB_OUTPUT_RTCCLOCK
|
* @arg @ref LL_RTC_CALIB_OUTPUT_ALARM
|
* @arg @ref LL_RTC_CALIB_OUTPUT_SECOND
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_SetOutputSource(BKP_TypeDef *BKPx, uint32_t OutputSource)
|
{
|
MODIFY_REG(BKPx->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE | BKP_RTCCR_ASOS), OutputSource);
|
}
|
|
/**
|
* @brief Get Output Source
|
* @rmtoll RTCCR CCO LL_RTC_GetOutPutSource
|
* @rmtoll RTCCR ASOE LL_RTC_GetOutPutSource
|
* @rmtoll RTCCR ASOS LL_RTC_GetOutPutSource
|
* @param BKPx BKP Instance
|
* @retval Returned value can be one of the following values:
|
* @arg @ref LL_RTC_CALIB_OUTPUT_NONE
|
* @arg @ref LL_RTC_CALIB_OUTPUT_RTCCLOCK
|
* @arg @ref LL_RTC_CALIB_OUTPUT_ALARM
|
* @arg @ref LL_RTC_CALIB_OUTPUT_SECOND
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_GetOutPutSource(BKP_TypeDef *BKPx)
|
{
|
return (uint32_t)(READ_BIT(BKPx->RTCCR, (BKP_RTCCR_CCO | BKP_RTCCR_ASOE | BKP_RTCCR_ASOS)));
|
}
|
|
/**
|
* @brief Enable the write protection for RTC registers.
|
* @rmtoll CRL CNF LL_RTC_EnableWriteProtection
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_EnableWriteProtection(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRL, RTC_CRL_CNF);
|
}
|
|
/**
|
* @brief Disable the write protection for RTC registers.
|
* @rmtoll CRL RTC_CRL_CNF LL_RTC_DisableWriteProtection
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_DisableWriteProtection(RTC_TypeDef *RTCx)
|
{
|
SET_BIT(RTCx->CRL, RTC_CRL_CNF);
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_Time Time
|
* @{
|
*/
|
|
/**
|
* @brief Set time counter in BCD format
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @note It can be written in initialization mode only (@ref LL_RTC_EnterInitMode function)
|
* @rmtoll CNTH CNT LL_RTC_TIME_Set\n
|
* CNTL CNT LL_RTC_TIME_Set\n
|
* @param RTCx RTC Instance
|
* @param TimeCounter Value between Min_Data=0x00 and Max_Data=0xFFFFF
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_TIME_Set(RTC_TypeDef *RTCx, uint32_t TimeCounter)
|
{
|
/* Set RTC COUNTER MSB word */
|
WRITE_REG(RTCx->CNTH, (TimeCounter >> 16U));
|
/* Set RTC COUNTER LSB word */
|
WRITE_REG(RTCx->CNTL, (TimeCounter & RTC_CNTL_RTC_CNT));
|
}
|
|
/**
|
* @brief Get time counter in BCD format
|
* @rmtoll CNTH CNT LL_RTC_TIME_Get\n
|
* CNTL CNT LL_RTC_TIME_Get\n
|
* @param RTCx RTC Instance
|
* @retval Value between Min_Data = 0 and Max_Data = 0xFFFFF
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_TIME_Get(RTC_TypeDef *RTCx)
|
{
|
register uint16_t high = 0, low = 0;
|
|
high = READ_REG(RTCx->CNTH & RTC_CNTH_RTC_CNT);
|
low = READ_REG(RTCx->CNTL & RTC_CNTL_RTC_CNT);
|
return ((uint32_t)(((uint32_t) high << 16U) | low));
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_ALARM ALARM
|
* @{
|
*/
|
|
/**
|
* @brief Set Alarm Counter
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll ALRH ALR LL_RTC_ALARM_Set\n
|
* @rmtoll ALRL ALR LL_RTC_ALARM_Set\n
|
* @param RTCx RTC Instance
|
* @param AlarmCounter Value between Min_Data=0x00 and Max_Data=0xFFFFF
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ALARM_Set(RTC_TypeDef *RTCx, uint32_t AlarmCounter)
|
{
|
/* Set RTC COUNTER MSB word */
|
WRITE_REG(RTCx->ALRH, (AlarmCounter >> 16));
|
/* Set RTC COUNTER LSB word */
|
WRITE_REG(RTCx->ALRL, (AlarmCounter & RTC_ALRL_RTC_ALR));
|
}
|
|
/**
|
* @brief Get Alarm Counter
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll ALRH ALR LL_RTC_ALARM_Get\n
|
* @rmtoll ALRL ALR LL_RTC_ALARM_Get\n
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_ALARM_Get(RTC_TypeDef *RTCx)
|
{
|
register uint16_t high = 0, low = 0;
|
|
high = READ_REG(RTCx->ALRH & RTC_ALRH_RTC_ALR);
|
low = READ_REG(RTCx->ALRL & RTC_ALRL_RTC_ALR);
|
|
return (((uint32_t) high << 16U) | low);
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_Tamper Tamper
|
* @{
|
*/
|
|
/**
|
* @brief Enable RTC_TAMPx input detection
|
* @rmtoll CR TPE LL_RTC_TAMPER_Enable\n
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_TAMPER_Enable(BKP_TypeDef *BKPx)
|
{
|
SET_BIT(BKPx->CR, BKP_CR_TPE);
|
}
|
|
/**
|
* @brief Disable RTC_TAMPx Tamper
|
* @rmtoll CR TPE LL_RTC_TAMPER_Disable\n
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_TAMPER_Disable(BKP_TypeDef *BKPx)
|
{
|
CLEAR_BIT(BKP->CR, BKP_CR_TPE);
|
}
|
|
/**
|
* @brief Enable Active level for Tamper input
|
* @rmtoll CR TPAL LL_RTC_TAMPER_SetActiveLevel\n
|
* @param BKPx BKP Instance
|
* @param Tamper This parameter can be a combination of the following values:
|
* @arg @ref LL_RTC_TAMPER_ACTIVELEVEL_LOW
|
* @arg @ref LL_RTC_TAMPER_ACTIVELEVEL_HIGH
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_TAMPER_SetActiveLevel(BKP_TypeDef *BKPx, uint32_t Tamper)
|
{
|
MODIFY_REG(BKPx->CR, BKP_CR_TPAL, Tamper);
|
}
|
|
/**
|
* @brief Disable Active level for Tamper input
|
* @rmtoll CR TPAL LL_RTC_TAMPER_SetActiveLevel\n
|
* @retval None
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_TAMPER_GetActiveLevel(BKP_TypeDef *BKPx)
|
{
|
return (uint32_t)(READ_BIT(BKPx->CR, BKP_CR_TPAL));
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_Backup_Registers Backup_Registers
|
* @{
|
*/
|
|
/**
|
* @brief Writes a data in a specified RTC Backup data register.
|
* @rmtoll BKPDR DR LL_RTC_BKP_SetRegister
|
* @param BKPx BKP Instance
|
* @param BackupRegister This parameter can be one of the following values:
|
* @arg @ref LL_RTC_BKP_DR1
|
* @arg @ref LL_RTC_BKP_DR2
|
* @arg @ref LL_RTC_BKP_DR3
|
* @arg @ref LL_RTC_BKP_DR4
|
* @arg @ref LL_RTC_BKP_DR5
|
* @arg @ref LL_RTC_BKP_DR6
|
* @arg @ref LL_RTC_BKP_DR7
|
* @arg @ref LL_RTC_BKP_DR8
|
* @arg @ref LL_RTC_BKP_DR9
|
* @arg @ref LL_RTC_BKP_DR10
|
* @arg @ref LL_RTC_BKP_DR11 (*)
|
* @arg @ref LL_RTC_BKP_DR12 (*)
|
* @arg @ref LL_RTC_BKP_DR13 (*)
|
* @arg @ref LL_RTC_BKP_DR14 (*)
|
* @arg @ref LL_RTC_BKP_DR15 (*)
|
* @arg @ref LL_RTC_BKP_DR16 (*)
|
* @arg @ref LL_RTC_BKP_DR17 (*)
|
* @arg @ref LL_RTC_BKP_DR18 (*)
|
* @arg @ref LL_RTC_BKP_DR19 (*)
|
* @arg @ref LL_RTC_BKP_DR20 (*)
|
* @arg @ref LL_RTC_BKP_DR21 (*)
|
* @arg @ref LL_RTC_BKP_DR22 (*)
|
* @arg @ref LL_RTC_BKP_DR23 (*)
|
* @arg @ref LL_RTC_BKP_DR24 (*)
|
* @arg @ref LL_RTC_BKP_DR25 (*)
|
* @arg @ref LL_RTC_BKP_DR26 (*)
|
* @arg @ref LL_RTC_BKP_DR27 (*)
|
* @arg @ref LL_RTC_BKP_DR28 (*)
|
* @arg @ref LL_RTC_BKP_DR29 (*)
|
* @arg @ref LL_RTC_BKP_DR30 (*)
|
* @arg @ref LL_RTC_BKP_DR31 (*)
|
* @arg @ref LL_RTC_BKP_DR32 (*)
|
* @arg @ref LL_RTC_BKP_DR33 (*)
|
* @arg @ref LL_RTC_BKP_DR34 (*)
|
* @arg @ref LL_RTC_BKP_DR35 (*)
|
* @arg @ref LL_RTC_BKP_DR36 (*)
|
* @arg @ref LL_RTC_BKP_DR37 (*)
|
* @arg @ref LL_RTC_BKP_DR38 (*)
|
* @arg @ref LL_RTC_BKP_DR39 (*)
|
* @arg @ref LL_RTC_BKP_DR40 (*)
|
* @arg @ref LL_RTC_BKP_DR41 (*)
|
* @arg @ref LL_RTC_BKP_DR42 (*)
|
* (*) value not defined in all devices.
|
* @param Data Value between Min_Data=0x00 and Max_Data=0xFFFFFFFF
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_BKP_SetRegister(BKP_TypeDef *BKPx, uint32_t BackupRegister, uint32_t Data)
|
{
|
register uint32_t tmp = 0U;
|
|
tmp = (uint32_t)BKP_BASE;
|
tmp += (BackupRegister * 4U);
|
|
/* Write the specified register */
|
*(__IO uint32_t *)tmp = (uint32_t)Data;
|
}
|
|
/**
|
* @brief Reads data from the specified RTC Backup data Register.
|
* @rmtoll BKPDR DR LL_RTC_BKP_GetRegister
|
* @param BKPx BKP Instance
|
* @param BackupRegister This parameter can be one of the following values:
|
* @arg @ref LL_RTC_BKP_DR1
|
* @arg @ref LL_RTC_BKP_DR2
|
* @arg @ref LL_RTC_BKP_DR3
|
* @arg @ref LL_RTC_BKP_DR4
|
* @arg @ref LL_RTC_BKP_DR5
|
* @arg @ref LL_RTC_BKP_DR6
|
* @arg @ref LL_RTC_BKP_DR7
|
* @arg @ref LL_RTC_BKP_DR8
|
* @arg @ref LL_RTC_BKP_DR9
|
* @arg @ref LL_RTC_BKP_DR10
|
* @arg @ref LL_RTC_BKP_DR11 (*)
|
* @arg @ref LL_RTC_BKP_DR12 (*)
|
* @arg @ref LL_RTC_BKP_DR13 (*)
|
* @arg @ref LL_RTC_BKP_DR14 (*)
|
* @arg @ref LL_RTC_BKP_DR15 (*)
|
* @arg @ref LL_RTC_BKP_DR16 (*)
|
* @arg @ref LL_RTC_BKP_DR17 (*)
|
* @arg @ref LL_RTC_BKP_DR18 (*)
|
* @arg @ref LL_RTC_BKP_DR19 (*)
|
* @arg @ref LL_RTC_BKP_DR20 (*)
|
* @arg @ref LL_RTC_BKP_DR21 (*)
|
* @arg @ref LL_RTC_BKP_DR22 (*)
|
* @arg @ref LL_RTC_BKP_DR23 (*)
|
* @arg @ref LL_RTC_BKP_DR24 (*)
|
* @arg @ref LL_RTC_BKP_DR25 (*)
|
* @arg @ref LL_RTC_BKP_DR26 (*)
|
* @arg @ref LL_RTC_BKP_DR27 (*)
|
* @arg @ref LL_RTC_BKP_DR28 (*)
|
* @arg @ref LL_RTC_BKP_DR29 (*)
|
* @arg @ref LL_RTC_BKP_DR30 (*)
|
* @arg @ref LL_RTC_BKP_DR31 (*)
|
* @arg @ref LL_RTC_BKP_DR32 (*)
|
* @arg @ref LL_RTC_BKP_DR33 (*)
|
* @arg @ref LL_RTC_BKP_DR34 (*)
|
* @arg @ref LL_RTC_BKP_DR35 (*)
|
* @arg @ref LL_RTC_BKP_DR36 (*)
|
* @arg @ref LL_RTC_BKP_DR37 (*)
|
* @arg @ref LL_RTC_BKP_DR38 (*)
|
* @arg @ref LL_RTC_BKP_DR39 (*)
|
* @arg @ref LL_RTC_BKP_DR40 (*)
|
* @arg @ref LL_RTC_BKP_DR41 (*)
|
* @arg @ref LL_RTC_BKP_DR42 (*)
|
* @retval Value between Min_Data=0x00 and Max_Data=0xFFFFFFFF
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_BKP_GetRegister(BKP_TypeDef *BKPx, uint32_t BackupRegister)
|
{
|
register uint32_t tmp = 0U;
|
|
tmp = (uint32_t)BKP_BASE;
|
tmp += (BackupRegister * 4U);
|
|
/* Read the specified register */
|
return ((*(__IO uint32_t *)tmp) & BKP_DR1_D);
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_Calibration Calibration
|
* @{
|
*/
|
|
/**
|
* @brief Set the coarse digital calibration
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @note It can be written in initialization mode only (@ref LL_RTC_EnterInitMode function)
|
* @rmtoll RTCCR CAL LL_RTC_CAL_SetCoarseDigital\n
|
* @param BKPx RTC Instance
|
* @param Value value of coarse calibration expressed in ppm (coded on 5 bits)
|
* @note This Calibration value should be between 0 and 121 when using positive sign with a 4-ppm step.
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_CAL_SetCoarseDigital(BKP_TypeDef *BKPx, uint32_t Value)
|
{
|
MODIFY_REG(BKPx->RTCCR, BKP_RTCCR_CAL, Value);
|
}
|
|
/**
|
* @brief Get the coarse digital calibration value
|
* @rmtoll RTCCR CAL LL_RTC_CAL_SetCoarseDigital\n
|
* @param BKPx BKP Instance
|
* @retval value of coarse calibration expressed in ppm (coded on 5 bits)
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_CAL_GetCoarseDigital(BKP_TypeDef *BKPx)
|
{
|
return (uint32_t)(READ_BIT(BKPx->RTCCR, BKP_RTCCR_CAL));
|
}
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_FLAG_Management FLAG_Management
|
* @{
|
*/
|
|
/**
|
* @brief Get RTC_TAMPI Interruption detection flag
|
* @rmtoll CSR TIF LL_RTC_IsActiveFlag_TAMPI
|
* @param BKPx BKP Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_TAMPI(BKP_TypeDef *BKPx)
|
{
|
return (READ_BIT(BKPx->CSR, BKP_CSR_TIF) == (BKP_CSR_TIF));
|
}
|
|
/**
|
* @brief Clear RTC_TAMP Interruption detection flag
|
* @rmtoll CSR CTI LL_RTC_ClearFlag_TAMPI
|
* @param BKPx BKP Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_TAMPI(BKP_TypeDef *BKPx)
|
{
|
SET_BIT(BKPx->CSR, BKP_CSR_CTI);
|
}
|
|
/**
|
* @brief Get RTC_TAMPE Event detection flag
|
* @rmtoll CSR TEF LL_RTC_IsActiveFlag_TAMPE
|
* @param BKPx BKP Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_TAMPE(BKP_TypeDef *BKPx)
|
{
|
return (READ_BIT(BKPx->CSR, BKP_CSR_TEF) == (BKP_CSR_TEF));
|
}
|
|
/**
|
* @brief Clear RTC_TAMPE Even detection flag
|
* @rmtoll CSR CTE LL_RTC_ClearFlag_TAMPE
|
* @param BKPx BKP Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_TAMPE(BKP_TypeDef *BKPx)
|
{
|
SET_BIT(BKPx->CSR, BKP_CSR_CTE);
|
}
|
|
/**
|
* @brief Get Alarm flag
|
* @rmtoll CRL ALRF LL_RTC_IsActiveFlag_ALR
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_ALR(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRL, RTC_CRL_ALRF) == (RTC_CRL_ALRF));
|
}
|
|
/**
|
* @brief Clear Alarm flag
|
* @rmtoll CRL ALRF LL_RTC_ClearFlag_ALR
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_ALR(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRL, RTC_CRL_ALRF);
|
}
|
|
/**
|
* @brief Get Registers synchronization flag
|
* @rmtoll CRL RSF LL_RTC_IsActiveFlag_RS
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_RS(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRL, RTC_CRL_RSF) == (RTC_CRL_RSF));
|
}
|
|
/**
|
* @brief Clear Registers synchronization flag
|
* @rmtoll CRL RSF LL_RTC_ClearFlag_RS
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_RS(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRL, RTC_CRL_RSF);
|
}
|
|
/**
|
* @brief Get Registers OverFlow flag
|
* @rmtoll CRL OWF LL_RTC_IsActiveFlag_OW
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_OW(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRL, RTC_CRL_OWF) == (RTC_CRL_OWF));
|
}
|
|
/**
|
* @brief Clear Registers OverFlow flag
|
* @rmtoll CRL OWF LL_RTC_ClearFlag_OW
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_OW(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRL, RTC_CRL_OWF);
|
}
|
|
/**
|
* @brief Get Registers synchronization flag
|
* @rmtoll CRL SECF LL_RTC_IsActiveFlag_SEC
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_SEC(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRL, RTC_CRL_SECF) == (RTC_CRL_SECF));
|
}
|
|
/**
|
* @brief Clear Registers synchronization flag
|
* @rmtoll CRL SECF LL_RTC_ClearFlag_SEC
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_ClearFlag_SEC(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRL, RTC_CRL_SECF);
|
}
|
|
/**
|
* @brief Get RTC Operation OFF status flag
|
* @rmtoll CRL RTOFF LL_RTC_IsActiveFlag_RTOF
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsActiveFlag_RTOF(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRL, RTC_CRL_RTOFF) == (RTC_CRL_RTOFF));
|
}
|
|
/**
|
* @}
|
*/
|
|
/** @defgroup RTC_LL_EF_IT_Management IT_Management
|
* @{
|
*/
|
|
/**
|
* @brief Enable Alarm interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH ALRIE LL_RTC_EnableIT_ALR
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_EnableIT_ALR(RTC_TypeDef *RTCx)
|
{
|
SET_BIT(RTCx->CRH, RTC_CRH_ALRIE);
|
}
|
|
/**
|
* @brief Disable Alarm interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH ALRIE LL_RTC_DisableIT_ALR
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_DisableIT_ALR(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRH, RTC_CRH_ALRIE);
|
}
|
|
/**
|
* @brief Check if Alarm interrupt is enabled or not
|
* @rmtoll CRH ALRIE LL_RTC_IsEnabledIT_ALR
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsEnabledIT_ALR(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRH, RTC_CRH_ALRIE) == (RTC_CRH_ALRIE));
|
}
|
|
/**
|
* @brief Enable Second Interrupt interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH SECIE LL_RTC_EnableIT_SEC
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_EnableIT_SEC(RTC_TypeDef *RTCx)
|
{
|
SET_BIT(RTCx->CRH, RTC_CRH_SECIE);
|
}
|
|
/**
|
* @brief Disable Second interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH SECIE LL_RTC_DisableIT_SEC
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_DisableIT_SEC(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRH, RTC_CRH_SECIE);
|
}
|
|
/**
|
* @brief Check if Second interrupt is enabled or not
|
* @rmtoll CRH SECIE LL_RTC_IsEnabledIT_SEC
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsEnabledIT_SEC(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRH, RTC_CRH_SECIE) == (RTC_CRH_SECIE));
|
}
|
|
/**
|
* @brief Enable OverFlow interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH OWIE LL_RTC_EnableIT_OW
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_EnableIT_OW(RTC_TypeDef *RTCx)
|
{
|
SET_BIT(RTCx->CRH, RTC_CRH_OWIE);
|
}
|
|
/**
|
* @brief Disable OverFlow interrupt
|
* @note Bit is write-protected. @ref LL_RTC_DisableWriteProtection function should be called before.
|
* @rmtoll CRH OWIE LL_RTC_DisableIT_OW
|
* @param RTCx RTC Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_DisableIT_OW(RTC_TypeDef *RTCx)
|
{
|
CLEAR_BIT(RTCx->CRH, RTC_CRH_OWIE);
|
}
|
|
/**
|
* @brief Check if OverFlow interrupt is enabled or not
|
* @rmtoll CRH OWIE LL_RTC_IsEnabledIT_OW
|
* @param RTCx RTC Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsEnabledIT_OW(RTC_TypeDef *RTCx)
|
{
|
return (READ_BIT(RTCx->CRH, RTC_CRH_OWIE) == (RTC_CRH_OWIE));
|
}
|
|
/**
|
* @brief Enable Tamper interrupt
|
* @rmtoll CSR TPIE LL_RTC_EnableIT_TAMP
|
* @param BKPx BKP Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_EnableIT_TAMP(BKP_TypeDef *BKPx)
|
{
|
SET_BIT(BKPx->CSR, BKP_CSR_TPIE);
|
}
|
|
/**
|
* @brief Disable Tamper interrupt
|
* @rmtoll CSR TPIE LL_RTC_EnableIT_TAMP
|
* @param BKPx BKP Instance
|
* @retval None
|
*/
|
__STATIC_INLINE void LL_RTC_DisableIT_TAMP(BKP_TypeDef *BKPx)
|
{
|
CLEAR_BIT(BKPx->CSR, BKP_CSR_TPIE);
|
}
|
|
/**
|
* @brief Check if all the TAMPER interrupts are enabled or not
|
* @rmtoll CSR TPIE LL_RTC_IsEnabledIT_TAMP
|
* @param BKPx BKP Instance
|
* @retval State of bit (1 or 0).
|
*/
|
__STATIC_INLINE uint32_t LL_RTC_IsEnabledIT_TAMP(BKP_TypeDef *BKPx)
|
{
|
return (READ_BIT(BKPx->CSR, BKP_CSR_TPIE) == BKP_CSR_TPIE);
|
}
|
/**
|
* @}
|
*/
|
|
#if defined(USE_FULL_LL_DRIVER)
|
/** @defgroup RTC_LL_EF_Init Initialization and de-initialization functions
|
* @{
|
*/
|
|
ErrorStatus LL_RTC_DeInit(RTC_TypeDef *RTCx);
|
ErrorStatus LL_RTC_Init(RTC_TypeDef *RTCx, LL_RTC_InitTypeDef *RTC_InitStruct);
|
void LL_RTC_StructInit(LL_RTC_InitTypeDef *RTC_InitStruct);
|
ErrorStatus LL_RTC_TIME_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_TimeTypeDef *RTC_TimeStruct);
|
void LL_RTC_TIME_StructInit(LL_RTC_TimeTypeDef *RTC_TimeStruct);
|
ErrorStatus LL_RTC_ALARM_Init(RTC_TypeDef *RTCx, uint32_t RTC_Format, LL_RTC_AlarmTypeDef *RTC_AlarmStruct);
|
void LL_RTC_ALARM_StructInit(LL_RTC_AlarmTypeDef *RTC_AlarmStruct);
|
ErrorStatus LL_RTC_EnterInitMode(RTC_TypeDef *RTCx);
|
ErrorStatus LL_RTC_ExitInitMode(RTC_TypeDef *RTCx);
|
ErrorStatus LL_RTC_WaitForSynchro(RTC_TypeDef *RTCx);
|
ErrorStatus LL_RTC_TIME_SetCounter(RTC_TypeDef *RTCx, uint32_t TimeCounter);
|
ErrorStatus LL_RTC_ALARM_SetCounter(RTC_TypeDef *RTCx, uint32_t AlarmCounter);
|
|
/**
|
* @}
|
*/
|
#endif /* USE_FULL_LL_DRIVER */
|
|
/**
|
* @}
|
*/
|
|
/**
|
* @}
|
*/
|
|
/**
|
* @}
|
*/
|
|
#endif /* defined(RTC) */
|
|
/**
|
* @}
|
*/
|
|
#ifdef __cplusplus
|
}
|
#endif
|
|
#endif /* __STM32F1xx_LL_RTC_H */
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|
