单片机与物联网 / 系统课时

读取按键状态

读取按键状态

本节解决 ESP32 如何判断按键是否被按下的问题。你将把一个 GPIO 配置为数字输入,读取 HIGH/LOW 电平,并通过串口把电平转换成直观的按键状态。

学习目标

  • 使用 pinMode() 将 GPIO 配置为数字输入
  • 使用 digitalRead() 读取 GPIO 的 HIGH 和 LOW
  • 根据实际接线判断“按下”和“松开”对应的逻辑电平

按键实际上改变的是电平

ESP32 的数字输入并不知道什么是“按键”,它只能判断 GPIO 当前接近高电平还是低电平。程序再根据电路连接方式,把这个电平解释为“按下”或“松开”。

本节采用最常见的接法:按键一端连接 GPIO18,另一端连接 GND,并启用 ESP32 的内部上拉电阻。按键松开时 GPIO 被保持为 HIGH;按下后 GPIO 与 GND 导通,因此读取到 LOW。

按键连接 GPIO 并读取高低电平

配置 GPIO 并读取状态

在 Arduino 框架中,pinMode() 负责设置 GPIO 模式,digitalRead() 返回当前数字电平。下面的完整程序每 200 ms 读取一次 GPIO18,并把状态打印到串口监视器。

cpp
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 波特率的串口监视器,松开和按下按键时会看到类似结果。

text
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 延时只是便于观察状态,不是完整的消抖方案;当程序需要准确统计单次按键事件时,还应加入软件或硬件消抖逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取按键状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通