Comment utiliser des manettes Xbox One sans fil sous Linux avec XOW

Pour utiliser une manette Xbox One sans fil sous Linux avec XOW, compilez et installez le pilote, téléchargez le firmware de l'adaptateur, démarrez son service systemd, puis associez la manette à l'adaptateur USB sans fil Xbox. XOW est compatible avec l'adaptateur USB, et non avec le Bluetooth.

Vérifiez d'abord l'état du projet : les responsables de XOW l'ont indiqué comme étant en mode maintenance et recommandent xone. Le projet xone original pointe désormais vers un fork activement développé. Si vous venez d'installer XOW, consultez le fork xone actif . Les étapes ci-dessous suivent la documentation de XOW.

Vérifier la compatibilité

XOW est un pilote espace utilisateur : il communique avec le dongle via libusb et expose les entrées de la manette via l'interface uinput de Linux. Le pilote xpad intégré au noyau ne gère pas les connexions sans fil Xbox One via cet adaptateur.

Le fichier README de la carte mère XOW mentionne les adaptateurs fins et de taille standard, ainsi que l'adaptateur intégré du Surface Book 2. Il indique que les modèles de contrôleur 1537, 1697, 1698, 1708 et 1797 sont compatibles ; le modèle 1914 n'a pas été testé. La configuration minimale requise est un noyau Linux 4.5 et le port systemd 232. Les différences matérielles et de distribution peuvent toutefois affecter les résultats.

Installer et configurer XOW

1. Installez les prérequis

Sous Ubuntu ou Debian, installez Git, les outils de compilation, curl, cabextract et les fichiers de développement libusb :

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

Sur Fedora, Arch, openSUSE ou toute autre distribution, installez les paquets équivalents à l'aide de son gestionnaire de paquets. Leurs noms diffèrent ; recherchez Git, make, un compilateur C++, curl, cabextract, les fichiers de développement de libusb et systemd.

2. Cloner, compiler et installer

Récupérez le code source en amont, compilez le binaire de la version et installez-le :

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

Veuillez lire le fichier README du dépôt d'origine avant l'installation. sudo make installCe programme écrit des fichiers système et s'exécute avec des privilèges d'administrateur ; utilisez donc le dépôt officiel plutôt qu'une archive source non vérifiée ou un fork.

3. Récupérer le firmware de l'adaptateur

L'utilitaire de XOW télécharge et extrait le firmware requis par la carte réseau sans fil. Exécutez-le après l'installation :

sudo xow-get-firmware.sh

Le projet indique que curl et cabextract sont nécessaires pour cette étape. En cas d'échec, veuillez consulter l'erreur et les instructions du fichier README afin d'éviter d'utiliser un fichier de firmware non compatible.

4. Activez et démarrez le service

Activez XOW au démarrage et lancez-le maintenant :

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

Le fichier README de XOW déconseille son lancement manuel et indique qu'un redémarrage peut être nécessaire après l'installation. Si le service est actif mais que la carte réseau n'est pas détectée, redémarrez l'ordinateur et vérifiez à nouveau l'état du service.

Associer le contrôleur

1. Branchez l'adaptateur sans fil Xbox à l'ordinateur et attendez que XOW démarre.
2. Appuyez sur le bouton d'appairage de l'adaptateur jusqu'à ce que son indicateur clignote.
3. Allumez la manette, puis maintenez enfoncé son bouton de synchronisation jusqu'à ce que le bouton Xbox clignote. Gardez les appareils à proximité.
4. Si le voyant de la manette reste allumé, testez les joysticks et les boutons dans un jeu ou un utilitaire de test d'entrée Linux.

Il est possible qu'une manette ne se reconnecte pas automatiquement à l'adaptateur si elle a été utilisée pour la dernière fois via USB ou Bluetooth. Dans ce cas, veuillez l'appairer à nouveau avec le dongle. Les connexions Bluetooth nécessitent une configuration compatible Bluetooth et un pilote différent ; XOW ne prend pas en charge le Bluetooth.

Résoudre les problèmes courants

Vérifiez l'état du service et le journal de démarrage actuel :

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

• InputException: No such file or directoryXOW ne peut pas accéder à /dev/uinput. Vérifiez que le module uinput est disponible ; essayez sudo modprobe uinput, puis redémarrez XOW.
• Permission deniedOu bienLIBUSB_ERROR_ACCESS : vérifiez les règles udev installées avec XOW et résolvez les conflits. Rebranchez l’adaptateur après avoir corrigé les permissions.
• LIBUSB_ERROR_BUSYOu bienLIBUSB_ERROR_NO_DEVICE : un autre processus ou pilote utilise peut-être la clé. Arrêtez les instances XOW en double et évitez d’exécuter un autre pilote sur le même adaptateur.
• LIBUSB_ERROR_TIMEOUTEssayez un autre port USB. XOW signale des problèmes avec certains contrôleurs USB ASMedia ; un hub peut aider à résoudre les problèmes de délai d'expiration de la gestion de l'alimentation USB 3.
• Erreurs de microprogramme : vérifiez que l’assistant de microprogramme s’est terminé. Si un autre pilote a chargé le microprogramme, débranchez l’adaptateur, rebranchez-le, puis exécutez la commande sudo systemctl restart xow.

Arrêtez ou supprimez XOW

Arrêtez temporairement le service avec sudo systemctl stop xowla commande `. Pour empêcher son démarrage automatique, exécutez ` sudo systemctl disable xow. Pour le supprimer, arrêtez et désactivez le service, retournez dans le xowrépertoire cloné et suivez les instructions de nettoyage du fichier README, qui utilisent ` sudo make uninstall. Supprimez XOW avant de changer de pilote afin d'éviter tout conflit d'utilisation de la carte réseau.

Pour plus de détails, consultez le fichier README officiel de XOW , le fichier README original de xone et la documentation xpad du noyau Linux .