BitLabels​.xmlおよびaaBitLabelsSchema​.xsdファイルの設定

ビット ラベル情報は BitLabels.xml ファイルとで定義され、aaBitLabelsSchema.xsd ファイルを使用して検証されます。デフォルトでは、これらのファイルは使用できません。

BitLabels.xml

BitLabels.xml ファイルは、サポートされる各ビット ラベルのラベルを定義します。（ビット ラベル "Standard" など）。

ビット ラベルを定義するには、名前（Name）とタイプ（Type）が必要です。<LabelsName="Standard"Type="Default">。

1. ここで指定する名前は、［ビットラベル］ドロップダウンコンボに一覧表示されます。
   ビット ラベル名には、少なくとも 1 文字を含む必要があります。有効な文字は、英数字および特殊文字（$、#、_）です。ビット ラベル名の最大長は 32 です。

2. ラベルの'Default'または'Name'。

各XMLには、複数の<を含めることができます>。各<上で>は一つ以上の<c0/>で構成されます。<Label>各ラベルには、Name（名前）および Range（範囲）情報があります。以下に例を示します。

<LabelsName="Standard"Type="Default">。

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

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

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

各 <Label> には 2 つのフィールドがあります。

3. ［ビットパターンの選択］ダイアログで'Standard'ビットラベルが選択されている場合、最初の左上隅にラベル名"B31"が表示されます。

4. Nameに適用するビットを指定する16進数の整数。Range には 32 のビットがあり、1 つのビットだけを '1' に設定できます。その他のすべてのビットは '0' である必要があります。これは、ラベル "ALMSTA" のラベル "CRIT" およびラベル "PRI" の例外です。

以下に例を示します。

'Standard' ラベルでは、ビット "B31" は "0x80000000" に割り当てられます。16 進数をバイナリに変換すると、これは "1000 0000 0000 0000 0000 0000 0000 0000" になります。したがって、ラベル "B31" は最高ビットになります。

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

'Standard' ラベルでは、ビット "B5" は "0x20" に割り当てられます。16 進数をバイナリに変換すると、これは "0000 0000 0000 0000 0000 0000 0010 0000" になります。最初の 26 桁は 0 なので、これらの 0 は Range 値で無視できます。

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

ビット ラベル XML を検証する際および［ビット パターンの選択］ダイアログを表示する際は、以下のルールが適用されます。

• ラベル名とビット ラベル名には、少なくとも 1 文字を含む必要があります。有効な文字は、英数字および特殊文字（$、#、_）です。
  <Label Name="B31" Range="0x80000000"/>

• ラベル名は、各ラベル タイプで一意である必要があります。1 つのラベル名をラベル タイプ内の複数の場所で使用することはできません。

• ビット ラベル名を "," で開始するとラベル スペースを節約できます。例：<Label Name=",PNT2" Range="0x4000"/>。

• 1 つのビットには複数のラベルを設定できますが、2 つの異なるラベル名を同じビットにポイントすることはできません。複数のラベルを 1 つの Name に割り当てることができます。個々のラベルは、カンマ ',' で区切ります。最大 4 つのグループのカンマ区切り値を設定できます。たとえば、"ALMSTA"ラベル内のビット"0x2000000"では、BitLabels.xmlのエントリは<LabelName="HHA,TARG"Range="0x2000000"/>になります。［ビットパターンの選択］ダイアログでは、次のように表示されます。<Label Name="HHA,TARG" Range="0x2000000"/>

  

• ［ビット パターンの選択］ダイアログは、ラベル名エイリアスをサポートします。たとえば、次のラベルタイプがxmlで定義されている場合、ラベル名選択"INHSTA"にラベルタイプ"ALMOPT"のすべてのラベルが適用されます。
  

• ビットに対してラベル名が定義されていない場合、対応するビット設定は選択ダイアログで無効化されます。Standard ビット ラベルのラベルがビットに関連付けられます。

• "CRIT" および "PRI" を除く各ラベル名は範囲内の 1 つのビットを指定できます。詳細については、「ALMSTA ラベルの CRIT および PRI」を参照してください。

aaBitEltEltsSchema.xsd

aaBitLabelsSchema.xsd には、BitLabels.xml ファイルを検証するためのスキーマが含まれています。次の場合、［ビット ラベル］ドロップダウン リストは無効化されます。

• XML および XSD ファイルが <installpath>\ArchestrA\Bin にない。

• XML の形式が正しくない。

• BitLabels.xml をロードするときに無効なラベルが検出された。この場合、警告メッセージがログに記録され、デフォルトの Standard ラベル タイプが使用されます。

ビット ラベルが無効になっている場合、［ビット パターンの選択］ダイアログの各ビットに "Standard" ビット ラベルが適用されます。

未割り当てビット

ラベルに割り当てられていないビットは、［ビット パターンの選択］ダイアログでグレー表示されます。

たとえば、"B15" から "B8" は "ALMSTA" ラベルでグレー表示されます。

グレー表示されたビットは変更することができず、ビット値は "X"（無視）として表示されます。