So verwenden Sie drahtlose Xbox One-Controller unter Linux mit XOW

Um einen Xbox One Controller unter Linux mit XOW drahtlos zu verwenden, müssen Sie den Treiber kompilieren und installieren, die Adapter-Firmware herunterladen, den zugehörigen systemd-Dienst starten und anschließend den Controller mit dem Xbox Wireless USB-Adapter koppeln. XOW ist für den USB-Adapter, nicht für Bluetooth.

Prüfen Sie zunächst den Projektstatus: Die Entwickler von XOW kennzeichnen das Projekt als im Wartungsmodus und empfehlen xone. Das ursprüngliche xone-Projekt verweist nun auf einen aktiv weiterentwickelten Fork. Falls es sich um eine Neuinstallation handelt, prüfen Sie den aktiven xone-Fork . Die folgenden Schritte orientieren sich an der Dokumentation von XOW.

Kompatibilität prüfen

XOW ist ein Benutzertreiber: Er kommuniziert über libusb mit dem Dongle und stellt Controller-Eingaben über die uinput-Schnittstelle von Linux bereit. Der im Kernel integrierte xpad-Treiber unterstützt keine drahtlosen Xbox One-Verbindungen über diesen Adapter.

Die XOW-README-Datei listet sowohl Slim- als auch Original-Adapter sowie den im Surface Book 2 integrierten Adapter auf. Die Controller-Modelle 1537, 1697, 1698, 1708 und 1797 werden als funktionierend gekennzeichnet; Modell 1914 ist ungetestet. Als Mindestanforderungen werden Linux-Kernel 4.5 und systemd 232 genannt. Hardware- und Distributionsunterschiede können die Ergebnisse jedoch beeinflussen.

XOW installieren und kompilieren

1. Installieren Sie die erforderlichen Komponenten

Installieren Sie unter Ubuntu oder Debian Git, Build-Tools, curl, cabextract und die libusb-Entwicklungsdateien:

sudo apt update
sudo apt install git build-essential curl cabextract libusb-1.0-0-dev

Unter Fedora, Arch, openSUSE oder einer anderen Distribution installieren Sie die entsprechenden Pakete mit dem jeweiligen Paketmanager. Die Namen können variieren; suchen Sie nach Git, make, einem C++-Compiler, curl, cabextract, den libusb-Entwicklungsdateien und systemd.

2. Klonen, kompilieren und installieren

Laden Sie den Quellcode herunter, erstellen Sie die Release-Binärdatei und installieren Sie sie:

git clone https://github.com/medusalix/xow
cd xow
make BUILD=RELEASE
sudo make install

Lesen Sie vor der Installation die README-Datei des Originalprojekts. Das sudo make installProgramm schreibt Systemdateien und wird mit Administratorrechten ausgeführt. Verwenden Sie daher das offizielle Repository und nicht ein ungeprüftes Quellcodearchiv oder einen Fork.

3. Laden Sie die Adapter-Firmware herunter.

Der XOW-Helfer lädt die für den WLAN-Adapter benötigte Firmware herunter und extrahiert sie. Führen Sie ihn nach der Installation aus:

sudo xow-get-firmware.sh

Das Projekt empfiehlt für diesen Schritt die Befehle curl und cabextract. Sollte dies fehlschlagen, überprüfen Sie die Fehlermeldung und die Anweisungen in der aktuellen README-Datei, anstatt eine nicht zugehörige Firmware-Datei zu verwenden.

4. Aktivieren und starten Sie den Dienst.

XOW beim Systemstart aktivieren und jetzt starten:

sudo systemctl enable xow
sudo systemctl start xow
systemctl status xow --no-pager

Die README-Datei von XOW rät von einem manuellen Start ab und weist darauf hin, dass nach der Installation möglicherweise ein Neustart erforderlich ist. Falls der Dienst aktiv ist, der Adapter aber nicht erkannt wird, starten Sie den Computer neu und überprüfen Sie den Status erneut.

Koppeln Sie den Controller

1. Schließen Sie den Xbox Wireless Adapter an den Computer an und warten Sie, bis XOW startet.
2. Drücken Sie die Kopplungstaste des Adapters, bis dessen Anzeige blinkt.
3. Schalten Sie den Controller ein und halten Sie dann die Synchronisierungstaste gedrückt, bis die Xbox-Taste blinkt. Halten Sie die Geräte in der Nähe.
4. Wenn die Kontrollleuchte des Controllers anbleibt, testen Sie die Sticks und Tasten in einem Spiel oder einem Linux-Eingabetestprogramm.

Ein Controller verbindet sich möglicherweise nicht automatisch wieder mit dem Adapter, wenn er zuletzt über USB oder Bluetooth verwendet wurde. Koppeln Sie ihn erneut mit dem Dongle. Bluetooth-Verbindungen erfordern ein Bluetooth-fähiges System und einen anderen Treiber; XOW bietet keine Bluetooth-Unterstützung.

Häufige Probleme beheben

Prüfen Sie den Dienststatus und das aktuelle Startprotokoll:

systemctl status xow --no-pager
journalctl -u xow -b --no-pager

• InputException: No such file or directoryXOW kann nicht zugreifen /dev/uinput. Überprüfen Sie, ob das uinput-Modul verfügbar ist; versuchen Sie sudo modprobe uinputes erneut und starten Sie XOW anschließend neu.
• Permission deniedOder LIBUSB_ERROR_ACCESS: Überprüfen Sie die mit XOW installierten udev-Regeln und beheben Sie Konflikte. Schließen Sie den Adapter nach der Korrektur der Berechtigungen erneut an.
• LIBUSB_ERROR_BUSYOder LIBUSB_ERROR_NO_DEVICE: Ein anderer Prozess oder Treiber verwendet möglicherweise den Dongle. Beenden Sie doppelte XOW-Instanzen und vermeiden Sie die Ausführung eines anderen Treibers mit demselben Adapter.
• LIBUSB_ERROR_TIMEOUTVersuchen Sie einen anderen USB-Anschluss. XOW meldet Probleme mit einigen ASMedia-USB-Controllern; ein Hub könnte bei USB-3-Energieverwaltungs-Timeouts helfen.
• Firmware-Fehler: Prüfen Sie, ob der Firmware-Helfer vollständig ausgeführt wurde. Falls ein anderer Treiber die Firmware geladen hat, trennen Sie den Adapter, schließen Sie ihn wieder an und führen Sie den Vorgang erneut aus sudo systemctl restart xow.

XOW stoppen oder entfernen

Den Dienst vorübergehend stoppen sudo systemctl stop xow. Um den automatischen Start beim Systemstart zu verhindern, führen Sie aus sudo systemctl disable xow. Zur Entfernung den Dienst stoppen und deaktivieren, in das geklonte xowVerzeichnis zurückkehren und die Bereinigungsanweisungen in der README-Datei befolgen sudo make uninstall. Entfernen Sie XOW, bevor Sie die Treiber wechseln, damit diese nicht um den Adapter konkurrieren.

Für aktuelle Details konsultieren Sie bitte die offizielle XOW README-Datei , die ursprüngliche xone README-Datei und die xpad-Dokumentation des Linux-Kernels .