📚 课程目录第3章 GPIO驱动封装（输出模式）

3. GPIO驱动封装（输出模式）

GPIO输出，说白了就是让芯片的引脚输出高电平或低电平。听起来简单，但实际项目中，我见过不少人在这上面栽跟头。比如推挽和开漏搞混，初始化参数配错，结果LED不亮或者芯片发热。嗯，这节课我们就来彻底搞定它。

3.1 为什么需要封装？

直接操作寄存器当然可以，但代码复用性太差。你想想看，换个引脚就得改一堆宏定义，换个项目又得重写。我个人的习惯是，把GPIO的初始化、设置、复位这些操作封装成函数，用结构体传参。这样代码清晰，移植也方便。

封装的好处：

代码可读性高——一看就知道在配置什么
移植方便——换芯片只需改底层寄存器操作
减少重复代码——不用每次写一堆寄存器赋值

3.2 结构体参数化配置

我们先定义一个结构体，把GPIO的配置项都放进去。这样调用初始化函数时，传一个结构体指针就行，清晰又简洁。

typedef struct {
    uint32_t Pin;           // 引脚号 (GPIO_PIN_0 ~ GPIO_PIN_15)
    uint32_t Mode;          // 模式: 输入/输出/复用/模拟
    uint32_t Speed;         // 速度: 低速/中速/高速/超高速
    uint32_t OutputType;    // 输出类型: 推挽/开漏
    uint32_t Pull;          // 上下拉: 无/上拉/下拉
} GPIO_InitTypeDef;

这个结构体，我在多个项目里都用过。从STM32F1到F4，基本结构没变过，只是寄存器地址不同。你想想看，这就是封装的价值。

3.3 GPIO_Init() 函数实现

初始化函数的核心，就是把结构体里的参数写到对应的寄存器。以STM32为例，主要涉及以下几个寄存器：

寄存器	作用	对应结构体成员
MODER	模式选择	Mode
OTYPER	输出类型	OutputType
OSPEEDR	输出速度	Speed
PUPDR	上下拉配置	Pull

void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct) {
    uint32_t pinpos = 0;
    uint32_t pos = 0;
    uint32_t currentpin = 0;

    // 遍历16个引脚
    for(pinpos = 0; pinpos < 16; pinpos++) {
        pos = 1 << pinpos;
        currentpin = GPIO_InitStruct->Pin & pos;

        if(currentpin == pos) {
            // 配置 MODER
            GPIOx->MODER &= ~(0x3 << (pinpos * 2));
            GPIOx->MODER |= (GPIO_InitStruct->Mode << (pinpos * 2));

            // 配置 OTYPER (仅输出模式有效)
            if((GPIO_InitStruct->Mode == GPIO_MODE_OUTPUT_PP) ||
               (GPIO_InitStruct->Mode == GPIO_MODE_OUTPUT_OD)) {
                GPIOx->OTYPER &= ~(0x1 << pinpos);
                GPIOx->OTYPER |= (GPIO_InitStruct->OutputType << pinpos);
            }

            // 配置 OSPEEDR
            GPIOx->OSPEEDR &= ~(0x3 << (pinpos * 2));
            GPIOx->OSPEEDR |= (GPIO_InitStruct->Speed << (pinpos * 2));

            // 配置 PUPDR
            GPIOx->PUPDR &= ~(0x3 << (pinpos * 2));
            GPIOx->PUPDR |= (GPIO_InitStruct->Pull << (pinpos * 2));
        }
    }
}

注意：我曾经在配置MODER时忘了先清零，结果模式一直不对，查了半天才发现是位操作没做好。记住，写寄存器前一定要先清零对应位，再赋值。

3.4 GPIO_SetPin() 与 GPIO_ResetPin()

输出高电平和低电平，最直接的方式就是操作BSRR寄存器。这个寄存器很巧妙，低16位写1置位，高16位写1复位。一次写入，原子操作，不需要关中断。

