Mise à niveau en xone est fortement recommandé! xow est un pilote de mode utilisateur Linux pour le dongle sans fil Xbox One. Il communique avec le dongle via...

Dépôt créer le : 21/12/2019

Release du : 26/02/2026 v0.5 – xow 0.5

Forks: 89 Watcher: 0 1455

Github: https://github.com/medusalix/xow

Ajouter à une sélection :

Connectez-vous pour gérer vos sélections.

Screenshot

Ce projet est en mode maintenance

Mise à niveauxoneestfortement recommandé- Oui!

À propos

xow est un pilote de mode utilisateur Linux pour le dongle sans fil Xbox One. Il communique avec le dongle vialibusbet fournit une entrée de joystick à travers leuinputmodule noyau. La cartographie d'entrée est basée sur les pilotes du noyau existants commexpad.

Appareils pris en charge

xow prend en charge les deux versions du dongle sans fil (slim et volumineux) et de l'adaptateur intégré de Surface Book 2. Les contrôleurs Xbox One suivants sont actuellement compatibles avec le pilote:

Numéro de modèle Année Informations supplémentaires Statut -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 2013TravailAutres 2015TravailAutres 2015TravailAutres Connexion BluetoothTravailAutres Régulateur Elite série 2TravailAutres # 1914 # 2020 # 2020 # et USB #Non testéAutres

Rejets

Distributions Linux

RPM packaging instructions(pour les distributions comme Fedora)

Matériel tiers

EmuELEC (à partir deversion 3.3)
Lien vapeur (commençant parbuild 747)

N'hésitez pas à paqueter xow pour toute distribution Linux ou matériel que vous aimez. Toute question concernant l'emballage doit être signalée aux responsables respectifs.

Installation

Préalables

Linux (kernel 4.5 ou plus récent)
curl (pour téléchargement propriétaire du pilote)
cabextract (pour extraction de micrologiciels)
libusb (libusb-1.0-0-dev pour Debian)
systèmed (version 232 ou plus récente)

Guide

Cloner le dépôt & #160;:

git clone https://github.com/medusalix/xow

Construire et installer xow :

cd xow
make BUILD=RELEASE
sudo make install

NOTA:Veuillez utiliserBUILD=DEBUGquand vous avez demandé vos registres de débogage.

Téléchargez le firmware pour le dongle sans fil :

sudo xow-get-firmware.sh

NOTA:Les--skip-disclaimerdrapeau peut être utile pour les scripts.

Activer et démarrer lasystemdservice (exécute xow au démarrage):

sudo systemctl enable xow
sudo systemctl start xow

NOTA:Exécuter manuellement xow estfortement découragé. Un redémarrage peut être nécessaire pour que xow fonctionne correctement.

Mise à jour

Assurez-vous de désinstaller complètement xow avant de mettre à jour:

sudo systemctl stop xow
sudo systemctl disable xow
sudo make uninstall

Interopérabilité

Vous pouvez activer le mode d'appariement du dongle en envoyant leSIGUSR1signal vers xow:

sudo systemctl kill -s SIGUSR1 xow

NOTA:Les signaux ne sont traités queaprèsun dongle a été branché. Le comportement par défaut pourSIGUSR1est de mettre fin au processus.

Dépannage

Messages d'erreur

InputException: Aucun fichier ou répertoire de ce genre
- Les/dev/uinputl'appareil doit être disponible. Lesuinputmodule noyau doit être chargé.
InputException: Autorisation refusée
- Les autorisations pour/dev/uinputdoivent permettre l'accès en lecture et en écriture. Lesudevles règles doivent être installées et tout conflit avec les règles existantes doit être résolu.
Mt76Exception: Impossible de charger le firmware
- Un autre pilote a peut-être déjà chargé le firmware du dongle. Le dongle doit être débranché pour réinitialiser sa mémoire interne, suivi d'un redémarrage de xowsystemdservice.
LIBUSB_ERROR_TIMEOUT
- VoirUSB incompatibilitieschapitre.
LIBUSB_ERROR_BUSYouLIBUSB_ERROR_NO_DEVICE
- Seul un seul programme peut communiquer avec le dongle à la fois. Tout conducteur existant qui pourrait interférer avec xow doit être désactivé. Cela inclut l'exécution de plusieurs instances de xow.
LIBUSB_ERROR_ACCESS
- Les permissions pour le périphérique USB du dongle doivent être configurées correctement. C'est aussi le cas de laudevrègles.

Utilisation d'une version obsolète delibusbpeut causer divers problèmes. Assurez-vous de mettre à jourlibusbà la dernière version.

Problèmes d'appariement

Le contrôleur se souvient seulement dudernierappareil auquel il était connecté. Il n'établira pas automatiquement une connexion au dongle s'il était précédemment branché sur un port USB ou jumelé via bluetooth, même si le même ordinateur a été utilisé.

Problèmes de configuration

Certains jeux ne détectent pas les contrôleurs sans fil
- Activermode de compatibilitédans la configuration de service, recharger lesystemddémon et redémarrez le service. Les contrôleurs connectés au dongle apparaîtront en tant que contrôleurs Xbox 360.
Les boutons, les déclencheurs et les bâtons sont mal cartographiés
- Essayez les options énumérées surthis pagepour recarter vos entrées.
L'entrée des bâtons saute autour
- Essayez les options énumérées surthis pagepour régler vos zones mortes.

Incompatibilités USB

Certains contrôleurs USB sont connus pour causer des problèmes avec xow. Branchez votre dongle dans un port USB qui utilise unASMediale contrôleur entraînera des problèmes. La plupartIntelLes contrôleurs USB fonctionnent bien avec xow. Des problèmes de gestion de l'alimentation peuvent survenir lors de l'utilisation d'un contrôleur USB 3. Celles-ci peuvent conduire à des délais de communication USB. L'utilisation d'un hub USB peut atténuer ces problèmes.

Autres problèmes

En cas d'autres problèmes, veuillez ouvrir un problème avec tous les détails pertinents (version Dongle, version controller, journaux, captures, etc.).

NOTA:S'il vous plaît ne pas créer de problèmes concernant le remappage d'entrées, les zones mortes ou la compatibilité des jeux, car ces sujets sont hors du champ de ce projet.

Comment ça marche

La puce sans fil du dongle (MT76xx) gère la connexion WLAN avec des contrôleurs individuels. Le format du paquet suit la spécification GIP (Game Input Protocol) de Microsoft. La plupart de l'ingénierie inverse a été faite en saisissant la communication entre le dongle et un PC Windows en utilisantWireshark. Comme aucune fiche de données pour cette puce n'est accessible au public, j'ai utilisé des fiches de données de radios sans fil similaires pour m'aider. Remerciements spéciaux aux auteurs de OpenWrtmt76pilote de noyau. Il aurait été impossible pour moi de créer ce pilote sansmt76Code source. Si quelqu'un a une meilleure compréhension du GIP ou des bizarreries que j'ai dû ajouter pour faire fonctionner le conducteur, s'il vous plaît contactez-moi.

Licence

xow est libéré sous laGNU General Public License, Version 2.

Copyright (C) 2019 Medusalix

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.