DOCS: Update documentation to reflect support for PS5 controller on Linux

[SteveDiniro]

Description

Updated the documentation to reflect support for PS5 controller on Linux:

• updated SupportedDevice.md
• added entry to CHANGELOG.md

This PR addresses https://jira.unity3d.com/browse/DOCR-6100

Testing status & QA

I used PMDT's Generate Documentation to verify what the output will look like, by viewing it on localHost

Overall Product Risks

• Complexity: low (docs only)
• Halo Effect: low (docs only)

Comments to reviewers

Please review for technical accuracy.

Checklist

Before review:

• Changelog entry added.
  • Explains the change in Changed, Fixed, Added sections.
  • For API change contains an example snippet and/or migration example.
  • JIRA ticket linked, example (case %%). If it is a private issue, just add the case ID without a link.
  • Jira port for the next release set as "Resolved".
• Tests added/changed, if applicable.
  • Functional tests Area_CanDoX, Area_CanDoX_EvenIfYIsTheCase, Area_WhenIDoX_AndYHappens_ThisIsTheResult.
  • Performance tests.
  • Integration tests.
• Docs for new/changed API's.
  • Xmldoc cross references are set correctly.
  • Added explanation how the API works.
  • Usage code examples added.
  • The manual is updated, if needed.

During merge:

• Commit message for squash-merge is prefixed with one of the list:
  • NEW: ___.
  • FIX: ___.
  • DOCS: ___.
  • CHANGE: ___.
  • RELEASE: 1.1.0-preview.3.

[cla-assistant-unity]

All committers have signed the CLA.

[u-pr]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

🎫 Ticket compliance analysis ✅ DOCR-6100 - Fully compliant Compliant requirements: Update Input docs (SupportedDevices.md) to reflect Linux HIDAPI support. Specifically address PS5 controller support on Linux as per the provided specification.

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪ The PR contains straightforward documentation updates with clear instructions and table changes that are easy to verify.

