vivado 写入 ILA 探针信息、读取 ILA 探针信息

写入 ILA 探针信息

“调试探针 (Debug Probes) ”窗口中的“ ILA 核 (ILA Cores) ”选项卡视图包含有关您在自己的设计中使用 ILA 核探测的

信号线的信息。此 ILA 探针信息提取自您的设计 ， 并存储在数据文件内 ， 此数据文件通常带有 .ltx 文件扩展名。

通常 ， ILA 探针文件是在比特流生成期间自动创建的。但是 ， 您也可以使用 write_debug_probes Tcl 命令来将调试

探针信息写出至文件 ：

1. 如果使用工程模式 ， 请打开“已实现的设计 (Implemented Design) ”。如果使用非工程模式 ， 请打开已实现的设计

检查表。

2. 运行 write_debug_probes 文件名 .ltx Tcl 命令。

读取 ILA 探针信息

如果在与器件关联的比特流编程 ( .bit ) 文件所在目录内找到名为 debug_nets.ltx 的 ILA 探针文件 ， 那么 ， 此探针

文件会与 FPGA 或 ACAP 硬件器件自动关联。

您还可以指定探针文件的位置 ：

1. 在“硬件 (Hardware) ”窗口内选择 FPGA 或 ACAP 。

2. 在“硬件器件属性 (Hardware Device Properties) ”窗口中设置探针文件位置。

3. 单击“ Apply ”以应用更改。

您也可以使用 set_property Tcl 命令来设置位置 ：

set_property PROBES.FILE {C:/myprobes.ltx} [lindex [get_hw_devices] 0]

在波形查看器中查看从 ILA 核采集的数据

当 ILA 核采集的数据上传到 Vivado IDE 后 ， 就会显示在波形查看器 (Waveform Viewer) 中。请参阅“查看 ILA 探测数

据”以获取有关使用波形查看器来查看从 ILA 核采集的数据的详细信息。

使用波形 ILA 触发器和导出功能

您可以使用波形窗口中的图标来装备 ILA 和运行触发器、停止触发器以及导出 ILA 数据 ， 如下所示。

“ Enable Auto Re-Trigger ” ： 选中“波形 (Waveform) ”窗口工具栏上的“启用自动重新触发 (Enable Auto Re

Trigger) ”按钮即可在成功完成触发 + 上传 + 显示操作后 ， 启用 Vivado IDE 以自动重新装备与“ Waveform ”窗口触发

器关联的 ILA 核。

每次成功完成触发事件后 ， 对应于 ILA 核的“ Waveform ”窗口中显示的采集数据都会被覆盖。“自动重新触发 (Auto

Re-Trigger) ”选项可搭配“运行触发器 (Run Trigger) ”操作和“立即运行触发器 (Run Trigger Immediate) ”操作一起使

用。单击“停止触发器 (Stop Trigger) ”按钮即可停止当前运行中的触发器。

“ Run Trigger ” ： 装备与“ Waveform ”窗口关联的 ILA 核 ， 以检测由 ILA 核的基本或高级触发器设置所定义的触发器

事件。

“ Run Trigger Immediate ” ： 装备与“ Waveform ”窗口关联的 ILA 核以忽略 ILA 核触发器设置 ， 并立即触发该核。此

命令用于通过采集 ILA 核的探针输入处的任意活动来检测设计的“活动状态”。

“ Stop Trigger ” ： 停止与“ Waveform ”窗口关联的 ILA 的 ILA 核触发器。

“ Export ILA Data ” ： 从 ILA 核采集数据并将其保存到文件。此数据可采用本机格式、 .csv 或 .vcd 格式来采集。单

击此图标后 ， 在“ Waveform ”窗口工具栏上会显示以下对话框。

“ ILA 核 (ILA Core) ”表示要为其导出数据的 ILA 调试核的名称。“格式 (Format) ”支持下列格式 ： 本机 (Native) 、 CSV

和 VCD 。

• 本机格式可配置 write_hw_ila_data 命令 ， 按本机 ILA 格式来导出 ILA 数据。

此 ILA 文件可重新导入 Vivado IDE 以便您查看先前采集的 ILA 数据。 read_hw_ila_data TCL 命令可用于将 ILA

数据重新导入 Vivado IDE ， 如以下示例所示 ：

read_hw_ila_data {./iladata.ila}

display_hw_ila_data

• CSV 格式可配置 write_hw_ila_data 命令 ， 按 .csv 文件格式导出 ILA 数据 ， 此文件可用于将数据导入电子表

格或第三方应用。

