HLA 映射文件教程
注意: 本教程使用第 3 章“使用映射文件准备 Riverbed 联邦成员”第 21 页中描述的类映射方法。有关通过编写你自己的 Federate Ambassador C++ 类来使用 HLA 的示例,请参阅
<reldir>\sys\utilities\hla\example中的rpr_tut项目。
HLA(High-Level Architecture,高层体系结构)功能让你能够将 Modeler 仿真作为 HLA 联邦的一个联邦成员纳入其中,从而影响其他联邦成员中的事件并受其影响。同时运行多个仿真使整体仿真更加真实,并能为每个仿真提供更新的输入。
本教程的联邦包含两个联邦成员:一个 Modeler 联邦成员(OPNET,将由你构建)和一个现有的控制器联邦成员(controller_tutorial)。
OPNET 联邦成员包含两个代表飞机的节点。这些飞机的运动由控制器联邦成员控制。
控制器联邦成员推进联邦时间,发送修改 OPNET 联邦成员中飞机 bearing(方位)和 ground speed(地速)的交互,并接收来自 OPNET 联邦成员的交互。本教程不涉及控制器联邦成员的开发,也不涉及它使用的两个文件:
- FOM 文件。本教程不包含完整的 FOM 文件,只包含相应的
.fed文件。你无需准备 FOM 文件。 - 联邦(
.fed)文件。该文件名为HLA_Tutorial.fed,已为你提供于<reldir>\models\std\tutorial_req\module\hla。
在本教程中,你将修改以下内容:
- 飞机中的进程模型
- HLA Interface 节点中的进程模型
本教程假设你具有使用 HLA 的经验,并且已安装 RTI executive。
标准安装包含两个与 HLA 教程相关的目录:
<reldir>\models\std\tutorial_req\module\hla包含完成本教程所需的文件。确认该目录已包含在你的 mod_dirs 偏好中。如果没有,请添加它。<reldir>\models\tutorial_ref\module\hla包含参考文件,代表你完成本教程后将产生的模型。这些文件仅供参考,完成教程并不需要它们。
注意: RTI 配置和输出基于 MÄK RTI 3.1.1 和 DMSO RTI 1.3NGV6。MÄK RTI 2.0 或更高版本也应可用,但菜单和输出可能有所不同。有关其他 RTI 的信息请联系技术支持。
注意: 使用 HLA 包时,你不能在仿真中使用任何非 HLA 的 esys 模块。
准备工作目录
在本教程的其余部分,<working_dir> 表示 mod_dirs 偏好中列出的第一个目录。
- 在典型的 Linux 安装中,这是
~/op_models。 - 在典型的 Windows 安装中,这是
%HOME%\op_models。
由于本教程涉及修改现有模型和创建新文件,第一步是在工作目录中准备好必要文件的副本。
步骤 1:准备工作目录
-
将
<reldir>\models\std\tutorial_req\module\hla目录中的文件复制到你的工作目录。 -
发出以下命令,确保文件可写:
Linux
cd <working_dir> chmod a+w *Windows
cd <working_dir> attrib -r *.*
设置过程
按照你所使用的 RTI 的说明操作:
MÄK 设置
为了与使用 DMSO RTI 构建设置相匹配,你需要设置以下系统变量。
表 1:MÄK 设置的系统变量
| 变量 | 位置 |
|---|---|
| RTI_HOME | 安装 MÄK 软件的基础目录(Windows 上默认为 C:\MAK) |
| RTI_BUILD_TYPE | RTI 目录的名称(例如 makRti3.1.1) |
步骤 2:以完全 DMSO 等效模式设置 RTI
-
从 RTI 安装目录,复制一份
rid.mtl文件,然后打开原始的rid.mtl文件。 -
找到该行(
setqb RTI_forceFullCompliance 0),将 “0” 改为 “1”。注意: 如果文件中不存在该行,请在文件开头添加它。
-
保存文件并退出文本编辑器。
DMSO 设置
Riverbed 和 RTI 依赖不同版本的第三方库(ACE、TAO)。你的环境必须设置为能够找到 RTI 版本。
注意: Riverbed 版本的第三方库仅在从 VNE Server 导入拓扑配置时才需要。如果你不从 VNE Server 导入拓扑配置,可以从路径中移除这些库而不影响其他 Riverbed 操作。
Windows
将 <rti_dir>\bin 添加到 PATH 系统变量中,位于 <reldir>\sys\pc_intel_win32\bin 之前
Linux
将 <rti_dir>/lib 添加到 LD_LIBRARY_PATH shell 变量中,位于 <reldir>/sys/pc_intel_linux/lib 之前
创建网络模型
在本教程中,示例网络包含两个飞机节点,其运动由 bearing 和 ground speed 属性控制。一个 HLA 交互改变这些值,另一个 HLA 交互确认收到。
步骤 3:创建网络模型
-
启动 Modeler,确保 Wireless 功能可用。
-
创建一个名为 <your_initials>_HLA_Tutorial 的新项目和一个名为 2Planes 的场景。
-
在 Startup Wizard 中指定以下值:
表 2:HLA 网络模型的 Startup Wizard 设置
项目 值 Initial Topology Create empty scenario Network Scale World Border Map World Model Family HLA_Tutorial -
按如下方式创建网络模型。
-
4.1 将 HLA Interface 节点放置在地图上的任意位置(其位置不影响仿真)。将其命名为 HLA Interface。
-
4.2 放置两个 Plane 节点。右键单击节点并选择 Edit Attributes (Advanced),按下表设置属性。
表 3:Plane 节点
名称 x 位置 y 位置 Trajectory bearing fly0 –31 44 VECTOR 270 fly1 82 63 VECTOR 270 网络模型将类似于下图:

