📚 课程目录第2章 GPIO基础与LED控制

GPIO基础与LED控制：数字输出、GPIO模式设置、LED闪烁实验、PWM调光原理

好，咱们开始第二章。上一章我们把ESP32的开发环境搭好了，也跑了第一个Hello World。这一章要动真格的了——控制GPIO，让LED亮起来、灭下去，再玩点高级的调光。

GPIO这东西，说白了就是芯片伸出来的“手脚”。你让它输出高电平，它就输出3.3V；你让它输出低电平，它就拉到GND。就这么简单。但实际项目里，坑往往就藏在“简单”里。

本章核心知识点一览

数字输出：GPIO高低电平控制
GPIO模式设置：推挽、开漏、上拉、下拉
LED闪烁实验：延时与循环
PWM调光原理：占空比与频率

2.1 数字输出——让LED亮起来

先看最基础的操作。让ESP32的一个引脚输出高电平，点亮LED。

硬件连接很简单：LED正极接GPIO2，负极串一个220Ω电阻到GND。为什么串电阻？不串的话，LED相当于直接把3.3V短路到地，电流能到几十毫安，LED会烧，GPIO口也可能挂掉。我刚开始学的时候偷懒没加电阻，结果LED冒烟了……嗯，从那以后我再也不敢省这个电阻了。

// 最简单的LED点亮程序
void setup() {
  pinMode(2, OUTPUT);      // 设置GPIO2为输出模式
  digitalWrite(2, HIGH);   // 输出高电平，LED亮
}

void loop() {
  // 啥也不干，就一直亮着
}

这里有个细节：pinMode() 设置模式，digitalWrite() 写电平。这两个函数是ESP32 Arduino框架的基础，底层其实调用了ESP-IDF的GPIO驱动。你想想看，如果不用Arduino框架，直接操作寄存器，代码会长很多。

2.2 GPIO模式设置——不只是输入输出

很多人以为GPIO只有输入和输出两种模式。其实ESP32的GPIO模式比你想的复杂。我列个表，你一看就明白。

模式	说明	典型应用
OUTPUT	推挽输出，能输出高和低	LED、继电器、蜂鸣器
OUTPUT_OPEN_DRAIN	开漏输出，只能拉低，高阻靠上拉	I2C总线、多设备共享线
INPUT	高阻输入，电平由外部决定	按键、传感器信号
INPUT_PULLUP	内部上拉输入，默认高电平	按键（按下拉低）
INPUT_PULLDOWN	内部下拉输入，默认低电平	按键（按下拉高）

我个人习惯，按键输入一定用 INPUT_PULLUP。为什么？因为ESP32内部有上拉电阻，省一个外部电阻，而且上拉输入抗干扰能力比下拉好。我在一个工业项目里用过下拉输入，结果现场干扰严重，按键动不动误触发。换成上拉之后，问题就解决了。

避坑指南

我曾经在量产项目里犯过一个低级错误：GPIO没有设置模式就直接digitalWrite。结果有的板子能亮，有的不亮。后来查手册才发现，ESP32上电后GPIO默认是输入模式，输出电平是不确定的。所以记住：先pinMode，再digitalWrite，顺序不能乱。

2.3 LED闪烁实验——延时与循环

闪烁实验是嵌入式开发的“Hello World”。逻辑很简单：亮→等一会儿→灭→等一会儿→循环。

void setup() {
  pinMode(2, OUTPUT);
}

void loop() {
  digitalWrite(2, HIGH);   // 亮
  delay(500);              // 等500ms
  digitalWrite(2, LOW);    // 灭
  delay(500);              // 等500ms
}

这段代码能跑，但有个问题：delay() 会阻塞CPU。在等待的500ms里，CPU啥也干不了。如果你同时要扫描按键、处理通信、刷新显示，delay就是灾难。

实际项目中，我一般用 millis() 做非阻塞延时。原理是记录上次切换的时间，不断检查当前时间是否到了切换点。这样CPU就能腾出手干别的。

// 非阻塞闪烁
const int ledPin = 2;
unsigned long previousMillis = 0;
const long interval = 500;
int ledState = LOW;

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  unsigned long currentMillis = millis();
  
  if (currentMillis - previousMillis >= interval) {
    previousMillis = currentMillis;
    ledState = (ledState == LOW) ? HIGH : LOW;
    digitalWrite(ledPin, ledState);
  }
  
  // 这里可以干别的事，比如读按键、处理串口数据
}