• VCD 文件格式可配置 write_hw_ila_data 命令 ， 按 .vcd 文件格式导出 ILA 数据 ， 此格式可用于导入第三方应

用或查看器。

重要提示 ！ 虽然 ILA 数据可按 CSV 、 VCD 和本机 ILA 格式导出 ， 但在 Vivado 中只能导入本机 ILA 格式。并

且 ， 仅支持将本机 ILA 数据导入 Vivado 用于脱机查看先前采集的数据。探针信号不能用于其它目的 ， 如触

发等。

保存和复原从 ILA 核采集的数据

除了显示从 ILA 核直接上传的采集数据外 ， 您也可以将采集输入写入文件 ， 然后从文件读取该数据 ， 并将其显示在波形

查看器中。

将采集的 ILA 数据保存到文件

当前将从 ILA 核采集的数据上传并保存到文件的唯一方法是使用以下 Tcl 命令 ：

write_hw_ila_data my_hw_ila_data_file.ila [upload_hw_ila_data hw_ila_1]

此 Tcl 命令序列会将从 ILA 核采集的数据上传并写入名为 my_hw_ila_data_file.ila 的存档文件。此存档文件包

含波形数据库文件、波形配置文件、波形逗号分隔值文件以及调试探针文件。

提示 ： 使用 -csv_file 选项可生成逗号分隔值 (CSV) 文件。这样即可配置 write_hw_ila_data 命令以将

ILA 数据导出至 CSV 格式 （ 而不是默认二进制 ILA 文件格式 ） 的文件 ， 此文件可供用于导入电子表格或第三方

应用。

提示 ： 使用 -vcd_file 选项可生成值更改转储 (VCD) 文件。这样即可配置 write_hw_ila_data 命令以将

ILA 数据导出至 VCD 格式 （ 而不是默认二进制 ILA 文件格式 ） 的文件 ， 此文件可用于导入第三方应用或查看

器。

探针数据基数

每个探针都具有关联的 DISPLAY_RADIX 属性。默认情况下 ， 该属性针对多位探针设置为 HEX ， 针对单位探针则设置

为 BINARY 。 .csv 文件中导出的探针数据会使用探针基数。

您可以在 Vivado 硬件管理器 Tcl 控制台中更改设计中所有 ILA 的所有探针的 DISPLAY_RADIX 属性 ， 如下所示 ：

foreach probe [get_hw_probes -of [get_hw_ilas]] {

set_property DISPLAY_RADIX binary $probe

set_property DISPLAY_AS_ENUM false $probe

}

注释 ： 此处我们所做的是将所有 ILA 中的所有探针基数更改为 BINARY 。要将基数更改为 HEX ， 请使用以下脚本。

foreach probe [get_hw_probes -of [get_hw_ilas]] {

set_property DISPLAY_RADIX hex $probe

set_property DISPLAY_AS_ENUM false $probe

}

与单一探针关联的数据样本列表

您还可使用 list_hw_samples Tcl 命令来列示与各探针关联的数据样本。

以下显示了与名为 i_fast_ila 的 ILA 上的 fast_cnt_incr_val_1 探针关联的样本列表示例 ：

list_hw_samples [get_hw_probes fast_cnt_incr_val_1 -of_objects [get_hw_ilas

-of_objects [get_hw_devices xc7k325t_0] -filter {CELL_NAME=~"i_fast_ila"}]]

00000001 00000001 00000001 00000001 00000001 00000001 00000001 00000001

00000001

00000001 00000001 00000001 00000001 00000001 00000001 00000001 00000001

00000001

00000001 00000001 00000001 00000001 00000001 00000001 00000001 00000001

00000001

00000001 00000001 00000001 00000001 00000001 00000001 00000001 00000001

00000001...

从文件恢复采集的 ILA 数据

当前 ， 从文件恢复采集的数据并将其显示在波形查看器中的唯一方法是使用以下 Tcl 命令 ：

display_hw_ila_data [read_hw_ila_data my_hw_ila_data_file.ila]

此 Tcl 命令序列会读取先前从 ILA 核采集并保存的数据 ， 然后将其显示在“波形 (Waveform) ”窗口中。

注释 ： “ ILA 数据波形 (ILA Data Waveform) ”窗口的波形配置设置 （ 分频器、标记、颜色、探针基数等 ） 也同样保存

在 ILA 采集数据归档文件中。恢复和显示先前保存的任意 ILA 数据时 ， 会使用这些存储的波形配置设置。

重要提示 ！ 请勿使用 open_wave_config 命令打开根据 ILA 采集的数据创建的波形。此命令仅适用于仿真

器 ， 对于 ILA 采集的数据波形无效。