xone

xone est un pilote de noyau Linux pour les accessoires Xbox One et Xbox Series X.S. Il sert de remplacement moderne pour xpad, visant à être compatible avec le...

Dépôt créer le : 01/07/2021

Release du : 25/02/2026 v0.3 – xone 0.3

Forks: 189 Watcher: 0 2405

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

Ajouter à une sélection :

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

xone est un pilote de noyau Linux pour les accessoires Xbox One et Xbox Series X.S. Il sert de remplacement moderne pour xpad, visant à être compatible avec Microsoft Protocole d'entrée de jeu (GIP).

Compatibilité

[x] Appareils filaires (par USB)
[x] Appareils sans fil (avec dongle sans fil Xbox)
[ ] Appareils Bluetooth (vérifier xpadneo)

Installation xone désactivera la xpad pilote de noyau. Si vous utilisez encore des périphériques Xbox ou Xbox 360, vous devrez installer xpad-noone en remplacement de xpad.

[!IMPORTANT] Ce projet est en mode maintenance et ne recevra que des corrections mineures occasionnelles. Une fourche développée activement est disponible Ici..

Caractéristiques

[x] Retour d'entrée et de force (runble)
[x] Déclaration des batteries (UPower intégration)
[x] contrôle LED (en utilisant /sys/class/leds)
[x] Capture/diffusion audio (par ALSA)
[x] Gestion de l'énergie (suppendance/résume et réveil à distance/sans fil)

Appareils pris en charge

[x] Jeux
- [x] Contrôleurs Xbox One
- [x] Régulateurs Xbox Series X.S
- [x] Contrôleur adaptateur Xbox
- [x] Contrôleurs tiers (PowerA, PDP, etc.)
[x] Casques
- [x] Casque Xbox One Chat
- [x] Casque stéréo Xbox One (adaptateur ou jack)
- [x] Casque Xbox sans fil
- [x] Casques sans fil tiers (SteelSeries, Razer, etc.)
[x] Guitares et tambours
- [x] Mad Catz Rock Band 4 Fender Stratocaster sans fil
- [x] Kit de tambour sans fil Mad Catz Rock Band 4
- [x] PDP Rock Band 4 Fender sans fil Jaguar
[x] Chatpad Xbox One
[ ] Roues de course tiers (Thrustmaster, Logitech, etc.)

Rejets

N'hésitez pas à faire un colis xone pour toute distribution Linux ou matériel que vous souhaitez. Toute question concernant l'emballage doit être signalée aux responsables respectifs.

Installation

Préalables

Linux (kernel 5.13+ et en-têtes)
DKMS
boucle (pour le téléchargement du firmware)
cabextract (pour extraction de micrologiciels)

Guide

Débranchez vos appareils Xbox.
Cloner le dépôt & #160;:

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

Installer xone:

cd xone
sudo ./install.sh

NOTA: Vous pouvez utiliser le --release drapeau pour désactiver l'enregistrement de débogage.

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

sudo xone-get-firmware.sh

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

Branchez vos appareils Xbox.

Mise à jour

Assurez-vous de désinstaller complètement xone avant mise à jour:

sudo ./uninstall.sh

Jumelage sans fil

Les appareils Xbox doivent être jumelés au dongle sans fil. Ils ne se connecteront pas automatiquement au dongle s'ils ont déjà été branchés dans un port USB ou utilisés via Bluetooth.

Des instructions pour l'appariement de vos appareils peuvent être trouvées Ici. (voir la section sur Xbox sans fil).

Contrôle LED

Le bouton guide LED peut être contrôlé via sysfs:

echo 2 | sudo tee /sys/class/leds/gip*/mode
echo 5 | sudo tee /sys/class/leds/gip*/brightness

Changer la LED de la manière ci-dessus est temporaire, il ne durera que jusqu'à ce que l'appareil se déconnecte. Pour appliquer ces paramètres automatiquement quand un périphérique se connecte, vous pouvez créer un nouveau udev règle en /etc/udev/rules.d/50-xone.rules avec le contenu suivant:

ACTION=="add", SUBSYSTEM=="leds", KERNEL=="gip*", ATTR{mode}="2", ATTR{brightness}="5"

Remplacer le wildcard (gip*) si vous voulez contrôler la LED d'un appareil spécifique. Les modes et la luminosité maximale peuvent varier d'un appareil à l'autre.

Dépannage

Désinstaller la version de publication et installer une compilation de débogage de xone (voir le guide d'installation). Exécuter sudo dmesg pour recueillir des journaux et vérifier les messages d'erreur concernant xone. Si xone n'est pas chargé automatiquement vous pourriez avoir à redémarrer votre système.

Messages d'erreur

Direct firmware load for xow_dongle.bin failed with error -2
- Téléchargez le firmware pour le dongle sans fil (voir le guide d'installation).

Questions relatives aux intrants

Vous pouvez utiliser evtest et fftest vérifier la fonctionnalité d'entrée et de retour de vos appareils.

Autres problèmes

S'il vous plaît rejoindre le Serveur discordant en cas d'autres problèmes.

Licence

xone est libéré sous Licence publique générale GNU, version 2.

Copyright (C) 2021 Severin von Wnuck-Lipinski

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.