GPIO的八种工作模式

大家好，我是良许。

在嵌入式开发中，GPIO（General Purpose Input/Output，通用输入输出）是我们接触最多的外设之一。

无论是点亮一个LED灯，还是读取按键状态，亦或是与其他芯片进行通信，都离不开GPIO的配置。

而GPIO的工作模式直接决定了引脚的电气特性和功能表现。

今天，我就来详细聊聊STM32中GPIO的八种工作模式，帮助大家彻底理解它们的区别和应用场景。

1. GPIO工作模式概述

STM32的GPIO具有八种工作模式，可以分为四种输入模式和四种输出模式。

这些模式的设计非常灵活，能够满足各种应用场景的需求。

四种输入模式：
1.1 输入浮空模式（GPIO_MODE_INPUT）
1.2 输入上拉模式（GPIO_MODE_INPUT，配合GPIO_PULLUP）
1.3 输入下拉模式（GPIO_MODE_INPUT，配合GPIO_PULLDOWN）
1.4 模拟输入模式（GPIO_MODE_ANALOG）

四种输出模式：
1.5 开漏输出模式（GPIO_MODE_OUTPUT_OD）
1.6 开漏复用输出模式（GPIO_MODE_AF_OD）
1.7 推挽输出模式（GPIO_MODE_OUTPUT_PP）
1.8 推挽复用输出模式（GPIO_MODE_AF_PP）

下面我将逐一详细介绍这八种模式的工作原理、特点以及典型应用场景。

2. 四种输入模式详解

2.1 输入浮空模式

输入浮空模式是GPIO最基本的输入模式。

在这种模式下，引脚既不接上拉电阻，也不接下拉电阻，完全处于"浮空"状态。

此时引脚的电平完全由外部电路决定，如果外部没有明确的高低电平信号，引脚的状态是不确定的，可能会受到外部干扰而产生随机的高低电平跳变。

特点：

• 引脚内部不接任何电阻
• 输入阻抗非常高
• 功耗最低
• 容易受到外部干扰

应用场景：
输入浮空模式通常用于外部电路已经提供了明确的上拉或下拉电阻的场合。

比如，当外部按键电路已经有上拉电阻时，MCU的GPIO就可以配置为浮空输入，避免内部上拉电阻与外部电阻形成分压。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

// 使能GPIOA时钟
__HAL_RCC_GPIOA_CLK_ENABLE();

// 配置PA0为浮空输入
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_NOPULL;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 读取引脚状态
GPIO_PinState pinState = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);

2.2 输入上拉模式

输入上拉模式是在浮空输入的基础上，内部连接了一个上拉电阻（通常为30~50kΩ）到VDD。

这样，当外部没有信号输入时，引脚会被上拉电阻拉到高电平状态，避免了浮空状态下的不确定性。

特点：

• 内部连接上拉电阻到VDD
• 默认状态为高电平
• 可以有效防止引脚悬空
• 适合低电平有效的输入信号

应用场景：
输入上拉模式最常用于按键检测。

当按键未按下时，引脚保持高电平；按键按下后，引脚被拉到地，变为低电平。

这种方式简单可靠，是按键检测的标准配置。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOA_CLK_ENABLE();

// 配置PA1为上拉输入，用于按键检测
GPIO_InitStruct.Pin = GPIO_PIN_1;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 检测按键是否按下（低电平有效）
if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_1) == GPIO_PIN_RESET) {
    // 按键被按下
    // 执行相应操作
}

2.3 输入下拉模式

输入下拉模式与上拉模式相反，内部连接了一个下拉电阻（同样是30~50kΩ）到GND。

当外部没有信号输入时，引脚会被下拉电阻拉到低电平状态。

特点：

• 内部连接下拉电阻到GND
• 默认状态为低电平
• 防止引脚悬空
• 适合高电平有效的输入信号

应用场景：
输入下拉模式适用于高电平有效的信号检测。

比如某些传感器输出高电平表示有效信号，此时可以将GPIO配置为下拉输入，确保在没有信号时引脚保持低电平。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOB_CLK_ENABLE();

// 配置PB0为下拉输入
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_PULLDOWN;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

// 检测高电平有效信号
if (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) == GPIO_PIN_SET) {
    // 检测到高电平信号
    // 执行相应操作
}

