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

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

各位同学，欢迎来到第二章。上一章我们把ESP32的开发环境搭好了，也跑了第一个“Hello World”程序。但说真的，一个只会打印串口日志的芯片，跟一块砖头没什么区别。真正的硬件工程师，得让芯片跟外界“动手动脚”——也就是控制GPIO。

这一章，我们就从最基础的LED灯开始。别小看这个小灯，它背后藏着数字输出、GPIO模式、PWM调光这些核心概念。我做了十几年嵌入式，可以说，GPIO玩明白了，嵌入式就入门了一半。

2.1 什么是GPIO？

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

ESP32有34个GPIO引脚，但不是所有引脚都能随便用。比如GPIO6到GPIO11被内部Flash占用了，你拿来点灯，程序就跑飞了。嗯，这里要注意。

核心概念：GPIO的本质就是一个数字开关。输出模式下，你写1它就输出高电平，写0就输出低电平。输入模式下，它读取外部电平，返回1或0。

2.2 数字输出与GPIO模式配置

在ESP32上操作GPIO，我习惯用Arduino框架的API，简洁明了。当然，ESP-IDF原生框架也可以，但咱们课程面向实战，怎么快怎么来。

配置一个GPIO为输出模式，只需要两步：

设置引脚模式：pinMode(pin, OUTPUT)
写入电平：digitalWrite(pin, HIGH/LOW)

你想想看，就这么简单。但我在项目中遇到过一个问题：有个同事把pinMode放在了循环里，每次循环都重新配置一次引脚。结果LED闪烁频率完全不对，查了半天才发现是模式配置消耗了额外时间。所以记住，pinMode只需要在setup()里调用一次。

个人习惯：我一般会在代码开头用宏定义给每个引脚起个名字，比如#define LED_PIN 2。这样后期换引脚，改一行就行，不用满篇找数字。

2.3 LED闪烁实验

好，理论说完了，咱们直接上手。下面这个实验，让ESP32板载的LED（通常是GPIO2）以1秒为周期闪烁。

// LED闪烁实验 - 经典Blink
#define LED_PIN 2

void setup() {
  pinMode(LED_PIN, OUTPUT);  // 配置GPIO2为输出模式
  Serial.begin(115200);
  Serial.println("LED闪烁实验开始！");
}

void loop() {
  digitalWrite(LED_PIN, HIGH);  // 点亮LED
  Serial.println("LED ON");
  delay(1000);                  // 保持1秒

  digitalWrite(LED_PIN, LOW);   // 熄灭LED
  Serial.println("LED OFF");
  delay(1000);                  // 保持1秒
}

这段代码，你上传到ESP32，就能看到板载LED一亮一灭。为什么是1秒？因为delay(1000)让程序停在这里1000毫秒。但delay()有个大问题——它会阻塞整个程序。在delay期间，芯片什么都干不了，不能读传感器，不能处理网络数据。

避坑指南：我曾经在一个项目中用了大量delay()，结果Wi-Fi连接总是超时。后来改用millis()非阻塞定时，问题才解决。所以，delay()只适合学习阶段，实际产品中尽量少用。

下面我画了一张图，帮你理清GPIO数字输出的完整流程：

2.4 PWM调光原理

数字输出只能让LED要么全亮，要么全灭。那怎么实现呼吸灯效果？让LED慢慢变亮再慢慢变暗？这就轮到PWM出场了。

PWM，Pulse Width Modulation，脉冲宽度调制。说白了，就是在一个周期内，让信号一部分时间高电平，一部分时间低电平。人眼有视觉暂留效应，只要频率够快（通常1kHz以上），你看到的就不是闪烁，而是亮度变化。

关键参数就两个：

参数	说明	典型值
频率	每秒多少个PWM周期	1000 Hz（1kHz）
占空比	高电平时间占整个周期的比例	0% ~ 100%

占空比0%就是全灭，100%就是全亮，50%就是一半亮度。你想想看，这不就是数字信号模拟了模拟效果吗？

ESP32的PWM比普通单片机灵活得多。它有一个LEDC（LED Control）外设，专门用来生成PWM信号。你可以设置任意频率、任意分辨率（比如8位、10位、16位）。

核心公式：PWM分辨率 = 占空比可调级数。8位分辨率就是0~255共256级，16位就是0~65535共65536级。级数越多，调光越平滑。

2.5 PWM调光实战：呼吸灯

下面这个实验，让LED从暗到亮，再从亮到暗，循环往复，就像呼吸一样。

// PWM呼吸灯实验
#define LED_PIN 2
#define PWM_CHANNEL 0      // LEDC通道0
#define PWM_FREQ 5000      // 5kHz频率
#define PWM_RESOLUTION 8   // 8位分辨率（0-255）

void setup() {
  ledcSetup(PWM_CHANNEL, PWM_FREQ, PWM_RESOLUTION);
  ledcAttachPin(LED_PIN, PWM_CHANNEL);
  Serial.begin(115200);
}

void loop() {
  // 逐渐变亮
  for (int duty = 0; duty <= 255; duty++) {
    ledcWrite(PWM_CHANNEL, duty);
    delay(5);
  }
  // 逐渐变暗
  for (int duty = 255; duty >= 0; duty--) {
    ledcWrite(PWM_CHANNEL, duty);
    delay(5);
  }
}

这段代码里，ledcSetup配置PWM参数，ledcAttachPin把PWM通道绑定到物理引脚。然后循环里改变占空比，每次增减1，延时5毫秒。整个呼吸周期大约2.5秒。

个人经验：我在做智能灯控项目时，发现PWM频率不能太低。低于200Hz，人眼就能看到闪烁，体验很差。一般室内照明，我习惯用1kHz以上。但驱动电机时，频率要低一些，否则电机啸叫。

2.6 数字输出 vs PWM：一张表看懂

特性	数字输出	PWM输出
输出状态	只有高/低两种	模拟连续变化
控制精度	1位（0或1）	8~16位（256~65536级）
硬件需求	任意GPIO	需支持PWM的引脚
典型应用	开关、指示灯、继电器	调光、调速、音频输出
功耗	静态功耗低	高频切换，功耗略高

避坑指南：ESP32的PWM通道是共享的。LEDC有8个通道，但每个通道只能绑定一个引脚。如果你要控制多个LED，记得分配不同的通道。我曾经在这里踩过坑，两个灯共用一个通道，结果它们亮度完全一样，根本没法独立控制。

2.7 本章小结

这一章我们干了三件事：

理解了GPIO的本质——数字开关
用digitalWrite实现了LED闪烁
用PWM实现了呼吸灯效果

这些基础操作，是后续所有外设控制、传感器读取、甚至Wi-Fi通信的基石。你想想看，连一个灯都控制不好，怎么去控制电机、屏幕、物联网设备？