第2章 GPIO基础与LED控制

2、GPIO基础与LED控制：GPIO工作原理、数字输出控制、点亮第一个LED、PWM调光原理、LED呼吸灯实现

好，咱们正式开始动手了。

这一章，是整门课里最让人兴奋的部分之一。为什么？因为你要亲眼看到自己写的代码，让硬件“活”起来。从这一章开始，你不再是单纯地看文档、读理论，而是真正在控制物理世界。

我个人习惯，每接触一块新开发板，第一件事就是点亮一个LED。这就像程序员学新语言先写“Hello World”一样，是一种仪式感，也是验证整个工具链是否打通的最快方式。

2.1 GPIO到底是什么？

GPIO，全称是General-Purpose Input/Output，通用输入输出口。说白了，它就是芯片上那些可以编程控制的引脚。

你可以把它想象成一个智能开关。这个开关有两个状态：高电平（3.3V）和低电平（0V）。你通过代码告诉它：“你现在输出高电平”，它就把引脚拉到3.3V；你说“输出低电平”，它就拉到0V。

嗯，这里要注意：ESP32的工作电压是3.3V，不是5V。我在项目中遇到过新手直接把5V的外设接到ESP32上，结果芯片冒烟了。所以，永远记住，ESP32的GPIO耐受电压是3.3V。

⚠️ 重要警告： 千万不要将5V电源直接接入ESP32的GPIO引脚，否则会烧毁芯片。如果需要驱动5V设备，必须使用电平转换模块。

2.2 数字输出控制——让引脚听话

在Arduino框架下，控制GPIO输出非常简单。核心就两个函数：

pinMode(pin, mode) —— 设置引脚模式
digitalWrite(pin, value) —— 写入高低电平

你想想看，这就像你给一个开关设定好功能，然后去拨动它。模式设置好了，后面就只管开和关。

这里有个小细节：pinMode 通常放在 setup() 函数里，只执行一次。而 digitalWrite 可以放在 loop() 里反复执行。

💡 我的经验： 我习惯在 pinMode 之后，先调用一次 digitalWrite 设置一个初始状态。比如先写 LOW，确保上电时LED是灭的。这样可以避免上电瞬间的闪烁。

2.3 点亮第一个LED——硬件连接与代码

好，咱们来真的。你需要准备：

一块ESP32开发板
一个LED（颜色随意，我建议用红色，看得清楚）
一个220Ω电阻（限流用，别省这一步）
几根杜邦线

连接方式很简单：

将LED的长脚（阳极）通过220Ω电阻连接到ESP32的GPIO2引脚
将LED的短脚（阴极）连接到GND（地线）

为什么选GPIO2？因为ESP32很多开发板上，GPIO2都连接了一个板载LED，方便调试。我个人习惯用这个引脚做测试，省得额外接线。

代码来了：

void setup() {
  pinMode(2, OUTPUT);  // 设置GPIO2为输出模式
  digitalWrite(2, LOW); // 初始状态：LED熄灭
}

void loop() {
  digitalWrite(2, HIGH); // 点亮LED
  delay(1000);           // 保持1秒
  digitalWrite(2, LOW);  // 熄灭LED
  delay(1000);           // 保持1秒
}

上传代码后，你会看到LED以1秒的间隔闪烁。恭喜你，你已经成功控制了硬件！

  🎯 核心要点： 这就是数字输出的本质——用高低电平控制外部设备。简单，但这是所有复杂控制的基础。

2.4 PWM调光原理——让LED不只是亮和灭

你可能会想：“只能亮和灭，太单调了。能不能让LED半亮？”

当然可以。这就引出了PWM——脉冲宽度调制。

PWM的原理，说白了就是：快速开关。你让LED以极高的频率（比如1000Hz）不停地亮和灭。如果亮的时间长、灭的时间短，人眼看起来就亮；反之就暗。

这里有两个关键参数：

参数	说明	示例
频率	每秒开关的次数	1000Hz = 每秒开关1000次
占空比	高电平时间占整个周期的比例	50% = 一半时间亮，一半时间灭

人眼的视觉暂留效应，让我们无法察觉这种快速闪烁，只会感受到平均亮度。占空比越高，LED越亮。

ESP32的PWM功能很强大。它有一个LEDC（LED Control）外设，专门用来生成PWM信号。你可以设置频率、分辨率（占空比的精度），非常灵活。

💡 避坑指南： 我曾经在项目里把PWM频率设得太低（比如50Hz），结果LED肉眼可见地在闪烁，用户投诉说“灯坏了”。后来我把频率提高到1000Hz以上，问题就解决了。记住：调光用的PWM，频率至少要在500Hz以上。

2.5 LED呼吸灯实现——从亮到暗，再到亮

呼吸灯，就是LED的亮度像呼吸一样，缓慢地从暗到亮，再从亮到暗，循环往复。

实现思路很简单：

用PWM控制LED亮度
在循环中逐渐增加占空比（变亮）
到达最大值后，逐渐减小占空比（变暗）
重复这个过程

ESP32的LEDC库让这件事变得非常优雅。来看代码：

// 定义PWM参数
const int ledPin = 2;      // GPIO2
const int freq = 5000;     // 5kHz PWM频率
const int ledChannel = 0;  // PWM通道
const int resolution = 8;  // 8位分辨率（0-255）

void setup() {
  // 配置PWM
  ledcSetup(ledChannel, freq, resolution);
  // 将GPIO2绑定到PWM通道
  ledcAttachPin(ledPin, ledChannel);
}

void loop() {
  // 逐渐变亮
  for (int dutyCycle = 0; dutyCycle <= 255; dutyCycle++) {
    ledcWrite(ledChannel, dutyCycle);
    delay(10);  // 控制变化速度
  }
  // 逐渐变暗
  for (int dutyCycle = 255; dutyCycle >= 0; dutyCycle--) {
    ledcWrite(ledChannel, dutyCycle);
    delay(10);
  }
}

上传代码后，你会看到LED像呼吸一样，柔和地亮起、熄灭。是不是很有成就感？

  🎯 核心要点： 呼吸灯的本质，就是PWM占空比的连续变化。这个技巧在智能灯控中非常常用，比如模拟日出唤醒、夜间小夜灯等场景。

2.6 本章小结

这一章，我们从最基础的GPIO原理讲起，到点亮第一个LED，再到用PWM实现呼吸灯。你其实已经掌握了智能灯控系统的核心控制逻辑。

我个人觉得，这一章最大的价值不是代码本身，而是让你建立了“代码控制物理世界”的直觉。以后你看到任何灯、电机、传感器，都会下意识地想：“这个能不能用PWM控制？”

下一章，我们会深入GPIO的输入功能，学习如何读取按键状态。到时候，你的灯就不再只是“自己亮自己灭”，而是可以被你控制了。

📌 课后练习： 试着修改呼吸灯的代码，让它的呼吸速度变快或变慢。再试试用两个LED，实现交替呼吸的效果。动手试试，你会发现更多乐趣。

📚 课程目录

2、GPIO基础与LED控制：GPIO工作原理、数字输出控制、点亮第一个LED、PWM调光原理、LED呼吸灯实现

2.1 GPIO到底是什么？

2.2 数字输出控制——让引脚听话

2.3 点亮第一个LED——硬件连接与代码

2.4 PWM调光原理——让LED不只是亮和灭

2.5 LED呼吸灯实现——从亮到暗，再到亮

2.6 本章小结