第4章 STM32 GPIO详解

4. STM32 GPIO详解：GPIO模式配置、寄存器操作、HAL库与标准库对比、按键消抖实战

各位同学，欢迎来到第四章。这一章我们聊聊GPIO——单片机最基础、也最容易被忽视的外设。

我刚开始做项目时，总觉得GPIO嘛，不就是输出高电平、读取高低电平吗？有什么好学的？结果有一次，一个产品在客户现场频繁死机，排查了三天，最后发现是GPIO模式配置错了——该用开漏输出的地方用了推挽输出，导致总线冲突。嗯，从那以后，我再也不敢小看GPIO的配置了。

这一章，我会把GPIO的几种工作模式、寄存器操作、HAL库和标准库的差异，以及按键消抖这个经典实战，一次性讲透。

4.1 GPIO的八种工作模式

STM32的GPIO，说白了有八种模式。但别慌，常用的其实就四种：推挽输出、开漏输出、上拉输入、下拉输入。剩下的浮空输入、模拟输入、复用推挽、复用开漏，理解起来也不难。

我们先看最常用的两种输出模式。

4.1.1 推挽输出 vs 开漏输出

推挽输出：内部有两个MOS管，一个推电流出去（输出高电平），一个拉电流进来（输出低电平）。输出高电平时，电压就是VCC；输出低电平时，电压就是GND。驱动能力强，响应快。

开漏输出：只有拉电流的MOS管，没有推电流的。输出低电平时，直接接地；输出高电平时，引脚处于高阻态，必须外接上拉电阻才能拉到高电平。

你可能会问：那为什么还要用开漏？

我举个例子。I2C总线，多个设备挂在同一条线上。如果用推挽输出，两个设备同时输出——一个输出高，一个输出低，那就短路了。开漏输出配合上拉电阻，可以实现“线与”功能：任何一个设备拉低，总线就是低电平。这就是为什么I2C必须用开漏。

核心区别一句话总结：推挽输出能主动输出高低电平，开漏输出只能主动拉低，拉高要靠外部电阻。

4.1.2 输入模式：上拉、下拉、浮空

输入模式有三种：

浮空输入：引脚既不接上拉也不接下拉，电平完全由外部决定。如果外部悬空，电平不确定，容易受干扰。
上拉输入：内部接了一个上拉电阻到VCC。外部不接时，默认高电平。
下拉输入：内部接了一个下拉电阻到GND。外部不接时，默认低电平。

我个人习惯，按键检测用上拉输入，外部按键按下接地，松开后引脚被内部上拉拉到高电平，逻辑清晰，省一个外部电阻。

小技巧：STM32内部上拉电阻约40kΩ，下拉电阻也差不多。如果对功耗敏感，注意这个电阻会消耗微安级的电流。

4.2 寄存器操作：直接操控GPIO

虽然现在HAL库很流行，但我觉得，搞嵌入式不懂寄存器，就像开车不懂发动机——能开，但出了问题不知道怎么修。

GPIO相关的寄存器主要有这几个：

寄存器	功能	位宽
GPIOx_CRL	低8位引脚配置（Pin0~7）	32位
GPIOx_CRH	高8位引脚配置（Pin8~15）	32位
GPIOx_IDR	输入数据寄存器	32位
GPIOx_ODR	输出数据寄存器	32位
GPIOx_BSRR	位设置/清除寄存器	32位
GPIOx_BRR	位清除寄存器	32位

每个引脚需要4位配置，所以CRL和CRH各管理8个引脚。4位中，高两位是CNF（配置模式），低两位是MODE（输入/输出及速度）。

举个例子，把PA0配置为推挽输出、50MHz：

// CRL寄存器中，PA0对应bit0~bit3
// MODE = 0x3 (输出50MHz), CNF = 0x0 (推挽输出)
// 所以4位值为 0011 = 0x3
GPIOA->CRL &= ~(0xF << 0);   // 先清零
GPIOA->CRL |= (0x3 << 0);    // 设置推挽输出50MHz

// 输出高电平
GPIOA->BSRR = (1 << 0);      // 用BSRR设置，比ODR更高效

// 输出低电平
GPIOA->BRR = (1 << 0);       // 用BRR清除

注意：操作CRL/CRH时，一定要先清零再赋值。我曾经见过有人直接赋值，结果把其他引脚配置搞乱了，调试了一下午才发现。

4.3 HAL库 vs 标准库：到底用哪个？

