FPGA 与数字 IC 设计 / 系统课时

演练常见 FPGA 故障排查

演练常见 FPGA 故障排查

FPGA 出现“仿真通过、上板却不工作”时,最危险的做法是立刻改 RTL。更高效的方法是按证据链逐层排除:先确认时钟和复位,再核对约束与引脚,随后检查 CDC 和接口协议,最后才回到功能 RTL。本节用一个最小心跳设计演练这套顺序。

学习目标

  • 能按时钟复位、约束、引脚、CDC、协议、RTL 的固定顺序定位上板故障。
  • 能用最小可观测设计判断问题位于基础硬件链路还是业务逻辑。
  • 能根据仿真、时序报告和片上观测结果建立可复现的故障证据链。

先把失败拆成证据链

“没有输出”只是现象,不是根因。排查时应优先验证最靠近硬件基础的条件,因为后面的协议和 RTL 都依赖前面的时钟、复位与物理连接。只要前一层没有证据证明正常,就不要跳到后一层猜测。

FPGA 上板故障的分层排查流程

一个实用原则是:先证明系统“活着”,再证明系统“做对了事”。因此最小诊断设计通常只保留一个时钟、一个复位和一个可见输出,例如 LED 心跳。若心跳都不正常,UART、SPI、状态机等更高层逻辑暂时没有排查价值。

从时钟和复位开始

下面的诊断顶层把输入复位异步拉低、同步释放,并用系统时钟分频产生心跳。测试平台把时钟频率参数缩小,便于在仿真中快速观察。上板时再把 CLK_HZ 改成板卡真实时钟频率。

verilog
`timescale 1ns/1ps
module fpga_diag_top #(
    parameter integer CLK_HZ = 50_000_000
) (
    input  wire clk,
    input  wire rst_n,
    output reg  heartbeat
);
    reg [1:0] rst_pipe;
    localparam integer HALF_PERIOD = CLK_HZ / 2;
    localparam integer CNT_W = (HALF_PERIOD <= 1) ? 1 : $clog2(HALF_PERIOD);
    reg [CNT_W-1:0] counter;
    wire reset;

    // 异步断言、同步释放,避免复位撤销瞬间在时钟域内产生亚稳风险。
    always @(posedge clk or negedge rst_n) begin
        if (!rst_n)
            rst_pipe <= 2'b00;
        else
            rst_pipe <= {rst_pipe[0], 1'b1};
    end

    assign reset = ~rst_pipe[1];

    // 只保留一个可观测输出,用来证明时钟、复位和基础 RTL 已经工作。
    always @(posedge clk) begin
        if (reset) begin
            counter   <= {CNT_W{1'b0}};
            heartbeat <= 1'b0;
        end else if (counter == HALF_PERIOD - 1) begin
            counter   <= {CNT_W{1'b0}};
            heartbeat <= ~heartbeat;
        end else begin
            counter <= counter + 1'b1;
        end
    end
endmodule

module tb;
    reg clk = 1'b0;
    reg rst_n = 1'b0;
    wire heartbeat;
    integer toggles = 0;
    reg last_hb;

    fpga_diag_top #(.CLK_HZ(10)) dut (
        .clk(clk),
        .rst_n(rst_n),
        .heartbeat(heartbeat)
    );

    always #5 clk = ~clk;

    initial begin
        #25 rst_n = 1'b1;
        repeat (4) @(posedge clk);
        last_hb = heartbeat;

        repeat (40) begin
            @(posedge clk);
            if (heartbeat != last_hb) begin
                toggles = toggles + 1;
                last_hb = heartbeat;
            end
        end

        if (toggles >= 3)
            $display("PASS: heartbeat observed");
        else
            $display("FAIL: heartbeat did not toggle");

        $finish;
    end
endmodule

将代码保存为 fpga_diag.v,在安装了 Icarus Verilog 的环境中执行:

bash
iverilog -g2012 -o fpga_diag_tb fpga_diag.v && vvp fpga_diag_tb

预期输出

text
PASS: heartbeat observed

仿真通过后若板上 LED 仍不闪,优先检查主时钟是否真的到达 FPGA、复位是否长期有效、LED 是否为低电平点亮,以及顶层端口是否与约束文件同名。此时不要通过修改状态机来“碰运气”。

核对约束和引脚

约束错误是“RTL 和行为仿真都正确,但板上完全不对”的高频原因。应同时核对端口名、封装引脚、I/O 电平标准和时钟周期。下面以 Vivado/XDC 语法展示约束形态,属于片段示例;<CLK_PIN>、<RST_PIN>、<LED_PIN> 必须替换为目标板原理图或官方约束中的真实引脚,I/O 标准也必须与 Bank 电压一致。

tcl
set_property PACKAGE_PIN <CLK_PIN> [get_ports clk]
set_property IOSTANDARD LVCMOS33 [get_ports clk]
create_clock -name sys_clk -period 20.000 [get_ports clk]

set_property PACKAGE_PIN <RST_PIN> [get_ports rst_n]
set_property IOSTANDARD LVCMOS33 [get_ports rst_n]

set_property PACKAGE_PIN <LED_PIN> [get_ports heartbeat]
set_property IOSTANDARD LVCMOS33 [get_ports heartbeat]

这里的 20.000 ns 只对应 50 MHz 时钟。验证时至少确认三件事:实现工具识别到了主时钟;I/O 报告中的封装引脚与板卡资料一致;时序分析没有把真正的时钟路径当成未约束路径。若使用差分时钟、专用时钟引脚或其他电压标准,还要按器件手册补充对应属性。

处理 CDC 与接口协议

当心跳正常,但跨时钟域的数据或接口仍异常时,下一步检查 CDC。单比特慢变化状态可使用两级同步器;窄脉冲可能在目标时钟域被漏采,应改用脉冲展宽、toggle 或握手;多比特数据不能给每一位各接两个触发器后就认为安全,通常要使用握手、异步 FIFO 或 Gray 编码等结构。

协议问题则要看“双方是否真的完成一次合法交互”,而不是只看某根数据线有没有跳变。对 UART 检查波特率、空闲电平和帧格式;对 SPI 检查 CPOL、CPHA、片选时序;对 ready/valid 类接口同时观察 valid、ready 和数据稳定窗口。片上逻辑分析仪适合记录这些信号,但探针应围绕一个明确假设添加,避免一次抓几十根无关信号。

现象 优先怀疑 先找的证据
心跳不动 时钟、复位、约束、引脚 时钟报告、复位电平、LED 极性与引脚映射
心跳正常但 UART 静默 TX 引脚、波特率、协议状态 TX 空闲电平、分频计数、发送使能
源时钟域有脉冲,目标域偶发丢失 CDC 同步结构、脉冲宽度、目标域采样
功能偶发错误且温度或频率敏感 时序、CDC setup/hold 裕量、未约束路径、跨域路径

最后才回到 RTL

只有基础条件、约束、引脚、CDC 和协议都已有正常证据,才应集中检查 RTL。此时重点看会导致“仿真像是正确、综合后却不同”的写法,例如未完整赋值导致锁存、组合逻辑形成环路、位宽截断、signed/unsigned 混用、错误的阻塞与非阻塞赋值,以及依赖未初始化寄存器的启动行为。

排查 RTL 时不要同时改多个模块。把设计缩减到“输入刺激 → 一个状态机或数据通路 → 一个可观测结果”,保留能够复现故障的最小路径。每次修改后重新跑行为仿真、综合/实现检查和上板验证,并记录“修改内容、预期影响、实际证据”。这样即使一次修复失败,也能排除一个假设,而不是制造新的变量。

用固定顺序避免无效试错

一套可复用的顺序是:时钟与复位 → 约束 → 引脚 → CDC → 协议 → RTL。如果某一层没有可观察证据,就停在该层继续定位;如果证据正常,再进入下一层。面对“仿真通过但上板失败”,真正提高效率的不是记住更多零散故障,而是始终从最基础、最可验证的条件开始,把每一步都变成可以被报告、波形或实际引脚行为证明的结论。

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

目录与阅读设置

阅读设置

17

记录一个想法

演练常见 FPGA 故障排查

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

登录哪都通