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

使用片上逻辑分析定位上板问题

使用片上逻辑分析定位上板问题

仿真通过但上板异常时,需要把真实硬件中的关键内部信号变成可验证证据。本节以 Vivado ILA 为例,从保留探针、创建并连接分析核,到设置触发窗口和实际采集波形,完成一次可复用的上板定位闭环。

学习目标

  • 能按“边界输入、内部状态、边界输出”选择足以解释故障的探针。
  • 能在综合后创建并连接 ILA,明确采样时钟、探针宽度和调试资源。
  • 能设置触发条件与采样窗口,实际抓取数据并与仿真时序逐级对照。

先定义要证明什么

片上逻辑分析不是“多接几个信号再看看”,而是先提出可验证假设。例如串口命令偶发丢失,可以依次确认:接收端是否看到起始位、采样计数是否推进、状态机是否进入接收态、数据是否被锁存,以及 rx_valid 是否最终产生。

探针应优先覆盖三类信号:边界输入说明板上真实收到了什么,内部状态解释模块如何处理,边界输出说明结果是否送往下一级。只观察其中一类,往往无法形成完整证据链。

片上逻辑分析探针与触发链路

在 RTL 中保留关键调试信号

综合优化可能删除、合并或改名内部网络。Vivado 可用 mark_debug 保留需要探测的网络;该属性用于调试可见性,不应承担功能逻辑。下面是片段示例,假设这些别名位于 UART 接收逻辑中,并与后续 Tcl 使用的网络名一致。

verilog
(* mark_debug = "true" *) wire       dbg_uart_rx  = uart_rx;
(* mark_debug = "true" *) wire [2:0] dbg_rx_state = rx_state;
(* mark_debug = "true" *) wire [7:0] dbg_rx_data  = rx_data;
(* mark_debug = "true" *) wire       dbg_rx_valid = rx_valid;

生效行为与验证方法:重新综合后,在综合网表中应能查询到四组 MARK_DEBUG 网络。若实际网络位于更深层级,后续 Tcl 中的 get_nets 需要改成对应的层级路径。

创建并连接 ILA

仅有 MARK_DEBUG 还没有形成采集链路。下面的 Tcl 在工程已完成 synth_1、且四组调试别名位于当前综合设计可查询范围时执行:创建 ILA,把 clk 作为采样时钟,并分别连接 RX、状态、数据和 valid 探针。不同采样时钟域应使用独立 ILA,不要把异步信号直接混在一个采样参考下解释。

tcl
open_run synth_1

create_debug_core u_ila_uart ila
set_property C_DATA_DEPTH 4096 [get_debug_cores u_ila_uart]

set_property port_width 1 [get_debug_ports u_ila_uart/clk]
connect_debug_port u_ila_uart/clk [get_nets clk]

set_property PROBE_TYPE DATA_AND_TRIGGER [get_debug_ports u_ila_uart/probe0]
set_property port_width 1 [get_debug_ports u_ila_uart/probe0]
connect_debug_port u_ila_uart/probe0 [get_nets dbg_uart_rx]

create_debug_port u_ila_uart probe
set_property PROBE_TYPE DATA_AND_TRIGGER [get_debug_ports u_ila_uart/probe1]
set_property port_width 3 [get_debug_ports u_ila_uart/probe1]
connect_debug_port u_ila_uart/probe1     [get_nets {dbg_rx_state[0] dbg_rx_state[1] dbg_rx_state[2]}]

create_debug_port u_ila_uart probe
set_property PROBE_TYPE DATA_AND_TRIGGER [get_debug_ports u_ila_uart/probe2]
set_property port_width 8 [get_debug_ports u_ila_uart/probe2]
connect_debug_port u_ila_uart/probe2     [get_nets {dbg_rx_data[0] dbg_rx_data[1] dbg_rx_data[2] dbg_rx_data[3]                dbg_rx_data[4] dbg_rx_data[5] dbg_rx_data[6] dbg_rx_data[7]}]

create_debug_port u_ila_uart probe
set_property PROBE_TYPE DATA_AND_TRIGGER [get_debug_ports u_ila_uart/probe3]
set_property port_width 1 [get_debug_ports u_ila_uart/probe3]
connect_debug_port u_ila_uart/probe3 [get_nets dbg_rx_valid]

