3. GPIO 基础：推挽输出与开漏输出、上拉下拉电阻、GPIO 寄存器映射与 HAL 库操作

GPIO 是嵌入式开发里打交道最多的外设，没有之一。说白了，它就是芯片伸出来的那些引脚，你可以控制它们输出高电平或低电平，也可以读取外部信号是 0 还是 1。但别小看这简单的功能，里面有不少门道。我刚开始学的时候，就因为在推挽和开漏之间选错了，折腾了一整个下午。

3.1 推挽输出与开漏输出

这两种输出模式，是 GPIO 最基础也最容易混淆的概念。我直接说人话：

• 推挽输出 (Push-Pull)：内部有两个管子，一个负责推（输出高电平），一个负责挽（输出低电平）。输出 1 就是直接接到 VCC，输出 0 就是直接接到 GND。驱动能力强，速度快。
• 开漏输出 (Open-Drain)：只有拉低的能力，没有拉高的能力。输出 0 时接地，输出 1 时引脚处于高阻态（相当于断开）。要想输出高电平，必须在外部接一个上拉电阻到 VCC。

我在项目中遇到过一个问题：用 STM32 的推挽输出直接驱动一个 5V 的 I2C 设备。结果发现高电平只有 3.3V，设备不认。这就是推挽输出的局限性——它输出的高电平就是芯片的供电电压（3.3V）。换成开漏输出，外部上拉到 5V，问题就解决了。

3.2 上拉与下拉电阻

上拉和下拉电阻，说白了就是给不确定的引脚一个确定的默认状态。你想想看，一个引脚悬空的时候，电平是浮动的，很容易受外界干扰。这时候就需要电阻把它拉到 VCC（上拉）或 GND（下拉）。

类型	连接方式	默认电平	典型应用
上拉电阻	引脚 → 电阻 → VCC	高电平	按键输入、I2C 总线、开漏输出
下拉电阻	引脚 → 电阻 → GND	低电平	防止误触发、某些传感器输入

我曾经犯过一个低级错误：用内部上拉电阻接按键，结果按键按下时电平没拉低，因为内部上拉太弱，加上按键线缆太长引入了噪声。后来换成外部 10kΩ 上拉，问题就解决了。嗯，这里要注意：内部上拉只适合短距离、低噪声的环境。

3.3 GPIO 寄存器映射

STM32 的 GPIO 外设是通过寄存器来控制的。每个 GPIO 端口（如 GPIOA、GPIOB）都有一组寄存器，映射到固定的内存地址。说白了，你往某个地址写数据，就等于控制了对应的引脚。

以 STM32F4 为例，GPIOA 的基地址是 0x40020000。每个端口有 10 个 32 位寄存器：

寄存器	偏移地址	功能描述
GPIOx_MODER	0x00	模式选择（输入、输出、复用、模拟）
GPIOx_OTYPER	0x04	输出类型（推挽或开漏）
GPIOx_OSPEEDR	0x08	输出速度
GPIOx_PUPDR	0x0C	上拉/下拉配置
GPIOx_IDR	0x10	输入数据寄存器（只读）
GPIOx_ODR	0x14	输出数据寄存器
GPIOx_BSRR	0x18	位设置/复位寄存器（原子操作）
GPIOx_LCKR	0x1C	配置锁定寄存器
GPIOx_AFRL	0x20	复用功能低寄存器（引脚 0-7）
GPIOx_AFRH	0x24	复用功能高寄存器（引脚 8-15）

直接操作寄存器，代码执行效率最高。但可读性差，容易写错位。我早期做项目时习惯用寄存器操作，后来项目大了，还是老老实实用 HAL 库——维护成本低很多。

// 直接寄存器操作示例：让 PA5 输出高电平
// 1. 开启 GPIOA 时钟
RCC->AHB1ENR |= (1 << 0);
// 2. 设置 PA5 为输出模式（MODER 寄存器，每两位控制一个引脚）
GPIOA->MODER |= (1 << 10);   // MODER[11:10] = 01
GPIOA->MODER &= ~(1 << 11);
// 3. 设置输出类型为推挽（OTYPER 寄存器）
GPIOA->OTYPER &= ~(1 << 5);
// 4. 设置输出速度（OSPEEDR 寄存器）
GPIOA->OSPEEDR |= (1 << 10); // 中速
// 5. 输出高电平（BSRR 寄存器，原子操作）
GPIOA->BSRR = (1 << 5);      // 置位 BS5

3.4 HAL 库操作

HAL 库把寄存器操作封装成了函数，用起来直观多了。我个人的建议是：学习阶段先用 HAL 库理解流程，等需要极致性能时再考虑寄存器。

HAL 库操作 GPIO 的核心函数就几个：

• HAL_GPIO_Init()：初始化引脚模式、类型、速度、上下拉
• HAL_GPIO_WritePin()：设置引脚输出电平
• HAL_GPIO_TogglePin()：翻转引脚电平
• HAL_GPIO_ReadPin()：读取引脚输入电平

// HAL 库示例：初始化 PA5 为推挽输出，并点亮 LED
GPIO_InitTypeDef GPIO_InitStruct = {0};

// 1. 开启 GPIOA 时钟
__HAL_RCC_GPIOA_CLK_ENABLE();

// 2. 配置 PA5
GPIO_InitStruct.Pin = GPIO_PIN_5;
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. 输出高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

3.5 知识结构图

下面这张图把 GPIO 的核心知识点串起来了，方便你理解整体脉络：

3.6 实战要点总结

最后，我把 GPIO 开发中容易踩的坑和我的经验整理成清单：

• 时钟必须先开启：操作任何 GPIO 之前，必须使能对应端口的时钟。忘了这一步，写寄存器没反应。
• 开漏输出记得加上拉：内部上拉电阻可选，但驱动能力有限。驱动 I2C 总线时，我习惯用外部 4.7kΩ 上拉。
• BSRR 比 ODR 更安全：用 BSRR 设置引脚电平是原子操作，不会被中断打断。ODR 的读-改-写操作在多任务环境下可能出问题。
• HAL_GPIO_Init 会覆盖配置：每次调用都会重新配置整个引脚，之前设置的参数会被清掉。如果需要频繁修改某个参数，考虑直接操作寄存器。
• 输入引脚不要悬空：要么内部上拉/下拉，要么外部接电阻。悬空的输入引脚功耗高且容易误触发。