📚 课程目录第2章 GPIO输出控制

GPIO输出控制：从理论到流水灯实战

各位同学，大家好。今天咱们来聊聊GPIO输出控制。这是嵌入式开发里最基础、也是最常用的功能。说白了，就是让单片机的一个引脚输出高电平或低电平，去控制LED灯、继电器、蜂鸣器这些东西。

我刚开始学单片机时，觉得GPIO不就是点个灯嘛，有啥难的？后来做项目才发现，这里面的门道还真不少。比如驱动能力够不够、电平匹配对不对、初始化顺序有没有问题……踩过的坑多了，自然就明白了。

GPIO基础知识

GPIO的全称是General Purpose Input Output，通用输入输出口。每个GPIO引脚都可以独立配置为输入或输出模式。

在STM32中，GPIO有几个关键特性你需要记住：

特性	说明
输出模式	推挽输出、开漏输出
输出速度	低速(2MHz)、中速(10MHz)、高速(50MHz)
上下拉	上拉、下拉、浮空
电平范围	0V(低电平) 和 3.3V(高电平)

小提示：推挽输出是最常用的模式。它能主动输出高电平和低电平，驱动能力也强。开漏输出需要外部上拉电阻，一般用在I2C总线这类需要“线与”功能的场合。

嗯，这里要注意一点：STM32的GPIO输出电流有限。单个引脚最大能提供20mA左右，但整个芯片的总电流有限制。我有个朋友曾经想用GPIO直接驱动一个5V的继电器，结果引脚烧了……所以驱动大负载时，一定要加三极管或MOS管做驱动。

CubeMX配置GPIO输出

用CubeMX配置GPIO输出，其实就几步。我习惯先打开CubeMX，选好芯片型号，然后在Pinout视图里找到要用的引脚。

在Pinout视图中，左键点击目标引脚
选择GPIO_Output模式
在Configuration面板中设置参数

配置参数时，有几个选项需要你留意：

GPIO output level：初始输出电平。我一般选Low，避免上电瞬间LED误亮
GPIO mode：推挽还是开漏？LED控制选推挽
GPIO Pull-up/Pull-down：输出模式下通常选No pull
Maximum output speed：控制LED用Low就够了，高速模式反而会增加功耗和噪声

避坑指南：我曾经在配置GPIO时，把输出速度设成了Very High，结果LED没亮，倒是把示波器上的信号搞得一团糟。高频信号在长导线上会产生反射，控制LED这种低频设备，用Low或Medium就足够了。

配置完成后，点击Generate Code，CubeMX就会自动生成初始化代码。你会在main.c里看到类似这样的内容：

/* GPIO Ports Clock Enable */
__HAL_RCC_GPIOA_CLK_ENABLE();

/*Configure GPIO pin : PA5 */
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);

这段代码做了两件事：开启GPIOA的时钟，然后初始化PA5为推挽输出模式。记住，STM32的GPIO是挂载在APB总线上的，使用前必须先开启时钟。这是新手最容易忘的一步。

HAL_GPIO_WritePin与HAL_GPIO_TogglePin函数详解

初始化完成后，控制GPIO输出就靠这两个函数了。

HAL_GPIO_WritePin

这个函数用来设置引脚为高电平或低电平。原型如下：

void HAL_GPIO_WritePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState);

参数说明：

GPIOx：端口基地址，比如GPIOA、GPIOB
GPIO_Pin：引脚编号，比如GPIO_PIN_5
PinState：电平状态，GPIO_PIN_SET(高电平) 或 GPIO_PIN_RESET(低电平)

用法示例：

// 点亮LED（假设低电平点亮）
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_RESET);

// 熄灭LED
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);

HAL_GPIO_TogglePin

这个函数更简单，每次调用都会翻转引脚的电平。原型：

void HAL_GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);

用法示例：

// 翻转LED状态
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);

    核心区别：WritePin可以精确控制输出电平，适合需要保持特定状态的场景。TogglePin适合做闪烁效果，代码更简洁。我个人在流水灯项目中更喜欢用WritePin，因为控制逻辑更清晰。

LED流水灯实战

好了，理论知识讲完了，咱们来做个流水灯。这个项目虽然简单，但能帮你把GPIO控制、延时、循环这些基础操作串起来。

硬件连接：

PA0 → LED1 (串联220Ω电阻到GND)
PA1 → LED2
PA2 → LED3
PA3 → LED4

CubeMX配置：

将PA0-PA3设置为GPIO_Output
初始电平设为High（LED熄灭）
模式选推挽输出，速度Low

生成代码后，在main.c的while循环里添加：

while (1)
{
    // LED1亮，其他灭
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3, GPIO_PIN_SET);
    HAL_Delay(200);

    // LED2亮，其他灭
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_2 | GPIO_PIN_3, GPIO_PIN_SET);
    HAL_Delay(200);

    // LED3亮，其他灭
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_3, GPIO_PIN_SET);
    HAL_Delay(200);

    // LED4亮，其他灭
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_3, GPIO_PIN_RESET);
    HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2, GPIO_PIN_SET);
    HAL_Delay(200);
}

这段代码的逻辑很简单：依次点亮每个LED，每次只亮一个，延时200ms后切换到下一个。你想想看，如果我想让流水灯来回跑，是不是只要把顺序反过来就行？

优化建议：上面的代码虽然直观，但重复代码太多。实际项目中，我一般会用数组和循环来写，这样扩展性更好。比如要改成8个LED，只需要改数组长度，不用复制粘贴代码。

下面我用一张图来总结本章的知识体系：

这张图把本章的知识点串起来了。从顶层的GPIO输出控制，到三个分支：基础知识、CubeMX配置、HAL库函数，最后汇聚到流水灯实战。你照着这个思路去学，就不会觉得乱了。

最后说一句，流水灯虽然简单，但它是你掌握GPIO输出的第一步。后面我们会用GPIO控制更多外设，比如数码管、LCD屏幕、步进电机。基础打牢了，后面才能走得稳。