4. GPIO输入输出与LED控制：数字输出点亮LED、按键输入检测、消抖处理、PWM调光、RGB灯控制实战

GPIO（General Purpose Input/Output，通用输入输出）是ESP32与物理世界交互的最基础通道。无论是点亮一盏LED、读取一个按键，还是驱动RGB灯实现呼吸效果，本质上都是对GPIO引脚进行数字或模拟级别的控制。本章将从ESP32的GPIO硬件特性出发，系统讲解数字输出、输入检测、机械消抖、PWM调光以及RGB灯控制的完整知识链，并通过一个综合实战案例将各知识点串联起来。

上图展示了本章的核心工程链路：ESP32通过GPIO矩阵管理输入输出，左侧按键输入经消抖处理后触发逻辑，右侧LED和RGB灯分别接收数字输出与PWM信号，电源域为整个系统提供稳定的3.3V供电。这张图也是后续所有实验的硬件连接基准。

4.1 核心原理：GPIO的工作模式与内部结构

ESP32的GPIO引脚并非简单的“高电平/低电平”开关，其内部集成了可配置的上下拉电阻、施密特触发器、输出驱动器以及复用矩阵。理解这些内部结构是正确使用GPIO的前提。

• 输入模式（Input）：引脚对外呈现高阻态，内部可选使能上拉（默认约45kΩ）或下拉电阻。适用于读取按键、传感器数字输出等场景。
• 输出模式（Output）：引脚由内部驱动器驱动，可输出高电平（3.3V）或低电平（0V）。推挽输出模式下，驱动能力约为40mA（最大值），但建议单引脚不超过20mA以保证长期可靠性。
• 开漏输出（Open-Drain）：引脚只能主动拉低，释放时由外部上拉电阻决定电平。常用于I2C总线或电平转换场景。
• 复用功能（Peripheral）：每个GPIO可映射到UART、SPI、I2C、PWM等外设信号，通过GPIO Matrix寄存器配置。

在Arduino框架下，使用pinMode()、digitalWrite()、digitalRead()即可完成基本操作。但要注意，ESP32的引脚编号与芯片丝印并不完全一致，例如开发板上标注的“D2”可能对应GPIO2，而“D15”可能对应GPIO15，务必查阅开发板原理图确认。

4.2 数字输出点亮LED：从电路设计到代码实现

点亮LED是最直观的数字输出实验，但其中包含两个关键工程点：限流电阻的计算和GPIO驱动能力的考量。

电路设计要点：LED正向压降（V_F）通常为1.8V-2.2V（红色）或3.0V-3.4V（白色/蓝色）。若直接连接3.3V GPIO，必须串联限流电阻。计算公式为：

R = (V_GPIO - V_F) / I_LED
例如：红色LED，V_F=2.0V，目标电流I_LED=10mA
R = (3.3V - 2.0V) / 0.01A = 130Ω
取标准值150Ω或220Ω均可，电流略小但更安全。

代码实现：

#define LED_PIN 2  // 开发板板载LED通常接GPIO2

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

void loop() {
  digitalWrite(LED_PIN, HIGH);  // 点亮
  delay(500);
  digitalWrite(LED_PIN, LOW);   // 熄灭
  delay(500);
}

4.3 按键输入检测与消抖处理

按键输入看似简单，但机械按键在按下和释放的瞬间会产生约5-20ms的抖动，表现为电平在高低之间快速跳变。如果不做消抖处理，一次按键可能被误判为多次触发。

硬件消抖方案：在按键两端并联一个0.1μF电容，利用电容的充放电特性吸收抖动。此方法简单有效，但会增加BOM成本。

软件消抖方案：检测到电平变化后，延时10-20ms再次读取，若状态一致则确认有效。更稳健的做法是连续多次采样，取稳定值。

#define KEY_PIN 0   // 使用BOOT按键，默认上拉

void setup() {
  pinMode(KEY_PIN, INPUT_PULLUP);  // 启用内部上拉
  Serial.begin(115200);
}

bool debounce(int pin) {
  static uint8_t stable_count = 0;
  static bool last_state = HIGH;
  bool current = digitalRead(pin);
  if (current != last_state) {
    stable_count = 0;
    last_state = current;
  } else {
    stable_count++;
  }
  return stable_count >= 3;  // 连续3次采样一致（约15ms）
}

void loop() {
  if (debounce(KEY_PIN) == false) {
    // 按键按下（低电平有效）
    Serial.println("Key Pressed!");
    while (digitalRead(KEY_PIN) == LOW) delay(10);  // 等待释放
  }
}

