📚 课程目录第3章 GPIO与LED控制

3. GPIO与LED控制：数字IO口操作，点亮板载LED，实现呼吸灯效果

各位同学，今天咱们来聊聊嵌入式开发里最基础、也最直观的一个操作——控制GPIO。说白了，就是让芯片的引脚输出高电平或低电平，去驱动外设。我刚开始学单片机那会儿，第一个实验就是点亮一个LED，那种“我能控制硬件了”的成就感，到现在还记得。

这一章，我们会从GPIO的基本概念讲起，然后实际操作板载LED，最后实现一个呼吸灯效果。别小看呼吸灯，它背后涉及的是PWM（脉宽调制）的原理，这在后续的无线透传、传感器数据采集中都会用到。

3.1 GPIO是什么？

GPIO，全称General Purpose Input Output，通用输入输出口。你可以把它想象成芯片伸出来的“触手”。每个GPIO引脚，都可以被配置成输入模式（读取外部信号）或输出模式（对外输出高低电平）。

在ESP32这类芯片上，GPIO的功能更丰富。除了基本的输入输出，还能配置成复用功能，比如UART、I2C、SPI等。但这一章，我们只关注最纯粹的“数字输出”。

核心概念：

高电平（1）： 通常对应3.3V（ESP32）或5V（部分Arduino），LED亮。
低电平（0）： 通常对应0V（GND），LED灭。
推挽输出： 最常用的输出模式，既能输出高电平，也能输出低电平，驱动能力强。
开漏输出： 只能输出低电平，高电平需要外部上拉电阻。常用于I2C总线。

3.2 点亮板载LED

大多数开发板上都有一颗板载LED，通常连接到某个固定的GPIO引脚。比如ESP32开发板，板载LED一般接在GPIO2上。但不同厂商的板子可能不一样，我建议你先查一下原理图。

我记得有一次，一个学员拿着板子来找我，说LED怎么都不亮。我一看，他用的板子LED接的是GPIO5，但他代码里写的是GPIO2。嗯，这种低级错误，我也犯过。

下面是一个标准的点亮LED的代码示例，基于Arduino框架（ESP32也支持）：

// 定义LED引脚
const int ledPin = 2;  // 根据你的板子修改

void setup() {
  // 设置引脚为输出模式
  pinMode(ledPin, OUTPUT);
}

void loop() {
  // 输出高电平，点亮LED
  digitalWrite(ledPin, HIGH);
  delay(1000);  // 等待1秒
  
  // 输出低电平，熄灭LED
  digitalWrite(ledPin, LOW);
  delay(1000);  // 等待1秒
}

这段代码很简单，但背后有几个关键点：

pinMode()：配置引脚模式。这里用了OUTPUT，告诉芯片这个引脚要往外送信号。
digitalWrite()：写入数字信号。HIGH就是高电平，LOW就是低电平。
delay()：延时函数，单位毫秒。这里让LED亮1秒，灭1秒，形成闪烁效果。

小技巧： 如果你不确定板载LED接在哪个引脚，可以写一个简单的扫描程序，让所有引脚轮流输出高电平，看哪个引脚对应的LED亮了。我早期做项目时，经常用这招来“盲测”硬件连接。

3.3 从闪烁到呼吸灯：PWM原理

闪烁LED很简单，但呼吸灯就有点意思了。呼吸灯的效果是：LED从暗到亮，再从亮到暗，循环往复，像呼吸一样自然。

怎么实现呢？直接给高电平，LED最亮；直接给低电平，LED最暗。那中间亮度怎么控制？

答案是：PWM（脉宽调制）。

PWM的原理，说白了就是“快速开关”。在一个非常短的时间周期内，让LED快速亮、灭。如果亮的时间长，灭的时间短，人眼看起来就亮；反之就暗。这个“亮的时间占整个周期的比例”，叫做占空比。

占空比 = 0%：一直灭，最暗。
占空比 = 100%：一直亮，最亮。
占空比 = 50%：一半时间亮，一半时间灭，看起来是半亮。

人眼的视觉暂留效应，让我们看不到闪烁，只看到平均亮度。你想想看，是不是这个道理？

下面这张图，展示了PWM的原理：

3.4 用代码实现呼吸灯

在Arduino框架下，实现PWM非常简单。ESP32的LEDC（LED Control）外设，专门用来生成PWM信号。我们只需要配置好频率和分辨率，然后改变占空比即可。

下面是一个完整的呼吸灯代码：

// 定义LED引脚和PWM参数
const int ledPin = 2;
const int freq = 5000;      // PWM频率，单位Hz
const int ledChannel = 0;   // PWM通道，ESP32有16个通道
const int resolution = 8;   // 分辨率，8位，即占空比范围0-255

void setup() {
  // 配置PWM
  ledcSetup(ledChannel, freq, resolution);
  // 将PWM通道绑定到GPIO引脚
  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);
  }
}

这段代码里，有几个新面孔：

ledcSetup()：配置PWM通道。频率5000Hz，分辨率8位。分辨率越高，亮度变化越细腻。
ledcAttachPin()：把PWM通道和物理引脚绑定起来。
ledcWrite()：写入占空比。0最暗，255最亮。
两个for循环：一个递增，一个递减，模拟呼吸的节奏。

注意事项：

ESP32的PWM频率不要设置太高，否则LED可能会产生人耳可闻的啸叫声。我一般用5000Hz，既平滑又安静。
不同GPIO引脚可能共享同一个PWM通道，注意不要冲突。
如果你用的是Arduino Uno，PWM引脚是带“~”标记的（如3、5、6、9、10、11），用法是analogWrite()，原理类似。

3.5 呼吸灯效果优化

上面的代码虽然能实现呼吸灯，但效果有点“生硬”。为什么？因为人眼对亮度的感知不是线性的。你从0到255线性增加占空比，人眼会觉得前面变化慢，后面变化快。

要解决这个问题，可以用指数曲线或对数曲线来映射占空比。简单点说，就是让占空比的变化速度，符合人眼的感知特性。

我分享一个我常用的优化方法：

void loop() {
  // 使用正弦波模拟更自然的呼吸
  for (int i = 0; i < 360; i++) {
    // 将角度转换为弧度，计算正弦值，映射到0-255
    float rad = i * 3.14159 / 180;
    int dutyCycle = (sin(rad) + 1) * 127.5;  // 范围0-255
    ledcWrite(ledChannel, dutyCycle);
    delay(10);
  }
}

这里用了sin()函数，生成一个平滑的正弦波。LED的亮度会按照正弦曲线变化，看起来更自然，就像真的在呼吸一样。

经验之谈： 我在做智能家居产品时，呼吸灯的效果直接影响用户体验。用户不会在意你用了什么算法，他们只关心“看着舒不舒服”。所以，花点时间调参数，值得。

3.6 本章小结

这一章，我们从GPIO的基础概念出发，亲手点亮了板载LED，然后通过PWM实现了呼吸灯效果。核心知识点就三个：

数字IO操作： pinMode()、digitalWrite()，控制引脚高低电平。
PWM原理： 通过快速开关，改变占空比，控制平均亮度。
呼吸灯实现： 用ledcWrite()改变占空比，配合循环或正弦波，模拟呼吸效果。

这些技能，在后续的WiFi配网状态指示、无线透传数据流可视化中，都会反复用到。别觉得简单，基础打牢了，后面才能跑得快。