协同仿真
在大多数方面,在 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,以防止仿真进入睡眠状态。