2.4 模拟输入模式

模拟输入模式是专门为ADC（模数转换器）设计的。

在这种模式下，GPIO引脚直接连接到ADC的输入通道，不经过施密特触发器，可以输入连续变化的模拟信号。

特点：

• 关闭数字输入功能
• 关闭上拉下拉电阻
• 信号直接进入ADC
• 功耗最低

应用场景：
模拟输入模式专门用于ADC采集模拟信号，比如读取温度传感器、光敏电阻、电位器等模拟量。

在这种模式下，GPIO不再作为数字IO使用，而是作为ADC的模拟输入通道。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};
ADC_HandleTypeDef hadc1;

__HAL_RCC_GPIOA_CLK_ENABLE();
__HAL_RCC_ADC1_CLK_ENABLE();

// 配置PA4为模拟输入，用于ADC
GPIO_InitStruct.Pin = GPIO_PIN_4;
GPIO_InitStruct.Mode = GPIO_MODE_ANALOG;
GPIO_InitStruct.Pull = GPIO_NOPULL;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// ADC配置（简化示例）
hadc1.Instance = ADC1;
hadc1.Init.Resolution = ADC_RESOLUTION_12B;
hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
HAL_ADC_Init(&hadc1);

// 读取ADC值
HAL_ADC_Start(&hadc1);
HAL_ADC_PollForConversion(&hadc1, 100);
uint32_t adcValue = HAL_ADC_GetValue(&hadc1);

3. 四种输出模式详解

3.1 推挽输出模式

推挽输出（Push-Pull）是最常用的输出模式。

在这种模式下，输出级由两个MOS管组成，一个连接VDD（P-MOS），一个连接GND（N-MOS）。

输出高电平时，P-MOS导通，引脚连接到VDD；输出低电平时，N-MOS导通，引脚连接到GND。

这种结构可以提供较强的驱动能力。

特点：

• 可以输出高电平和低电平
• 驱动能力强，可以直接驱动LED等负载
• 输出电平明确，不会出现悬空状态
• 不能实现线与功能

应用场景：
推挽输出是GPIO最常用的输出模式，适用于驱动LED、控制继电器、输出PWM信号等场景。

只要不需要多个设备共享同一条信号线，推挽输出都是首选。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOC_CLK_ENABLE();

// 配置PC13为推挽输出，用于控制LED
GPIO_InitStruct.Pin = GPIO_PIN_13;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);

// 点亮LED（假设低电平点亮）
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);

// 延时
HAL_Delay(1000);

// 熄灭LED
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);

3.2 开漏输出模式

开漏输出（Open-Drain）模式下，输出级只有一个N-MOS管连接到GND。

输出低电平时，N-MOS导通，引脚接地；输出高电平时，N-MOS关断，引脚呈现高阻态。

要输出高电平，必须外接上拉电阻。

特点：

• 只能主动输出低电平
• 输出高电平需要外部上拉电阻
• 可以实现电平转换
• 支持线与功能（多个设备共享一条线）

应用场景：
开漏输出最典型的应用是I2C总线。

I2C是多主机总线，多个设备共享SDA和SCL两条线，必须使用开漏输出配合外部上拉电阻。

此外，开漏输出还可以用于电平转换，比如MCU是3.3V供电，但需要输出5V信号时，可以使用开漏输出配合5V上拉电阻。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOB_CLK_ENABLE();

// 配置PB6和PB7为开漏输出，用于I2C（SCL和SDA）
GPIO_InitStruct.Pin = GPIO_PIN_6 | GPIO_PIN_7;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD;
GPIO_InitStruct.Pull = GPIO_PULLUP;  // 如果外部没有上拉，可以使能内部上拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

// 模拟I2C起始信号
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET);  // SDA拉低
HAL_Delay(1);
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET);  // SCL拉低

3.3 推挽复用输出模式

推挽复用输出模式是推挽输出的复用版本。

在这种模式下，GPIO的控制权交给片上外设（如SPI、USART等），由外设自动控制引脚的输出。

特点：

• 由片上外设控制输出
• 具有推挽输出的所有特性
• 用户不能直接控制引脚电平
• 适合高速通信

应用场景：
推挽复用输出主要用于SPI、USART等需要高速、强驱动能力的通信接口。

