编写自定义调试器可视化

你可以编写自定义可视化,在仿真运行期间通过图形调试器查看它们。

创建自定义调试器可视化包括以下步骤:

  • 编写并构建可视化库函数和头文件。
    • 如有必要,修改进程模型以提供可视化所需的信息。
  • 配置 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 添加自定义可视化

  1. 在图形调试器中运行仿真时,单击 Visualizations 标签。

  2. 在 Add Visualization 标签页 上,单击 Configure Available Visualizations 按钮。

  3. 在 Configure Debugger Visualizations 对话框 中添加可视化:

    3.1 单击 Add Row。 3.2 输入 Friendly Name、Function Prefix 和 Library Name。 3.3 单击 Save Changes。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com