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

用上拉输入读取机械按键状态

用上拉输入读取机械按键状态

把机械按键接入 STM32 GPIO 后,需要让松开和按下分别对应稳定的数字电平。本节以 STM32F4 的 PA0 引脚为例,使用内部上拉和 HAL 库读取按键状态,通过调试器与电压测量验证结果,并解释为什么浮空输入会产生不可靠的读数。

学习目标

  • 正确连接低电平有效的机械按键,区分松开和按下时的 GPIO 电平。
  • 使用 GPIO_MODE_INPUT、GPIO_PULLUP 和 HAL_GPIO_ReadPin() 完成按键读取。
  • 通过调试和测量验证内部上拉,识别浮空输入与机械抖动的影响。

接线决定按键的有效电平

本例采用低电平有效接法:按键一端连接 PA0,另一端连接 GND。PA0 在 MCU 内部通过上拉电阻连接到 VDD,因此不需要额外接一根从 PA0 到 3.3 V 的导线。

  • 松开按键:开关断开,内部上拉将 PA0 保持在高电平。
  • 按下按键:开关闭合,PA0 通过按键连接 GND,变为低电平。

内部上拉按键的松开与按下电路对比

对应的逻辑状态如下:

按键状态 PA0 电压 HAL 读取值 业务含义
松开 接近 3.3 V GPIO_PIN_SET 未按下
按下 接近 0 V GPIO_PIN_RESET 已按下

内部上拉通常是数十千欧量级的弱上拉,具体阻值随芯片型号、供电电压和工艺条件变化,应查对应器件的数据手册。它用于定义默认逻辑电平,不适合作为外部负载的供电通路。

使用 HAL 配置并读取 GPIO

下面以 STM32F4 系列、STM32CubeIDE 创建的传统 STM32F4 HAL 工程为环境。工程需包含对应芯片的启动文件、HAL 驱动、SysTick 中断处理和默认链接配置。示例使用复位后的默认系统时钟,不依赖外部晶振。

GPIO 初始化有三个关键设置:

配置项 使用值 作用
GPIO 端口与引脚 GPIOA、GPIO_PIN_0 选择 PA0
输入模式 GPIO_MODE_INPUT 读取数字输入电平
上下拉配置 GPIO_PULLUP 松开时维持高电平

在独立练习工程中,可将以下完整示例作为 Core/Src/main.c 的内容。保留工程已有的 HAL 驱动和启动文件。如果使用 CubeMX 重新生成代码,需注意自定义代码区之外的修改可能被覆盖。

c
#include "stm32f4xx_hal.h"

// 使用全局 volatile 变量,便于调试器持续观察按键状态
volatile uint32_t key_pressed = 0U;

int main(void)
{
    HAL_Init();
    __HAL_RCC_GPIOA_CLK_ENABLE();

    GPIO_InitTypeDef gpio = {0};
    gpio.Pin = GPIO_PIN_0;
    gpio.Mode = GPIO_MODE_INPUT;
    gpio.Pull = GPIO_PULLUP;
    HAL_GPIO_Init(GPIOA, &gpio);

    while (1)
    {
        // 按键连接GND,低电平才代表按下
        GPIO_PinState level = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0);
        key_pressed = (level == GPIO_PIN_RESET) ? 1U : 0U;

        // 每20 ms读取一次;这只是采样间隔,并非完整消抖
        HAL_Delay(20);
    }
}

预期结果(调试器观察到的变量值,并非串口输出):

text
松开按键:key_pressed = 0
按住按键:key_pressed = 1

代码先调用 HAL_Init() 初始化 HAL 基础功能,再使能 GPIOA 外设时钟。没有执行 __HAL_RCC_GPIOA_CLK_ENABLE() 就操作 GPIOA,不符合外设初始化要求。

HAL_GPIO_Init() 将 PA0 配置为带内部上拉的输入引脚。HAL_GPIO_ReadPin() 返回 GPIO_PinState 枚举,而不是已经转换好的业务状态,所以要显式判断 GPIO_PIN_RESET。

这里将按下转换为 1U、松开转换为 0U,便于后续业务代码使用。按键采用相反接法时不能直接照搬该判断条件。

在开发板上验证上拉配置

完成接线后,在 STM32CubeIDE 中执行编译与调试。可按照以下顺序验证:

  1. 确认按键连接 PA0 和 GND,PA0 没有与其他推挽输出直接相连。
  2. 编译工程并启动 Debug 调试,将程序运行起来。
  3. 打开 Window > Show View > Other,找到 Live Expressions 视图,添加全局变量 key_pressed。
  4. 松开按键,观察变量是否保持为 0。
  5. 按住按键超过一个采样周期,观察变量是否变成 1;松开后应恢复为 0。

STM32CubeIDE 的 Live Expressions 需要在调试配置中启用相应功能,实际采样刷新速度也取决于调试连接。如果无法实时刷新,可以使用断点和普通 Expressions 视图查看暂停时的变量值。

还可以用万用表的直流电压档进行交叉验证:黑表笔连接 GND,红表笔测量 PA0。在本例 3.3 V 供电条件下,松开时应接近 3.3 V,按下时应接近 0 V。测量时避免表笔短接相邻管脚。

若松开后仍保持低电平,应依次检查:

  • PA0 是否被外部电路持续拉低,或按键接线是否错误。
  • 初始化中的 gpio.Pull 是否为 GPIO_PULLUP。
  • GPIOA 外设时钟是否已使能,PA0 是否被其他初始化逻辑重新配置。
  • 程序读取的端口、引脚是否与实际接线一致。

浮空输入为什么会误判

当 GPIO 配置为输入且没有上拉、下拉或外部驱动时,该引脚处于高阻抗状态。输入缓冲器仍然检测引脚电压,但此时电压缺乏确定的约束,容易受到寄生电容、漏电流和周围电磁干扰影响。

可以通过一次受控实验理解这一点:

  1. 将示例中的 gpio.Pull 临时修改为 GPIO_NOPULL,重新编译并下载。
  2. 断开 PA0 的按键连接,使引脚没有外部驱动。
  3. 观察 key_pressed,它可能不规律变化,也可能暂时停留在某一个值。
  4. 将配置恢复为 GPIO_PULLUP 并重新运行,即使外部按键断开,变量也应稳定为 0。

浮空不等于必然快速跳变。即使某次测试连续读到高电平,也不能据此证明浮空输入可靠;周围干扰或测试环境改变后,结果可能不同。

如果实际电路采用按键连接 VDD、松开时要求低电平的接法,则应考虑使用 GPIO_PULLDOWN,并将按下判断改为 GPIO_PIN_SET。内部上下拉的选择必须与外部接线保持一致。

此外,机械触点闭合和断开时通常会在短时间内反复接触,产生电平抖动。即使配置了内部上拉,按键仍可能在一次按下过程中产生多次电平变化。

本例中的 HAL_Delay(20) 只是降低轮询频率,不能保证消除抖动。若后续要实现一次按下只触发一次事件,应记录候选状态,并要求该状态连续稳定至少约 20 ms 后才更新确认状态;具体消抖时间需要依据实测按键特性调整。

对于低电平有效按键,最终应同时满足三项检查:松开时输入稳定为高电平、按下时稳定为低电平、程序中的按下判定与实际接线一致。满足这些条件后,才适合继续实现按键边沿检测与事件处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

用上拉输入读取机械按键状态

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

登录哪都通