Jak korzystać z bezprzewodowych kontrolerów Xbox One w systemie Linux z systemem XOW

Aby używać kontrolera Xbox One bezprzewodowo w systemie Linux z XOW, należy skompilować i zainstalować sterownik, pobrać oprogramowanie układowe adaptera, uruchomić usługę systemd, a następnie sparować kontroler z bezprzewodowym adapterem USB Xbox. XOW dotyczy adaptera USB, a nie Bluetooth.

Najpierw sprawdź status projektu: opiekunowie XOW oznaczają go jako w trybie konserwacji i zalecają xone. Pierwotny projekt xone wskazuje teraz na aktywnie rozwijany fork. Jeśli jest to nowa konfiguracja, sprawdź aktywny fork xone . Poniższe kroki są zgodne z dokumentacją XOW.

Sprawdź zgodność

XOW to sterownik działający w przestrzeni użytkownika: komunikuje się z kluczem sprzętowym za pośrednictwem libusb i udostępnia dane wejściowe kontrolera za pośrednictwem interfejsu uinput Linuksa. Wbudowany w jądro sterownik xpad nie obsługuje połączeń bezprzewodowych Xbox One przez ten adapter.

W pliku README XOW wymieniono adaptery w rozmiarze slim i original, a także adapter wbudowany do Surface Book 2. Modele kontrolerów 1537, 1697, 1698, 1708 i 1797 oznaczono jako działające; model 1914 nie był testowany. Minimalne wymagania to jądro Linux 4.5 i systemd 232. Różnice w sprzęcie i dystrybucji mogą nadal wpływać na wyniki.

Zainstaluj i zbuduj XOW

1. Zainstaluj wymagania wstępne

W systemie Ubuntu lub Debian zainstaluj Git, narzędzia do kompilacji, curl, cabextract i pliki deweloperskie libusb:

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

W Fedorze, Arch, openSUSE lub innej dystrybucji zainstaluj odpowiednie pakiety za pomocą menedżera pakietów. Nazwy różnią się; szukaj Git, make, kompilatora C++, curl, cabextract, plików deweloperskich libusb i systemd.

2. Sklonuj, skompiluj i zainstaluj

Pobierz kod źródłowy, skompiluj wersję binarną i zainstaluj ją:

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

Przed instalacją przeczytaj plik README. sudo make installzapisuje pliki systemowe i działa z uprawnieniami administratora, dlatego należy korzystać z oficjalnego repozytorium, a nie z nieprzejrzanego archiwum źródłowego lub forka.

3. Pobierz oprogramowanie układowe adaptera

Pomocnik XOW pobiera i rozpakowuje oprogramowanie układowe wymagane przez kartę bezprzewodową. Uruchom go po instalacji:

sudo xow-get-firmware.sh

Projekt wymienia curl i cabextract dla tego kroku. Jeśli się nie powiedzie, sprawdź błąd i aktualne instrukcje README zamiast korzystać z niepowiązanego pliku oprogramowania sprzętowego.

4. Włącz i uruchom usługę

Włącz XOW podczas rozruchu i uruchom go teraz:

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

Plik README XOW odradza ręczne uruchamianie usługi i informuje, że po instalacji może być konieczne ponowne uruchomienie. Jeśli usługa jest aktywna, ale adapter nie został wykryty, należy ponownie uruchomić komputer i ponownie sprawdzić stan.

Sparuj kontroler

1. Podłącz adapter bezprzewodowy Xbox do komputera i poczekaj na uruchomienie XOW.
2. Naciśnij przycisk parowania na adapterze, aż jego wskaźnik zacznie migać.
3. Włącz kontroler, a następnie naciśnij i przytrzymaj przycisk synchronizacji, aż przycisk Xbox zacznie migać. Trzymaj urządzenia blisko siebie.
4. Gdy kontrolka kontrolera pozostanie zapalona, ​​przetestuj gałki i przyciski w grze lub narzędziu do testowania działania przycisków w systemie Linux.

Kontroler może nie połączyć się automatycznie z adapterem, jeśli ostatnio był używany przez USB lub Bluetooth. Sparuj go ponownie z kluczem sprzętowym. Połączenia Bluetooth wymagają konfiguracji obsługującej Bluetooth i innego sterownika; XOW nie obsługuje Bluetooth.

Rozwiązywanie typowych problemów

Sprawdź stan usługi i bieżący dziennik rozruchu:

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

• InputException: No such file or directory: XOW nie może uzyskać dostępu do /dev/uinput. Sprawdź, czy moduł uinput jest dostępny; spróbuj sudo modprobe uinput, a następnie uruchom ponownie XOW.
• Permission deniedlub LIBUSB_ERROR_ACCESS: sprawdź reguły udev zainstalowane w XOW i rozwiąż konflikty. Podłącz ponownie adapter po naprawieniu uprawnień.
• LIBUSB_ERROR_BUSYlub LIBUSB_ERROR_NO_DEVICE: inny proces lub sterownik może używać klucza sprzętowego. Zatrzymaj duplikowanie instancji XOW i unikaj uruchamiania innego sterownika na tym samym adapterze.
• LIBUSB_ERROR_TIMEOUT: spróbuj innego portu USB. XOW zgłasza problemy z niektórymi kontrolerami USB ASMedia; koncentrator może pomóc w przypadku przekroczenia limitu czasu zarządzania energią USB 3.
• Błędy oprogramowania układowego: sprawdź, czy pomoc dotycząca oprogramowania układowego została ukończona. Jeśli inny sterownik mógł załadować oprogramowanie układowe, odłącz adapter, podłącz go ponownie i uruchom program sudo systemctl restart xow.

Zatrzymaj lub usuń XOW

Tymczasowo zatrzymaj usługę za pomocą sudo systemctl stop xow. Aby zapobiec uruchamianiu podczas rozruchu, uruchom sudo systemctl disable xow. Aby usunąć usługę, zatrzymaj ją i wyłącz, wróć do sklonowanego xowkatalogu i postępuj zgodnie z instrukcjami czyszczenia zawartymi w pliku README, które używają sudo make uninstall. Usuń XOW przed zmianą sterowników, aby nie konkurowały o kartę.

Aktualne informacje można znaleźć w oficjalnym pliku README dla XOW , oryginalnym pliku README dla xone i dokumentacji jądra Linux xpad .