这个问题，几乎每个初学者都会问。我直接说结论：

标准库：代码更接近寄存器，执行效率高，代码量小。适合对性能有要求、或者想深入理解硬件的场景。
HAL库：封装层次高，跨平台移植方便，有超时机制和错误处理。适合快速开发、项目周期紧的场景。

看个对比就明白了。同样是初始化PA0为推挽输出：

标准库写法：

GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);

HAL库写法：

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_0;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

你看，HAL库多了一个Pull成员，因为HAL库把上拉/下拉也统一到了初始化结构体里。标准库则是在GPIO_SetBits之前单独配置。

我个人建议：新手从HAL库入手，因为出错概率低，调试方便。等熟悉了整体流程，再回头研究标准库和寄存器，理解会更深刻。

4.4 按键消抖实战：从理论到代码

按键消抖，是每个嵌入式工程师都绕不开的实战。机械按键按下和松开时，触点会弹跳，产生多个高低电平变化，持续约5~20ms。如果不消抖，一次按下可能被误判成多次。

消抖方法有两种：硬件消抖（RC滤波、施密特触发器）和软件消抖。这里我们重点讲软件消抖。

4.4.1 延时消抖法

最直接的方法：检测到按键按下，延时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);          // 延时20ms消抖
        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;
}

这个方法简单，但有个问题：HAL_Delay(20)会阻塞CPU。如果系统里还有别的任务，这20ms就浪费了。

4.4.2 状态机消抖法（推荐）

我在项目中更常用状态机消抖。不阻塞，效率高，适合RTOS或者前后台系统。

typedef enum
{
    KEY_STATE_IDLE,     // 空闲状态
    KEY_STATE_DEBOUNCE, // 消抖状态
    KEY_STATE_PRESSED   // 确认按下
} KeyState_t;

KeyState_t keyState = KEY_STATE_IDLE;
uint32_t lastTick = 0;

void Key_Task(void)
{
    uint8_t keyLevel = HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN);
    
    switch(keyState)
    {
        case KEY_STATE_IDLE:
            if(keyLevel == GPIO_PIN_RESET)  // 检测到按下
            {
                keyState = KEY_STATE_DEBOUNCE;
                lastTick = HAL_GetTick();   // 记录当前时间
            }
            break;
            
        case KEY_STATE_DEBOUNCE:
            if(HAL_GetTick() - lastTick >= 20)  // 20ms到了
            {
                if(keyLevel == GPIO_PIN_RESET)  // 再次确认按下
                {
                    keyState = KEY_STATE_PRESSED;
                    // 在这里执行按键处理函数
                    Key_Process();
                }
                else
                {
                    keyState = KEY_STATE_IDLE;  // 是抖动，回到空闲
                }
            }
            break;
            
        case KEY_STATE_PRESSED:
            if(keyLevel == GPIO_PIN_SET)    // 检测到松开
            {
                keyState = KEY_STATE_IDLE;
            }
            break;
    }
}

这个状态机，说白了就是：检测到按下→等待20ms→再次确认→执行动作→等待松开→回到空闲。整个过程不阻塞，每次调用只执行一小步。

经验之谈：状态机消抖的延时值，我一般取20ms。但不同按键的弹跳时间不一样，便宜的按键可能更长。建议用示波器看一下实际波形，再调整延时值。我曾经在一个项目中，因为按键批次换了，弹跳时间从10ms变成了30ms，导致按键偶尔失灵，排查了好久才发现是延时不够。

4.5 本章小结

这一章我们讲了：

GPIO的八种模式，重点掌握推挽、开漏、上拉、下拉
寄存器操作，尤其是CRL/CRH和BSRR/BRR的用法
HAL库和标准库的对比，根据场景选择
按键消抖的两种实战方法，推荐状态机方式

下一章，我们会进入定时器的世界。定时器是STM32的灵魂，PWM、输入捕获、编码器接口……每一个都是实战利器。我们下章见。

📚 课程目录

4. STM32 GPIO详解：GPIO模式配置、寄存器操作、HAL库与标准库对比、按键消抖实战

4.1 GPIO的八种工作模式

4.1.1 推挽输出 vs 开漏输出

4.1.2 输入模式：上拉、下拉、浮空

4.2 寄存器操作：直接操控GPIO

4.3 HAL库 vs 标准库：到底用哪个？

4.4 按键消抖实战：从理论到代码

4.4.1 延时消抖法

4.4.2 状态机消抖法（推荐）

4.5 本章小结