2. GPIO 外设驱动开发：从寄存器到 HAL 库的实战之路

GPIO 是 STM32 最基础、最常用的外设。说白了，它就是芯片的「手脚」——用来输出高低电平，或者读取外部信号的高低状态。我刚开始学 STM32 时，第一个实验就是点亮 LED，那时候觉得 GPIO 太简单了。后来做项目才发现，GPIO 的模式配置、上下拉、速度选择，每一个细节都可能让板子「翻车」。这一章，咱们就把 GPIO 彻底讲透。

2.1 GPIO 模式详解：不只是输入输出

STM32 的 GPIO 有 8 种工作模式。很多初学者只记得「推挽输出」和「浮空输入」，其实远远不够。我曾在一次工业控制项目中，因为没正确配置开漏输出，导致 I2C 通信一直报错，查了两天才找到原因。

模式	名称	典型用途
输入模式	浮空输入	外部按键、无固定电平的信号
输入模式	上拉输入	按键检测（默认高电平）
输入模式	下拉输入	按键检测（默认低电平）
输入模式	模拟输入	ADC 采样
输出模式	推挽输出	LED、普通数字信号
输出模式	开漏输出	I2C 总线、电平转换
复用功能	复用推挽输出	USART、SPI 等外设引脚
复用功能	复用开漏输出	I2C 等需要开漏的复用功能

2.2 寄存器映射：直接操作硬件的「底层密码」

每个 GPIO 端口都有一组寄存器。以 GPIOA 为例，它的基地址是 0x40020000。你想想看，往这个地址写数据，就是在控制 PA0~PA15 的引脚状态。

常用的寄存器有这几个：

• MODER：模式寄存器，每 2 位控制一个引脚（00=输入，01=输出，10=复用，11=模拟）
• OTYPER：输出类型寄存器，0=推挽，1=开漏
• OSPEEDR：输出速度寄存器，00=低速，01=中速，10=高速，11=超高速
• PUPDR：上下拉寄存器，00=无上下拉，01=上拉，10=下拉
• ODR：输出数据寄存器，写 1 输出高，写 0 输出低
• IDR：输入数据寄存器，读引脚电平
• BSRR：位设置/清除寄存器，低 16 位置位，高 16 位复位

2.3 HAL 库封装：让代码更「优雅」

直接操作寄存器虽然快，但可读性差、移植困难。HAL 库把这些操作封装成了函数。比如：

// 初始化 GPIO
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);

// 输出操作
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_1);

// 输入操作
GPIO_PinState state = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_2);

HAL 库的好处是：你不需要记寄存器地址，函数名一看就懂。但代价是代码体积变大、执行速度变慢。对于对实时性要求高的场景（比如 PWM 中断响应），我建议还是用寄存器操作。

2.4 LED 流水灯实战：第一个「看得见」的程序

流水灯是嵌入式开发的「Hello World」。咱们用 4 个 LED 接在 PA0~PA3 上，实现循环点亮。

void LED_Flow(void)
{
    uint16_t led_pins[] = {GPIO_PIN_0, GPIO_PIN_1, GPIO_PIN_2, GPIO_PIN_3};
    for(int i = 0; i < 4; i++)
    {
        HAL_GPIO_WritePin(GPIOA, led_pins[i], GPIO_PIN_SET);
        HAL_Delay(200);
        HAL_GPIO_WritePin(GPIOA, led_pins[i], GPIO_PIN_RESET);
    }
}

这里有个坑：HAL_Delay 依赖 SysTick 中断。如果你在中断服务函数里调用流水灯，系统会死锁。我刚开始做项目时就踩过这个坑——按键中断里调了延时，结果整个程序卡死了。

2.5 按键中断实战：从「轮询」到「事件驱动」

轮询按键太浪费 CPU 了。真正项目里，我们都会用外部中断。配置步骤很简单：

1. 使能 GPIO 时钟和 SYSCFG 时钟
2. 配置 GPIO 为输入模式（上拉或下拉）
3. 设置中断触发边沿（上升沿、下降沿或双边沿）
4. 配置 NVIC 中断优先级并使能
5. 编写中断服务函数

// 配置 PA0 为下降沿触发的外部中断
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING;
GPIO_InitStruct.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 使能中断线 0
HAL_NVIC_SetPriority(EXTI0_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(EXTI0_IRQn);

// 中断服务函数
void EXTI0_IRQHandler(void)
{
    HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0);
}

// 回调函数
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    if(GPIO_Pin == GPIO_PIN_0)
    {
        // 按键按下，执行动作
        HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
    }
}

2.6 知识体系总览

下面这张图，把 GPIO 的核心知识点串起来了。你可以把它当作本章的「思维导图」。

2.7 避坑指南：我踩过的那些 GPIO 的坑

• 未使能时钟：操作 GPIO 前必须使能对应端口的时钟。忘了这一步，写寄存器根本没反应。我刚开始学的时候，对着代码看了半小时，最后发现是 RCC 时钟没开。
• 中断优先级配置不当：多个中断共用时，优先级设错了会导致中断嵌套异常。建议把按键中断优先级设低一些，系统定时器中断优先级设高一些。
• 引脚复用冲突：同一个引脚不能同时用作 GPIO 和复用功能。比如 PA9 和 PA10 默认是 USART1 的 TX/RX，如果你要当普通 GPIO 用，得先禁用复用功能。
• 上下拉电阻选择：外部已经有上拉电阻时，内部就不要开上拉了，否则会形成分压，导致电平不准。