Configurer et calibrer une manette de jeu sous Linux

Pourquoi remplacer xpad

Le noyau Linux fournit le module xpad qui fonctionne bien pour de nombreux contrôleurs. Toutefois, certains modèles présentent des comportements erratiques (LEDs qui clignotent, axes mal détectés) ou manquent d’options de configuration. Les pilotes utilisateurs comme xboxdrv offrent plus de flexibilité : mappages avancés, émulation de touches, gestion fine des deadzones et des saturations.

Important : si votre manette fonctionne correctement avec xpad, vous n’avez pas besoin de le remplacer. Remplacez le pilote seulement si vous rencontrez des bugs ou des besoins de configuration que xpad ne couvre pas.

Pré-requis rapides

• Distribution Linux avec gestionnaire de paquets APT (Ubuntu, Debian ou dérivés). Les commandes indiquées sont pour APT.
• Accès administrateur (sudo).
• Manette USB ou sans fil avec récepteur compatible.

Étape 1 — Installer xboxdrv

Ouvrez un terminal et installez le paquet :

sudo apt-get update
sudo apt-get install xboxdrv

Pour obtenir la version la plus récente (support étendu d’autres manettes), téléchargez-la depuis le site officiel de xboxdrv ou compilez depuis les sources si nécessaire.

Démarrer xboxdrv et désactiver xpad

Vous devez empêcher xpad d’être chargé en même temps que xboxdrv. Deux approches :

• Démarrer xboxdrv en détachant le pilote du noyau :

sudo xboxdrv --detach-kernel-driver

• Ou démonter le module xpad puis lancer xboxdrv :

sudo rmmod xpad
sudo xboxdrv

Si vous ne voulez pas voir le flux de messages (appuis et positions d’axes) dans le terminal :

sudo xboxdrv --silent

Image d’illustration :

Image d’illustration :

Note : si xboxdrv se lance sans erreur, le terminal affichera les événements liés aux boutons et aux axes.

Alternative : ubuntu-xboxdrv

Si xboxdrv ne gère pas correctement votre appareil, essayez la variante ubuntu-xboxdrv (ppa non officiel). Ajoutez le dépôt à vos risques :

sudo apt-add-repository -y ppa:rael-gc/ubuntu-xboxdrv
sudo apt-get update
sudo apt-get install ubuntu-xboxdrv

Étape 2 — Rendre la modification persistante (blacklist xpad)

Pour empêcher xpad d’être chargé au démarrage :

echo "blacklist xpad" | sudo tee /etc/modprobe.d/blacklist-xpad.conf

Cela évite les conflits après un redémarrage. Pour revenir en arrière : supprimez le fichier ou commentez la ligne.

Option avancée — Lancer xboxdrv au démarrage (systemd)

Créez un fichier d’unité systemd si vous souhaitez que xboxdrv tourne en permanence (utile pour mapping clavier en arrière-plan) :

sudo tee /etc/systemd/system/xboxdrv.service > /dev/null <<'UNIT'
[Unit]
Description=xboxdrv daemon
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/xboxdrv --daemon --silent --detach-kernel-driver
Restart=on-failure

[Install]
WantedBy=multi-user.target
UNIT

sudo systemctl daemon-reload
sudo systemctl enable --now xboxdrv.service

Important : adaptez les options ExecStart selon vos besoins (profil de mapping, options d’émulation).

Étape 3 — Calibration avec jstest-gtk

Installez l’outil graphique de test et calibration :

sudo apt-get install jstest-gtk

Lancez jstest-gtk depuis le menu ou le terminal :

jstest-gtk

Ouvrez votre périphérique, puis cliquez sur le bouton “Properties” (Propriétés). La fenêtre affiche les axes et boutons en temps réel, utile pour détecter des offsets ou axes inversés.

Image d’illustration :

Pour calibrer : dans la même fenêtre, cliquez sur “Calibration” puis sur “Start Calibration” et suivez les instructions (déplacez les sticks, appuyez sur les boutons demandés). Une calibration correcte réduit le drift et aligne les plages d’axes.

Image d’illustration :

Mapping des boutons

