[Tutorial] Logitech G27 (und andere Lenkräder) an PS4

1. 'Raspberry Pi' (in Folge kurz 'Pi' genannt) + Case + Netzteil + SD-Karte(>=4GB)
(Alle erhältlichen Pi-Modelle(ausser dem 'Pi Zero') sollten funtzen... Ich benutze das alte Modell B)
2. 'Teensy 2.0' oder 'Teensy++ 2.0' (in Folge kurz 'Teensy' genannt) - ACHTUNG: Teensy 3.0 ist nicht kompatibel !
(Das ist im Grunde ein Micro-PC... Ich hab den 'Teensy++ 2.0')
3. Lenkrad G27
4. Dualshock 4 Controller
5. HDMI-Kabel, USB-auf-MiniUSB Kabel, USB-auf-MicroUSB Kabel
6. Einen 2,2 kOhm Widerstand und einen 3,3 kOhm Widerstand
7. Buchsenleiste (Rastermass=2,54mm / Höhe=8,5mm)... nehmt eine Buchsenleiste mit geraden Anschlüssen !
8. Ein zweipoliger Taster schliessend
9. Elektronik-Lötkolben, 6 farbige Drähte(a 10cm), Elektronik-Lötzinn (idealerweise mit Flussmittelkern)
10.Heissklebepistole o.ä
Anmerkung 1:
Die hier angegebene Widerstandskombination ist nur ein Vorschlag.
Im Grunde kann man jede andere Kombination verwenden, die sich ungefähr im Verhältnis 3:2 teilt,
wobei man darauf achten muss, dass der kleinere Widerstand an den GND-Anschluss des 'Teensy' kommt.
Anmerkung 2 (für die, die's genau wissen wollen):
Hintergrund für den Einsatz der beiden Widerstände ist, dass der 'Teensy' 5V Signale ausgibt, während der 'Pi' 3,3V Signale am Eingang benötigt.
Damit der 'Pi' durch die 'Überspannung' keinen Schaden erleidet nutzt man die in Reihe geschalteten Widerstände als Spannungsteiler (5V/3,3V~3:2).

1. GEDULD
2. NOCH MEHR GEDULD
3. Minimale Lötfähigkeiten
4. Keine Angst davor sich etwas mit Linux auf Kommandoebene rumzuschlagen (bin da auch bei weitem kein Experte)

TEENSY
1. Von der Buchsenleiste ein 2er- und 3er-Stück abtrennen und deren Anschlüsse verzinnen
2. 4 farbige Drähte an den Enden abisolieren und verzinnen
3. Hier mal ein Bild wie man's nun zusammenlötet:
[Blockierte Grafik: http://i.imgur.com/uXxbKIF.jpg]
ACHTUNG: Die Beschriftung der Widerstände im Bild ist falschrum !
a) Das schwarze(GND), rote(D2) und orange(+5V/VCC) Kabel von der Vorderseite durch die Lötösen geführt und von der Rückseite verlötet.
b) Den 3.3 kOhm Widerstand an den Lötpunkt des schwarzen Kabels gelötet
c) Den 2,2 kOhm Widerstand an den Lötpunkt D3 gelötet
d) Die beiden Widerstände an ihrem Kreuzungspunkt verlötet
e) Das weiße Kabel an den Kreuzungspunkt gelötet.
f) Etwas Klebeband zur Isolation unter den Kreuzungspunkt geklebt, damit keine Kurzschlüsse entstehen
g) Die Kabel an die Buchsenleistenstücke gelötet (Aufpassen, dass man die gleiche Reihenfolge wie im Bild beibehält)
Anmerkung: Die Erklärung warum das orange Kabel optional ist folgt später

SHUTDOWN BUTTON
1. 2 farbige Kabel an den beiden Kontakten des Tasters anlöten (blau & grau im Bild... siehe Sektion G)
2. Ein 2er Stück von der Buchsenleiste abtrennen und die anderen Enden der 2 farbigen Kabel daran verlöten

