3. 软件消抖核心算法：基于状态机的按键消抖原理

按键消抖这件事，说白了就是跟物理世界的「不完美」做斗争。机械按键按下时，金属触点会弹跳几次，就像乒乓球落地一样。这个弹跳时间通常持续 5-20ms，如果不处理，一次按键会被误认为多次触发。

我个人习惯用状态机来处理消抖。为什么？因为状态机逻辑清晰，可读性强，而且很容易移植到不同的项目中。你想想看，按键的状态无非就是三种：闲着、正在抖动、已经稳定。这不正好对应一个三态状态机吗？

3.1 三态状态机设计

我设计的这个状态机，包含三个核心状态：

空闲态（IDLE）：按键没有被按下，输出为高电平。等待按键按下。
抖动态（DEBOUNCE）：检测到按键电平变化，进入消抖计时。这个阶段不输出任何有效信号。
稳定态（STABLE）：消抖计时结束，按键电平稳定。输出有效的按键信号。

嗯，这里要注意：抖动态是核心。我在项目中遇到过，有些工程师直接把消抖计时放在空闲态里做，结果导致按键响应延迟很大。正确的做法是：只有检测到电平变化才启动计时，而不是一直计时。

核心思想：状态机只在电平跳变时启动消抖计时，而不是周期性轮询。这样可以最大程度降低 CPU 占用率。

3.2 状态转移图

下面我用 SVG 画了一张状态转移图，把整个逻辑串起来。你看一眼就明白了：

3.3 状态机实现代码

下面是我在实际项目中用过的 Verilog 代码。这段代码我优化过很多次，目前已经稳定运行在多个量产产品中。

// 三态按键消抖状态机
module key_debounce_fsm (
    input  wire       clk,          // 系统时钟，假设 50MHz
    input  wire       rst_n,        // 异步复位，低有效
    input  wire       key_in,       // 按键输入，低电平有效
    output reg        key_out,      // 消抖后输出，低电平有效
    output reg        key_pulse     // 按键按下脉冲，持续一个时钟周期
);

// 状态编码
localparam IDLE     = 2'b00;
localparam DEBOUNCE = 2'b01;
localparam STABLE   = 2'b10;

// 消抖计时器参数
// 20ms 消抖时间，50MHz 时钟 = 1_000_000 个周期
localparam DEBOUNCE_CNT_MAX = 20'd1_000_000;

reg [1:0] state, next_state;
reg [19:0] debounce_cnt;
reg key_in_sync;  // 同步后的按键输入

// 两级同步，消除亚稳态
reg key_in_d1, key_in_d2;
always @(posedge clk or negedge rst_n) begin
    if (!rst_n) begin
        key_in_d1 <= 1'b1;
        key_in_d2 <= 1'b1;
    end else begin
        key_in_d1 <= key_in;
        key_in_d2 <= key_in_d1;
    end
end

assign key_in_sync = key_in_d2;

// 状态转移
always @(posedge clk or negedge rst_n) begin
    if (!rst_n)
        state <= IDLE;
    else
        state <= next_state;
end

// 次态逻辑
always @(*) begin
    next_state = state;
    case (state)
        IDLE: begin
            if (key_in_sync == 1'b0)  // 检测到按键按下
                next_state = DEBOUNCE;
        end
        DEBOUNCE: begin
            if (debounce_cnt == DEBOUNCE_CNT_MAX - 1)
                next_state = STABLE;
            // 如果按键在消抖过程中释放，回到空闲态
            else if (key_in_sync == 1'b1)
                next_state = IDLE;
        end
        STABLE: begin
            if (key_in_sync == 1'b1)  // 检测到按键释放
                next_state = IDLE;
        end
        default: next_state = IDLE;
    endcase
end

// 计时器逻辑
always @(posedge clk or negedge rst_n) begin
    if (!rst_n)
        debounce_cnt <= 20'd0;
    else if (state == DEBOUNCE)
        debounce_cnt <= debounce_cnt + 1'b1;
    else
        debounce_cnt <= 20'd0;
end

// 输出逻辑
always @(posedge clk or negedge rst_n) begin
    if (!rst_n) begin
        key_out   <= 1'b1;
        key_pulse <= 1'b0;
    end else begin
        key_out <= (state == STABLE) ? 1'b0 : 1'b1;
        // 进入稳定态时产生一个脉冲
        if (state == DEBOUNCE && next_state == STABLE)
            key_pulse <= 1'b1;
        else
            key_pulse <= 1'b0;
    end
end

endmodule

我的经验：这段代码里我用了两级同步寄存器来处理按键输入。为什么？因为按键信号来自外部，和系统时钟不同步，直接采样会引入亚稳态。我曾经在一个项目中偷懒没做同步，结果按键偶尔会误触发，排查了两天才找到原因。从那以后，所有异步输入我都老老实实做两级同步。

3.4 状态机设计要点

基于状态机的消抖算法，有几个关键点需要特别注意：

消抖时间的选择：一般机械按键的弹跳时间是 5-20ms。我习惯取 20ms 作为消抖时间，这样兼容性最好。如果按键质量较差，可以适当延长到 30ms。
计时器的复位时机：只有在抖动态才启动计时。如果在空闲态或稳定态，计时器必须清零。否则会出现「累计计时」的问题，导致消抖时间不准确。
按键释放的处理：有些设计只处理按键按下，不处理释放。我个人建议把释放也纳入状态机管理，这样可以避免「长按」时产生的误判。
脉冲信号的生成：很多应用只需要一个按键按下的脉冲信号，而不是持续的电平信号。我在代码里专门生成了一个 key_pulse 信号，只在进入稳定态时产生一个时钟周期的脉冲。

避坑指南：我曾经在一个项目中，把消抖计时器设计成「只要按键按下就一直计时」。结果按键按了 1 秒，计时器溢出了，状态机误判为消抖结束。后来我改成「只在抖动态计时」，问题就解决了。记住：计时器一定要和状态绑定，不能独立运行。

3.5 状态机 vs 延时消抖

你可能要问：为什么非要用状态机？直接用延时消抖不行吗？

我对比一下这两种方法：

对比项	状态机消抖	延时消抖
资源占用	需要几个寄存器，资源极少	需要定时器，资源稍多
响应速度	快，检测到变化立即启动消抖	慢，需要等待固定延时
可读性	逻辑清晰，容易维护	逻辑简单，但扩展性差
适用场景	所有按键场景，特别是多按键	简单单按键，对响应不敏感
抗干扰能力	强，状态机天然抗抖动	弱，容易受噪声影响

说白了，状态机消抖就是「用逻辑换可靠性」。虽然代码量比延时消抖多几行，但换来的是稳定可靠的按键检测。我在 FPGA 项目中，所有按键处理都统一用状态机实现，从来没有出过问题。

总结一下：三态状态机消抖的核心就是「空闲-抖动-稳定」三个状态的循环。空闲态等待按键按下，抖动态进行消抖计时，稳定态输出有效信号。这个设计模式简单、可靠、可复用，是我个人最推荐的按键消抖方案。

嗯，关于状态机消抖的原理和实现，就讲到这里。代码你可以直接拿去用，但建议根据实际时钟频率调整消抖时间参数。下一节我们会把这个状态机封装成 AXI 接口的外设，让它能挂到总线上被 CPU 访问。

📚 课程目录

3. 软件消抖核心算法：基于状态机的按键消抖原理

3.1 三态状态机设计

3.2 状态转移图

3.3 状态机实现代码

3.4 状态机设计要点

3.5 状态机 vs 延时消抖