GPIO基础与LED驱动：从寄存器到HAL库的实战之路

各位同学，咱们今天聊点实在的。GPIO，说白了就是单片机跟外界打交道的最基本通道。你想想看，一个单片机再厉害，如果连个灯都点不亮，那跟一块石头有什么区别？我刚开始做嵌入式那会儿，第一个任务就是点亮LED，当时觉得简单，结果一上手才发现，这里面的门道还真不少。

GPIO模式配置：推挽输出 vs 开漏输出

先说说输出模式。很多新手一上来就问：为什么我的LED不亮？其实多半是模式没配对。

推挽输出，内部有PMOS和NMOS两个管子，一个推一个拉，所以叫推挽。输出高电平时，PMOS导通，电流从VCC经过管子流到引脚；输出低电平时，NMOS导通，电流从引脚流到GND。说白了，就是既能灌电流又能拉电流。

开漏输出就不一样了。它只有NMOS，只能把引脚拉到GND。想输出高电平？得靠外部上拉电阻。我在项目中遇到过一个问题：用开漏输出驱动LED，结果灯死活不亮。后来才发现，忘了加上拉电阻，引脚一直处于高阻态，电流根本流不过去。

上拉/下拉输入：别让引脚悬空

输入模式也有讲究。你想想看，一个引脚如果不接任何东西，它的电平是不确定的，这叫「浮空」。浮空状态下，读到的值可能是0也可能是1，完全看心情。这在实际项目中是要出大问题的。

上拉输入，就是内部把一个电阻接到VCC，让引脚默认是高电平。下拉输入，则是内部电阻接到GND，默认是低电平。按键检测就是个典型场景：按键没按下时，引脚通过上拉电阻保持高电平；按下后，引脚被拉到GND，变成低电平。

寄存器操作 vs HAL库函数：两种思路

说到GPIO配置，有两种方式：直接操作寄存器和用HAL库函数。很多初学者问我：到底学哪个？我的回答是：两个都得会。

直接操作寄存器，速度快，代码体积小，适合对时序要求高的场景。但可读性差，移植性也差。HAL库函数封装得好，代码清晰，移植方便，但执行效率会低一些。

咱们拿STM32F103来举个例子。要配置PA5为推挽输出，寄存器写法是这样的：

// 开启GPIOA时钟
RCC->APB2ENR |= (1 << 2);

// 配置PA5为推挽输出，50MHz
GPIOA->CRL &= ~(0xF << 20);  // 先清零
GPIOA->CRL |= (0x3 << 20);   // 设置为推挽输出

// 输出高电平
GPIOA->BSRR = (1 << 5);

// 输出低电平
GPIOA->BRR = (1 << 5);

用HAL库的话，代码是这样的：

GPIO_InitTypeDef GPIO_InitStruct = {0};

// 开启GPIOA时钟
__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_HIGH;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 输出高电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

// 输出低电平
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);

你看，HAL库的代码更直观，但背后做的事情跟寄存器操作是一样的。我个人习惯是：原型验证阶段用HAL库，快速出效果；到了产品优化阶段，关键路径上的GPIO操作会改成寄存器直接操作，省几个时钟周期也是好的。

LED闪烁：最简单的入门实验

好了，理论说完了，咱们动手。LED闪烁，说白了就是让GPIO交替输出高低电平。延时可以用简单的循环，也可以用定时器。这里先用循环延时：

while (1)
{
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);   // 亮
    delay_ms(500);                                          // 延时500ms
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET); // 灭
    delay_ms(500);                                          // 延时500ms
}

这个delay_ms函数怎么实现？最简单的就是用循环：

void delay_ms(uint32_t ms)
{
    for (uint32_t i = 0; i < ms; i++)
    {
        for (uint32_t j = 0; j < 8000; j++);  // 具体数值根据主频调整
    }
}

嗯，这里要注意：这种延时方式会占用CPU，延时期间CPU什么都干不了。在实际项目中，我一般用定时器中断或者SysTick来实现精确延时，后面章节会详细讲。

呼吸灯：PWM的入门应用

呼吸灯，就是LED从暗到亮，再从亮到暗，像呼吸一样。这需要用到PWM（脉冲宽度调制）。PWM的原理很简单：通过调节高电平占空比，来控制LED的平均亮度。

占空比越高，LED越亮；占空比越低，LED越暗。人眼有视觉暂留效应，只要PWM频率足够高（一般100Hz以上），就看不到闪烁，只感觉到亮度变化。

用定时器输出PWM是最标准的方式。这里我给出一个用软件模拟PWM的简单实现，方便你理解原理：

void breath_led(void)
{
    uint16_t duty = 0;
    uint8_t direction = 1;  // 1: 变亮, 0: 变暗

    while (1)
    {
        // 输出一个PWM周期
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);
        delay_us(duty);  // 高电平时间
        HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);
        delay_us(1000 - duty);  // 低电平时间

        // 更新占空比
        if (direction)
        {
            duty += 10;
            if (duty >= 1000)
                direction = 0;
        }
        else
        {
            duty -= 10;
            if (duty <= 0)
                direction = 1;
        }
    }
}

这个实现里，PWM周期是1000微秒（1ms），频率就是1kHz。占空比从0到1000变化，LED就从灭到亮。你想想看，如果占空比变化得慢一点，呼吸效果就更柔和。

知识体系总览

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

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

• 限流电阻不能省：直接给LED供电，电流可能高达几十毫安，超过GPIO的驱动能力。我一般串联一个220Ω~470Ω的电阻，把电流限制在10mA左右。
• 引脚初始化顺序：先配置GPIO模式，再输出电平。如果先输出电平再配置模式，可能会产生一个短暂的错误电平。
• 开漏输出别忘了上拉：用开漏输出驱动LED，LED的另一端要接VCC，而不是GND。否则电流路径不通，灯不会亮。
• PWM频率要合适：呼吸灯的PWM频率建议在100Hz~1kHz之间。频率太低会看到闪烁，频率太高LED的响应速度跟不上。

好了，这一章的内容就到这里。GPIO看似简单，但它是所有外设驱动的基础。你把这些搞明白了，后面学I²C、SPI、UART都会轻松很多。记住：寄存器操作和HAL库都要会，一个用来理解原理，一个用来提高效率。