单片机与物联网 / 系统课时
读取按键状态
读取按键状态
本节解决 ESP32 如何判断按键是否被按下的问题。你将把一个 GPIO 配置为数字输入,读取 HIGH/LOW 电平,并通过串口把电平转换成直观的按键状态。
学习目标
- 使用
pinMode()将 GPIO 配置为数字输入 - 使用
digitalRead()读取 GPIO 的 HIGH 和 LOW - 根据实际接线判断“按下”和“松开”对应的逻辑电平
按键实际上改变的是电平
ESP32 的数字输入并不知道什么是“按键”,它只能判断 GPIO 当前接近高电平还是低电平。程序再根据电路连接方式,把这个电平解释为“按下”或“松开”。
本节采用最常见的接法:按键一端连接 GPIO18,另一端连接 GND,并启用 ESP32 的内部上拉电阻。按键松开时 GPIO 被保持为 HIGH;按下后 GPIO 与 GND 导通,因此读取到 LOW。

配置 GPIO 并读取状态
在 Arduino 框架中,pinMode() 负责设置 GPIO 模式,digitalRead() 返回当前数字电平。下面的完整程序每 200 ms 读取一次 GPIO18,并把状态打印到串口监视器。
const int BUTTON_PIN = 18;
void setup() {
Serial.begin(115200);
// 使用内部上拉,让按键松开时输入保持为稳定 HIGH。
pinMode(BUTTON_PIN, INPUT_PULLUP);
}
void loop() {
int level = digitalRead(BUTTON_PIN);
// 当前接法中,按键按下会把 GPIO 直接连接到 GND。
if (level == LOW) {
Serial.println("PRESSED");
} else {
Serial.println("RELEASED");
}
delay(200);
}预期输出:打开 115200 波特率的串口监视器,松开和按下按键时会看到类似结果。
RELEASED
RELEASED
PRESSED
PRESSED
RELEASED实际连续出现多少行取决于按键保持时间和程序的 200 ms 采样间隔。
从电平判断按键状态
digitalRead(BUTTON_PIN) 的返回值只有 HIGH 或 LOW。对于本节电路,可以直接建立如下对应关系:
| GPIO18 电平 | 按键状态 | 原因 |
|---|---|---|
| HIGH | 松开 | 内部上拉将输入保持为高电平 |
| LOW | 按下 | 按键导通后 GPIO18 连接到 GND |
如果把电路改成按下时连接 3.3V,并使用下拉电阻,那么逻辑会反过来:按下是 HIGH,松开是 LOW。因此程序中的条件判断必须和实际硬件连接一致。
读取异常时先检查这些位置
如果串口状态始终不变化,先检查按键是否真正跨接在 GPIO18 与 GND 之间,再确认代码中的引脚编号与实际接线一致。某些开发板丝印编号与芯片 GPIO 编号不是同一概念,应以开发板引脚定义为准。
如果状态在没有按键操作时随机跳变,通常意味着输入没有稳定的默认电平。本例通过 INPUT_PULLUP 避免这种情况;直接使用 INPUT 时,则需要由外部电路提供可靠的上拉或下拉。
机械按键在按下和释放瞬间还可能出现数毫秒的触点抖动,因此真实项目中的一次按键可能被读取成多次快速变化。这里的 200 ms 延时只是便于观察状态,不是完整的消抖方案;当程序需要准确统计单次按键事件时,还应加入软件或硬件消抖逻辑。