2、ESP32基础外设控制：GPIO数字输出、数字输入、按键消抖、PWM呼吸灯

好，咱们直接进入正题。这一章讲的是ESP32最基础、也是最常用的几个外设操作。说白了，就是让芯片跟外界“打招呼”的方式。你想想看，一个单片机如果连引脚都控制不了，那跟一块石头有什么区别？

我个人习惯，每接触一块新开发板，第一件事就是点亮一个LED。这就像程序员写“Hello World”一样，是种仪式感。但别小看这个仪式，它背后藏着GPIO配置、电平输出、时钟使能等一系列基本功。今天我们就从最基础的开始，一步步把ESP32的“手脚”练灵活。

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

GPIO，全称是General Purpose Input Output，通用输入输出口。ESP32有34个GPIO引脚，但不是所有都能随便用。嗯，这里要注意，像GPIO6到GPIO11是连接Flash的，你千万别碰，碰了程序就跑飞了。

数字输出，说白了就是让引脚输出高电平（3.3V）或低电平（0V）。我们用Arduino框架写代码，非常简单：

void setup() {
  pinMode(2, OUTPUT);  // 将GPIO2设置为输出模式
}

void loop() {
  digitalWrite(2, HIGH);  // 输出高电平，LED亮
  delay(1000);            // 延时1秒
  digitalWrite(2, LOW);   // 输出低电平，LED灭
  delay(1000);
}

这段代码，相信很多朋友都见过。但我想说的是，别只停留在复制粘贴。我在项目中遇到过一个问题：用GPIO2驱动一个继电器，结果死活不工作。后来发现，GPIO2在启动时默认是拉高的，会导致继电器在上电瞬间误动作。所以，选引脚时一定要看数据手册里的默认状态。

核心要点：

  • pinMode() 配置方向，digitalWrite() 设置电平
  • ESP32输出高电平是3.3V，不是5V
  • 驱动大负载（如电机、继电器）必须加三极管或光耦隔离

2.2 数字输入——读取按键状态

输出是让芯片说话，输入就是让芯片听话。读取一个按键，听起来简单，但里面坑不少。

先看基本代码：

const int buttonPin = 4;  // 按键接GPIO4

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

void loop() {
  int buttonState = digitalRead(buttonPin);
  Serial.println(buttonState);
  delay(100);
}

这里我用了 INPUT_PULLUP，而不是 INPUT。为什么？因为ESP32内部有上拉电阻，大约45kΩ。你想想看，如果不启用上拉，按键悬空时引脚电平是浮动的，读出来的数据就是乱跳的。我曾经见过一个学生，没加上拉电阻，结果按键没按的时候，串口打印的数据在0和1之间疯狂切换，他还以为是芯片坏了。

我的习惯： 按键电路通常采用“按下为低电平”的接法。即按键一端接GND，另一端接GPIO，内部上拉使能。这样按键按下时读到0，松开时读到1。逻辑清晰，不容易出错。

2.3 按键消抖——别让毛刺坑了你

好，现在问题来了。你按下按键，程序真的只读到一次变化吗？

答案是：不会。机械按键在按下和松开的瞬间，触点会弹跳几次，产生多个脉冲。这就是“抖动”。如果你直接用 digitalRead() 检测边沿，一次按键可能会触发十几次中断。

我刚开始做项目时就被这个坑过。做一个计数器，按一下按键加1，结果按一次能跳好几个数。后来查资料才知道，按键抖动时间一般在5~20ms之间。

消抖有两种常用方法：

方法一：软件延时消抖

if (digitalRead(buttonPin) == LOW) {
  delay(20);  // 等待20ms，避开抖动
  if (digitalRead(buttonPin) == LOW) {
    // 确认按键确实被按下
    Serial.println("按键按下");
  }
}

这种方法简单粗暴，但有个缺点：delay() 会阻塞程序。如果你在延时期间需要处理其他任务，就不太合适了。

方法二：状态机消抖（推荐）

const int debounceDelay = 20;
int lastButtonState = HIGH;
int buttonState;
unsigned long lastDebounceTime = 0;

void loop() {
  int reading = digitalRead(buttonPin);
  
  if (reading != lastButtonState) {
    lastDebounceTime = millis();  // 记录状态变化的时间
  }
  
  if ((millis() - lastDebounceTime) > debounceDelay) {
    // 如果状态稳定超过20ms，则认为有效
    if (reading != buttonState) {
      buttonState = reading;
      if (buttonState == LOW) {
        Serial.println("按键按下（已消抖）");
      }
    }
  }
  
  lastButtonState = reading;
}

避坑指南： 我曾经用第一种延时消抖法做一个智能灯控，结果按键按下时LED呼吸灯卡住了，因为delay阻塞了PWM输出。后来全部改成状态机消抖，问题迎刃而解。所以，但凡涉及多任务，别用delay()。

2.4 PWM呼吸灯——让LED学会“呼吸”

PWM，脉冲宽度调制。说白了，就是通过快速开关引脚，用占空比来模拟模拟电压。人眼有视觉暂留效应，只要频率够高（通常1kHz以上），看到的就是平滑的亮度变化。

ESP32的PWM比Arduino Uno灵活得多。它有一个LEDC（LED Control）外设，可以独立设置频率和分辨率。

const int ledPin = 2;
const int freq = 5000;      // 5kHz PWM频率
const int ledChannel = 0;   // PWM通道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(10);
  }
  // 逐渐变暗
  for (int dutyCycle = 255; dutyCycle >= 0; dutyCycle--) {
    ledcWrite(ledChannel, dutyCycle);
    delay(10);
  }
}

这段代码会让LED像呼吸一样，从暗到亮，再从亮到暗，循环往复。你想想看，如果把这个原理用在智能台灯上，就能实现无级调光，比那种几档亮度的手动开关舒服多了。

关于PWM的几个关键参数：

参数 说明 我的建议
频率 PWM波形的周期 LED用1kHz~5kHz，电机用20kHz以上（避免人耳听到啸叫）
分辨率 占空比的精细程度 8位（0~255）够用，要求高可用10位或12位
通道数 ESP32有8个独立PWM通道 每个通道可绑定多个引脚，但频率相同

小技巧： 如果你想让呼吸效果更自然，可以用正弦波映射占空比，而不是线性变化。人眼对亮度的感知是对数的，线性变化看起来会感觉“中间亮得很快，两头变化慢”。用 sin() 函数生成一个平滑的曲线，效果会好很多。

小结

这一章我们覆盖了ESP32最基础的外设控制：数字输出让LED亮灭，数字输入读取按键状态，按键消抖解决了机械触点的弹跳问题，PWM则让LED学会了“呼吸”。

这些看似简单，但它们是所有复杂项目的地基。我见过太多人一上来就搞WiFi、搞MQTT，结果连个按键都读不稳，最后排查半天发现是没消抖。所以，基础不牢，地动山摇。把这些练熟了，后面的传感器、执行器控制，你上手会快得多。

下一章，我们会深入模拟输入——ADC，也就是让ESP32学会“听”模拟世界的电压信号。到时候你会发现，原来数字世界和模拟世界的桥梁，就是这么搭建起来的。

← 上一章 📖 返回目录 下一章 →