Dans jstest-gtk, le bouton “Mapping” permet de réordonner ou renommer les boutons. Les changements s’appliquent au niveau du système et sont visibles par les jeux qui utilisent l’API joystick.

Étape 4 — Mapper la manette vers le clavier avec qjoypad

Si vous voulez que les actions d’une manette envoient des touches clavier ou mouvements de souris (utile pour jeux anciens ou applications non compatibles manettes) :

sudo apt-get install qjoypad

Lancez-le sans icône de tray si besoin :

qjoypad --notray

Image d’illustration :

Cliquez sur “Add” pour créer des profils et assignez des touches. Le bouton “Quick Set” vous guidera : il vous demandera d’appuyer sur une touche de la manette puis d’appuyer sur la touche clavier à associer.

Image d’illustration :

Lorsque qjoypad tourne en arrière-plan, ses profils sont accessibles depuis la zone de notification et vous pouvez basculer entre eux.

Image d’illustration :

Vérification et tests

• Lancez un jeu Steam natif ou utilisez jstest-gtk pour valider la détection des axes et boutons.
• Testez les mappings clavier dans une application simple (éditeur de texte) pour vérifier les affectations Qjoypad.

Dépannages courants

• Manette non détectée : vérifiez le câble/charge et essayez un port USB différent. Testez avec lsusb et dmesg | tail.
• Permissions : si vous voulez lancer xboxdrv sans sudo, ajoutez une règle udev pour js* :

# /etc/udev/rules.d/99-joystick.rules
KERNEL=="js[0-9]*", MODE="0666"

Puis :

sudo udevadm control --reload-rules
sudo udevadm trigger

• Conflits après reboot : vérifiez que xpad est bien blacklisted.
• LEDs qui clignotent / comportement étrange : essayez ubuntu-xboxdrv ou testez la manette sur une autre machine pour isoler le problème matériel.

Mini-méthodologie (pas à pas)

1. Vérifier la détection matérielle (lsusb, dmesg).
2. Tester avec xpad (pilote noyau) par défaut.
3. Si flottements ou bugs, installer xboxdrv et démarrer avec –detach-kernel-driver.
4. Calibrer avec jstest-gtk.
5. Mapper si besoin avec qjoypad.
6. Persister la configuration (blacklist + systemd + udev).

Checklist rapide selon votre rôle

• Joueur : tester sous Steam, calibrer axes, créer profil qjoypad pour jeux non natifs.
• Développeur de jeux : vérifier mapping avec jstest-gtk et rapporter les IDs d’événements.
• Administrateur système : blacklister xpad, créer unité systemd, ajouter règles udev.

Flowchart de décision

flowchart TD
  A[La manette fonctionne bien avec xpad ?] -->|Oui| B[Ne rien changer]
  A -->|Non| C[Installer xboxdrv]
  C --> D{xboxdrv résout-il le problème ?}
  D -->|Oui| E[Blacklister xpad et persister]
  D -->|Non| F[Essayer ubuntu-xboxdrv ou tester autre machine]
  F --> G[Si échec matériel: remplacer la manette]

Astuces et bonnes pratiques

• Sauvegardez vos profils qjoypad (*.qjp) dans un dossier de configuration pour les restaurer.
• Testez les sticks et gâchettes sur plusieurs jeux pour valider la calibration.
• N’utilisez les PPAs qu’après vérification : l’installation depuis source peut être plus sûre pour les mises à jour.

Glossaire rapide

• xpad : pilote noyau pour manettes Xbox.
• xboxdrv : pilote en espace utilisateur offrant de la flexibilité de mapping.
• jstest-gtk : utilitaire graphique de test et calibration des joysticks.
• qjoypad : outil de mappage manette -> clavier/souris.

Résumé

• Remplacez xpad uniquement si nécessaire. xboxdrv offre plus de contrôle et ubuntu-xboxdrv est une alternative.
• Calibrez toujours avec jstest-gtk lorsque vous constatez des déplacements ou des offsets.
• Utilisez qjoypad pour émuler des touches clavier et rendre compatibles d’anciens jeux.

Notes :

• Effectuez chaque changement progressivement et testez à chaque étape.
• Conservez une copie de vos fichiers de configuration pour restaurer l’état précédent si besoin.

Fin du guide.