1. Steckt den 'Teensy' per USB-auf-MiniUSB Kabel an den PC (der sollte dann den Treiber automatisch installieren)
2. Startet die 'Teensy Loader App'

3. Jetzt sieht man ein kleines Fenster mit einem ausgegrautem Bild des 'Teensy'
4. Drückt den kleinen Knopf am 'Teensy' und das Bild im Fenster sollte 'klar' werden (='Teensy' ist im Flash-Modus)
5. Im Firmware-Download für den 'Teensy' den 'EMUG29PS4'-Ordner öffnen
6a.Für 'Teensy 2.0' : Die Datei 'atmega32u4.hex' auf das Bild des 'Teensy' in der 'Teensy Loader App' ziehn
6b.Für 'Teensy++ 2.0' : Die Datei 'at90usb1286.hex' auf das Bild des 'Teensy' in der 'Teensy Loader App' ziehn
__(Der Dateiname der '*.hex'-Datei steht nun untem im Fenster)
7. Den nach unten gerichteten grünen Pfeil drücken um den 'Teensy' zu flashen
__(Es sollte nun 'Download Complete' unten im Fenster zu lesen sein)
8. Den nach rechts gerichteten grünen Pfeil drücken um den 'Teensy' zu rebooten
9. 'Teensy Loader App' schliessen und 'Teensy' vom PC entfernen

Das macht jetzt richtig Arbeit... also fangt damit nur an, wenn genug Zeit da ist !

Alternativ stelle ich hier mein SD-Card-Image zur Verfügung:
RudisPiGimx.part01.rar
RudisPiGimx.part02.rar
RudisPiGimx.part03.rar
Benötigt wird eine SD-Karte mit mindestens 2GB.
Ausserdem muss man noch
- das Filesystem via "sudo raspi-config" erweitern
- die Ethernet-Konfiguration dem eigenen Heimnetzwerk anpassen (siehe Kapitel "Dem 'Pi' EINE FESTE IP-ADDRESSE GEBEN" etwas weiter unten)

SD MIT DEM 'RASPIAN'-IMAGE FLASHEN
1. Steckt die SD in den PC-Cardreader und startet 'Win32 Disk Imager'
2. Klickt auf das kleine Ordner-Symbol und wählt die 'xxxx-xx-xx-raspbian-jessie-lite.img'-Datei aus
3. Unter 'Device' den Laufwerksbuchstaben der SD einstellen (steht meist schon richtig)
4. Klickt den 'Write'-Button und wartet bis das Schreiben des Images auf die SD fertig ist.
5. 'Win32 Disk Imager' beenden und SD entnehmen

'Pi' ZUM EINRICHTEN VERKABELN
1. Steckt die SD in den SD-Kartenslot des 'Pi'
2. Verbindet den 'Pi' via HDMI-Kabel mit dem TV (oder einem anderen Anzeigegerät) und stellt dieses auf den richtigen HDMI-Kanal.
3. Verbindet den 'Pi' via LAN-Kabel mit eurem Heimnetzwerk
4. Verbindet das 'Pi'-Netzteil mit dem 'Pi'
5. Der 'Pi' fährt nun hoch und gibt jede Menge Text aus (der euch nicht zu interessieren braucht)
6. Wartet bis sich das Geschehen auf dem Bildschirm beruhigt hat

'Pi' VOM PC AUS BEDIENEN
Anmerkung: Man könnte auch eine Tastatur an den 'Pi' anschliessen und alles folgende eintippen, doch das ist einfach zu mühsam.
1. In etwa in der Mitte des Bildschirms steht 'My IP address is 192.168.x.y' ... Diese IP-Adresse merken !
2. 'Putty' am PC starten
3. Gebt bei 'Host Name (or IP address)' die IP-Adresse des 'Pi' ein
4. Gebt bei 'Saved Sessions' dem 'Pi' einen Namen... z.b. 'GIMX Pi' und klickt den 'Save'-Button
5. Doppelklick auf 'GIMX Pi' und die ggf erscheinende Meldung bestätigen
6. Es erscheint eine Art DOS-Fenster und Ihr müsst das Login und dann das Passwort eingeben (pi & raspberry)
__(Linux unterscheidet Groß/Klein-Schreibung... also aufgepasst !)
7. Nun kann man dem 'Pi' Befehle erteilen (Dazu schaut Euch nun bitte erst mal den ANHANG ganz unten im Tut an)

