2. GPIO基础与LED控制：数字输出原理、GPIO库函数、LED闪烁实验、PWM调光

好，咱们正式开始动手了。这一章是嵌入式开发的"Hello World"——控制LED。别小看它，GPIO是芯片和外界打交道的"手脚"，搞懂了它，后面接传感器、驱动电机都是换汤不换药。

2.1 数字输出：芯片怎么"说话"？

GPIO的全称是General Purpose Input/Output，通用输入输出口。说白了，它就是一个可以编程控制的引脚。你可以让它输出高电平（3.3V）或低电平（0V），也可以读取外部信号是高还是低。

数字输出，就是芯片通过引脚对外输出一个确定的电平。ESP32的工作电压是3.3V，所以高电平就是3.3V，低电平就是0V。你想想看，LED灯的正极接3.3V，负极通过一个电阻接地，灯就亮了。反过来，正极接地，负极接3.3V，灯就灭了——这就是最基本的控制逻辑。

我在项目中遇到过一个问题：有个同事把LED直接接在GPIO和GND之间，没加限流电阻。结果一上电，LED瞬间烧了，GPIO引脚也挂了。嗯，这里要注意：GPIO引脚能提供的电流有限（ESP32约40mA），LED需要串联一个220Ω~1kΩ的电阻来限流。

2.2 ESP32的GPIO库函数

ESP32的官方开发框架是ESP-IDF，但咱们课程用的是Arduino框架——更简单，上手快。Arduino框架把底层寄存器操作封装成了几个简单的函数，咱们直接调用就行。

常用的GPIO控制函数就这几个：

函数	功能	参数说明
pinMode(pin, mode)	设置引脚模式	pin：引脚号；mode：OUTPUT、INPUT、INPUT_PULLUP等
digitalWrite(pin, value)	输出数字电平	pin：引脚号；value：HIGH或LOW
digitalRead(pin)	读取数字电平	返回HIGH或LOW
analogWrite(pin, value)	输出PWM模拟信号	pin：支持PWM的引脚；value：0~255

我个人习惯，在写代码前先画个引脚分配表。ESP32的引脚编号和功能不是完全随意的，有些引脚有特殊功能（比如ADC、DAC、触摸），有些引脚在启动时有特殊用途（比如GPIO0、GPIO2）。

2.3 LED闪烁实验：第一个硬件程序

好了，理论说完了，咱们直接上手。这个实验的目标：让LED以1秒为周期闪烁。

硬件连接：

• LED正极（长脚） → 220Ω电阻 → GPIO2
• LED负极（短脚） → GND

代码实现：

// LED闪烁实验 - 第2章
// 连接：LED正极→220Ω→GPIO2，LED负极→GND

const int ledPin = 2;  // 定义LED引脚

void setup() {
  pinMode(ledPin, OUTPUT);  // 设置引脚为输出模式
  Serial.begin(115200);     // 初始化串口，方便调试
  Serial.println("LED闪烁实验开始！");
}

void loop() {
  digitalWrite(ledPin, HIGH);  // 点亮LED
  Serial.println("LED ON");
  delay(1000);                 // 延时1000ms

  digitalWrite(ledPin, LOW);   // 熄灭LED
  Serial.println("LED OFF");
  delay(1000);                 // 延时1000ms
}

代码逻辑很简单：setup()里配置引脚模式，loop()里循环点亮→延时→熄灭→延时。你上传代码后，应该能看到LED以1秒间隔闪烁。

2.4 PWM调光：让LED呼吸起来

数字输出只能控制亮灭，那怎么实现"半亮"或"渐亮渐灭"呢？答案是PWM——脉冲宽度调制。

PWM的原理很简单：在一个周期内，高电平的时间占比（占空比）决定了等效电压。占空比50%，等效电压就是1.65V，LED就是半亮。占空比0%，全灭；占空比100%，全亮。

ESP32的PWM频率可调，默认是1000Hz（1ms一个周期）。Arduino的analogWrite()函数把占空比映射到0~255，0对应0%，255对应100%。

呼吸灯代码：

// PWM呼吸灯实验 - 第2章
// 连接：LED正极→220Ω→GPIO2，LED负极→GND

const int ledPin = 2;
int brightness = 0;    // 当前亮度值 0~255
int fadeAmount = 5;    // 每次变化的步长

void setup() {
  pinMode(ledPin, OUTPUT);
  Serial.begin(115200);
}

void loop() {
  analogWrite(ledPin, brightness);  // 输出PWM

  brightness = brightness + fadeAmount;  // 改变亮度

  // 到达边界时反转方向
  if (brightness <= 0 || brightness >= 255) {
    fadeAmount = -fadeAmount;
  }

  delay(30);  // 控制变化速度
}

这段代码让LED从暗到亮、再从亮到暗循环，看起来就像在"呼吸"。你调整delay()的值可以改变呼吸速度，调整fadeAmount可以改变变化的平滑度。

2.5 本章知识体系

下面这张图把本章的核心逻辑串起来了：

这张图把本章内容分成了三条线：数字输出→LED闪烁、PWM调光→呼吸灯、GPIO库函数→三个核心函数。你顺着这条线走，就能把GPIO控制吃透。

2.6 常见问题与避坑

最后，我把自己踩过的坑和学员常问的问题整理一下：

问题	原因	解决方案
LED不亮	接线错误、引脚未配置、LED损坏	检查正负极、确认pinMode、用万用表测引脚电压
LED亮度异常	电阻值不对、PWM频率不合适	使用220Ω~1kΩ电阻，PWM频率保持1000Hz
程序上传后无反应	引脚被占用、串口监视器未打开	换用安全引脚（GPIO2/4/5），打开串口看输出
PWM调光不平滑	步长太大或延时太短	减小fadeAmount（如2或3），适当增加delay