你想想看，如果每个延时都用delay，一个稍微复杂点的项目，CPU大部分时间都在空等。用millis()才是正经做法。

2.4 PWM调光原理——让LED呼吸起来

数字输出只能亮或灭，但PWM可以让LED“半亮半灭”。原理其实不复杂：在一个周期内，高电平的时间占比叫占空比。占空比100%就是全亮，0%就是全灭，50%就是一半亮度。

人眼有视觉暂留效应，只要PWM频率够高（一般1kHz以上），你就感觉不到闪烁，只看到平均亮度。

PWM关键参数

频率：每秒多少个周期。LED调光一般用1kHz~5kHz，电机控制用几百Hz到几十kHz。
占空比：高电平时间占整个周期的比例。范围0%~100%。
分辨率：占空比能分多少级。8位分辨率就是0~255，16位就是0~65535。

ESP32的PWM比普通单片机灵活得多。它有专门的LEDC（LED Control）外设，可以独立设置频率和分辨率，最多16个通道。我做过一个项目，同时控制8路RGB灯带，每路3个通道，一共24路PWM，ESP32轻松搞定。

// PWM呼吸灯示例
const int ledPin = 2;
const int freq = 5000;      // 5kHz
const int ledChannel = 0;   // 通道0
const int resolution = 8;   // 8位分辨率，0~255

void setup() {
  ledcSetup(ledChannel, freq, resolution);
  ledcAttachPin(ledPin, ledChannel);
}

void loop() {
  // 从暗到亮
  for (int dutyCycle = 0; dutyCycle <= 255; dutyCycle++) {
    ledcWrite(ledChannel, dutyCycle);
    delay(5);
  }
  // 从亮到暗
  for (int dutyCycle = 255; dutyCycle >= 0; dutyCycle--) {
    ledcWrite(ledChannel, dutyCycle);
    delay(5);
  }
}

注意这里用的是 ledcWrite()，不是 digitalWrite()。因为PWM模式下，GPIO不再由普通的数字输出控制，而是由LEDC外设接管。你调用 ledcWrite() 的时候，硬件会自动产生PWM波形，CPU不用管。

重要提醒

ESP32的PWM通道和GPIO不是一一对应的。一个通道可以绑定到多个GPIO，但一个GPIO只能绑定一个通道。另外，不是所有GPIO都支持PWM输出。具体哪些引脚能用，要看芯片手册。我建议你避开GPIO6~11，这些是Flash接口引脚，乱动会导致程序跑飞。

2.5 本章知识结构图

下面这张图把本章的核心逻辑串起来了。从GPIO模式选择，到数字输出控制LED亮灭，再到PWM调光实现呼吸效果。你看一遍就能理清脉络。

2.6 常见问题与避坑

最后总结几个我实际踩过的坑，你遇到了可以直接翻回来查。

坑1：GPIO上电瞬间电平不确定

ESP32上电时，GPIO默认是输入模式，电平由外部电路决定。如果你外接的LED阳极直接连GPIO，阴极接地，上电瞬间GPIO可能是低电平，LED不会亮。但如果你接的是共阳接法（LED阳极接VCC，阴极接GPIO），上电瞬间GPIO如果是高阻，LED可能微亮。解决办法：在setup()里尽快设置GPIO模式并输出确定电平。

坑2：PWM频率选不对，LED会闪

人眼对50Hz~100Hz的闪烁很敏感。PWM频率低于100Hz，你会看到LED在闪。我一般选1kHz以上，既省电又无闪烁。但频率太高也有问题——频率超过10kHz，LED驱动电路的开关损耗会变大，而且有些LED灯珠的响应速度跟不上。折中方案：1kHz~5kHz。

坑3：GPIO驱动能力有限

ESP32单个GPIO最大输出电流约12mA，所有GPIO总电流不能超过200mA。如果你要驱动大功率LED（比如1W以上的），必须加三极管或MOS管驱动。我见过有人直接用GPIO驱动5V继电器，结果GPIO烧了。记住：GPIO只能驱动小负载，大负载必须加驱动电路。

好了，这一章的内容就到这儿。GPIO控制是嵌入式开发的基本功，你把它练熟了，后面做传感器读取、电机控制、通信接口都会轻松很多。代码多敲几遍，尤其是非阻塞延时和PWM调光，这两个是高频使用的技能。