mbed library sources. Supersedes mbed-src.

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

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
Parent:
167:e84263d55307
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 stm32f2xx_hal_rtc.h
<> 144:ef7eb2e8f9f7 4 * @author MCD Application Team
AnnaBridge 167:e84263d55307 5 * @version V1.2.1
AnnaBridge 167:e84263d55307 6 * @date 14-April-2017
<> 144:ef7eb2e8f9f7 7 * @brief Header file of RTC HAL module.
<> 144:ef7eb2e8f9f7 8 ******************************************************************************
<> 144:ef7eb2e8f9f7 9 * @attention
<> 144:ef7eb2e8f9f7 10 *
AnnaBridge 167:e84263d55307 11 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
<> 144:ef7eb2e8f9f7 12 *
<> 144:ef7eb2e8f9f7 13 * Redistribution and use in source and binary forms, with or without modification,
<> 144:ef7eb2e8f9f7 14 * are permitted provided that the following conditions are met:
<> 144:ef7eb2e8f9f7 15 * 1. Redistributions of source code must retain the above copyright notice,
<> 144:ef7eb2e8f9f7 16 * this list of conditions and the following disclaimer.
<> 144:ef7eb2e8f9f7 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
<> 144:ef7eb2e8f9f7 18 * this list of conditions and the following disclaimer in the documentation
<> 144:ef7eb2e8f9f7 19 * and/or other materials provided with the distribution.
<> 144:ef7eb2e8f9f7 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
<> 144:ef7eb2e8f9f7 21 * may be used to endorse or promote products derived from this software
<> 144:ef7eb2e8f9f7 22 * without specific prior written permission.
<> 144:ef7eb2e8f9f7 23 *
<> 144:ef7eb2e8f9f7 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
<> 144:ef7eb2e8f9f7 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
<> 144:ef7eb2e8f9f7 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 144:ef7eb2e8f9f7 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
<> 144:ef7eb2e8f9f7 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
<> 144:ef7eb2e8f9f7 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
<> 144:ef7eb2e8f9f7 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
<> 144:ef7eb2e8f9f7 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
<> 144:ef7eb2e8f9f7 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
<> 144:ef7eb2e8f9f7 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 144:ef7eb2e8f9f7 34 *
<> 144:ef7eb2e8f9f7 35 ******************************************************************************
<> 144:ef7eb2e8f9f7 36 */
<> 144:ef7eb2e8f9f7 37
<> 144:ef7eb2e8f9f7 38 /* Define to prevent recursive inclusion -------------------------------------*/
<> 144:ef7eb2e8f9f7 39 #ifndef __STM32F2xx_HAL_RTC_H
<> 144:ef7eb2e8f9f7 40 #define __STM32F2xx_HAL_RTC_H
<> 144:ef7eb2e8f9f7 41
<> 144:ef7eb2e8f9f7 42 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 43 extern "C" {
<> 144:ef7eb2e8f9f7 44 #endif
<> 144:ef7eb2e8f9f7 45
<> 144:ef7eb2e8f9f7 46 /* Includes ------------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 47 #include "stm32f2xx_hal_def.h"
AnnaBridge 189:f392fc9709a3 48 #include "stm32f2xx_ll_rtc.h"
<> 144:ef7eb2e8f9f7 49
<> 144:ef7eb2e8f9f7 50 /** @addtogroup STM32F2xx_HAL_Driver
<> 144:ef7eb2e8f9f7 51 * @{
<> 144:ef7eb2e8f9f7 52 */
<> 144:ef7eb2e8f9f7 53
<> 144:ef7eb2e8f9f7 54 /** @addtogroup RTC
<> 144:ef7eb2e8f9f7 55 * @{
<> 144:ef7eb2e8f9f7 56 */
<> 144:ef7eb2e8f9f7 57
<> 144:ef7eb2e8f9f7 58 /* Exported types ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 59 /** @defgroup RTC_Exported_Types RTC Exported Types
<> 144:ef7eb2e8f9f7 60 * @{
<> 144:ef7eb2e8f9f7 61 */
<> 144:ef7eb2e8f9f7 62
<> 144:ef7eb2e8f9f7 63 /**
<> 144:ef7eb2e8f9f7 64 * @brief HAL State structures definition
<> 144:ef7eb2e8f9f7 65 */
<> 144:ef7eb2e8f9f7 66 typedef enum
<> 144:ef7eb2e8f9f7 67 {
<> 144:ef7eb2e8f9f7 68 HAL_RTC_STATE_RESET = 0x00U, /*!< RTC not yet initialized or disabled */
<> 144:ef7eb2e8f9f7 69 HAL_RTC_STATE_READY = 0x01U, /*!< RTC initialized and ready for use */
<> 144:ef7eb2e8f9f7 70 HAL_RTC_STATE_BUSY = 0x02U, /*!< RTC process is ongoing */
<> 144:ef7eb2e8f9f7 71 HAL_RTC_STATE_TIMEOUT = 0x03U, /*!< RTC timeout state */
<> 144:ef7eb2e8f9f7 72 HAL_RTC_STATE_ERROR = 0x04U /*!< RTC error state */
<> 144:ef7eb2e8f9f7 73
<> 144:ef7eb2e8f9f7 74 }HAL_RTCStateTypeDef;
<> 144:ef7eb2e8f9f7 75
<> 144:ef7eb2e8f9f7 76 /**
<> 144:ef7eb2e8f9f7 77 * @brief RTC Configuration Structure definition
<> 144:ef7eb2e8f9f7 78 */
<> 144:ef7eb2e8f9f7 79 typedef struct
<> 144:ef7eb2e8f9f7 80 {
<> 144:ef7eb2e8f9f7 81 uint32_t HourFormat; /*!< Specifies the RTC Hour Format.
AnnaBridge 167:e84263d55307 82 This parameter can be a value of @ref RTC_Hour_Formats */
<> 144:ef7eb2e8f9f7 83
<> 144:ef7eb2e8f9f7 84 uint32_t AsynchPrediv; /*!< Specifies the RTC Asynchronous Predivider value.
AnnaBridge 167:e84263d55307 85 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x7F */
AnnaBridge 167:e84263d55307 86
<> 144:ef7eb2e8f9f7 87 uint32_t SynchPrediv; /*!< Specifies the RTC Synchronous Predivider value.
AnnaBridge 167:e84263d55307 88 This parameter must be a number between Min_Data = 0x00 and Max_Data = 0x1FFF */
AnnaBridge 167:e84263d55307 89
<> 144:ef7eb2e8f9f7 90 uint32_t OutPut; /*!< Specifies which signal will be routed to the RTC output.
AnnaBridge 167:e84263d55307 91 This parameter can be a value of @ref RTC_Output_selection_Definitions */
AnnaBridge 167:e84263d55307 92
<> 144:ef7eb2e8f9f7 93 uint32_t OutPutPolarity; /*!< Specifies the polarity of the output signal.
AnnaBridge 167:e84263d55307 94 This parameter can be a value of @ref RTC_Output_Polarity_Definitions */
AnnaBridge 167:e84263d55307 95
AnnaBridge 167:e84263d55307 96 uint32_t OutPutType; /*!< Specifies the RTC Output Pin mode.
AnnaBridge 167:e84263d55307 97 This parameter can be a value of @ref RTC_Output_Type_ALARM_OUT */
<> 144:ef7eb2e8f9f7 98 }RTC_InitTypeDef;
<> 144:ef7eb2e8f9f7 99
<> 144:ef7eb2e8f9f7 100 /**
<> 144:ef7eb2e8f9f7 101 * @brief RTC Time structure definition
<> 144:ef7eb2e8f9f7 102 */
<> 144:ef7eb2e8f9f7 103 typedef struct
<> 144:ef7eb2e8f9f7 104 {
<> 144:ef7eb2e8f9f7 105 uint8_t Hours; /*!< Specifies the RTC Time Hour.
<> 144:ef7eb2e8f9f7 106 This parameter must be a number between Min_Data = 0 and Max_Data = 12 if the RTC_HourFormat_12 is selected.
<> 144:ef7eb2e8f9f7 107 This parameter must be a number between Min_Data = 0 and Max_Data = 23 if the RTC_HourFormat_24 is selected */
<> 144:ef7eb2e8f9f7 108
<> 144:ef7eb2e8f9f7 109 uint8_t Minutes; /*!< Specifies the RTC Time Minutes.
<> 144:ef7eb2e8f9f7 110 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
AnnaBridge 167:e84263d55307 111
<> 144:ef7eb2e8f9f7 112 uint8_t Seconds; /*!< Specifies the RTC Time Seconds.
<> 144:ef7eb2e8f9f7 113 This parameter must be a number between Min_Data = 0 and Max_Data = 59 */
AnnaBridge 167:e84263d55307 114
<> 144:ef7eb2e8f9f7 115 uint8_t TimeFormat; /*!< Specifies the RTC AM/PM Time.
<> 144:ef7eb2e8f9f7 116 This parameter can be a value of @ref RTC_AM_PM_Definitions */
AnnaBridge 167:e84263d55307 117
<> 144:ef7eb2e8f9f7 118 uint32_t DayLightSaving; /*!< Specifies DayLight Save Operation.
<> 144:ef7eb2e8f9f7 119 This parameter can be a value of @ref RTC_DayLightSaving_Definitions */
AnnaBridge 167:e84263d55307 120
<> 144:ef7eb2e8f9f7 121 uint32_t StoreOperation; /*!< Specifies RTC_StoreOperation value to be written in the BCK bit
<> 144:ef7eb2e8f9f7 122 in CR register to store the operation.
<> 144:ef7eb2e8f9f7 123 This parameter can be a value of @ref RTC_StoreOperation_Definitions */
<> 144:ef7eb2e8f9f7 124 }RTC_TimeTypeDef;
<> 144:ef7eb2e8f9f7 125
<> 144:ef7eb2e8f9f7 126 /**
<> 144:ef7eb2e8f9f7 127 * @brief RTC Date structure definition
<> 144:ef7eb2e8f9f7 128 */
<> 144:ef7eb2e8f9f7 129 typedef struct
<> 144:ef7eb2e8f9f7 130 {
<> 144:ef7eb2e8f9f7 131 uint8_t WeekDay; /*!< Specifies the RTC Date WeekDay.
<> 144:ef7eb2e8f9f7 132 This parameter can be a value of @ref RTC_WeekDay_Definitions */
AnnaBridge 167:e84263d55307 133
<> 144:ef7eb2e8f9f7 134 uint8_t Month; /*!< Specifies the RTC Date Month (in BCD format).
<> 144:ef7eb2e8f9f7 135 This parameter can be a value of @ref RTC_Month_Date_Definitions */
<> 144:ef7eb2e8f9f7 136
<> 144:ef7eb2e8f9f7 137 uint8_t Date; /*!< Specifies the RTC Date.
<> 144:ef7eb2e8f9f7 138 This parameter must be a number between Min_Data = 1 and Max_Data = 31 */
AnnaBridge 167:e84263d55307 139
<> 144:ef7eb2e8f9f7 140 uint8_t Year; /*!< Specifies the RTC Date Year.
<> 144:ef7eb2e8f9f7 141 This parameter must be a number between Min_Data = 0 and Max_Data = 99 */
AnnaBridge 167:e84263d55307 142
<> 144:ef7eb2e8f9f7 143 }RTC_DateTypeDef;
<> 144:ef7eb2e8f9f7 144
<> 144:ef7eb2e8f9f7 145 /**
<> 144:ef7eb2e8f9f7 146 * @brief RTC Alarm structure definition
<> 144:ef7eb2e8f9f7 147 */
<> 144:ef7eb2e8f9f7 148 typedef struct
<> 144:ef7eb2e8f9f7 149 {
<> 144:ef7eb2e8f9f7 150 RTC_TimeTypeDef AlarmTime; /*!< Specifies the RTC Alarm Time members */
AnnaBridge 167:e84263d55307 151
<> 144:ef7eb2e8f9f7 152 uint32_t AlarmMask; /*!< Specifies the RTC Alarm Masks.
<> 144:ef7eb2e8f9f7 153 This parameter can be a value of @ref RTC_AlarmMask_Definitions */
AnnaBridge 167:e84263d55307 154
<> 144:ef7eb2e8f9f7 155 uint32_t AlarmDateWeekDaySel; /*!< Specifies the RTC Alarm is on Date or WeekDay.
<> 144:ef7eb2e8f9f7 156 This parameter can be a value of @ref RTC_AlarmDateWeekDay_Definitions */
AnnaBridge 167:e84263d55307 157
<> 144:ef7eb2e8f9f7 158 uint8_t AlarmDateWeekDay; /*!< Specifies the RTC Alarm Date/WeekDay.
<> 144:ef7eb2e8f9f7 159 If the Alarm Date is selected, this parameter must be set to a value in the 1-31 range.
<> 144:ef7eb2e8f9f7 160 If the Alarm WeekDay is selected, this parameter can be a value of @ref RTC_WeekDay_Definitions */
AnnaBridge 167:e84263d55307 161
<> 144:ef7eb2e8f9f7 162 uint32_t Alarm; /*!< Specifies the alarm .
AnnaBridge 167:e84263d55307 163 This parameter can be a value of @ref RTC_Alarms_Definitions */
<> 144:ef7eb2e8f9f7 164 }RTC_AlarmTypeDef;
<> 144:ef7eb2e8f9f7 165
<> 144:ef7eb2e8f9f7 166 /**
<> 144:ef7eb2e8f9f7 167 * @brief RTC Handle Structure definition
<> 144:ef7eb2e8f9f7 168 */
<> 144:ef7eb2e8f9f7 169 typedef struct
<> 144:ef7eb2e8f9f7 170 {
<> 144:ef7eb2e8f9f7 171 RTC_TypeDef *Instance; /*!< Register base address */
AnnaBridge 167:e84263d55307 172
<> 144:ef7eb2e8f9f7 173 RTC_InitTypeDef Init; /*!< RTC required parameters */
AnnaBridge 167:e84263d55307 174
<> 144:ef7eb2e8f9f7 175 HAL_LockTypeDef Lock; /*!< RTC locking object */
AnnaBridge 167:e84263d55307 176
<> 144:ef7eb2e8f9f7 177 __IO HAL_RTCStateTypeDef State; /*!< Time communication state */
AnnaBridge 167:e84263d55307 178
<> 144:ef7eb2e8f9f7 179 }RTC_HandleTypeDef;
<> 144:ef7eb2e8f9f7 180
<> 144:ef7eb2e8f9f7 181 /**
<> 144:ef7eb2e8f9f7 182 * @}
<> 144:ef7eb2e8f9f7 183 */
<> 144:ef7eb2e8f9f7 184
<> 144:ef7eb2e8f9f7 185 /* Exported constants --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 186 /** @defgroup RTC_Exported_Constants RTC Exported Constants
<> 144:ef7eb2e8f9f7 187 * @{
<> 144:ef7eb2e8f9f7 188 */
<> 144:ef7eb2e8f9f7 189
<> 144:ef7eb2e8f9f7 190 /** @defgroup RTC_Hour_Formats RTC Hour Formats
<> 144:ef7eb2e8f9f7 191 * @{
<> 144:ef7eb2e8f9f7 192 */
AnnaBridge 167:e84263d55307 193 #define RTC_HOURFORMAT_24 0x00000000U
AnnaBridge 167:e84263d55307 194 #define RTC_HOURFORMAT_12 0x00000040U
<> 144:ef7eb2e8f9f7 195 /**
<> 144:ef7eb2e8f9f7 196 * @}
<> 144:ef7eb2e8f9f7 197 */
<> 144:ef7eb2e8f9f7 198
<> 144:ef7eb2e8f9f7 199 /** @defgroup RTC_Output_selection_Definitions RTC Output Selection Definitions
<> 144:ef7eb2e8f9f7 200 * @{
<> 144:ef7eb2e8f9f7 201 */
AnnaBridge 167:e84263d55307 202 #define RTC_OUTPUT_DISABLE 0x00000000U
AnnaBridge 167:e84263d55307 203 #define RTC_OUTPUT_ALARMA 0x00200000U
AnnaBridge 167:e84263d55307 204 #define RTC_OUTPUT_ALARMB 0x00400000U
AnnaBridge 167:e84263d55307 205 #define RTC_OUTPUT_WAKEUP 0x00600000U
<> 144:ef7eb2e8f9f7 206 /**
<> 144:ef7eb2e8f9f7 207 * @}
<> 144:ef7eb2e8f9f7 208 */
<> 144:ef7eb2e8f9f7 209
<> 144:ef7eb2e8f9f7 210 /** @defgroup RTC_Output_Polarity_Definitions RTC Output Polarity Definitions
<> 144:ef7eb2e8f9f7 211 * @{
<> 144:ef7eb2e8f9f7 212 */
AnnaBridge 167:e84263d55307 213 #define RTC_OUTPUT_POLARITY_HIGH 0x00000000U
AnnaBridge 167:e84263d55307 214 #define RTC_OUTPUT_POLARITY_LOW 0x00100000U
<> 144:ef7eb2e8f9f7 215 /**
<> 144:ef7eb2e8f9f7 216 * @}
<> 144:ef7eb2e8f9f7 217 */
<> 144:ef7eb2e8f9f7 218
<> 144:ef7eb2e8f9f7 219 /** @defgroup RTC_Output_Type_ALARM_OUT RTC Output Type ALARM OUT
<> 144:ef7eb2e8f9f7 220 * @{
<> 144:ef7eb2e8f9f7 221 */
AnnaBridge 167:e84263d55307 222 #define RTC_OUTPUT_TYPE_OPENDRAIN 0x00000000U
AnnaBridge 167:e84263d55307 223 #define RTC_OUTPUT_TYPE_PUSHPULL 0x00040000U
<> 144:ef7eb2e8f9f7 224 /**
<> 144:ef7eb2e8f9f7 225 * @}
<> 144:ef7eb2e8f9f7 226 */
<> 144:ef7eb2e8f9f7 227
<> 144:ef7eb2e8f9f7 228 /** @defgroup RTC_AM_PM_Definitions RTC AM PM Definitions
<> 144:ef7eb2e8f9f7 229 * @{
<> 144:ef7eb2e8f9f7 230 */
AnnaBridge 167:e84263d55307 231 #define RTC_HOURFORMAT12_AM ((uint8_t)0x00)
AnnaBridge 167:e84263d55307 232 #define RTC_HOURFORMAT12_PM ((uint8_t)0x40)
<> 144:ef7eb2e8f9f7 233 /**
<> 144:ef7eb2e8f9f7 234 * @}
<> 144:ef7eb2e8f9f7 235 */
<> 144:ef7eb2e8f9f7 236
<> 144:ef7eb2e8f9f7 237 /** @defgroup RTC_DayLightSaving_Definitions RTC DayLight Saving Definitions
<> 144:ef7eb2e8f9f7 238 * @{
<> 144:ef7eb2e8f9f7 239 */
AnnaBridge 167:e84263d55307 240 #define RTC_DAYLIGHTSAVING_SUB1H 0x00020000U
AnnaBridge 167:e84263d55307 241 #define RTC_DAYLIGHTSAVING_ADD1H 0x00010000U
AnnaBridge 167:e84263d55307 242 #define RTC_DAYLIGHTSAVING_NONE 0x00000000U
<> 144:ef7eb2e8f9f7 243 /**
<> 144:ef7eb2e8f9f7 244 * @}
<> 144:ef7eb2e8f9f7 245 */
<> 144:ef7eb2e8f9f7 246
<> 144:ef7eb2e8f9f7 247 /** @defgroup RTC_StoreOperation_Definitions RTC Store Operation Definitions
<> 144:ef7eb2e8f9f7 248 * @{
<> 144:ef7eb2e8f9f7 249 */
AnnaBridge 167:e84263d55307 250 #define RTC_STOREOPERATION_RESET 0x00000000U
AnnaBridge 167:e84263d55307 251 #define RTC_STOREOPERATION_SET 0x00040000U
<> 144:ef7eb2e8f9f7 252 /**
<> 144:ef7eb2e8f9f7 253 * @}
<> 144:ef7eb2e8f9f7 254 */
<> 144:ef7eb2e8f9f7 255
<> 144:ef7eb2e8f9f7 256 /** @defgroup RTC_Input_parameter_format_definitions RTC Input Parameter Format Definitions
<> 144:ef7eb2e8f9f7 257 * @{
<> 144:ef7eb2e8f9f7 258 */
AnnaBridge 167:e84263d55307 259 #define RTC_FORMAT_BIN 0x00000000U
AnnaBridge 167:e84263d55307 260 #define RTC_FORMAT_BCD 0x00000001U
<> 144:ef7eb2e8f9f7 261 /**
<> 144:ef7eb2e8f9f7 262 * @}
<> 144:ef7eb2e8f9f7 263 */
<> 144:ef7eb2e8f9f7 264
<> 144:ef7eb2e8f9f7 265 /** @defgroup RTC_Month_Date_Definitions RTC Month Date Definitions
<> 144:ef7eb2e8f9f7 266 * @{
<> 144:ef7eb2e8f9f7 267 */
<> 144:ef7eb2e8f9f7 268 /* Coded in BCD format */
AnnaBridge 167:e84263d55307 269 #define RTC_MONTH_JANUARY ((uint8_t)0x01)
AnnaBridge 167:e84263d55307 270 #define RTC_MONTH_FEBRUARY ((uint8_t)0x02)
AnnaBridge 167:e84263d55307 271 #define RTC_MONTH_MARCH ((uint8_t)0x03)
AnnaBridge 167:e84263d55307 272 #define RTC_MONTH_APRIL ((uint8_t)0x04)
AnnaBridge 167:e84263d55307 273 #define RTC_MONTH_MAY ((uint8_t)0x05)
AnnaBridge 167:e84263d55307 274 #define RTC_MONTH_JUNE ((uint8_t)0x06)
AnnaBridge 167:e84263d55307 275 #define RTC_MONTH_JULY ((uint8_t)0x07)
AnnaBridge 167:e84263d55307 276 #define RTC_MONTH_AUGUST ((uint8_t)0x08)
AnnaBridge 167:e84263d55307 277 #define RTC_MONTH_SEPTEMBER ((uint8_t)0x09)
AnnaBridge 167:e84263d55307 278 #define RTC_MONTH_OCTOBER ((uint8_t)0x10)
AnnaBridge 167:e84263d55307 279 #define RTC_MONTH_NOVEMBER ((uint8_t)0x11)
AnnaBridge 167:e84263d55307 280 #define RTC_MONTH_DECEMBER ((uint8_t)0x12)
<> 144:ef7eb2e8f9f7 281 /**
<> 144:ef7eb2e8f9f7 282 * @}
<> 144:ef7eb2e8f9f7 283 */
<> 144:ef7eb2e8f9f7 284
<> 144:ef7eb2e8f9f7 285 /** @defgroup RTC_WeekDay_Definitions RTC WeekDay Definitions
<> 144:ef7eb2e8f9f7 286 * @{
<> 144:ef7eb2e8f9f7 287 */
AnnaBridge 167:e84263d55307 288 #define RTC_WEEKDAY_MONDAY ((uint8_t)0x01)
AnnaBridge 167:e84263d55307 289 #define RTC_WEEKDAY_TUESDAY ((uint8_t)0x02)
AnnaBridge 167:e84263d55307 290 #define RTC_WEEKDAY_WEDNESDAY ((uint8_t)0x03)
AnnaBridge 167:e84263d55307 291 #define RTC_WEEKDAY_THURSDAY ((uint8_t)0x04)
AnnaBridge 167:e84263d55307 292 #define RTC_WEEKDAY_FRIDAY ((uint8_t)0x05)
AnnaBridge 167:e84263d55307 293 #define RTC_WEEKDAY_SATURDAY ((uint8_t)0x06)
AnnaBridge 167:e84263d55307 294 #define RTC_WEEKDAY_SUNDAY ((uint8_t)0x07)
<> 144:ef7eb2e8f9f7 295 /**
<> 144:ef7eb2e8f9f7 296 * @}
<> 144:ef7eb2e8f9f7 297 */
<> 144:ef7eb2e8f9f7 298
<> 144:ef7eb2e8f9f7 299 /** @defgroup RTC_AlarmDateWeekDay_Definitions RTC Alarm Date WeekDay Definitions
<> 144:ef7eb2e8f9f7 300 * @{
<> 144:ef7eb2e8f9f7 301 */
AnnaBridge 167:e84263d55307 302 #define RTC_ALARMDATEWEEKDAYSEL_DATE 0x00000000U
AnnaBridge 167:e84263d55307 303 #define RTC_ALARMDATEWEEKDAYSEL_WEEKDAY 0x40000000U
<> 144:ef7eb2e8f9f7 304 /**
<> 144:ef7eb2e8f9f7 305 * @}
<> 144:ef7eb2e8f9f7 306 */
<> 144:ef7eb2e8f9f7 307
<> 144:ef7eb2e8f9f7 308 /** @defgroup RTC_AlarmMask_Definitions RTC Alarm Mask Definitions
<> 144:ef7eb2e8f9f7 309 * @{
<> 144:ef7eb2e8f9f7 310 */
AnnaBridge 167:e84263d55307 311 #define RTC_ALARMMASK_NONE 0x00000000U
<> 144:ef7eb2e8f9f7 312 #define RTC_ALARMMASK_DATEWEEKDAY RTC_ALRMAR_MSK4
<> 144:ef7eb2e8f9f7 313 #define RTC_ALARMMASK_HOURS RTC_ALRMAR_MSK3
<> 144:ef7eb2e8f9f7 314 #define RTC_ALARMMASK_MINUTES RTC_ALRMAR_MSK2
<> 144:ef7eb2e8f9f7 315 #define RTC_ALARMMASK_SECONDS RTC_ALRMAR_MSK1
AnnaBridge 167:e84263d55307 316 #define RTC_ALARMMASK_ALL 0x80808080U
<> 144:ef7eb2e8f9f7 317 /**
<> 144:ef7eb2e8f9f7 318 * @}
<> 144:ef7eb2e8f9f7 319 */
<> 144:ef7eb2e8f9f7 320
<> 144:ef7eb2e8f9f7 321 /** @defgroup RTC_Alarms_Definitions RTC Alarms Definitions
<> 144:ef7eb2e8f9f7 322 * @{
<> 144:ef7eb2e8f9f7 323 */
<> 144:ef7eb2e8f9f7 324 #define RTC_ALARM_A RTC_CR_ALRAE
<> 144:ef7eb2e8f9f7 325 #define RTC_ALARM_B RTC_CR_ALRBE
<> 144:ef7eb2e8f9f7 326 /**
<> 144:ef7eb2e8f9f7 327 * @}
<> 144:ef7eb2e8f9f7 328 */
<> 144:ef7eb2e8f9f7 329
<> 144:ef7eb2e8f9f7 330 /** @defgroup RTC_Interrupts_Definitions RTC Interrupts Definitions
<> 144:ef7eb2e8f9f7 331 * @{
<> 144:ef7eb2e8f9f7 332 */
AnnaBridge 167:e84263d55307 333 #define RTC_IT_TS 0x00008000U
AnnaBridge 167:e84263d55307 334 #define RTC_IT_WUT 0x00004000U
AnnaBridge 167:e84263d55307 335 #define RTC_IT_ALRB 0x00002000U
AnnaBridge 167:e84263d55307 336 #define RTC_IT_ALRA 0x00001000U
AnnaBridge 167:e84263d55307 337 #define RTC_IT_TAMP 0x00000004U /* Used only to Enable the Tamper Interrupt */
AnnaBridge 167:e84263d55307 338 #define RTC_IT_TAMP1 0x00020000U
<> 144:ef7eb2e8f9f7 339 /**
<> 144:ef7eb2e8f9f7 340 * @}
<> 144:ef7eb2e8f9f7 341 */
<> 144:ef7eb2e8f9f7 342
<> 144:ef7eb2e8f9f7 343 /** @defgroup RTC_Flags_Definitions RTC Flags Definitions
<> 144:ef7eb2e8f9f7 344 * @{
<> 144:ef7eb2e8f9f7 345 */
AnnaBridge 167:e84263d55307 346 #define RTC_FLAG_TAMP1F 0x00002000U
AnnaBridge 167:e84263d55307 347 #define RTC_FLAG_TSOVF 0x00001000U
AnnaBridge 167:e84263d55307 348 #define RTC_FLAG_TSF 0x00000800U
AnnaBridge 167:e84263d55307 349 #define RTC_FLAG_WUTF 0x00000400U
AnnaBridge 167:e84263d55307 350 #define RTC_FLAG_ALRBF 0x00000200U
AnnaBridge 167:e84263d55307 351 #define RTC_FLAG_ALRAF 0x00000100U
AnnaBridge 167:e84263d55307 352 #define RTC_FLAG_INITF 0x00000040U
AnnaBridge 167:e84263d55307 353 #define RTC_FLAG_RSF 0x00000020U
AnnaBridge 167:e84263d55307 354 #define RTC_FLAG_INITS 0x00000010U
AnnaBridge 167:e84263d55307 355 #define RTC_FLAG_WUTWF 0x00000004U
AnnaBridge 167:e84263d55307 356 #define RTC_FLAG_ALRBWF 0x00000002U
AnnaBridge 167:e84263d55307 357 #define RTC_FLAG_ALRAWF 0x00000001U
<> 144:ef7eb2e8f9f7 358 /**
<> 144:ef7eb2e8f9f7 359 * @}
<> 144:ef7eb2e8f9f7 360 */
<> 144:ef7eb2e8f9f7 361
<> 144:ef7eb2e8f9f7 362 /**
<> 144:ef7eb2e8f9f7 363 * @}
<> 144:ef7eb2e8f9f7 364 */
<> 144:ef7eb2e8f9f7 365
<> 144:ef7eb2e8f9f7 366 /* Exported macro ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 367 /** @defgroup RTC_Exported_Macros RTC Exported Macros
<> 144:ef7eb2e8f9f7 368 * @{
<> 144:ef7eb2e8f9f7 369 */
<> 144:ef7eb2e8f9f7 370
<> 144:ef7eb2e8f9f7 371 /** @brief Reset RTC handle state
<> 144:ef7eb2e8f9f7 372 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 373 * @retval None
<> 144:ef7eb2e8f9f7 374 */
<> 144:ef7eb2e8f9f7 375 #define __HAL_RTC_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_RTC_STATE_RESET)
<> 144:ef7eb2e8f9f7 376
<> 144:ef7eb2e8f9f7 377 /**
<> 144:ef7eb2e8f9f7 378 * @brief Disable the write protection for RTC registers.
<> 144:ef7eb2e8f9f7 379 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 380 * @retval None
<> 144:ef7eb2e8f9f7 381 */
<> 144:ef7eb2e8f9f7 382 #define __HAL_RTC_WRITEPROTECTION_DISABLE(__HANDLE__) \
<> 144:ef7eb2e8f9f7 383 do{ \
<> 144:ef7eb2e8f9f7 384 (__HANDLE__)->Instance->WPR = 0xCAU; \
<> 144:ef7eb2e8f9f7 385 (__HANDLE__)->Instance->WPR = 0x53U; \
AnnaBridge 167:e84263d55307 386 } while(0U)
<> 144:ef7eb2e8f9f7 387
<> 144:ef7eb2e8f9f7 388 /**
<> 144:ef7eb2e8f9f7 389 * @brief Enable the write protection for RTC registers.
<> 144:ef7eb2e8f9f7 390 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 391 * @retval None
<> 144:ef7eb2e8f9f7 392 */
<> 144:ef7eb2e8f9f7 393 #define __HAL_RTC_WRITEPROTECTION_ENABLE(__HANDLE__) \
<> 144:ef7eb2e8f9f7 394 do{ \
<> 144:ef7eb2e8f9f7 395 (__HANDLE__)->Instance->WPR = 0xFFU; \
AnnaBridge 167:e84263d55307 396 } while(0U)
<> 144:ef7eb2e8f9f7 397
<> 144:ef7eb2e8f9f7 398 /**
<> 144:ef7eb2e8f9f7 399 * @brief Enable the RTC ALARMA peripheral.
<> 144:ef7eb2e8f9f7 400 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 401 * @retval None
<> 144:ef7eb2e8f9f7 402 */
<> 144:ef7eb2e8f9f7 403 #define __HAL_RTC_ALARMA_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRAE))
<> 144:ef7eb2e8f9f7 404
<> 144:ef7eb2e8f9f7 405 /**
<> 144:ef7eb2e8f9f7 406 * @brief Disable the RTC ALARMA peripheral.
<> 144:ef7eb2e8f9f7 407 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 408 * @retval None
<> 144:ef7eb2e8f9f7 409 */
<> 144:ef7eb2e8f9f7 410 #define __HAL_RTC_ALARMA_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRAE))
<> 144:ef7eb2e8f9f7 411
<> 144:ef7eb2e8f9f7 412 /**
<> 144:ef7eb2e8f9f7 413 * @brief Enable the RTC ALARMB peripheral.
<> 144:ef7eb2e8f9f7 414 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 415 * @retval None
<> 144:ef7eb2e8f9f7 416 */
<> 144:ef7eb2e8f9f7 417 #define __HAL_RTC_ALARMB_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR |= (RTC_CR_ALRBE))
<> 144:ef7eb2e8f9f7 418
<> 144:ef7eb2e8f9f7 419 /**
<> 144:ef7eb2e8f9f7 420 * @brief Disable the RTC ALARMB peripheral.
<> 144:ef7eb2e8f9f7 421 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 422 * @retval None
<> 144:ef7eb2e8f9f7 423 */
<> 144:ef7eb2e8f9f7 424 #define __HAL_RTC_ALARMB_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~(RTC_CR_ALRBE))
<> 144:ef7eb2e8f9f7 425
<> 144:ef7eb2e8f9f7 426 /**
<> 144:ef7eb2e8f9f7 427 * @brief Enable the RTC Alarm interrupt.
<> 144:ef7eb2e8f9f7 428 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 429 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 430 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 431 * @arg RTC_IT_ALRA: Alarm A interrupt
<> 144:ef7eb2e8f9f7 432 * @arg RTC_IT_ALRB: Alarm B interrupt
<> 144:ef7eb2e8f9f7 433 * @retval None
<> 144:ef7eb2e8f9f7 434 */
<> 144:ef7eb2e8f9f7 435 #define __HAL_RTC_ALARM_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__))
<> 144:ef7eb2e8f9f7 436
<> 144:ef7eb2e8f9f7 437 /**
<> 144:ef7eb2e8f9f7 438 * @brief Disable the RTC Alarm interrupt.
<> 144:ef7eb2e8f9f7 439 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 440 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 441 * This parameter can be any combination of the following values:
<> 144:ef7eb2e8f9f7 442 * @arg RTC_IT_ALRA: Alarm A interrupt
<> 144:ef7eb2e8f9f7 443 * @arg RTC_IT_ALRB: Alarm B interrupt
<> 144:ef7eb2e8f9f7 444 * @retval None
<> 144:ef7eb2e8f9f7 445 */
<> 144:ef7eb2e8f9f7 446 #define __HAL_RTC_ALARM_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= ~(__INTERRUPT__))
<> 144:ef7eb2e8f9f7 447
<> 144:ef7eb2e8f9f7 448 /**
<> 144:ef7eb2e8f9f7 449 * @brief Check whether the specified RTC Alarm interrupt has occurred or not.
<> 144:ef7eb2e8f9f7 450 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 451 * @param __INTERRUPT__: specifies the RTC Alarm interrupt to check.
<> 144:ef7eb2e8f9f7 452 * This parameter can be:
<> 144:ef7eb2e8f9f7 453 * @arg RTC_IT_ALRA: Alarm A interrupt
<> 144:ef7eb2e8f9f7 454 * @arg RTC_IT_ALRB: Alarm B interrupt
<> 144:ef7eb2e8f9f7 455 * @retval None
<> 144:ef7eb2e8f9f7 456 */
<> 144:ef7eb2e8f9f7 457 #define __HAL_RTC_ALARM_GET_IT(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->ISR)& ((__INTERRUPT__)>> 4U)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 458
<> 144:ef7eb2e8f9f7 459 /**
<> 144:ef7eb2e8f9f7 460 * @brief Get the selected RTC Alarm's flag status.
<> 144:ef7eb2e8f9f7 461 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 462 * @param __FLAG__: specifies the RTC Alarm Flag to check.
<> 144:ef7eb2e8f9f7 463 * This parameter can be:
<> 144:ef7eb2e8f9f7 464 * @arg RTC_FLAG_ALRAF
<> 144:ef7eb2e8f9f7 465 * @arg RTC_FLAG_ALRBF
<> 144:ef7eb2e8f9f7 466 * @arg RTC_FLAG_ALRAWF
<> 144:ef7eb2e8f9f7 467 * @arg RTC_FLAG_ALRBWF
<> 144:ef7eb2e8f9f7 468 * @retval None
<> 144:ef7eb2e8f9f7 469 */
<> 144:ef7eb2e8f9f7 470 #define __HAL_RTC_ALARM_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) != RESET)? SET : RESET)
<> 144:ef7eb2e8f9f7 471
<> 144:ef7eb2e8f9f7 472 /**
<> 144:ef7eb2e8f9f7 473 * @brief Clear the RTC Alarm's pending flags.
<> 144:ef7eb2e8f9f7 474 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 475 * @param __FLAG__: specifies the RTC Alarm Flag sources to be enabled or disabled.
<> 144:ef7eb2e8f9f7 476 * This parameter can be:
<> 144:ef7eb2e8f9f7 477 * @arg RTC_FLAG_ALRAF
<> 144:ef7eb2e8f9f7 478 * @arg RTC_FLAG_ALRBF
<> 144:ef7eb2e8f9f7 479 * @retval None
<> 144:ef7eb2e8f9f7 480 */
<> 144:ef7eb2e8f9f7 481 #define __HAL_RTC_ALARM_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ISR) = (~((__FLAG__) | RTC_ISR_INIT)|((__HANDLE__)->Instance->ISR & RTC_ISR_INIT))
<> 144:ef7eb2e8f9f7 482
<> 144:ef7eb2e8f9f7 483
<> 144:ef7eb2e8f9f7 484 /**
<> 144:ef7eb2e8f9f7 485 * @brief Check whether the specified RTC Alarm interrupt has been enabled or not.
<> 144:ef7eb2e8f9f7 486 * @param __HANDLE__: specifies the RTC handle.
<> 144:ef7eb2e8f9f7 487 * @param __INTERRUPT__: specifies the RTC Alarm interrupt sources to check.
<> 144:ef7eb2e8f9f7 488 * This parameter can be:
<> 144:ef7eb2e8f9f7 489 * @arg RTC_IT_ALRA: Alarm A interrupt
<> 144:ef7eb2e8f9f7 490 * @arg RTC_IT_ALRB: Alarm B interrupt
<> 144:ef7eb2e8f9f7 491 * @retval None
<> 144:ef7eb2e8f9f7 492 */
<> 144:ef7eb2e8f9f7 493 #define __HAL_RTC_ALARM_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) (((((__HANDLE__)->Instance->CR) & (__INTERRUPT__)) != RESET) ? SET : RESET)
<> 144:ef7eb2e8f9f7 494
<> 144:ef7eb2e8f9f7 495 /**
<> 144:ef7eb2e8f9f7 496 * @brief Enable interrupt on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 497 * @retval None
<> 144:ef7eb2e8f9f7 498 */
<> 144:ef7eb2e8f9f7 499 #define __HAL_RTC_ALARM_EXTI_ENABLE_IT() (EXTI->IMR |= RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 500
<> 144:ef7eb2e8f9f7 501 /**
<> 144:ef7eb2e8f9f7 502 * @brief Disable interrupt on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 503 * @retval None
<> 144:ef7eb2e8f9f7 504 */
<> 144:ef7eb2e8f9f7 505 #define __HAL_RTC_ALARM_EXTI_DISABLE_IT() (EXTI->IMR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
<> 144:ef7eb2e8f9f7 506
<> 144:ef7eb2e8f9f7 507 /**
<> 144:ef7eb2e8f9f7 508 * @brief Enable event on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 509 * @retval None.
<> 144:ef7eb2e8f9f7 510 */
<> 144:ef7eb2e8f9f7 511 #define __HAL_RTC_ALARM_EXTI_ENABLE_EVENT() (EXTI->EMR |= RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 512
<> 144:ef7eb2e8f9f7 513 /**
<> 144:ef7eb2e8f9f7 514 * @brief Disable event on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 515 * @retval None.
<> 144:ef7eb2e8f9f7 516 */
<> 144:ef7eb2e8f9f7 517 #define __HAL_RTC_ALARM_EXTI_DISABLE_EVENT() (EXTI->EMR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
<> 144:ef7eb2e8f9f7 518
<> 144:ef7eb2e8f9f7 519 /**
<> 144:ef7eb2e8f9f7 520 * @brief Enable falling edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 521 * @retval None.
<> 144:ef7eb2e8f9f7 522 */
<> 144:ef7eb2e8f9f7 523 #define __HAL_RTC_ALARM_EXTI_ENABLE_FALLING_EDGE() (EXTI->FTSR |= RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 524
<> 144:ef7eb2e8f9f7 525 /**
<> 144:ef7eb2e8f9f7 526 * @brief Disable falling edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 527 * @retval None.
<> 144:ef7eb2e8f9f7 528 */
<> 144:ef7eb2e8f9f7 529 #define __HAL_RTC_ALARM_EXTI_DISABLE_FALLING_EDGE() (EXTI->FTSR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
<> 144:ef7eb2e8f9f7 530
<> 144:ef7eb2e8f9f7 531 /**
<> 144:ef7eb2e8f9f7 532 * @brief Enable rising edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 533 * @retval None.
<> 144:ef7eb2e8f9f7 534 */
<> 144:ef7eb2e8f9f7 535 #define __HAL_RTC_ALARM_EXTI_ENABLE_RISING_EDGE() (EXTI->RTSR |= RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 536
<> 144:ef7eb2e8f9f7 537 /**
<> 144:ef7eb2e8f9f7 538 * @brief Disable rising edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 539 * @retval None.
<> 144:ef7eb2e8f9f7 540 */
<> 144:ef7eb2e8f9f7 541 #define __HAL_RTC_ALARM_EXTI_DISABLE_RISING_EDGE() (EXTI->RTSR &= ~(RTC_EXTI_LINE_ALARM_EVENT))
<> 144:ef7eb2e8f9f7 542
<> 144:ef7eb2e8f9f7 543 /**
<> 144:ef7eb2e8f9f7 544 * @brief Enable rising & falling edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 545 * @retval None.
<> 144:ef7eb2e8f9f7 546 */
<> 144:ef7eb2e8f9f7 547 #define __HAL_RTC_ALARM_EXTI_ENABLE_RISING_FALLING_EDGE() do{ __HAL_RTC_ALARM_EXTI_ENABLE_RISING_EDGE();\
<> 144:ef7eb2e8f9f7 548 __HAL_RTC_ALARM_EXTI_ENABLE_FALLING_EDGE();\
AnnaBridge 167:e84263d55307 549 }while(0U)
<> 144:ef7eb2e8f9f7 550
<> 144:ef7eb2e8f9f7 551 /**
<> 144:ef7eb2e8f9f7 552 * @brief Disable rising & falling edge trigger on the RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 553 * @retval None.
<> 144:ef7eb2e8f9f7 554 */
<> 144:ef7eb2e8f9f7 555 #define __HAL_RTC_ALARM_EXTI_DISABLE_RISING_FALLING_EDGE() do{ __HAL_RTC_ALARM_EXTI_DISABLE_RISING_EDGE();\
<> 144:ef7eb2e8f9f7 556 __HAL_RTC_ALARM_EXTI_DISABLE_FALLING_EDGE();\
AnnaBridge 167:e84263d55307 557 }while(0U)
<> 144:ef7eb2e8f9f7 558
<> 144:ef7eb2e8f9f7 559 /**
<> 144:ef7eb2e8f9f7 560 * @brief Check whether the RTC Alarm associated Exti line interrupt flag is set or not.
<> 144:ef7eb2e8f9f7 561 * @retval Line Status.
<> 144:ef7eb2e8f9f7 562 */
<> 144:ef7eb2e8f9f7 563 #define __HAL_RTC_ALARM_EXTI_GET_FLAG() (EXTI->PR & RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 564
<> 144:ef7eb2e8f9f7 565 /**
<> 144:ef7eb2e8f9f7 566 * @brief Clear the RTC Alarm associated Exti line flag.
<> 144:ef7eb2e8f9f7 567 * @retval None.
<> 144:ef7eb2e8f9f7 568 */
<> 144:ef7eb2e8f9f7 569 #define __HAL_RTC_ALARM_EXTI_CLEAR_FLAG() (EXTI->PR = RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 570
<> 144:ef7eb2e8f9f7 571 /**
<> 144:ef7eb2e8f9f7 572 * @brief Generate a Software interrupt on RTC Alarm associated Exti line.
<> 144:ef7eb2e8f9f7 573 * @retval None.
<> 144:ef7eb2e8f9f7 574 */
<> 144:ef7eb2e8f9f7 575 #define __HAL_RTC_ALARM_EXTI_GENERATE_SWIT() (EXTI->SWIER |= RTC_EXTI_LINE_ALARM_EVENT)
<> 144:ef7eb2e8f9f7 576 /**
<> 144:ef7eb2e8f9f7 577 * @}
<> 144:ef7eb2e8f9f7 578 */
<> 144:ef7eb2e8f9f7 579
<> 144:ef7eb2e8f9f7 580 /* Include RTC HAL Extension module */
<> 144:ef7eb2e8f9f7 581 #include "stm32f2xx_hal_rtc_ex.h"
<> 144:ef7eb2e8f9f7 582
<> 144:ef7eb2e8f9f7 583 /* Exported functions --------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 584 /** @addtogroup RTC_Exported_Functions
<> 144:ef7eb2e8f9f7 585 * @{
<> 144:ef7eb2e8f9f7 586 */
<> 144:ef7eb2e8f9f7 587
<> 144:ef7eb2e8f9f7 588 /** @addtogroup RTC_Exported_Functions_Group1
<> 144:ef7eb2e8f9f7 589 * @{
<> 144:ef7eb2e8f9f7 590 */
<> 144:ef7eb2e8f9f7 591 /* Initialization and de-initialization functions ****************************/
<> 144:ef7eb2e8f9f7 592 HAL_StatusTypeDef HAL_RTC_Init(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 593 HAL_StatusTypeDef HAL_RTC_DeInit(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 594 void HAL_RTC_MspInit(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 595 void HAL_RTC_MspDeInit(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 596 /**
<> 144:ef7eb2e8f9f7 597 * @}
<> 144:ef7eb2e8f9f7 598 */
<> 144:ef7eb2e8f9f7 599
<> 144:ef7eb2e8f9f7 600 /** @addtogroup RTC_Exported_Functions_Group2
<> 144:ef7eb2e8f9f7 601 * @{
<> 144:ef7eb2e8f9f7 602 */
<> 144:ef7eb2e8f9f7 603 /* RTC Time and Date functions ************************************************/
<> 144:ef7eb2e8f9f7 604 HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
<> 144:ef7eb2e8f9f7 605 HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
<> 144:ef7eb2e8f9f7 606 HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
<> 144:ef7eb2e8f9f7 607 HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);
<> 144:ef7eb2e8f9f7 608 /**
<> 144:ef7eb2e8f9f7 609 * @}
<> 144:ef7eb2e8f9f7 610 */
<> 144:ef7eb2e8f9f7 611
<> 144:ef7eb2e8f9f7 612 /** @addtogroup RTC_Exported_Functions_Group3
<> 144:ef7eb2e8f9f7 613 * @{
<> 144:ef7eb2e8f9f7 614 */
<> 144:ef7eb2e8f9f7 615 /* RTC Alarm functions ********************************************************/
<> 144:ef7eb2e8f9f7 616 HAL_StatusTypeDef HAL_RTC_SetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
<> 144:ef7eb2e8f9f7 617 HAL_StatusTypeDef HAL_RTC_SetAlarm_IT(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
<> 144:ef7eb2e8f9f7 618 HAL_StatusTypeDef HAL_RTC_DeactivateAlarm(RTC_HandleTypeDef *hrtc, uint32_t Alarm);
<> 144:ef7eb2e8f9f7 619 HAL_StatusTypeDef HAL_RTC_GetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format);
<> 144:ef7eb2e8f9f7 620 void HAL_RTC_AlarmIRQHandler(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 621 HAL_StatusTypeDef HAL_RTC_PollForAlarmAEvent(RTC_HandleTypeDef *hrtc, uint32_t Timeout);
<> 144:ef7eb2e8f9f7 622 void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 623 /**
<> 144:ef7eb2e8f9f7 624 * @}
<> 144:ef7eb2e8f9f7 625 */
<> 144:ef7eb2e8f9f7 626
<> 144:ef7eb2e8f9f7 627 /** @addtogroup RTC_Exported_Functions_Group4
<> 144:ef7eb2e8f9f7 628 * @{
<> 144:ef7eb2e8f9f7 629 */
<> 144:ef7eb2e8f9f7 630 /* Peripheral Control functions ***********************************************/
<> 144:ef7eb2e8f9f7 631 HAL_StatusTypeDef HAL_RTC_WaitForSynchro(RTC_HandleTypeDef* hrtc);
<> 144:ef7eb2e8f9f7 632 /**
<> 144:ef7eb2e8f9f7 633 * @}
<> 144:ef7eb2e8f9f7 634 */
<> 144:ef7eb2e8f9f7 635
<> 144:ef7eb2e8f9f7 636 /** @addtogroup RTC_Exported_Functions_Group5
<> 144:ef7eb2e8f9f7 637 * @{
<> 144:ef7eb2e8f9f7 638 */
<> 144:ef7eb2e8f9f7 639 /* Peripheral State functions *************************************************/
<> 144:ef7eb2e8f9f7 640 HAL_RTCStateTypeDef HAL_RTC_GetState(RTC_HandleTypeDef *hrtc);
<> 144:ef7eb2e8f9f7 641 /**
<> 144:ef7eb2e8f9f7 642 * @}
<> 144:ef7eb2e8f9f7 643 */
<> 144:ef7eb2e8f9f7 644
<> 144:ef7eb2e8f9f7 645 /**
<> 144:ef7eb2e8f9f7 646 * @}
<> 144:ef7eb2e8f9f7 647 */
<> 144:ef7eb2e8f9f7 648
<> 144:ef7eb2e8f9f7 649 /* Private types -------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 650 /* Private variables ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 651 /* Private constants ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 652 /** @defgroup RTC_Private_Constants RTC Private Constants
<> 144:ef7eb2e8f9f7 653 * @{
<> 144:ef7eb2e8f9f7 654 */
<> 144:ef7eb2e8f9f7 655 /* Masks Definition */
AnnaBridge 167:e84263d55307 656 #define RTC_TR_RESERVED_MASK 0x007F7F7FU
AnnaBridge 167:e84263d55307 657 #define RTC_DR_RESERVED_MASK 0x00FFFF3FU
AnnaBridge 167:e84263d55307 658 #define RTC_INIT_MASK 0xFFFFFFFFU
AnnaBridge 167:e84263d55307 659 #define RTC_RSF_MASK 0xFFFFFF5FU
<> 144:ef7eb2e8f9f7 660 #define RTC_FLAGS_MASK ((uint32_t)(RTC_FLAG_TSOVF | RTC_FLAG_TSF | RTC_FLAG_WUTF | \
<> 144:ef7eb2e8f9f7 661 RTC_FLAG_ALRBF | RTC_FLAG_ALRAF | RTC_FLAG_INITF | \
<> 144:ef7eb2e8f9f7 662 RTC_FLAG_RSF | RTC_FLAG_INITS | RTC_FLAG_WUTWF | \
<> 144:ef7eb2e8f9f7 663 RTC_FLAG_ALRBWF | RTC_FLAG_ALRAWF | RTC_FLAG_TAMP1F))
<> 144:ef7eb2e8f9f7 664
AnnaBridge 167:e84263d55307 665 #define RTC_TIMEOUT_VALUE 1000U
<> 144:ef7eb2e8f9f7 666
<> 144:ef7eb2e8f9f7 667 #define RTC_EXTI_LINE_ALARM_EVENT ((uint32_t)EXTI_IMR_MR17) /*!< External interrupt line 17 Connected to the RTC Alarm event */
<> 144:ef7eb2e8f9f7 668 /**
<> 144:ef7eb2e8f9f7 669 * @}
<> 144:ef7eb2e8f9f7 670 */
<> 144:ef7eb2e8f9f7 671
<> 144:ef7eb2e8f9f7 672 /* Private macros ------------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 673 /** @defgroup RTC_Private_Macros RTC Private Macros
<> 144:ef7eb2e8f9f7 674 * @{
<> 144:ef7eb2e8f9f7 675 */
<> 144:ef7eb2e8f9f7 676
<> 144:ef7eb2e8f9f7 677 /** @defgroup RTC_IS_RTC_Definitions RTC Private macros to check input parameters
<> 144:ef7eb2e8f9f7 678 * @{
<> 144:ef7eb2e8f9f7 679 */
<> 144:ef7eb2e8f9f7 680 #define IS_RTC_HOUR_FORMAT(FORMAT) (((FORMAT) == RTC_HOURFORMAT_12) || \
<> 144:ef7eb2e8f9f7 681 ((FORMAT) == RTC_HOURFORMAT_24))
<> 144:ef7eb2e8f9f7 682 #define IS_RTC_OUTPUT(OUTPUT) (((OUTPUT) == RTC_OUTPUT_DISABLE) || \
<> 144:ef7eb2e8f9f7 683 ((OUTPUT) == RTC_OUTPUT_ALARMA) || \
<> 144:ef7eb2e8f9f7 684 ((OUTPUT) == RTC_OUTPUT_ALARMB) || \
<> 144:ef7eb2e8f9f7 685 ((OUTPUT) == RTC_OUTPUT_WAKEUP))
<> 144:ef7eb2e8f9f7 686 #define IS_RTC_OUTPUT_POL(POL) (((POL) == RTC_OUTPUT_POLARITY_HIGH) || \
<> 144:ef7eb2e8f9f7 687 ((POL) == RTC_OUTPUT_POLARITY_LOW))
<> 144:ef7eb2e8f9f7 688 #define IS_RTC_OUTPUT_TYPE(TYPE) (((TYPE) == RTC_OUTPUT_TYPE_OPENDRAIN) || \
<> 144:ef7eb2e8f9f7 689 ((TYPE) == RTC_OUTPUT_TYPE_PUSHPULL))
AnnaBridge 167:e84263d55307 690 #define IS_RTC_HOUR12(HOUR) (((HOUR) > 0U) && ((HOUR) <= 12U))
AnnaBridge 167:e84263d55307 691 #define IS_RTC_HOUR24(HOUR) ((HOUR) <= 23U)
AnnaBridge 167:e84263d55307 692 #define IS_RTC_ASYNCH_PREDIV(PREDIV) ((PREDIV) <= 0x7FU)
AnnaBridge 167:e84263d55307 693 #define IS_RTC_SYNCH_PREDIV(PREDIV) ((PREDIV) <= 0x1FFFU)
AnnaBridge 167:e84263d55307 694 #define IS_RTC_MINUTES(MINUTES) ((MINUTES) <= 59U)
AnnaBridge 167:e84263d55307 695 #define IS_RTC_SECONDS(SECONDS) ((SECONDS) <= 59U)
<> 144:ef7eb2e8f9f7 696
<> 144:ef7eb2e8f9f7 697 #define IS_RTC_HOURFORMAT12(PM) (((PM) == RTC_HOURFORMAT12_AM) || ((PM) == RTC_HOURFORMAT12_PM))
<> 144:ef7eb2e8f9f7 698 #define IS_RTC_DAYLIGHT_SAVING(SAVE) (((SAVE) == RTC_DAYLIGHTSAVING_SUB1H) || \
<> 144:ef7eb2e8f9f7 699 ((SAVE) == RTC_DAYLIGHTSAVING_ADD1H) || \
<> 144:ef7eb2e8f9f7 700 ((SAVE) == RTC_DAYLIGHTSAVING_NONE))
<> 144:ef7eb2e8f9f7 701 #define IS_RTC_STORE_OPERATION(OPERATION) (((OPERATION) == RTC_STOREOPERATION_RESET) || \
<> 144:ef7eb2e8f9f7 702 ((OPERATION) == RTC_STOREOPERATION_SET))
<> 144:ef7eb2e8f9f7 703 #define IS_RTC_FORMAT(FORMAT) (((FORMAT) == RTC_FORMAT_BIN) || ((FORMAT) == RTC_FORMAT_BCD))
AnnaBridge 167:e84263d55307 704 #define IS_RTC_YEAR(YEAR) ((YEAR) <= 99U)
AnnaBridge 167:e84263d55307 705 #define IS_RTC_MONTH(MONTH) (((MONTH) >= 1U) && ((MONTH) <= 12U))
AnnaBridge 167:e84263d55307 706 #define IS_RTC_DATE(DATE) (((DATE) >= 1U) && ((DATE) <= 31U))
<> 144:ef7eb2e8f9f7 707 #define IS_RTC_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
<> 144:ef7eb2e8f9f7 708 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
<> 144:ef7eb2e8f9f7 709 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
<> 144:ef7eb2e8f9f7 710 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
<> 144:ef7eb2e8f9f7 711 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
<> 144:ef7eb2e8f9f7 712 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
<> 144:ef7eb2e8f9f7 713 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
AnnaBridge 167:e84263d55307 714 #define IS_RTC_ALARM_DATE_WEEKDAY_DATE(DATE) (((DATE) > 0U) && ((DATE) <= 31U))
<> 144:ef7eb2e8f9f7 715 #define IS_RTC_ALARM_DATE_WEEKDAY_WEEKDAY(WEEKDAY) (((WEEKDAY) == RTC_WEEKDAY_MONDAY) || \
<> 144:ef7eb2e8f9f7 716 ((WEEKDAY) == RTC_WEEKDAY_TUESDAY) || \
<> 144:ef7eb2e8f9f7 717 ((WEEKDAY) == RTC_WEEKDAY_WEDNESDAY) || \
<> 144:ef7eb2e8f9f7 718 ((WEEKDAY) == RTC_WEEKDAY_THURSDAY) || \
<> 144:ef7eb2e8f9f7 719 ((WEEKDAY) == RTC_WEEKDAY_FRIDAY) || \
<> 144:ef7eb2e8f9f7 720 ((WEEKDAY) == RTC_WEEKDAY_SATURDAY) || \
<> 144:ef7eb2e8f9f7 721 ((WEEKDAY) == RTC_WEEKDAY_SUNDAY))
<> 144:ef7eb2e8f9f7 722 #define IS_RTC_ALARM_DATE_WEEKDAY_SEL(SEL) (((SEL) == RTC_ALARMDATEWEEKDAYSEL_DATE) || \
<> 144:ef7eb2e8f9f7 723 ((SEL) == RTC_ALARMDATEWEEKDAYSEL_WEEKDAY))
<> 144:ef7eb2e8f9f7 724 #define IS_RTC_ALARM_MASK(MASK) (((MASK) & 0x7F7F7F7FU) == (uint32_t)RESET)
<> 144:ef7eb2e8f9f7 725 #define IS_RTC_ALARM(ALARM) (((ALARM) == RTC_ALARM_A) || ((ALARM) == RTC_ALARM_B))
<> 144:ef7eb2e8f9f7 726 /**
<> 144:ef7eb2e8f9f7 727 * @}
<> 144:ef7eb2e8f9f7 728 */
<> 144:ef7eb2e8f9f7 729
<> 144:ef7eb2e8f9f7 730 /**
<> 144:ef7eb2e8f9f7 731 * @}
<> 144:ef7eb2e8f9f7 732 */
<> 144:ef7eb2e8f9f7 733
<> 144:ef7eb2e8f9f7 734 /* Private functions ---------------------------------------------------------*/
<> 144:ef7eb2e8f9f7 735 /** @defgroup RTC_Private_Functions RTC Private Functions
<> 144:ef7eb2e8f9f7 736 * @{
<> 144:ef7eb2e8f9f7 737 */
<> 144:ef7eb2e8f9f7 738 HAL_StatusTypeDef RTC_EnterInitMode(RTC_HandleTypeDef* hrtc);
<> 144:ef7eb2e8f9f7 739 uint8_t RTC_ByteToBcd2(uint8_t Value);
<> 144:ef7eb2e8f9f7 740 uint8_t RTC_Bcd2ToByte(uint8_t Value);
<> 144:ef7eb2e8f9f7 741 /**
<> 144:ef7eb2e8f9f7 742 * @}
<> 144:ef7eb2e8f9f7 743 */
<> 144:ef7eb2e8f9f7 744
<> 144:ef7eb2e8f9f7 745 /**
<> 144:ef7eb2e8f9f7 746 * @}
<> 144:ef7eb2e8f9f7 747 */
<> 144:ef7eb2e8f9f7 748
<> 144:ef7eb2e8f9f7 749 /**
<> 144:ef7eb2e8f9f7 750 * @}
<> 144:ef7eb2e8f9f7 751 */
<> 144:ef7eb2e8f9f7 752
<> 144:ef7eb2e8f9f7 753 #ifdef __cplusplus
<> 144:ef7eb2e8f9f7 754 }
<> 144:ef7eb2e8f9f7 755 #endif
<> 144:ef7eb2e8f9f7 756
<> 144:ef7eb2e8f9f7 757 #endif /* __STM32F2xx_HAL_RTC_H */
<> 144:ef7eb2e8f9f7 758
<> 144:ef7eb2e8f9f7 759 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/