fix(linux): route Xbox Series gamepad through uinput#54
Draft
ReenigneArcher wants to merge 15 commits into
Draft
fix(linux): route Xbox Series gamepad through uinput#54ReenigneArcher wants to merge 15 commits into
ReenigneArcher wants to merge 15 commits into
Conversation
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@
## master #54 +/- ##
==========================================
+ Coverage 74.88% 75.90% +1.01%
==========================================
Files 19 24 +5
Lines 5890 7260 +1370
Branches 2246 2730 +484
==========================================
+ Hits 4411 5511 +1100
- Misses 1279 1484 +205
- Partials 200 265 +65
Flags with carried forward coverage won't be shown. Click here to find out more.
... and 2 files with indirect coverage changes Continue to review full report in Codecov by Harness.
|
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 14, 2026 23:03
b799c70 to
cb4c5f9
Compare
ReenigneArcher
changed the title
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
2 times, most recently
from
July 14, 2026 23:44
61eb72a to
01dec7e
Compare
Adds a dedicated Linux uinput Xbox Series backend that emits canonical evdev button/axis events and translates force-feedback effects back into normalized rumble callbacks, while keeping other gamepads on UHID. The backend gamepad submit interface now accepts both normalized state and packed report so native backends can consume state directly. It also updates gamepad descriptors/report packing (including misc1 button handling and hat-based dpad bits), sets Switch Pro UHID bus to virtual, refreshes platform/usage docs, and expands Linux adapter/backend/consumer tests accordingly.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 15, 2026 02:07
01dec7e to
b44a75e
Compare
Match the active evdev capabilities exposed by the USB xpad driver instead of the full 15-slot HID layout. Remove unused BTN_C, BTN_Z, BTN_TL2, and BTN_TR2 capabilities that shifted Guide, L3, and R3 indices. Set firmware version to 0x050D for a known SDL/Steam USB mapping. Add Guide button to consumer test coverage.
Update the Linux uinput backend to advertise Xbox Series controllers as Bluetooth with product ID 0x0B13, while keeping the public profile identity unchanged. The evdev key capabilities now include the full 15-slot HID button range (including reserved C/Z/TL2/TR2 slots) so SDL/Steam button indices stay stable and Guide/L3/R3 map correctly. Unit and consumer tests were updated accordingly, and platform support docs now describe the identity split and reserved-slot behavior.
Generalizes the Linux uinput gamepad backend from Xbox Series-only to support Generic, Xbox 360, Xbox One, and Xbox Series profiles. Extracts `uses_uinput_gamepad_profile()` predicate, renames `UinputXboxGamepad` to `UinputGamepad`, makes rumble and misc1 (Share) button conditional on profile capabilities, and updates tests and docs accordingly.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
3 times, most recently
from
July 16, 2026 20:51
26e03dd to
5e41124
Compare
Enable generic and Xbox 360 gamepad profiles to emit BTN_DPAD_* events alongside their hat axes, allowing consumers that prefer digital D-pad buttons to receive them directly. Also correct Xbox One and Xbox Series to use their Bluetooth product IDs (0x0B20 and 0x0B13) for their Linux uinput devices, matching the standard consumer mappings those identities carry. Update documentation and tests to verify D-pad button capabilities and events across profiles.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 17, 2026 01:51
5e41124 to
af8d805
Compare
Update the Linux uinput backend so Xbox 360 profiles use the sparse Linux gamepad button slots like the other uinput gamepads, while limiting BTN_DPAD_* emission to the generic profile. The tests and platform support docs were updated to reflect the new capability layout and D-pad behavior.
Use the Bluetooth bus for the sparse Xbox uinput evdev mapping across Xbox 360, One, and Series profiles, and rename the bus constant to reflect the broader scope.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 17, 2026 03:23
87a1526 to
c5fadf4
Compare
ReenigneArcher
marked this pull request as draft
July 17, 2026 03:58
Split Linux uhid/uinput gamepad setup and submit logic into focused helper functions for event types, buttons, axes, and force-feedback while preserving behavior. This improves readability and reduces duplication in button emission paths. Unit tests were updated to reuse a shared pressed-key extraction helper, and consumer profile setup now explicitly checks optional product IDs with `has_value()` for clarity.
Moves Linux Switch Pro gamepads from descriptor-driven UHID behavior to a uinput-native mapping, including Nintendo face-button positions, button-based ZL/ZR triggers, BTN_Z for Capture, and hat-only D-pad reporting. The Linux backend now treats Generic/Xbox/Switch Pro as uinput gamepads with normalized FF rumble callbacks, while DualShock 4 and DualSense stay on UHID. Also enables rumble capability for Generic and Switch Pro profiles, updates output parsing so Switch Pro reports remain raw instead of being misread as generic rumble packets, and improves UHID output handling by honoring SET_REPORT report numbers and control-path output frames. Tests and docs were updated to match the new profile capabilities and Linux platform behavior.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 17, 2026 21:29
ca031eb to
0b0f6df
Compare
Update built-in profiles to use clearer default device names and document those names in the usage guide. On Linux, adjust uinput gamepad behavior so the generic profile uses BTN_DPAD_* instead of hat axes, expand supported force-feedback effect normalization beyond FF_RUMBLE, and stop re-inserting UHID report numbers into output reports. Tests were extended to cover the new profile names, D-pad capabilities, Switch Pro SDL behavior, and additional rumble effect types.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 18, 2026 12:51
ef6afa8 to
fbfa4df
Compare
Move the generic gamepad's D-pad into the platform-neutral button bitmap and expose all Linux uinput gamepads through ABS_HAT0X/ABS_HAT0Y for a single evdev mapping. On the Linux UHID path, normalize SET_REPORT payloads, discover hidraw nodes by UHID metadata, and add a short startup delay before reading feedback so PlayStation and early rumble output stay reliable. Docs and tests were updated to match the new report layout and backend behavior.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 18, 2026 14:29
fbfa4df to
3246918
Compare
Reworks gamepad output handling to use native PID-style rumble for Generic/Xbox profiles, decodes Switch Pro native rumble reports, and limits legacy 5-byte rumble parsing to Xbox 360. On Windows, UMDF output reads/events are now tracked per file handle so output callbacks are delivered to the runtime that created each device. On Linux, Generic uinput devices now use an Xbox-compatible VID/PID mapping for better Steam/browser behavior while keeping the public profile identity unchanged. Also updates CI udev rules, platform docs, and broad test coverage (including new Windows consumer integration tests) to validate descriptor changes, button packing, output normalization, and backend routing behavior.
Introduces major gamepad protocol upgrades across backends: Windows now maps the Generic profile to a DirectInput PID joystick (descriptor rewrite, feature/output handling, timed rumble scheduling), adds shared driver helpers, and implements native PlayStation feature-report responses plus Switch Pro handshake/reply behavior. Linux backend now reuses shared PlayStation feature payloads, keeps Generic VID/PID on uinput while exposing both hat and BTN_DPAD events, and fixes force-feedback lifetime handling for infinite and reuploaded effects. CI/docs/tests were expanded to cover the new behavior, including hid_playstation module requirements and new Windows driver protocol and consumer integration coverage.
ReenigneArcher
force-pushed
the
fix/linux/gamepad-mappings
branch
from
July 19, 2026 04:07
5a46bbd to
7bde9bd
Compare
Switch Xbox Series Windows transport from XInputHID (0x0B12/&IG_00) to the native Bluetooth HID identity (0x0B13) with a 17-byte input packet, exposing the Share button to SDL/Steam without binding the legacy 15-button XInput surface. Expand the Generic PID report descriptor to the complete DirectInput output-report set required for enumeration; Constant and Sine are still the only effects normalized as rumble. Bump the Windows control-protocol version to 2 and double the max descriptor capacity to 2048 bytes so a stale driver fails explicitly on version mismatch. Extend Xbox Series rumble parsing to accept report-ID-3 packets from the Bluetooth HID path. Move the Linux Generic profile onto the sparse uinput button-slot sequence and drop BTN_DPAD_* capabilities so D-pad directions are published only through hat axes. Fix Switch Pro stick Y-axis sign inversion. Downgrade the hid_playstation CI load failure to a warning; replace per-test output-wait boilerplate with a GamepadOutputCapture helper.
Stops rewriting Xbox Series reports/descriptors to the Bluetooth HID format and keeps the profile’s native transport data in Windows create requests and report submission. The Windows driver now advertises a Series-specific XInputHID-compatible match ID (`VID_045E&PID_0B13&IG_00`) while preserving the public `VID_045E&PID_0B12` identity. Updates docs, validation scripts, and unit/consumer tests to reflect the new identity behavior. Also enables `BTN_DPAD_*` events for the Linux Generic profile alongside hat axes, and adjusts CI/test expectations when `hid_playstation` is unavailable.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds a dedicated Linux uinput Xbox Series backend that emits canonical evdev button/axis events and translates force-feedback effects back into normalized rumble callbacks, while keeping other gamepads on UHID. The backend gamepad submit interface now accepts both normalized state and packed report so native backends can consume state directly. It also updates gamepad descriptors/report packing (including misc1 button handling and hat-based dpad bits), sets Switch Pro UHID bus to virtual, refreshes platform/usage docs, and expands Linux adapter/backend/consumer tests accordingly.
Screenshot
Issues Fixed or Closed
Roadmap Issues
Type of Change
Checklist
AI Usage
See our AI usage policy.