📚 课程目录第4章 GPIO驱动开发

4. GPIO驱动开发

GPIO（General Purpose Input/Output）是STM32所有外设中最基础、使用频率最高的模块。无论是点亮一颗LED、读取一个按键，还是模拟SPI、I2C时序，都离不开对GPIO寄存器的精确配置。本章围绕GPIO的8种工作模式、上下拉电阻、开漏与推挽输出、输出速度、位带操作，以及按键与LED的完整驱动案例展开，帮助读者建立从寄存器到实际工程的完整认知。

一、GPIO的8种工作模式与结构原理

STM32的每个GPIO引脚内部都包含输入驱动器、输出驱动器、上拉/下拉电阻、施密特触发器等结构。通过配置GPIOx_MODER、GPIOx_OTYPER、GPIOx_OSPEEDR、GPIOx_PUPDR四个寄存器，可以组合出8种工作模式：

输入浮空：引脚悬空，电平由外部电路决定，适合外部已有上下拉的场景。
输入上拉：内部上拉电阻接通，默认高电平，适合按键接地检测。
输入下拉：内部下拉电阻接通，默认低电平，适合按键接VCC检测。
模拟输入：关闭施密特触发器，信号直连ADC/DAC，用于模拟采集。
开漏输出：只能拉低，需外部上拉才能输出高电平，适合I2C总线。
推挽输出：可主动输出高、低电平，驱动能力强，适合LED、继电器。
开漏复用：外设控制开漏输出，如I2C的SCL/SDA。
推挽复用：外设控制推挽输出，如SPI的SCK、MOSI。

记忆口诀：输入看上下拉，输出看推挽开漏，复用看外设接管，模拟关触发器。

二、上下拉、开漏与推挽的工程选择

上下拉电阻的核心作用是给悬空引脚一个确定的默认电平，避免因浮空导致输入抖动或功耗异常。内部上下拉电阻通常在30kΩ~50kΩ之间，若外部电路阻抗较高或干扰较强，应使用外部4.7kΩ~10kΩ电阻增强抗扰度。

推挽输出由PMOS和NMOS组成，输出高电平时PMOS导通，低电平时NMOS导通，驱动能力强，但两个引脚不能直接并联，否则会形成短路。开漏输出只有NMOS，输出低电平时导通，输出高电平时呈高阻态，必须依赖外部上拉电阻才能得到高电平。开漏的优点是支持“线与”逻辑，多个开漏引脚可以并联到同一根总线，任意一个拉低总线即为低，这正是I2C总线仲裁的基础。

模式	高电平来源	典型应用	注意事项
推挽输出	内部PMOS	LED、蜂鸣器、继电器	不可并联
开漏输出	外部上拉	I2C、电平转换	必须加上拉
输入上拉	内部上拉	按键接地	注意消抖
输入下拉	内部下拉	按键接VCC	注意消抖
模拟输入	无	ADC采样	关闭数字功能

三、输出速度配置与位带操作

输出速度（OSPEEDR）控制引脚电平翻转的压摆率，可选低速、中速、高速、超高速。速度越高，EMI辐射越大，功耗也越高。一般LED、按键扫描用低速即可；SPI、SDIO等高速信号才需要高速或超高速。不要盲目全部配置为超高速，否则会引入不必要的噪声。

位带操作是Cortex-M内核提供的一种原子位访问机制。STM32将外设区和SRAM区的每个位映射到别名区的一个32位字，对该字的读写等价于对原始位的原子操作。以GPIOA的ODR寄存器为例，PA0对应位带别名地址为：

#define BITBAND(addr, bitnum) ((addr & 0xF0000000) + 0x2000000 + ((addr & 0xFFFFF) << 5) + (bitnum << 2))
#define PA0_OUT BITBAND(0x40020014, 0)   // GPIOA_ODR
#define PA0_IN  BITBAND(0x40020010, 0)   // GPIOA_IDR

// 使用
PA0_OUT = 1;   // 原子置位PA0
PA0_OUT = 0;   // 原子清零PA0

位带操作的优势是“读-改-写”一步完成，不会被中断打断，适合多任务环境下的标志位操作。但HAL库已提供HAL_GPIO_WritePin，工程中可按需选择。

四、按键与LED驱动案例

下面以STM32F103为例，PA5接LED（推挽输出，低电平点亮），PC13接按键（输入上拉，按下为低电平），实现“按下按键翻转LED”的功能。

// 1. 使能时钟
RCC->APB2ENR |= RCC_APB2ENR_IOPAEN | RCC_APB2ENR_IOPCEN;

// 2. PA5 推挽输出，低速
GPIOA->CRL &= ~(0xF << 20);
GPIOA->CRL |=  (0x1 << 20);   // 输出模式，最大10MHz

// 3. PC13 输入上拉
GPIOC->CRH &= ~(0xF << 20);
GPIOC->CRH |=  (0x8 << 20);   // 输入模式，上拉/下拉
GPIOC->ODR |=  (1 << 13);     // 上拉

// 4. 主循环
while (1) {
    if ((GPIOC->IDR & (1 << 13)) == 0) {   // 按键按下
        for (volatile int i = 0; i < 72000; i++); // 简单消抖
        if ((GPIOC->IDR & (1 << 13)) == 0) {
            GPIOA->ODR ^= (1 << 5);        // 翻转LED
            while ((GPIOC->IDR & (1 << 13)) == 0); // 等待释放
        }
    }
}

若使用HAL库，代码更简洁：

GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
__HAL_RCC_GPIOC_CLK_ENABLE();

gpio.Pin = GPIO_PIN_5;
gpio.Mode = GPIO_MODE_OUTPUT_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &gpio);

gpio.Pin = GPIO_PIN_13;
gpio.Mode = GPIO_MODE_INPUT;
gpio.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOC, &gpio);

while (1) {
    if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET) {
        HAL_Delay(20);
        if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET) {
            HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
            while (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET);
        }
    }
}

五、常见误区与复盘

误区1：按键不加上拉或下拉，引脚浮空导致读数随机。解决：输入模式必须明确上下拉，或外部加电阻。

误区2：开漏输出忘记外部上拉，输出永远为低或高阻。解决：开漏必须配合上拉电阻使用。

误区3：两个推挽输出直接并联，一个输出高一个输出低，形成大电流短路。解决：需要线与时改用开漏。

误区4：所有GPIO都配置为超高速，导致EMI超标、功耗上升。解决：按信号速率选择最低够用的速度档位。

误区5：按键消抖只做一次延时，长按或快速连按误判。解决：采用“延时+二次确认+等待释放”的状态机思路。

复盘本章：GPIO配置的本质是“模式+上下拉+速度”三要素的组合。推挽用于主动驱动，开漏用于总线共享，上下拉用于确定默认电平，速度用于平衡信号完整性与EMI。位带操作提供了原子位访问能力，在裸机多任务或中断共享标志位时非常实用。掌握这些要点后，按键与LED这类基础驱动就能稳定可靠地运行，也为后续SPI、I2C、UART等外设的GPIO复用配置打下坚实基础。