{{indexmenu_n>10}}
====== X-Plane-Plugin ======
===== Systembeschreibung =====
-> Das X-Plane-Plugin für den [[hardware:anleitungen:ucp-compact|UCP-COMPACT]] ist [[hardware:anleitungen:ucp-compact:software:x-plane-plugin|hier]] beschrieben.

Das Plugin unterstützt nur die Windows-Version von X-Plane.

Durch das [[http://www.xsquawkbox.net/xpsdk/mediawiki/Main_Page|X-Plane Plugin SDK2]] und [[https://developer.x-plane.com/sdk/|X-Plane SDK3]] wird Zugriff auf Kommandos und Daten-Referenzen zur Verfügung gestellt. Durch Plugins ist es möglich, mit externer Hardware Kommandos an den Flugsimulator X-Plane zu senden, Variablen zu setzen und den Status von Variablen abzufragen und anzuzeigen. 

**Funktionsschema des Arduino X-Plane Plugins**\\
{{:hardware:howto:plugin-arduino.png?500|}}

Das X-Plane Plugin kommuniziert direkt mit der Arduino-Hardware über das Netzwerkprotokoll UDP. 

===== System-Voraussetzungen =====

Für die Verwendung der X-Plane Plugins ist eine X-Plane-Version höher 10.0 notwendig. Voraussetzung ist ein konfiguriertes Netzwerk mit automatischer Adressvergabe (DHCP), damit dem Arduino eine gültige IP-Adresse zugewiesen wird. Dies erfolgt z.B. über den Router, der die Internetverbindung realisiert.
-----

**Speicherort der X-Plane Plugins:**\\
Die Plugins ''*.xpl'' müssen manuell aus dem Installationsordner in den Plugin-Ordner des X-Plane kopiert werden, dieses Verzeichnis ''\Ressources\plugins'' liegt unterhalb des X-Plane-Installationsorders.

Der Speicherort der **Konfigurations-Dateien** der X-Plane Plugins ist:\\
Win7 ff: ''C:\Users\Benutzername\AppData\Roaming\Sim&IT\X-Plane-Plugins''\\
WinXP: ''C:\Dokumente und Einstellungen\Benutzername\Anwendungsdaten\Sim&IT\X-Plane-Plugins''

Diese Ordner sind standardmäßig versteckt.

Die Konfigurationsdatei kann z.B. mit dem Editor (Programme -> Zubehör) angezeigt und bearbeitet werden. Ein entsprechender Link zur Konfigurationsdatei wird bei der Installation im Programmordner erzeugt. 
-----
===== Software-Installation =====

[[http://simandit.de/Downloads/setup-avionics_xpl.zip|Plugin Setup]]

Nach dem Start des Setup können Sie den Zielordner der Installation und den Menü-Ordner der Programm-Gruppe ändern. Mit "Fertigstellen" ist die Client-Installation abgeschlossen.

{{:hardware:howto:ardu_inst_01.png?200|}}\\
Nach der Installation finden Sie in der bei der Installation vorzugsweise angegebenen Programmgruppe ''Sim&IT'' den Unterordner ''X-Plane-Plugins'' Links zum Installationsordner der Plugins und zur Konfigurationsdatei für das Ändern der Konfigurationsvariablen der Plugins. 

===== Plugin-Konfiguration =====

Nach dem Starten des X-Plane finden Sie im Menü **Plugins** jeweils einen Menüpunkt mit zwei Unterpunkten für Infos und für die Eingabe von Lizenzinformationen. Das COM1 Plugin funktioniert ohne Lizenz uneingeschränkt, die anderen Plugins funktionieren ohne Lizenz für ca. 10 Minuten.

{{:weiteres:arduino:ardu_fsxpl_01.png?200|}}

Im Info-Bereich wird entweder die Verbindung zum Arduino-Panel und die Lizenzinformation angezeigt. 

Wenn **mehr als ein Netzwerkadapter** gefunden wurde, dann werden diese mit dem Index angezeigt, der vom Betriebssystem vergeben wurde. Der Index des Netzwerkadapters, an dem die Arduino-Hardware angeschlossen ist, muss in der Konfigurationsdatei\\
''.\AppData\Roaming\Sim&IT\X-Plane-Plugins\Arduino-Panel.cfg''\\
mit der [[hardware:anleitungen:arduino-panel:arduino-xplane#Konfigurationsvariablen|Konfigurationsvariablen]] ''INTERFACE_INDEX'' definiert werden, um eine Verbindung aufzubauen. 

{{:weiteres:arduino:ardu_fsxpl_02.png?250|}} {{:weiteres:arduino:ardu_fsxpl_04.png?250|}}

Zum Feststellen des Index kann auch das mitinstallierte Programm ''Show NetIndex'' genutzt werden, dieses zeigt ebenfalls die installierten Netzwerk-Adapter und deren Index im Betriebssystem an.\\
{{:hardware:anleitungen:arduino-panel:netindex.png|}}


Mit Windowsmitteln kann dies wie folgt ermittelt werden:\\
''wmic path win32_networkadapter get name, index, interfaceindex''


==== Konfigurationsvariablen ====

Den Konfigurationsvariablen folgt ein ''='' und dann der zu setztende Wert.

Jedes Arduino-Frequenzmodul hat einen eigenen Abschnitt in der Konfigurationsdatei.\\
[COM1], [COM2], [NAV1], [NAV2], [ADF], [XPDR], [MFP1], [NAVCOM1] und [NAVCOM2].

In jedem Abschnitt gibt es folgende Variablen:
  * ''ARDU_PORT'' zur Definition des Ports des empangenden Gerätes, wenn Standardport nicht nutzbar ist
  * ''RECV_PORT'' zur Definition des Ports auf dem PC, wenn Standardport nicht nutzbar ist

Die geänderten Ports müssen ebenfalls im Arduino-Sketch definiert sein.

Das ADF-Modul hat die Variablen:
  * ''4DIGIT'' standardmäßig ist vierstellige Frequenzanzeige aktiviert, 0 setzt auf dreistellig

Das Transponder-Modul hat die Variablen:
  * ''XPDR_CODE'' zur Definition des Codes beim Start des Panel, Standard ist ''1200''

Das Multi-Funktions-Panel hat die Variablen:
  * ''START_DISPLAY'' zur Definition der Anzeige beim Systemstart, default ist ''1'' = NAV1
  * ''RMP_SYNC'' zu Synchronisation mit einem Radio Management Panel im X-Plane-Flugzeug, das Flugzeug muss diese Funktion aber unterstützen.
  * ''XPDR_CODE'' zur Definition des Codes beim Start des Panel, Standard ist ''1200''
  * ''ADF_4DIGIT'' standardmäßig ist vierstellige Frequenzanzeige aktiviert, 0 setzt auf dreistellig

Für alle gibt es den Abschnitt ''[NET]'' mit der Konfigurationsvariablen\\
  * ''INTERFACE_INDEX'' zur Definition des Netzwerkadapters bei mehreren im System