Dem 'Pi' EINE FESTE IP-ADDRESSE GEBEN
Anmerkung:
Da der 'Pi' aktuell beim einschalten vom Eurem Router eine IP-Adresse zugewiesen bekommt, kann es passieren, dass dies nicht immer die gleiche IP-Adresse ist. Das hätte zur Folge, dass man die IP-Adresse jedesmal nachsehen muss, wenn man via 'Putty' Kontakt aufnehmen will.
Da das nicht sehr schön ist, ist es nötig dem 'Pi' eine feste IP-Adresse zu geben, die sich nie ändert.
1. Gateway-IP(=Router-IP) finden : "route -n" eingeben -> In der ersten Zeile findet man die Gateway-IP (zb 192.168.1.1)
2. "sudo nano /etc/network/interfaces" eingeben
3. Die Zeile "iface eth0 inet manual" ersetzen mit

# Ethernet
auto eth0
allow-hotplug eth0
iface eth0 inet static
address <Pi-IP>
netmask 255.255.255.0
gateway <Gateway-IP>
dns-nameservers 8.8.8.8

__'<Pi-IP>' mit der IP-Adresse des 'Pi' ersetzen (s.o)
__'<Gateway-IP>' mit der Gateway-IP ersetzen (s.o)
4. Speichern und beenden
5. Um den DHCP-Client und TriggerHappy zu deaktivieren folgende Zeilen nacheinander eingeben:

sudo service dhcpcd stop
sudo systemctl disable dhcpcd
sudo service triggerhappy stop
sudo update-rc.d triggerhappy disable
sudo reboot

6. Reboot abwarten und dann wieder per 'Putty' einloggen

'Pi' KONFIGURIEREN
1. "sudo raspi-config"
2. 'Advanced Options' -> 'A8 Serial' -> 'No' -> 'Ok'
3. 'Finish' -> 'Yes'
4. Reboot abwarten und dann wieder per 'Putty' einloggen
5. Um den 'Pi' vollständig zu updaten folgende Zeilen nacheinander eingeben

sudo apt-get update && sudo apt-get upgrade
sudo apt-get install rpi-update
sudo rpi-update
sudo reboot

Anmerkung: Abfragen mit 'y' bestätigen
6. Reboot abwarten und dann wieder per 'Putty' einloggen
7. "sudo nano /boot/config.txt"
8. Nach ganz unten scrollen und vor der Zeile 'enable_uart=0' die Zeile 'dtoverlay=pi3-disable-bt' einfügen
9. Die Zeile 'enable_uart=0' in 'enable_uart=1' abändern
10. Hinter der Zeile 'enable_uart=1' die Zeile 'init_uart_clock=8000000' einfügen
11. Speichern und beenden

'GIMX' INSTALLIEREN UND IN DEN AUTOSTART SETZEN
1. Folgende Zeilen nacheinander eingeben:

wget http://gimx.fr/download/gimx-raspbian -O gimx.deb -O gimx.deb
sudo sudo dpkg -i gimx.deb
sudo apt-get -f install
sudo nano /etc/systemd/system/gimx.service

Anmerkung: Das 'sudo sudo dpkg -i gimx.deb' wird einige Fehler ausgeben... Das ist normal !

2. Folgenden Textblock per Copy'n'Paste einfügen:

[Unit]
Description=GIMX
After=syslog.target network.target
[Service]
User=pi
Type=simple
ExecStart=/usr/bin/gimx -p /dev/ttyAMA0 -c LogitechG27_G29.xml --nograb
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target

