vivado 在波形查看器中查看 ILA 探针数据

在波形查看器中查看 ILA 探针数据

Vivado ® 集成设计环境 (IDE) 中的“ ILA 波形查看器 (ILA waveform viewer) ”提供了一种强大的方法 ， 可分析从 ILA 调 试核采集的数据。成功触发 ILA 核并采集数据后 ， Vivado 会以从 ILA 核收集的数据自动填充对应的波形查看器。使用 Vivado 工程模式时 ， 在不同 Vivado 会话间 ， 可配置波形设置 （ 例如 ， 颜色、基数选择和信号排序 ） 将保持不变且方便 记忆。

ILA 数据与波形关系

了解 hw_ila_data 采集的 ILA 数据对象与波形之间的关系是很有用的 ， 如下图所示。

hw_ila Tcl 对象表示硬件中的 ILA 核。每次 ILA 核上传采集的数据后 ， 这些数据都会存储在对应 Tcl hw_ila_data 对 象的存储器中。这些对象按可预测的方式来命名， 即硬件“ hw_ila_1 ”中的首个 ILA 核在触发并上传后 ， 会在名为 “hw_ila_data_1 ”的对应 Tcl 数据对象中生成数据。联机处理硬件后 ， 每个波形均由存储器内的 hw_ila_data 对 象予以支持， 并与此对象保持 1:1 对应关系 ， 如上图中的图例所示。对于每个 Tcl hw_ila_data 对象 ， 将在 Vivado 工程目录中创建并自动追踪波形数据库 (WDB) 文件和波形配置 (WCFG) 文件。上图显示的数据流向为从左侧硬件 hw_ila 流至右侧显示的波形。 波形配置 WCFG 文件和波形转换数据库 WDB 文件的组合包含 Vivado 波形用户界面中显示的波形数据库和自定义设 置。这些波形文件在 Vivado ILA 流程中自动进行管理 ， 用户不应直接修改 WDB 或 WCFG 文件。波形配置可通过更改 波形查看器中的对象（ 例如 ， 信号颜色、总线基数、信号顺序、标记等 ） 来进行修改。这样可将波形配置更改自动保存 至 Vivado 工程中相应的 WCFG 文件。 Tcl 命令 write_hw_ila_data 可用于归档波形配置和数据以供后续查看。这样即可将 hw_ila_data 、波形数据库和波 形配置保存在归档中以便后续脱机查看。请参阅“保存和复原从 ILA 核采集的数据”以获取有关如何使用 read_hw_ila_data 和 write_hw_ila_data 来脱机存储和检索波形的详细信息。

波形查看器布局

ILA 波形查看器 （ 有时被称为波形配置 ） 由多个动态对象组成 ， 这些动态对象通过协同工作来为采集的 ILA 数据提供完 整的可视化工具， 如下图所示。

前图中带标签的对象描述如下 ：

1. 来自 ILA 探针文件 ( .ltx ) 的信号线或总线名称

2. 光标处的信号线或总线值

3. 触发器标记 （ 红线 ）

4. 光标 （ 黄线 ）

5. 标记 （ 蓝线 ）

6. ILA 采集窗口转换 （ 交替清空 / 灰色区域 ）

7. 浮动测量标尺 （ 黄色条形区域 ）

波形查看器操作

波形查看器的“名称 (Name) ”列中所示标量和总线表示波形中探针设计对象的名称 （ 请参阅下图 ） 。这些对象对应于ILA 核的硬件探针 （ 请参阅 get_hw_probes Tcl 命令 ） 。

首次触发并上传 ILA 数据后 ， 就会立即在波形查看器中填充连接到该 ILA 核的所有探针。除了在查看器中移除现有探针 或添加新探针外， 还可以在其中对探针进行自定义。本章涵盖了波形查看器的基本操作。

从波形中移除探针

默认情况下 ， 在首次执行触发和上传操作期间会将所有探针添加到波形中。如果您不希望波形包含所有探针 ， 那么只需 从查看器移除探针即可。

要从波形查看器移除探针 ， 请在“名称 (Name) ”列中右键单击标量或总线 ， 然后从弹出菜单中单击“ Delete ”。或 者， 也可以选中要删除的信号或总线 ， 然后按 Delete 键。移除探针并非真的从存储器中删除探针传输事务数据 ， 只是 在视图中隐藏这些数据而已。

向波形中添加探针

要向波形中添加探针 ， 请在“调试探针 (Debug Probes) ”窗口中选择要为关联的 ILA 核添加的“探针 (Probes) ” ， 右键 单击， 然后从右键菜单中选择“ Add Probes to Waveform ”。

要向“波形 (Waveform) ”窗口添加另一个信号或总线副本 ， 请在“ Waveform ”窗口中选中该信号或总线。然后依次单 击“Edit ” → “ Copy ”或者按 Ctrl+C 。这样即可将所选对象复制到剪贴板中。依次单击“ Edit ” → “ Paste ”或者按Ctrl+V 以在波形中粘贴此对象的副本。

您也可以使用 Tcl 命令 add_wave 来完成相同操作 ， 如下所示。

add_wave -into {hw_ila_data_1.wcfg} -radix hex { {counter1} }

在此示例中 ， 在 hw_ila_1 的“波形配置 (Waveform Configuration) ”窗口中添加了探针 counter1 ， 并且在“Waveform ”窗口中其显示基数设为 hex 。