-
-
检查各模型:
-
5.1 右键单击 fly0 并选择 Edit Attributes (Advanced)。注意 bearing 和 ground speed 属性,它们将因 HLA Interface 节点收到并传送给飞机节点的 HLA 交互而改变。
-
5.2 检查 hla13_cosim_compat 进程模型。为此,双击 HLA Interface 节点,然后双击 hla13 esys 模块。
这个自包含的模型处理 OPNET 联邦成员与联邦之间的所有交互。它可以放置在任何节点模型中,执行它的 esys 模块与其他模块之间无需任何额外连接。
-
5.3 关闭 Process Editor 和 Node Editor。
-
-
保存网络模型。
配置仿真
hla13_cosim_compat 进程模型的行为通过一组仿真属性进行定制。现在你必须准备一个包含这些属性的环境文件。运行仿真时你会引用该文件。
步骤 4:配置仿真
-
使用你选择的编辑器打开环境文件:
<working_dir>\HLA_Tutorial.ef。结果: 文件将如下所示:
# Fill in with your working directory "HLA Class Mapping File" : "<Fill In Value>" # Predefined values "HLA Abort On Failure" : false "HLA Callback Set" : 511 "HLA Create Federation" : true "HLA Create Init Synchronization Point" : false "HLA Destroy Federation" : true "HLA Factory" : hla13_cosim_compat "HLA FED File Name" : "" "HLA Federate Name" : OPNET "HLA Federation Name" : HLA_Tutorial "HLA Init Synchronization Point" : "" "HLA Inter-event Tick" : false "HLA Join Attempts" : 10 "HLA Mak Time Advance Request" : 0.1 "HLA Standard" : "DOD 1.3" "HLA Time Constrained" : true "HLA Time Lookahead" : 0.1 "HLA Time Quantum" : 0.0 "HLA Time Regulating" : true "HLA Update Check Interval" : -1.0 "HLA Verbose" : false "HLA Verbosity Level" : 0 -
将 <Fill In Value>(位于 HLA Class Mapping File 属性之后)替换为你系统的正确信息。该值应为以下之一:
Linux
<working_dir>/HLA_Tutorial.mapWindows
<working_dir>\HLA_Tutorial.map -
将编辑后的文件以相同名称(HLA_Tutorial.ef)保存在你的工作目录中。
此环境文件中的属性配置将对仿真产生以下影响:
- OPNET 联邦成员将在启动时尝试创建联邦。如果联邦已存在,则不会发生任何事情。
- 当 OPNET 联邦成员结束其仿真时,它将尝试销毁联邦。如果其他联邦成员仍是成员,该尝试将失败。
- 联邦名称为 HLA_Tutorial。
- OPNET 联邦成员的名称为 OPNET。
- 用于联邦时间管理的 lookahead(前瞻)为 0.1 秒。
- hla13_cosim_compat 进程模型不会周期性地检查被修改的属性(无需检查,因为没有使用任何属性)。
- hla13_cosim_compat 进程模型将使用映射文件
HLA_Tutorial.map。 - 如果在 HLA 接口遇到错误,仿真不会中止。
准备初始类映射文件
尽管目前尚未定义任何映射,映射文件对于 hla_cosim 进程模型正确初始化仍然是必需的。
步骤 5:准备初始类映射文件
-
使用你选择的编辑器创建一个包含以下文本的新文件。
(mapping version 2) -
将文件以 HLA_Tutorial.map 名称保存在你的工作目录中。
启动控制器联邦成员
本教程包含一个控制器联邦成员(名为 controller_tutorial),你只需编译并启动它。控制器联邦成员生成的交互会使 OPNET 联邦成员中的飞机改变位置并生成确认交互。在启动控制器联邦成员之前,你必须先编译它。
HLA 初始化包括创建并加入联邦、建立时间管理以及向 esys 模块传递初始化回调,它发生在仿真事件执行之前。如果你使用 ODB,HLA 初始化事件在你执行第一个 odb> 提示之后发生。
步骤 6:启动控制器联邦成员
-
设置你的环境以访问 RTI executive(如设置过程中所述)。
-
启动 RTI executive。
-
对于 MÄK RTI:
输入以下命令:
Linux
在命令提示符处输入
rtiexec。你应该看到类似如下的消息:
% rtiexec Loading Config File: <rti_dir>/rid.mtl Using MAK Technologies’ RTI version 3.1.1-HLA1.3 for GNU C++ version 3.4.6 20060404 (Red Hat 3.4.6-3) DtTcpSocket connecting to 127.0.0.1 Using TcpSocket with 50000 byte buffer (Client) Using TcpSocket with 50000 byte buffer (Server) TCP Forwarder: RTI Exec connection established.Windows
从 Startup 菜单,选择 Startup > Programs > Mak Technologies > MAK RTI <version> > RTI Rtiexec
-
对于 DMSO RTI:
出现以下消息:
The RTI Executive process no longer accepts input to interrogate or control the federation executions. Instead a separate RTI Console application provides this functionality. The RTI Console was designed to improve usability and add the ability to be run at multiple locations. Check the RTI Installation Guide for further information concerning the RTI Console application.按 Ctrl-C 以生成以下内容:
rtiexec exit Advertising launcher as RtiLauncher;<ip_address>; rtiexec, process id = <pid>, endpoint = <ip_address>:<value>, multicast discovery endpoint = <value>:<value>, initialization complete.
-
-
打开新的 shell(Linux)或 Riverbed Console(Windows)并移动到
<working_dir>。 -
按如下方式编译控制器:
注意: 如果编译控制器时遇到问题,尝试设置以下环境变量并重新编译。
setenv LD_LIBRARY_PATH $(RTI_HOME)/$(RTI_BUILD_TYPE)/lib:$LD_LIBRARY_PATHLinux
输入以下命令:
make controller_tutorialWindows
输入以下命令:
make_controller你会看到类似如下的编译消息(LInux 输出,MÄK):
% make controller_tutorial g++ -c -g -m32 -Wno-deprecated -DRTI_USES_STD_FSTREAM -DDT_USE_DLL -I<rti_dir>/include -o controller_tutorial.o controller_tutorial.cpp g++ -c -g -m32 -Wno-deprecated -DRTI_USES_STD_FSTREAM -DDT_USE_DLL -I. s_hla_stream.cpp -o s_hla_stream.o g++ -g -m32 -Wno-deprecated -o controller_tutorial controller_tutorial.o s_hla_stream.o -L<rti_dir>/lib -lRTI-NG -lfedtime -lpthread controller_tutorial.o(.text+0x1a5a): In function ‘process_events()’: <working_dir>/controller_tutorial.cpp:573: warning: the ‘gets’ function is dangerous and should not be used. -
输入此命令启动控制器和联邦:
Linux
./controller_tutorial HLA_TutorialWindows
.\controller_tutorial.exe HLA_Tutorial-
对于 MÄK,你应该看到类似如下的消息:
% ./controller_tutorial HLA_Tutorial Loading Config File: <rti_dir>/rid.mtl DtTcpSocket connecting to 127.0.0.1 Using TcpSocket with 50000 byte buffer (Client) Using MAK Technologies’ RTI version 3.1.1-HLA1.3 for GNU C++ version 3.4.6 20060404 (Red Hat 3.4.6-3) Attempting to join federation... Reading Fed file: HLA_Tutorial.fed Setting max UDP packet size to 15000 bytes NetSocket ok for port 4000 to 229.7.7.7 Federation joined, attempting to enable time regulation... Time regulation enabled, RTI time is 0 Attempting to constrain time advances... Time advances constrained [Time: 0] Enter command:在 Windows 上,如果你拥有 MÄK Rtispy 许可证并启用图形界面,rtiexec 将如图 1 所示。
图 1:对于 MÄK 和 Windows:联邦成员加入 HLA Tutorial

