ESP32-S3 按键

GPIO按键（独立按键）和ADC按键（电阻分压按键）在嵌入式系统中有各自明确的适用场景。
GPIO按键的本质是数字逻辑。每个按键独立占用一个GPIO，这个GPIO被配置为数字输入模式。按键按下时，引脚电平在0和1之间跳变。ADC按键的本质是模拟量编码。它通过电阻分压，将不同的按键信息编码成不同的电压值。

为了帮你更直观地了解，我从硬件资源、软件复杂度、功能扩展性、可靠性这几个核心维度进行了深度对比：

⚖️ ADC按键 vs GPIO按键

对比维度	GPIO按键（独立式）	ADC按键（电阻分压式）
引脚占用	高：1个按键占用1个GPIO。	极低：N个按键仅占用1个ADC引脚。
电路复杂度	简单：每个按键独立，互不干扰，只需上拉电阻（或启用内部上拉）。	中等：需要精密电阻分压网络，电阻精度影响检测准确性。
软件复杂度	简单：直接读取引脚电平，消抖逻辑简单。	较高：需进行ADC采样、滤波、区间判断，处理逻辑更复杂。
成本	低：仅需按键，可利用MCU内部上拉。	中等：需要多个高精度电阻，增加BOM成本和PCB面积。
响应速度	快：电平变化实时反映在中断或轮询中。	较慢：依赖ADC采样和转换时间，有固定周期。
组合键检测	完美支持：可准确识别任意组合键（如Ctrl+Alt）。	不支持：无法同时按下两个键（会产生分压并联，电压值不确定）。
长按键/短按键	支持良好，通过计时即可实现。	支持良好，通过计时即可实现。
功耗	较低：可通过中断唤醒，无需持续工作。	较高：需周期性开启ADC采样，会增加平均功耗。
抗干扰能力	强：数字信号，电平判断有噪声容限。	中等：易受电源波动、电阻温漂、PCB漏电流影响。

点击 牛瘪汤 主页可以了解更多。

---

---

1. GPIO 直连按键

在ESP32-S3中，GPIO0通常用作启动模式选择引脚（上拉为正常运行模式，下拉为下载模式），但也可配置为用户按键输入。

1.1 中断方式检测按键

const int buttonPin = 0;  // GPIO0
volatile bool buttonPressed = false;

void IRAM_ATTR handleInterrupt() {
  buttonPressed = true;
}

void setup() {
  Serial.begin(115200);
  pinMode(buttonPin, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(buttonPin), handleInterrupt, FALLING);
}

void loop() {
  if (buttonPressed) {
    Serial.println("Button pressed!");
    buttonPressed = false;
    // 添加按键处理逻辑
  }
}

中断服务程序（ISR）必须标记为IRAM_ATTR以确保其存放在IRAM中，避免从闪存执行导致的延迟。

1.2 中断方式检测按键(消抖)

由于GPIO0在启动时影响设备模式，确保按键按下不会干扰正常启动。建议在电路设计时增加硬件防抖（如0.1μF电容并联按键）。

const int buttonPin = 0;  // GPIO0
volatile bool buttonPressed = false;
unsigned long lastDebounceTime = 0;
const unsigned long debounceDelay = 50;

void IRAM_ATTR handleInterrupt() {
  buttonPressed = true;
}

void setup() {
  Serial.begin(115200);
  pinMode(buttonPin, INPUT_PULLUP);
  attachInterrupt(digitalPinToInterrupt(buttonPin), handleInterrupt, FALLING);
}

void loop() {
  if (buttonPressed && (millis() - lastDebounceTime) > debounceDelay) {
    lastDebounceTime = millis();
    Serial.println("Valid button press");
    buttonPressed = false;
  }
}

中断类型选择：
FALLING: 按键按下时触发（高→低）
RISING: 按键释放时触发（低→高）
CHANGE: 任何电平变化触发
对于大多数按键场景，FALLING或RISING配合消抖即可满足需求。避免使用CHANGE模式可能导致的多次误触发。

1.3 键轮询检测按键

ESP32S3 配置内部上拉 INPUT_PULLUP 模式，避免额外电阻，但需注意ESP32-S3内部上拉电阻约45kΩ，若环境干扰大建议外接更小阻值（如10kΩ）。机械按键会产生抖动，通过延时过滤误触发，也就是防抖处理。需要注意: GPIO0在启动时为低电平会进入下载模式，正常运行时无需担心此问题。

const int buttonPin = 0; // GPIO0作为按键输入
bool lastButtonState = HIGH; // 默认上拉状态为HIGH
bool buttonState;
unsigned long lastDebounceTime = 0;
unsigned long pressStartTime = 0;
const int longPressDuration = 1000; // 长按判定时间(ms)
unsigned long debounceDelay = 50; // 防抖延时(ms)

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

