Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ InTouch HMI

配置 BitLabels​.xml 和 aaBitLabelsSchema​.xsd 文件

配置 BitLabels​.xml 和 aaBitLabelsSchema​.xsd 文件

  • Last UpdatedSep 24, 2024
  • 1 minute read

BitLabels.xml 文件用于定义位标签信息,而 aaBitLabelsSchema.xsd 文件用于验证位标签信息。缺省条件下,这些文件不可用。

BitLabels.xml

BitLabels.xml 文件用于定义每个受支持位标签的标签。例如,Standard 位标签。

Showing how The BitLabels.xml file defines the labels of each supported Bit Label

要定义位标签,需要使用 Name 和 Type。例如:<Labels Name="Standard" Type="Default">

  1. Name:此处指定的名称会显示在“位标签”下拉列表组合框中。
    位标签名必须至少包含一个字母。有效字符为字母数字和特殊字符($、#、_)。位标签名的最大长度为 32。

  2. Type:标签的“Default”或“Name”。

每个 XML 可以包含多个 <Labels>。每个 <Labels> 包含一个或多个 <Label>。每个标签都包含 Name 和 Range 信息。例如:

<Labels Name="Standard" Type="Default">

<Label Name="B31" Range="0X80000000"/>

<Label Name="B30" Range="0X40000000"/>

<Label Name="B29" Range="0X20000000"/>

每个 <Label> 都将包含两个字段:

  1. Name:标签名和位标签名不区分大小写,标签名的最大长度为 4。在“位模式选择器”对话框中,选择“Standard”位标签时,将在第一个左上角显示标签名“B31”。

  2. Range:一个十六进制格式的整数,用于指定将哪个位应用于 Name。Range 包含 32 个位,其中只能有一个位设置为“1”。其它所有位都应该为“0”。但“ALMSTA”标签的“CRIT”标签和“PRI”标签除外。

    例如:

    在“Standard”标签中,将位“B31”指定给“0x80000000”。将十六进制数转换为二进制数后,将为“1000 0000 0000 0000 0000 0000 0000 0000”。这意味着,“B31”标签是最高位。

    <Label Name="B31" Range="0x80000000"/>

    在“Standard”标签中,将位“B5”指定给“0x20”。将十六进制数转换为二进制数后,将为“0000 0000 0000 0000 0000 0000 0010 0000”。由于前导 26 位都是 0,我们可以在 Range 值中忽略这些 0。

    <Label Name="B5" Range="0x20"/>

    验证位标签 XML 并显示“位模式选择器”对话框时,会应用以下规则:

    • 标签名和位标签名必须至少包含一个字母。有效字符为字母数字和特殊字符($、#、_)。
      <Label Name="B31" Range="0x80000000"/>

    • 每种标签类型的标签名必须是唯一的。一个标签名不能用于一个标签类型中的多个地方。

    • 位标签名可以“,”开头,以节省标签空间。例如:<Label Name=",PNT2" Range="0x4000"/>。

    • 两个不同的标签名不能指向相同的位,但一个位可以有多个标签。这些标签可以在 Name 中指定,以逗号“,”分隔。最多可包含 4 组逗号分隔值。例如,标签“ALMSTA”中的位“0x2000000”。BitLabels.xml 中的条目将为 <Label Name="HHA,TARG" Range="0x2000000"/>。“位模式选择器”对话框将显示如下内容:

      Showing how two different label names cannot point to the same bit, although a bit can have multiple labels.

    • 位模式选择器支持标签名别名。例如,如果在 xml 中定义了以下标签类型,选择器将针对所选标签名“INHSTA”,应用类型为“ALMOPT”的所有标签:
      <Labels Name="ALMOPT" Type="ALMOPT" SameAs="INHSTA"/>

    • 如果没有定义位的标签名,相应的位配置在选择器对话框中会被禁用。Standard 位标签中的标签将与该位关联。

    • 每个标签名只能在范围中指定一个位,但“CRIT”和“PRI”除外。如需详细信息,请参阅 ALMSTA 标签中的 CRIT 和 PRI

    aaBitLabelsSchema.xsd

    aaBitLabelsSchema.xsd 包含用于验证 BitLabels.xml 文件的架构。在以下条件下,将禁用“位标签”下拉列表:

    • XML 和 XSD 文件不在 <installpath>\ArchestrA\Bin 位置中。

    • XML 格式不正确

    • 加载 BitLabels.xml 时检测到无效标签;在此情况下,将记录警告消息,并且将使用缺省 Standard 标签类型。

    如果位标签被禁用,则会在“位模式选择器”对话框中将“Standard”位标签应用于每个位。

    未指定的位

    如果没有将位指定给标签,该位在“位模式选择器”对话框中将显示为灰色。

    例如,“B15”到“B8”在“ALMSTA”标签中显示为灰色。

    显示为灰色的位无法更改,并且位值将显示为“X”(忽略)。

    In This Topic