ConfigPackage.XML

in dieser Datei wird programmiert bzw. konfiguriert, was man später direkt in Cockpit XP zu einem AddOn so alles einstellen kann:

Beispiel:

Die Einträge dafür in der Confige.Package.XML sehen folgendermaßen aus:

Beispiel einer ConfigPackage.XML

<?xml version="1.0" encoding="iso-8859-1"?>
<ConfigPackage>		
<Variables>
<Variable xmlindex="1" beschreibung="Tank auf Reserve ab [10-30] % " name="Reserve" datatyp="extended" value="25"></Variable>	
<Variable xmlindex="2" beschreibung="Neuer Geschw.-Wert, wenn Reserve? [0=aus],[1-15] " name="SpeedReserve"  datatyp="Integer"  value="4"></Variable>	
<Variable xmlindex="3" beschreibung="Geschw.-Wert, wenn Tank Leer? [1-15]" name="SpeedTankLeer" datatyp="Integer"  value="2"></Variable>
<Variable xmlindex="4" beschreibung="Delay [ms]           " name="Delay"  datatyp="Integer" value="250"></Variable>
<Variable xmlindex="5" beschreibung="Speed-Down-Rampe [ms]" name="TSDown" datatyp="Integer" value="500"></Variable>
</Variables>

<IOConfig>
        <DigInput name="TasterChaos"  devicenumber="1" number="4"></DigOutput>
        <DigOutput name="LichtRelais" devicenumber="2" number="2"></DigOutput>
</IOConfig>

</ConfigPackage>

Was kann man alles in der ConfigPackage.XML einstellen?

Es gibt ein Feld für die Programmierung von Variablen → Variables
und ein Feld für die Programmierung von Ein/Ausgängen → IOConfig

Variables

hier werden die Variablen programmiert, welche später im AddOn abgefragt werden.

Syntax
<Variable xmlindex=„1“ beschreibung=„Tank auf Reserve ab wann? [10-30] Prozent “ name=„Reserve“ datatyp=„float“ value=„25,0“></Variable>
xmlindex=„1“
Hier muss eine fortlaufende Nummerierung eingehalten werden.
beschreibung=„Tank auf Reserve ab wann? [10-30] Prozent“
Dies ist ein Textfeld, welches später dann in Cockpit XP erscheint.
name=„Reserve“
Hier wird der Name vergeben, welches das AddOn dann aufruft.
datatyp=„float“
Hier wird der Datentyp für Reserve bestimmt. Möglich sind Integer, Float und String.
value=„25,0“>
Hier wird ein Wert für die Variable vordefiniert. Dieser kann aber später jederzeit in Cockpit XP geändert und abgespeichert werden.

Wichtig

Während die Zahlenwerte mit Nachkommastellen im AddOn-Code mit einem '.' als Trennzeichen für die Dezimalstellen arbeiten, ist in der ConfigPackage.xml ein ',' gefordert.

Außerdem existiert in der 'ConfigPackage.xml nur der Datentyp Float. Dieser entspricht dem Datentype Extended bei der Variablendeklaration im AddOn-Code.

ComboBox

In der ConfigPackage.XML kann man über den Datentyp Combo auch eine ComboBox mit einer definierbaren Auswahlliste programmieren.
Syntax
name=„Combo1“ datatyp=„Combo“ set=„A|B|C|D“ value=„0“

Beispiel

<Variable xmlindex="1" beschreibung="Test-1" name="Combo1" datatyp="Combo" set="A|B|C|D" value="0"></Variable>
<Variable xmlindex="2" beschreibung="Test-2" name="Combo2" datatyp="Combo" set="Nein|Ja" value="1"></Variable>
<Variable xmlindex="3" beschreibung="Test-3" name="Combo3" datatyp="Combo" set="Ja|Nein" value="1"></Variable>

Die Listeneinträge in der ComboBox beginnen mit dem Index 0. Sie werden im AddOn-Code immer über eine Integer-Packagevariable angesprochen.

Die Auswahl C entspricht dem Integerwert 2.

Überschrift

Für die bessere Übersichtlichkeit kann zusätzlich auch noch eine „Überschrift“ eingefügt werden.
Syntax
name=„xxx“ datatyp=„Text“ value=„ “>
Beispiel

<Variable xmlindex="1" beschreibung="*** Eingaben BoxengasseStrafe bei Chaos ***" name="xxx" datatyp="Text" value=" "></Variable>

IOConfig

Hier werden die Ein- bzw.Ausgänge mit einem Namen konfiguriert, welche dann mit diesem Namen aus dem AddOn heraus angesprochen werden. - Eingänge werden mit DigInput definiert
- Ausgänge werden mit DigOutput definiert

Syntax
<DigInput name=„TasterLicht“ devicenumber=„1“ number=„4“></DigOutput>
<DigOutput name=„LichtRelais“ devicenumber=„2“ number=„2“></DigOutput>

name=„TasterLicht“
Ist der Name, welcher aus dem AddOn angesprochen wird.
devicenumber=„1“
Ist die Nummer der USBBox, an welcher der betreffende Ein-/Ausgang angeschlossen ist.
number=„4“
Ist die Nummer des Ein-/Ausgangs, welcher an der USBBox angeschlossen ist.



Start - FAQ - Glossar - Sitemap - Impressum

 
cockpit-xp/addon/configpackage.xml.txt · Zuletzt geändert: 2020/11/28 12:14 (Externe Bearbeitung)