3、GPIO输出控制：GPIO基础知识、HAL_GPIO_WritePin函数、点亮LED实战

各位同学，欢迎来到第三章。

前两章我们把开发环境搭好了，也跑通了第一个程序。但说句实话，点灯才是嵌入式的"Hello World"。你想想看，一个单片机连个灯都点不亮，那还谈什么项目？

这一章，我们就来彻底搞懂GPIO输出。我会从最底层的寄存器讲到HAL库函数，最后带你亲手点亮LED。嗯，这里要注意，我讲的不是那种"照着抄就能亮"的教程，而是让你真正理解——为什么这么写，背后发生了什么。

3.1 GPIO到底是什么？

GPIO，全称General Purpose Input Output，通用输入输出口。说白了，就是芯片上那些可以编程控制的引脚。

你可以把它想象成一个"智能开关"：

• 输出模式：芯片控制引脚输出高电平（3.3V）或低电平（0V）
• 输入模式：芯片读取引脚上的电平是高还是低

我刚开始学的时候，总觉得GPIO很神秘。后来拆了一个产品，发现里面最复杂的逻辑也就是GPIO的输入输出组合。说白了，单片机就是靠这些引脚跟外界打交道的。

3.2 STM32的GPIO结构

STM32的GPIO比51单片机复杂得多。每个GPIO端口（如GPIOA、GPIOB）有16个引脚，每个引脚都可以独立配置。

这里我画了一张结构图，帮你理清GPIO的内部逻辑：

看到这个图你就明白了：我们写代码设置引脚电平，最终都是通过操作寄存器来实现的。HAL库只是帮我们封装了这些操作。

3.3 GPIO输出模式详解

STM32的GPIO输出有两种模式，我分别说一下：

模式	特点	适用场景
推挽输出	可以输出高电平或低电平，驱动能力强	驱动LED、蜂鸣器、普通数字信号
开漏输出	只能输出低电平，高电平需要外部上拉	I2C总线、多设备共享线路

3.4 HAL_GPIO_WritePin 函数深度解析

这个函数是GPIO输出的核心。我们来看看它的原型：

void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

三个参数，我一个个说：

• GPIOx：端口基地址，比如GPIOA、GPIOB、GPIOC
• GPIO_Pin：引脚编号，比如GPIO_PIN_0、GPIO_PIN_1
• PinState：电平状态，GPIO_PIN_RESET（低电平）或GPIO_PIN_SET（高电平）

举个例子，让PA0输出高电平：

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);

就这么简单。但你知道吗？这个函数背后其实做了不少事情。我带你看看它的源码（简化版）：

void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
{
    if(PinState != GPIO_PIN_RESET)
    {
        GPIOx->BSRR = GPIO_Pin;  // 设置高电平
    }
    else
    {
        GPIOx->BSRR = (uint32_t)GPIO_Pin << 16;  // 设置低电平
    }
}

我曾经在一个项目中，因为用了ODR直接赋值，导致中断里修改引脚电平出了bug。后来换成BSRR，问题就解决了。这个坑，我帮你踩过了。

3.5 点亮LED实战

好了，理论说完了，我们来动手。假设LED接在PA0引脚，正极接3.3V，负极接PA0（低电平点亮）。

完整的代码流程：

// 1. 使能GPIOA时钟
__HAL_RCC_GPIOA_CLK_ENABLE();

// 2. 配置GPIOA引脚0为推挽输出
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_0;
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);

// 3. 点亮LED（低电平）
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);

// 4. 延时后熄灭
HAL_Delay(1000);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET);

3.6 常见问题与调试技巧

在实际调试中，你可能会遇到这些问题：

1. LED不亮：检查时钟使能、引脚配置、接线是否正确
2. LED微亮：可能是引脚模式配置错误，或者驱动能力不足
3. LED闪烁异常：检查延时函数是否正常工作

我的调试习惯是：先用万用表测引脚电压。如果代码写了输出高电平，但引脚还是0V，那肯定是配置有问题。如果电压正常但灯不亮，那就是硬件问题了。

3.7 本章小结

这一章我们学了：

• GPIO的本质就是可编程的引脚
• 推挽输出和开漏输出的区别
• HAL_GPIO_WritePin函数的用法
• 完整的LED点亮流程

说实话，点灯虽然简单，但它是你理解嵌入式系统的第一步。后面所有的外设驱动、通信协议，都离不开GPIO的基础操作。把这个基础打牢了，后面的路就好走了。

---