STM32 GPIO 输入输出模式完全指南：推挽、开漏、上下拉、复用功能怎么选

一、STM32 GPIO 的 8 种工作模式与电气结构

STM32 的每个 GPIO 引脚都可以独立配置为 8 种模式之一，这是它区别于 51 单片机准双向口的核心优势。按输入/输出、是否带上下拉、是否复用分四类：输出类——推挽输出（GPIO_MODE_OUTPUT_PP）、开漏输出（GPIO_MODE_OUTPUT_OD）；输入类——浮空输入（INPUT_NOPULL）、上拉输入（INPUT_PULLUP）、下拉输入（INPUT_PULLDOWN）；复用类——复用推挽（AF_PP）、复用开漏（AF_OD）；模拟类——模拟输入（ANALOG）。

推挽输出（Push-Pull）内部由一对 PMOS + NMOS 组成推挽结构：输出高电平时 PMOS 导通拉到 VDD（3.3V），输出低电平时 NMOS 导通拉到 GND，驱动能力强、上升下降沿都快，是最常用的输出模式。开漏输出（Open-Drain）只保留 NMOS：输出低电平时 NMOS 导通拉 GND，输出高电平时 NMOS 截止、引脚呈高阻态，必须外接上拉电阻才能输出高电平。开漏的优势是支持线与（Wire-AND）与电平转换，I2C 总线就是典型应用。

二、灌电流与拉电流：GPIO 能驱动多大负载

STM32F103/F407 单个 IO 的驱动能力在 datasheet 中明确标注：拉电流（Source，输出高电平向外供电）与灌电流（Sink，输出低电平吸收电流）单引脚最大 ±25mA，但 IVDD 与 IVSS 总电流不超过 150mA（F1 系列），F4/H7 总电流上限 120-240mA 视封装而定。也就是说，不能同时让 8 个 IO 各输出 25mA——会超过总功耗限值导致内部发热甚至闩锁。

结论：GPIO 只能直接驱动 LED（串 330Ω-1kΩ 限流电阻）与小信号负载；蜂鸣器（30-50mA）、继电器（70-200mA）、电机必须通过 NPN 三极管（S8050）或 N-MOS（AO3400）做电流放大，并在感性负载两端并续流二极管（1N4148/SS14）。灌电流模式下电压更低（VOL 典型 0.4V@20mA）比拉电流（VOH 典型 VDD-0.4V）驱动能力略强，老式电路常用"LED 阳极接 VCC、阴极接 GPIO"的低电平点亮接法就是这个原因。

三、上拉/下拉电阻怎么选：4.7k / 10k / 100k

STM32 内部自带上下拉电阻，阻值在 30-50kΩ（典型 40kΩ，F1 系列）或 30-50kΩ（F4/H7），属于弱上拉，只适合按键输入、未连接引脚防悬浮等场景。需要更强上拉时必须外接：I2C 总线上拉按总线电容计算，100kHz 标准模式 4.7kΩ、400kHz 快速模式 2.2kΩ-4.7kΩ、1MHz 快速+ 模式 1kΩ-2.2kΩ；按键上拉常用 10kΩ，按下时电流 0.33mA，功耗可忽略；开漏输出驱动 LED上拉 4.7kΩ-10kΩ；低功耗产品上拉可加大到 100kΩ 甚至 1MΩ，把静态电流压到 3.3μA 以下。

下拉电阻常见场景：N-MOS 栅极下拉（10kΩ，防止上电瞬间误导通）、EN 使能脚下拉（100kΩ，默认关断）、按键接地时上拉改下拉（同样 10kΩ）。切勿把上拉/下拉电阻用在承载大电流的路径上——例如用 10kΩ 下拉给 MOS 栅极放电是合理的，但用 10kΩ 给继电器线圈限流就完全不工作。

四、复用功能 AF：UART / SPI / I2C 引脚配置