4.4 PWM调光：用LEDC实现呼吸灯效果

PWM（脉冲宽度调制）通过改变占空比来模拟模拟输出。ESP32的LEDC（LED Control）外设提供16个通道，可配置不同频率和分辨率，非常适合LED调光、电机控制等场景。

关键参数：频率（如5kHz用于LED避免闪烁）、分辨率（如8位即0-255）、通道号（0-15）。

#define LED_PIN 2
#define PWM_CH 0
#define PWM_FREQ 5000
#define PWM_RES 8

void setup() {
  ledcSetup(PWM_CH, PWM_FREQ, PWM_RES);
  ledcAttachPin(LED_PIN, PWM_CH);
}

void loop() {
  // 呼吸灯效果：亮度从0渐增到255，再渐减
  for (int duty = 0; duty <= 255; duty++) {
    ledcWrite(PWM_CH, duty);
    delay(10);
  }
  for (int duty = 255; duty >= 0; duty--) {
    ledcWrite(PWM_CH, duty);
    delay(10);
  }
}

PWM调光时，LED的亮度与占空比并非线性关系。人眼对低亮度更敏感，因此建议使用指数或Gamma校正曲线，使调光过程更自然。例如：duty = pow(brightness / 255.0, 2.2) * 255。

4.5 RGB灯控制实战：三通道PWM混色

RGB LED由红、绿、蓝三个发光芯片组成，通过控制三路PWM的占空比，可以混合出任意颜色。共阴RGB LED的公共端接GND，三个引脚分别通过限流电阻接GPIO。

硬件连接：

代码实现：

#define R_PIN 4
#define G_PIN 5
#define B_PIN 6

void setup() {
  ledcSetup(0, 5000, 8); ledcAttachPin(R_PIN, 0);
  ledcSetup(1, 5000, 8); ledcAttachPin(G_PIN, 1);
  ledcSetup(2, 5000, 8); ledcAttachPin(B_PIN, 2);
}

void setColor(uint8_t r, uint8_t g, uint8_t b) {
  ledcWrite(0, r);
  ledcWrite(1, g);
  ledcWrite(2, b);
}

void loop() {
  setColor(255, 0, 0); delay(500);  // 红色
  setColor(0, 255, 0); delay(500);  // 绿色
  setColor(0, 0, 255); delay(500);  // 蓝色
  setColor(255, 255, 0); delay(500); // 黄色
  setColor(0, 255, 255); delay(500); // 青色
  setColor(255, 0, 255); delay(500); // 品红
  setColor(255, 255, 255); delay(500); // 白色
}

unsigned long press_time;
bool adjusting = false;
int brightness = 255;

void loop() {
  if (digitalRead(KEY_PIN) == LOW) {
    press_time = millis();
    while (digitalRead(KEY_PIN) == LOW) delay(10);
    if (millis() - press_time > 1000) {
      adjusting = true;
      brightness = max(50, brightness - 50);
      setBrightness(brightness);
    } else if (!adjusting) {
      nextColor();
    }
    adjusting = false;
  }
}

4.6 常见误区与总结复盘

本章内容虽基础，但工程实践中常出现以下问题：

• 误区一：忽略引脚默认状态。部分GPIO（如GPIO0、GPIO2、GPIO15）在启动时有特殊功能（下载模式、SD卡检测等），使用前需确认不会影响启动流程。
• 误区二：消抖延时过长。若消抖延时超过50ms，用户会感觉按键“迟钝”。建议消抖总时间控制在15-30ms。
• 误区三：PWM频率选择不当。LED调光频率低于1kHz时人眼可感知闪烁，建议使用5kHz以上；但电机驱动则需较低频率（如1kHz）以获得更大扭矩。
• 误区四：RGB三通道未做Gamma校正。直接线性映射会导致中间色调偏暗，混合颜色不准确。

总结：GPIO控制是嵌入式开发的基本功，但“会亮灯”和“灯亮得好”之间存在巨大差距。本章从数字输出到PWM调光，再到RGB混色，层层递进地构建了完整的LED控制知识体系。在实际项目中，建议先绘制硬件连接图，明确引脚分配和电流路径，再编写代码。同时，善用ESP32的LEDC外设和内部上拉电阻，可大幅简化外围电路设计。下一阶段，读者可尝试将本章的按键与PWM逻辑封装为独立模块，为后续传感器数据可视化、智能家居控制等复杂应用打下基础。