meh

Fork of mbed by mbed official

Committer:
Kojto
Date:
Wed May 13 08:08:21 2015 +0200
Revision:
99:dbbf35b96557
Parent:
90:cb3d968589d8
Child:
106:ba1f97679dad
Release 99 of the mbed library

Changes:
- new targets - MAXWSNENV, DISCO_L053C8
- STM32F4xx - ST Cube driver
- KSDK mcu - SPI timing fix
- Nordic - update to softdevice s130

Who changed what in which revision?

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