| /** |
| ****************************************************************************** |
| * @file stm32f3xx_hal_rtc_ex.h |
| * @author MCD Application Team |
| * @version V1.4.0 |
| * @date 16-December-2016 |
| * @brief Header file of RTC HAL Extended module. |
| ****************************************************************************** |
| * @attention |
| * |
| * <h2><center>© COPYRIGHT(c) 2016 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. |
| * |
| ****************************************************************************** |
| */ |
| |
| /* Define to prevent recursive inclusion -------------------------------------*/ |
| #ifndef __STM32F3xx_HAL_RTC_EX_H |
| #define __STM32F3xx_HAL_RTC_EX_H |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32f3xx_hal_def.h" |
| |
| /** @addtogroup STM32F3xx_HAL_Driver |
| * @{ |
| */ |
| |
| /** @defgroup RTCEx RTCEx |
| * @{ |
| */ |
| |
| /* Exported types ------------------------------------------------------------*/ |
| |
| /** @defgroup RTCEx_Exported_Types RTC Extended Exported Types |
| * @{ |
| */ |
| |
| /** |
| * @brief RTC Tamper structure definition |
| */ |
| typedef struct |
| { |
| uint32_t Tamper; /*!< Specifies the Tamper Pin. |
| This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions */ |
| |
| uint32_t Trigger; /*!< Specifies the Tamper Trigger. |
| This parameter can be a value of @ref RTCEx_Tamper_Trigger_Definitions */ |
| |
| uint32_t Filter; /*!< Specifies the RTC Filter Tamper. |
| This parameter can be a value of @ref RTCEx_Tamper_Filter_Definitions */ |
| |
| uint32_t SamplingFrequency; /*!< Specifies the sampling frequency. |
| This parameter can be a value of @ref RTCEx_Tamper_Sampling_Frequencies_Definitions */ |
| |
| uint32_t PrechargeDuration; /*!< Specifies the Precharge Duration . |
| This parameter can be a value of @ref RTCEx_Tamper_Pin_Precharge_Duration_Definitions */ |
| |
| uint32_t TamperPullUp; /*!< Specifies the Tamper PullUp . |
| This parameter can be a value of @ref RTCEx_Tamper_Pull_UP_Definitions */ |
| |
| uint32_t TimeStampOnTamperDetection; /*!< Specifies the TimeStampOnTamperDetection. |
| This parameter can be a value of @ref RTCEx_Tamper_TimeStampOnTamperDetection_Definitions */ |
| }RTC_TamperTypeDef; |
| /** |
| * @} |
| */ |
| |
| /* Exported constants --------------------------------------------------------*/ |
| /** @defgroup RTCEx_Exported_Constants RTC Extended Exported Constants |
| * @{ |
| */ |
| |
| /** @defgroup RTCEx_Output_selection_Definitions RTC Extended Output Selection Definition |
| * @{ |
| */ |
| #define RTC_OUTPUT_DISABLE (0x00000000U) |
| #define RTC_OUTPUT_ALARMA RTC_CR_OSEL_0 |
| #define RTC_OUTPUT_ALARMB RTC_CR_OSEL_1 |
| #define RTC_OUTPUT_WAKEUP RTC_CR_OSEL |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Backup_Registers_Definitions RTC Extended Backup Registers Definition |
| * @{ |
| */ |
| #if RTC_BKP_NUMBER > 0U |
| #define RTC_BKP_DR0 (0x00000000U) |
| #define RTC_BKP_DR1 (0x00000001U) |
| #define RTC_BKP_DR2 (0x00000002U) |
| #define RTC_BKP_DR3 (0x00000003U) |
| #define RTC_BKP_DR4 (0x00000004U) |
| #endif /* RTC_BKP_NUMBER > 0U */ |
| |
| #if RTC_BKP_NUMBER > 5U |
| #define RTC_BKP_DR5 (0x00000005U) |
| #define RTC_BKP_DR6 (0x00000006U) |
| #define RTC_BKP_DR7 (0x00000007U) |
| #define RTC_BKP_DR8 (0x00000008U) |
| #define RTC_BKP_DR9 (0x00000009U) |
| #define RTC_BKP_DR10 (0x0000000AU) |
| #define RTC_BKP_DR11 (0x0000000BU) |
| #define RTC_BKP_DR12 (0x0000000CU) |
| #define RTC_BKP_DR13 (0x0000000DU) |
| #define RTC_BKP_DR14 (0x0000000EU) |
| #define RTC_BKP_DR15 (0x0000000FU) |
| #endif /* RTC_BKP_NUMBER > 5U */ |
| |
| #if RTC_BKP_NUMBER > 16U |
| #define RTC_BKP_DR16 (0x00000010U) |
| #define RTC_BKP_DR17 (0x00000011U) |
| #define RTC_BKP_DR18 (0x00000012U) |
| #define RTC_BKP_DR19 (0x00000013U) |
| #endif /* RTC_BKP_NUMBER > 16U */ |
| |
| #if RTC_BKP_NUMBER > 20U |
| #define RTC_BKP_DR20 (0x00000014U) |
| #define RTC_BKP_DR21 (0x00000015U) |
| #define RTC_BKP_DR22 (0x00000016U) |
| #define RTC_BKP_DR23 (0x00000017U) |
| #define RTC_BKP_DR24 (0x00000018U) |
| #define RTC_BKP_DR25 (0x00000019U) |
| #define RTC_BKP_DR26 (0x0000001AU) |
| #define RTC_BKP_DR27 (0x0000001BU) |
| #define RTC_BKP_DR28 (0x0000001CU) |
| #define RTC_BKP_DR29 (0x0000001DU) |
| #define RTC_BKP_DR30 (0x0000001EU) |
| #define RTC_BKP_DR31 (0x0000001FU) |
| #endif /* RTC_BKP_NUMBER > 20U */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Time_Stamp_Edges_definitions RTC Extended Time Stamp Edges definition |
| * @{ |
| */ |
| #define RTC_TIMESTAMPEDGE_RISING (0x00000000U) |
| #define RTC_TIMESTAMPEDGE_FALLING RTC_CR_TSEDGE |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_TimeStamp_Pin_Selections RTC Extended TimeStamp Pin Selection |
| * @{ |
| */ |
| #define RTC_TIMESTAMPPIN_DEFAULT (0x00000000U) |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_Pins_Definitions RTC Extended Tamper Pins Definition |
| * @{ |
| */ |
| #define RTC_TAMPER_1 RTC_TAFCR_TAMP1E |
| #define RTC_TAMPER_2 RTC_TAFCR_TAMP2E |
| #if defined(RTC_TAMPER3_SUPPORT) |
| #define RTC_TAMPER_3 RTC_TAFCR_TAMP3E |
| #endif /* RTC_TAMPER3_SUPPORT */ |
| /** |
| * @} |
| */ |
| |
| |
| /** @defgroup RTCEx_Tamper_Trigger_Definitions RTC Extended Tamper Trigger Definition |
| * @{ |
| */ |
| #define RTC_TAMPERTRIGGER_RISINGEDGE (0x00000000U) |
| #define RTC_TAMPERTRIGGER_FALLINGEDGE RTC_TAFCR_TAMP1TRG |
| #define RTC_TAMPERTRIGGER_LOWLEVEL RTC_TAMPERTRIGGER_RISINGEDGE |
| #define RTC_TAMPERTRIGGER_HIGHLEVEL RTC_TAMPERTRIGGER_FALLINGEDGE |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_Filter_Definitions RTC Extended Tamper Filter Definition |
| * @{ |
| */ |
| #define RTC_TAMPERFILTER_DISABLE (0x00000000U) /*!< Tamper filter is disabled */ |
| |
| #define RTC_TAMPERFILTER_2SAMPLE RTC_TAFCR_TAMPFLT_0 /*!< Tamper is activated after 2 |
| consecutive samples at the active level */ |
| #define RTC_TAMPERFILTER_4SAMPLE RTC_TAFCR_TAMPFLT_1 /*!< Tamper is activated after 4 |
| consecutive samples at the active level */ |
| #define RTC_TAMPERFILTER_8SAMPLE RTC_TAFCR_TAMPFLT /*!< Tamper is activated after 8 |
| consecutive samples at the active level. */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_Sampling_Frequencies_Definitions RTC Extended Tamper Sampling Frequencies Definition |
| * @{ |
| */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV32768 (0x00000000U) /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 32768U */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV16384 RTC_TAFCR_TAMPFREQ_0 /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 16384U */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV8192 RTC_TAFCR_TAMPFREQ_1 /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 8192 */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV4096 (RTC_TAFCR_TAMPFREQ_0 | RTC_TAFCR_TAMPFREQ_1) /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 4096 */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV2048 RTC_TAFCR_TAMPFREQ_2 /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 2048 */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV1024 (RTC_TAFCR_TAMPFREQ_0 | RTC_TAFCR_TAMPFREQ_2) /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 1024 */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV512 (RTC_TAFCR_TAMPFREQ_1 | RTC_TAFCR_TAMPFREQ_2) /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 512 */ |
| #define RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV256 (RTC_TAFCR_TAMPFREQ_0 | RTC_TAFCR_TAMPFREQ_1 | RTC_TAFCR_TAMPFREQ_2) /*!< Each of the tamper inputs are sampled |
| with a frequency = RTCCLK / 256 */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_Pin_Precharge_Duration_Definitions RTC Extended Tamper Pin Precharge Duration Definition |
| * @{ |
| */ |
| #define RTC_TAMPERPRECHARGEDURATION_1RTCCLK (0x00000000U) /*!< Tamper pins are pre-charged before |
| sampling during 1 RTCCLK cycle */ |
| #define RTC_TAMPERPRECHARGEDURATION_2RTCCLK RTC_TAFCR_TAMPPRCH_0 /*!< Tamper pins are pre-charged before |
| sampling during 2 RTCCLK cycles */ |
| #define RTC_TAMPERPRECHARGEDURATION_4RTCCLK RTC_TAFCR_TAMPPRCH_1 /*!< Tamper pins are pre-charged before |
| sampling during 4 RTCCLK cycles */ |
| #define RTC_TAMPERPRECHARGEDURATION_8RTCCLK (RTC_TAFCR_TAMPPRCH_0 | RTC_TAFCR_TAMPPRCH_1) /*!< Tamper pins are pre-charged before |
| sampling during 8 RTCCLK cycles */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_TimeStampOnTamperDetection_Definitions RTC Extended Tamper TimeStampOnTamperDetection Definition |
| * @{ |
| */ |
| #define RTC_TIMESTAMPONTAMPERDETECTION_ENABLE ((uint32_t)RTC_TAFCR_TAMPTS) /*!< TimeStamp on Tamper Detection event saved */ |
| #define RTC_TIMESTAMPONTAMPERDETECTION_DISABLE (0x00000000U) /*!< TimeStamp on Tamper Detection event is not saved */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Tamper_Pull_UP_Definitions RTC Extended Tamper Pull UP Definition |
| * @{ |
| */ |
| #define RTC_TAMPER_PULLUP_ENABLE (0x00000000U) /*!< Tamper pins are pre-charged before sampling */ |
| #define RTC_TAMPER_PULLUP_DISABLE ((uint32_t)RTC_TAFCR_TAMPPUDIS) /*!< Tamper pins are not pre-charged before sampling */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Wakeup_Timer_Definitions RTC Extended Wakeup Timer Definition |
| * @{ |
| */ |
| #define RTC_WAKEUPCLOCK_RTCCLK_DIV16 (0x00000000U) |
| #define RTC_WAKEUPCLOCK_RTCCLK_DIV8 RTC_CR_WUCKSEL_0 |
| #define RTC_WAKEUPCLOCK_RTCCLK_DIV4 RTC_CR_WUCKSEL_1 |
| #define RTC_WAKEUPCLOCK_RTCCLK_DIV2 (RTC_CR_WUCKSEL_0 | RTC_CR_WUCKSEL_1) |
| #define RTC_WAKEUPCLOCK_CK_SPRE_16BITS (RTC_CR_WUCKSEL_2) |
| #define RTC_WAKEUPCLOCK_CK_SPRE_17BITS (RTC_CR_WUCKSEL_1 | RTC_CR_WUCKSEL_2) |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Smooth_calib_period_Definitions RTC Extended Smooth calib period Definition |
| * @{ |
| */ |
| #define RTC_SMOOTHCALIB_PERIOD_32SEC (0x00000000U) /*!< If RTCCLK = 32768 Hz, Smooth calibation |
| period is 32s, else 2exp20 RTCCLK seconds */ |
| #define RTC_SMOOTHCALIB_PERIOD_16SEC RTC_CALR_CALW16 /*!< If RTCCLK = 32768 Hz, Smooth calibation |
| period is 16s, else 2exp19 RTCCLK seconds */ |
| #define RTC_SMOOTHCALIB_PERIOD_8SEC RTC_CALR_CALW8 /*!< If RTCCLK = 32768 Hz, Smooth calibation |
| period is 8s, else 2exp18 RTCCLK seconds */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Smooth_calib_Plus_pulses_Definitions RTC Extended Smooth calib Plus pulses Definition |
| * @{ |
| */ |
| #define RTC_SMOOTHCALIB_PLUSPULSES_RESET (0x00000000U) /*!< The number of RTCCLK pulses subbstited |
| during a 32-second window = CALM[8:0] */ |
| #define RTC_SMOOTHCALIB_PLUSPULSES_SET RTC_CALR_CALP /*!< The number of RTCCLK pulses added |
| during a X -second window = Y - CALM[8:0] |
| with Y = 512U, 256U, 128 when X = 32U, 16U, 8U */ |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Calib_Output_selection_Definitions RTC Extended Calib Output selection Definition |
| * @{ |
| */ |
| #define RTC_CALIBOUTPUT_512HZ (0x00000000U) |
| #define RTC_CALIBOUTPUT_1HZ RTC_CR_COSEL |
| /** |
| * @} |
| */ |
| |
| /** @defgroup RTCEx_Add_1_Second_Parameter_Definition RTC Extended Add 1 Second Parameter Definition |
| * @{ |
| */ |
| #define RTC_SHIFTADD1S_RESET (0x00000000U) |
| #define RTC_SHIFTADD1S_SET RTC_SHIFTR_ADD1S |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /* Exported macro ------------------------------------------------------------*/ |
| /** @defgroup RTCEx_Exported_Macros RTC Extended Exported Macros |
| * @{ |
| */ |
| |
| /* ---------------------------------WAKEUPTIMER---------------------------------*/ |
| /** @defgroup RTCEx_WakeUp_Timer RTC Extended WakeUp Timer |
| * @{ |
| */ |
| /** |
| * @brief Enable the RTC WakeUp Timer peripheral. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_WUTE)) |
| |
| /** |
| * @brief Disable the RTC WakeUp Timer peripheral. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_WUTE)) |
| |
| /** |
| * @brief Enable the RTC WakeUpTimer interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC WakeUpTimer interrupt sources to be enabled. |
| * This parameter can be: |
| * @arg RTC_IT_WUT: WakeUpTimer interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__)) |
| |
| /** |
| * @brief Disable the RTC WakeUpTimer interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC WakeUpTimer interrupt sources to be disabled. |
| * This parameter can be: |
| * @arg RTC_IT_WUT: WakeUpTimer interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__)) |
| |
| /** |
| * @brief Check whether the specified RTC WakeUpTimer interrupt has occurred or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC WakeUpTimer interrupt to check. |
| * This parameter can be: |
| * @arg RTC_IT_WUT: WakeUpTimer interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_GET_IT(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->ISR) & ((__INTERRUPT__)>> 4U)) != RESET) ? SET : RESET) |
| |
| /** |
| * @brief Check whether the specified RTC Wake Up timer interrupt has been enabled or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Wake Up timer interrupt sources to check. |
| * This parameter can be: |
| * @arg RTC_IT_WUT: WakeUpTimer interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->CR) & (__INTERRUPT__)) != RESET) ? SET : RESET) |
| |
| /** |
| * @brief Get the selected RTC WakeUpTimer's flag status. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC WakeUpTimer Flag is pending or not. |
| * This parameter can be: |
| * @arg RTC_FLAG_WUTF |
| * @arg RTC_FLAG_WUTWF |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET) ? SET : RESET) |
| |
| /** |
| * @brief Clear the RTC Wake Up timer's pending flags. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC WakeUpTimer Flag to clear. |
| * This parameter can be: |
| * @arg RTC_FLAG_WUTF |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~((__FLAG__) | RTC_ISR_INIT)|((__HANDLE__)->Instance->ISR & RTC_ISR_INIT)) |
| |
| /* WAKE-UP TIMER EXTI */ |
| /* ------------------ */ |
| /** |
| * @brief Enable interrupt on the RTC WakeUp Timer associated Exti line. |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_IT() (EXTI->IMR |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Disable interrupt on the RTC WakeUp Timer associated Exti line. |
| * @retval None |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_IT() (EXTI->IMR &= ~(RTC_EXTI_LINE_WAKEUPTIMER_EVENT)) |
| |
| /** |
| * @brief Enable event on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_EVENT() (EXTI->EMR |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Disable event on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_EVENT() (EXTI->EMR &= ~(RTC_EXTI_LINE_WAKEUPTIMER_EVENT)) |
| |
| /** |
| * @brief Enable falling edge trigger on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Disable falling edge trigger on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR &= ~(RTC_EXTI_LINE_WAKEUPTIMER_EVENT)) |
| |
| /** |
| * @brief Enable rising edge trigger on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Disable rising edge trigger on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR &= ~(RTC_EXTI_LINE_WAKEUPTIMER_EVENT)) |
| |
| /** |
| * @brief Enable rising & falling edge trigger on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_RISING_FALLING_EDGE() __HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_RISING_EDGE();__HAL_RTC_WAKEUPTIMER_EXTI_ENABLE_FALLING_EDGE(); |
| |
| /** |
| * @brief Disable rising & falling edge trigger on the RTC WakeUp Timer associated Exti line. |
| * This parameter can be: |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_RISING_FALLING_EDGE() __HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_RISING_EDGE();__HAL_RTC_WAKEUPTIMER_EXTI_DISABLE_FALLING_EDGE(); |
| |
| /** |
| * @brief Check whether the RTC WakeUp Timer associated Exti line interrupt flag is set or not. |
| * @retval Line Status. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_GET_FLAG() (EXTI->PR & RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Clear the RTC WakeUp Timer associated Exti line flag. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_CLEAR_FLAG() (EXTI->PR = RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| |
| /** |
| * @brief Generate a Software interrupt on the RTC WakeUp Timer associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_WAKEUPTIMER_EXTI_GENERATE_SWIT() (EXTI->SWIER |= RTC_EXTI_LINE_WAKEUPTIMER_EVENT) |
| /** |
| * @} |
| */ |
| |
| /* ---------------------------------TIMESTAMP---------------------------------*/ |
| /** @defgroup RTCEx_Timestamp RTC Extended Timestamp |
| * @{ |
| */ |
| /** |
| * @brief Enable the RTC TimeStamp peripheral. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_TSE)) |
| |
| /** |
| * @brief Disable the RTC TimeStamp peripheral. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_TSE)) |
| |
| /** |
| * @brief Enable the RTC TimeStamp interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC TimeStamp interrupt source to be enabled. |
| * This parameter can be: |
| * @arg RTC_IT_TS: TimeStamp interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__)) |
| |
| /** |
| * @brief Disable the RTC TimeStamp interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC TimeStamp interrupt source to be disabled. |
| * This parameter can be: |
| * @arg RTC_IT_TS: TimeStamp interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__)) |
| |
| /** |
| * @brief Check whether the specified RTC TimeStamp interrupt has occurred or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC TimeStamp interrupt to check. |
| * This parameter can be: |
| * @arg RTC_IT_TS: TimeStamp interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_GET_IT(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->ISR) & ((__INTERRUPT__)>> 4U)) != RESET)? SET : RESET) |
| |
| /** |
| * @brief Check whether the specified RTC Time Stamp interrupt has been enabled or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Time Stamp interrupt source to check. |
| * This parameter can be: |
| * @arg RTC_IT_TS: TimeStamp interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->CR) & (__INTERRUPT__)) != RESET) ? SET : RESET) |
| |
| /** |
| * @brief Get the selected RTC TimeStamp's flag status. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC TimeStamp Flag is pending or not. |
| * This parameter can be: |
| * @arg RTC_FLAG_TSF |
| * @arg RTC_FLAG_TSOVF |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET) |
| |
| /** |
| * @brief Clear the RTC Time Stamp's pending flags. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC Alarm Flag to clear. |
| * This parameter can be: |
| * @arg RTC_FLAG_TSF |
| * @retval None |
| */ |
| #define __HAL_RTC_TIMESTAMP_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~((__FLAG__) | RTC_ISR_INIT)|((__HANDLE__)->Instance->ISR & RTC_ISR_INIT)) |
| |
| /** |
| * @} |
| */ |
| |
| /* ---------------------------------TAMPER------------------------------------*/ |
| /** @defgroup RTCEx_Tamper RTC Extended Tamper |
| * @{ |
| */ |
| |
| /** |
| * @brief Enable the RTC Tamper1 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER1_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR |= (RTC_TAFCR_TAMP1E)) |
| |
| /** |
| * @brief Disable the RTC Tamper1 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER1_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR &= ~(RTC_TAFCR_TAMP1E)) |
| |
| /** |
| * @brief Enable the RTC Tamper2 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER2_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR |= (RTC_TAFCR_TAMP2E)) |
| |
| /** |
| * @brief Disable the RTC Tamper2 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER2_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR &= ~(RTC_TAFCR_TAMP2E)) |
| |
| #if defined(RTC_TAMPER3_SUPPORT) |
| /** |
| * @brief Enable the RTC Tamper3 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER3_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR |= (RTC_TAFCR_TAMP3E)) |
| |
| /** |
| * @brief Disable the RTC Tamper3 input detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER3_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->TAFCR &= ~(RTC_TAFCR_TAMP3E)) |
| #endif /* RTC_TAMPER3_SUPPORT */ |
| |
| /** |
| * @brief Enable the RTC Tamper interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be enabled. |
| * This parameter can be any combination of the following values: |
| * @arg RTC_IT_TAMP: Tamper interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->TAFCR |= (__INTERRUPT__)) |
| |
| /** |
| * @brief Disable the RTC Tamper interrupt. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be disabled. |
| * This parameter can be any combination of the following values: |
| * @arg RTC_IT_TAMP: Tamper interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->TAFCR &= ~(__INTERRUPT__)) |
| |
| /** |
| * @brief Check whether the specified RTC Tamper interrupt has occurred or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Tamper interrupt to check. |
| * This parameter can be: |
| * @arg RTC_IT_TAMP1: Tamper1 interrupt |
| * @arg RTC_IT_TAMP2: Tamper2 interrupt |
| * @arg RTC_IT_TAMP3: Tamper3 interrupt (*) |
| * @note (*) RTC_IT_TAMP3 not present on all the devices |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_GET_IT(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->ISR) & ((__INTERRUPT__)>> 4U)) != RESET)? SET : RESET) |
| |
| /** |
| * @brief Check whether the specified RTC Tamper interrupt has been enabled or not. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __INTERRUPT__: specifies the RTC Tamper interrupt source to check. |
| * This parameter can be: |
| * @arg RTC_IT_TAMP: Tamper interrupt |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->TAFCR) & (__INTERRUPT__)) != RESET) ? SET : RESET) |
| |
| /** |
| * @brief Get the selected RTC Tamper's flag status. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC Tamper Flag is pending or not. |
| * This parameter can be: |
| * @arg RTC_FLAG_TAMP1F |
| * @arg RTC_FLAG_TAMP2F |
| * @arg RTC_FLAG_TAMP3F (*) |
| * @note (*) RTC_FLAG_TAMP3F not present on all the devices |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET) |
| |
| |
| /** |
| * @brief Clear the RTC Tamper's pending flags. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC Tamper Flag to clear. |
| * This parameter can be: |
| * @arg RTC_FLAG_TAMP1F |
| * @arg RTC_FLAG_TAMP2F |
| * @arg RTC_FLAG_TAMP3F (*) |
| * @note (*) RTC_FLAG_TAMP3F not present on all the devices |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~((__FLAG__) | RTC_ISR_INIT)|((__HANDLE__)->Instance->ISR & RTC_ISR_INIT)) |
| |
| |
| /** |
| * @} |
| */ |
| |
| /* --------------------------TAMPER/TIMESTAMP---------------------------------*/ |
| /** @defgroup RTCEx_Tamper_Timestamp EXTI RTC Extended Tamper Timestamp EXTI |
| * @{ |
| */ |
| |
| /* TAMPER TIMESTAMP EXTI */ |
| /* --------------------- */ |
| /** |
| * @brief Enable interrupt on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_IT() (EXTI->IMR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Disable interrupt on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_IT() (EXTI->IMR &= ~(RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT)) |
| |
| /** |
| * @brief Enable event on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_EVENT() (EXTI->EMR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Disable event on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_EVENT() (EXTI->EMR &= ~(RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT)) |
| |
| /** |
| * @brief Enable falling edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Disable falling edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR &= ~(RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT)) |
| |
| /** |
| * @brief Enable rising edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Disable rising edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR &= ~(RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT)) |
| |
| /** |
| * @brief Enable rising & falling edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_RISING_FALLING_EDGE() __HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_RISING_EDGE();__HAL_RTC_TAMPER_TIMESTAMP_EXTI_ENABLE_FALLING_EDGE(); |
| |
| /** |
| * @brief Disable rising & falling edge trigger on the RTC Tamper and Timestamp associated Exti line. |
| * This parameter can be: |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_RISING_FALLING_EDGE() __HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_RISING_EDGE();__HAL_RTC_TAMPER_TIMESTAMP_EXTI_DISABLE_FALLING_EDGE(); |
| |
| /** |
| * @brief Check whether the RTC Tamper and Timestamp associated Exti line interrupt flag is set or not. |
| * @retval Line Status. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_GET_FLAG() (EXTI->PR & RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Clear the RTC Tamper and Timestamp associated Exti line flag. |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_CLEAR_FLAG() (EXTI->PR = RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| |
| /** |
| * @brief Generate a Software interrupt on the RTC Tamper and Timestamp associated Exti line |
| * @retval None. |
| */ |
| #define __HAL_RTC_TAMPER_TIMESTAMP_EXTI_GENERATE_SWIT() (EXTI->SWIER |= RTC_EXTI_LINE_TAMPER_TIMESTAMP_EVENT) |
| /** |
| * @} |
| */ |
| |
| /* ------------------------------Calibration----------------------------------*/ |
| /** @defgroup RTCEx_Calibration RTC Extended Calibration |
| * @{ |
| */ |
| |
| /** |
| * @brief Enable the RTC calibration output. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_CALIBRATION_OUTPUT_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_COE)) |
| |
| /** |
| * @brief Disable the calibration output. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_CALIBRATION_OUTPUT_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_COE)) |
| |
| /** |
| * @brief Enable the clock reference detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_CLOCKREF_DETECTION_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_REFCKON)) |
| |
| /** |
| * @brief Disable the clock reference detection. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @retval None |
| */ |
| #define __HAL_RTC_CLOCKREF_DETECTION_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_REFCKON)) |
| |
| /** |
| * @brief Get the selected RTC shift operation's flag status. |
| * @param __HANDLE__: specifies the RTC handle. |
| * @param __FLAG__: specifies the RTC shift operation Flag is pending or not. |
| * This parameter can be: |
| * @arg RTC_FLAG_SHPF |
| * @retval None |
| */ |
| #define __HAL_RTC_SHIFT_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET) |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /* Exported functions --------------------------------------------------------*/ |
| /** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions |
| * @{ |
| */ |
| |
| /* RTC TimeStamp and Tamper functions *****************************************/ |
| /** @defgroup RTCEx_Exported_Functions_Group1 Extended RTC TimeStamp and Tamper functions |
| * @{ |
| */ |
| |
| HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp(RTC_HandleTypeDef *hrtc, uint32_t TimeStampEdge, uint32_t RTC_TimeStampPin); |
| HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp_IT(RTC_HandleTypeDef *hrtc, uint32_t TimeStampEdge, uint32_t RTC_TimeStampPin); |
| HAL_StatusTypeDef HAL_RTCEx_DeactivateTimeStamp(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_GetTimeStamp(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTimeStamp, RTC_DateTypeDef *sTimeStampDate, uint32_t Format); |
| |
| HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper); |
| HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper); |
| HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper); |
| void HAL_RTCEx_TamperTimeStampIRQHandler(RTC_HandleTypeDef *hrtc); |
| |
| void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc); |
| void HAL_RTCEx_Tamper2EventCallback(RTC_HandleTypeDef *hrtc); |
| void HAL_RTCEx_Tamper3EventCallback(RTC_HandleTypeDef *hrtc); |
| void HAL_RTCEx_TimeStampEventCallback(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_PollForTimeStampEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| HAL_StatusTypeDef HAL_RTCEx_PollForTamper2Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| HAL_StatusTypeDef HAL_RTCEx_PollForTamper3Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| /** |
| * @} |
| */ |
| |
| /* RTC Wake-up functions ******************************************************/ |
| /** @defgroup RTCEx_Exported_Functions_Group2 Extended RTC Wake-up functions |
| * @{ |
| */ |
| |
| HAL_StatusTypeDef HAL_RTCEx_SetWakeUpTimer(RTC_HandleTypeDef *hrtc, uint32_t WakeUpCounter, uint32_t WakeUpClock); |
| HAL_StatusTypeDef HAL_RTCEx_SetWakeUpTimer_IT(RTC_HandleTypeDef *hrtc, uint32_t WakeUpCounter, uint32_t WakeUpClock); |
| uint32_t HAL_RTCEx_DeactivateWakeUpTimer(RTC_HandleTypeDef *hrtc); |
| uint32_t HAL_RTCEx_GetWakeUpTimer(RTC_HandleTypeDef *hrtc); |
| void HAL_RTCEx_WakeUpTimerIRQHandler(RTC_HandleTypeDef *hrtc); |
| void HAL_RTCEx_WakeUpTimerEventCallback(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_PollForWakeUpTimerEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| /** |
| * @} |
| */ |
| |
| /* Extended Control functions ************************************************/ |
| /** @defgroup RTCEx_Exported_Functions_Group3 Extended Peripheral Control functions |
| * @{ |
| */ |
| |
| void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data); |
| uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister); |
| |
| HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef *hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmoothCalibMinusPulsesValue); |
| HAL_StatusTypeDef HAL_RTCEx_SetSynchroShift(RTC_HandleTypeDef *hrtc, uint32_t ShiftAdd1S, uint32_t ShiftSubFS); |
| HAL_StatusTypeDef HAL_RTCEx_SetCalibrationOutPut(RTC_HandleTypeDef *hrtc, uint32_t CalibOutput); |
| HAL_StatusTypeDef HAL_RTCEx_DeactivateCalibrationOutPut(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_SetRefClock(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_DeactivateRefClock(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_EnableBypassShadow(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_DisableBypassShadow(RTC_HandleTypeDef *hrtc); |
| /** |
| * @} |
| */ |
| |
| /* Extended RTC features functions *******************************************/ |
| /** @defgroup RTCEx_Exported_Functions_Group4 Extended features functions |
| * @{ |
| */ |
| void HAL_RTCEx_AlarmBEventCallback(RTC_HandleTypeDef *hrtc); |
| HAL_StatusTypeDef HAL_RTCEx_PollForAlarmBEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout); |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /* Private types -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private constants ---------------------------------------------------------*/ |
| /* Private macros ------------------------------------------------------------*/ |
| /** @defgroup RTCEx_Private_Macros RTCEx Private Macros |
| * @{ |
| */ |
| |
| /** @defgroup RTCEx_IS_RTC_Definitions Private macros to check input parameters |
| * @{ |
| */ |
| #define IS_RTC_OUTPUT(OUTPUT) (((OUTPUT) == RTC_OUTPUT_DISABLE) || \ |
| ((OUTPUT) == RTC_OUTPUT_ALARMA) || \ |
| ((OUTPUT) == RTC_OUTPUT_ALARMB) || \ |
| ((OUTPUT) == RTC_OUTPUT_WAKEUP)) |
| |
| #define IS_RTC_BKP(BKP) ((BKP) < (uint32_t) RTC_BKP_NUMBER) |
| |
| #define IS_TIMESTAMP_EDGE(EDGE) (((EDGE) == RTC_TIMESTAMPEDGE_RISING) || \ |
| ((EDGE) == RTC_TIMESTAMPEDGE_FALLING)) |
| |
| #define IS_RTC_TAMPER(TAMPER) ((((TAMPER) & 0xFFFFFFD6U) == 0x00U) && ((TAMPER) != (uint32_t)RESET)) |
| |
| |
| #define IS_RTC_TIMESTAMP_PIN(PIN) (((PIN) == RTC_TIMESTAMPPIN_DEFAULT)) |
| |
| |
| #define IS_RTC_TAMPER_TRIGGER(TRIGGER) (((TRIGGER) == RTC_TAMPERTRIGGER_RISINGEDGE) || \ |
| ((TRIGGER) == RTC_TAMPERTRIGGER_FALLINGEDGE) || \ |
| ((TRIGGER) == RTC_TAMPERTRIGGER_LOWLEVEL) || \ |
| ((TRIGGER) == RTC_TAMPERTRIGGER_HIGHLEVEL)) |
| #define IS_RTC_TAMPER_FILTER(FILTER) (((FILTER) == RTC_TAMPERFILTER_DISABLE) || \ |
| ((FILTER) == RTC_TAMPERFILTER_2SAMPLE) || \ |
| ((FILTER) == RTC_TAMPERFILTER_4SAMPLE) || \ |
| ((FILTER) == RTC_TAMPERFILTER_8SAMPLE)) |
| #define IS_RTC_TAMPER_SAMPLING_FREQ(FREQ) (((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV32768)|| \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV16384)|| \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV8192) || \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV4096) || \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV2048) || \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV1024) || \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV512) || \ |
| ((FREQ) == RTC_TAMPERSAMPLINGFREQ_RTCCLK_DIV256)) |
| #define IS_RTC_TAMPER_PRECHARGE_DURATION(DURATION) (((DURATION) == RTC_TAMPERPRECHARGEDURATION_1RTCCLK) || \ |
| ((DURATION) == RTC_TAMPERPRECHARGEDURATION_2RTCCLK) || \ |
| ((DURATION) == RTC_TAMPERPRECHARGEDURATION_4RTCCLK) || \ |
| ((DURATION) == RTC_TAMPERPRECHARGEDURATION_8RTCCLK)) |
| #define IS_RTC_TAMPER_TIMESTAMPONTAMPER_DETECTION(DETECTION) (((DETECTION) == RTC_TIMESTAMPONTAMPERDETECTION_ENABLE) || \ |
| ((DETECTION) == RTC_TIMESTAMPONTAMPERDETECTION_DISABLE)) |
| #define IS_RTC_TAMPER_PULLUP_STATE(STATE) (((STATE) == RTC_TAMPER_PULLUP_ENABLE) || \ |
| ((STATE) == RTC_TAMPER_PULLUP_DISABLE)) |
| #define IS_RTC_WAKEUP_CLOCK(CLOCK) (((CLOCK) == RTC_WAKEUPCLOCK_RTCCLK_DIV16) || \ |
| ((CLOCK) == RTC_WAKEUPCLOCK_RTCCLK_DIV8) || \ |
| ((CLOCK) == RTC_WAKEUPCLOCK_RTCCLK_DIV4) || \ |
| ((CLOCK) == RTC_WAKEUPCLOCK_RTCCLK_DIV2) || \ |
| ((CLOCK) == RTC_WAKEUPCLOCK_CK_SPRE_16BITS) || \ |
| ((CLOCK) == RTC_WAKEUPCLOCK_CK_SPRE_17BITS)) |
| |
| #define IS_RTC_WAKEUP_COUNTER(COUNTER) ((COUNTER) <= 0xFFFFU) |
| |
| |
| #define IS_RTC_SMOOTH_CALIB_PERIOD(PERIOD) (((PERIOD) == RTC_SMOOTHCALIB_PERIOD_32SEC) || \ |
| ((PERIOD) == RTC_SMOOTHCALIB_PERIOD_16SEC) || \ |
| ((PERIOD) == RTC_SMOOTHCALIB_PERIOD_8SEC)) |
| #define IS_RTC_SMOOTH_CALIB_PLUS(PLUS) (((PLUS) == RTC_SMOOTHCALIB_PLUSPULSES_SET) || \ |
| ((PLUS) == RTC_SMOOTHCALIB_PLUSPULSES_RESET)) |
| |
| |
| #define IS_RTC_SMOOTH_CALIB_MINUS(VALUE) ((VALUE) <= 0x000001FFU) |
| #define IS_RTC_SHIFT_ADD1S(SEL) (((SEL) == RTC_SHIFTADD1S_RESET) || \ |
| ((SEL) == RTC_SHIFTADD1S_SET)) |
| #define IS_RTC_SHIFT_SUBFS(FS) ((FS) <= 0x00007FFFU) |
| #define IS_RTC_CALIB_OUTPUT(OUTPUT) (((OUTPUT) == RTC_CALIBOUTPUT_512HZ) || \ |
| ((OUTPUT) == RTC_CALIBOUTPUT_1HZ)) |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* __STM32F3xx_HAL_RTC_EX_H */ |
| |
| /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |