===== 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:__\\
{{:cockpit-xp:addon:configpackageauswahl.png?nolink|}}\\


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

<Code xml linenums|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></Code>

==== 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**\\
<Code xml linenums>
<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>
</Code>

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**\\
<Code xml>
<Variable xmlindex="1" beschreibung="*** Eingaben BoxengasseStrafe bei Chaos ***" name="xxx" datatyp="Text" value=" "></Variable>
</Code>




=== 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.\\


\\
----

[[cockpit-xp:start|Start]] - [[cockpit-xp:faq|FAQ]] - [[cockpit-xp:glossar|Glossar]] - [[cockpit-xp:sitemap|Sitemap]] - [[cockpit-xp:impressum|Impressum]]