第4章 GPIO编程

第4章：GPIO编程：GPIO模式配置、点亮LED、按键输入检测

各位同学，欢迎来到第四节课。今天咱们聊点能看得见摸得着的东西——GPIO。

说实话，我当年刚入行时，觉得GPIO不就是个高低电平嘛，有啥好学的？直到我在一个心电监护项目里，因为GPIO配置不当，导致按键误触发，半夜三点被叫起来改代码……嗯，从那以后，我再也不敢小看这几个引脚了。

4.1 GPIO是什么？说白了就是芯片的“手脚”

GPIO，全称General-Purpose Input/Output，通用输入输出口。你可以把它想象成芯片伸出来的“手指头”——既能往外推东西（输出），也能感知外面的触碰（输入）。

每个GPIO引脚，内部其实是一堆晶体管和寄存器在干活。你写代码配置寄存器，本质上就是在告诉这些晶体管：“嘿，你现在要当输出，还是当输入？”

我个人习惯把GPIO的工作模式分成三大类：

输出模式：芯片主动拉高或拉低引脚电平，驱动LED、蜂鸣器这类外设
输入模式：芯片读取引脚上的电平，判断按键是否按下、传感器是否触发
复用功能模式：引脚交给内部外设（如UART、I2C）去控制，GPIO模块靠边站

你想想看，一个引脚能当普通IO用，也能当串口用，还能当PWM输出——这就是现代MCU的灵活之处。但灵活也意味着容易出错，我见过不少新手把复用功能的引脚当普通IO用，结果通信死活不通。

4.2 GPIO模式配置：别小看这几行代码

配置GPIO，说白了就是写寄存器。不同MCU的寄存器名字不一样，但套路大同小异。以最常用的STM32为例，配置一个GPIO通常需要三步：

开启时钟：GPIO模块默认是关着的，你得先给它供电
配置模式：设置输入/输出、推挽/开漏、上拉/下拉
设置速度：输出模式下，告诉引脚你跑多快

这里我特别想强调一点——时钟使能。我曾经有个学生，折腾了一下午LED就是不亮，最后发现是忘了开GPIO的时钟。你想想看，模块都没通电，你写再多寄存器也没用啊。

核心要点：GPIO配置的本质就是“开时钟→写模式寄存器→写数据寄存器”。无论你用HAL库还是直接操作寄存器，底层逻辑都一样。

下面给个直接操作寄存器的例子，这样你能看到底层到底发生了什么：

// 以STM32F103为例，配置PA5为推挽输出
RCC->APB2ENR |= (1 << 2);      // 开启GPIOA时钟
GPIOA->CRL &= ~(0xF << 20);    // 先清空配置位
GPIOA->CRL |= (0x2 << 20);     // 设置为推挽输出，2MHz速度
GPIOA->ODR |= (1 << 5);        // PA5输出高电平

你看，就这么几行。但如果你用HAL库，代码会更“友好”一些：

GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();           // 开时钟
GPIO_InitStruct.Pin = GPIO_PIN_5;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;  // 推挽输出
GPIO_InitStruct.Pull = GPIO_NOPULL;     // 不上拉不下拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);  // 输出高

我的小建议：初学阶段，我建议你两种方式都试试。先用手册查寄存器，再用HAL库验证。这样你既知道底层怎么干活，又能享受库函数带来的便利。

4.3 点亮LED：嵌入式世界的“Hello World”

点亮LED，就像学编程时写“Hello World”一样，是每个嵌入式工程师的必修课。但你别小看它——这里面藏着GPIO输出的全部精髓。

LED的接法通常有两种：

高电平点亮：LED正极接GPIO，负极通过电阻接地。GPIO输出高电平时LED亮。
低电平点亮：LED正极接VCC，负极通过电阻接GPIO。GPIO输出低电平时LED亮。

我个人更常用高电平点亮的方式，因为逻辑上更直观——写1就是亮，写0就是灭。但有些开发板为了省电，会采用低电平点亮，你得看原理图确认。