STM32 的外设引脚不是固定的，而是通过复用功能（Alternate Function, AF）把 UART/SPI/I2C/TIM/ADC 等信号映射到指定 GPIO。F1 系列用 AFIO + REMAP 寄存器配置（部分引脚可重映射到备选位置），F4/F7/H7 用 AFRL/AFRH 寄存器 + AF0-AF15 编号，每个引脚最多 16 种复用功能，具体映射查 datasheet 的 Alternate Function Mapping 表。

关键提醒：①I2C 必须开漏 + 外部上拉，不能用推挽（会短路）；②ADC 输入必须配置为模拟输入模式，禁止内部上下拉（会引入额外电流影响采样精度）；③SWD 调试引脚（PA13/PA14）默认已占用，若复用为普通 GPIO 会失去调试能力，必须保留 NRST 才能用 ST-Link 的 Connect Under Reset 恢复。

五、HAL 库 GPIO_InitTypeDef 参数说明

STM32CubeMX 生成的 HAL 代码里，GPIO 初始化核心是 GPIO_InitTypeDef 结构体，共 5 个字段：Pin（GPIO_PIN_0 到 GPIO_PIN_15，可位或同时配置多个）；Mode（GPIO_MODE_OUTPUT_PP / OUTPUT_OD / INPUT / AF_PP / AF_OD / ANALOG / IT_RISING / IT_FALLING 等 16 种）；Pull（GPIO_NOPULL / PULLUP / PULLDOWN）；Speed（LOW / MEDIUM / HIGH / VERY_HIGH，对应 2/10/50/100 MHz 输出斜率，不是工作频率而是边沿速率，高速会增加 EMI，非必要时选 LOW）；Alternate（AF0-AF15 编号）。

典型配置示例：PA9 配置为 USART1_TX——Pin=GPIO_PIN_9、Mode=GPIO_MODE_AF_PP、Pull=GPIO_NOPULL、Speed=GPIO_SPEED_FREQ_HIGH、Alternate=GPIO_AF7_USART1。初学者最常见的三个错误：1. Speed 选 VERY_HIGH 导致 EMI 超标；2. 忘了配 Alternate 字段导致外设无信号输出；3. 把 I2C 配成 AF_PP 而非 AF_OD 烧毁引脚。

六、5V 容忍 IO 与工程选型建议

STM32 工作在 3.3V，但很多老外设是 5V 逻辑（如 51 单片机、部分传感器、LCD1602）。STM32F1/F4 大部分 IO 标注 FT（Five-volt Tolerant，5V 容忍），可以承受 5V 输入而不损坏，但输出仍是 3.3V——推动 5V CMOS 输入（VIH 最低 3.5V）可能不可靠。判断方法：查 datasheet 引脚定义表，标 FT 或 FTf/FTa 的可 5V 容忍，标 TC 或 TTa 的（多为 ADC 专用引脚）禁止超过 3.6V。

• 5V → 3.3V 输入：FT 引脚直接连，或串 1kΩ + 钳位二极管到 3.3V 双保险。
• 3.3V → 5V 输出：用开漏 + 5V 上拉（4.7kΩ）实现电平转换，或用 TXS0108E / 74LVC245 专用转换芯片。
• I2C 跨电平：用 PCA9306 / TXS0102 双向电平转换器，MOS 管分立方案（BSS138 + 两个上拉）也可。
• 按键 / 通用输入：默认上拉输入（PULLUP），按键一端接 GND，省去外部上拉电阻。
• LED / 数码管：推挽输出 + 限流电阻，单路电流 ≤20mA，总功耗 ≤150mA。
• I2C 传感器（SHT30/MPU6050）：复用开漏 + 4.7kΩ 外部上拉，100kHz 速率下可挂 4-6 个从机。

结论：STM32 GPIO 的 8 种模式不是冗余设计，而是覆盖从低速按键到高速 SPI、从单端驱动到双向总线的完整场景。掌握推挽=默认输出、开漏=I2C 与电平转换、上拉=按键默认、模拟=ADC 专用、复用=外设映射这 5 条核心规则，90% 的 GPIO 配置问题都能秒解。剩余的 10% 集中在5V 容忍判断、Speed 字段与 EMI 的权衡、复用 AF 编号查询，务必以官方 datasheet 与参考手册为准，不要凭记忆写代码。