第3章 GPIO驱动开发：LL库GPIO初始化结构体、输出模式配置、输入模式与中断配置

GPIO，说白了就是芯片的“手脚”。你要让灯亮、读按键、驱动外设，都得通过它。这一章我们就把LL库的GPIO驱动讲透。

3.1 LL库GPIO初始化结构体

LL库和HAL库最大的区别是什么？我个人觉得，LL库更“裸”。它没有那么多抽象层，结构体里的字段你一眼就能看懂对应哪个寄存器。先看这个结构体：

typedef struct {
  uint32_t Pin;        // 引脚编号
  uint32_t Mode;       // 模式：输出、输入、复用、模拟
  uint32_t Speed;      // 速度：低速、中速、高速、极速
  uint32_t OutputType; // 输出类型：推挽、开漏
  uint32_t Pull;       // 上下拉：无、上拉、下拉
  uint32_t Alternate;  // 复用功能选择
} LL_GPIO_InitTypeDef;

嗯，这里要注意——LL库的结构体字段顺序和寄存器位域是对应的。我刚开始从HAL转LL时，总觉得少了个“GPIO_Init”函数，后来才发现LL库的初始化是这么玩的：

LL_GPIO_InitTypeDef GPIO_InitStruct = {0};

GPIO_InitStruct.Pin = LL_GPIO_PIN_0;
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);

你看，结构体赋值完，调用LL_GPIO_Init就写进去了。没有HAL那种“先DeInit再Init”的啰嗦。

3.2 GPIO输出模式配置

输出模式是最常用的。点灯、驱动继电器、控制蜂鸣器，都是输出。配置起来其实就三步：

1. 使能时钟：LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA)
2. 配置结构体：Mode选OUTPUT，OutputType选PUSHPUSH或OPENDRAIN
3. 写电平：LL_GPIO_SetOutputPin() 或 LL_GPIO_ResetOutputPin()

举个例子，驱动一个LED：

// 使能GPIOA时钟
LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA);

// 初始化PA0为推挽输出，低速，无上下拉
LL_GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = LL_GPIO_PIN_0;
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);

// 点亮LED
LL_GPIO_SetOutputPin(GPIOA, LL_GPIO_PIN_0);

这里有个细节——速度选择。低速（LOW）对应2MHz，中速（MEDIUM）对应10MHz，高速（HIGH）对应50MHz，极速（VERY_HIGH）对应100MHz。你想想看，点个灯用100MHz的翻转速度有意义吗？不仅没意义，还会增加EMI和功耗。我建议：能用低速就别用高速。

3.3 GPIO输入模式与中断配置

输入模式，说白了就是读引脚电平。配置和输出类似，但Mode要选LL_GPIO_MODE_INPUT。读电平用LL_GPIO_IsInputPinSet()：

// 配置PA1为输入，上拉
GPIO_InitStruct.Pin = LL_GPIO_PIN_1;
GPIO_InitStruct.Mode = LL_GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = LL_GPIO_PULL_UP;
LL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 读取按键状态
if(LL_GPIO_IsInputPinSet(GPIOA, LL_GPIO_PIN_1) == 0) {
  // 按键按下（低电平有效）
}

但实际项目中，大部分输入场景都需要中断。轮询太浪费CPU了，尤其是在低功耗场景下。LL库配置中断的流程是这样的：

1. 配置GPIO为输入模式
2. 选择触发边沿：上升沿、下降沿、或双边沿
3. 使能NVIC中断
4. 编写中断服务函数

看代码：

// 配置PA1为输入，下拉，下降沿触发中断
GPIO_InitStruct.Pin = LL_GPIO_PIN_1;
GPIO_InitStruct.Mode = LL_GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = LL_GPIO_PULL_DOWN;
LL_GPIO_Init(GPIOA, &GPIO_InitStruct);

// 选择下降沿触发
LL_EXTI_EnableIT_0_31(LL_EXTI_LINE_1);
LL_EXTI_EnableFallingTrig_0_31(LL_EXTI_LINE_1);

// 使能NVIC
NVIC_SetPriority(EXTI1_IRQn, 3);
NVIC_EnableIRQ(EXTI1_IRQn);

中断服务函数里，记得清除中断标志：

void EXTI1_IRQHandler(void) {
  if(LL_EXTI_IsActiveFlag_0_31(LL_EXTI_LINE_1)) {
    LL_EXTI_ClearFlag_0_31(LL_EXTI_LINE_1);
    // 处理按键事件
  }
}

3.4 知识结构图

下面这张图把GPIO驱动的核心流程串起来了：

3.5 避坑指南与实战建议

做GPIO驱动，有几个坑我几乎每次培训都会提：

• 时钟没使能就操作寄存器——读回来的值全是0，写进去的也不生效。我见过有人查了两天，结果是忘了LL_AHB2_GRP1_EnableClock。
• 中断优先级没配好——多个中断同时触发时，优先级低的永远得不到响应。建议统一规划优先级，别偷懒。
• 上下拉电阻选错——外部接了上拉，内部又配了上拉，结果电平被拉得太高，功耗增加。嗯，这里要匹配好。
• 速度配太高——尤其是长走线时，高速翻转会产生振铃和串扰。我建议：先配低速，不够再往上提。