📚 课程目录第3章 GPIO外设驱动

3、GPIO外设驱动：寄存器详解、HAL库驱动与中断实战

GPIO，说白了就是芯片的「手脚」——用来跟外界打交道的最基本方式。我刚开始学STM32时，觉得GPIO不就是点个灯嘛，有啥好讲的？后来做项目才发现，很多奇怪的问题都出在GPIO配置上。比如引脚没拉高、模式选错了、中断没清标志……嗯，这一章咱们就把GPIO彻底讲透。

3.1 GPIO寄存器：芯片的「开关面板」

每个GPIO端口（如GPIOA、GPIOB）背后都有一组寄存器。你往寄存器里写值，引脚就听话地输出高低电平；你读寄存器，就知道外部是高还是低。说白了，这就是个「开关面板」。

STM32的GPIO寄存器主要有这么几个：

寄存器	全称	作用
MODER	端口模式寄存器	设置输入/输出/复用/模拟
OTYPER	输出类型寄存器	推挽输出或开漏输出
OSPEEDR	输出速度寄存器	低速/中速/高速/超高速
PUPDR	上拉/下拉寄存器	内部上拉、下拉或浮空
IDR	输入数据寄存器	读引脚电平（只读）
ODR	输出数据寄存器	写引脚电平
BSRR	位设置/复位寄存器	原子操作置位或复位
AFR[0:1]	复用功能寄存器	选择外设功能（如USART、SPI）

我的小习惯：配置GPIO时，我总先写MODER，再写PUPDR，最后写OSPEEDR。顺序固定了，就不容易漏。曾经有个同事漏配了PUPDR，结果引脚浮空，按键怎么按都不对——查了一下午才发现。

3.2 HAL库GPIO驱动：封装好的「遥控器」

直接操作寄存器当然快，但可读性差。HAL库把这些操作封装成了几个函数，用起来就像遥控器——按一个键，灯就亮了。

常用的HAL库GPIO函数：

HAL_GPIO_WritePin() — 写引脚电平
HAL_GPIO_ReadPin() — 读引脚电平
HAL_GPIO_TogglePin() — 翻转引脚电平
HAL_GPIO_Init() — 初始化GPIO
HAL_GPIO_DeInit() — 恢复GPIO默认状态

举个例子，点亮LED：

// 初始化结构体
GPIO_InitTypeDef GPIO_InitStruct = {0};

// 使能GPIO时钟
__HAL_RCC_GPIOA_CLK_ENABLE();

// 配置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);

// 点亮LED（低电平有效）
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);

  关键点：HAL_GPIO_Init()内部会帮你配置MODER、OTYPER、PUPDR、OSPEEDR等多个寄存器。但时钟必须提前使能，否则写寄存器等于白写——芯片根本不理你。

3.3 按键中断：让芯片「主动响应」

轮询读按键太浪费CPU了——你想想看，主循环里一直读引脚，啥也干不了。中断才是正经做法：按键按下，芯片自动跳进中断服务函数，处理完再回来。

配置外部中断的步骤：

使能GPIO时钟和SYSCFG时钟
配置GPIO为输入模式
设置引脚为外部中断源（SYSCFG_EXTICR）
配置中断触发边沿（上升沿/下降沿/双边沿）
配置NVIC使能中断
编写中断服务函数

HAL库代码示例：

// 配置PA0为外部中断（下降沿触发）
GPIO_InitTypeDef GPIO_InitStruct = {0};

__HAL_RCC_GPIOA_CLK_ENABLE();
__HAL_RCC_SYSCFG_CLK_ENABLE();

GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING;
GPIO_InitStruct.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

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

中断服务函数：

void EXTI0_IRQHandler(void)
{
    // HAL库自带的中断处理函数
    HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_0);
}

// 回调函数——真正干活的地方
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{
    if(GPIO_Pin == GPIO_PIN_0)
    {
        // 按键按下，翻转LED
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
    }
}

我曾经踩过的坑：中断服务函数里一定要调用HAL_GPIO_EXTI_IRQHandler()，它会帮你清中断标志位。如果不调，中断会一直触发，芯片就卡死在中断里了。别问我怎么知道的……

3.4 知识结构图：GPIO驱动全景

下面这张图把GPIO驱动的核心逻辑串起来了——从寄存器到HAL库，再到中断实战：

3.5 实战：按键控制LED（完整代码）

把上面讲的东西串起来，写一个完整的例子：按键按下，LED翻转。

// main.c
#include "stm32f4xx_hal.h"

void SystemClock_Config(void);
void GPIO_Init(void);

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    GPIO_Init();

    while(1)
    {
        // 主循环可以干别的事
        // 按键中断会自动处理LED翻转
    }
}

void GPIO_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 使能时钟
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_SYSCFG_CLK_ENABLE();

    // PA5: LED输出
    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);

    // 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);

    // 配置NVIC
    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_Delay(20);
        if(HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET)
        {
            HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
        }
    }
}

关于防抖：机械按键按下时会有抖动，一般持续5-20ms。我习惯在回调里加一个20ms的延时再读一次引脚，确认确实是按下而不是抖动。当然，更专业的做法是用定时器做去抖，但小项目里延时够用了。

3.6 常见问题速查表

现象	可能原因	解决办法
LED不亮	时钟未使能 / 引脚模式错	检查__HAL_RCC_GPIOx_CLK_ENABLE()和Mode配置
按键没反应	上下拉配置不对 / 中断未使能	检查PUPDR和NVIC配置
中断一直触发	中断标志未清	确保调用了HAL_GPIO_EXTI_IRQHandler()
引脚电平不对	复用功能配置冲突	检查AFR寄存器是否被其他外设占用

GPIO看似简单，但它是所有外设的基础。寄存器、HAL库、中断——这三层搞明白了，后面学定时器、串口、I2C都会轻松很多。嗯，这一章就到这儿，动手试试吧。