这里有个坑，我当年踩过——限流电阻。LED不能直接接在GPIO上，否则电流过大，轻则烧LED，重则烧GPIO。一般3.3V系统用330Ω到1kΩ的电阻就行。

来个完整的闪烁程序：

// LED闪烁，PA5接LED正极，负极经电阻接地
while(1) {
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);   // 亮
    HAL_Delay(500);                                        // 等500ms
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET); // 灭
    HAL_Delay(500);                                        // 等500ms
}

你看，就这么简单。但如果你发现LED不亮，别急着怀疑硬件，先检查三件事：

时钟开了吗？
模式配成输出了吗？
引脚号对不对？

这三步走完，90%的问题都能解决。

4.4 按键输入检测：从“按下去”到“读出来”

按键检测，说白了就是读GPIO的电平。但这里有个大坑——机械抖动。

你想想看，按键是个机械结构，按下和松开时，触点会弹跳几次，产生一连串的脉冲。如果你直接读电平，一次按键可能会被误判成十几次。

我曾经在一个输液泵项目里，因为没做消抖处理，导致按键按一次，屏幕跳三下。护士长差点没把我吃了……

消抖的方法有两种：

方法	原理	适用场景
硬件消抖	在按键两端并联电容（通常0.1μF）	对成本不敏感、要求高可靠性的场合
软件消抖	检测到电平变化后，延时10-20ms再读一次	大多数嵌入式项目，成本低、灵活

我个人更推荐软件消抖，因为不增加硬件成本，而且调整延时很方便。下面给个标准的按键检测代码：

// 按键检测，PA0接按键，外部上拉（按键按下为低电平）
#define KEY_PIN     GPIO_PIN_0
#define KEY_PORT    GPIOA

uint8_t Key_Scan(void) {
    if(HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET) {
        HAL_Delay(20);  // 消抖延时
        if(HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET) {
            // 等待按键松开
            while(HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == GPIO_PIN_RESET);
            return 1;   // 检测到一次有效按键
        }
    }
    return 0;
}

注意：上面的代码用了while等待按键松开，这在简单任务里没问题。但如果你的系统有多个任务，这种阻塞式等待会卡死整个系统。这时候就该用状态机或者定时器中断来做非阻塞检测了——这个我们后面章节会讲。

4.5 实战：用按键控制LED

把前面两个知识点串起来，做个按键控制LED的小实验：按一下亮，再按一下灭。

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();  // 初始化GPIO，配置PA5为输出，PA0为输入

    uint8_t led_state = 0;

    while(1) {
        if(Key_Scan()) {          // 检测到按键按下
            led_state = !led_state;  // 翻转状态
            HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, 
                led_state ? GPIO_PIN_SET : GPIO_PIN_RESET);
        }
    }
}

这个例子虽然简单，但它包含了嵌入式开发的三个核心要素：输入检测、逻辑处理、输出控制。你想想看，所有复杂的嵌入式系统，归根结底不都是在做这三件事吗？

4.6 避坑指南：我踩过的那些GPIO的坑

最后，分享几个我实际项目中遇到的GPIO问题，希望能帮你少走弯路：

浮空输入导致功耗异常：我曾经有个手持设备，待机电流偏大。查了半天，发现有个GPIO配成了浮空输入，引脚悬空导致电平不确定，内部电路一直在切换状态。解决办法是加上拉或下拉电阻。
输出速度配太快：有次驱动一个慢速光耦，我把GPIO速度配成了50MHz，结果信号过冲严重，光耦反而误动作。后来改成2MHz就稳了。
开漏输出忘加上拉：开漏输出本身只能拉低，不能拉高。如果你忘了外部上拉电阻，引脚永远读不到高电平。这个坑我见过不下五次。

嗯，今天就到这儿。下一章我们会聊定时器，那玩意儿比GPIO有意思多了——能计时、能产生PWM、还能捕获输入信号。到时候见。

📚 课程目录