fix(linux): route Xbox Series gamepad through uinput

[ReenigneArcher]

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

• feat: New feature (non-breaking change which adds functionality)
• fix: Bug fix (non-breaking change which fixes an issue)
• docs: Documentation only changes
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semicolons, etc.)
• refactor: Code change that neither fixes a bug nor adds a feature
• perf: Code change that improves performance
• test: Adding missing tests or correcting existing tests
• build: Changes that affect the build system or external dependencies
• ci: Changes to CI configuration files and scripts
• chore: Other changes that don't modify src or test files
• revert: Reverts a previous commit
• BREAKING CHANGE: Introduces a breaking change (can be combined with any type above)

Checklist

• Code follows the style guidelines of this project
• Code has been self-reviewed
• Code has been commented, particularly in hard-to-understand areas
• Code docstring/documentation-blocks for new or existing methods/components have been added or updated
• Unit tests have been added or updated for any new or modified functionality

AI Usage

See our AI usage policy.

• None: No AI tools were used in creating this PR
• Light: AI provided minor assistance (formatting, simple suggestions)
• Moderate: AI helped with code generation or debugging specific parts
• Heavy: AI generated most or all of the code changes

[codecov]

❌ 3 Tests Failed:

Tests completed	Failed	Passed	Skipped
102	3	99	2

View the top 3 failed test(s) by shortest run time

VirtualHidControlModelTest::SummarizesOutputState

Stack Traces | 0s run time

.../tests/unit/test_virtualhid_control_model.cpp:174
Expected equality of these values:
  control::output_summary(state, generic)
    Which is: L"Output: no reports received"
  L"Output: no reports received | profile has no normalized feedback categories"

VirtualHidControlModelTest::SummarizesProfileFeatures

Stack Traces | 0s run time

.../tests/unit/test_virtualhid_control_model.cpp:136
Expected equality of these values:
  control::profile_feature_summary(generic)
    Which is: L"Features: battery no | rumble yes | trigger rumble no | RGB LED no | adaptive triggers no | raw output yes"
  L"Features: battery no | rumble no | trigger rumble no | RGB LED no | adaptive triggers no | raw output no"

LinuxConsumerTest::SdlSeesGenericCanonicalButtons

Stack Traces | 0.244s run time

.../tests/unit/test_linux_consumers.cpp:372
Expected: (SDL_JoystickNumButtons(joystick)) >= (minimum_buttons), actual: 16 vs 20

To view more test analytics, go to the Test Analytics Dashboard
_{📋 Got 3 mins? Take this short survey to help us improve Test Analytics.}

[sonarqubecloud]

Quality Gate failed

Failed conditions
2 New issues
2 New Code Smells (required ≤ 0)

See analysis details on SonarQube Cloud

💡 Need a hand with PR review? Try Gitar by Sonar!