BiDiB Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Sie befinden sich hier: Herzlich Willkommen im BiDiB Wiki » BiDiB-Monitor » XML-Struktur einer CV-Definitionsdatei
Zuletzt angesehen:
monitor:cv-definitionsfile

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
monitor:cv-definitionsfile [2018/05/15 16:21] – [4. CV definieren] Michaelmonitor:cv-definitionsfile [2022/12/07 21:17] (aktuell) – [4.14. CV-Type "MAC_Address"] akuhtz
Zeile 52: Zeile 52:
  
  
 +Die Knoten-CV-XMLs werden entweder von den Tools mitgeliefert oder sie werden an folgendem Ort gesucht:
 +<code>
 +${userhome}\.bidib\data\BiDiBNodeVendorData
 +</code>
  
 ===== 3. Info-Abschitt ===== ===== 3. Info-Abschitt =====
Zeile 213: Zeile 217:
 Der Type „DCC_ADDR_RG“ setzt sich immer aus zwei CV’s zusammen und bilden Low-Byte und High- Der Type „DCC_ADDR_RG“ setzt sich immer aus zwei CV’s zusammen und bilden Low-Byte und High-
 Byte. Beim Klick auf eines der beiden CV wird geprüft, ob die Partner CV vorhanden. Wenn ja, wird Byte. Beim Klick auf eines der beiden CV wird geprüft, ob die Partner CV vorhanden. Wenn ja, wird
-im rechten, unteren Bereich eine Eingabemaske angezeigt+im rechten, unteren Bereich eine Eingabemaske angezeigt.\\
 Dieser Type arbeitet ähnlich wie „Int“.\\ Dieser Type arbeitet ähnlich wie „Int“.\\
 Die eingegebene Integer-Zahl wird hier aber in den oberen 15 Bit gespeichert. Optisch wird der Wert also verdoppelt. Es ist also nur ein Wert zwischen 0 und 32767 möglich.\\ Die eingegebene Integer-Zahl wird hier aber in den oberen 15 Bit gespeichert. Optisch wird der Wert also verdoppelt. Es ist also nur ein Wert zwischen 0 und 32767 möglich.\\
Zeile 231: Zeile 235:
 </CV> </CV>
 </code> </code>
-==== 4.6. CV-Type "GBM16TReverser" ====+ 
 + 
 +==== 4.6. CV-Type "DccAccAddr" ==== 
 +Der Type ''DccAccAddr'' setzt sich immer aus zwei CV’s zusammen und bilden Low-Byte und High- 
 +Byte. Beim Klick auf eines der beiden CV wird geprüft, ob die Partner CV vorhanden. Falls dies zutrifft werden 
 +im rechten, unteren Bereich Eingabefelder angezeigt, über welche die DCC Accessory Adresse geändert werden kann. 
 + 
 +Beide CV’s müssen mit den Attribute **Low** und **High** aufeinander verweisen.\\ 
 +**__Beispiel:__** 
 +<code xml> 
 +<CV Number="1" Type="DccAccAddr" Min="-" Max="-" Low="1" High="9" Values="-" Mode="rw"> 
 +    <Description Lang="de-DE" Text="Dekoderadresse (low)"/> 
 +    <Description Lang="en-EN" Text="Decoder address (low)"/> 
 +</CV> 
 +<CV Number="9" Type="DccAccAddr" Min="-" Max="-" Low="1" High="9" Values="-" Mode="rw"> 
 +    <Description Lang="de-DE" Text="Dekoderadresse (high)"/> 
 +    <Description Lang="en-EN" Text="Decoder address (high)"/> 
 +</CV> 
 +</code> 
 +==== 4.7. CV-Type "GBM16TReverser" ====
  
 **Dieser Type ist nur für einen GBM16T zugelassen.**\\ **Dieser Type ist nur für einen GBM16T zugelassen.**\\
Zeile 248: Zeile 271:
 </CV> </CV>
 </code> </code>
