4、GPIO点亮第一颗灯：GPIO初始化，高低电平控制，点亮单色LED
好，咱们正式开始动手了。
前面几章讲了原理图、讲了芯片选型，都是纸上谈兵。这一章，咱们真刀真枪干一把——让按摩仪上的第一颗LED亮起来。
你想想看，一个嵌入式系统工程师，第一次点亮LED的感觉，就跟程序员写出“Hello World”一样。我记得我当年第一次点亮LED，是在一块STM32F103的开发板上，折腾了整整一个下午，最后灯亮的那一刻，心里那个激动啊……嗯，扯远了，咱们说正事。
4.1 GPIO是什么？说白了就是芯片的“手脚”
GPIO，全称General Purpose Input Output，通用输入输出口。你可以把它理解成芯片伸出来的“手脚”。
芯片要跟外界打交道，靠的就是这些引脚。有的引脚负责接收信号（输入），有的引脚负责发送信号（输出）。而我们今天要做的，就是让某个引脚输出高电平或低电平，从而控制LED的亮灭。
核心概念：
- 输出模式：引脚输出高电平（3.3V或5V）或低电平（0V）
- 输入模式：引脚读取外部电平是高还是低
- 推挽输出：最常用的输出模式，能主动拉高或拉低电平
- 开漏输出：只能拉低，不能拉高，需要外部上拉电阻
我个人习惯，点亮LED一律用推挽输出。简单粗暴，不用想太多。
4.2 硬件连接：先看看你的LED长啥样
在写代码之前，你得先搞清楚一件事：你的LED是高电平点亮还是低电平点亮？
这取决于电路设计。一般来说有两种接法：
| 接法 | LED正极 | LED负极 | 控制逻辑 |
|---|---|---|---|
| 高电平点亮 | 接GPIO引脚 | 接GND（地） | GPIO输出高电平 → 灯亮 |
| 低电平点亮 | 接VCC（电源） | 接GPIO引脚 | GPIO输出低电平 → 灯亮 |
我在项目中遇到过好几次，新手拿到板子不看原理图，直接按“高电平点亮”的逻辑写代码，结果灯死活不亮。后来一查，发现电路是低电平点亮的……嗯，这种坑踩过一次就记住了。
避坑指南：我曾经因为没看原理图，直接按默认逻辑写代码，浪费了半小时查问题。所以，拿到板子第一件事——看原理图！看原理图！看原理图！
4.3 GPIO初始化：让引脚准备好干活
GPIO不能拿来就用。你得先告诉芯片：这个引脚我要用来干嘛。这个过程就叫初始化。
初始化一般包括这几步：
- 使能时钟：GPIO模块的时钟默认是关闭的，得先打开
- 配置模式：设置引脚为输出模式，推挽输出
- 设置速度：一般用2MHz或10MHz就够了，LED不需要高速
- 设置初始电平：先让引脚输出低电平，防止上电瞬间灯就亮了
来，看代码。这里以STM32为例，其他芯片大同小异：
// 使能GPIOB时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);
// 定义GPIO初始化结构体
GPIO_InitTypeDef GPIO_InitStructure;
// 配置PB0引脚为推挽输出
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; // 速度2MHz
// 调用初始化函数
GPIO_Init(GPIOB, &GPIO_InitStructure);
// 设置初始电平为低
GPIO_ResetBits(GPIOB, GPIO_Pin_0);你看，代码其实不长。但每一行都有它的意义。我刚开始学的时候，总觉得这些配置很烦，后来发现——初始化做不好，后面全是坑。
小技巧：我个人习惯把GPIO初始化封装成一个函数，比如LED_Init()，这样主函数里调用一下就完事，代码看起来清爽很多。
4.4 高低电平控制：让灯亮起来
初始化完了，接下来就是控制电平了。说白了就两个操作：
- 输出高电平：
GPIO_SetBits(GPIOB, GPIO_Pin_0); - 输出低电平：
GPIO_ResetBits(GPIOB, GPIO_Pin_0);
如果你的LED是高电平点亮，那调用GPIO_SetBits，灯就亮了。如果是低电平点亮，那就调用GPIO_ResetBits。
来，写个完整的点亮程序：
#include "stm32f10x.h"
void LED_Init(void)
{
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);
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_2MHz;
GPIO_Init(GPIOB, &GPIO_InitStructure);
GPIO_ResetBits(GPIOB, GPIO_Pin_0); // 初始灭灯
}
int main(void)
{
LED_Init();
// 点亮LED
GPIO_SetBits(GPIOB, GPIO_Pin_0);
while(1)
{
// 程序停在这里，灯一直亮着
}
}你看，就这么几行代码，第一颗灯就亮了。
为什么会这么简单？因为GPIO控制本身就是嵌入式开发里最基础的操作。你想想看，后面所有的复杂功能——PWM调光、呼吸灯、流水灯——都是在这个基础上叠加出来的。
4.5 验证与调试：灯不亮怎么办？
代码写完了，下载到板子上，灯没亮。怎么办？
别慌。我遇到过无数次这种情况。按这个顺序排查：
- 检查硬件连接：LED正负极有没有接反？限流电阻有没有加？
- 检查引脚编号：代码里写的引脚号跟实际电路对不对得上？
- 检查时钟使能：GPIO的时钟有没有打开？
- 检查电平逻辑：是高电平点亮还是低电平点亮？
- 用万用表量：直接量引脚电压，看是不是你预期的电平
注意：千万不要直接拿导线把GPIO引脚和VCC短接！我曾经见过有人这么干，结果芯片直接冒烟了。GPIO引脚输出电流有限，短路会烧坏引脚。
4.6 本章小结
好，咱们捋一下这章干了什么：
- 理解了GPIO是什么——芯片的“手脚”
- 搞清了LED的两种接法——高电平点亮和低电平点亮
- 学会了GPIO初始化——时钟、模式、速度、初始电平
- 掌握了高低电平控制——
SetBits和ResetBits - 写了一个完整的点亮程序
下一章，咱们要让这颗灯闪烁起来。别觉得简单，闪烁里藏着延时、循环、还有定时器的影子。嗯，到时候你就知道了。
公众号:蓝海资料掘金营，微信deep3321