协同仿真

在大多数方面,在 Modeler 中调用协同仿真与调用普通仿真相似。普通仿真所需的全部参数都适用于协同仿真。但要运行协同仿真,必须安装外部系统代码。

当为仿真程序指定 op_runsim -cosim 时,Modeler 会利用仿真器描述文件中的信息来找到所涉及的其他仿真器。除了常规的 Modeler 参数之外,其他仿真器所需的参数也可以作为 op_runsim 或 op_mksim 的参数来指定。

编译协同仿真代码

协同仿真的代码可以像常规仿真一样使用 op_mko 编译。

外部代码可以使用原生编译器和自定义 makefile 规则编译。构建目录中必须包含 <reldir>/sys/include 目录。外部代码:

  • 应当包含语句 #include "esa.h"
  • 不能使用 ESA 之外的任何 Modeler API

链接协同仿真代码

生成协同仿真可执行程序有两种方式。仿真器描述文件指定使用哪种方式,以及应当链接哪些目标文件和库(参见仿真器描述文件)。

将离散事件仿真嵌入一个更大的程序中。

将仿真器描述文件中的 use_esa_main 设置为 "no" 即指定此方式。采用此方式时:

  • 外部代码声明 main()。
  • 可执行程序使用 op_mksim 或自定义 makefile 规则创建。使用自定义 makefile 时,必须显式提及 Riverbed 库,如下:
    • Windows:opsim.lib(或 opsim_opt.lib)
    • Linux:-lopsim(-lopsim_opt)
  • Riverbed 模型代码被链接进可执行程序。

在离散事件仿真中使用外部库。

将仿真器描述文件中的 use_esa_main 设置为 "yes" 即指定此方式。采用此方式时:

  • Modeler 声明 main()。
  • 可执行程序对静态仿真使用 op_mksim、对动态仿真使用 op_runsim 创建。
  • 外部代码包含在动态加载的库中,使用由 Riverbed 代码调用的特殊入口点 esa_main()。

esa_main() 函数接受与 main() 相同的参数,其原型为:

int
esa_main (int argc, char *argv[])

仿真器描述文件

每个外部系统定义(ESD)模型都为使用该 ESD 的协同仿真指定一个仿真器描述文件。仿真器描述文件是一个文本文件,它告诉 Modeler 如何构建协同仿真。它针对特定的操作系统和内核类型指定必须链接的目标文件和库。仿真器描述文件必须使用文件名后缀 .sd 命名,并存放在 mod_dirs 属性所列的某个目录中。

仿真器描述文件格式

一个仿真器描述由一个或多个语句块组成,各块由标识符 start_definition 和 end_definition 分隔,如下面的示例所示(Modeler 自带的 hla.sd 文件的一部分)。

图 245:仿真器描述文件——示例节选

# Simulator Description file for HLA Cosimulation
# This uses the Riverbed-provided HLA module
# Do not modify the following information

start_definition
	platform: linux_x86
	kernel: development
	bitness: 32bit
	bind_static_lib: -lophla1516_opt -lfedtime1516 -lrti1516
	bind_shobj_lib: -lophla1516_opt -lfedtime1516 -lrti1516
	dll_lib: libophla1516_opt.so
end_definition

一个仿真器描述文件中可以包含任意数量的块。当 Modeler 构建协同仿真时,它会查看仿真器描述文件,寻找 platform 和 kernel 语句与目标平台和内核相匹配的块,然后使用该块中其余的语句来控制构建。

仿真器描述文件中可以使用的语句在下表中说明。

表 126:仿真器描述文件语句

语句 说明 值
platform 协同仿真的目标平台 "windows"、"linux_x86"
bitness 目标架构位数 "32bit"、"64bit"
kernel 目标内核类型 "development"、"optimized"
dll_lib 协同仿真 DLL 库 协同仿真所用库的文件名
bind_lib 绑定参数 命令行中使用的参数
bind_objs 绑定目标文件 待绑定的目标文件
use_esa_main 外部代码是否声明名为 esa_main() 的函数 "yes"——用于在离散事件仿真中使用外部库
"no"——用于将离散事件仿真嵌入更大的程序

以 "#" 开头的行是注释,可以出现在仿真器描述文件的任何位置。

延迟

作为与 SITL 或 HLA 的协同仿真运行时,离散事件仿真在没有事件需要处理时会进入睡眠状态,并偶尔唤醒以检查新事件,从而降低 CPU 占用。除非需要实时响应(例如测量 ping 响应时间),这种方式运行良好。为避免操作系统内核时钟周期引入的延迟,可以将 "cosimulation_optimization_mode" 偏好设置为 low-latency,以防止仿真进入睡眠状态。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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