3. GPIO 深入浅出：推挽输出、开漏输出、上拉下拉、复用功能，以及我在一个电机驱动项目中踩过的坑
GPIO 是 STM32 最基础的外设，但也是坑最多的地方。很多新手觉得 GPIO 就是点个灯、读个按键，没什么好学的。说实话，我当年也是这么想的，直到在一个电机驱动项目里被折腾了整整三天……
那次项目其实不复杂——用 STM32F103 驱动一个直流有刷电机，通过 L298N 模块控制正反转和 PWM 调速。硬件连好了，代码写完了，电机就是不动。示波器一测，控制引脚波形完全不对。查到最后，问题出在 GPIO 模式配置上。嗯，从那以后，我再也不敢小看 GPIO 了。
这一章，咱们就把 GPIO 的几种工作模式彻底讲清楚。我会结合那个电机驱动项目的踩坑经历，帮你避开同样的雷区。
3.1 推挽输出（Push-Pull Output）
推挽输出是 GPIO 最常用的输出模式。它的内部结构可以理解为两个互补的 MOS 管：一个负责推（输出高电平），一个负责挽（输出低电平）。
推挽输出的特点很明确：
- 输出电平强：高电平接近 VDD，低电平接近 VSS，驱动能力强
- 响应速度快：两个 MOS 管交替导通，没有死区时间
- 不能线与：多个推挽输出直接并联会短路
配置代码也很简单：
// 推挽输出配置示例
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_0 | 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);3.2 开漏输出（Open-Drain Output）
开漏输出就有点意思了。它只有下拉的 NMOS 管，没有上拉的 PMOS 管。输出低电平时，NMOS 导通，引脚拉到 GND；输出高电平时，NMOS 关断，引脚处于高阻态。
这就引出了开漏输出的核心应用场景：
- 电平转换：外部上拉到 5V，就能用 3.3V 的 MCU 控制 5V 器件
- 线与逻辑：多个开漏输出可以并联，任何一个拉低，总线就是低电平
- I2C 总线：标准 I2C 协议要求开漏输出，实现多主机仲裁
配置代码：
// 开漏输出配置示例（I2C SCL 引脚）
GPIO_InitStruct.Pin = GPIO_PIN_6; // PB6 - I2C1_SCL
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 开漏输出
GPIO_InitStruct.Pull = GPIO_NOPULL; // 外部已有上拉电阻
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);3.3 上拉与下拉（Pull-Up / Pull-Down）
STM32 内部集成了可配置的上拉和下拉电阻，阻值大约在 40kΩ 左右。这个功能在输入模式下特别有用。
什么时候用上拉？什么时候用下拉？我总结了一个简单规则：
| 应用场景 | 推荐配置 | 原因 |
|---|---|---|
| 按键输入（接地） | 上拉输入 | 按键按下为低电平，松开为高电平 |
| 按键输入（接 VCC） | 下拉输入 | 按键按下为高电平，松开为低电平 |
| 外部中断输入 | 上拉或下拉 | 防止浮空电平触发误中断 |
| 开漏输出 | 不配置内部上拉 | 外部上拉电阻更精确 |
关键点：内部上拉/下拉电阻的阻值约 40kΩ，驱动能力有限。如果需要强上拉（比如 I2C 总线），必须使用外部电阻，通常 4.7kΩ 或 10kΩ。
3.4 复用功能（Alternate Function）
复用功能是 GPIO 最强大的特性之一。说白了，就是把引脚的控制权交给片内外设，比如 USART、SPI、I2C、定时器等。
配置复用功能时，有两点特别容易搞错：
- 复用功能编号：每个引脚可能有多个复用功能，必须选择正确的 AF 编号
- 输出类型：复用功能也要区分推挽和开漏，比如 USART TX 用推挽，I2C SCL/SDA 用开漏
配置示例：
// USART1 TX (PA9) 复用推挽输出
GPIO_InitStruct.Pin = GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; // 复用推挽
GPIO_InitStruct.Pull = GPIO_PULLUP;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF7_USART1; // 选择 AF7
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);3.5 电机驱动项目中的踩坑实录
回到开头说的那个电机驱动项目。当时我用 STM32F103 的 PA0、PA1 控制 L298N 的 IN1、IN2，PA2 输出 PWM 到 ENA 使能端。
电路连好了，代码写好了，电机纹丝不动。示波器一测，发现问题了：
- PA0 和 PA1 的波形只有 2.8V，不是预期的 3.3V
- PWM 波形占空比正确，但幅值只有 2.5V
- L298N 的逻辑输入阈值是 2.3V，勉强能识别，但噪声容限几乎为零
查了半天，原因让我哭笑不得——我把 GPIO 配置成了开漏输出，而且没接外部上拉电阻！
为什么会犯这种低级错误？因为之前做 I2C 项目习惯了开漏输出，写代码时直接复制了之前的模板，忘了改模式。
修复方案很简单：把 GPIO 模式改成推挽输出，同时把速度等级调到 HIGH，因为 PWM 频率较高（20kHz），低速模式会导致波形失真。
// 正确的电机控制引脚配置
GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1; // IN1, IN2
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出！
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; // 高速模式
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
// PWM 引脚（PA2）使用定时器复用功能
GPIO_InitStruct.Pin = GPIO_PIN_2;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; // 复用推挽
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF1_TIM2; // TIM2 通道 3
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);改完之后，电机正常运转。但这次经历让我养成了一个习惯：每次配置 GPIO 前，先问自己三个问题：
- 这个引脚是输入还是输出？
- 如果是输出，需要推挽还是开漏？
- 如果是输入，需要上拉还是下拉？
3.6 GPIO 模式选择速查表
为了方便你快速决策，我整理了一张速查表：
| 应用场景 | 模式 | 上拉/下拉 | 速度 |
|---|---|---|---|
| LED 指示灯 | 推挽输出 | 无 | 低 |
| 继电器/电机控制 | 推挽输出 | 无 | 高 |
| I2C 总线 | 开漏输出 | 外部上拉 | 高 |
| USART TX | 复用推挽 | 上拉 | 高 |
| USART RX | 浮空输入 | 上拉 | - |
| 按键输入（接地） | 输入 | 上拉 | - |
| 外部中断 | 输入 | 上拉/下拉 | - |
| SPI 时钟/数据 | 复用推挽 | 无 | 非常高 |
| ADC 采样 | 模拟输入 | 无 | - |
3.7 GPIO 知识体系总览
下面这张 SVG 图把 GPIO 的核心知识点串起来了，你可以把它当作快速复习的路线图：
3.8 几个实用技巧
最后分享几个我平时用 GPIO 的小技巧：
- 未使用的引脚怎么处理？我习惯配置成模拟输入模式，功耗最低，也不会产生干扰
- 调试时快速定位 GPIO 问题：用 HAL_GPIO_TogglePin 配合示波器，比读寄存器快多了
- 批量操作多个引脚：用 ODR 寄存器直接赋值，比逐位操作快 10 倍以上
- 注意 GPIO 的电流限制：单个引脚最大 25mA，整片 MCU 总电流不超过 150mA，驱动大负载必须加三极管或 MOS 管