🏅 Score: 98 The PR is well-structured, compliant with the ticket, and improves documentation quality; a minor verification of the referenced Unity Editor version is recommended.

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Verify Version Format The text mentions 'Unity Editor 6000.4'. Standard Unity 6 versioning is typically '6000.0.x' (e.g., 6000.0.4). Please verify if '6000.4' is the correct intended version string or a typo. > 11. PS5 DualSense is supported on Windows, macOS, and Linux via USB HID. Linux support begins with Unity Editor 6000.4 (refer to [PS5 controller support on Linux](#ps5-controller-support-on-linux)). On all platforms, setting motor rumble and light bar color when connected over Bluetooth is currently not supported.

Update review

---

🤖 Helpful? Please react with 👍/👎 | Questions❓Please reach out in Slack #ask-u-pr-agent

[u-pr]

PR Code Suggestions ✨

Latest suggestions up to 9b2595e

Category	Suggestion	Impact
General	Scope udevadm trigger to hidraw devices Running udevadm trigger without arguments re-evaluates rules for all system devices, which can be slow and cause unintended side effects (e.g., network device reset). Scope the trigger to the hidraw subsystem to only apply the new rules to the relevant devices. Packages/com.unity.inputsystem/Documentation~/SupportedDevices.md [100-101] sudo udevadm control --reload-rules -sudo udevadm trigger +sudo udevadm trigger --subsystem-match=hidraw Suggestion importance[1-10]: 8 __ Why: Running udevadm trigger without arguments triggers events for all devices, which can be slow and disruptive to other hardware. Restricting it to the hidraw subsystem is safer and cleaner for user instructions.	Medium
	Use force flag for group creation The groupadd command will fail with an error if the gamepad group already exists (e.g., if the user previously ran these instructions). Use the -f (force) flag to exit successfully if the group is already present, making the instructions more robust. Packages/com.unity.inputsystem/Documentation~/SupportedDevices.md [94-95] -sudo groupadd gamepad +sudo groupadd -f gamepad sudo usermod -aG gamepad $USER Suggestion importance[1-10]: 7 __ Why: Using groupadd -f allows the command to exit successfully if the gamepad group already exists. This makes the setup instructions more robust for users who may have already configured this group.	Medium
More suggestions

---

🤖 Helpful? Please react with 👍/👎 | Questions❓Please reach out in Slack #ask-u-pr-agent

---

Previous suggestions

Suggestions up to commit 9b2595e

Category	Suggestion	Impact
General	Simplify udev rules using TAG+="uaccess" Consider using TAG+="uaccess" in the udev rules instead of creating a specific group. This modern approach (standard on systemd-based distributions) automatically grants access to the currently logged-in user, eliminating the need for manual group management (groupadd) and the requirement to log out and back in. Packages/com.unity.inputsystem/Documentation~/SupportedDevices.md [76-104] If your PS5 controller isn't detected through the HID subsystem, follow these steps to grant the necessary permissions: 1. Open the terminal and create the following `udev` rule file: ``` sudo nano /etc/udev/rules.d/70-sony-controllers.rules ``` 2. Add the following lines to the file. Save the file, then exit the editor. ``` # PS5 DualSense Edge - KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0df2", GROUP="gamepad", MODE="0660" + KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0df2", MODE="0660", TAG+="uaccess" # PS5 DualSense - KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0ce6", GROUP="gamepad", MODE="0660" + KERNEL=="hidraw*", SUBSYSTEM=="hidraw", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0ce6", MODE="0660", TAG+="uaccess" ``` -3. Grant the current user access to PS5 gamepads: - ``` - sudo groupadd gamepad - sudo usermod -aG gamepad $USER - ``` - -4. Apply the new `udev` rules: +3. Apply the new `udev` rules: ``` sudo udevadm control --reload-rules sudo udevadm trigger ``` -5. Log out from the current session and log back in. This step is required for the session to recognize the updated group membership. - Suggestion importance[1-10]: 8 __ Why: The suggestion proposes using the modern TAG+="uaccess" mechanism for managing device permissions on Linux. This simplifies the documentation and user experience by removing the steps for manual group creation and requiring a session logout/login.	Medium

[codecov-fd.fxlcf.dpdns.org]

Codecov Report

All modified and coverable lines are covered by tests ✅

@@           Coverage Diff            @@
##           develop    #2300   +/-   ##
========================================
  Coverage    77.95%   77.95%           
========================================
  Files          477      476    -1     
  Lines        97419    97405   -14     
========================================
- Hits         75943    75934    -9     
+ Misses       21476    21471    -5     

Flag	Coverage Δ
inputsystem_MacOS_2022.3	5.54% <ø> (-0.01%)	⬇️
inputsystem_MacOS_2022.3_project	75.49% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.0	5.32% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.0_project	77.37% <ø> (-0.05%)	⬇️
inputsystem_MacOS_6000.2	5.32% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.2_project	77.36% <ø> (-0.06%)	⬇️
inputsystem_MacOS_6000.3	5.32% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.3_project	77.36% <ø> (-0.06%)	⬇️
inputsystem_MacOS_6000.4	5.33% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.4_project	77.37% <ø> (+<0.01%)	⬆️
inputsystem_MacOS_6000.5	5.33% <ø> (-0.01%)	⬇️
inputsystem_MacOS_6000.5_project	77.37% <ø> (-0.05%)	⬇️
inputsystem_Ubuntu_2022.3	5.54% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_2022.3_project	75.29% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.0	5.32% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.0_project	77.16% <ø> (-0.06%)	⬇️
inputsystem_Ubuntu_6000.2	5.32% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.2_project	77.16% <ø> (-0.06%)	⬇️
inputsystem_Ubuntu_6000.3	5.32% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.3_project	77.16% <ø> (-0.06%)	⬇️
inputsystem_Ubuntu_6000.4	5.33% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.4_project	77.17% <ø> (-0.06%)	⬇️
inputsystem_Ubuntu_6000.5	5.33% <ø> (-0.01%)	⬇️
inputsystem_Ubuntu_6000.5_project	77.17% <ø> (-0.06%)	⬇️
inputsystem_Windows_2022.3	5.54% <ø> (-0.01%)	⬇️
inputsystem_Windows_2022.3_project	75.62% <ø> (+<0.01%)	⬆️
inputsystem_Windows_6000.0	5.32% <ø> (-0.01%)	⬇️
inputsystem_Windows_6000.0_project	77.49% <ø> (-0.05%)	⬇️
inputsystem_Windows_6000.2	5.32% <ø> (-0.01%)	⬇️
inputsystem_Windows_6000.2_project	77.48% <ø> (-0.06%)	⬇️
inputsystem_Windows_6000.3	5.32% <ø> (-0.01%)	⬇️
inputsystem_Windows_6000.3_project	77.48% <ø> (-0.06%)	⬇️
inputsystem_Windows_6000.4	5.33% <ø> (-0.01%)	⬇️
inputsystem_Windows_6000.4_project	77.49% <ø> (-0.05%)	⬇️
inputsystem_Windows_6000.5	5.33% <ø> (-0.01%)	⬇️
inputsystem_Windows_6000.5_project	77.49% <ø> (-0.05%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

see 6 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[kalana-sahabandu]

LGTM ! Thank you so much for updating the docs for Linux Platform

[SteveDiniro]

NOTE: this step would get removed if I apply the suggestion mentioned on L86 & L89

[kalana-sahabandu]

same here as well. Let's leave as is

[SteveDiniro]

will leave as-is and mark as "Resolved"