3. GPIO 外设驱动与调试：从模式配置到实战应用

GPIO 是嵌入式开发里最基础、也最容易被轻视的外设。我见过不少工程师，上来就写 HAL_GPIO_WritePin，结果板子不亮、按键没反应，查半天发现是模式配错了。说白了，GPIO 的每个模式都有它的脾气，摸透了才能用得顺手。

3.1 GPIO 模式配置：八种模式，你选对了吗？

STM32 的 GPIO 有 8 种工作模式，但实际项目中常用的就 4-5 种。我习惯把它们分成三类：

类别	模式	典型用途	我的经验
输入	浮空输入、上拉输入、下拉输入、模拟输入	按键检测、ADC 采样	按键用上拉输入最稳，省外部电阻
输出	推挽输出、开漏输出	LED 控制、I2C 总线	推挽驱动能力强，开漏适合多设备共用
复用	复用推挽、复用开漏	USART、SPI 等外设引脚	别手动操作复用引脚，交给外设自己管

3.2 推挽输出 vs 开漏输出：到底怎么选？

推挽输出，说白了就是内部有两个 MOS 管，一个推高电平，一个拉低电平。输出高时直接连 VCC，低时直接连 GND。驱动能力强，LED 直接推没问题。

开漏输出呢？只有拉低的能力，高电平是靠外部上拉电阻实现的。为什么要有这种模式？

• 电平转换： 3.3V 的 MCU 要驱动 5V 的设备，开漏 + 5V 上拉就搞定了
• 线与逻辑： 多个设备共用一个总线，谁拉低谁说话，I2C 就是这么干的
• 电流能力： 开漏输出拉低时电流可以很大，但高电平靠电阻，速度慢

3.3 上下拉电阻：别让引脚“悬空”

输入引脚如果不接上下拉，电平就是不确定的。STM32 内部有可配置的上下拉电阻，大约 40kΩ。我一般这么用：

• 按键检测： 上拉输入，按键按下拉低，释放高电平
• 外部中断： 根据触发沿选择上拉或下拉
• 未使用的引脚： 配置为模拟输入或上拉输出，省电防干扰

你想想看，如果引脚浮空，手指靠近都能让电平跳变。我遇到过一批产品，在强电磁干扰环境下频繁误触发，最后发现是 GPIO 没配上下拉，加上 10kΩ 外部下拉后问题消失。

3.4 实战：LED 呼吸灯

呼吸灯的核心是 PWM。STM32 的定时器可以输出 PWM，但这里我们用 GPIO 模拟——虽然精度不高，但能让你理解原理。

// 呼吸灯实现：GPIO 模拟 PWM
void breath_led(void) {
    uint16_t duty;
    for (duty = 0; duty < 1000; duty++) {
        HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);
        delay_us(duty);  // 高电平时间逐渐增加
        HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
        delay_us(1000 - duty);  // 低电平时间逐渐减少
    }
    for (duty = 1000; duty > 0; duty--) {
        HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);
        delay_us(duty);
        HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
        delay_us(1000 - duty);
    }
}

实际项目中，我会用定时器的 PWM 输出，频率设在 100Hz 左右，占空比从 0 到 100% 渐变。这样 CPU 不用一直跑，省电又稳定。

3.5 实战：按键中断

按键中断的调试，我踩过的坑比呼吸灯多得多。核心配置就三步：

1. GPIO 配置： 上拉输入，开启外部中断
2. 中断线配置： 选择触发沿（上升沿、下降沿、双边沿）
3. 中断服务函数： 清标志位，处理逻辑

// 按键中断配置示例
void key_interrupt_init(void) {
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_SYSCFG_CLK_ENABLE();
    
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING;  // 下降沿触发
    GPIO_InitStruct.Pull = GPIO_PULLUP;           // 内部上拉
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
    
    HAL_NVIC_SetPriority(EXTI0_IRQn, 2, 0);
    HAL_NVIC_EnableIRQ(EXTI0_IRQn);
}

// 中断服务函数
void EXTI0_IRQHandler(void) {
    if(__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_0) != RESET) {
        __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_0);
        // 按键处理逻辑
        // 注意：这里要加消抖，不然一次按下触发多次
    }
}

3.6 知识体系：GPIO 调试全景图

下面这张图总结了 GPIO 调试的核心逻辑，从模式选择到中断处理，每一步都有对应的调试手段。

3.7 调试经验总结

GPIO 调试，说白了就是三板斧：

• 看电平： 万用表测静态，逻辑分析仪看动态
• 查配置： 时钟开了没？模式选对了没？上下拉配了没？
• 验逻辑： 中断触发条件对不对？消抖做了没？