编辑 lgrConfig.xml

lgrConfig.xml 文件包含在你启动 Logger 时运行的命令。默认配置文件使用初始化命令启动 Logger,以加载插件并连接到 HLA 网络。

每个 ./bin 目录都有一个 lgrConfig.xml 版本,针对该目录中 Logger 版本所使用的协议进行了定制。lgrConfig.xml 的默认版本位于 ./data/backups 中。这些文件按协议命名,因此如果你需要将某个特定的 lgrConfig.xml 恢复为默认值,你知道该使用哪一个。你也可以通过 --configFile 命令行选项指定某个默认版本来使用它。

该文件使用 XML 语法编写。它本质上包含两个部分——变量定义和命令。变量定义在 <defaults> 块中指定。命令在两个 <commands> 块之一中以一系列 <command> 条目指定。你可以在配置文件中使用任何 Logger 命令。(有关命令列表,请参阅“Command Descriptions“(第 470 页)。

**注意:**某些命令行选项在配置文件的 defaults 部分中有一个与之匹配的变量名。如果你更改或删除默认配置文件中的某个变量名,将会破坏与之关联的命令行选项。

此外,如果你添加一个新变量并给它一个与现有命令行参数匹配的名称,你将得到不可预期的行为。注意新变量的命名方式应能消除发生这种错误的任何风险。

以下是一个针对 HLA 的配置文件的深度编辑版本,展示了主要组成部分:

<lgrConfig>
   <!-- Variable formatting -->
   <defaults>
      <var name="messageLevel" type="int" value="2"/>
      <!-- HLA Settings -->
      <var name="execName" type="string" value="VR-Link"/>
      <var name="federateName" type="string" value="Logger"/>
      <var name="fedFileName" type="string" value="VR-Link.fed"/>
      <var name="fomMapperLib" type="string" value=""/>
      <var name="fomMapperInitData" type="string" value=""/>
      <var name="rprFomVersion" type="double" value="1.0"/>
      <var name="rprFomRevision" type="int" value="1"/>
      <var name="ignoreAdvisoriesValue" type="bool" value="false"/>
      <var name="useEmptyFomMapperValue" type="bool" value="false"/>
   </defaults>

   <!-- Initialize commands executed after the command line is parsed -->
   <!-- Parameter variables must be defined in the defaults group -->
   <commands name="init">
      <command domain="System" protocol="None" command="SetNotifyLevel">
         <param name="lgrLevel" var="messageLevel"></param>
      </command>
   </commands>

   <commands name="startup">
      <command domain="Simulation" protocol="HLA 13"
         command="SetConnectionParameters">
         <param name="federateName" var="federateName"></param>
         <param name="federationName" var="execName"></param>
         <param name="fedFile" var="fedFileName"></param>
         <param name="fomVersion" var="rprFomVersion"></param>
         <param name="fomRevision" var="rprFomRevision"></param>
         <param name="fomMapper" var="fomMapperLib"></param>
         <param name="fomMapperData" var="fomMapperInitData"></param>
         <param name="ignoreAdvisories" var="ignoreAdvisoriesValue"></param>
         <param name="useEmptyFomMapper" var="useEmptyFomMapperValue"></param>
      </command>
      <command domain="Simulation" protocol="None" command="Connect"/>
   </commands>
</lgrConfig>

命令语法

不带参数的命令采用如下格式:

<command domain="domain" protocol="protocol" command="command"/>

其中:

以下是一个不带参数的命令示例:

<command domain="Simulation" protocol="None" command="Connect"/>

带参数的命令采用如下格式:

<command domain="domain" protocol="protocol" command="command">
   <param name="name" var="variableName"></param>
</command>

其中:

以下是一个带参数的命令示例:

   <command domain="System" protocol="None" command="SetNotifyLevel">
      <param name="lgrLevel" var="messageLevel"></param>
   </command>

变量语法

变量条目采用如下格式:

 <var name="variableName" type="type" value="value"/>

其中:

  • variableName 是由配置文件 commands 部分中的命令指定的变量。
  • type 是该变量的参数类型,如“Command Descriptions“(第 470 页)中为每个命令参数所定义。
  • value 是你想赋给该变量的值。

例如:

<var name="messageLevel" type="int" value="2"/>

向 lgrConfig.xml 添加命令

向配置文件添加命令时,你通常会将命令添加到 startup 命令部分。只有在要添加一个用于加载插件的命令时,才会将命令添加到 init 部分。

假设你想向 lgrConfig.xml 添加 NewFile 命令。该命令创建一个用于记录的新文件。如果你将它添加到配置文件中,那么每次启动 Logger 时,它都会创建一个具有指定名称的新文件。

过程 146:示例:向 lgrConfig.xml 添加命令

  1. 在 <commands name="startup"> 部分中添加一个新命令,类似于以下内容:

    <commands name="startup">
       <command domain="Recorder" protocol="None" command="NewFile">
          <param name="filename" var="newfile"></param>
       </command>
    </commands>
    

    在该命令定义中,域是 Recorder,你之所以知道这一点,是因为 NewFile 列在“Command Descriptions“(第 470 页)中 Recorder 域的命令之中。Protocol 是 None,因为该命令与协议无关。该命令是 NewFile。

    命令定义表明 NewFile 带有一个类型为 string 的参数 filename。因此,向该命令添加一个参数定义。名称是 filename,它必须与定义中的拼写完全一致。变量名是由用户定义的名称,将在变量定义中定义。

  2. 为变量 newfile 添加一个变量定义,类似于以下内容:

    <var name="newfile" type="string" value="newfilename.lgr"/>
    

    名称 newfile 与命令条目中的变量名相匹配。类型是命令定义中列出的类型。值是你想赋的任何值,在本例中,就是你想赋予将在启动时创建的 Logger 文件的名称。

向 lgrConfig.xml 添加字符串列表

某些命令需要指定多个字符串。与其他命令一样,你指定一个变量来接收数据,然后以 listitem 列表的形式提供这些字符串。例如,下面是为 HLA 指定订阅列表的方式:

过程 147:示例:为 HLA 指定订阅列表

  1. 在配置文件的命令部分中,为 SetSubscriptionLists 命令添加一个条目,如下所示:

    <!-- To Disable auto-connection remove this command -->
       <command domain="Simulation" protocol="None" command="Connect"/>
    </commands>
    
    <command domain="Simulation" protocol="HLA 13"
       command="SetSubscriptionLists">
       <param name="objectClasses" var="objectSubscriptionList"></param>
       <param name="interactionClasses" var="interactionSubscriptionList">
          </param>
    </command>
    

    由于 SetSubscriptionLists 命令带有两个参数,我们为其定义两个参数。

    **注意:**我们包含了 Connect 命令(它位于默认配置文件中),因为在发出 SetSubscriptionLists 命令之前,Logger 必须已经连接。使用 Logger 命令时,你必须考虑它们所具有的任何前置条件。

  2. 为命令中定义的每个参数添加一个变量定义。在每个变量定义中,为你想包含在列表中的每个字符串包含一个 listitem。

    <var name="objectSubscriptionList" type="list" listtype="string">
       <listitem>ObjectRoot.BaseEntity.PhysicalEntity.Platform.Aircraft
          </listitem>
       <listitem>ObjectRoot.BaseEntity.PhysicalEntity.Radio</listitem>
    </var>
    
    <var name="InteractionSubscriptionList" type="list" listtype="string">
       <listitem>InteractionRoot.WeaponFire</listitem>
    </var>
    

    **注意:**此示例创建的订阅列表与“在命令行上使用 Logger 命令”(第 468 页)和“在文本界面中使用 Logger 命令”(第 469 页)中的示例命令所创建的订阅列表完全相同。

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