qmk/qmk_firmware

[Bug] EXTRAKEY_ENABLE build flag is breaking steaminput on linux

Chiusa

#25.277 aperta il 19 mag 2025

Vedi su GitHubGuida contributor
 (0 commenti) (0 reazioni) (0 assegnatari)C (43.867 fork)batch import
bughelp wanted

Metriche repository

Star
 (20.368 stelle)
Metriche merge PR
 (Merge medio 20g 9h) (27 PR mergiate in 30 g)

Descrizione

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

Guida contributor

Direzione di ricerca
Indaga sulla generazione del descrittore USB in tmk core/protocol/usb descriptor.c intorno alla riga 344, dove EXTRAKEY ENABLE fa sì che la tastiera segnali tutti gli usi HID. Rivedi il report di bug di Valve Software Steam (issue #3384) e il commit del kernel Linux che ha aggiunto una soluzione simile per le tastiere Microsoft. Considera l'implementazione di un descrittore condizionale o di un flag di compilazione per limitare gli usi HID segnalati quando EXTRAKEY ENABLE è impostato.
Tech stack
cshell
Dominio
backend
Tipo issue
Bug
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
3
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
Mezza giornata
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Nuova
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Abbastanza chiara
Prerequisiti
C programmingUSB HID descriptorsQMK firmware build system
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
35