编写自定义调试器可视化
你可以编写自定义可视化,在仿真运行期间通过图形调试器查看它们。
创建自定义调试器可视化包括以下步骤:
- 编写并构建可视化库函数和头文件。
- 如有必要,修改进程模型以提供可视化所需的信息。
- 配置 ODB 以使用该可视化。
以下各节对这些步骤进行详细说明。
要查看可视化插件的示例,可以检查内置 IP_Routing 可视化的源代码,位于以下位置:
头文件:<reldir>/models/std/include/odb_vis_iprte.h
源代码:<reldir>/models/std/utilities/odb_vis/odb_vis_iprte.ets.cpp
创建可视化库
可视化插件使用 C/C++ 编写,可以使用 Riverbed 的 prg 和 ets API。其中特别有用的是 ETS “ODB Package” 中的函数,它们可帮助你从插件中访问仿真对象并运行 ODB 命令。
每个插件必须实现六个回调。仿真会在不同时间调用这些回调以完成可视化:
- init() —— 初始化可视化
- configure() —— 在可视化首次显示时显示一个对话框
- draw() —— 绘制可视化
- select() —— 处理对可视化中对象的单击
- unselect_all() —— 处理应将可视化恢复到初始状态的操作
- destroy() —— 在可视化关闭或仿真结束时进行清理
注意: 这些回调中的每一个都必须存在(即使它们什么都不做),否则插件将不会被加载。
每个回调的详细说明见调试器可视化回调。
除回调之外,你可能还需要编写额外的函数来完成可视化所需的特定任务。例如,IP_Routing 插件包含显示路由、获取下一跳以及为节点添加可达性图标的函数。可能对不同可视化有用的函数可以包含在可视化工具库(<reldir>/models/std/utilities/odb_vis/odb_vis_util.ets.cpp)中。
获取调试器信息
可视化插件可以通过 Ets_Odb_Run_Command() 运行 ODB 命令并解析命令输出来获取有关仿真的信息。但有时必要的信息无法从命令中获得。在这种情况下,你可以在进程模型的诊断块中添加代码,收集并返回你需要的信息。
例如,IP_Routing 插件通过在 ip_dispatch 进程模型的调试头文件中定义一个标签(ip_interfaces)来获取路由表信息。该插件使用 “proldiag” 命令执行与该标签关联的诊断块代码,从而获取指定节点的路由表。
构建命令
使用实用程序 “op_mko” 和 “op_mkso” 构建插件库。例如:
op_mko -type ets -m odb_vis_iprte
op_mkso -type ets -f odb_vis_iprte.gui32.i0.ets.obj -m simviz.gui32.i0.ets.dll
配置 ODB
要在 ODB 中使用自定义插件,必须将其添加到可用可视化列表中。为此,可以编辑 Debugger Visualizations 偏好设置,或使用以下过程:
过程 10:向 ODB 添加自定义可视化
-
在图形调试器中运行仿真时,单击 Visualizations 标签。
-
在 Add Visualization 标签页 上,单击 Configure Available Visualizations 按钮。
-
在 Configure Debugger Visualizations 对话框 中添加可视化:
3.1 单击 Add Row。 3.2 输入 Friendly Name、Function Prefix 和 Library Name。 3.3 单击 Save Changes。