De/Joystick: Difference between revisions

Können Sie sich in der Wirklichkeit einen Piloten vorstellen, der seine (reale) Cessna alleine mittels einer Tastatur steuert? Für das richtige “Pilotengefühl” benötigt man mindestens einen Steuerknüppel (=”Joystick”) bzw. ein Steuerhorn (=”yoke”), einen Gashebel (=”throttle”), möglichst noch Pedale für das Seitenruder (=”rudder pedals”), man kann auch nie genug zusätzliche Schalter und Regler haben, auch ein echter Pilotensessel wäre nicht schlecht - am besten wäre natürlich ein ganzes Cockpit mit mehreren Instrumententafeln! Leider kann die schiere Menge der möglichen Kombinationen der verschiedensten externen Zusatzgeräten von den verschiedensten Herstellern für die unterschiedlichsten PCs und Betriebssysteme zu beträchtlichen Schwierigkeiten führen. Die erste Schwierigkeit ist schon, in der folgenden Beschreibung immer wieder alle möglichen Geräte aufzulisten – obwohl das beschriebene auf alle diese externen Zusatz-Geräte zutrifft. Somit mach ich mir das Leben einfach: Ich verwende den allgemeinen Begriff „Joystick“ im Folgenden für alle Steuerungs-Geräte – mit Ausnahme der Maus und der Tastatur!

Damit die im FlightGear vorhandene automatische Erkennung der Steuerungs-Geräte funktioniert, muss es für jeden Joystick (etc.) eine XML-Steuerdatei geben, die beschreibt welche Achsen und/oder Knöpfe welche Funktionen im FlightGear wie auslöst. Diese Zuordnung nennt man „bindings“. Diese XML-Steuerdatei selbst kann irgendeinen Namen haben - aber innerhalb der Datei muss am Anfangs der Name definiert sein, mit dem sich das Gerät am PC anmeldet (mehr dazu später). Und die Datei muss in dem Verzeichnis stehen auf das die Datei

:FG_ROOT/joysticks.xml

nachschauen. Voraussichtlich gibt es dort mehrere Steuerdateien für unterschiedliche Geräte mit unterschiedlichen Zuordnungen! Bei Geräten mit unterschiedlichem Namen aber gleicher Zuordnung wird keine extra Datei benötigt – allerdings müssen alle dazu passende „Gerätenamen“ in dieser einen Steuerungs-Datei aufgelistet sein.

*in „Ruhestellung“ ist, d.h. keine der „Axis“ ist außerhalb der Ruhestellung. Versuchen Sie es: Bewegen Sie die Regler Ihres Joysticks und beobachten die Auswirkungen im oberen Teil der Anzeige.

===Überprüfen ob der Joystick vom PC erkannt wird===

====Für Windows:====

*Öffnen Sie Start → Einstellungen → Systemsteuerung → Gamecontroller  

*Doppelklicken Sie auf den angezeigten Joystick → damit öffnet sich bei den meisten Geräten ein Fenster in dem Sie schon alle (im Geräte-Treiber definierten) Funktionen testen können

*Beachten Sie dabei, dass die Bezeichnungen innerhalb Windows anders sein können als Sie sie später für den FlightGear benötigen. z.B. könnten Regler in Windows als „Z-Ac“ und „X-Ro.“ etc. bezeichnet werden, für die Sie später die Bezeichnungen „axis 0“, „axis 1“ etc. benötigen. Falls bei der benötigten Zuordnung Zweifel bestehen, führen Sie auf jeden Fall auch den Test im nachfolgende Kapitel 2.5.1.b js_demo: Testen & Zuordnen der Joystick-Funktionen durch.

====Für Linux:====

*Öffnen Sie ein Befehlsfenster und geben Sie ein: dmesg | grep Joystick  

*die Antwort sollte ähnlich sein wie: [ 16.481211] generic-usb 0003:06A3:075C.0001: input,hidraw0: USB HID v1.11 Joystick [Saitek Saitek X52 Flight Control System] on usb-0000:00:02.0-4/input0

*Merken Sie sich insbesondere den Namen in [ ]! Und wunderen Sie sich nicht über das 2*“Saitek“ – so heißt er nun mal und so meldet er sich am System an – und wenn Sie bei der Benutzung des Namens ein “Saitek“ weglassen funktioniert nix mehr!

*Falls OK: weiter mit: 2.5.1.b

====Für Mac OS X:====

===js_demo: Testen & Zuordnen der Joystick-Funktionen===

Hier verlassen wir also die reine System-Anbindung des Joysticks, und testen diesen selbst im System-Umfeld – wiederum erst mal ohne FlightGear!  

*'''Für Windows:'''

**Öffnen Sie Ihren „Explorer“ (rechter Mausklick auf Start → Explorer)

*'''Für Mac OS X:'''

**Öffnen Sie die Terminal.app (/Applications/Utilities/)  

**und geben ein: $ '''./js_demo'''