-
对于 DMSO,执行以下操作:
控制器尝试加入联邦。如果成功,控制器窗口中将出现类似如下的消息:
Using RID file ‘<working_dir>/RTI.rid’. Attempting to join federation... "RtiVnMulticast.cpp", line 298: Query mcast sender sendbuf size returned 131072 "RtiVnMulticast.cpp", line 715: Query mcast receiver rcvbuf size returned 131072 Federation joined, attempting to enable time regulation... Time regulation enabled, RTI time is 0 Attempting to constrain time advances... Time advances constrained [Time: 0] Enter command:在 RTI executive 窗口中,应该出现类似如下的消息:
federation HLA_Tutorial finished initialization with process id <pid> and endpoint <ip address>:<value> Federate ./controller_tutorial is JOINING federation HLA_Tutorial at <date & time>如果没有 RTI 图形界面,你将在 RTI console 或 shell 中看到以下消息:
Create: execution HLA_Tutorial created. Handle: 1. FED File: HLA_Tutorial.fed Join: Federate controller_tut has joined HLA_Tutorial with handle 1.
-
准备 OPNET 联邦成员
在本节中,你编译并启动 OPNET 联邦成员。
步骤 7:准备 OPNET 联邦成员
-
打开新的 shell(Linux)或 Console(Windows)并进入你的工作目录。
-
设置你的环境以访问 RTI executive。
确保 RTI 目录位于 Riverbed 设置之前。
Linux
将
<rti_dir>/lib放在 LD_LIBRARY_PATH shell 变量中,位于<reldir>/sys/pc_intel_linux/lib之前Windows
将
<rti_dir>\bin(DMSO)或<rti_dir>\lib(MÄK)放在 PATH 系统变量中,位于<reldir>\sys\pc_intel_win32\bin之前 -
根据你所使用的平台,验证以下偏好设置:
Linux
comp_flags_common应包含-D_REENTRANT;bind_shobj_prog应为bind_so_unix;bind_shobj_flags应包含-L<rti_dir>/lib。对于 DMSO,
comp_flags_c++_specific偏好应包含-I<rti_dir>/include。对于 MÄK,
comp_flags_c++_specific偏好应包含-I<rti_dir>/include -DDT_USE_DLL -DRTI_USES_STD_FSTREAM。上述设置中的 <rti_dir> 是 RTI 目录,如控制器构建输出中所示(见步骤 6 的第 4 步)。
bind 设置确保 DMSO RTI 针对 TAO 和 CORBA 的支持库屏蔽发布目录中的不同版本。
Windows
对于 DMSO,
comp_flags_c++_specific偏好应包含/I <rti_dir>\include。对于 MÄK,
comp_flags_c++_specific偏好应包含/I <rti_dir>\include /DDT_USE_DLL /DRTI_USES_STD_FSTREAM。对于 MÄK,
bind_shobj_libs偏好应包含/LIBPATH:<rti_dir>\lib。确保 <rti_dir> 不包含任何空格。如果有空格,确定不含空格的表示形式,其中会包含 ~,例如
c:\progra~1 for c:\Program Files。 -
启动 OPNET 联邦成员。指定环境文件并通过输入以下命令启动 OPNET Debugger(ODB):
op_runsim -net_name <your_initials>_HLA_Tutorial-2Planes -kernel_type development -m32 -ef HLA_Tutorial -debug系统会编译若干名称形如 hla_cosim_… 的外部文件,以及 hla_cosim 和 Plane 进程模型。ODB 提示在若干消息之后出现,如图 2 所示。如果 ODB 提示没有出现,你可能需要设置 LD_LIBRARY_PATH 环境变量以包含 Riverbed 库。参见第 2 章“安装支持”第 1 页。
使用 OPNET Debugger
在本节中,你使用 OPNET Debugger(ODB)和 RTI 使 Riverbed 和 controller_tutorial 两个联邦成员在时间上向前推进。当 OPNET 联邦成员完成初始化后,它开始接收交互并发出自己的交互。
为什么使用 ODB?为什么不直接让仿真运行?
本教程使用 ODB,以便你可以逐个执行仿真事件。这使你能够看到两个联邦成员之间的交互。此外,由于 ODB 允许你逐个对象地监视映射过程,你可以立即精确定位这一关键过程中出现的任何问题。
步骤 8:启动 Modeler 仿真
-
输入 next(或 n),将 Modeler 仿真推进到第一个初始化事件。
-
对于 MÄK RTI:
控制器可能正在阻塞 join 操作。要解除阻塞:
- 转到运行控制器的 shell。
- 按 <return> 让 RTI 支持获得一些处理时间。
- 返回 ODB console。
你应该看到以下消息:
odb> n Loading Config File: <rti_dir>/rid.mtl DtTcpSocket connecting to 127.0.0.1 Using TcpSocket with 50000 byte buffer (Client) Using MAK Technologies’ RTI version 3.1.1-HLA1.3 for GNU C++ version 3.4.6 20060404 (Red Hat 3.4.6-3) Reading Fed file: HLA_Tutorial.fed Setting max UDP packet size to 15000 bytes NetSocket ok for port 4000 to 229.7.7.7在 rtiexec console 或 shell 中(如果没有图形界面),你将看到以下内容:
Using TcpSocket with 50000 byte buffer (Server) Create: execution HLA_Tutorial already exists. Join: federate OPNET has joined HLA_Tutorial with handle 2.如果你有图形界面,你将看到以下内容:
图 2:对于 Windows:联邦成员 OPNET 加入 HLA Tutorial

