单片机与物联网 / 系统课时
读取按键状态
读取按键状态
本课完成一个最小按键输入实验:把按键引脚配置为上拉或下拉输入,使用 HAL_GPIO_ReadPin 读取电平,并把“按下”统一转换为布尔状态。完成后,你能避免因接法不同而把按下和松开判断写反。
学习目标
- 能根据按键接法选择上拉或下拉输入
- 能使用
HAL_GPIO_ReadPin读取当前引脚电平 - 能正确处理高电平有效与低电平有效的差异
理解上拉、下拉与有效电平
输入引脚悬空时容易受噪声影响,因此未按下状态必须由上拉或下拉电阻固定。内部上拉使引脚默认读取高电平,按键按下后接地,通常属于低电平有效;内部下拉使引脚默认读取低电平,按下后接到电源,通常属于高电平有效。

下文以 PA0、内部上拉、按下接地为例。此时松开读取 GPIO_PIN_SET,按下读取 GPIO_PIN_RESET。
配置按键输入
在 STM32CubeMX 中把按键引脚设置为 GPIO_Input,并选择 Pull-up。如果板上已经有外部上拉电阻,可选择无上下拉,避免内部电阻改变原有电路特性。
手动初始化代码如下。该片段依赖 CubeMX 生成的 HAL 工程,并假设按键连接在 PA0。
static void BUTTON_GPIO_Init(void)
{
GPIO_InitTypeDef gpio = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();
gpio.Pin = GPIO_PIN_0;
gpio.Mode = GPIO_MODE_INPUT;
gpio.Pull = GPIO_PULLUP;
HAL_GPIO_Init(GPIOA, &gpio);
}生效行为:未按下时 PA0 被内部上拉保持为高电平;按下并接地时读取低电平。可用万用表测量引脚电压验证,松开时应接近 3.3 V,按下时应接近 0 V。
读取并统一按键状态
HAL_GPIO_ReadPin 返回 GPIO_PIN_SET 或 GPIO_PIN_RESET。建议立即把物理电平转换成“是否按下”,后续逻辑只处理布尔语义,避免把有效电平散落在各处。
static bool BUTTON_IsPressed(void)
{
// 上拉输入且按下接地,所以低电平表示按下
return HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET;
}该函数需要在文件顶部包含布尔类型定义。
#include <stdbool.h>
#include "main.h"预期结果
按键松开:BUTTON_IsPressed() 返回 false
按键按下:BUTTON_IsPressed() 返回 true加入最小消抖处理
机械按键在按下和释放瞬间会产生数毫秒的电平抖动。若直接循环读取,程序可能把一次按下识别为多次。最简单的方法是检测到按下后延时,再次确认电平。
下面代码为片段示例,适合低频人机按键;它会在确认一次按下后等待释放,避免重复触发。
if (BUTTON_IsPressed())
{
HAL_Delay(20);
if (BUTTON_IsPressed())
{
HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_0);
// 等待释放,防止一次长按被反复识别
while (BUTTON_IsPressed())
{
}
}
}预期结果
每完整按下并释放一次按键,LED 只翻转一次状态。这种阻塞式消抖实现简单,但等待期间 CPU 不能处理其他任务。需要同时处理通信、界面或实时控制时,应改用定时器或系统节拍实现非阻塞状态机。
处理不同有效电平
若使用下拉输入并让按键按下时接 3.3 V,初始化应改为 GPIO_PULLDOWN,判断条件也应改为 GPIO_PIN_SET。硬件接法、上下拉选择和有效电平必须三者一致,否则可能出现未按下时随机触发或逻辑完全相反。
调试时可先直接读取原始电平,再检查松开和按下是否分别稳定为预期值。确认物理电平正确后,再封装 BUTTON_IsPressed(),这样能快速区分接线问题与程序判断问题。