📚 课程目录第2章开发环境搭建

2. 开发环境搭建

GPIO，说白了就是芯片的“手脚”。你要让 LED 亮，得靠它；你要读按键，也得靠它。我刚开始用 STM32 时，总觉得 GPIO 太简单，不就是置 1 清 0 嘛。结果有一次板子焊回来，LED 死活不亮，查了半天才发现是模式配错了——输出开漏，没加上拉，电平根本拉不上去。嗯，从那以后，我再也不敢小看 GPIO 的配置了。

2.1 GPIO 的八种工作模式

STM32 的 GPIO 有 8 种模式，但别被数字吓到。我习惯把它们分成三大类：输入、输出、复用。每种模式对应不同的硬件电路结构，选错了，轻则功能异常，重则烧引脚。

模式	分类	典型用途	我踩过的坑
浮空输入	输入	外部中断、电平检测	引脚悬空时电平随机跳变，读按键会误触发
上拉输入	输入	按键检测（默认高电平）	内部上拉约 40kΩ，低功耗项目注意漏电
下拉输入	输入	按键检测（默认低电平）	下拉电阻也是 40kΩ，外部强驱动会冲突
模拟输入	输入	ADC 采样	必须配模拟模式，否则 ADC 结果不准
推挽输出	输出	LED、普通数字信号	最常用，高低电平都能主动驱动
开漏输出	输出	I2C 总线、电平转换	高电平靠外部上拉，内部只能拉低
复用推挽	复用	USART_TX、SPI_MOSI	外设输出时用，别配成普通输出
复用开漏	复用	I2C_SCL/SDA	I2C 必须用这个，否则总线会锁死

核心原则：输出功能选输出模式，输入功能选输入模式，外设功能选复用模式。别混用，混用必出 bug。

2.2 LL_GPIO_Init 结构体详解

LL 库的初始化函数 LL_GPIO_Init 接受一个结构体参数。我个人习惯把结构体成员记成“五要素”：引脚、模式、速度、输出类型、上下拉。少配一个，就可能出问题。

LL_GPIO_InitTypeDef GPIO_InitStruct = {0};

GPIO_InitStruct.Pin        = LL_GPIO_PIN_5;          // 选引脚
GPIO_InitStruct.Mode       = LL_GPIO_MODE_OUTPUT;    // 输出模式
GPIO_InitStruct.Speed      = LL_GPIO_SPEED_FREQ_LOW; // 低速
GPIO_InitStruct.OutputType = LL_GPIO_OUTPUT_PUSHPULL;// 推挽
GPIO_InitStruct.Pull       = LL_GPIO_PULL_NO;        // 无上下拉

LL_GPIO_Init(GPIOA, &GPIO_InitStruct);

这里有个细节：Speed 不是输出速度，而是 IO 驱动电路的响应速度。低速模式能抑制 EMI，高频信号才需要高速。我见过有人把 I2C 的引脚配成高速，结果波形过冲严重，通信反而失败。

我的习惯：普通 GPIO 输出用 FREQ_LOW，SPI 时钟用 FREQ_HIGH，I2C 用 FREQ_MEDIUM。够用就好，别盲目开高速。

2.3 输出控制：点亮你的第一颗 LED

输出控制就两个函数：LL_GPIO_SetOutputPin 和 LL_GPIO_ResetOutputPin。还有一个 LL_GPIO_TogglePin 用于翻转。

// 点亮 PA5 上的 LED
LL_GPIO_SetOutputPin(GPIOA, LL_GPIO_PIN_5);

// 熄灭
LL_GPIO_ResetOutputPin(GPIOA, LL_GPIO_PIN_5);

// 翻转
LL_GPIO_TogglePin(GPIOA, LL_GPIO_PIN_5);

你可能会问：为什么不用 GPIOA->ODR 直接写寄存器？LL 库的函数在 Release 模式下会被内联成单条指令，性能几乎一样。但代码可读性高很多。我在团队里强制要求：除非是中断服务函数里的极致优化，否则一律用 LL 库函数。

注意：同时操作多个引脚时，用 LL_GPIO_WriteOutputPort 一次性写入整个端口寄存器，避免多次调用造成引脚电平不同步。

2.4 输入读取：按键检测实战

读取输入用 LL_GPIO_IsInputPinSet，返回 1 表示高电平，0 表示低电平。但直接读按键会有抖动问题，我吃过亏。

// 读取 PC13 按键（假设按下为低电平）
if (LL_GPIO_IsInputPinSet(GPIOC, LL_GPIO_PIN_13) == 0) {
    // 延时消抖
    for (volatile uint32_t i = 0; i < 10000; i++);
    if (LL_GPIO_IsInputPinSet(GPIOC, LL_GPIO_PIN_13) == 0) {
        // 按键确实被按下
        LL_GPIO_TogglePin(GPIOA, LL_GPIO_PIN_5);
    }
}

为什么需要消抖？机械按键在按下和释放的瞬间，触点会弹跳 5~20ms。如果不做延时，一次按下可能被误判成多次。我曾经在一个量产项目里没做消抖，结果用户按一次，LED 闪了七八下——被投诉了。

经验值：消抖延时 10~20ms 足够。用 for 循环延时只适合测试，正式项目请用定时器或系统滴答。

2.5 知识结构图：GPIO 操作全流程

下面这张图总结了 GPIO 从配置到使用的完整链路。我画图时习惯把“配置”和“操作”分开，这样调试时能快速定位问题出在初始化阶段还是运行阶段。

2.6 避坑指南：我踩过的 GPIO 坑

时钟没使能：配置 GPIO 前必须调用 LL_AHB1_GRP1_EnableClock。我见过有人把时钟使能写在初始化之后，结果寄存器写不进去，引脚毫无反应。
开漏输出忘加上拉：开漏模式高电平靠外部上拉。如果外部没接电阻，引脚永远拉不高，读回来永远是 0。
复用模式配成普通输出：比如 USART 的 TX 引脚，如果配成推挽输出，数据能发出去，但波特率会乱。因为外设信号没经过复用器。
上下拉与外部电路冲突：外部已经接了 10kΩ 上拉到 3.3V，内部又配了下拉。结果是内部下拉把电平拉低，外部上拉又拉高，引脚电平不确定。

我曾经犯过的错：一个 I2C 项目，SCL 和 SDA 配成了推挽输出。结果总线一直拉高，从机不响应。查了两天，最后发现是模式错了。I2C 必须用复用开漏，切记。

2.7 小结：GPIO 操作的核心要点

GPIO 看似简单，但它是所有外设的基础。我建议你每次配置 GPIO 时，都问自己三个问题：

时钟开了吗？
模式选对了吗？
上下拉和外部电路匹配吗？

这三个问题答对了，GPIO 基本不会出问题。如果还是不行，拿示波器看引脚波形，比读代码快得多。