3. Speichern und beenden
4. "sudo systemctl daemon-reload"
5. "sudo systemctl enable gimx && sudo systemctl start gimx"

GIMX KONFIGURIEREN
1. Um die passende Lenkradkonfiguration hinzuzufügen folgende Zeilen nacheinander eingeben:
cd /home/pi
mkdir .gimx
cd .gimx
mkdir config
cd config
sudo nano LogitechG27_G29.xml

2. G27-Konfigurations-Seite am PC-Browser öffnen
3. Den kompletten Text ab einschliesslich '<?xml version="1.0" encoding="UTF-8"?>' bis '</root>' per copy'n'paste im 'nano'-Fenster einfügen
4. Speichern und beenden
Anmerkung 1:
Wer ein anders Lenkrad besitzt als das G27, der schaut bitte mal HIER. Es finden sich hier Konfigurationsdateien für andere Lenkräder.
Alle die auf 'G29.xml' enden kommen in Frage.
Anpassen muss man dann hier im Tut die Zeilen
- 'sudo nano LogitechG27_G29.xml'
- 'ExecStart=/usr/bin/gimx -p /dev/ttyAMA0 -c LogitechG27_G29.xml --nograb'

SHUTDOWN EINRICHTEN
Wichtiger Hinweis :
Den 'Pi' einfach vom Strom zu trennen ist keine gute Idee, denn das wird Euch füher oder später die SD-Karte zerschiessen.
Deshalb verwenden wir hier einen Taster, der, wenn gedrückt, den 'Pi' sauber herunterfährt.

!!! MACHT DAS BEVOR IHR DIE PS4 AUSCHALTET !!!

1. Um ein Python-Script zu erstellen, das den 'Pi' runterfährt, wenn man den "Shutdown-Taster" drückt, folgende Zeilen nacheinander eingeben:

cd /home/pi
mkdir Scripts
cd Scripts
sudo nano shutdown_pi.py

2. Den folgenden Block via Copy'n'Paste einfügen

#!/bin/python
# Simple script for shutting down the raspberry Pi at the press of a button.
# by Inderpreet Singh
import RPi.GPIO as GPIO
import time
import os
# Use the Broadcom SOC Pin numbers
# Setup the Pin with Internal pullups enabled and PIN in reading mode.
GPIO.setmode(GPIO.BCM)
GPIO.setup(18, GPIO.IN, pull_up_down = GPIO.PUD_UP)
# Our function on what to do when the button is pressed
def Shutdown(channel):
    os.system("sudo init 0")
# Add our function to execute when the button pressed event happens
GPIO.add_event_detect(18, GPIO.FALLING, callback = Shutdown, bouncetime = 2000)
# Now wait!
while 1:
    time.sleep(1)

3. Speichern und beenden
4. "sudo nano /etc/rc.local"
5. Runterscrollen und direkt vor der "exit 0'-Zeile eine neue Zeile eingügen: "sudo python /home/pi/Scripts/shutdown_pi.py &"
6. Speichern und beenden
7. "sudo init 0"
Anmerkung 1:
Ich empfehle nach Schritt 3 das 'Shutdown'-Script mit "sudo python /home/pi/Scripts/shutdown_pi.py" erstmal zu testen
Dafür muss man natürlich wenigstens den 'Shutdown'-Taster mit dem 'Pi' verbinden (siehe Sektion G)
Anmerkung 2: Der letzte Befehl schaltet den 'Pi' aus

