Come utilizzare i controller wireless Xbox One su Linux con XOW

Per utilizzare un controller Xbox One in modalità wireless su Linux con XOW, è necessario compilare e installare il driver, scaricare il firmware dell'adattatore, avviare il relativo servizio systemd e infine associare il controller all'adattatore USB wireless Xbox. XOW è progettato per l'adattatore USB, non per il Bluetooth.

Innanzitutto, verifica lo stato del progetto: i manutentori di XOW lo contrassegnano come in modalità di manutenzione e consigliano xone. Il progetto xone originale ora punta a un fork attivamente sviluppato. Se si tratta di una nuova configurazione, esamina il fork xone attivo . I passaggi seguenti seguono la documentazione ufficiale di XOW.

Verifica la compatibilità

XOW è un driver in spazio utente: comunica con il dongle tramite libusb ed espone l'input del controller attraverso l'interfaccia uinput di Linux. Il driver xpad integrato nel kernel non gestisce le connessioni wireless di Xbox One tramite questo adattatore.

Il file README di XOW elenca sia gli adattatori slim che quelli di dimensioni standard, oltre all'adattatore integrato del Surface Book 2. Indica i modelli di controller 1537, 1697, 1698, 1708 e 1797 come funzionanti; il modello 1914 non è stato testato. I requisiti minimi dichiarati sono kernel Linux 4.5 e systemd 232. Differenze hardware e di distribuzione possono comunque influire sui risultati.

Installa e compila XOW

1. Installa i prerequisiti

Su Ubuntu o Debian, installa Git, gli strumenti di compilazione, curl, cabextract e i file di sviluppo di libusb:

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

Su Fedora, Arch, openSUSE o altre distribuzioni, installa i pacchetti equivalenti utilizzando il relativo gestore di pacchetti. I nomi possono variare; cerca Git, make, un compilatore C++, curl, cabextract, i file di sviluppo di libusb e systemd.

2. Clona, ​​compila e installa

Scarica il codice sorgente originale, compila il binario di rilascio e installalo:

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

Leggere il file README del progetto originale prima dell'installazione. sudo make installIl programma scrive file di sistema ed è eseguito con privilegi di amministratore, quindi utilizzare il repository ufficiale anziché un archivio sorgente non verificato o una versione derivata.

3. Scarica il firmware dell'adattatore

Il programma di supporto di XOW scarica ed estrae il firmware necessario per l'adattatore wireless. Eseguilo dopo l'installazione:

sudo xow-get-firmware.sh

Il progetto richiede l'utilizzo di curl e cabextract per questo passaggio. In caso di errore, consultare il messaggio di errore e le istruzioni del file README anziché utilizzare un file firmware non correlato.

4. Abilitare e avviare il servizio

Abilita XOW all'avvio e avvialo ora:

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

Il file README di XOW sconsiglia l'avvio manuale e segnala che potrebbe essere necessario riavviare il sistema dopo l'installazione. Se il servizio è attivo ma l'adattatore non viene rilevato, riavviare il sistema e verificare nuovamente lo stato.

Associa il controller

1. Collega l'adattatore wireless Xbox al computer e attendi l'avvio di XOW.
2. Premi il pulsante di abbinamento dell'adattatore finché il relativo indicatore non lampeggia.
3. Accendi il controller, quindi tieni premuto il pulsante di sincronizzazione finché il pulsante Xbox non lampeggia. Tieni i dispositivi vicini.
4. Se la spia del controller rimane accesa, testa gli stick e i pulsanti in un gioco o in un'utilità di test degli input per Linux.

Un controller potrebbe non riconnettersi automaticamente all'adattatore se l'ultima volta è stato utilizzato tramite USB o Bluetooth. Associalo nuovamente con il dongle. Le connessioni Bluetooth richiedono un dispositivo compatibile con Bluetooth e un driver diverso; XOW non fornisce supporto Bluetooth.

Risolvere i problemi comuni

Verificare lo stato del servizio e il registro di avvio corrente:

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

• InputException: No such file or directoryXOW non può accedere /dev/uinput. Verificare che il modulo uinput sia disponibile; provare sudo modprobe uinput, quindi riavviare XOW.
• Permission deniedoppure LIBUSB_ERROR_ACCESS: controlla le regole udev installate con XOW e risolvi quelle in conflitto. Ricollega l'adattatore dopo aver corretto i permessi.
• LIBUSB_ERROR_BUSYoppure LIBUSB_ERROR_NO_DEVICE: un altro processo o driver potrebbe utilizzare la chiavetta. Interrompere le istanze XOW duplicate ed evitare di eseguire un altro driver sullo stesso adattatore.
• LIBUSB_ERROR_TIMEOUTProva un'altra porta USB. XOW segnala problemi con alcuni controller USB ASMedia; un hub potrebbe essere d'aiuto per i timeout di gestione dell'alimentazione USB 3.
• Errori del firmware: verificare che l'assistente del firmware sia stato completato. Se un altro driver potrebbe aver caricato il firmware, scollegare l'adattatore, ricollegarlo, quindi eseguire sudo systemctl restart xow.

Interrompere o rimuovere XOW

Interrompi temporaneamente il servizio con sudo systemctl stop xow. Per impedire l'avvio all'avvio del sistema, esegui sudo systemctl disable xow. Per la rimozione, arresta e disabilita il servizio, torna alla xowdirectory clonata e segui le istruzioni di pulizia del file README, che utilizzano sudo make uninstall. Rimuovi XOW prima di cambiare i driver in modo che non entrino in competizione per l'adattatore.

Per informazioni aggiornate, consultare il file README ufficiale di XOW , il file README originale di xone e la documentazione xpad del kernel Linux .