{| border=1

|-

*Bewegen Sie Ihre Regler und beobachten Sie die Werte in der Zeile unterhalb der „Ax:n“-Werte. Diese Werte ändern sich entsprechend Ihrer Bewegung zwischen -1.0 und +1.0. Merken Sie sich welche Ax:n mit welchem Regler geändert wird. Diese Nummer benötigen Sie später in der XML-Steuerdatei. Am Besten schreiben Sie es gleich auf und fügen auch gleich hinzu, welche Funktion (Querruder, Seitenruder, etc.) sie dieser Achse zuteilen wollen.

*Unterhalb des „Btns“ sehen Sie die Zahl „800000“ - diese zeigt die Aktionen der binären Taster an. Beim Drücken einer Taste wird eine der „0“en durch eine Zahl ersetzt. Dies sind allerdings binäre Zahlen die hexadezimal verschlüsselt sind: Also (sogar für EDV-Leute verwirrend!):

|-

||''''Code = Btn.''''||''''Code = Btn.''''

*Und vergewissern Sie sich dass ALLE Knöpfe, Regler, Schalter etc. Ihres Joysticks in oben gezeigter Liste eine Auswirkung haben!!

====jstest: (nur Linux) Testen & Zuordnen der Joystick-Funktionen====

Die meisten Linux-Systeme bieten eine zusätzliche Anwendung zur Anzeige der Achsen und Tasten: „jstest“. Diese Anwendung hat den Vorteil, dass Achsen und Tasten mit Ihren direkten Codes angezeigt werden. z.B.:

|-

||

|}

<br>Die Listen-Darstellung ist auch hier etwas „ingenieurmäßig verklausuliert“ – aber zumindest sehen Sie hier direkt und ohne Umrechnungen welche Nummer zu welcher Achse/Taste gehört! Merken Sie sich diese Zuordnungen – diese benötigen Sie wenn Sie anschließend Ihre eigene „*.xml“ schreiben oder ändern wollen.

====Installation / Benutzung des „jstest“:====

Dieses Programm ist nicht Bestandteil des FlightGear, sondern kann für die meisten Linux-Systeme zusätzlich installiert werden. Wenn Sie also ein Linux-System haben, öffnen Sie ein Befehlsfenster und geben einfach „jstest“ ein – dann können mehrere Reaktionen erfolgen:

#Es erscheint eine Benachrichtigung, wie etwa: „Der Befehl 'jstest' ist nicht installiert – Sie können ihn mit folgendem Befehl herunterladen und installieren: ….“. Geben Sie dann genau den vorgeschlagenen Befehl ein und folgen den Anweisungen – und wiederholen dann ab Punkt 1!

#Es erscheint einfach: „Befehl unbekannt“. Dann können Sie noch versuchen dieses Progrämmchen von irgendwo sonst zu erhalten – aber dazu sollten Sie sich dann schon etwas auskennen! Wie gesagt: Es ist nicht Bestandteil des FlightGear!

===Erstellen oder Ändern einer XML-Steuerdatei für Ihren Joystick===

An dieser Stelle wissen Sie nun, dass Ihr PC und Ihr Betriebssystem Ihren Joystick erkannt haben und auch ein entsprechender Gerätetreiber installiert ist und funktioniert. Zudem wissen Sie wie die Regler, Taste etc. systemintern benannt sind. Somit können Sie nun definieren welche Regler und Tasten während des Fliegens was bewirken sollen. Mit all dem nun erworbenen Wissen können Sie jetzt eine völlig neue XML-Steuerdatei schreiben – ABER: Da ich persönlich schon immer faul war, ziehe ich es vor eine bestehende Datei quasi als „Template“ (=Vorlage) zu nehmen und meinen Wünschen entsprechend abzuändern.  

*Als Nachschlagewerke empfehlen sich alle xml-Steuerdateien im Verzeichnis FG_ROOT/Input/Joysticks/ und die README: FG_ROOT/Docs/README.commands.

*'''Beachten Sie:''' Die Nummerierung der Achsen und Tasten kann zwischen den Betriebssystemen durchaus unterschiedlich sein! Wenn Sie also der glückliche Besitzer zweier PCs mit unterschiedlichen Betriebssystemen sind, können Sie dies berücksichtigen indem Sie nicht nur die erste Zeile <axis n="6"> definieren sondern dazu noch die entsprechende Nummer für andere Betriebssysteme. z.B.:

|-

<axis n="6">  

|}

*Die Reihenfolge der einzelnen Axis- und Buttons-Blöcke ist absolut beliebig. Es ist aber SEHR empfehlenswert systematisch vorzugehen, damit Sie sich später noch zurechtfinden. Es kann sehr schnell sehr unübersichtlich werde!

====„fgjs“: Erstellen einer neuen Template====

Wie bereits vorstehend gesagt können Sie sich vom System eine neue, auf Ihren PC mit Ihrem Joystick passende XML-Steuerdatei generieren lassen. Das FlightGear Zusatzprogramm „fgjs“ (bzw. unter Windows „fgjs.exe“) tut genau dies für Sie, ohne dass Sie wissen müssen welcher Regler oder Taste welchen „Namen“ hat. Das Programm „fgjs“