1. GPIO 模式总览

STM32 的每个 GPIO 引脚在复位后默认为浮空输入，但我们在实际工程中很少直接使用这种状态。GPIO 的配置由几个关键寄存器决定：

  • MODER：选择输入模式、输出模式、复用功能或模拟模式。
  • OTYPER：配置输出为推挽（Push-Pull）或开漏（Open-Drain）。
  • PUPDR：配置上拉、下拉或浮空。
  • OSPEEDR：设置输出速率，可选低、中、高、超高速。

理解这几个寄存器的含义，才能从根本上看清不同配置的真实效果。

2. 上下拉电阻：你的引脚需要确定的电平

当引脚配置为输入模式时，如果外部信号没有强驱动，引脚就会悬空，电平不确定。此时内部上拉/下拉电阻可以提供一个默认电平。STM32 内部上拉/下拉电阻的典型阻值约为 30~50kΩ，适合通用逻辑电平，但不可用于强负载，且功耗有限。

通过设置 PUPDR 寄存器，可配置为：

  • 0b00：无上拉/下拉（浮空）
  • 0b01：上拉
  • 0b10：下拉

在 HAL 库中，通过 GPIO_InitStruct.Pull 字段设置：

GPIO_InitStruct.Pull = GPIO_PULLUP;   // 上拉
GPIO_InitStruct.Pull = GPIO_PULLDOWN; // 下拉

使用场景：按键检测常用上拉输入（按键接地），或下拉输入（按键接 VCC）；I2C 总线的 SDA/SCL 在开漏模式下外接上拉，内部不再额外配置上拉，避免并联电阻降低总阻值。

3. 开漏与推挽：输出电压能力的本质区别

推挽输出（Push-Pull）内部有两只 MOS 管交替导通，拉电流和灌电流能力都很强，输出高电平时直接连到 VDD，低电平时连到 GND。这是最常用的输出模式，如驱动 LED、普通数字信号。

开漏输出（Open-Drain）只具备拉低能力，内部 MOSFET 将引脚拉到 GND；输出高电平时引脚为高阻态，需要外部上拉电阻将电平拉高。这种模式的价值在于：

  • 电平转换：通过选择不同电压的上拉电阻，适应不同电平的外部器件。
  • 线与逻辑：多个开漏输出可以共用一个上拉电阻，任一拉低则总线为低，如 I2C 总线仲裁。

在 HAL 库中配置模式：

GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 开漏输出

注意：开漏输出如果不接外部上拉，只能输出低电平，无法输出高电平。

4. 输出速率：不是越高越好

输出速率决定了 GPIO 输出信号的边沿翻转速度。高速率意味着更陡峭的上升/下降沿，在长走线或高阻抗负载下容易产生振铃、过冲和电磁干扰（EMI）。而低速率则信号平缓，功耗也更低。

在 OSPEEDR 寄存器中可选择四档，对应 HAL 库的宏：

  • GPIO_SPEED_FREQ_LOW
  • GPIO_SPEED_FREQ_MEDIUM
  • GPIO_SPEED_FREQ_HIGH
  • GPIO_SPEED_FREQ_VERY_HIGH

选择建议：LED、按键、普通控制信号用 LOW 或 MEDIUM；PWM、SPI、I2C 等通信信号根据实际频率选择 HIGH；高速外设如 SDIO、USB 可能才需要 VERY_HIGH。盲目使用最高速率会导致信号质量问题，得不偿失。

5. 完整代码示例：HAL 库配置输入、推挽输出和开漏输出

下面初始化三个引脚：

  • PA0：按键输入，上拉，检测外部接地；
  • PA1：LED 输出，推挽模式，低速；
  • PA2：开漏输出，外部已接 4.7kΩ 上拉至 3.3V，用于模拟 I2C 或电平转换。
#include "stm32f4xx_hal.h"

void MX_GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();

    /* PA0: 按键输入，上拉 */
    GPIO_InitStruct.Pin   = GPIO_PIN_0;
    GPIO_InitStruct.Mode  = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull  = GPIO_PULLUP;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    /* PA1: LED 推挽输出，低速 */
    GPIO_InitStruct.Pin   = GPIO_PIN_1;
    GPIO_InitStruct.Mode  = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull  = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    /* PA2: 开漏输出，外部上拉，用于 I2C / 电平转换 */
    GPIO_InitStruct.Pin   = GPIO_PIN_2;
    GPIO_InitStruct.Mode  = GPIO_MODE_OUTPUT_OD;
    GPIO_InitStruct.Pull  = GPIO_NOPULL;   /* 内部不使能上下拉，外部已有上拉电阻 */
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
}

void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    if (GPIO_Pin == GPIO_PIN_0)
    {
        /* 按键按下（PA0被拉低）时翻转 LED */
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_1);
    }
}

int main(void)
{
    HAL_Init();
    MX_GPIO_Init();

    while (1)
    {
        /* 也可以主动读取按键电平 */
        if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET)
        {
            HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET); // 开漏拉低
        }
        else
        {
            HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET);   // 高阻态，外部上拉拉高
        }
        HAL_Delay(10);
    }
}

上述代码演示了三种典型配置。实际项目中，PA2 的开漏输出不需要轮询，这里仅为展示用法。

6. 注意事项：写给挑剔的开发者

  • 上下拉电阻的功耗：内部上下拉阻值较大，但仍有微弱电流。在低功耗设计中，尽量将引脚配置为浮空，或者改用外部电阻并关闭内部上下拉。
  • 开漏输出必须接外部上拉：如果没有上拉电阻，开漏引脚只能驱动低电平，逻辑高不存在，通信协议可能直接失败。
  • 复用功能同样需要配置：例如 I2C 在 STM32F1 中需配置为开漏输出（MX 工具中自动管理），而 F4 系列需选择 GPIO_MODE_AF_OD。不要忘记同时配置 PUPDR 和 OSPEEDR。
  • 速率校准：高速率不是万灵药。信号完整性取决于负载电容、走线长度和终端匹配。过冲可能损坏外部器件，振铃则导致误触发。
  • 时钟使能：所有 GPIO 配置前必须开启对应总线的时钟，否则写寄存器无效，甚至触发硬件错误。

掌握这些细节后，GPIO 配置不再是靠“试”出来的，而是基于电路原理的理性选择。在实际项目中，建议结合示波器观察信号波形，验证速率设置是否合理，让代码和硬件真正协同工作。