4、GPIO编程实战：GPIO模式配置、输入输出控制、内部上拉/下拉电阻、基于STM32的按键读取

好，咱们今天来点真家伙。

前面几章讲了PDA的交互逻辑、按键的电气特性，但说到底，你得让芯片真正动起来。GPIO（通用输入输出口）是嵌入式世界里最基础、也最容易被忽视的模块。我见过不少新手，上来就写HAL_GPIO_WritePin，结果灯不亮、按键没反应，查了半天发现是模式配错了。

嗯，咱们今天就把它彻底讲透。

4.1 GPIO模式配置：别小看这步

STM32的GPIO模式，说白了就是告诉芯片：这个引脚是往外送信号，还是往里收信号？要不要加个电阻？速度跑多快？

我个人习惯，在写任何外设驱动之前，先把GPIO的初始化结构体填好。你想想看，如果模式配错了，后面写再多代码也是白搭。

我在项目中遇到过一件事：有个同事用开漏输出驱动LED，结果灯死活不亮。为什么？因为开漏输出只能拉低，LED正极接VCC，负极接引脚，引脚拉低时灯亮——但开漏模式下，引脚拉高是靠外部上拉电阻的，而他的电路板上根本没接上拉电阻。说白了，模式选错了，硬件设计也得跟着改。

4.2 输入输出控制：让引脚听话

配置好模式之后，控制就简单了。输出用HAL_GPIO_WritePin，输入用HAL_GPIO_ReadPin。但这里有个细节：输出时，别忘了设置速度。

// 输出控制示例：点亮LED
HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);   // 高电平
HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); // 低电平

// 或者用Toggle翻转
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);

输入呢？更简单：

// 读取按键状态
GPIO_PinState keyState = HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin);
if(keyState == GPIO_PIN_RESET) {
    // 按键按下（假设上拉输入，按下为低）
}

嗯，这里要注意：读取输入时，别在主循环里一直读，否则CPU全耗在这上面了。我建议用定时器中断或者外部中断来触发读取，后面会讲。

4.3 内部上拉/下拉电阻：省掉外部元件的秘诀

很多初学者会问：为什么按键电路里要加个电阻？其实就是为了防止引脚悬空。悬空状态下，引脚电平不确定，稍微有点电磁干扰就会误触发。

STM32内部集成了上拉和下拉电阻，阻值大约在40kΩ左右。你想想看，如果外部电路已经接了10kΩ的上拉，内部再开一个40kΩ的上拉，两者并联后等效电阻变小，但逻辑上还是高电平——不过功耗会稍微大一点。

配置内部上拉/下拉，就在GPIO初始化结构体里：

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = KEY_Pin;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_PULLUP;   // 内部上拉
// GPIO_InitStruct.Pull = GPIO_PULLDOWN; // 内部下拉
// GPIO_InitStruct.Pull = GPIO_NOPULL;   // 浮空
HAL_GPIO_Init(KEY_GPIO_Port, &GPIO_InitStruct);

我曾经犯过一个错：按键一端接地，另一端接引脚，我配置了内部下拉。结果按下时引脚被拉低，但松开后内部下拉又把引脚拉低——按键永远显示按下状态。后来才意识到，按键接地时应该用上拉输入，按下为低，松开为高。

4.4 基于STM32的按键读取：从理论到实战

好了，前面都是铺垫，现在咱们写一个完整的按键读取程序。这个程序会读取一个按键，按下时点亮LED，松开时熄灭。

#include "main.h"

// 假设按键在PA0，LED在PC13
#define KEY_Pin       GPIO_PIN_0
#define KEY_GPIO_Port GPIOA
#define LED_Pin       GPIO_PIN_13
#define LED_GPIO_Port GPIOC

void GPIO_Init(void) {
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_GPIOC_CLK_ENABLE();

    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 配置按键：上拉输入
    GPIO_InitStruct.Pin = KEY_Pin;
    GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(KEY_GPIO_Port, &GPIO_InitStruct);

    // 配置LED：推挽输出
    GPIO_InitStruct.Pin = LED_Pin;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(LED_GPIO_Port, &GPIO_InitStruct);
}

int main(void) {
    HAL_Init();
    GPIO_Init();

    while (1) {
        // 读取按键状态
        if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) == GPIO_PIN_RESET) {
            // 按键按下（上拉输入，按下为低）
            HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);  // 点亮LED
        } else {
            HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); // 熄灭LED
        }
    }
}

这个程序能跑，但有个问题：没有消抖。机械按键在按下和松开的瞬间，会产生多次抖动，导致LED闪烁。我建议加一个简单的软件消抖：

// 简单消抖：延时10ms后再次读取
if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) == GPIO_PIN_RESET) {
    HAL_Delay(10);  // 等待抖动过去
    if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) == GPIO_PIN_RESET) {
        // 确认按键按下
        HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
        // 等待按键松开，防止一次按下触发多次
        while (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin) == GPIO_PIN_RESET);
    }
}

嗯，这里要注意：HAL_Delay会阻塞CPU，不适合在实时性要求高的场合。更好的做法是用定时器或者状态机来做消抖，咱们后面章节会专门讲。

4.5 实战中的几个坑

• 引脚复用冲突：STM32很多引脚有多个功能。比如PA9和PA10默认是USART1的TX/RX，如果你把它们当GPIO用，记得在初始化前关闭复用功能。我遇到过调试串口和按键共用引脚的情况，折腾了半天才发现是功能冲突。
• 时钟没使能：配置GPIO之前，一定要先使能对应GPIO组的时钟。忘了这一步，写寄存器是没反应的。我刚开始学的时候，经常忘了加__HAL_RCC_GPIOx_CLK_ENABLE()，然后对着数据手册查半天。
• 电平匹配：如果按键接的是3.3V的MCU，但外部信号是5V，记得加电平转换或者用开漏输出加外部上拉。直接硬接可能会烧坏引脚。

好了，这一章的内容就到这里。GPIO看似简单，但它是所有外设交互的基础。你想想看，如果连引脚的电平都控制不好，后面的I2C、SPI、UART就更别谈了。下一章咱们会讲外部中断，让按键读取不再占用CPU轮询——那才是真正的触发式交互。