执行细节
本节描述使用由 HLA_Interface 节点创建的 Federate Ambassador 的 HLA 仿真行为。
HLA 初始化包括创建并加入联邦、建立时间管理,以及向 esys 模块交付初始化回调,它发生在仿真事件执行之前。如果你使用 ODB,则 HLA 初始化事件在你执行第一个 odb> 提示符之后发生。
在仿真过程中,HLA-PM 使用 RTI 服务和 Modeler Simulation Kernel 过程。HLA-PM:
- 读取 HLA Class Mapping File 仿真属性所引用的类映射文件,并执行相应的 RTI 初始化。
- 接收来自其它联邦成员的 HLA 事件,并根据 Modeler 动作参与时间推进。
- 接收 HLA 属性更新,更新相应的 Modeler 属性,并在有请求时将这些更新通知其它节点。
- 接收 HLA 交互,将交互转换为数据包,并将数据包转发给合适的进程模型。
- 如果被更改的对象映射到某个 HLA 对象,则将 Modeler 属性的更改发布(给 RTI)。
- 为其它节点提供向 RTI 发送 HLA 交互的能力。
加入联邦
初始化之后,HLA-PM 要么自己发起联邦,要么加入由其它联邦成员发起的联邦。
要让 Modeler 发起联邦,请正确设置 HLA Create Federation 和 HLA Federation Name 仿真属性。HLA-PM 会忽略创建已存在联邦的尝试。详细信息见“HLA-PM Attributes”第 12 页。
如果 Riverbed 联邦成员不是发起者,它会尝试加入 HLA Federation Name 仿真属性所指定的联邦。如果失败,Modeler 仿真终止。
如果加入成功,HLA-PM 随后:
-
向 RTI 表明其时间管理模式(time-constrained 和 time-regulating)。
-
启动时间管理(见“Managing and Advancing Time”第 8 页)。
-
读取类映射文件。
-
遍历网络模型,登记可能与 HLA 对象映射的 Modeler 对象,并在映射文件有规定时创建相应的 HLA 对象。
-
注册并更新应当创建的 HLA 对象。
在 HLA-PM 完成初始化之前,网络模型的其它部分可能尝试注册交互处理(见交付交互),或生成交互或属性更新(见生成外出数据)。这些请求将被推迟,直到初始化完成。
创建对象
联邦中的每个对象至少被表示两次:一次作为 Modeler 对象,一次作为 HLA 对象。有且只有一个联邦成员创建 HLA 表示;其它联邦成员只是发现新创建的对象,并(通常)创建它们自己的内部表示。
RTI 为每个创建的对象关联一个唯一的 HLA ID。其它联邦成员通过发现回调得知该创建,回调向它们提供新对象的类和 ID。
由于 Modeler 不会在网络或模块级别动态创建对象,所有必需的 Modeler 表示必须在仿真启动时创建。这意味着 Modeler 需要知道:
- 要创建哪些 HLA 对象。
- 如何将发现的 HLA 对象映射到 Modeler 对象。
创建 HLA 对象
如果类映射文件的 <CreateMode> 规则包含创建模式 “create”,则 HLA-PM 在初始化阶段为每个匹配该规则的 Modeler 对象创建一个 HLA 对象(该规则的详细信息见对象与属性映射)。HLA 对象的名称使用 <CreateMode> 规则中指定的属性生成。
如果类映射文件的 <CreateMode> 规则包含创建模式 “dynamic”,进程模型可以动态请求将 Modeler 对象映射到 HLA 对象,使用 op_hla_obj_create_notify() Kernel 过程。RTI 在可能的情况下创建相应的 HLA 对象。随后更新该 HLA 对象的属性。
映射发现的对象
如果类映射文件的 <CreateMode> 规则包含创建模式 “discover”,则发现的对象必须被唯一匹配:HLA 对象与 Modeler 对象相互一一对应。
发现时,HLA-PM 接收被发现对象的类、ID 和名称。
- 如果指定了 name_match,则立即执行匹配。
- 如果指定了 attr_match,则匹配被推迟,直到收到第一组属性更新。这些就是 Modeler 在类映射文件中通过在
<PS>规则里放置 “S” 所订阅的属性。name_match 和 attr_match 规则的详细信息见对象与属性映射。
如果 HLA-PM 无法映射某个发现的对象,它会丢弃该对象的后续更新,并在控制台上写出警告。
如果映射成功,HLA-PM 将尝试取得被发现对象中标记为发布的任何属性的所有权。
销毁对象
RTI 对象可以在仿真期间被销毁。销毁可以发生在其它联邦成员中,也可以发生在 Modeler 仿真本身中。
- 如果销毁发生在其它联邦成员中,该事件被报告给 HLA-PM,HLA-PM 从其类映射文件中移除相应的映射。Modeler 对象本身仍然存在并继续执行。
- 如果销毁发生在 Modeler 仿真中,进程模型使用
op_hla_obj_destroy_notify()请求销毁 RTI 对象。Modeler 对象本身仍然存在并继续执行。
发送通知
当 HLA 对象被发现或创建时,该对象被映射到一个 Modeler 对象。类似地,当 HLA 对象被销毁时,Modeler 对象被解除映射。内核过程 op_hla_obj_notification_enable() 请求在发生这两种事件中的任一种时通知调用它的进程模型。
当映射或解除映射发生时,将生成一个带有指定事件代码的远程中断。
其它进程模型可以使用 op_hla_obj_info_get() 和 op_hla_id_hla_to_opnet_map() 向 HLA-PM 查询 Modeler 与 HLA 之间的 ID 映射。
处理传入数据
传入数据有两种形式:
- 属性更新
- 交互
默认情况下,DES 引擎作为 time-constrained 联邦成员工作。因此,只有当联邦时间推进时,Modeler 的时间才推进。只有当更新或交互的时间戳与 Modeler 时间一致时,它们才会被处理。你可以通过仿真属性更改这一行为(见“HLA-PM Attributes”第 12 页)。
更新属性
当某个 HLA 对象的属性被一个联邦成员修改时,所有订阅该属性的联邦成员都会收到带有新值的更新。在 Riverbed 联邦成员中,更新由 HLA-PM 接收。收到更新后,HLA-PM:
- 确定哪个 Modeler 对象应当接收该更新或建立映射。如果使用 attr_match 规则映射对象,属性更新可能引发一次映射事件(见映射发现的对象)。
- 更新已映射的 Modeler 属性。
- 如有请求,HLA-PM 使用带有已更新属性列表的远程中断,通知已注册的进程模型属性更新已经执行。
下表列出了与属性更新相关的 Kernel 过程。详细信息见 Editors Reference 手册中的“Project Editor”第 89 页。
表 6:属性更新 KP
| 用途 | Kernel 过程名 |
|---|---|
| 请求属性更新通知 | op_hla_obj_notification_enable() 第 33 页 |
| 取消属性更新通知 | op_hla_obj_notification_disable() 第 31 页 |
| 检索已映射对象的已修改属性列表 | op_hla_attr_update_list_get() 第 8 页 |
有关用于打包属性值的格式说明,见表示属性与参数值。
交付交互
交互由联邦成员提供给 RTI,RTI 再将其交付给每个注册了该类交互的联邦成员。在 Riverbed 联邦成员中,HLA-PM 接收该交互。如果至少有一个进程模型(HLA-PM 之外)请求了该交互,Modeler 就会为其注册。
接收交互后,HLA-PM 确定哪些进程模型已注册处理该特定类型的交互。随后 HLA-PM 使用交互/参数映射中描述的映射,将该交互转换为相应的 Modeler 数据包格式。如果交互映射中包含将特殊名称 <tag> 映射到数据包某个字段的条目,则随交互接收的任何 “tag” 值都会被放入数据包。
HLA-PM 只转换对应基数为 1 的整数或浮点数据类型的参数。其它参数对应的数据被直接复制到一个本地数据块(使用 op_prg_mem_alloc() Kernel 过程分配),并将指向该数据块的指针放入数据包的字段(该字段应定义为 Structure)。数据块及其大小使用 op_hla_interaction_pk_struct_get() 获取。接收方负责提取该数据块中实际存储的数据,并在使用后使用 op_prg_mem_free() 释放该数据块。交互处理模块负责使用 op_pk_destroy() 处置其收到的已转换数据包。
转换后的数据结构通过安排在交互时间的流中断交付给所有已注册的进程模型。
下表列出了与交互相关的 HLA Kernel 过程。详细信息见 Editors Reference 手册中的“Project Editor”第 89 页。
表 7:交互 KP
| 用途 | Kernel 过程 |
|---|---|
| 进程模型实例用于向 HLA-PM 注册其对特定数据包类型的兴趣 | op_hla_interaction_pk_register() |
| 进程模型实例用于取消其在 HLA-PM 中的现有注册 | op_hla_interaction_pk_deregister() |
有关用于打包参数值的格式说明,见表示属性与参数值。
生成外出数据
默认情况下,DES 引擎作为 time-regulating 联邦成员工作。这意味着 Riverbed 联邦成员发布的属性更新和交互的时间戳为当前联邦时间加上 lookahead(见“Managing and Advancing Time”第 8 页)。
更新属性
Riverbed 联邦成员必须向其它联邦成员通报任何 Modeler 对象已发布属性的变化。为履行这一职责,HLA-PM 保留已发布属性的副本,并定期检查相应对象以确定其属性值是否发生变化。检测到变化时,HLA-PM 生成属性更新。
你在 HLA Update Check Interval 仿真属性中指定检查之间的时间间隔。详细信息见“HLA-PM Attributes”第 12 页。
进程模型也可以通知 HLA-PM 某些属性已更新,且应立即通知 RTI。特定属性更改的指示方式是使用 op_hla_obj_attr_set() 而不是 op_ima_obj_attr_set()。这个 HLA 专用函数向 HLA-PM 通报该属性更改。
内核过程 op_hla_attr_change_notify() 通知 HLA-PM 应检查该对象的所有已发布属性是否发生变化。
生成交互
进程模型通过创建相应的数据包并经过程调用中断将其转发给 HLA-PM 来模拟 HLA 交互。HLA-PM 将数据包转换为交互并传递给 RTI,RTI 将其交付给所有感兴趣的联邦成员。
该过程如下所述。在下面的步骤中,模拟交互的进程模型被称为“源进程模型”,以区别于 HLA-PM。你必须在源进程模型中编写实现这些步骤的代码。执行 HLA-PM 步骤的代码已包含在 HLA-PM 中。
-
源进程模型创建一个数据包。
-
源进程模型使用
op_pk_nfd_set()为数据包赋予整数和浮点值。 -
源进程模型使用
op_prg_mem_alloc()为 Structure 字段(如果有)分配内存。它使用op_hla_interaction_pk_struct_set()赋予结构字段(使用已分配的字节块),并将数据块的所有权转移给 HLA-PM。 -
源进程模型使用
op_hla_interaction_pk_send()将数据包交付给 HLA-PM。该 KP 指定交互应当交付的时间(可以立即交付)。如果映射文件包含特殊 HLA 名称<tag>与数据包格式某个字段之间的映射,则 tag 值被放入数据包(见交互/参数映射)。Structure 类型的数据包字段应包含指向数据块的指针,这些块用
op_prg_mem_alloc()分配,并按表示属性与参数值中描述的打包约定填充。 -
HLA-PM 将数据包转换为 RTI 结构,然后销毁该数据包,并使用
op_prg_mem_free()释放结构块。
注: 虽然 RTI 在联邦成员之间交付交互,但它不会把交互交付回发起该交互的联邦成员。这意味着,如果你希望发起联邦成员中的其它进程模型收到该数据包,你必须为该任务编写显式代码,使用标准的
op_pkKP(例如op_pk_deliver())。
向 RTI 发送 HLA 事件
外出的属性更新和交互在 HLA-PM 恢复执行时被排入队列,等待传送给 RTI。
表示属性与参数值
你准备的 HLA Object Model Template 文档定义了用于属性与参数值的大多数数据类型的二进制表示。HLA-PM 执行以下数据转换:
- 在对象属性的 Modeler 表示(作为数据类型)与属性的 HLA 表示(作为打包的数据块)之间转换。
- 在数据包字段的 Modeler 表示(作为 integer 和 double 数据类型)与参数的 HLA 表示(作为整数和浮点数据类型)之间转换。
HLA-PM 不转换 structure 数据包类型。这些类型内部数据的编码由接收交互的进程模型完成。
下表展示了 HLA-PM 所使用的各种 HLA 类型的二进制表示。多字节数值按网络序存储。
表 8:HLA 数据类型的二进制表示
| HLA 类型 | 二进制表示 |
|---|---|
| float | IEEE 单精度浮点数,32 位 |
| double | IEEE 双精度浮点数,64 位 |
| short | 16 位 |
| unsigned short | 16 位 |
| long | 32 位 |
| unsigned long | 32 位 |
| long long | 64 位 |
| unsigned long long | 64 位 |
| char | 8 位,无符号 |
| boolean | 1 位,存储为 8 位,值位于最低有效位 |
| octet | 8 位,无符号 |
| string | 以 NULL 结尾的字符序列 |
| complex | 行的序列,每行由字段值的序列组成(基数由 Modeler 变量决定) |
HLA-PM 使用映射文件中提供的类型定义来编码或解码 HLA 属性与参数值。
Modeler 支持符号映射(symbol map),允许把值映射到字符串。编解码方案不支持符号映射,因此传递的是值本身而不是字符串。不要为将映射到 HLA 属性的 Modeler 属性定义符号映射。
注: 上表中列出的二进制表示不用于 tag 值。tag 值只是一个以 null 结尾的字符串。
数据的打包与解包
HLA-PM 代码包含一组类和运算符,用于基于“HLA 数据类型的二进制表示”表中的表示执行数据打包与解包。Sim_Hla_Ostream 按网络序打包数据。Sim_Hla_Istream 按主机序提取数据。
除 complex 外,表中所有类型都提供了运算符。还可以创建额外的运算符。
数据所有权
只有当某个联邦成员拥有相应属性时,该联邦成员才能修改该 HLA 属性。通常,属性的所有权可以在联邦成员之间传递,由 RTI 请求当前拥有者放弃所有权。在本版本中,Riverbed 联邦成员从不放弃所有权。这意味着 Riverbed 联邦成员拥有的属性不能被任何其它联邦成员修改。
结束仿真
Modeler 仿真完成时,Riverbed 联邦成员退出联邦。如果启用了 HLA Destroy Federation 仿真属性,HLA-PM 将尝试销毁联邦。如果其它联邦成员仍在联邦中,该尝试将失败。
更多信息见“HLA-PM Attributes”第 12 页。
调试信息
HLA-PM 及其相关函数提供调试信息,可用于 Simulation Debugger (ODB) 以及 ltrace 和 proldiag 命令。