report_debug_core u_ila_uart
save_constraints
close_design

reset_run impl_1
launch_runs impl_1 -to_step write_bitstream
wait_on_run impl_1
open_run impl_1

set out_dir [get_property DIRECTORY [current_project]]
set ltx_file [file join $out_dir uart_debug.ltx]
write_debug_probes -force $ltx_file
puts "implementation = [get_property PROGRESS [get_runs impl_1]]"
puts "probes file = $ltx_file"

预期输出

text
implementation = 100%
probes file = <PROJECT_DIR>/uart_debug.ltx

实际工程目录会不同。report_debug_core 还应显示 u_ila_uart 的一个时钟端口和四个 probe 端口,宽度依次为 1、3、8、1;若 get_nets 找不到网络,应先修正层级路径,而不是继续实现。

设置触发并完成采集

对于 UART 接收,起始位通常表现为 RX 的下降沿,因此可让 dbg_uart_rx 的下降沿成为第一次可观察事件。4096 点深度下把触发位置设为 2048,可同时保留触发前后的上下文。下面命令假设开发板已连接,且 impl_1 生成的 .bit 与刚写出的 .ltx 属于同一次实现。

tcl
set run_dir [get_property DIRECTORY [get_runs impl_1]]
set bit_file [lindex [glob -nocomplain [file join $run_dir *.bit]] 0]
set ltx_file [file join [get_property DIRECTORY [current_project]] uart_debug.ltx]

if {$bit_file eq ""} {
    error "No bitstream found in impl_1"
}

open_hw_manager
connect_hw_server
open_hw_target

set dev [lindex [get_hw_devices] 0]
current_hw_device $dev
set_property PROGRAM.FILE $bit_file $dev
set_property PROBES.FILE $ltx_file $dev
program_hw_devices $dev
refresh_hw_device $dev

set ila [lindex [get_hw_ilas -of_objects $dev     -filter {CELL_NAME =~ "*u_ila_uart*"}] 0]
if {$ila eq ""} {
    error "u_ila_uart was not discovered on the programmed device"
}
current_hw_ila $ila
reset_hw_ila $ila

set_property CONTROL.DATA_DEPTH 4096 $ila
set_property CONTROL.TRIGGER_POSITION 2048 $ila
set_property CONTROL.TRIGGER_MODE BASIC_ONLY $ila
set_property CONTROL.TRIGGER_CONDITION AND $ila

set rx_probe [lindex [get_hw_probes -of_objects $ila     -filter {NAME =~ "*dbg_uart_rx*"}] 0]
if {$rx_probe eq ""} {
    error "dbg_uart_rx hardware probe was not found"
}
set_property TRIGGER_COMPARE_VALUE eq1'bF $rx_probe

run_hw_ila $ila
puts "ILA armed; send one UART frame now"
wait_on_hw_ila -timeout 1 $ila

set capture [upload_hw_ila_data $ila]
display_hw_ila_data $capture
puts "capture = [get_property NAME $capture]"

预期输出

text
ILA armed; send one UART frame now
capture = <HW_ILA_DATA>

<HW_ILA_DATA> 是 Vivado 为本次采集创建的数据对象名,实际值会不同。若一分钟内没有检测到 RX 下降沿,wait_on_hw_ila 会超时;这时先确认串口物理输入、波特率测试条件和 probe 名称,而不是把超时直接解释为 RTL 错误。

对照硬件捕获与仿真

拿到波形后,先找第一个与仿真不一致的时间点,而不是从最终错误结果倒推全部逻辑。串口问题可按“RX 边沿 → 状态迁移 → 数据寄存 → rx_valid”逐级比较;ready/valid 握手则重点确认双方是否在同一拍满足握手条件,以及数据在握手拍是否稳定。

如果外部输入已经与仿真不同,应优先检查引脚、电平标准、时钟、复位和外设时序;如果输入一致但内部状态开始分叉,再检查 CDC、初始化、时序违例或仿真模型没有覆盖的硬件条件。这样就完成了“保留网络 → 插入 ILA → 指定采样时钟 → 设置触发窗口 → 上板采集 → 对照仿真”的最小调试闭环。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用片上逻辑分析定位上板问题

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

登录哪都通