Cum se utilizează controlerele wireless Xbox One pe Linux cu XOW

Pentru a utiliza un controler Xbox One fără fir pe Linux cu XOW, compilați și instalați driverul, preluați firmware-ul adaptorului, porniți serviciul systemd, apoi asociați controlerul cu adaptorul USB fără fir Xbox. XOW este pentru adaptorul USB, nu pentru Bluetooth.

Verificați mai întâi starea proiectului: administratorii XOW îl marchează ca fiind în modul de întreținere și recomandă xone. Proiectul xone original indică acum o ramură dezvoltată activ. Dacă aceasta este o configurație nouă, verificați ramura xone activă . Pașii de mai jos respectă documentația proprie a XOW.

Verificați compatibilitatea

XOW este un driver de spațiu utilizator: comunică cu dongle-ul prin libusb și expune datele de intrare ale controlerului prin interfața uinput a Linux. Driverul xpad încorporat în kernel nu gestionează conexiunile wireless Xbox One prin acest adaptor.

Fișierul README XOW listează atât adaptoarele subțiri, cât și cele de dimensiuni originale, plus adaptorul încorporat pentru Surface Book 2. Acesta marchează modelele de controler 1537, 1697, 1698, 1708 și 1797 ca fiind funcționale; modelul 1914 nu este testat. Rezoluțiile minime declarate sunt kernelul Linux 4.5 și systemd 232. Diferențele de hardware și distribuție pot afecta în continuare rezultatele.

Instalați și construiți XOW

1. Instalați cerințele preliminare

Pe Ubuntu sau Debian, instalați Git, instrumentele de compilare, curl, cabextract și fișierele de dezvoltare libusb:

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

Pe Fedora, Arch, openSUSE sau o altă distribuție, instalați pachetele echivalente folosind managerul de pachete al acestora. Numele diferă; căutați Git, make, un compilator C++, curl, cabextract, fișierele de dezvoltare libusb și systemd.

2. Clonează, compilează și instalează

Obțineți sursa upstream, construiți fișierul binar de lansare și instalați-l:

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

Citiți fișierul README din amonte înainte de instalare. sudo make installScrie fișierele de sistem și rulează cu privilegii de administrator, așadar folosiți depozitul oficial în loc de o arhivă sursă sau un fork neravizuit.

3. Preluați firmware-ul adaptorului

Instrumentul auxiliar XOW descarcă și extrage firmware-ul necesar adaptorului wireless. Rulați-l după instalare:

sudo xow-get-firmware.sh

Proiectul listează instrucțiunile curl și cabextract pentru acest pas. Dacă eșuează, verificați eroarea și instrucțiunile README curente în loc să utilizați un fișier firmware fără legătură.

4. Activați și porniți serviciul

Activați XOW la pornire și porniți-l acum:

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

Fișierul README al XOW descurajează lansarea manuală și menționează că poate fi necesară o repornire după instalare. Dacă serviciul este activ, dar adaptorul nu este detectat, reporniți o dată și verificați din nou starea.

Asociați controlerul

1. Conectați adaptorul wireless Xbox la computer și așteptați ca XOW să pornească.
2. Apăsați butonul de asociere al adaptorului până când indicatorul acestuia clipește.
3. Pornește controlerul, apoi apasă și ține apăsat butonul de sincronizare până când butonul Xbox clipește. Ține dispozitivele aproape.
4. Când lumina controlerului rămâne aprinsă, testați manetele și butoanele într-un joc sau într-un utilitar de testare a intrării în Linux.

Este posibil ca un controler să nu se reconecteze automat la adaptor dacă a fost utilizat ultima dată prin USB sau Bluetooth. Asociați-l din nou cu dongle-ul. Conexiunile Bluetooth necesită o configurație compatibilă cu Bluetooth și un driver diferit; XOW nu oferă suport Bluetooth.

Depanați problemele comune

Verificați starea serviciului și jurnalul de pornire curent:

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

• InputException: No such file or directoryXOW nu poate accesa /dev/uinput. Verificați dacă modulul uinput este disponibil; încercați sudo modprobe uinput, apoi reporniți XOW.
• Permission deniedsau LIBUSB_ERROR_ACCESS: verificați regulile udev instalate cu XOW și rezolvați regulile conflictuale. Reconectați adaptorul după remedierea permisiunilor.
• LIBUSB_ERROR_BUSYsau LIBUSB_ERROR_NO_DEVICE: este posibil ca un alt proces sau driver să utilizeze dongle-ul. Opriți instanțele XOW duplicate și evitați rularea unui alt driver pe același adaptor.
• LIBUSB_ERROR_TIMEOUTÎncercați un alt port USB. XOW raportează probleme cu unele controllere USB ASMedia; un hub ar putea ajuta cu expirarea timpilor de gestionare a energiei prin USB 3.
• Erori de firmware: confirmați finalizarea programului de asistență pentru firmware. Dacă este posibil ca un alt driver să fi încărcat firmware-ul, deconectați adaptorul, reconectați-l, apoi rulați sudo systemctl restart xow.

Opriți sau eliminați XOW

Opriți temporar serviciul cu sudo systemctl stop xow. Pentru a preveni pornirea la bootare, executați sudo systemctl disable xow. Pentru eliminare, opriți și dezactivați serviciul, reveniți la xowdirectorul clonat și urmați instrucțiunile de curățare ale fișierului README, care utilizează sudo make uninstall. Eliminați XOW înainte de a schimba driverele, astfel încât acestea să nu concureze pentru adaptor.

Pentru detalii actuale, consultați fișierul README oficial XOW , fișierul README original xone și documentația kernelului Linux xpad .