Dateien BitLabels​.xml und aaBitLabelsSchema​.xsd konfigurieren

Die Bit-Beschriftungs-Informationen werden in der Datei BitLabels.xml definiert und mit Hilfe der Datei aaBitLabelsSchema.xsd validiert. Diese Dateien sind standardmäßig nicht verfügbar.

BitLabels.xml

Die Datei BitLabels.xml definiert die Beschriftungen aller unterstützten Bit-Beschriftungen. Zum Beispiel die Bit-Beschriftungen „Standard“.

Um eine Bit-Beschriftung zu definieren, brauchen wir einen Namen und einen Typ. Beispiel: <Beschriftungsname="Standard" Typ="Standard">.

1. Name: Der hier angegebene Name wird in der Dropdown-Liste Bit-Beschriftungen aufgeführt.
   Der Name der Bit-Beschriftung muss mindestens einen Buchstaben enthalten. Gültige Zeichen sind alphanumerische Zeichen und Sonderzeichen ($, #, _). Der Name der Bit-Beschriftung darf maximal 32 Zeichen lang sein.

2. Typ: „Standard“ oder der „Name“ der Beschriftung.

Jede XML kann mehrere <Beschriftungen> enthalten. Jedes Element vom Typ <Beschriftungen> besteht aus mindestens einem <Label>-Element. Jede Beschriftung enthält den Namen und die Bereichsinfo. Zum Beispiel:

<Beschriftungsname="Standard" Typ="Standard">

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

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

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

Jede <Label> wird zwei Felder haben:

3. Name: Groß- und Kleinschreibung werden nicht berücksichtigt, und die maximale Länge des Beschriftungsnamens ist 4. Im Dialogfeld „Bit Pattern Selector“ wird bei Auswahl der Bit-Beschriftungen „Standard“ der Beschriftungsname „B31“ in der ersten oberen linken Ecke angezeigt.

4. Bereich: Ist eine Ganzzahl im hexadezimalen Format, die angibt, für welches Bit der Name angewendet wird. Der Bereich hat 32 Bits und es kann nur ein Bit auf „1“ gesetzt sein. Alle anderen Bits müssen „0“ sein. Es gibt eine Ausnahme bei der Beschriftung „CRIT“ und der Beschriftung „PRI“ der Beschriftung „ALMSTA“.

Zum Beispiel:

In der Beschriftung „Standard“ ist das Bit „B31“ „0x80000000“ zugeordnet. Wenn Sie die hexadezimale Zahl in eine binäre Zahl umwandeln, lautet sie „1000 0000 0000 0000 0000 0000 0000 0000“. Das bedeutet, dass die Bezeichnung „B31“ das höchste Bit ist.

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

In der Beschriftung „Standard“ ist „B5“ „0x20“ zugeordnet. Wenn Sie die hexadezimale Zahl in eine binäre Zahl umwandeln, lautet sie „0000 0000 0000 0000 0000 0000 0010 0000“. Da die ersten sechsundzwanzig Ziffern Nullen sind, können wir diese Nullen im Bereichswert ignorieren.

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

Bei der Validierung der Bit-Beschriftungs-XML und der Anzeige des Dialogs „Bit Pattern Selector“ werden folgende Regeln angewandt:

• Der Beschriftungsname und der Bit-Beschriftungs-Name müssen mindestens einen Buchstaben enthalten. Gültige Zeichen sind alphanumerische Zeichen und Sonderzeichen ($, #, _).
  <Label Name="B31" Range="0x80000000"/>

• Der Beschriftungsname muss für jeden Beschriftungstyp eindeutig sein. Ein Beschriftungsname darf in einem Beschriftungstyp nicht an mehreren Stellen verwendet werden.

• Ein Bit-Beschriftungsname kann mit „,“ beginnen, um den Beschriftungsplatz zu reservieren. Beispiel: <Label Name=",PNT2" Range="0x4000"/>.

• Es dürfen nicht zwei verschiedene Bezeichnungen auf dasselbe Bit verweisen, obwohl ein Bit mehrere Bezeichnungen haben kann. Die Bezeichnungen können in einem Namen zugeordnet und durch ein Komma „,“ getrennt werden. Sie kann bis zu 4 durch Komma getrennte Werte enthalten. Zum Beispiel das Bit „0x2000000“ in der Beschriftung „ALMSTA“, der Eintrag in BitLabels.xml wird <Label Name="HHA,TARG" Range="0x2000000"/> sein, und im Dialogfeld „Bit Pattern Selector“ wird Folgendes angezeigt:

  

• Der Bit Pattern Selector unterstützt Alias-Beschriftungsnamen. Beispielsweise wird die Auswahl die ganze Beschriftung von Beschriftungstyp „ALMOPT“ für die Beschriftungsnamenauswahl „INHSTA“ anwenden, wenn in der XML folgender Beschriftungstyp definiert ist:
  <Beschriftungsname="ALMOPT" Typ="ALMOPT" Entsprechung="INHSTA"/>

• Wenn für das Bit kein Beschriftungsname definiert ist, wird im Auswahl-Dialog die entsprechende Bitkonfiguration deaktiviert. Die Beschriftung aus den Standard-Bit-Beschriftungen wird mit dem Bit verknüpft.

• Jeder Beschriftungsname außer „CRIT“ und „PRI“ kann nur ein Bit im Bereich angeben. Weitere Informationen finden Sie im Abschnitt CRIT und PRI in der Beschriftung ALMSTA.

aaBitLabelsSchema.xsd

aaBitLabelsSchema.xsd enthält das Schema für das Validieren der Datei BitLabels.xml. Die Bit-Beschriftungs-Dropdown-Liste wird in folgenden Fällen deaktiviert:

• Die XML- und XSD-Dateien sind am Speicherort <installpath>\ArchestrA\Bin nicht verfügbar.

• Die XML ist nicht wohlgeformt.

• Beim Laden der Datei BitLabels.xml wird eine ungültige Beschriftung erkannt. In diesem Fall wird eine Warnmeldung protokolliert und der Standardbeschriftungstyp „Standard“ verwendet.

Wenn die Bit-Beschriftungen deaktiviert sind, werden die „Standard“-Bitbeschriftungen auf jedes Bit im Dialogfeld „Bit Pattern Selector“ angewendet.

Nicht zugewiesenes Bit

Wenn ein Bit keiner Beschriftung zugewiesen ist, wird das Bit im Dialogfeld „Bit Pattern Selector“ ausgegraut dargestellt.

Beispielsweise sind „B15“ bis „B8“ in der Beschriftung „ALMSTA“ ausgegraut.

Ein ausgegrautes Bit kann nicht geändert werden und der Bitwert wird als „X“ (Ignorieren) angezeigt.