嵌入式C++实践开发第21篇（单片机实践）：按钮输入 —— 硬件原理、消抖与HAL API

嵌入式C实践开发第21篇单片机实践按钮输入 —— 硬件原理、消抖与HAL API仓库已经开源仍然在持续建设中喜欢的话点个⭐相关的链接如下https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeModernCPP静态网页直接阅览https://awesome-embedded-learning-studio.github.io/Tutorial_AwesomeModernCPP/承接上一篇GPIO 输入路径已经搞清楚了——上拉输入、施密特触发器、IDR 寄存器。这一篇我们把理论落地画接线图、算电流面对机械抖动问题然后用 HAL API 读取按钮状态。我们的接线方案在 LED 教程里我们用的硬件是 Blue Pill 板上自带的 LED——连接在 PC13 上不需要任何外部接线。按钮不一样——Blue Pill 上没有板载的用户按键复位按钮是 NRST 引脚专用的不能当通用按钮用所以你需要自己接一个按钮。接线方案如下STM32F103C8T6 内部 ┌─────────────────────┐ │ │ │ VDD (3.3V) │ │ │ │ │ [R_pullup ~40kΩ] │ │ │ │ │ ├──── PA0 ─────┤─── 排针 PA0 │ │ │ │ │ │ GND ────────────┤─── 排针 GND │ │ └─────────────────────┘ 外部接线 PA0 排针 ──┤ 按钮 ├─── GND 排针 松开按钮PA0 通过内部上拉电阻接到 VDD → 读到高电平 (1) 按下按钮PA0 直接接到 GND → 读到低电平 (0)就这么简单——按钮的两根线分别插到 Blue Pill 排针上的 PA0 和 GND 孔位。不需要电阻、不需要电容、不需要任何其他元件。STM32 内部的 40kΩ 上拉电阻帮我们搞定了默认电平的问题。电流计算按下按钮时电流从 VDD3.3V经内部上拉电阻约 40kΩ流向 GNDI VDD / R_pullup 3.3V / 40000Ω 82.5μA82.5 微安。这个电流非常小——STM32 的每个引脚最大能承受 25mA 的电流82.5μA 只是额定值的 0.3%。而且按钮按下的时间通常很短几百毫秒级别对功耗的影响可以忽略。即使在电池供电的项目中这个电流也完全不是问题。为什么选 PA0上一篇我们提到了选 PA0 的原因EXTI0 有独立的中断向量。这里再补充一个实际原因——PA0 在 Blue Pill 排针上的位置很好找。Blue Pill 板子右侧的排针上PA0 通常在最上面几个位置旁边的 GND 引脚也很近用一根短杜邦线就能接好。如果你手边只有 4 脚的轻触按键也不用担心——4 脚按键的对角两脚是连通的同一个触点相邻两脚之间才是开关。你只需要选对角的两脚分别接 PA0 和 GND 就行。对比方案下拉接法作为参考还有一种下拉接法STM32F103C8T6 内部 ┌─────────────────────┐ │ │ │ [R_pulldown ~40kΩ]│ │ │ │ │ ├──── PA0 ─────┤─── 排针 PA0 │ │ │ │ VDD ────────────┤─── 排针 3.3V │ │ └─────────────────────┘ 外部接线 PA0 排针 ──┤ 按钮 ├─── 3.3V 排针 松开按钮PA0 通过内部下拉电阻接到 GND → 读到低电平 (0) 按下按钮PA0 直接接到 VDD → 读到高电平 (1)下拉方案是高电平有效Active High——松开低按下高。对应代码中的ButtonActiveLevel::High。我们不用下拉方案原因有三(1) 上拉方案中按钮接地GND 在板子上到处都是接线更方便(2) 绝大多数 MCU 开发资料默认用上拉方案社区资源更丰富(3) 如果按钮线被意外拉断或脱落上拉方案引脚回到高电平安全状态而浮空的引脚电平不确定可能导致误触发。机械抖动按钮的原罪接好了线理论上按钮应该产生理想的信号按下瞬间从高电平干净地跳到低电平松开瞬间从低电平干净地跳回高电平。就像这样理想的按钮信号 高 ───────────┐ ┌─────────── │ │ 低 └─────────────────┘ │← 按下 →│← 松开 →│但现实中机械开关不是理想器件。按钮内部的金属触点在闭合和断开的瞬间由于弹簧效应和金属弹性会经历一个短暂的弹跳过程——触点反复接触、断开、再接触直到最终稳定。用示波器看实际信号是这样的实际的按钮信号按下瞬间 高 ───┐ ┌┐ ┌┐ ┌┐ ┌───────────── │ ││ ││ ││ │ 低 └──┘└─┘└──┘└──┘ │← 5~20ms →│ 抖动区间 最终稳定为低电平 实际的按钮信号松开瞬间 低 ─────────────┐ ┌┐ ┌┐ ┌───── │ ││ ││ │ 高 └──┘└─┘└──┘ │← 5~20ms →│ 抖动区间 最终稳定为高电平抖动的持续时间取决于开关的物理特性——便宜的轻触按键可能抖 10-15ms质量好的可能只有 2-5ms。但几乎不存在完全不抖动的机械开关。不处理的后果如果代码不处理抖动直接在主循环中读取引脚状态会发生什么假设主循环每 1ms 执行一次对于 72MHz 的 STM32 来说绰绰有余。按下按钮的 10ms 抖动期间CPU 可能采样到这样的序列采样 1 1 0 1 0 0 1 0 0 0 0 0 0 0 ... ↑ ↑ ↑ ↑ 按下 抖动中的假释放和假按下CPU 看到的是高→低→高→低→高→低→低→低→低… 它会认为按钮被按下了三四次而不是一次。如果你的代码是每次按下切换 LED 状态那你会发现按一次按钮LED 可能亮、可能灭、可能根本没反应——因为多次翻转互相抵消了。这不是理论推演——你可以很容易地验证。写一个最简单的轮询程序不加任何消抖然后快速按一下按钮用计数器记录检测到的按下次数。你会发现一次按压被计了 2-5 次偶尔甚至是 7-8 次。软件消抖我们的路线软件消抖的核心思想很简单不信任第一次采样。检测到引脚电平变化后不立即认为状态变了而是等一段时间再采样确认。如果连续多次采样结果一致才认为状态真正发生了变化。具体实现有几种方式我们会逐步演进阻塞延时消抖检测到变化后HAL_Delay(20)等待然后再采样。简单但有代价——CPU 被阻塞 20ms什么都干不了。非阻塞时间戳消抖用HAL_GetTick()记录变化时间每次循环检查是否已经过了足够长的时间。不阻塞 CPU但需要手动管理状态变量。状态机消抖用 7 个状态的有限状态机来精确管理整个消抖和事件检测过程。这是最可靠的方案。每一种都是前一种的自然演进——先用最简单的方式解决问题看到问题后用更好的方式解决。这种先脏后净的学习路径比直接给出最终方案要好得多因为你理解了每一步的为什么。从输出 API 到输入 APILED 教程中我们用了三个 HAL 函数来控制 LED操作HAL 函数操作的寄存器初始化引脚HAL_GPIO_Init()CRL/CRH写引脚电平HAL_GPIO_WritePin()ODR/BSRR翻转引脚电平HAL_GPIO_TogglePin()ODR/BSRR按钮只需要两个一个初始化一个读取。操作HAL 函数操作的寄存器初始化引脚HAL_GPIO_Init()CRL/CRH读引脚电平HAL_GPIO_ReadPin()IDRHAL_GPIO_Init()在 LED 教程中已经拆解过了——它把GPIO_InitTypeDef结构体中的配置翻译成 CRL/CRH 寄存器的位域操作。按钮初始化和 LED 初始化用的是同一个函数只是参数不同。输入模式初始化GPIO_InitTypeDef 的输入配置LED 的初始化代码是这样的GPIO_InitTypeDef init{0};init.PinGPIO_PIN_13;init.ModeGPIO_MODE_OUTPUT_PP;// 推挽输出init.PullGPIO_NOPULL;init.SpeedGPIO_SPEED_FREQ_LOW;HAL_GPIO_Init(GPIOC,init);按钮的初始化只需要改两个参数GPIO_InitTypeDef init{0};init.PinGPIO_PIN_0;init.ModeGPIO_MODE_INPUT;// 通用输入init.PullGPIO_PULLUP;// 内部上拉init.SpeedGPIO_SPEED_FREQ_LOW;// 输入模式下 Speed 无意义但需要填值HAL_GPIO_Init(GPIOA,init);三个值得注意的地方第一Mode从GPIO_MODE_OUTPUT_PP变成了GPIO_MODE_INPUT。这对应 CRL 寄存器中MODE[1:0] 00输入模式和CNF[1:0] 10上拉/下拉输入。第二Pull从GPIO_NOPULL变成了GPIO_PULLUP。这启用内部上拉电阻同时在 ODR 对应位写 1 来选择上拉方向。第三Speed在输入模式下没有实际意义。Speed 控制输出驱动器的翻转速率——输入模式下输出驱动器是断开的所以这个参数不影响任何行为。但 HAL 要求你填一个值随便填就行。别忘了时钟和输出一样使用任何 GPIO 端口之前必须先使能对应的时钟。PA0 在 GPIOA 上所以__HAL_RCC_GPIOA_CLK_ENABLE();如果你忘了这一步HAL_GPIO_Init()调用不会报错它不知道你有没有开时钟但写入的配置不会生效——引脚保持复位状态浮空输入读出来的值是不确定的。这是新手最常见的坑之一。LED 教程中我们用if constexpr在编译时自动选择时钟使能宏按钮教程的 Button 模板类会复用同样的机制。但如果你用 C 语言写记得手动调用。HAL_GPIO_ReadPin函数签名GPIO_PinStateHAL_GPIO_ReadPin(GPIO_TypeDef*GPIOx,uint16_tGPIO_Pin);两个参数GPIOx指定端口GPIOA、GPIOB、GPIOC…GPIO_Pin指定引脚编号GPIO_PIN_0~GPIO_PIN_15。返回值是GPIO_PinState枚举typedefenum{GPIO_PIN_RESET0,// 低电平GPIO_PIN_SET1// 高电平}GPIO_PinState;底层实现HAL 库的HAL_GPIO_ReadPin()实现非常简洁GPIO_PinStateHAL_GPIO_ReadPin(GPIO_TypeDef*GPIOx,uint16_tGPIO_Pin){GPIO_PinState bitstatus;if((GPIOx-IDRGPIO_Pin)!(uint32_t)GPIO_PIN_RESET){bitstatusGPIO_PIN_SET;}else{bitstatusGPIO_PIN_RESET;}returnbitstatus;}核心就是一个位操作GPIOx-IDR GPIO_Pin。IDR是 16 位只读寄存器每个 bit 对应一个引脚。GPIO_PIN_0的值是0x0001所以IDR 0x0001就是取 bit 0 的值。如果不为 0引脚是高电平否则是低电平。几个时钟周期就能完成LDR AND CMP编译器优化后约 2-4 个周期。72MHz 的 CPU 意味着读引脚状态只需要约数十纳秒。和 WritePin 的对比HAL_GPIO_WritePin()操作的是 BSRR 寄存器Bit Set/Reset Register这是一个只写的寄存器——写 1 到低 16 位会复位清零对应的 ODR bit写 1 到高 16 位会置位设一对应的 ODR bit。这是一种原子操作不需要读-改-写的三步过程。HAL_GPIO_ReadPin()操作的是 IDR 寄存器只读直接返回引脚电平。输出 (LED)输入 (按钮)初始化GPIO_MODE_OUTPUT_PPGPIO_MODE_INPUT核心操作HAL_GPIO_WritePin()→ BSRRHAL_GPIO_ReadPin()→ IDR寄存器属性BSRR 只写IDR 只读操作耗时1 个时钟周期1 个时钟周期read_pin_state()我们的 C 封装在device/gpio/gpio.hpp中我们给 GPIO 模板类新增了read_pin_state()方法[[nodiscard]]Stateread_pin_state()const{returnstatic_castState(HAL_GPIO_ReadPin(native_port(),PIN));}这里有几个设计决策需要解释。为什么返回 State 枚举而不是 bool你可以争论说返回bool更简单——true是高电平false是低电平。但我们选择返回State枚举State::Set和State::UnSet和输出端的set_gpio_pin_state(State)保持对称。这样输入和输出用的是同一套类型代码风格一致。而且State枚举比bool更不容易被误用。如果你有多个引脚要操作bool的true/false含义在不同上下文中可能混淆——true是按下还是松开取决于上拉还是下拉。但State::Set永远表示引脚为高电平State::UnSet永远表示低电平不含歧义。为什么加 [[nodiscard]][[nodiscard]]告诉编译器这个函数的返回值不应该被忽略。如果你写了button.read_pin_state();但没有使用返回值编译器会发出警告。读引脚状态的唯一目的就是获取返回值。如果你调用了read_pin_state()却不使用结果那这个调用百分之百是写错了——多半是忘写赋值语句了。在嵌入式开发中这类低级错误如果不被抓出来可能导致按钮状态没被检测到系统行为异常且难以调试。static_cast 的零开销HAL_GPIO_ReadPin()返回GPIO_PinState0 或 1static_castState()把它转成State::Set或State::UnSet。static_cast在枚举之间的转换是纯编译时操作——底层值0 或 1不变只是类型信息变了。生成的机器码和直接用GPIO_PinState完全一样。const 成员函数read_pin_state()被声明为const——它不修改对象的任何成员变量。这是只读操作在 C 中的标准表达方式。对比set_gpio_pin_state()也被声明为const——这是因为我们的 GPIO 模板类没有成员变量需要修改所有的状态都存在于硬件寄存器中而不是 C 对象里。最小的 C 语言示例在进入完整的轮询程序之前先用一个最小的 C 代码片段验证一下能不能读到按钮状态#includestm32f1xx_hal.hintmain(void){HAL_Init();/* 系统时钟配置省略 *//* 使能 GPIOA 时钟 */__HAL_RCC_GPIOA_CLK_ENABLE();/* 配置 PA0 为上拉输入 */GPIO_InitTypeDef init{0};init.PinGPIO_PIN_0;init.ModeGPIO_MODE_INPUT;init.PullGPIO_PULLUP;HAL_GPIO_Init(GPIOA,init);/* 同时配置 PC13 为推挽输出控制 LED */__HAL_RCC_GPIOC_CLK_ENABLE();GPIO_InitTypeDef led_init{0};led_init.PinGPIO_PIN_13;led_init.ModeGPIO_MODE_OUTPUT_PP;led_init.SpeedGPIO_SPEED_FREQ_LOW;HAL_GPIO_Init(GPIOC,led_init);while(1){/* 读取 PA0 状态 */GPIO_PinState stateHAL_GPIO_ReadPin(GPIOA,GPIO_PIN_0);if(stateGPIO_PIN_RESET){/* 按钮按下低电平 → 点亮 LEDPC13 低电平有效 */HAL_GPIO_WritePin(GPIOC,GPIO_PIN_13,GPIO_PIN_RESET);}else{/* 按钮松开高电平 → 熄灭 LED */HAL_GPIO_WritePin(GPIOC,GPIO_PIN_13,GPIO_PIN_SET);}}}这段代码做了四件事(1) 使能 GPIOA 和 GPIOC 时钟(2) 配置 PA0 为上拉输入(3) 配置 PC13 为推挽输出(4) 主循环中读取 PA0 并控制 PC13。⚠️ 注意这段代码没有消抖。快速按一下按钮LED 可能会闪好几次。后续文章会看到这个问题的完整演示和解决方案。如果你把这段代码烧到板子上按住按钮时 LED 亮松开时 LED 灭。最基本的输入输出交互就这样实现了。硬件准备清单总结一下你需要的硬件Blue Pill 开发板— 和 LED 教程同一块不需要换ST-Link V2 调试器— 和 LED 教程一样一个按钮开关— 最普通的轻触按键tactile switch2 脚或 4 脚都行一到两根杜邦线— 用来连接按钮和排针PA0 和 GND 在排针上不一定相邻通常需要杜邦线跳接接线只有两根按钮一端 → PA0按钮另一端 → GNDPC13 板载 LED 保持不变不需要额外接线。⚠️ 如果你手边确实没有按钮开关可以用一根杜邦线模拟——一端插 PA0另一端碰一下 GND 再松开。效果和按钮一样只是没有弹簧回弹抖动可能会少一些但仍然会有。本章小结这一篇从硬件接线讲到了软件 API。核心要点硬件接线上拉方案最简单按钮接 PA0 和 GND电流只有 82.5μA机械抖动真实按钮在按下和松开时会产生 5-20ms 的电平震荡必须用软件消抖处理输入初始化GPIO_MODE_INPUTGPIO_PULLUP两个参数就够了读引脚 APIHAL_GPIO_ReadPin()底层就是读 IDR 寄存器一个时钟周期我们的封装read_pin_state()返回类型安全的State枚举带[[nodiscard]]防止误用下一篇我们会学习完整的轮询程序亲眼看到没有消抖会发生什么然后一步步实现可靠的消抖算法。相关阅读第19篇从输出到输入 —— 为什么按钮比 LED 难 - 相似度 100%第15篇第三次重构 —— if constexpr让时钟使能在编译时自动选对 - 相似度 67%第17篇C23特性收尾 —— 属性、链接与零开销抽象的最终证明 - 相似度 67%