void loop() {
  bool reading = digitalRead(buttonPin); // 读取当前引脚状态

  // 防抖逻辑：状态变化时重置计时器
  if (reading != lastButtonState) {
    lastDebounceTime = millis();
  }

  // 稳定状态检测
  if ((millis() - lastDebounceTime) > debounceDelay) {
    if (reading != buttonState) {
      buttonState = reading;
      
      // 仅当按键稳定为LOW时触发（按下动作）
      if (buttonState == LOW) {
        pressStartTime = millis();
        Serial.println("Button pressed!");
        // 此处添加按键按下后的处理逻辑
      }  else if (pressStartTime > 0) {
			  if (millis() - pressStartTime > longPressDuration) {
			    Serial.println("Long press detected");
			  } else {
			    Serial.println("Short press detected");
			  }
			  pressStartTime = 0;
			}
    }
  }

  lastButtonState = reading;
}

2. ADC 连接按键

ADC串联按键，其实就是利用单片机的一个ADC（模数转换）引脚，配合一个电阻分压网络来识别多个按键。这是一种非常巧妙的方法，可以在只占用一个引脚的情况下，扩展出多个按键，特别适合引脚资源紧张的场景。
它的核心思想是：让不同的按键按下时，在ADC引脚上产生不同且可区分的电压值。单片机通过读取这个电压值，就能判断出是哪个按键被按下了。

⚙️ 工作原理详解

为了帮你直观理解，我们先来看一个典型的电路图。它由两部分组成：一个上拉电阻（连接到电源）和一系列由电阻和按键组成的串联支路（连接到地）。

这个电路的工作状态可以分为两种情况：

1. 无按键按下（空闲状态）：所有按键支路都处于断开状态，ADC引脚通过上拉电阻 R_pull-up 被稳定地拉到了电源电压 VCC。此时，单片机读取到的电压值就是 VCC，代表没有任何按键被按下。

2. 单个按键按下：当某个按键（比如 Key2）被按下时，该支路导通。电流的路径变为：VCC → R_pull-up → ADC引脚 → 电阻R2 → GND。这就构成了一个简单的串联分压电路。根据电阻串联分压原理，ADC引脚上的电压 V_adc 就可以通过公式计算出来：

$$V_{adc}=VCC\times \frac{R_{按键支路电阻}}{R_{pull-up}+R_{按键支路电阻}}$$

其中，$R_{按键支路电阻}$ 就是该按键所在支路上串联的电阻值。

由于每个按键支路串联的电阻值（R1, R2, R3…）都是经过精心计算的，因此每个按键按下时产生的 V_adc 都会是一个独一无二的电压值。单片机通过ADC读取到这个电压，再与预设的电压表进行对比，就能准确地识别出是哪个按键被按下了。

将4个按键串联连接，每个按键的一端接ESP32-S3的ADC引脚（如GPIO1），另一端通过不同阻值的电阻接地。按键按下时，ADC引脚会检测到不同的分压值。

• 按键1：100Ω
• 按键2：2kΩ
• 按键3：3.3kΩ
• 按键4：6.8kΩ

const int adcPin = 1;  // 使用GPIO1作为ADC输入  
const int adcResolution = 4095;  // ESP32-S3 ADC为12位  
const float voltageRef = 3.3;    // 参考电压  

// 定义按键电压阈值（需根据实测调整）  
const float keyThresholds[] = {  
  0.5,   // 按键1阈值（单位：V）  
  1.0,   // 按键2  
  1.5,   // 按键3  
  2.0    // 按键4  
};  

void setup() {  
  Serial.begin(115200);  
  analogReadResolution(12);  // 设置ADC为12位  
}  

void loop() {  
  int adcValue = analogRead(adcPin);  
  float voltage = (adcValue * voltageRef) / adcResolution;  

  // 检测按键按下  
  if (voltage < keyThresholds[0]) {  
    Serial.println("按键1按下");  
  } else if (voltage < keyThresholds[1]) {  
    Serial.println("按键2按下");  
  } else if (voltage < keyThresholds[2]) {  
    Serial.println("按键3按下");  
  } else if (voltage < keyThresholds[3]) {  
    Serial.println("按键4按下");  
  } else {  
    Serial.println("无按键按下");  
  }  

  delay(20);  // 防抖延时  
}  

• 电阻值的选取：这是最关键的一步。你需要保证任意两个按键按下时产生的电压值有足够的差距，以避免因电阻误差、电压波动或ADC精度限制导致的误判。一般来说，相邻按键的ADC采样值差距最好能保持在几十以上（以10位ADC为例）。你可以先根据公式计算出理论电压值，再通过实际测试来微调和确定最终的判断区间。
• 软件消抖与容错：机械按键在按下和释放的瞬间会产生抖动，这会导致ADC读数不稳定。因此，在软件中需要进行消抖处理。常见的做法是：检测到电压变化后，等待10-20毫秒，然后多次采样（例如4-6次）并取平均值，或者去掉最大值和最小值后取平均，最后用这个稳定的平均值去和预设的区间进行比较。

结语

文章都看到完了，就不点个关注吗，老铁！
欢迎关注博主–牛瘪汤 。