比如SPI的MOSI、SCK引脚，USART的TX引脚等。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOA_CLK_ENABLE();

// 配置PA9为推挽复用输出，用于USART1_TX
GPIO_InitStruct.Pin = GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF7_USART1;  // 复用为USART1
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 后续由USART外设控制该引脚

3.4 开漏复用输出模式

开漏复用输出模式是开漏输出的复用版本。

同样，GPIO的控制权交给片上外设，但输出特性为开漏。

特点：

• 由片上外设控制输出
• 具有开漏输出的所有特性
• 需要外部上拉电阻
• 支持多主机通信

应用场景：
开漏复用输出主要用于I2C、SMBUS等需要多主机通信的总线。

当使用STM32的硬件I2C外设时，SCL和SDA引脚必须配置为开漏复用输出。

代码示例：

GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOB_CLK_ENABLE();

// 配置PB8和PB9为开漏复用输出，用于I2C1（SCL和SDA）
GPIO_InitStruct.Pin = GPIO_PIN_8 | GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
GPIO_InitStruct.Pull = GPIO_PULLUP;  // 使能内部上拉（外部也应有上拉电阻）
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;  // 复用为I2C1
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

// 后续由I2C外设控制该引脚

4. 工作模式选择建议

在实际开发中，如何选择合适的GPIO工作模式呢？这里给出一些实用建议：

4.1 输入模式选择：

• 如果外部电路已有上拉/下拉电阻，选择浮空输入
• 如果是按键检测且按键接地，选择上拉输入
• 如果是按键检测且按键接VDD，选择下拉输入
• 如果是ADC采集模拟信号，必须选择模拟输入

4.2 输出模式选择：

• 一般的LED驱动、信号输出，选择推挽输出
• I2C、单总线等多设备共享的总线，选择开漏输出
• 需要电平转换时，选择开漏输出配合外部上拉
• 使用片上外设（如SPI、USART）时，根据外设要求选择复用模式

4.3 速度等级选择：
STM32的GPIO还可以配置输出速度（Low、Medium、High、Very High），这会影响引脚的翻转速度和功耗。一般原则是：

• 低速信号（如LED控制）选择Low Speed，降低EMI和功耗
• 中速信号（如普通通信）选择Medium或High Speed
• 高速信号（如高速SPI、SDIO）选择Very High Speed

5. 常见问题与注意事项

5.1 为什么开漏输出需要上拉电阻？
因为开漏输出只能主动拉低，不能主动拉高。

没有上拉电阻时，输出高电平时引脚处于高阻态，无法驱动负载。

上拉电阻的作用是在N-MOS关断时将引脚拉到高电平。

5.2 推挽输出可以接上拉电阻吗？
可以，但通常没有必要。

推挽输出本身就能输出强高电平和强低电平，额外的上拉电阻只会增加功耗。

只有在需要提高驱动能力或进行电平转换时才需要。

5.3 多个GPIO可以连接在一起吗？
如果都是推挽输出，绝对不能连接在一起！当一个输出高电平、另一个输出低电平时，会形成短路，可能烧毁芯片。

如果需要多个GPIO共享一条线，必须使用开漏输出。

5.4 复用功能如何配置？
使用HAL库时，需要同时配置GPIO模式和复用功能。

不同的引脚支持的复用功能不同，需要查阅芯片数据手册中的引脚复用表。

通过以上详细的介绍，相信大家对STM32的GPIO八种工作模式有了深入的理解。

在实际项目中，正确选择GPIO的工作模式是保证系统稳定运行的基础。

希望这篇文章能帮助大家在嵌入式开发的道路上少走弯路，写出更加可靠的代码。

更多编程学习资源

• C语言零基础入门电子书-2026最新版
• STM32零基础入门电子书-2026最新版
• FreeRTOS零基础入门电子书-2026最新版
• C++ 零基础入门电子书-2026最新版
• 51单片机零基础入门学习路线
• AD画板零基础入门学习路线
• C语言零基础入门学习路线
• C++语言零基础入门学习路线
• ESP32零基础入门学习路线
• FreeRTOS零基础入门学习路线
• Linux应用开发零基础入门学习路线
• Linux底层开发零基础入门学习路线
• LVGL零基础入门学习路线
• QT零基础入门学习路线
• STM32零基础入门学习路线