4、GPIO基础：GPIO工作原理、推挽/开漏/上拉/下拉、GPIO模式配置、寄存器与库函数操作

GPIO（General Purpose Input/Output，通用输入输出）是STM32单片机与外部世界交互的最基本通道。无论是点亮LED、读取按键，还是驱动继电器、与传感器通信，最终都要落实到GPIO的配置与操作上。对于零基础学习者而言，理解GPIO的内部结构、掌握四种主要工作模式（推挽、开漏、上拉、下拉）的区别，并学会通过寄存器或标准库函数进行配置，是迈入嵌入式开发大门的关键一步。本章将从硬件原理出发，逐步深入到软件配置，帮助您建立完整的GPIO知识框架。

4.1 GPIO核心工作原理

STM32的GPIO引脚内部并非一根简单的导线，而是一个由多个MOS管、触发器和寄存器构成的完整信号通路。每个GPIO端口（如GPIOA、GPIOB）包含多个引脚（PA0~PA15等），每个引脚都对应一组控制寄存器。从软件视角看，操作GPIO的本质就是读写特定的寄存器位；从硬件视角看，这些寄存器位控制着引脚内部MOS管的开关状态，从而决定引脚的电平输出或输入采样。

GPIO的核心结构包括：输出数据寄存器（ODR）、输入数据寄存器（IDR）、端口配置寄存器（CRL/CRH）以及复用功能寄存器（AFIO）。当引脚配置为输出模式时，CPU写入ODR的0或1，经过输出驱动器（推挽或开漏）作用到引脚；当配置为输入模式时，外部电平经过施密特触发器整形后，被采样到IDR中供CPU读取。理解这条数据通路，是后续配置的基础。

4.2 四种工作模式：推挽、开漏、上拉、下拉

STM32的GPIO支持八种工作模式，但最常用的是四种：推挽输出、开漏输出、上拉输入和下拉输入。它们的区别在于输出驱动器的结构和输入引脚的默认电平状态。

推挽输出是最常用的输出模式。内部包含两个互补的MOS管：上管导通时输出高电平，下管导通时输出低电平。这种结构可以提供较大的灌电流和拉电流能力，适合驱动LED、继电器等负载。但推挽输出不能实现"线与"逻辑，多个推挽输出引脚不能直接并联。

开漏输出只有下管，上管被移除。当输出1时，引脚处于高阻状态，必须依靠外部上拉电阻才能输出高电平。这种模式非常适合I2C总线——多个设备可以共享一条数据线，任何一个设备拉低总线，其他设备都能检测到。开漏输出还常用于电平转换，例如5V的I2C设备与3.3V的STM32连接时，只需将上拉电阻接到5V电源即可。

上拉输入和下拉输入的区别在于内部是否连接了上拉或下拉电阻。上拉输入在引脚悬空时默认读到高电平，适合连接按键（按键另一端接地）；下拉输入默认读到低电平，适合连接传感器（传感器输出高电平有效）。选择哪种输入模式，取决于外部电路的设计，目的是避免引脚悬空导致的不确定状态。

4.3 GPIO模式配置：寄存器操作与库函数操作

STM32提供了两种GPIO配置方式：直接寄存器操作和标准库函数操作。寄存器操作更底层、执行效率高，但代码可读性差；库函数封装了底层细节，开发效率高，适合初学者。无论哪种方式，最终都是修改CRL/CRH寄存器中的配置位。

以STM32F103为例，每个GPIO端口有16个引脚，CRL寄存器控制低8位引脚（Pin0~Pin7），CRH控制高8位引脚（Pin8~Pin15）。每个引脚占用4个配置位，其中CNF[1:0]配置模式（输入/输出/复用），MODE[1:0]配置速度（输入模式时MODE必须为00）。

使用寄存器操作配置PA1为推挽输出、50MHz速度，代码如下：

// 开启GPIOA时钟（RCC_APB2ENR的Bit2）
RCC->APB2ENR |= (1 << 2);

// 配置PA1为推挽输出，50MHz
// CRL寄存器：Pin1对应Bit4~Bit7
// MODE[1:0] = 11 (50MHz)，CNF[1:0] = 00 (推挽输出)
GPIOA->CRL |= (0x3 << 4);   // 设置MODE为11
GPIOA->CRL &= ~(0x3 << 6); // 设置CNF为00

// 输出高电平
GPIOA->ODR |= (1 << 1);

使用标准库函数完成相同配置，代码更直观：

GPIO_InitTypeDef GPIO_InitStructure;

// 开启GPIOA时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);

// 配置PA1为推挽输出，50MHz
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_1;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);

// 输出高电平
GPIO_SetBits(GPIOA, GPIO_Pin_1);

对于输入模式，库函数配置类似，只需将GPIO_Mode改为GPIO_Mode_IPU（上拉输入）或GPIO_Mode_IPD（下拉输入）。读取输入电平使用GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_1)函数。

4.4 实战案例：按键控制LED

下面通过一个完整的案例，将本章知识串联起来。假设硬件连接如下：PA0连接一个按键（另一端接GND），PC1连接一个LED（通过1kΩ限流电阻接VCC）。要求实现：按下按键时LED点亮，松开时LED熄灭。

硬件分析：按键一端接PA0，另一端接GND。当按键未按下时，PA0悬空，必须使用上拉输入模式，使默认电平为高；按下后PA0被拉低。LED接PC1，使用推挽输出模式，输出高电平点亮LED。

软件实现步骤：

1. 开启GPIOA和GPIOC的时钟
2. 配置PA0为上拉输入模式
3. 配置PC1为推挽输出模式，50MHz
4. 循环读取PA0的电平状态，若为低电平（按键按下），则PC1输出高电平；否则输出低电平

核心代码如下：

// 初始化
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOC, ENABLE);

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;  // 上拉输入
GPIO_Init(GPIOA, &GPIO_InitStructure);

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_1;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOC, &GPIO_InitStructure);

// 主循环
while (1) {
  if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0) {
    GPIO_SetBits(GPIOC, GPIO_Pin_1);  // 点亮LED
  } else {
    GPIO_ResetBits(GPIOC, GPIO_Pin_1); // 熄灭LED
  }
}

结果验证：按下按键，LED点亮；松开按键，LED熄灭。如果LED状态相反，说明按键电路接法不同，需要调整输入模式为上拉或下拉。

4.5 常见误区与总结复盘

通过本章学习，需要重点掌握以下要点，避免常见错误：

• 时钟使能是前提：任何GPIO操作前，必须先通过RCC寄存器开启对应端口时钟。
• 推挽与开漏的选择：驱动LED、蜂鸣器等负载用推挽；I2C、电平转换等需要线与逻辑的场景用开漏。
• 上拉与下拉的区分：按键接GND用上拉输入，按键接VCC用下拉输入；传感器输出高电平有效用下拉输入，低电平有效用上拉输入。
• 速度配置的误区：GPIO速度不是越快越好。高速模式（50MHz）会增加功耗和噪声，对于LED、按键等低速应用，2MHz或10MHz足够。
• 寄存器与库函数的关系：库函数只是对寄存器的封装，理解寄存器操作有助于排查底层问题，但日常开发推荐使用库函数提高效率。

最后，建议初学者在开发板上动手实践：先点亮一个LED，再读取一个按键，最后将两者结合。通过实际操作，您会发现GPIO配置并不复杂，关键在于理解每种模式背后的硬件原理。掌握了GPIO，就为后续学习定时器、串口、I2C等外设打下了坚实基础。