-==== 4.7. CV-Type "Radio" ==== +==== 4.8. CV-Type "Radio" ==== 
-**Der CV-Type "Radio" ist zur Zeit nur im BiDiB-Monitor verwendbar. **\\ +**Der CV-Type "Radio" ist zur Zeit nur im BiDiB-Monitor verwendbar. ** 
-\\ + 
-Ist der Type „**Radio**“ für die CV angeben, öffnet sich beim Anklicken der CV in der Baumstruktur eine Eingabemaske in der eine Auswahlliste von max. 16 möglichen Optionen angezeigt wird.{{ :monitor:radio-maske.png|}}\\ Es können auch mehr als 16 Optionen per <Bitdescription> angegeben werden. \\ +Ist der Type ''Radio'' für die CV angeben, öffnet sich beim Anklicken der CV in der Baumstruktur eine Eingabemaske in der eine Auswahlliste von max. 16 möglichen Optionen angezeigt wird.{{ :monitor:radio-maske.png|}} 
-Aber nur die ersten 16 können den RadioButtons zugewiesen werden (siehe unten "RadioGroups"\\ Mit dem Attribute "**Radiovalues**" kann ein Wert für jede der 16 möglichen Optionen vorgegeben werden.\\ \\  __**Beispiel:**__\\ Radiovalues="0,15,3"\\ Klick auf Option 0 -> CV hat Wert 0\\ Klick auf Option 1 -> CV hat Wert 15\\ Klick auf Option 2 -> CV hat Wert 3\\ + 
-\\  +Es können auch mehr als 16 Optionen per ''<Bitdescription>'' angegeben werden, aber nur die ersten 16 können den RadioButtons zugewiesen werden (siehe unten "RadioGroups").  
-Ist "**Radiovalues**" nicht vorhanden, werden den Optionen die Werte 0-15 zugewiesen\\ + 
-\\ +Mit dem Attribute ''Radiovalues'' kann ein Wert für jede der 16 möglichen Optionen vorgegeben werden. 
 + 
 +__**Beispiel:**__ 
 + 
 +<code>Radiovalues="0,15,3"</code> 
 + 
 +Klick auf Option 0 -> CV hat Wert 0 \\  
 +Klick auf Option 1 -> CV hat Wert 15 \\  
 +Klick auf Option 2 -> CV hat Wert 3 
 + 
 +Ist ''Radiovalues'' nicht vorhanden, werden den Optionen die Werte 0-15 zugewiesen. 
 + 
 __**Beispiel:**__ __**Beispiel:**__
 <code xml> <code xml>
Zeile 275: Zeile 309:
 </CV> </CV>
 </code> </code>
-\\ Attribute "**RadioGroups**": Die, per <Bitdescription> aufgelisteten Auswahlmöglichkeiten, können in zwei Gruppen aufgeteilt werden werden. Die beiden Gruppen bestehen jeweils aus der Auflistung (durch Komma getrennt) der Bitnum-Nummern. Die beiden Gruppen werden durch ein ';' getrennt\\  + 
-Diese Funktion steht erst ab der Monitor-Version 0.6.2.6 zu Verfügung.\\  +Attribute ''RadioGroups'': Die, per ''<Bitdescription>'' aufgelisteten Auswahlmöglichkeiten, können in zwei Gruppen aufgeteilt werden werden. Die beiden Gruppen bestehen jeweils aus der Auflistung (durch Komma getrennt) der Bitnum-Nummern. Die beiden Gruppen werden durch ein '';'' getrennt. 
-Die Bitnum-Nummern vor dem ';', werden als RadioButton dargestellt und dürfen nur die ersten 16 Bitnum-Nummern enthalten.\\     + 
-Bitnum-Nummern nach dem ';', werden in der Combobox aufgelistet und kann jede vorkommende Bitnum-Nummer enthalten.\\  +  * Die Bitnum-Nummern vor dem '';'', werden als RadioButton dargestellt und dürfen nur die ersten 16 Bitnum-Nummern enthalten. 
-__**Beispiel:**__\\ RadioGroups="1,2,3,4,5,6,7,8,9,10,11,12,13;14,15"\\  +  * Die Bitnum-Nummern nach dem '';'' werden in der Combobox aufgelistet und kann jede vorkommende Bitnum-Nummer enthalten. 
-Hier werden die Werte für die RadioButton 1-13 als RadioButton dargestellt.\\ +  
-Die Werte der RadioButton 14 und 15 als Auswahl in einer Combobox angezeigt.\\ +__**Beispiel:**__ 
-Der CV-Wert wird dann aus der Addition beider Eingaben gebildet.\\+ 
 +<code>RadioGroups="1,2,3,4,5,6,7,8,9,10,11,12,13;14,15"</code> 
 +  
 +Hier werden die Werte für die RadioButton 1-13 als RadioButton dargestellt. \\ 
 +Die Werte der RadioButton 14 und 15 als Auswahl in einer Combobox angezeigt. \\ 
 +Der CV-Wert wird dann aus der Addition beider Eingaben gebildet. 
 __**Beispiel-XML:**__ __**Beispiel-XML:**__
 +
 <code XML> <code XML>
 <CV Number="47" Type="Radio" RadioGroups="1,2,3,4,5,6,7,8,9,10,11,12,13,;14,15,16" Radiovalues="0,1,2,0,4,5,6,7,8,9,0,0,12,0,64,32" Min="-" Max="-" Low="-" High="-" Mode="rw"> <CV Number="47" Type="Radio" RadioGroups="1,2,3,4,5,6,7,8,9,10,11,12,13,;14,15,16" Radiovalues="0,1,2,0,4,5,6,7,8,9,0,0,12,0,64,32" Min="-" Max="-" Low="-" High="-" Mode="rw">
Zeile 306: Zeile 347:
 </code> </code>
 {{:monitor:radiogroups.png|}} {{:monitor:radiogroups.png|}}
-==== 4.8. CV-Type "SignedChar" ====+==== 4.9. CV-Type "SignedChar" ====
 {{ :monitor:signedchar-maske.png|}} {{ :monitor:signedchar-maske.png|}}
 Durch Mausklick auf eine CV vom Type „**SignedChar**“, wird im unteren, rechten Bereich eine Eingabemaske Durch Mausklick auf eine CV vom Type „**SignedChar**“, wird im unteren, rechten Bereich eine Eingabemaske
Zeile 321: Zeile 362:
 </CV> </CV>
 </code> </code>
-==== 4.9. CV-Type "Long" ====+==== 4.10. CV-Type "Long" ====
 Implementiert ab Wizard vom 14.10.2015 und Monitor ab Version 0.6.4.8.\\ Implementiert ab Wizard vom 14.10.2015 und Monitor ab Version 0.6.4.8.\\
 \\ \\
Zeile 327: Zeile 368:
 Durch Mausklick auf eine CV vom Type „**Long**“, wird im unteren, rechten Bereich eine Eingabemaske Durch Mausklick auf eine CV vom Type „**Long**“, wird im unteren, rechten Bereich eine Eingabemaske
  für den Wert angezeigt. \\  für den Wert angezeigt. \\
-Der Type „**Long**“ besteht aus vier aufeinander folgenden CV's. \\+Der Type „**Long**“ besteht aus 4 aufeinander folgenden CV's. \\
 Beginnend mit der CV-Nummer die im Attribut **Number** angegeben ist. Beginnend mit der CV-Nummer die im Attribut **Number** angegeben ist.
  \\   \\ 
Zeile 342: Zeile 383:
 </code> </code>
  
-==== 4.10. CV-Type "String" ====+==== 4.11. CV-Type "String" ====
 Implementiert ab Wizard vom 11.02.2017  Implementiert ab Wizard vom 11.02.2017 
  
Zeile 358: Zeile 399:
     <Description Lang="en-EN" Text="Test String with max 20 characters"/ Help="Test String with max 20 characters"/>     <Description Lang="en-EN" Text="Test String with max 20 characters"/ Help="Test String with max 20 characters"/>
 </CV> </CV>
 +</code>
 +
 +==== 4.12. CV-Type "BiDiB_UID" ====
 +
 +Der CV-Type ''BiDiB_UID'' wird verwendet, um die ''Unique ID'' eines BiDiB-Knoten in den CV zu definieren. Diese Definition belegt 7 aufeinanderfolgende CVs, in welcher 
 +<code>
 +uid_cls_l
 +uid_cls_h
 +uid_vid
 +uid_pid_l
 +uid_pid_h
 +uid_ser_l
 +uid_ser_h
 +</code>
 +abgelegt werden.
 +
 +<code xml>
 +<CV Number="10" Type="BiDiB_UID" Mode="rw">
 +    <Description Lang="de-DE" Text="BiDiB-UID" Help="BiDiB-UID des Freundes."/>
 +    <Description Lang="en-EN" Text="BiDiB-UID" Help="BiDiB-UID of the friend."/>
 +</CV>
 +</code>
 +
 +Anwendung in einem Template:
 +
 +Der nachfolgende Block erzeugt 4 Pairings beginnend an der CV 100:
 +
 +<code xml>
 +<Template Name="Pairing">
 +    <CV Number="0" Type="Byte" Min="0" Max="1" Values="-" Mode="rw">
 +        <Description Lang="de-DE" Text="Freund" Help="0=Eintrag ist ungueltig, 1=Eintrag zeigt die BiDiB-Kennungen eines Freundes (=paired)"/>
 +        <Description Lang="en-EN" Text="Friend" Help="0=entry is void, 1=entry denotes a pairing partner"/>
 +    </CV>
 +    <CV Number="1" Type="BiDiB_UID" Mode="rw">
 +        <Description Lang="de-DE" Text="BiDiB-UID" Help="BiDiB-UID des Freundes."/>
 +        <Description Lang="en-EN" Text="BiDiB-UID" Help="BiDiB-UID of the friend."/>
 +    </CV>
 +</Template>
 +
 +
 +<Node>
 +    <Nodetext Lang="de-DE" Text="Pairing Einstellungen"/>
 +    <Nodetext Lang="en-EN" Text="Pairing Settings"/>
 +    <Node Offset="100" Template="Pairing" Count="4" Next="8">
 +        <Nodetext Lang="de-DE" Text="Pairing-%%d"/>
 +        <Nodetext Lang="en-EN" Text="Pairing-%%d"/>
 +    </Node>
 +</Node>
 +</code>
 +
 +
 +==== 4.13. CV-Type "NodeID" ====
 +
 +Der CV-Type ''NodeID'' wird verwendet, um die ''Knoten-ID'' eines BiDiB-Knoten in den CV zu definieren. Diese Definition belegt 5 aufeinanderfolgende CVs (wie ''UniqueID'' aber ohne Classbits) , in welcher 
 +<code>
 +uid_vid
 +uid_pid_l
 +uid_pid_h
 +uid_ser_l
 +uid_ser_h
 +</code>
 +abgelegt werden.
 +
 +<code xml>
 +<CV Number="10" Type="NodeID" Mode="rw">
 +    <Description Lang="de-DE" Text="Knoten-ID" Help="Knoten-ID des Freundes."/>
 +    <Description Lang="en-EN" Text="NodeID" Help="NodeID of the friend."/>
 +</CV>
 +</code>
 +
 +Anwendung in einem Template:
 +
 +Der nachfolgende Block erzeugt 4 Knoten-IDs beginnend an der CV 100:
 +
 +<code xml>
 +<Template Name="KnotenIDs">
 +    <CV Number="1" Type="NodeID" Mode="rw">
 +        <Description Lang="de-DE" Text="Knoten-ID" Help="Knoten-ID des Freundes."/>
 +        <Description Lang="en-EN" Text="NodeID " Help="NodeID  of the friend."/>
 +    </CV>
 +</Template>
 +
 +
 +<Node>
 +    <Nodetext Lang="de-DE" Text="Knoten-IDs Einstellungen"/>
 +    <Nodetext Lang="en-EN" Text="Node-IDs Settings"/>
 +    <Node Offset="100" Template="KnotenIDs" Count="4" Next="6">
 +        <Nodetext Lang="de-DE" Text="Knoten-ID-%%d"/>
 +        <Nodetext Lang="en-EN" Text="Node-ID-%%d"/>
 +    </Node>
 +</Node>
 +</code>
 +
 +==== 4.14. CV-Type "MAC_Address" ====
 +
 +Der CV-Type ''MAC_Address'' wird verwendet, um die ''MAC Adresse'' in den CV zu definieren. Diese Definition belegt 6 aufeinanderfolgende CVs, in welcher 
 +<code>
 +byte 1
 +byte 2
 +byte 3
 +byte 4
 +byte 5
 +byte 6
 +</code>
 +abgelegt werden.
 +
 +<code xml>
 +<CV Number="10" Type="MAC_Address" Mode="rw">
 +    <Description Lang="de-DE" Text="MAC-Adresse" Help="MAC-Adresse."/>
 +    <Description Lang="en-EN" Text="MAC-Address" Help="MAC address"/>
 +</CV>
 +</code>
 +
 +Anwendung in einem Template:
 +
 +Der nachfolgende Block erzeugt 4 MAC-Adressen beginnend an der CV 100:
 +
 +<code xml>
 +<Template Name="MAC_Addresses">
 +    <CV Number="1" Type="MAC_Address" Mode="rw">
 +        <Description Lang="de-DE" Text="MAC-Adresse" Help="MAC Adresse"/>
 +        <Description Lang="en-EN" Text="MAC-Address" Help="MAC address"/>
 +    </CV>
 +</Template>
 +
 +
 +<Node>
 +    <Nodetext Lang="de-DE" Text="MAC-Adresse Einstellungen"/>
 +    <Nodetext Lang="en-EN" Text="MAC-Address Settings"/>
 +    <Node Offset="100" Template="MAC_Addresses" Count="4" Next="7">
 +        <Nodetext Lang="de-DE" Text="MAC-Adresse-%%d"/>
 +        <Nodetext Lang="en-EN" Text="MAC-Address-%%d"/>
 +    </Node>
 +</Node>
 </code> </code>
  
Zeile 448: Zeile 623:
  
 Mit dem **Repeater**-Tag kann eine //for-Schleife// für CV-Values definiert werden. Mit dem **Repeater**-Tag kann eine //for-Schleife// für CV-Values definiert werden.
 +
 +Die Werte für ''Offset'', ''Count'' und ''Next'' sind mandatory.
  
 Beispiel: Beispiel:
monitor/cv-definitionsfile.1526394101.txt.gz · Zuletzt geändert: 2018/05/15 16:21 von Michael
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki