1 /**
2   ******************************************************************************
3   * @file    stm32h7rsxx_hal_exti.h
4   * @author  MCD Application Team
5   * @brief   Header file of EXTI HAL module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2022 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32H7RSxx_HAL_EXTI_H
21 #define STM32H7RSxx_HAL_EXTI_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32h7rsxx_hal_def.h"
29 
30 /** @addtogroup STM32H7RSxx_HAL_Driver
31   * @{
32   */
33 
34 /** @defgroup EXTI EXTI
35   * @brief EXTI HAL module driver
36   * @{
37   */
38 
39 /* Exported types ------------------------------------------------------------*/
40 
41 /** @defgroup EXTI_Exported_Types EXTI Exported Types
42   * @{
43   */
44 typedef enum
45 {
46   HAL_EXTI_COMMON_CB_ID          = 0x00U,
47 } EXTI_CallbackIDTypeDef;
48 
49 
50 /**
51   * @brief  EXTI Handle structure definition
52   */
53 typedef struct
54 {
55   uint32_t Line;                    /*!<  Exti line number */
56   void (* PendingCallback)(void);   /*!<  Exti pending callback */
57 } EXTI_HandleTypeDef;
58 
59 /**
60   * @brief  EXTI Configuration structure definition
61   */
62 typedef struct
63 {
64   uint32_t Line;      /*!< The Exti line to be configured. This parameter
65                            can be a value of @ref EXTI_Line */
66   uint32_t Mode;      /*!< The Exit Mode to be configured for a core.
67                            This parameter can be a combination of @ref EXTI_Mode */
68   uint32_t Trigger;   /*!< The Exti Trigger to be configured. This parameter
69                            can be a value of @ref EXTI_Trigger */
70   uint32_t GPIOSel;   /*!< The Exti GPIO multiplexer selection to be configured.
71                            This parameter is only possible for line 0 to 15. It
72                            can be a value of @ref EXTI_GPIOSel */
73 } EXTI_ConfigTypeDef;
74 
75 /**
76   * @}
77   */
78 
79 /* Exported constants --------------------------------------------------------*/
80 /** @defgroup EXTI_Exported_Constants EXTI Exported Constants
81   * @{
82   */
83 
84 /** @defgroup EXTI_Line  EXTI Line
85   * @{
86   */
87 #define EXTI_LINE_0                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x00u)
88 #define EXTI_LINE_1                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x01u)
89 #define EXTI_LINE_2                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x02u)
90 #define EXTI_LINE_3                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x03u)
91 #define EXTI_LINE_4                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x04u)
92 #define EXTI_LINE_5                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x05u)
93 #define EXTI_LINE_6                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x06u)
94 #define EXTI_LINE_7                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x07u)
95 #define EXTI_LINE_8                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x08u)
96 #define EXTI_LINE_9                         (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x09u)
97 #define EXTI_LINE_10                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Au)
98 #define EXTI_LINE_11                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Bu)
99 #define EXTI_LINE_12                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Cu)
100 #define EXTI_LINE_13                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Du)
101 #define EXTI_LINE_14                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Eu)
102 #define EXTI_LINE_15                        (EXTI_GPIO     | EXTI_REG1 | EXTI_EVENT | 0x0Fu)
103 #define EXTI_LINE_16                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x10u)
104 #define EXTI_LINE_17                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x11u)
105 #define EXTI_LINE_18                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x12u)
106 #define EXTI_LINE_19                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x13u)
107 #define EXTI_LINE_20                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x14u)
108 #define EXTI_LINE_21                        (EXTI_CONFIG   | EXTI_REG1 | EXTI_EVENT | 0x15u)
109 #define EXTI_LINE_22                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x16u)
110 #define EXTI_LINE_23                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x17u)
111 #define EXTI_LINE_24                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x18u)
112 #define EXTI_LINE_25                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x19u)
113 #define EXTI_LINE_26                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x1Au)
114 #define EXTI_LINE_27                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x1Bu)
115 #define EXTI_LINE_28                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x1Cu)
116 #define EXTI_LINE_29                        (EXTI_RESERVED | EXTI_REG1              | 0x1Du)
117 #define EXTI_LINE_30                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x1Eu)
118 #define EXTI_LINE_31                        (EXTI_DIRECT   | EXTI_REG1 | EXTI_EVENT | 0x1Fu)
119 #define EXTI_LINE_32                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x00u)
120 #define EXTI_LINE_33                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x01u)
121 #define EXTI_LINE_34                        (EXTI_CONFIG   | EXTI_REG2 | EXTI_EVENT | 0x02u)
122 #define EXTI_LINE_35                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x03u)
123 #define EXTI_LINE_36                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x04u)
124 #define EXTI_LINE_37                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x05u)
125 #define EXTI_LINE_38                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x06u)
126 #define EXTI_LINE_39                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x07u)
127 #define EXTI_LINE_40                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x08u)
128 #define EXTI_LINE_41                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x09u)
129 #define EXTI_LINE_42                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x0Au)
130 #define EXTI_LINE_43                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x0Bu)
131 #define EXTI_LINE_44                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x0Cu)
132 #define EXTI_LINE_45                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x0Du)
133 #define EXTI_LINE_46                        (EXTI_CONFIG   | EXTI_REG2 | EXTI_EVENT | 0x0Eu)
134 #define EXTI_LINE_47                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x0Fu)
135 #define EXTI_LINE_48                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x10u)
136 #define EXTI_LINE_49                        (EXTI_CONFIG   | EXTI_REG2 | EXTI_EVENT | 0x11u)
137 #define EXTI_LINE_50                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x12u)
138 #define EXTI_LINE_51                        (EXTI_CONFIG   | EXTI_REG2 | EXTI_EVENT | 0x13u)
139 #define EXTI_LINE_52                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x14u)
140 #define EXTI_LINE_53                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x15u)
141 #define EXTI_LINE_54                        (EXTI_CONFIG   | EXTI_REG2 | EXTI_EVENT | 0x16u)
142 #define EXTI_LINE_55                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x17u)
143 #define EXTI_LINE_56                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x18u)
144 #define EXTI_LINE_57                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x19u)
145 #define EXTI_LINE_58                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x1Au)
146 #define EXTI_LINE_59                        (EXTI_DIRECT   | EXTI_REG2 | EXTI_EVENT | 0x1Bu)
147 #define EXTI_LINE_77                        (EXTI_DIRECT   | EXTI_REG3 | EXTI_EVENT | 0x0Du)
148 /**
149   * @}
150   */
151 
152 /** @defgroup EXTI_Mode  EXTI Mode
153   * @{
154   */
155 #define EXTI_MODE_NONE                      0x00000000u
156 #define EXTI_MODE_INTERRUPT                 0x00000001u
157 #define EXTI_MODE_EVENT                     0x00000002u
158 /**
159   * @}
160   */
161 
162 /** @defgroup EXTI_Trigger  EXTI Trigger
163   * @{
164   */
165 #define EXTI_TRIGGER_NONE                   0x00000000u
166 #define EXTI_TRIGGER_RISING                 0x00000001u
167 #define EXTI_TRIGGER_FALLING                0x00000002u
168 #define EXTI_TRIGGER_RISING_FALLING         (EXTI_TRIGGER_RISING | EXTI_TRIGGER_FALLING)
169 /**
170   * @}
171   */
172 
173 /** @defgroup EXTI_GPIOSel  EXTI GPIOSel
174   * @brief
175   * @{
176   */
177 #define EXTI_GPIOA                          0x00000000u
178 #define EXTI_GPIOB                          0x00000001u
179 #define EXTI_GPIOC                          0x00000002u
180 #define EXTI_GPIOD                          0x00000003u
181 #define EXTI_GPIOE                          0x00000004u
182 #define EXTI_GPIOF                          0x00000005u
183 #define EXTI_GPIOG                          0x00000006u
184 #define EXTI_GPIOH                          0x00000007u
185 #define EXTI_GPIOM                          0x0000000Cu
186 #define EXTI_GPION                          0x0000000Du
187 #define EXTI_GPIOO                          0x0000000Eu
188 #define EXTI_GPIOP                          0x0000000Fu
189 /**
190   * @}
191   */
192 
193 /**
194   * @}
195   */
196 
197 /* Exported macro ------------------------------------------------------------*/
198 /** @defgroup EXTI_Exported_Macros EXTI Exported Macros
199   * @{
200   */
201 
202 /**
203   * @}
204   */
205 
206 /* Private constants --------------------------------------------------------*/
207 /** @defgroup EXTI_Private_Constants EXTI Private Constants
208   * @{
209   */
210 /**
211   * @brief  EXTI Line property definition
212   */
213 #define EXTI_PROPERTY_SHIFT                 24u
214 #define EXTI_DIRECT                         (0x01uL << EXTI_PROPERTY_SHIFT)
215 #define EXTI_CONFIG                         (0x02uL << EXTI_PROPERTY_SHIFT)
216 #define EXTI_GPIO                           ((0x04uL << EXTI_PROPERTY_SHIFT) | EXTI_CONFIG)
217 #define EXTI_RESERVED                       (0x08uL << EXTI_PROPERTY_SHIFT)
218 #define EXTI_PROPERTY_MASK                  (EXTI_DIRECT | EXTI_CONFIG | EXTI_GPIO)
219 
220 /**
221   * @brief  EXTI Event presence definition
222   */
223 #define EXTI_EVENT_PRESENCE_SHIFT           28u
224 #define EXTI_EVENT                          (0x01uL << EXTI_EVENT_PRESENCE_SHIFT)
225 #define EXTI_EVENT_PRESENCE_MASK            (EXTI_EVENT)
226 
227 /**
228   * @brief  EXTI Register and bit usage
229   */
230 #define EXTI_REG_SHIFT                      16u
231 #define EXTI_REG1                           (0x00uL << EXTI_REG_SHIFT)
232 #define EXTI_REG2                           (0x01uL << EXTI_REG_SHIFT)
233 #define EXTI_REG3                           (0x02uL << EXTI_REG_SHIFT)
234 #define EXTI_REG_MASK                       (EXTI_REG1 | EXTI_REG2 | EXTI_REG3)
235 #define EXTI_PIN_MASK                       0x0000001Fu
236 
237 /**
238   * @brief  EXTI Mask for interrupt & event mode
239   */
240 #define EXTI_MODE_MASK                      (EXTI_MODE_EVENT | EXTI_MODE_INTERRUPT)
241 
242 /**
243   * @brief  EXTI Mask for trigger possibilities
244   */
245 #define EXTI_TRIGGER_MASK                   (EXTI_TRIGGER_RISING | EXTI_TRIGGER_FALLING)
246 
247 /**
248   * @brief  EXTI Line number
249   */
250 #define EXTI_LINE_NB                        78u
251 
252 /**
253   * @}
254   */
255 
256 /* Private macros ------------------------------------------------------------*/
257 /** @defgroup EXTI_Private_Macros EXTI Private Macros
258   * @{
259   */
260 #define IS_EXTI_LINE(__LINE__)          ((((__LINE__) & ~(EXTI_PROPERTY_MASK | EXTI_EVENT_PRESENCE_MASK | EXTI_REG_MASK | EXTI_PIN_MASK)) == 0x00u) && \
261                                          ((((__LINE__) & EXTI_PROPERTY_MASK) == EXTI_DIRECT)   || \
262                                           (((__LINE__) & EXTI_PROPERTY_MASK) == EXTI_CONFIG)   || \
263                                           (((__LINE__) & EXTI_PROPERTY_MASK) == EXTI_GPIO))    && \
264                                          ((((__LINE__) & (EXTI_REG_MASK | EXTI_PIN_MASK))      < \
265                                            (((EXTI_LINE_NB / 32u) << EXTI_REG_SHIFT) | (EXTI_LINE_NB % 32u))) || \
266                                           (((__LINE__) & (EXTI_REG_MASK | EXTI_PIN_MASK)) == 0x0002000DUL)))
267 
268 #define IS_EXTI_MODE(__LINE__)          ((((__LINE__) & EXTI_MODE_MASK) != 0x00u) && \
269                                          (((__LINE__) & ~EXTI_MODE_MASK) == 0x00u))
270 
271 #define IS_EXTI_TRIGGER(__LINE__)       (((__LINE__) & ~EXTI_TRIGGER_MASK) == 0x00u)
272 
273 #define IS_EXTI_PENDING_EDGE(__LINE__)  ((__LINE__) == EXTI_TRIGGER_RISING_FALLING)
274 
275 #define IS_EXTI_CONFIG_LINE(__LINE__)   (((__LINE__) & EXTI_CONFIG) != 0x00u)
276 
277 #define IS_EXTI_GPIO_PORT(__PORT__)     (((__PORT__) == EXTI_GPIOA) || \
278                                          ((__PORT__) == EXTI_GPIOB) || \
279                                          ((__PORT__) == EXTI_GPIOC) || \
280                                          ((__PORT__) == EXTI_GPIOD) || \
281                                          ((__PORT__) == EXTI_GPIOE) || \
282                                          ((__PORT__) == EXTI_GPIOF) || \
283                                          ((__PORT__) == EXTI_GPIOG) || \
284                                          ((__PORT__) == EXTI_GPIOH) || \
285                                          ((__PORT__) == EXTI_GPIOM) || \
286                                          ((__PORT__) == EXTI_GPION) || \
287                                          ((__PORT__) == EXTI_GPIOO) || \
288                                          ((__PORT__) == EXTI_GPIOP))
289 
290 #define IS_EXTI_GPIO_PIN(__PIN__)       ((__PIN__) < 16u)
291 /**
292   * @}
293   */
294 
295 
296 /* Exported functions --------------------------------------------------------*/
297 /** @defgroup EXTI_Exported_Functions EXTI Exported Functions
298   * @brief    EXTI Exported Functions
299   * @{
300   */
301 
302 /** @defgroup EXTI_Exported_Functions_Group1 Configuration functions
303   * @brief    Configuration functions
304   * @{
305   */
306 /* Configuration functions ****************************************************/
307 HAL_StatusTypeDef HAL_EXTI_SetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig);
308 HAL_StatusTypeDef HAL_EXTI_GetConfigLine(EXTI_HandleTypeDef *hexti, EXTI_ConfigTypeDef *pExtiConfig);
309 HAL_StatusTypeDef HAL_EXTI_ClearConfigLine(const EXTI_HandleTypeDef *hexti);
310 HAL_StatusTypeDef HAL_EXTI_RegisterCallback(EXTI_HandleTypeDef *hexti, EXTI_CallbackIDTypeDef CallbackID, void (*pPendingCbfn)(void));
311 HAL_StatusTypeDef HAL_EXTI_GetHandle(EXTI_HandleTypeDef *hexti, uint32_t ExtiLine);
312 /**
313   * @}
314   */
315 
316 /** @defgroup EXTI_Exported_Functions_Group2 IO operation functions
317   * @brief    IO operation functions
318   * @{
319   */
320 /* IO operation functions *****************************************************/
321 void              HAL_EXTI_IRQHandler(const EXTI_HandleTypeDef *hexti);
322 uint32_t          HAL_EXTI_GetPending(const EXTI_HandleTypeDef *hexti, uint32_t Edge);
323 void              HAL_EXTI_ClearPending(const EXTI_HandleTypeDef *hexti, uint32_t Edge);
324 void              HAL_EXTI_GenerateSWI(const EXTI_HandleTypeDef *hexti);
325 
326 /**
327   * @}
328   */
329 
330 /**
331   * @}
332   */
333 
334 /**
335   * @}
336   */
337 
338 /**
339   * @}
340   */
341 
342 #ifdef __cplusplus
343 }
344 #endif
345 
346 #endif /* STM32H7RSxx_HAL_EXTI_H */
347