企业官网建设流程全解析

• 嵌入式
• 语言运行时
• 编程语言
• 解释器
• 编译器
• 物联网
• 系统编程

按键去抖是嵌入式开发中绕不开的基础话题。本指南以 MicroPython pyboard 的 GPIO 输入为场景，讲解机械开关按下/释放瞬间产生的信号抖动现象，并给出一个基于软件采样的去抖函数wait_pin_change，它要求引脚电平连续稳定 20ms 才认为状态变化有效。读完本文，你将理解抖动的成因、硬件去抖与软件去抖的取舍，掌握可直接复制到 pyboard 上运行的去抖代码，并能根据实际开关噪声调整采样窗口参数。

一、为什么需要去抖：机械开关的“真实谎言”

当我们将一个开关或按键接入 pyboard 的 GPIO 引脚作为输入时，得到的信号并不是干净利落的低↔高跳变。机械开关的簧片在物理接触的瞬间会发生多次弹跳（bounce），导致引脚电平在按下或释放的几毫秒到几十毫秒内快速、不规则地在高低电平之间震荡。pyb.Pin.value()在这种状态下读取，可能在同一“次”按键中连续读到0 → 1 → 0 → 1的变化，从而让程序把一次按键误判成多次触发。

原文档 debounce.rst 明确描述了这一现象：引脚作为开关输入时会有大量噪声，在按下或释放的瞬间迅速在低高之间变化。消除噪声有两条技术路线：

• 硬件去抖：在开关与引脚之间并联电容，构成 RC 低通滤波（去抖电路），把高频弹跳信号“抹平”成平滑的边沿；
• 软件去抖：编写一个简单函数，反复读取引脚电平，只有当新值持续稳定一段时间后才认可这次变化——这正是本指南要实现的方案。

软件去抖不增加任何元器件，适用于原型验证和大多数按键场景，是 pyboard 教程给出的首选入门方案。

二、核心实现：wait_pin_change软件去抖函数

文档给出的去抖函数完整代码如下，其设计思路是：记录当前引脚值，然后持续轮询，每当引脚值发生变化就累计“稳定计数”，一旦计数达到 20（对应连续 20ms 稳定）即确认状态变化并返回；一旦再次读到旧值则计数清零，重新开始。

import pyb def wait_pin_change(pin): # wait for pin to change value # it needs to be stable for a continuous 20ms cur_value = pin.value() active = 0 while active < 20: if pin.value() != cur_value: active += 1 else: active = 0 pyb.delay(1)

逐行拆解工作原理

这个算法的本质是滑动窗口确认：它不是记录“第一次变化”就立即返回，而是要求新电平在连续 20 次采样（20ms）内一次都不回弹，才断定这是真实的状态切换。任何一次回弹都会把active清零，从而滤掉机械抖动的毛刺。

关于采样基准的说明

函数内部以“旧值”为基准来判断变化方向，因此它既适用于“按下时由低变高”（如接上拉电阻的按键），也适用于“按下时由高变低”（如接下拉电阻的按键），无需针对边沿方向单独写两套逻辑。调用返回时，引脚电平即处于新的稳定状态。

三、完整使用示例：按键切换 LED

文档给出的配套用法如下：把 X1 引脚配置为带下拉电阻的输入，然后无限循环等待引脚电平稳定变化，每次变化就翻转绿色 LED（pyb.LED(4)）：

import pyb pin_x1 = pyb.Pin('X1', pyb.Pin.IN, pyb.Pin.PULL_DOWN) while True: wait_pin_change(pin_x1) pyb.LED(4).toggle()

这里的关键参数在 pyb.Pin 参考文档 中有完整定义：

• pyb.Pin.IN：将引脚配置为输入模式；
• pyb.Pin.PULL_DOWN：使能内部下拉电阻，未按下时引脚被拉至 GND，读到 0；按下后开关将引脚接到 3V3，读到 1。下拉使能时，引脚上等效有一个约 40kΩ 电阻接地（例外：Y5 引脚为 11kΩ，详见 pyb.Pin.rst 的 pull 参数说明）；
• pyb.Pin('X1', ...)：字符串 'X1' 会依次经过用户映射函数、用户映射字典、板载引脚名、CPU 端口/引脚名的解析顺序，最终映射到具体的 GPIO（见 pyb.Pin.rst 的映射顺序说明）。

pyb.LED(4).toggle()中的 LED 编号 1~4 对应板载红、绿、橙、蓝四颗 LED，toggle()每次调用翻转一次亮灭状态；若希望按键控制特定 LED 开关，可改用pyb.LED(4).on()或pyb.LED(4).off()，LED 用法详见 leds.rst。

