STM32L4xx_HAL_Driver  1.14.0
stm32l4xx_hal_gpio.h
Go to the documentation of this file.
1 
20 /* Define to prevent recursive inclusion -------------------------------------*/
21 #ifndef __STM32L4xx_HAL_GPIO_H
22 #define __STM32L4xx_HAL_GPIO_H
23 
24 #ifdef __cplusplus
25  extern "C" {
26 #endif
27 
28 /* Includes ------------------------------------------------------------------*/
29 #include "stm32l4xx_hal_def.h"
30 
39 /* Exported types ------------------------------------------------------------*/
40 
47 typedef struct
48 {
49  uint32_t Pin;
52  uint32_t Mode;
55  uint32_t Pull;
58  uint32_t Speed;
61  uint32_t Alternate;
63 }GPIO_InitTypeDef;
64 
68 typedef enum
69 {
77 /* Exported constants --------------------------------------------------------*/
84 #define GPIO_PIN_0 ((uint16_t)0x0001) /* Pin 0 selected */
85 #define GPIO_PIN_1 ((uint16_t)0x0002) /* Pin 1 selected */
86 #define GPIO_PIN_2 ((uint16_t)0x0004) /* Pin 2 selected */
87 #define GPIO_PIN_3 ((uint16_t)0x0008) /* Pin 3 selected */
88 #define GPIO_PIN_4 ((uint16_t)0x0010) /* Pin 4 selected */
89 #define GPIO_PIN_5 ((uint16_t)0x0020) /* Pin 5 selected */
90 #define GPIO_PIN_6 ((uint16_t)0x0040) /* Pin 6 selected */
91 #define GPIO_PIN_7 ((uint16_t)0x0080) /* Pin 7 selected */
92 #define GPIO_PIN_8 ((uint16_t)0x0100) /* Pin 8 selected */
93 #define GPIO_PIN_9 ((uint16_t)0x0200) /* Pin 9 selected */
94 #define GPIO_PIN_10 ((uint16_t)0x0400) /* Pin 10 selected */
95 #define GPIO_PIN_11 ((uint16_t)0x0800) /* Pin 11 selected */
96 #define GPIO_PIN_12 ((uint16_t)0x1000) /* Pin 12 selected */
97 #define GPIO_PIN_13 ((uint16_t)0x2000) /* Pin 13 selected */
98 #define GPIO_PIN_14 ((uint16_t)0x4000) /* Pin 14 selected */
99 #define GPIO_PIN_15 ((uint16_t)0x8000) /* Pin 15 selected */
100 #define GPIO_PIN_All ((uint16_t)0xFFFF) /* All pins selected */
101 
102 #define GPIO_PIN_MASK (0x0000FFFFu) /* PIN mask for assert test */
103 
117 #define GPIO_MODE_INPUT (0x00000000u)
118 #define GPIO_MODE_OUTPUT_PP (0x00000001u)
119 #define GPIO_MODE_OUTPUT_OD (0x00000011u)
120 #define GPIO_MODE_AF_PP (0x00000002u)
121 #define GPIO_MODE_AF_OD (0x00000012u)
122 #define GPIO_MODE_ANALOG (0x00000003u)
123 #define GPIO_MODE_ANALOG_ADC_CONTROL (0x0000000Bu)
124 #define GPIO_MODE_IT_RISING (0x10110000u)
125 #define GPIO_MODE_IT_FALLING (0x10210000u)
126 #define GPIO_MODE_IT_RISING_FALLING (0x10310000u)
127 #define GPIO_MODE_EVT_RISING (0x10120000u)
128 #define GPIO_MODE_EVT_FALLING (0x10220000u)
129 #define GPIO_MODE_EVT_RISING_FALLING (0x10320000u)
138 #define GPIO_SPEED_FREQ_LOW (0x00000000u)
139 #define GPIO_SPEED_FREQ_MEDIUM (0x00000001u)
140 #define GPIO_SPEED_FREQ_HIGH (0x00000002u)
141 #define GPIO_SPEED_FREQ_VERY_HIGH (0x00000003u)
150 #define GPIO_NOPULL (0x00000000u)
151 #define GPIO_PULLUP (0x00000001u)
152 #define GPIO_PULLDOWN (0x00000002u)
161 /* Exported macro ------------------------------------------------------------*/
162 
172 #define __HAL_GPIO_EXTI_GET_FLAG(__EXTI_LINE__) (EXTI->PR1 & (__EXTI_LINE__))
173 
180 #define __HAL_GPIO_EXTI_CLEAR_FLAG(__EXTI_LINE__) (EXTI->PR1 = (__EXTI_LINE__))
181 
188 #define __HAL_GPIO_EXTI_GET_IT(__EXTI_LINE__) (EXTI->PR1 & (__EXTI_LINE__))
189 
196 #define __HAL_GPIO_EXTI_CLEAR_IT(__EXTI_LINE__) (EXTI->PR1 = (__EXTI_LINE__))
197 
204 #define __HAL_GPIO_EXTI_GENERATE_SWIT(__EXTI_LINE__) (EXTI->SWIER1 |= (__EXTI_LINE__))
205 
210 /* Private macros ------------------------------------------------------------*/
214 #define IS_GPIO_PIN_ACTION(ACTION) (((ACTION) == GPIO_PIN_RESET) || ((ACTION) == GPIO_PIN_SET))
215 
216 #define IS_GPIO_PIN(__PIN__) ((((uint32_t)(__PIN__) & GPIO_PIN_MASK) != 0x00U) &&\
217  (((uint32_t)(__PIN__) & ~GPIO_PIN_MASK) == 0x00U))
218 
219 #define IS_GPIO_MODE(__MODE__) (((__MODE__) == GPIO_MODE_INPUT) ||\
220  ((__MODE__) == GPIO_MODE_OUTPUT_PP) ||\
221  ((__MODE__) == GPIO_MODE_OUTPUT_OD) ||\
222  ((__MODE__) == GPIO_MODE_AF_PP) ||\
223  ((__MODE__) == GPIO_MODE_AF_OD) ||\
224  ((__MODE__) == GPIO_MODE_IT_RISING) ||\
225  ((__MODE__) == GPIO_MODE_IT_FALLING) ||\
226  ((__MODE__) == GPIO_MODE_IT_RISING_FALLING) ||\
227  ((__MODE__) == GPIO_MODE_EVT_RISING) ||\
228  ((__MODE__) == GPIO_MODE_EVT_FALLING) ||\
229  ((__MODE__) == GPIO_MODE_EVT_RISING_FALLING) ||\
230  ((__MODE__) == GPIO_MODE_ANALOG) ||\
231  ((__MODE__) == GPIO_MODE_ANALOG_ADC_CONTROL))
232 
233 #define IS_GPIO_SPEED(__SPEED__) (((__SPEED__) == GPIO_SPEED_FREQ_LOW) ||\
234  ((__SPEED__) == GPIO_SPEED_FREQ_MEDIUM) ||\
235  ((__SPEED__) == GPIO_SPEED_FREQ_HIGH) ||\
236  ((__SPEED__) == GPIO_SPEED_FREQ_VERY_HIGH))
237 
238 #define IS_GPIO_PULL(__PULL__) (((__PULL__) == GPIO_NOPULL) ||\
239  ((__PULL__) == GPIO_PULLUP) || \
240  ((__PULL__) == GPIO_PULLDOWN))
241 
245 /* Include GPIO HAL Extended module */
246 #include "stm32l4xx_hal_gpio_ex.h"
247 
248 /* Exported functions --------------------------------------------------------*/
258 /* Initialization and de-initialization functions *****************************/
259 void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);
260 void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin);
261 
270 /* IO operation functions *****************************************************/
271 GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
272 void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);
273 void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
274 HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
275 void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);
276 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);
277 
294 #ifdef __cplusplus
295 }
296 #endif
297 
298 #endif /* __STM32L4xx_HAL_GPIO_H */
299 
300 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
Read the specified input port pin.
void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin)
De-initialize the GPIOx peripheral registers to their default reset values.
void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin)
Handle EXTI interrupt request.
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
EXTI line detection callback.
This file contains HAL common defines, enumeration, macros and structures definitions.
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
Set or clear the selected data port bit.
GPIO_PinState
GPIO Bit SET and Bit RESET enumeration.
HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
Lock GPIO Pins configuration registers.
void HAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init)
Initialize the GPIOx peripheral according to the specified parameters in the GPIO_Init.
Header file of GPIO HAL Extended module.
void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin)
Toggle the specified GPIO pin.