stm32g4xx_hal_gpio.h

转到该文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_gpio.h
  * @author  MCD Application Team
  * @brief   GPIO HAL模块头文件。
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */

/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef STM32G4xx_HAL_GPIO_H
#define STM32G4xx_HAL_GPIO_H

#ifdef __cplusplus
extern "C" {
#endif

/* Includes ------------------------------------------------------------------*/
#include "stm32g4xx_hal_def.h"

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @defgroup GPIO GPIO
  * @brief GPIO HAL模块驱动程序
  * @{
  */

/* Exported types ------------------------------------------------------------*/

/** @defgroup GPIO_Exported_Types GPIO导出的类型
  * @{
  */
/**
  * @brief   GPIO初始化结构体定义
  */
typedef struct
{
  uint32_t Pin;        /*!< 指定要配置的GPIO引脚。
                           该参数可以是@ref GPIO_pins的任何值 */

  uint32_t Mode;       /*!< 指定所选引脚的工作模式。
                           该参数可以是@ref GPIO_mode的值 */

  uint32_t Pull;       /*!< 指定所选引脚的上拉或下拉激活。
                           该参数可以是@ref GPIO_pull的值 */

  uint32_t Speed;      /*!< 指定所选引脚的速度。
                           该参数可以是@ref GPIO_speed的值 */

  uint32_t Alternate;  /*!< 要连接到所选引脚的外设
                            该参数可以是@ref GPIOEx_Alternate_function_selection的值 */
} GPIO_InitTypeDef;

/**
  * @brief  GPIO引脚置位和复位枚举
  */
typedef enum
{
  GPIO_PIN_RESET = 0U,
  GPIO_PIN_SET
} GPIO_PinState;
/**
  * @}
  */

/* Exported constants --------------------------------------------------------*/
/** @defgroup GPIO_Exported_Constants GPIO导出的常量
  * @{
  */
/** @defgroup GPIO_pins GPIO引脚
  * @{
  */
#define GPIO_PIN_0                 ((uint16_t)0x0001)  /* 选择引脚0    */
#define GPIO_PIN_1                 ((uint16_t)0x0002)  /* 选择引脚1    */
#define GPIO_PIN_2                 ((uint16_t)0x0004)  /* 选择引脚2    */
#define GPIO_PIN_3                 ((uint16_t)0x0008)  /* 选择引脚3    */
#define GPIO_PIN_4                 ((uint16_t)0x0010)  /* 选择引脚4    */
#define GPIO_PIN_5                 ((uint16_t)0x0020)  /* 选择引脚5    */
#define GPIO_PIN_6                 ((uint16_t)0x0040)  /* 选择引脚6    */
#define GPIO_PIN_7                 ((uint16_t)0x0080)  /* 选择引脚7    */
#define GPIO_PIN_8                 ((uint16_t)0x0100)  /* 选择引脚8    */
#define GPIO_PIN_9                 ((uint16_t)0x0200)  /* 选择引脚9    */
#define GPIO_PIN_10                ((uint16_t)0x0400)  /* 选择引脚10   */
#define GPIO_PIN_11                ((uint16_t)0x0800)  /* 选择引脚11   */
#define GPIO_PIN_12                ((uint16_t)0x1000)  /* 选择引脚12   */
#define GPIO_PIN_13                ((uint16_t)0x2000)  /* 选择引脚13   */
#define GPIO_PIN_14                ((uint16_t)0x4000)  /* 选择引脚14   */
#define GPIO_PIN_15                ((uint16_t)0x8000)  /* 选择引脚15   */
#define GPIO_PIN_All               ((uint16_t)0xFFFF)  /* 选择所有引脚 */

#define GPIO_PIN_MASK              (0x0000FFFFU) /* 用于断言测试的引脚掩码 */
/**
  * @}
  */

/** @defgroup GPIO_mode GPIO模式
  * @brief GPIO配置模式
  *        元素值约定：0x00WX00YZ
  *           - W  : EXTI触发检测，3位
  *           - X  : EXTI模式（中断或事件），2位
  *           - Y  : 输出类型（推挽或开漏），1位
  *           - Z  : GPIO模式（输入、输出、复用功能或模拟），2位
  * @{
  */ 
#define  GPIO_MODE_INPUT                        MODE_INPUT                                                  /*!< 输入浮空模式                   */
#define  GPIO_MODE_OUTPUT_PP                    (MODE_OUTPUT | OUTPUT_PP)                                   /*!< 输出推挽模式                 */
#define  GPIO_MODE_OUTPUT_OD                    (MODE_OUTPUT | OUTPUT_OD)                                   /*!< 输出开漏模式                */
#define  GPIO_MODE_AF_PP                        (MODE_AF | OUTPUT_PP)                                       /*!< 复用功能推挽模式     */
#define  GPIO_MODE_AF_OD                        (MODE_AF | OUTPUT_OD)                                       /*!< 复用功能开漏模式    */

#define  GPIO_MODE_ANALOG                       MODE_ANALOG                                                 /*!< 模拟模式  */
    
#define  GPIO_MODE_IT_RISING                    (MODE_INPUT | EXTI_IT | TRIGGER_RISING)                     /*!< 带上升沿触发检测的外部中断模式          */
#define  GPIO_MODE_IT_FALLING                   (MODE_INPUT | EXTI_IT | TRIGGER_FALLING)                    /*!< 带下降沿触发检测的外部中断模式         */
#define  GPIO_MODE_IT_RISING_FALLING            (MODE_INPUT | EXTI_IT | TRIGGER_RISING | TRIGGER_FALLING)   /*!< 带上升/下降沿触发检测的外部中断模式  */
 
#define  GPIO_MODE_EVT_RISING                   (MODE_INPUT | EXTI_EVT | TRIGGER_RISING)                     /*!< 带上升沿触发检测的外部事件模式             */
#define  GPIO_MODE_EVT_FALLING                  (MODE_INPUT | EXTI_EVT | TRIGGER_FALLING)                    /*!< 带下降沿触发检测的外部事件模式            */
#define  GPIO_MODE_EVT_RISING_FALLING           (MODE_INPUT | EXTI_EVT | TRIGGER_RISING | TRIGGER_FALLING)   /*!< 带上升/下降沿触发检测的外部事件模式     */
/**
  * @}
  */

/** @defgroup GPIO_speed GPIO速度
  * @brief GPIO输出最大频率
  * @{
  */
#define  GPIO_SPEED_FREQ_LOW        (0x00000000U)   /*!< 范围最高5 MHz，请参阅产品数据手册 */
#define  GPIO_SPEED_FREQ_MEDIUM     (0x00000001U)   /*!< 范围5 MHz至25 MHz，请参阅产品数据手册 */
#define  GPIO_SPEED_FREQ_HIGH       (0x00000002U)   /*!< 范围25 MHz至50 MHz，请参阅产品数据手册 */
#define  GPIO_SPEED_FREQ_VERY_HIGH  (0x00000003U)   /*!< 范围50 MHz至120 MHz，请参阅产品数据手册 */
/**
  * @}
  */

/** @defgroup GPIO_pull GPIO上下拉
  * @brief GPIO上拉或下拉激活
  * @{
  */
#define  GPIO_NOPULL        (0x000000