qmk/qmk_firmware

[Bug] EXTRAKEY_ENABLE build flag is breaking steaminput on linux

Fermée

#25 277 ouverte le 19 mai 2025

Voir sur GitHubGuide contributeur
 (0 commentaire) (0 réaction) (0 personne assignée)C (43 867 forks)batch import
bughelp wanted

Métriques du dépôt

Stars
 (20 368 étoiles)
Métriques de merge PR
 (Merge moyen 20j 9h) (27 PRs mergées en 30 j)

Description

Describe the Bug

If you build qmk with EXTRAKEY_ENABLE which is default your keyboard will report that is supporting every HID available which will break steaminput. https://github.com/qmk/qmk_firmware/blob/02517bd8069ea6d22a3b10945611b0170f7ef7d4/tmk_core/protocol/usb_descriptor.c#L344-L347

Steam and KDE system settings will also detect your keyboard as joystick / gamepad.

For example my dualshock 4 controller will stop working in Dark souls 2 if I connect QMK keyboard. For now I have moved back to stock firmware which doesn't have this issue.

Keyboard Used

gmmk/gmmk2/p96/iso:default

Link to product page (if applicable)

No response

Operating System

Linux, Opensuse Tumbleweed

qmk doctor Output

Is AutoHotKey / Karabiner installed

  • AutoHotKey (Windows)
  • Karabiner (macOS)

Other keyboard-related software installed

No response

Additional Context

Steam related bug https://github.com/ValveSoftware/steam-for-linux/issues/3384

And more context what is probably happening. This patch was for microsoft keyboard https://github.com/torvalds/linux/commit/1989dada7ce07848196991c9ebf25ff9c5f14d4e

Guide contributeur

Direction de recherche
Examinez la génération du descripteur USB dans tmk core/protocol/usb descriptor.c autour de la ligne 344, où EXTRAKEY ENABLE entraîne que le clavier signale tous les usages HID. Consultez le rapport de bug de Valve Software Steam (issue #3384) et le commit du noyau Linux qui a ajouté une solution similaire pour les claviers Microsoft. Envisagez d'implémenter un descripteur conditionnel ou un drapeau de compilation pour restreindre les usages HID signalés lorsque EXTRAKEY ENABLE est activé.
Stack technique
cshell
Domaine
backend
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Une demi journée
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Plutôt claire
Prérequis
C programmingUSB HID descriptorsQMK firmware build system
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
35