Simulationodb> n loading config file: C:\Mak\makRTI <version>\rid.mtl____________________________ (ODB 15.5.A: Event) ____________________________ * Time : 0.0 sec, [0s] * Event : execution ID (0), schedule ID (#4), type (remote intrpt), (Forced) * Source : Simulation Kernel * Data : code(123), ev_state(0x0012EBFC) > Module : top.HLA Interface.hla13 [Objid=4] (esys module)注意: ev_state (0012EBFC) 因具体运行而异,将与所示的不同。
-
对于 DMSO RTI:
在提示符处输入 n:
odb> n你应该看到以下消息:
Using RID file ‘<working_dir>/RTI.rid’. "RtiVnMulticast.cpp", line 298: Query mcast sender sendbuf size returned 131072 "RtiVnMulticast.cpp", line 715: Query mcast receiver rcvbuf size returned 131072结果: 在 RTI executive 窗口中,将出现以下消息:
Federate OPNET is JOINING federation HLA_Tutorial at <date & time>
-
-
再次输入 n 以移动到下一个 Modeler 仿真事件。
结果: 出现 fly0 的 begin simulation interrupt 事件横幅。如果你没有看到该横幅,请执行以下操作:
- 转到运行控制器的 shell。
- 按 <return> 让 RTI 支持获得一些处理时间。
- 返回 ODB console。
-
再输入几次 n。
结果: 前四个步骤初始化并执行每个 Modeler 飞机的 regular interrupt。第五步时,控制器窗口中没有进展显示:Riverbed 被阻塞,直到另一个联邦成员推进时间。
-
在控制器窗口中输入 t 1 推进时间:
[Time: 0] Enter command: t 1 [Time: 1]结果: 这使得 Riverbed 能够推进到仿真时间 1:
____________________________ (ODB 14.0.A: Event) ____________________________ * Time : 1.0 sec, [1s] * Event : execution ID (5), schedule ID (#5), type (regular intrpt) * Source : Simulation Kernel * Data : none > Module : top.fly0.plane [Objid=9] (processor) -
在控制器联邦成员命令窗口中输入 q,让控制器退出联邦。
[Time: 1] Enter command: q结果: 控制器通过显示以下内容响应
Done with event loop, leaving the federationRTI executive 以下列方式之一响应:
对于 MÄK,没有图形界面:
Resign: federate 1 has resigned HLA_Tutorial Destroy: execution HLA_Tutorial has federates joined对于 MÄK,有图形界面:
图 3:对于 Windows:控制器离开联邦

对于 DMSO:
Federate ./controller_tutorial is RESIGNING federation HLA_Tutorial at <date & time> -
在 OPNET 联邦成员命令窗口中输入 q 退出 ODB。
结果: fedex 进程终止(因为最后一个联邦成员刚刚终止并请求结束联邦)。你应该在 RTI executive 窗口中看到一条指示联邦已终止的消息:
对于 MÄK,没有图形界面:
Resign: Federate 2 has resigned HLA_Tutorial Destroy: execution HLA_Tutorial destroyed对于 MÄK,有图形界面:
图 4:对于 Windows:联邦终止

对于 DMSO:
Federate OPNET is RESIGNING federation HLA_Tutorial at <date & time> Removed federation HLA_Tutorial at <date & time> fedex shutting down.
检查当前的 Plane 进程模型
在本节中,你检查当前的 Plane 进程模型,以理解其结构。在下一节中,你将修改此模型以接收交互。
步骤 9:检查 Plane 进程模型
-
检查 Plane 进程模型。在 Modeler 窗口中,选择 File > Open,在 "Files of type" 菜单(Windows)或 Filters 菜单(Linux)中选择 Process Model,然后选择 Plane 进程模型。
结果: Plane 进程模型出现。

-
双击 init 状态的上半部分。
结果: 出现 Enter Executives。
parent_id = op_topo_parent (op_id_self());这段代码初始化状态变量 parent_id,其中包含父节点的 ID。该变量用于设置节点的 bearing 和 ground speed 属性。
-
关闭 init 状态的 Enter Executives。
-
打开 wait 状态的 Exit Executives。
结果: 出现 Exit Executives。
if (op_intrpt_type () == OPC_INTRPT_REGULAR) { double dummy; /* just check position to have animation updated */ op_ima_obj_pos_get (parent_id, &dummy, &dummy, &dummy, &dummy, &dummy, &dummy); }在此状态下,进程模型等待事件。主要关注的事件是传入的交互。该状态还每秒接收 regular interrupt,节点使用它来在动画显示中更新其位置。
-
检查状态变量。
结果: 一个状态变量 parent_id,是父节点的 ID。
修改 Plane 进程模型以接收交互
现在你已准备好进行更改,使 OPNET 联邦成员中的飞机能够根据从控制器联邦成员接收的交互修改其 bearing 和 ground speed。为此,你将
- 创建一个用于存储交互内容的数据包格式。
- 在映射文件中定义交互类与数据包格式之间的映射。
- 修改 Plane 进程模型,使其请求交付该类的交互。
创建 Plane_Order 数据包格式
为什么要创建数据包格式?
创建数据包格式是因为 HLA 交互在 Riverbed 中可以映射为数据包。Riverbed 数据包不是通常意义上的通信数据包;它只是代表 HLA 交互的实体。HLA 参数以 Riverbed 数据包字段表示。
步骤 10:创建 Plane_Order 数据包格式
-
选择 File > New,在下拉列表中选择 Packet Format,然后单击 OK。
-
创建一个由两个字段(bearing 和 ground speed)组成的数据包格式,每个字段的类型为 floating point。
结果: 完成的数据包应如下所示:

-
将数据包格式保存为 Plane_Order。
-
关闭 Packet Format Editor。
在类映射文件中将 Order 映射到 Plane_Order
在本节中,你将把 HLA 交互类 Order 映射到数据包格式 Plane_Order。
步骤 11:在类映射文件中将 Order 映射到 Plane_Order
-
在你选择的文本编辑器中打开 HLA_Tutorial.map。
-
添加下面以粗体显示的文本。
(mapping version 2 (interactions (class Order Plane_Order (parameter bearing bearing double) (parameter speed "ground speed" double) ) ) )此映射表明,
.fed文件中定义的 HLA 交互类 Order 映射到数据包格式 Plane_Order。交互参数 “bearing”(double 类型)映射到数据包字段 “bearing”。类似地,交互参数 “speed”(double 类型)映射到数据包字段 “ground speed”。 -
保存修改后的文件。
请求交付 Order 交互
飞机的进程模型必须向 RTI 请求某些交互类,并将传入的交互实例交付给适当的节点。HLA Kernel Procedure op_hla_interaction_pk_register() 用于这些目的。
步骤 12:请求交付 Order 交互
-
单击 Process Editor 的窗口以激活它。
-
选择 Code Blocks > Header Block(或单击 Edit Header Block 工具栏按钮)。
-
添加下面以粗体显示的文本。
#include <string.h> #include <stdio.h> /* stream index where packets are delivered */ #define PLANE_ORDER_STREAM_INDEX 0 -
保存 Header Block。
-
打开 init Enter Executives。
-
添加下面以粗体显示的文本:
parent_id = op_topo_parent (op_id_self()); /* register for interactions */ op_hla_interaction_pk_register (op_id_self(),"Plane_Order", PLANE_ORDER_STREAM_INDEX);此请求使 hla_cosim 进程模型将名为 Plane_Order 的数据包通过输入流 PLANE_ORDER_STREAM_INDEX 发送到 Plane。
现在 Plane 进程模型的 wait 状态可以接收两种事件:
- 用于动画更新的 regular interrupt
- 指示交互已交付的 stream interrupt
-
保存 init enter execs。
-
保存(但不要关闭)进程模型。
处理传入的交互
当它在 PLANE_ORDER_STREAM_INDEX 上收到 stream interrupt 时,Plane 进程模型需要提取 bearing 和 ground speed 值,然后更新 Plane 节点的属性。在本节中,你修改 Plane 的 wait Exit Executives 以实现这一点。
步骤 13:处理传入的交互
-
打开 wait state Exit Executives。
-
添加下面以粗体显示的文本。
if ((op_intrpt_type () == OPC_INTRPT_STRM) && (op_intrpt_strm () == PLANE_ORDER_STREAM_INDEX)) { Packet * pk; double speed, bearing; char gs [40]; /* extract information from packet */ pk = op_pk_get (PLANE_ORDER_STREAM_INDEX); op_pk_nfd_get_dbl (pk, "bearing", &bearing); op_pk_nfd_get_dbl (pk, "ground speed", &speed); op_pk_destroy (pk); /* update node attributes */ snprintf (gs, sizeof(gs), "%f kilometer/sec", speed); op_ima_obj_attr_set_dbl (parent_id, "bearing", bearing); op_ima_obj_attr_set_str (parent_id, "ground speed", gs); } else if (op_intrpt_type () == OPC_INTRPT_REGULAR) { double dummy; /* just check position to have animation updated */ op_ima_obj_pos_get (parent_id, &dummy, &dummy, &dummy, &dummy, &dummy, &dummy); } -
保存 Exit Executives。
-
选择 Compile > Compile Code(或单击 Compile Process Model 工具栏按钮)以编译进程模型。
生成传出数据
当 Plane 进程模型收到改变 bearing 或 ground speed 的指令后,它应生成一个确认收到该指令的交互。该交互返回飞机的 ID 及其收到 Plane_Order 数据包时的位置。
要生成确认交互,你需要
- 创建一个映射到 Order_Reply 交互类的数据包格式。
- 在映射文件中定义交互类与数据包格式之间的映射。
- 修改 Plane 进程模型,使其生成并向 hla_cosim 进程模型发送一个包含飞机 ID 和位置的确认数据包。
创建 Plane_Ack 数据包格式
首先,创建一个映射到 Order_Reply 交互类的数据包格式。
步骤 14:创建 Plane_Ack 数据包格式
-
选择 File > New,在下拉列表中选择 Packet Format,然后单击 OK。
-
按照下表所述创建包含三个字段的数据包格式。
表 4:Plane_Ack 数据包格式
名称 类型 id integer change_lat floating point change_long floating point 结果: 完成的数据包应如下所示:

-
将数据包格式保存为 Plane_Ack。
-
关闭 Packet Format Editor。
在类映射文件中将 Order_Reply 映射到 Plane_Ack
接下来,在映射文件中定义交互类与数据包格式之间的映射。
步骤 15:在类映射文件中将 Order_Reply 映射到 Plane_Ack
-
在你选择的文本编辑器中打开 HLA_Tutorial.map。
-
添加下面以粗体显示的文本。
(mapping version 2 (interactions (class Order Plane_Order (parameter bearing bearing double) (parameter speed "ground speed" double) ) (class Order_Reply Plane_Ack (parameter id id long) (parameter change_lat change_lat double) (parameter change_long change_long double) ) ) )此映射表明,
.fed文件中定义的 HLA 交互类 Order_Reply 映射到数据包格式 Plane_Ack。交互参数 “id”(long 类型)映射到数据包字段 “id”。类似地,交互参数 “change_lat” 和 “change_long”(均为 double 类型)映射到数据包字段 “change_lat” 和 “change_long”。 -
保存修改后的文件。
生成并发送确认交互
最后,必须修改进程模型以发送 Plane_Ack 数据包。
步骤 16:生成并发送确认交互
-
在 Plane 进程模型中,打开 wait state Exit Executives。
-
添加下面以粗体显示的文本。
char_gs[40]; double latitude, longitude, dummy; /*extract information from packet*/ ... op_ima_obj_attr_set_str (parent_id, "ground speed", gs); /* Obtain current position */ op_ima_obj_pos_get (parent_id, &latitude, &longitude, &dummy, &dummy, &dummy, &dummy); /* Generate reply */ pk = op_pk_create_fmt ("Plane_Ack"); op_pk_nfd_set_int32 (pk, "id", parent_id); op_pk_nfd_set_dbl (pk, "change_lat", latitude); op_pk_nfd_set_dbl (pk, "change_long", longitude); op_hla_interaction_pk_send (pk, OPC_HLA_DELIVER_NOW); } else if (op_intrpt_type () == OPC_INTRPT_REGULAR) -
保存 Exit Executives。
-
选择 Compile > Compile Code(或单击 Compile Process Model 工具栏按钮)以编译进程模型。
-
保存并关闭 Plane 进程模型。
准备仿真
在本节中,你将准备仿真。
步骤 17:准备仿真
-
在新窗口中启动 RTI executive(如果之前的已停止)。
-
在另一个窗口中,移动到控制器所在的目录(可能是你的工作目录)。输入此命令重新启动控制器:
Linux
./controller_tutorial HLA_TutorialWindows
.\controller_tutorial.exe HLA_Tutorial -
在 OPNET 联邦成员窗口中,启动 Modeler 联邦成员。指定环境文件并通过输入以下命令之一启动 OPNET Debugger(ODB):
op_runsim -net_name <your_initials>_HLA_Tutorial-2Planes -kernel_type development -m32 -ef HLA_Tutorial -debug结果: 出现 ODB 提示。
启动仿真
在本节中,你将看到修改的结果:OPNET 联邦成员订阅 Order 类,飞机接收 Plane_Order 数据包。
步骤 18:启动仿真
-
输入 n 两次。
注意: 对于 MÄK,记得转到控制器窗口并按 <return>,以允许 OPNET 加入联邦。
结果: OPNET 加入联邦。ODB 窗口中出现以下消息:
* Event : execution ID (<1>), schedule ID (#<0>), type (begin sim intrpt) > Module : top.fly0.Plane [objid=9](processor)前面的事件横幅表明 HLA Interface 模型的初始化已完成,第一个 Plane 进程模型的初始化即将开始。
如果仿真意外终止(你会看到类似 “federate resigning from federation” 的消息),你的映射文件可能有误。检查
.map文件,核实在类映射文件中将 Order 映射到 Plane_Order和在类映射文件中将 Order_Reply 映射到 Plane_Ack中给出的更改。 -
为验证预期映射已建立,使用
proldiag命令查看 hla_interactions,在 ODB 提示处输入以下内容:proldiag 0 hla_interactions结果: 显示已定义的交互映射列表。这些映射与你在类映射文件中输入的映射相同。
*** 2 Interaction class mappings defined [1] Mapping between HLA interaction class "Order" and OPNET packet format "Plane_Order" Interaction class RTI Handle: 1 2 Parameters HLA OPNET Type RTI Handle [1] bearing "bearing" double 0 [2] speed "ground speed" double 1 OPNET federate neither publishes nor subscribes to this class No recipient of incoming interactions of this class [2] Mapping between HLA interaction class "Order_Reply" and OPNET packet format "Plane_Ack" Interaction class RTI Handle: 2 3 Parameters HLA OPNET Type RTI Handle [1] id "id" long 2 [2] change_lat "change_lat" double 0 [3] change_long "change_long" double 1 OPNET federate neither publishes nor subscribes to this class No recipient of incoming interactions of this class -
输入 n 直到看到 regular interrupt 事件。事件横幅应类似于以下内容:
* Event : execution ID (<3>), schedule ID (#<1>), type (regular intrpt) > Module : top.fly0.plane [objid=9](processor) -
在 OPNET 联邦成员命令窗口中再输入 n 两次。
结果: 注意此时不会出现 ODB 提示。
-
在控制器联邦成员命令窗口中输入 time n,其中 n 是下一个连续的数字。如果当前时间是 0,例如,你将输入 time 1。
结果: 现在 HLA 类 Order 与 Riverbed 数据包格式 Plane_Order 之间的映射已完成。
-
ODB 的
proldiag命令配合hla_interactions将显示此映射的效果。在 ODB 提示处输入此命令:proldiag 0 hla_interactions结果: 出现以下响应。实际的 objid 可能不同,具体取决于你在网络中创建节点的顺序:
*** 2 Interaction class mappings defined [1] Mapping between HLA interaction class "Order" and OPNET packet format "Plane_Order" . . . OPNET federate subscribes to this class 2 recipients of incoming interactions of this class: Objid Stream index 9 0 10 0此响应表明:
- OPNET 联邦成员订阅 HLA 交互类 Order。
- 飞机节点(“2 recipients”)将接收 Riverbed 数据包 Plane_Order。这些数据包是 HLA 交互 Order 的 Riverbed 表示。
在 OPNET 联邦成员中控制飞机运动
在本节中,你将看到所添加类映射的结果。OPNET 联邦成员中的飞机根据它们接收的 Plane_Order 交互修改其 bearing 和 ground speed,并且 OPNET 联邦成员发送一个确认收到 Plane_Order 交互的交互 Plane_Ack。
步骤 19:在 OPNET 联邦成员中控制飞机运动
-
在 OPNET 联邦成员命令窗口中,输入以下命令让仿真继续到时间 3:
odb> tstop 3 Added breakpoint #0: stop at time = (3.0 sec [3s]) odb> cont -
在控制器联邦成员命令窗口中输入
fly命令,改变 OPNET 联邦成员中飞机的 bearing 和 ground speed。输入以下命令(以粗体显示):[Time: 1] Enter command: fly 2 90 200结果: 此命令生成一个将在时间 2 交付的 Plane_Order 交互。bearing 将变为 90 度,ground speed 变为 200 km/sec。
-
输入以下命令(以粗体显示)让 OPNET 联邦成员推进到时间 2:
[Time: 1] Enter command: time 2如果出现以下消息,忽略它:
Module (4), (top.HLA Interface.hla13) From procedure: hla13_cosim_compat [listen exit execs] HLA Interface: hla_cosim process model info type "Interaction_Control" not handled by default model -
现在交互已被 OPNET 联邦成员接收。在时间 2 加上 lookahead(时间 2.1),飞机应发回一个 Plane_Ack 交互。为验证这一点已发生,输入以下命令(以粗体显示)使联邦时间推进:
[Time: 2] Enter command: time 3结果: 时间推进后,控制器报告传入的交互(Plane_Ack 交互)已被接收,并且 Plane 节点改变了它们的运动。控制器联邦成员命令窗口中的响应类似于以下内容:
Incoming interaction at time 2.1 Node 2 has changed movement at 44, -31 Incoming interaction at time 2.1 Node 3 has changed movement at 63, 82 [Time: 3] Enter command: -
控制器报告了飞机 bearing 和 ground speed 的更改已经发生。因此,飞机的 x 位置和 y 位置属性也已改变。
注意: 在生成位置改变与控制器接收该信息之间存在一个延迟(即 “lookahead”)。因此,当位置信息出现在控制器中时,节点已经移动得更远。因此,用 ODB 打印节点的属性将不会得到相同的值。
-
你现在可以终止仿真:
- 6.1 在控制器联邦成员命令窗口中输入 q,让控制器退出联邦。
- 6.2 在 OPNET 联邦成员命令窗口中输入 q 退出 ODB。
- 6.3 关闭所有剩余的窗口。
总结
本入门级 HLA 教程到此完成。在本教程中,你学会了
- 使用 HLA 专用属性配置仿真
- 准备类映射文件
- 创建向 OPNET 联邦成员交付交互的数据包
- 准备一个将 HLA 交互类和参数映射到 Riverbed 数据包格式和字段的类映射文件
- 修改进程模型以接收代表传入交互的数据包
- 修改进程模型以生成代表传出交互的数据包