[Blockierte Grafik: http://i.imgur.com/zHTZlPX.jpg]
'Teensy' auf den GPIO des 'Pi' gesteckt.
Die äußere Stiftreihe des 'Pi' ist, beginnend an der 'Ecke' des 'Pi'(im Bild oben links), durchnummeriert mit den geraden Zahlen 2,4,6...

+----+--------+--------+| Pi | Teensy | Kabel  |+----+--------+--------+| 2  |  +5V   | orange || 6  |  GND   | schwarz|| 8  |  D2    | rot    || 10 |  X     | weiss  |+----+--------+--------+X = Kreuzungspunkt der beiden Widerstände

[Blockierte Grafik: http://i.imgur.com/VxKV2co.jpg]
Der 'Teensy' in den Case-Deckel des 'Pi' geklebt (Bitte vorher ein Loch für die Mini-USB-Buchse des Teensy aus dem Pi-Case schneiden)

[Blockierte Grafik: http://i.imgur.com/gujJC3C.jpg]
Dies zeigt den "Shutdown"-Taster verbunden mit der 'Pi' GPIO an Pin 12 & 14

[Blockierte Grafik: http://i.imgur.com/GH278sg.jpg]
Alles fertig... man sieht unten den normalen Stromanschluss des Pi und darüber die USB-Buchse des 'Teensy'

Anmerkung: Einige der Bilder sind schon älter und zeigen deswegen den "Shutdown"-Taster nicht

STROMVERSORGUNG ÜBER PS4... ECHT JETZT ?
Manche werden sich fragen, ob das die PS4 nicht langfristig überfordert, aber da die PS4 USB3-Anschlüsse hat, die bis zu 900mA verkraften, sollte das so, wie hier vorgestellt, kein Problem darstellen.
Selbst ein Pi3 benötigt unter Vollast aller 4 Kerne nur ca 750mA. GIMX ist von Volllast und Ausnutzung aller 4 Kerne aber mehr als weit entfernt.
Und die angeschlossenen USB-Geräte(Lenkrad und Dualshock 4) benötigen auch nichts zusätzlich an Strom.

Aber... wenn man's doch lieber anders machen will, dann zieht man einfach das orange Kabel von Pin 2 des 'Pi' und befeuert ihn dann alternativ mit seinem Netzteil.

1. Schaltet die PS4 aus
2. Verbindet den 'Pi' via USB mit dem Lenkrad und einem Dualshock 4
3. Verbindet den 'Pi' via der 'Teensy'-Mini-USB-Buchse mit der PS4
4. Schaltet die PS4 an der PS4 selber an
5. Beobachtet die LED des Dualshock 4 bis das diese gelb aufblinkt (kann ca 2-3 Minuten dauern)
6. Drückt die ganz linke orange Taste am Lenkrad (=PS-Taste)
7. Jetzt solltet Ihr im PS4-Menü mit dem Lenkrad-Steuerkreuz navigieren können und auch sonst sollten alle Knöpfe funktionieren

8. Zum sauberen Runterfahren des 'Pi' den "Shutdown"-Taster kurz drücken und warten bis nur noch die rote LED am 'Pi' leuchtet. Dann erst PS4 ausschalten.

Unterschiede und das Zusammenarbeiten von Copy&Paste bei Windoof und Linux:
- Windoof: Wie 'Kopieren' und 'Einfügen' über das Kontext-Menü funzt sollte wohl jedem klar sein
- Linux: 'Kopieren' = Text markieren / 'Einfügen'= Rechter Mausklick

Wollt Ihr zB den Text 'Rudi ist doof' in die Eingabezeile von 'Putty' kopieren, dann...
Den Text 'Rudi ist doof' markieren -> Rechtsklick auf den markierten Text-> 'Kopieren' -> Rechtsklick ins 'Putty'-Konsolenfenster
!!! Auf diese Weise kann man im Folgenden die ganzen Befehle copy'n'pasten !!!
(Andersrum (von Linux nach Windoof) funzt das übrigens auch)

- Copy'n'Paste : Funzt hier genauso wie oben beschrieben
- Cursor im Text bewegen : mit den Cursor-Tasten
- Text speichern und 'nano' beenden: 'Strg' + 'x' drücken -> 'Y' oder 'J' -> 'ENTER'
_(Ist im Tutorial die Rede von 'Speichern und beenden', dann ist genau das hier gemeint)