void GPIO_SetPin(GPIO_TypeDef* GPIOx, uint16_t Pin) {
    GPIOx->BSRR = Pin;  // 低16位置位
}

void GPIO_ResetPin(GPIO_TypeDef* GPIOx, uint16_t Pin) {
    GPIOx->BSRR = (uint32_t)Pin << 16;  // 高16位复位
}

为什么不用ODR寄存器？因为ODR的读写不是原子的，如果中断里也操作同一个GPIO，可能会出问题。BSRR是只写寄存器，一次搞定，安全可靠。这是我个人的经验之谈。

3.5 推挽输出 vs 开漏输出

这两个概念，初学者容易搞混。我简单解释一下：

特性	推挽输出	开漏输出
高电平驱动	由内部PMOS提供	需要外部上拉电阻
低电平驱动	由内部NMOS提供	由内部NMOS提供
电平转换	不支持	支持（通过上拉电阻）
典型应用	LED、普通IO	I2C、多设备共用总线

说白了，推挽输出就是既能拉高又能拉低，驱动能力强。开漏输出只能拉低，拉高靠外部电阻。我在做I2C驱动时，就吃过开漏的亏——忘了加上拉电阻，总线一直低电平，设备死活不响应。

3.6 LED流水灯实战

理论讲完了，我们来写个流水灯。假设三个LED分别接在PA0、PA1、PA2上，低电平点亮。

// 定义LED引脚
#define LED1_PIN GPIO_PIN_0
#define LED2_PIN GPIO_PIN_1
#define LED3_PIN GPIO_PIN_2

// 初始化GPIO
void LED_Init(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    __HAL_RCC_GPIOA_CLK_ENABLE();  // 使能时钟

    GPIO_InitStruct.Pin = LED1_PIN | LED2_PIN | LED3_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;  // 推挽输出
    GPIO_InitStruct.OutputType = GPIO_OUTPUT_TYPE_PP;  // 推挽
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;  // 低速即可
    GPIO_InitStruct.Pull = GPIO_PULLUP;  // 上拉，确保默认高电平

    GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 初始状态：全部熄灭（高电平）
    GPIO_SetPin(GPIOA, LED1_PIN | LED2_PIN | LED3_PIN);
}

// 流水灯主函数
void LED_Flow(void) {
    uint16_t led_pins[] = {LED1_PIN, LED2_PIN, LED3_PIN};
    uint8_t i;

    while(1) {
        for(i = 0; i < 3; i++) {
            // 点亮当前LED（低电平）
            GPIO_ResetPin(GPIOA, led_pins[i]);
            delay_ms(200);  // 延时200ms

            // 熄灭当前LED（高电平）
            GPIO_SetPin(GPIOA, led_pins[i]);
        }
    }
}

小技巧：延时函数可以用简单的循环实现，但实际项目中建议用定时器。我刚开始做时就用空循环延时，结果不同优化等级下延时时间不一样，调试起来很头疼。

3.7 知识结构图

下面这张图，把GPIO输出模式的封装思路和调用流程串起来了。你可以对照着看，理解整个设计脉络。

3.8 避坑指南

最后，分享几个我踩过的坑：

时钟没使能：配置GPIO前一定要使能对应端口的时钟。我刚开始学STM32时，忘了这一步，寄存器写不进去，查了半天才发现。
推挽和开漏混用：如果外设需要开漏输出（比如I2C），用了推挽模式，总线会拉不低。反过来，开漏输出忘了加上拉电阻，高电平出不来。
位操作顺序：配置寄存器时，先清零再赋值。否则旧值会干扰新值，结果不是你想要的。
BSRR vs ODR：多任务环境下，操作ODR可能被中断打断，导致输出错误。用BSRR更安全。

嗯，这节课的内容就到这里。GPIO输出模式看似简单，但封装好了，后面所有外设驱动都能复用这套思路。你动手试试，把流水灯跑起来，感受一下封装带来的便利。