📚 课程目录第2章 GPIO驱动开发

第2章 GPIO驱动开发：从原理到实战

GPIO，说白了就是单片机最基础的输入输出接口。你让它高它就高，让它低它就低，读它就知道外部电平。但就是这么简单的功能，我在项目里见过太多翻车案例——LED不亮、按键误触发、甚至烧引脚。这一章，咱们把GPIO吃透。

2.1 GPIO工作原理

STM32的GPIO内部结构比你想的复杂。每个引脚背后都有一堆寄存器、上下拉电阻、施密特触发器和输出驱动器。我画了张图帮你理清脉络。

这张图里有两个关键路径：

输入路径：外部信号经过施密特触发器整形，消除毛刺，然后存入输入数据寄存器。你读引脚时读的就是这个寄存器。
输出路径：你往输出数据寄存器写值，经过输出驱动器（推挽或开漏）驱动外部引脚。

核心要点：GPIO的8种工作模式本质是配置内部这些模块的连接方式。比如推挽输出就是让输出驱动器同时具备拉电流和灌电流能力；开漏输出只保留下拉管，高阻态靠外部上拉。

2.2 HAL库GPIO函数详解

HAL库把寄存器操作封装成了几个核心函数。我用过这么多MCU的库，ST的HAL算是比较清晰的。下面这张表帮你快速定位。

函数名	功能	典型场景
`HAL_GPIO_Init`	初始化引脚模式、速度、上下拉	配置LED、按键引脚
`HAL_GPIO_DeInit`	恢复引脚为默认复位状态	释放引脚资源
`HAL_GPIO_WritePin`	设置引脚输出电平	点亮/熄灭LED
`HAL_GPIO_TogglePin`	翻转引脚输出电平	LED闪烁
`HAL_GPIO_ReadPin`	读取引脚输入电平	检测按键状态
`HAL_GPIO_EXTI_Callback`	外部中断回调函数	按键中断处理

我个人习惯把HAL_GPIO_Init的参数封装成结构体，这样可读性更好。你看这个例子：

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

我的习惯：初始化前先调用__HAL_RCC_GPIOA_CLK_ENABLE()使能时钟。我见过新手调了半天GPIO不工作，最后发现是时钟没开——这种坑踩一次就够了。

2.3 LED灯驱动实战

LED驱动是GPIO输出的经典案例。咱们用PA0接一个LED，阳极通过220Ω电阻连到PA0，阴极接地。这样写1点亮，写0熄灭。

代码其实就三步：

使能GPIO时钟
配置引脚为推挽输出
写电平控制LED

// led.h
#ifndef __LED_H
#define __LED_H
#include "stm32f1xx_hal.h"

#define LED_PIN     GPIO_PIN_0
#define LED_PORT    GPIOA
#define LED_ON()    HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_SET)
#define LED_OFF()   HAL_GPIO_WritePin(LED_PORT, LED_PIN, GPIO_PIN_RESET)
#define LED_TOGGLE() HAL_GPIO_TogglePin(LED_PORT, LED_PIN)

void LED_Init(void);
#endif

// led.c
#include "led.h"

void LED_Init(void)
{
    __HAL_RCC_GPIOA_CLK_ENABLE();
    GPIO_InitTypeDef gpio_config = {0};
    gpio_config.Pin = LED_PIN;
    gpio_config.Mode = GPIO_MODE_OUTPUT_PP;
    gpio_config.Pull = GPIO_NOPULL;
    gpio_config.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(LED_PORT, &gpio_config);
    LED_OFF();  // 初始状态熄灭
}

主函数里调用就很简单了：

int main(void)
{
    HAL_Init();
    LED_Init();
    while (1)
    {
        LED_ON();
        HAL_Delay(500);
        LED_OFF();
        HAL_Delay(500);
    }
}

避坑指南：我曾经在量产时发现一批板子LED亮度不一致。查了半天，原来是限流电阻阻值偏差太大。LED电流建议控制在5~15mA，电阻用1%精度的。另外，别把LED直接连到3.3V——不加限流电阻，烧引脚是分分钟的事。

2.4 按键输入检测实战

按键检测比LED麻烦一点。硬件上，按键一端接GND，另一端接PA1，内部上拉。没按下时读1，按下时读0。

但有个问题——机械按键有抖动。按下和释放的瞬间，电平会跳变几次。如果不做处理，一次按下可能被识别成多次。我常用的消抖方法有两种：

方法	原理	适用场景
硬件消抖	RC低通滤波 + 施密特触发器	对成本不敏感、要求高可靠性
软件消抖	延时10~20ms后再次读取	大多数嵌入式项目

我个人偏爱软件消抖，因为省成本、改起来方便。看代码：

// key.h
#ifndef __KEY_H
#define __KEY_H
#include "stm32f1xx_hal.h"

#define KEY_PIN     GPIO_PIN_1
#define KEY_PORT    GPIOA
#define KEY_PRESS   0  // 按下为低电平

uint8_t Key_Scan(void);
void Key_Init(void);
#endif

// key.c
#include "key.h"

void Key_Init(void)
{
    __HAL_RCC_GPIOA_CLK_ENABLE();
    GPIO_InitTypeDef gpio_config = {0};
    gpio_config.Pin = KEY_PIN;
    gpio_config.Mode = GPIO_MODE_INPUT;
    gpio_config.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(KEY_PORT, &gpio_config);
}

uint8_t Key_Scan(void)
{
    if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == KEY_PRESS)
    {
        HAL_Delay(10);  // 消抖延时
        if (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == KEY_PRESS)
        {
            while (HAL_GPIO_ReadPin(KEY_PORT, KEY_PIN) == KEY_PRESS);  // 等待释放
            return 1;  // 有效按键
        }
    }
    return 0;
}

关键点：Key_Scan函数里用了两次读取+延时。第一次检测到按下，延时10ms再读一次。如果还是按下状态，才认为是有效按键。最后等待释放，防止一次按下触发多次。

主函数里这样用：

int main(void)
{
    HAL_Init();
    LED_Init();
    Key_Init();
    while (1)
    {
        if (Key_Scan())
        {
            LED_TOGGLE();  // 按一次，LED翻转一次
        }
    }
}

进阶建议：如果项目里按键比较多，别用HAL_Delay做消抖——它会阻塞整个系统。我一般在RTOS里用信号量，或者用定时器轮询+状态机。不过对于入门阶段，延时消抖完全够用。

嗯，GPIO这块就这些。从原理到函数，再到LED和按键的实战，你跟着敲一遍应该就能上手。记住：初始化先开时钟，输出注意电流，输入记得消抖。这三条记住了，GPIO基本不会出大问题。