mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

targets/TARGET_STM/TARGET_STM32F1/device/stm32f1xx_hal_rtc_ex.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
187:0387e8f68319 
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 144:ef7eb2e8f9f7 1 /**
<> 144:ef7eb2e8f9f7 2 ******************************************************************************
<> 144:ef7eb2e8f9f7 3 * @file stm32f1xx_hal_rtc_ex.h
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
<> 144:ef7eb2e8f9f7 5 * @brief Header file of RTC HAL Extension module.
<> 144:ef7eb2e8f9f7 6 ******************************************************************************
<> 144:ef7eb2e8f9f7 7 * @attention
<> 144:ef7eb2e8f9f7 8 *
<> 144:ef7eb2e8f9f7 9 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 10 *
<> 144:ef7eb2e8f9f7 11 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 12 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 13 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 14 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 16 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 17 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 19 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 20 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 21 *
<> 144:ef7eb2e8f9f7 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 32 *
<> 144:ef7eb2e8f9f7 33 ******************************************************************************
<> 144:ef7eb2e8f9f7 34 */
<> 144:ef7eb2e8f9f7 35
<> 144:ef7eb2e8f9f7 36 /* Define to prevent recursive inclusion -------------------------------------*/
<> 144:ef7eb2e8f9f7 37 #ifndef __STM32F1xx_HAL_RTC_EX_H
<> 144:ef7eb2e8f9f7 38 #define __STM32F1xx_HAL_RTC_EX_H
<> 144:ef7eb2e8f9f7 39
<> 144:ef7eb2e8f9f7 40 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 41 extern "C" {
<> 144:ef7eb2e8f9f7 42 #endif
<> 144:ef7eb2e8f9f7 43
<> 144:ef7eb2e8f9f7 44 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 45 #include "stm32f1xx_hal_def.h"
<> 144:ef7eb2e8f9f7 46
<> 144:ef7eb2e8f9f7 47 /** @addtogroup STM32F1xx_HAL_Driver
<> 144:ef7eb2e8f9f7 48 * @{
<> 144:ef7eb2e8f9f7 49 */
<> 144:ef7eb2e8f9f7 50
<> 144:ef7eb2e8f9f7 51 /** @addtogroup RTCEx
<> 144:ef7eb2e8f9f7 52 * @{
<> 144:ef7eb2e8f9f7 53 */
<> 144:ef7eb2e8f9f7 54
<> 144:ef7eb2e8f9f7 55 /** @addtogroup RTCEx_Private_Macros
<> 144:ef7eb2e8f9f7 56 * @{
<> 144:ef7eb2e8f9f7 57 */
<> 144:ef7eb2e8f9f7 58
<> 144:ef7eb2e8f9f7 59 /** @defgroup RTCEx_Alias_For_Legacy Alias define maintained for legacy
<> 144:ef7eb2e8f9f7 60 * @{
<> 144:ef7eb2e8f9f7 61 */
<> 144:ef7eb2e8f9f7 62 #define HAL_RTCEx_TamperTimeStampIRQHandler HAL_RTCEx_TamperIRQHandler
<> 144:ef7eb2e8f9f7 63
<> 144:ef7eb2e8f9f7 64 /**
<> 144:ef7eb2e8f9f7 65 * @}
<> 144:ef7eb2e8f9f7 66 */
<> 144:ef7eb2e8f9f7 67
<> 144:ef7eb2e8f9f7 68 /** @defgroup RTCEx_IS_RTC_Definitions Private macros to check input parameters
<> 144:ef7eb2e8f9f7 69 * @{
<> 144:ef7eb2e8f9f7 70 */
<> 144:ef7eb2e8f9f7 71 #define IS_RTC_TAMPER(__TAMPER__) ((__TAMPER__) == RTC_TAMPER_1)
<> 144:ef7eb2e8f9f7 72
<> 144:ef7eb2e8f9f7 73 #define IS_RTC_TAMPER_TRIGGER(__TRIGGER__) (((__TRIGGER__) == RTC_TAMPERTRIGGER_LOWLEVEL) || \
AnnaBridge 165:e614a9f1c9e2 74 ((__TRIGGER__) == RTC_TAMPERTRIGGER_HIGHLEVEL))
<> 144:ef7eb2e8f9f7 75
AnnaBridge 165:e614a9f1c9e2 76 #if RTC_BKP_NUMBER > 10U
AnnaBridge 165:e614a9f1c9e2 77 #define IS_RTC_BKP(BKP) (((BKP) <= (uint32_t)RTC_BKP_DR10) || (((BKP) >= (uint32_t)RTC_BKP_DR11) && ((BKP) <= (uint32_t)RTC_BKP_DR42)))
<> 144:ef7eb2e8f9f7 78 #else
AnnaBridge 165:e614a9f1c9e2 79 #define IS_RTC_BKP(BKP) ((BKP) <= (uint32_t)RTC_BKP_NUMBER)
<> 144:ef7eb2e8f9f7 80 #endif
AnnaBridge 165:e614a9f1c9e2 81 #define IS_RTC_SMOOTH_CALIB_MINUS(__VALUE__) ((__VALUE__) <= 0x0000007FU)
<> 144:ef7eb2e8f9f7 82
<> 144:ef7eb2e8f9f7 83 /**
<> 144:ef7eb2e8f9f7 84 * @}
<> 144:ef7eb2e8f9f7 85 */
<> 144:ef7eb2e8f9f7 86
<> 144:ef7eb2e8f9f7 87 /**
<> 144:ef7eb2e8f9f7 88 * @}
<> 144:ef7eb2e8f9f7 89 */
<> 144:ef7eb2e8f9f7 90
<> 144:ef7eb2e8f9f7 91 /* Exported types ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 92 /** @defgroup RTCEx_Exported_Types RTCEx Exported Types
<> 144:ef7eb2e8f9f7 93 * @{
<> 144:ef7eb2e8f9f7 94 */
<> 144:ef7eb2e8f9f7 95 /**
<> 144:ef7eb2e8f9f7 96 * @brief RTC Tamper structure definition
<> 144:ef7eb2e8f9f7 97 */
<> 144:ef7eb2e8f9f7 98 typedef struct
<> 144:ef7eb2e8f9f7 99 {
<> 144:ef7eb2e8f9f7 100 uint32_t Tamper; /*!< Specifies the Tamper Pin.
<> 144:ef7eb2e8f9f7 101 This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions */
<> 144:ef7eb2e8f9f7 102
<> 144:ef7eb2e8f9f7 103 uint32_t Trigger; /*!< Specifies the Tamper Trigger.
<> 144:ef7eb2e8f9f7 104 This parameter can be a value of @ref RTCEx_Tamper_Trigger_Definitions */
<> 144:ef7eb2e8f9f7 105
<> 144:ef7eb2e8f9f7 106 }RTC_TamperTypeDef;
<> 144:ef7eb2e8f9f7 107
<> 144:ef7eb2e8f9f7 108 /**
<> 144:ef7eb2e8f9f7 109 * @}
<> 144:ef7eb2e8f9f7 110 */
<> 144:ef7eb2e8f9f7 111
<> 144:ef7eb2e8f9f7 112 /* Exported constants --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 113 /** @defgroup RTCEx_Exported_Constants RTCEx Exported Constants
<> 144:ef7eb2e8f9f7 114 * @{
<> 144:ef7eb2e8f9f7 115 */
<> 144:ef7eb2e8f9f7 116
<> 144:ef7eb2e8f9f7 117 /** @defgroup RTCEx_Tamper_Pins_Definitions Tamper Pins Definitions
<> 144:ef7eb2e8f9f7 118 * @{
<> 144:ef7eb2e8f9f7 119 */
<> 144:ef7eb2e8f9f7 120 #define RTC_TAMPER_1 BKP_CR_TPE /*!< Select tamper to be enabled (mainly for legacy purposes) */
<> 144:ef7eb2e8f9f7 121
<> 144:ef7eb2e8f9f7 122 /**
<> 144:ef7eb2e8f9f7 123 * @}
<> 144:ef7eb2e8f9f7 124 */
<> 144:ef7eb2e8f9f7 125
<> 144:ef7eb2e8f9f7 126 /** @defgroup RTCEx_Tamper_Trigger_Definitions Tamper Trigger Definitions
<> 144:ef7eb2e8f9f7 127 * @{
<> 144:ef7eb2e8f9f7 128 */
<> 144:ef7eb2e8f9f7 129 #define RTC_TAMPERTRIGGER_LOWLEVEL BKP_CR_TPAL /*!< A high level on the TAMPER pin resets all data backup registers (if TPE bit is set) */
AnnaBridge 165:e614a9f1c9e2 130 #define RTC_TAMPERTRIGGER_HIGHLEVEL 0x00000000U /*!< A low level on the TAMPER pin resets all data backup registers (if TPE bit is set) */
<> 144:ef7eb2e8f9f7 131
<> 144:ef7eb2e8f9f7 132 /**
<> 144:ef7eb2e8f9f7 133 * @}
<> 144:ef7eb2e8f9f7 134 */
<> 144:ef7eb2e8f9f7 135
<> 144:ef7eb2e8f9f7 136 /** @defgroup RTCEx_Backup_Registers_Definitions Backup Registers Definitions
<> 144:ef7eb2e8f9f7 137 * @{
<> 144:ef7eb2e8f9f7 138 */
AnnaBridge 165:e614a9f1c9e2 139 #if RTC_BKP_NUMBER > 0U
AnnaBridge 165:e614a9f1c9e2 140 #define RTC_BKP_DR1 0x00000001U
AnnaBridge 165:e614a9f1c9e2 141 #define RTC_BKP_DR2 0x00000002U
AnnaBridge 165:e614a9f1c9e2 142 #define RTC_BKP_DR3 0x00000003U
AnnaBridge 165:e614a9f1c9e2 143 #define RTC_BKP_DR4 0x00000004U
AnnaBridge 165:e614a9f1c9e2 144 #define RTC_BKP_DR5 0x00000005U
AnnaBridge 165:e614a9f1c9e2 145 #define RTC_BKP_DR6 0x00000006U
AnnaBridge 165:e614a9f1c9e2 146 #define RTC_BKP_DR7 0x00000007U
AnnaBridge 165:e614a9f1c9e2 147 #define RTC_BKP_DR8 0x00000008U
AnnaBridge 165:e614a9f1c9e2 148 #define RTC_BKP_DR9 0x00000009U
AnnaBridge 165:e614a9f1c9e2 149 #define RTC_BKP_DR10 0x0000000AU
<> 144:ef7eb2e8f9f7 150 #endif /* RTC_BKP_NUMBER > 0 */
<> 144:ef7eb2e8f9f7 151
AnnaBridge 165:e614a9f1c9e2 152 #if RTC_BKP_NUMBER > 10U
AnnaBridge 165:e614a9f1c9e2 153 #define RTC_BKP_DR11 0x00000010U
AnnaBridge 165:e614a9f1c9e2 154 #define RTC_BKP_DR12 0x00000011U
AnnaBridge 165:e614a9f1c9e2 155 #define RTC_BKP_DR13 0x00000012U
AnnaBridge 165:e614a9f1c9e2 156 #define RTC_BKP_DR14 0x00000013U
AnnaBridge 165:e614a9f1c9e2 157 #define RTC_BKP_DR15 0x00000014U
AnnaBridge 165:e614a9f1c9e2 158 #define RTC_BKP_DR16 0x00000015U
AnnaBridge 165:e614a9f1c9e2 159 #define RTC_BKP_DR17 0x00000016U
AnnaBridge 165:e614a9f1c9e2 160 #define RTC_BKP_DR18 0x00000017U
AnnaBridge 165:e614a9f1c9e2 161 #define RTC_BKP_DR19 0x00000018U
AnnaBridge 165:e614a9f1c9e2 162 #define RTC_BKP_DR20 0x00000019U
AnnaBridge 165:e614a9f1c9e2 163 #define RTC_BKP_DR21 0x0000001AU
AnnaBridge 165:e614a9f1c9e2 164 #define RTC_BKP_DR22 0x0000001BU
AnnaBridge 165:e614a9f1c9e2 165 #define RTC_BKP_DR23 0x0000001CU
AnnaBridge 165:e614a9f1c9e2 166 #define RTC_BKP_DR24 0x0000001DU
AnnaBridge 165:e614a9f1c9e2 167 #define RTC_BKP_DR25 0x0000001EU
AnnaBridge 165:e614a9f1c9e2 168 #define RTC_BKP_DR26 0x0000001FU
AnnaBridge 165:e614a9f1c9e2 169 #define RTC_BKP_DR27 0x00000020U
AnnaBridge 165:e614a9f1c9e2 170 #define RTC_BKP_DR28 0x00000021U
AnnaBridge 165:e614a9f1c9e2 171 #define RTC_BKP_DR29 0x00000022U
AnnaBridge 165:e614a9f1c9e2 172 #define RTC_BKP_DR30 0x00000023U
AnnaBridge 165:e614a9f1c9e2 173 #define RTC_BKP_DR31 0x00000024U
AnnaBridge 165:e614a9f1c9e2 174 #define RTC_BKP_DR32 0x00000025U
AnnaBridge 165:e614a9f1c9e2 175 #define RTC_BKP_DR33 0x00000026U
AnnaBridge 165:e614a9f1c9e2 176 #define RTC_BKP_DR34 0x00000027U
AnnaBridge 165:e614a9f1c9e2 177 #define RTC_BKP_DR35 0x00000028U
AnnaBridge 165:e614a9f1c9e2 178 #define RTC_BKP_DR36 0x00000029U
AnnaBridge 165:e614a9f1c9e2 179 #define RTC_BKP_DR37 0x0000002AU
AnnaBridge 165:e614a9f1c9e2 180 #define RTC_BKP_DR38 0x0000002BU
AnnaBridge 165:e614a9f1c9e2 181 #define RTC_BKP_DR39 0x0000002CU
AnnaBridge 165:e614a9f1c9e2 182 #define RTC_BKP_DR40 0x0000002DU
AnnaBridge 165:e614a9f1c9e2 183 #define RTC_BKP_DR41 0x0000002EU
AnnaBridge 165:e614a9f1c9e2 184 #define RTC_BKP_DR42 0x0000002FU
<> 144:ef7eb2e8f9f7 185 #endif /* RTC_BKP_NUMBER > 10 */
<> 144:ef7eb2e8f9f7 186
<> 144:ef7eb2e8f9f7 187 /**
<> 144:ef7eb2e8f9f7 188 * @}
<> 144:ef7eb2e8f9f7 189 */
<> 144:ef7eb2e8f9f7 190
<> 144:ef7eb2e8f9f7 191 /**
<> 144:ef7eb2e8f9f7 192 * @}
<> 144:ef7eb2e8f9f7 193 */
<> 144:ef7eb2e8f9f7 194
<> 144:ef7eb2e8f9f7 195 /* Exported macro ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 196 /** @defgroup RTCEx_Exported_Macros RTCEx Exported Macros
<> 144:ef7eb2e8f9f7 197 * @{
<> 144:ef7eb2e8f9f7 198 */
<> 144:ef7eb2e8f9f7 199
<> 144:ef7eb2e8f9f7 200 /**
<> 144:ef7eb2e8f9f7 201 * @brief Enable the RTC Tamper interrupt.
<> 144:ef7eb2e8f9f7 202 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 203 * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be enabled
<> 144:ef7eb2e8f9f7 204 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 205 * @arg RTC_IT_TAMP1: Tamper A interrupt
<> 144:ef7eb2e8f9f7 206 * @retval None
<> 144:ef7eb2e8f9f7 207 */
<> 144:ef7eb2e8f9f7 208 #define __HAL_RTC_TAMPER_ENABLE_IT(__HANDLE__, __INTERRUPT__) SET_BIT(BKP->CSR, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 209
<> 144:ef7eb2e8f9f7 210 /**
<> 144:ef7eb2e8f9f7 211 * @brief Disable the RTC Tamper interrupt.
<> 144:ef7eb2e8f9f7 212 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 213 * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be disabled.
<> 144:ef7eb2e8f9f7 214 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 215 * @arg RTC_IT_TAMP1: Tamper A interrupt
<> 144:ef7eb2e8f9f7 216 * @retval None
<> 144:ef7eb2e8f9f7 217 */
<> 144:ef7eb2e8f9f7 218 #define __HAL_RTC_TAMPER_DISABLE_IT(__HANDLE__, __INTERRUPT__) CLEAR_BIT(BKP->CSR, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 219
<> 144:ef7eb2e8f9f7 220 /**
<> 144:ef7eb2e8f9f7 221 * @brief Check whether the specified RTC Tamper interrupt has been enabled or not.
<> 144:ef7eb2e8f9f7 222 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 223 * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be checked.
<> 144:ef7eb2e8f9f7 224 * This parameter can be:
<> 144:ef7eb2e8f9f7 225 * @arg RTC_IT_TAMP1
<> 144:ef7eb2e8f9f7 226 * @retval None
<> 144:ef7eb2e8f9f7 227 */
<> 144:ef7eb2e8f9f7 228 #define __HAL_RTC_TAMPER_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((BKP->CSR) & ((__INTERRUPT__))) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 229
<> 144:ef7eb2e8f9f7 230 /**
<> 144:ef7eb2e8f9f7 231 * @brief Get the selected RTC Tamper's flag status.
<> 144:ef7eb2e8f9f7 232 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 233 * @param __FLAG__: specifies the RTC Tamper Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 234 * This parameter can be:
<> 144:ef7eb2e8f9f7 235 * @arg RTC_FLAG_TAMP1F
<> 144:ef7eb2e8f9f7 236 * @retval None
<> 144:ef7eb2e8f9f7 237 */
<> 144:ef7eb2e8f9f7 238 #define __HAL_RTC_TAMPER_GET_FLAG(__HANDLE__, __FLAG__) ((((BKP->CSR) & (__FLAG__)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 239
<> 144:ef7eb2e8f9f7 240 /**
<> 144:ef7eb2e8f9f7 241 * @brief Get the selected RTC Tamper's flag status.
<> 144:ef7eb2e8f9f7 242 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 243 * @param __INTERRUPT__: specifies the RTC Tamper interrupt sources to be checked.
<> 144:ef7eb2e8f9f7 244 * This parameter can be:
<> 144:ef7eb2e8f9f7 245 * @arg RTC_IT_TAMP1
<> 144:ef7eb2e8f9f7 246 * @retval None
<> 144:ef7eb2e8f9f7 247 */
<> 144:ef7eb2e8f9f7 248 #define __HAL_RTC_TAMPER_GET_IT(__HANDLE__, __INTERRUPT__) ((((BKP->CSR) & (BKP_CSR_TEF)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 249
<> 144:ef7eb2e8f9f7 250 /**
<> 144:ef7eb2e8f9f7 251 * @brief Clear the RTC Tamper's pending flags.
<> 144:ef7eb2e8f9f7 252 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 253 * @param __FLAG__: specifies the RTC Tamper Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 254 * This parameter can be:
<> 144:ef7eb2e8f9f7 255 * @arg RTC_FLAG_TAMP1F
<> 144:ef7eb2e8f9f7 256 * @retval None
<> 144:ef7eb2e8f9f7 257 */
<> 144:ef7eb2e8f9f7 258 #define __HAL_RTC_TAMPER_CLEAR_FLAG(__HANDLE__, __FLAG__) SET_BIT(BKP->CSR, BKP_CSR_CTE | BKP_CSR_CTI)
<> 144:ef7eb2e8f9f7 259
<> 144:ef7eb2e8f9f7 260 /**
<> 144:ef7eb2e8f9f7 261 * @brief Enable the RTC Second interrupt.
<> 144:ef7eb2e8f9f7 262 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 263 * @param __INTERRUPT__: specifies the RTC Second interrupt sources to be enabled
<> 144:ef7eb2e8f9f7 264 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 265 * @arg RTC_IT_SEC: Second A interrupt
<> 144:ef7eb2e8f9f7 266 * @retval None
<> 144:ef7eb2e8f9f7 267 */
<> 144:ef7eb2e8f9f7 268 #define __HAL_RTC_SECOND_ENABLE_IT(__HANDLE__, __INTERRUPT__) SET_BIT((__HANDLE__)->Instance->CRH, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 269
<> 144:ef7eb2e8f9f7 270 /**
<> 144:ef7eb2e8f9f7 271 * @brief Disable the RTC Second interrupt.
<> 144:ef7eb2e8f9f7 272 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 273 * @param __INTERRUPT__: specifies the RTC Second interrupt sources to be disabled.
<> 144:ef7eb2e8f9f7 274 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 275 * @arg RTC_IT_SEC: Second A interrupt
<> 144:ef7eb2e8f9f7 276 * @retval None
<> 144:ef7eb2e8f9f7 277 */
<> 144:ef7eb2e8f9f7 278 #define __HAL_RTC_SECOND_DISABLE_IT(__HANDLE__, __INTERRUPT__) CLEAR_BIT((__HANDLE__)->Instance->CRH, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 279
<> 144:ef7eb2e8f9f7 280 /**
<> 144:ef7eb2e8f9f7 281 * @brief Check whether the specified RTC Second interrupt has occurred or not.
<> 144:ef7eb2e8f9f7 282 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 283 * @param __INTERRUPT__: specifies the RTC Second interrupt sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 284 * This parameter can be:
<> 144:ef7eb2e8f9f7 285 * @arg RTC_IT_SEC: Second A interrupt
<> 144:ef7eb2e8f9f7 286 * @retval None
<> 144:ef7eb2e8f9f7 287 */
<> 144:ef7eb2e8f9f7 288 #define __HAL_RTC_SECOND_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((((__HANDLE__)->Instance->CRH)& ((__INTERRUPT__)))) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 289
<> 144:ef7eb2e8f9f7 290 /**
<> 144:ef7eb2e8f9f7 291 * @brief Get the selected RTC Second's flag status.
<> 144:ef7eb2e8f9f7 292 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 293 * @param __FLAG__: specifies the RTC Second Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 294 * This parameter can be:
<> 144:ef7eb2e8f9f7 295 * @arg RTC_FLAG_SEC
<> 144:ef7eb2e8f9f7 296 * @retval None
<> 144:ef7eb2e8f9f7 297 */
<> 144:ef7eb2e8f9f7 298 #define __HAL_RTC_SECOND_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->CRL) & (__FLAG__)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 299
<> 144:ef7eb2e8f9f7 300 /**
<> 144:ef7eb2e8f9f7 301 * @brief Clear the RTC Second's pending flags.
<> 144:ef7eb2e8f9f7 302 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 303 * @param __FLAG__: specifies the RTC Second Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 304 * This parameter can be:
<> 144:ef7eb2e8f9f7 305 * @arg RTC_FLAG_SEC
<> 144:ef7eb2e8f9f7 306 * @retval None
<> 144:ef7eb2e8f9f7 307 */
<> 144:ef7eb2e8f9f7 308 #define __HAL_RTC_SECOND_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->CRL) = ~(__FLAG__)
<> 144:ef7eb2e8f9f7 309
<> 144:ef7eb2e8f9f7 310 /**
<> 144:ef7eb2e8f9f7 311 * @brief Enable the RTC Overflow interrupt.
<> 144:ef7eb2e8f9f7 312 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 313 * @param __INTERRUPT__: specifies the RTC Overflow interrupt sources to be enabled
<> 144:ef7eb2e8f9f7 314 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 315 * @arg RTC_IT_OW: Overflow A interrupt
<> 144:ef7eb2e8f9f7 316 * @retval None
<> 144:ef7eb2e8f9f7 317 */
<> 144:ef7eb2e8f9f7 318 #define __HAL_RTC_OVERFLOW_ENABLE_IT(__HANDLE__, __INTERRUPT__) SET_BIT((__HANDLE__)->Instance->CRH, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 319
<> 144:ef7eb2e8f9f7 320 /**
<> 144:ef7eb2e8f9f7 321 * @brief Disable the RTC Overflow interrupt.
<> 144:ef7eb2e8f9f7 322 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 323 * @param __INTERRUPT__: specifies the RTC Overflow interrupt sources to be disabled.
<> 144:ef7eb2e8f9f7 324 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 325 * @arg RTC_IT_OW: Overflow A interrupt
<> 144:ef7eb2e8f9f7 326 * @retval None
<> 144:ef7eb2e8f9f7 327 */
<> 144:ef7eb2e8f9f7 328 #define __HAL_RTC_OVERFLOW_DISABLE_IT(__HANDLE__, __INTERRUPT__) CLEAR_BIT((__HANDLE__)->Instance->CRH, (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 329
<> 144:ef7eb2e8f9f7 330 /**
<> 144:ef7eb2e8f9f7 331 * @brief Check whether the specified RTC Overflow interrupt has occurred or not.
<> 144:ef7eb2e8f9f7 332 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 333 * @param __INTERRUPT__: specifies the RTC Overflow interrupt sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 334 * This parameter can be:
<> 144:ef7eb2e8f9f7 335 * @arg RTC_IT_OW: Overflow A interrupt
<> 144:ef7eb2e8f9f7 336 * @retval None
<> 144:ef7eb2e8f9f7 337 */
<> 144:ef7eb2e8f9f7 338 #define __HAL_RTC_OVERFLOW_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((((__HANDLE__)->Instance->CRH)& ((__INTERRUPT__))) ) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 339
<> 144:ef7eb2e8f9f7 340 /**
<> 144:ef7eb2e8f9f7 341 * @brief Get the selected RTC Overflow's flag status.
<> 144:ef7eb2e8f9f7 342 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 343 * @param __FLAG__: specifies the RTC Overflow Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 344 * This parameter can be:
<> 144:ef7eb2e8f9f7 345 * @arg RTC_FLAG_OW
<> 144:ef7eb2e8f9f7 346 * @retval None
<> 144:ef7eb2e8f9f7 347 */
<> 144:ef7eb2e8f9f7 348 #define __HAL_RTC_OVERFLOW_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->CRL) & (__FLAG__)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 349
<> 144:ef7eb2e8f9f7 350 /**
<> 144:ef7eb2e8f9f7 351 * @brief Clear the RTC Overflow's pending flags.
<> 144:ef7eb2e8f9f7 352 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 353 * @param __FLAG__: specifies the RTC Overflow Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 354 * This parameter can be:
<> 144:ef7eb2e8f9f7 355 * @arg RTC_FLAG_OW
<> 144:ef7eb2e8f9f7 356 * @retval None
<> 144:ef7eb2e8f9f7 357 */
<> 144:ef7eb2e8f9f7 358 #define __HAL_RTC_OVERFLOW_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->CRL) = ~(__FLAG__)
<> 144:ef7eb2e8f9f7 359
<> 144:ef7eb2e8f9f7 360 /**
<> 144:ef7eb2e8f9f7 361 * @}
<> 144:ef7eb2e8f9f7 362 */
<> 144:ef7eb2e8f9f7 363
<> 144:ef7eb2e8f9f7 364 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 365 /** @addtogroup RTCEx_Exported_Functions
<> 144:ef7eb2e8f9f7 366 * @{
<> 144:ef7eb2e8f9f7 367 */
<> 144:ef7eb2e8f9f7 368
<> 144:ef7eb2e8f9f7 369 /* RTC Tamper functions *****************************************/
<> 144:ef7eb2e8f9f7 370 /** @addtogroup RTCEx_Exported_Functions_Group1
<> 144:ef7eb2e8f9f7 371 * @{
<> 144:ef7eb2e8f9f7 372 */
<> 144:ef7eb2e8f9f7 373 HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper);
<> 144:ef7eb2e8f9f7 374 HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper);
<> 144:ef7eb2e8f9f7 375 HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper);
<> 144:ef7eb2e8f9f7 376 void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 377 void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 378 HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout);
<> 144:ef7eb2e8f9f7 379
<> 144:ef7eb2e8f9f7 380 /**
<> 144:ef7eb2e8f9f7 381 * @}
<> 144:ef7eb2e8f9f7 382 */
<> 144:ef7eb2e8f9f7 383
<> 144:ef7eb2e8f9f7 384 /* RTC Second functions *****************************************/
<> 144:ef7eb2e8f9f7 385 /** @addtogroup RTCEx_Exported_Functions_Group2
<> 144:ef7eb2e8f9f7 386 * @{
<> 144:ef7eb2e8f9f7 387 */
<> 144:ef7eb2e8f9f7 388 HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 389 HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 390 void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef* hrtc);
<> 144:ef7eb2e8f9f7 391 void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 392 void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 393
<> 144:ef7eb2e8f9f7 394 /**
<> 144:ef7eb2e8f9f7 395 * @}
<> 144:ef7eb2e8f9f7 396 */
<> 144:ef7eb2e8f9f7 397
<> 144:ef7eb2e8f9f7 398 /* Extension Control functions ************************************************/
<> 144:ef7eb2e8f9f7 399 /** @addtogroup RTCEx_Exported_Functions_Group3
<> 144:ef7eb2e8f9f7 400 * @{
<> 144:ef7eb2e8f9f7 401 */
<> 144:ef7eb2e8f9f7 402 void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data);
<> 144:ef7eb2e8f9f7 403 uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister);
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef* hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue);
<> 144:ef7eb2e8f9f7 406 /**
<> 144:ef7eb2e8f9f7 407 * @}
<> 144:ef7eb2e8f9f7 408 */
<> 144:ef7eb2e8f9f7 409
<> 144:ef7eb2e8f9f7 410 /**
<> 144:ef7eb2e8f9f7 411 * @}
<> 144:ef7eb2e8f9f7 412 */
<> 144:ef7eb2e8f9f7 413
<> 144:ef7eb2e8f9f7 414 /**
<> 144:ef7eb2e8f9f7 415 * @}
<> 144:ef7eb2e8f9f7 416 */
<> 144:ef7eb2e8f9f7 417
<> 144:ef7eb2e8f9f7 418 /**
<> 144:ef7eb2e8f9f7 419 * @}
<> 144:ef7eb2e8f9f7 420 */
<> 144:ef7eb2e8f9f7 421
<> 144:ef7eb2e8f9f7 422 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 423 }
<> 144:ef7eb2e8f9f7 424 #endif
<> 144:ef7eb2e8f9f7 425
<> 144:ef7eb2e8f9f7 426 #endif /* __STM32F1xx_HAL_RTC_EX_H */
<> 144:ef7eb2e8f9f7 427
<> 144:ef7eb2e8f9f7 428 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/