lib/main/STM32F7/Drivers/STM32F7xx_HAL_Driver/Inc/stm32f7xx_hal_gpio.h

   1 /**
   2   ******************************************************************************
   3   * @file    stm32f7xx_hal_gpio.h
   4   * @author  MCD Application Team
   5   * @brief   Header file of GPIO HAL module.
   6   ******************************************************************************
   7   * @attention
   8   *
   9   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
  10   * All rights reserved.</center></h2>
  11   *
  12   * This software component is licensed by ST under BSD 3-Clause license,
  13   * the "License"; You may not use this file except in compliance with the
  14   * License. You may obtain a copy of the License at:
  15   *                        opensource.org/licenses/BSD-3-Clause
  16   *
  17   ******************************************************************************
  18   */
  19
  20 /* Define to prevent recursive inclusion -------------------------------------*/
  21 #ifndef __STM32F7xx_HAL_GPIO_H
  22 #define __STM32F7xx_HAL_GPIO_H
  23
  24 #ifdef __cplusplus
  25  extern "C" {
  26 #endif
  27
  28 /* Includes ------------------------------------------------------------------*/
  29 #include "stm32f7xx_hal_def.h"
  30
  31 /** @addtogroup STM32F7xx_HAL_Driver
  32   * @{
  33   */
  34
  35 /** @addtogroup GPIO
  36   * @{
  37   */
  38
  39 /* Exported types ------------------------------------------------------------*/
  40 /** @defgroup GPIO_Exported_Types GPIO Exported Types
  41   * @{
  42   */
  43
  44 /**
  45   * @brief GPIO Init structure definition
  46   */
  47 typedef struct
  48 {
  49   uint32_t Pin;       /*!< Specifies the GPIO pins to be configured.
  50                            This parameter can be any value of @ref GPIO_pins_define */
  51
  52   uint32_t Mode;      /*!< Specifies the operating mode for the selected pins.
  53                            This parameter can be a value of @ref GPIO_mode_define */
  54
  55   uint32_t Pull;      /*!< Specifies the Pull-up or Pull-Down activation for the selected pins.
  56                            This parameter can be a value of @ref GPIO_pull_define */
  57
  58   uint32_t Speed;     /*!< Specifies the speed for the selected pins.
  59                            This parameter can be a value of @ref GPIO_speed_define */
  60
  61   uint32_t Alternate;  /*!< Peripheral to be connected to the selected pins.
  62                             This parameter can be a value of @ref GPIO_Alternate_function_selection */
  63 }GPIO_InitTypeDef;
  64
  65 /**
  66   * @brief  GPIO Bit SET and Bit RESET enumeration
  67   */
  68 typedef enum
  69 {
  70   GPIO_PIN_RESET = 0,
  71   GPIO_PIN_SET
  72 }GPIO_PinState;
  73 /**
  74   * @}
  75   */
  76
  77 /* Exported constants --------------------------------------------------------*/
  78
  79 /** @defgroup GPIO_Exported_Constants GPIO Exported Constants
  80   * @{
  81   */
  82
  83 /** @defgroup GPIO_pins_define GPIO pins define
  84   * @{
  85   */
  86 #define GPIO_PIN_0                 ((uint16_t)0x0001U)  /* Pin 0 selected    */
  87 #define GPIO_PIN_1                 ((uint16_t)0x0002U)  /* Pin 1 selected    */
  88 #define GPIO_PIN_2                 ((uint16_t)0x0004U)  /* Pin 2 selected    */
  89 #define GPIO_PIN_3                 ((uint16_t)0x0008U)  /* Pin 3 selected    */
  90 #define GPIO_PIN_4                 ((uint16_t)0x0010U)  /* Pin 4 selected    */
  91 #define GPIO_PIN_5                 ((uint16_t)0x0020U)  /* Pin 5 selected    */
  92 #define GPIO_PIN_6                 ((uint16_t)0x0040U)  /* Pin 6 selected    */
  93 #define GPIO_PIN_7                 ((uint16_t)0x0080U)  /* Pin 7 selected    */
  94 #define GPIO_PIN_8                 ((uint16_t)0x0100U)  /* Pin 8 selected    */
  95 #define GPIO_PIN_9                 ((uint16_t)0x0200U)  /* Pin 9 selected    */
  96 #define GPIO_PIN_10                ((uint16_t)0x0400U)  /* Pin 10 selected   */
  97 #define GPIO_PIN_11                ((uint16_t)0x0800U)  /* Pin 11 selected   */
  98 #define GPIO_PIN_12                ((uint16_t)0x1000U)  /* Pin 12 selected   */
  99 #define GPIO_PIN_13                ((uint16_t)0x2000U)  /* Pin 13 selected   */
 100 #define GPIO_PIN_14                ((uint16_t)0x4000U)  /* Pin 14 selected   */
 101 #define GPIO_PIN_15                ((uint16_t)0x8000U)  /* Pin 15 selected   */
 102 #define GPIO_PIN_All               ((uint16_t)0xFFFFU)  /* All pins selected */
 103
 104 #define GPIO_PIN_MASK              ((uint32_t)0x0000FFFFU) /* PIN mask for assert test */
 105 /**
 106   * @}
 107   */
 108
 109 /** @defgroup GPIO_mode_define GPIO mode define
 110   * @brief GPIO Configuration Mode
 111   *        Elements values convention: 0xX0yz00YZ
 112   *           - X  : GPIO mode or EXTI Mode
 113   *           - y  : External IT or Event trigger detection
 114   *           - z  : IO configuration on External IT or Event
 115   *           - Y  : Output type (Push Pull or Open Drain)
 116   *           - Z  : IO Direction mode (Input, Output, Alternate or Analog)
 117   * @{
 118   */
 119 #define  GPIO_MODE_INPUT                        ((uint32_t)0x00000000U)   /*!< Input Floating Mode                   */
 120 #define  GPIO_MODE_OUTPUT_PP                    ((uint32_t)0x00000001U)   /*!< Output Push Pull Mode                 */
 121 #define  GPIO_MODE_OUTPUT_OD                    ((uint32_t)0x00000011U)   /*!< Output Open Drain Mode                */
 122 #define  GPIO_MODE_AF_PP                        ((uint32_t)0x00000002U)   /*!< Alternate Function Push Pull Mode     */
 123 #define  GPIO_MODE_AF_OD                        ((uint32_t)0x00000012U)   /*!< Alternate Function Open Drain Mode    */
 124
 125 #define  GPIO_MODE_ANALOG                       ((uint32_t)0x00000003U)   /*!< Analog Mode  */
 126
 127 #define  GPIO_MODE_IT_RISING                    ((uint32_t)0x10110000U)   /*!< External Interrupt Mode with Rising edge trigger detection          */
 128 #define  GPIO_MODE_IT_FALLING                   ((uint32_t)0x10210000U)   /*!< External Interrupt Mode with Falling edge trigger detection         */
 129 #define  GPIO_MODE_IT_RISING_FALLING            ((uint32_t)0x10310000U)   /*!< External Interrupt Mode with Rising/Falling edge trigger detection  */
 130
 131 #define  GPIO_MODE_EVT_RISING                   ((uint32_t)0x10120000U)   /*!< External Event Mode with Rising edge trigger detection               */
 132 #define  GPIO_MODE_EVT_FALLING                  ((uint32_t)0x10220000U)   /*!< External Event Mode with Falling edge trigger detection              */
 133 #define  GPIO_MODE_EVT_RISING_FALLING           ((uint32_t)0x10320000U)   /*!< External Event Mode with Rising/Falling edge trigger detection       */
 134 /**
 135   * @}
 136   */
 137
 138 /** @defgroup GPIO_speed_define  GPIO speed define
 139   * @brief GPIO Output Maximum frequency
 140   * @{
 141   */
 142 #define  GPIO_SPEED_FREQ_LOW         ((uint32_t)0x00000000U)  /*!< Low speed     */
 143 #define  GPIO_SPEED_FREQ_MEDIUM      ((uint32_t)0x00000001U)  /*!< Medium speed  */
 144 #define  GPIO_SPEED_FREQ_HIGH        ((uint32_t)0x00000002U)  /*!< Fast speed    */
 145 #define  GPIO_SPEED_FREQ_VERY_HIGH   ((uint32_t)0x00000003U)  /*!< High speed    */
 146 /**
 147   * @}
 148   */
 149
 150  /** @defgroup GPIO_pull_define GPIO pull define
 151    * @brief GPIO Pull-Up or Pull-Down Activation
 152    * @{
 153    */
 154 #define  GPIO_NOPULL        ((uint32_t)0x00000000U)   /*!< No Pull-up or Pull-down activation  */
 155 #define  GPIO_PULLUP        ((uint32_t)0x00000001U)   /*!< Pull-up activation                  */
 156 #define  GPIO_PULLDOWN      ((uint32_t)0x00000002U)   /*!< Pull-down activation                */
 157 /**
 158   * @}
 159   */
 160
 161 /**
 162   * @}
 163   */
 164
 165 /* Exported macro ------------------------------------------------------------*/
 166 /** @defgroup GPIO_Exported_Macros GPIO Exported Macros
 167   * @{
 168   */
 169
 170 /**
 171   * @brief  Checks whether the specified EXTI line flag is set or not.
 172   * @param  __EXTI_LINE__ specifies the EXTI line flag to check.
 173   *         This parameter can be GPIO_PIN_x where x can be(0..15)
 174   * @retval The new state of __EXTI_LINE__ (SET or RESET).
 175   */
 176 #define __HAL_GPIO_EXTI_GET_FLAG(__EXTI_LINE__) (EXTI->PR & (__EXTI_LINE__))
 177
 178 /**
 179   * @brief  Clears the EXTI's line pending flags.
 180   * @param  __EXTI_LINE__ specifies the EXTI lines flags to clear.
 181   *         This parameter can be any combination of GPIO_PIN_x where x can be (0..15)
 182   * @retval None
 183   */
 184 #define __HAL_GPIO_EXTI_CLEAR_FLAG(__EXTI_LINE__) (EXTI->PR = (__EXTI_LINE__))
 185
 186 /**
 187   * @brief  Checks whether the specified EXTI line is asserted or not.
 188   * @param  __EXTI_LINE__ specifies the EXTI line to check.
 189   *          This parameter can be GPIO_PIN_x where x can be(0..15)
 190   * @retval The new state of __EXTI_LINE__ (SET or RESET).
 191   */
 192 #define __HAL_GPIO_EXTI_GET_IT(__EXTI_LINE__) (EXTI->PR & (__EXTI_LINE__))
 193
 194 /**
 195   * @brief  Clears the EXTI's line pending bits.
 196   * @param  __EXTI_LINE__ specifies the EXTI lines to clear.
 197   *          This parameter can be any combination of GPIO_PIN_x where x can be (0..15)
 198   * @retval None
 199   */
 200 #define __HAL_GPIO_EXTI_CLEAR_IT(__EXTI_LINE__) (EXTI->PR = (__EXTI_LINE__))
 201
 202 /**
 203   * @brief  Generates a Software interrupt on selected EXTI line.
 204   * @param  __EXTI_LINE__ specifies the EXTI line to check.
 205   *          This parameter can be GPIO_PIN_x where x can be(0..15)
 206   * @retval None
 207   */
 208 #define __HAL_GPIO_EXTI_GENERATE_SWIT(__EXTI_LINE__) (EXTI->SWIER |= (__EXTI_LINE__))
 209 /**
 210   * @}
 211   */
 212
 213 /* Include GPIO HAL Extension module */
 214 #include "stm32f7xx_hal_gpio_ex.h"
 215
 216 /* Exported functions --------------------------------------------------------*/
 217 /** @addtogroup GPIO_Exported_Functions
 218   * @{
 219   */
 220
 221 /** @addtogroup GPIO_Exported_Functions_Group1
 222   * @{
 223   */
 224 /* Initialization and de-initialization functions *****************************/
 225 void  HAL_GPIO_Init(GPIO_TypeDef  *GPIOx, GPIO_InitTypeDef *GPIO_Init);
 226 void  HAL_GPIO_DeInit(GPIO_TypeDef  *GPIOx, uint32_t GPIO_Pin);
 227 /**
 228   * @}
 229   */
 230
 231 /** @addtogroup GPIO_Exported_Functions_Group2
 232   * @{
 233   */
 234 /* IO operation functions *****************************************************/
 235 GPIO_PinState HAL_GPIO_ReadPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
 236 void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);
 237 void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
 238 HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
 239 void HAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);
 240 void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);
 241
 242 /**
 243   * @}
 244   */
 245
 246 /**
 247   * @}
 248   */
 249 /* Private types -------------------------------------------------------------*/
 250 /* Private variables ---------------------------------------------------------*/
 251 /* Private constants ---------------------------------------------------------*/
 252 /** @defgroup GPIO_Private_Constants GPIO Private Constants
 253   * @{
 254   */
 255
 256 /**
 257   * @}
 258   */
 259
 260 /* Private macros ------------------------------------------------------------*/
 261 /** @defgroup GPIO_Private_Macros GPIO Private Macros
 262   * @{
 263   */
 264 #define IS_GPIO_PIN_ACTION(ACTION) (((ACTION) == GPIO_PIN_RESET) || ((ACTION) == GPIO_PIN_SET))
 265 #define IS_GPIO_PIN(__PIN__)        ((((__PIN__) & GPIO_PIN_MASK) != (uint32_t)0x00))
 266 #define IS_GPIO_MODE(MODE) (((MODE) == GPIO_MODE_INPUT)              ||\
 267                             ((MODE) == GPIO_MODE_OUTPUT_PP)          ||\
 268                             ((MODE) == GPIO_MODE_OUTPUT_OD)          ||\
 269                             ((MODE) == GPIO_MODE_AF_PP)              ||\
 270                             ((MODE) == GPIO_MODE_AF_OD)              ||\
 271                             ((MODE) == GPIO_MODE_IT_RISING)          ||\
 272                             ((MODE) == GPIO_MODE_IT_FALLING)         ||\
 273                             ((MODE) == GPIO_MODE_IT_RISING_FALLING)  ||\
 274                             ((MODE) == GPIO_MODE_EVT_RISING)         ||\
 275                             ((MODE) == GPIO_MODE_EVT_FALLING)        ||\
 276                             ((MODE) == GPIO_MODE_EVT_RISING_FALLING) ||\
 277                             ((MODE) == GPIO_MODE_ANALOG))
 278 #define IS_GPIO_SPEED(SPEED) (((SPEED) == GPIO_SPEED_LOW)  || ((SPEED) == GPIO_SPEED_MEDIUM) || \
 279                               ((SPEED) == GPIO_SPEED_FAST) || ((SPEED) == GPIO_SPEED_HIGH))
 280 #define IS_GPIO_PULL(PULL) (((PULL) == GPIO_NOPULL) || ((PULL) == GPIO_PULLUP) || \
 281                             ((PULL) == GPIO_PULLDOWN))
 282 /**
 283   * @}
 284   */
 285
 286 /* Private functions ---------------------------------------------------------*/
 287 /** @defgroup GPIO_Private_Functions GPIO Private Functions
 288   * @{
 289   */
 290
 291 /**
 292   * @}
 293   */
 294
 295 /**
 296   * @}
 297   */
 298
 299 /**
 300   * @}
 301   */
 302
 303 #ifdef __cplusplus
 304 }
 305 #endif
 306
 307 #endif /* __STM32F7xx_HAL_GPIO_H */
 308
 309 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/