把上面两段代码合并保存为板上的main.py，软复位（Ctrl-D）后即可运行：每按一次按键，LED 翻转一次，弹跳噪声不会再引起多余的翻转。

运行前提

• 需要一块 pyboard（PYBv1.0 等）及 USB 连接线，教程前提与环境准备参见 pyboard 教程首页；
• pyb模块是 pyboard（ports/stm32）专用模块，本示例不适用于 Unix 桌面移植版；跨平台通用输入应使用machine.Pin，其去抖思路与本例完全一致。

四、参数调节：从 20ms 到 50ms

文档特别说明：去抖窗口是可调的，如果仍有噪声，可以把 20ms 调到 50ms。这意味着两处修改：

1. 把while active < 20:中的20改为50（假设仍配合pyb.delay(1)的 1ms 采样间隔）；
2. 保持采样间隔与计数阈值的时间乘积等于期望窗口，例如pyb.delay(2)配active < 25同样得到 50ms 窗口。

选参原则：窗口太短（如 <5ms）无法覆盖簧片弹跳期，去抖失效；窗口太长会明显增加按键响应延迟（每次按键要等满窗口才被确认），且长按场景下连击节奏会被过滤。常见机械开关弹跳期为 5~20ms，因此 20ms 是兼顾可靠性与响应速度的常用起点，若实测仍有毛刺再逐级加大。

五、原理佐证：从源码看pyb.delay与引脚配置

去抖函数的两个核心依赖——延时与引脚读写——都能在仓库源码中找到直接实现：

• pyb.delay(ms)：在 ports/stm32/modpyb.c 中，pyb.delay直接映射到mp_time_sleep_ms（见该文件中{ MP_ROM_QSTR(MP_QSTR_delay), MP_ROM_PTR(&mp_time_sleep_ms_obj) }），即以毫秒为单位的忙等延时，保证wait_pin_change中每次采样间隔精确为 1ms；
• Pin.value()：无参数调用时返回引脚当前数字逻辑电平 0 或 1（见 pyb.Pin.rst 的value()方法说明）；
• 上下拉常量：Pin.PULL_UP、Pin.PULL_DOWN、Pin.PULL_NONE在 ports/stm32/pin.c 中分别映射到 STM32 HAL 的GPIO_PULLUP、GPIO_PULLDOWN、GPIO_NOPULL，与芯片寄存器直接对应，说明下拉/上拉是在硬件层完成的，不占用额外 GPIO。

由此可见，wait_pin_change是纯软件算法，但依赖底层精确的毫秒延时与可靠的引脚电平读取，这两点均由 pyboard 固件层保证。

六、进阶：与中断方案的取舍

除了轮询式软件去抖，pyboard 还提供了中断驱动方案。在 switch.rst 教程中，板载 USR 按键可通过sw.callback(f)注册回调函数，固件会在引脚下降沿触发外部中断并异步执行回调。两种方案各有适用场景：

• 轮询去抖（本文方案）：逻辑直观、可控性强，适合在主循环中“等待某个按键动作”的交互模式；代价是去抖期间 CPU 忙等，无法并行处理其他任务；
• 中断回调：事件驱动、不阻塞主流程，适合需要及时响应按键且回调内只做极简操作（如置标志位、翻转 LED）的场景；回调函数不允许分配内存，不能创建列表/元组，复杂逻辑应通过标志位交给主循环处理（详见 switch.rst 的约束说明）。

实际工程中二者常结合使用：中断里只记录“发生了事件”，主循环中再用本文的去抖逻辑确认事件的真实性，兼顾实时性与抗干扰能力。

七、总结

本文以 pyboard 教程的 debounce.rst 为骨架，完整给出了软件去抖函数wait_pin_change及其使用示例，并从抖动成因、20ms 窗口的选参依据、pyb.delay/上下拉常量等源码实现三个层面做了展开。核心要点可概括为：

1. 机械开关的弹跳会造成引脚电平快速抖动，需经硬件（RC 电容）或软件（稳定窗口采样）方式消除；
2. wait_pin_change通过“连续 20 次采样均保持新值”来确认状态变化，任一回弹即清零重计；
3. 去抖窗口可按需调整（如 50ms），原则是覆盖弹跳期且不牺牲响应速度；
4. 轮询去抖与中断回调各有取舍，复杂系统可组合使用。

掌握这个模式后，你可以将其泛化到任意 GPIO 按键、编码器边沿检测乃至多按键矩阵中去抖，是 pyboard 及 MicroPython 各类开发板输入处理的基础功。

• 嵌入式
• 语言运行时
• 编程语言
• 解释器
• 编译器
• 物联网
• 系统编程