1725
Comment:
|
4795
make translation header easy to include in translated pages
|
Deletions are marked like this. | Additions are marked like this. |
Line 2: | Line 2: |
||||<tablestyle="width: 100%; border: 0px hidden">||<style="border: 0px hidden">|| ||<style="border: 0px hidden">[:FrontPage:Front page] > [:Portal Hardwares:Hardwares] > Gamepad||<style="text-align: right; border: 0px hidden"> ||<style="text-align: right; border: 0px hidden"> (!) [:/Discussion:Discussion]|| ||<style="border: 0px hidden">~-''Translation(s): [:Portail_Gamepad:Français]''-~|| |
##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following (with the comment's character at the start of the line removed) ## <<Include(Gamepad, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>> ##TAG:TRANSLATION-HEADER-START ||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[it/Gamepad|Italiano]] - [[pt_BR/Gamepad|Português (Brasil)]] -~ ||<style="text-align: right; border: 0px hidden"> (!) [[/Discussion|Discussion]]|| ##TAG:TRANSLATION-HEADER-END |
Line 6: | Line 8: |
||<tablestyle="width: 100%; text-align: center; border: 0px hidden"> http://www.debian.org/logos/openlogo-nd-50.png http://www.debian.org/Pics/debian.png|| ||<style="border: 0px hidden">~+inline:Portal/IDB/logo_portal.png Welcome on Debian gamepad portal+~|| |
<<BR>> ||<tablestyle="width: 100%; text-align: center; border: 0px hidden"> {{http://www.debian.org/logos/openlogo-nd-50.png}} {{http://www.debian.org/Pics/debian.png}}|| ||<style="border: 0px hidden">~+{{attachment:Portal/IDB/logo_portal.png}} Welcome to the [[Debian]] gamepad portal!+~|| ---- {{attachment:Portal/IDB/icon-game-32x32.png}}This article talks about gamepad installation and setup. The two stages of configuration are often driver installation, and device configuration. Many devices have support integrated into the kernel and will work as soon as they're plugged in. Others can be more difficult. ---- <<TableOfContents(3)>> == Generic configuration == Given that the majority of devices have their necessary drivers built-in, the only thing most people might need to do is calibrate their controller afterwards. Many desktops have built-in configuration modules to select any connected gamepads and calibrate them. The process in the KDE Plasma desktop is documented here but the instructions are near-universally applicable. === KDE === * Open {{{Application Launcher > Search > Game Controller}}} '''or''' * Open {{{Application Launcher > System Settings > Input Devices > Game Controller}}} * Select your gamepad in the "Device" drop-down box * Hit the "Calibrate" button in the bottom-left and follow the on-screen instructions {{attachment:KDE_Gamepad_Configuration.png}} |
Line 10: | Line 36: |
inline:Portal/IDB/icone-game-32x32.png This article talk about gamepad installations. Installation can use two stages which are driver installation and device configuration. Generally, gamepads are detected automatically ''(native support)''. Technical words can be used but explained. |
== Testing == There are many useful games in the Debian repositories for verifying that your gamepad works as expected, but DebianPkg:supertuxkart is especially recommended due to its fantastic gamepad support. |
Line 13: | Line 44: |
[[TableOfContents([3])]] = Installation = This part presente list of hardwares order by manufacturer. This list driver you to the WikiPedia:chipset documentation and its driver. We recommand to get [:HowToIdentifyADevice:hardware identification]. |
|
Line 17: | Line 45: |
List is composed with chipset name and its identification. List is grouped by manufacturer name and commercial name of your device. | == Specific devices == === Xbox and PlayStation controllers === Xbox, Xbox 360, and Xbox One controllers, including many knock-offs, should work out-of-the-box with no issues. This includes both wired and wireless variants, whether by using official wireless receivers or through Bluetooth. This also applies for the !DualShock 3 and !DualShock 4 controllers commonly used by the !PlayStation consoles. |
Line 19: | Line 53: |
== USB Interface == * Logitech !RumblePad 2 [046d:c218] ''(native support)'' |
In December 2020, Sony published an official Linux driver for the "!DualSense" controller that comes with the !PlayStation 5 that should bring its support up to parity with previous Sony controllers, but the patchset remains under review. |
Line 22: | Line 55: |
= Configure your device = == KDE == Go in the next menu: |
=== Steam Controller === Support for the Steam Controller is provided through the DebianPkg:steam-devices package. By default, it works in "desktop mode" where it emulates mouse input. It will act as a proper controller only for games launched through Steam. There's a project developing a user-mode driver for the Steam Controller that allows it to emulate an Xbox controller in any game without need for the proprietary Steam client. It is not officially supported in Debian however, and it will require extra configuration of its own: https://github.com/kozec/sc-controller === Nintendo Switch Pro Controller === While support is not integrated into Debian yet, [[Steam]] implements its own driver, with udev rules available in the non-free DebPkg:steam-devices package. Patches to the kernel for a generic Nintendo driver are set to be included in Linux 5.16, and the driver will likely become available in Debian 12/Bookworm. ---- == Troubleshooting == If you struggle with connecting an Xbox One controller over Bluetooth, it may fix it to disable ERTM. This can be done once by running: |
Line 26: | Line 82: |
K > Settings > Peripherals > Joystick}}} attachment:kcontrol.png * Push all keys to see them in the dialog. * If necessary, you can calibrate your gamepad = Verify that works = * play DebPkg:torcs game |
# echo 1 > /sys/module/bluetooth/parameters/disable_ertm }}} If this fixes it, you may want to set this permanently so it isn't reversed on reboot. To do this, create a new file using Nano (or your preferred editor): {{{ # nano /etc/modprobe.d/bluetooth.conf }}} And add a single line to the new file: {{{ options bluetooth disable_ertm=Y }}} Note that ERTM is seldom used by any non-controller devices and it should not interfere with any other normal Bluetooth functionality to disable it. But if you do happen to run into issues with other Bluetooth devices after making this change, it may be helpful to try reverting it. ---- CategoryPortal | CategoryHardware | CategoryGamepad |
This article talks about gamepad installation and setup. The two stages of configuration are often driver installation, and device configuration. Many devices have support integrated into the kernel and will work as soon as they're plugged in. Others can be more difficult.
Contents
Generic configuration
Given that the majority of devices have their necessary drivers built-in, the only thing most people might need to do is calibrate their controller afterwards. Many desktops have built-in configuration modules to select any connected gamepads and calibrate them. The process in the KDE Plasma desktop is documented here but the instructions are near-universally applicable.
KDE
Open Application Launcher > Search > Game Controller
or
Open Application Launcher > System Settings > Input Devices > Game Controller
- Select your gamepad in the "Device" drop-down box
- Hit the "Calibrate" button in the bottom-left and follow the on-screen instructions
Testing
There are many useful games in the Debian repositories for verifying that your gamepad works as expected, but supertuxkart is especially recommended due to its fantastic gamepad support.
Specific devices
Xbox and PlayStation controllers
Xbox, Xbox 360, and Xbox One controllers, including many knock-offs, should work out-of-the-box with no issues. This includes both wired and wireless variants, whether by using official wireless receivers or through Bluetooth. This also applies for the DualShock 3 and DualShock 4 controllers commonly used by the PlayStation consoles.
In December 2020, Sony published an official Linux driver for the "DualSense" controller that comes with the PlayStation 5 that should bring its support up to parity with previous Sony controllers, but the patchset remains under review.
Steam Controller
Support for the Steam Controller is provided through the steam-devices package. By default, it works in "desktop mode" where it emulates mouse input. It will act as a proper controller only for games launched through Steam.
There's a project developing a user-mode driver for the Steam Controller that allows it to emulate an Xbox controller in any game without need for the proprietary Steam client. It is not officially supported in Debian however, and it will require extra configuration of its own: https://github.com/kozec/sc-controller
Nintendo Switch Pro Controller
While support is not integrated into Debian yet, Steam implements its own driver, with udev rules available in the non-free steam-devices package. Patches to the kernel for a generic Nintendo driver are set to be included in Linux 5.16, and the driver will likely become available in Debian 12/Bookworm.
Troubleshooting
If you struggle with connecting an Xbox One controller over Bluetooth, it may fix it to disable ERTM. This can be done once by running:
# echo 1 > /sys/module/bluetooth/parameters/disable_ertm
If this fixes it, you may want to set this permanently so it isn't reversed on reboot. To do this, create a new file using Nano (or your preferred editor):
# nano /etc/modprobe.d/bluetooth.conf
And add a single line to the new file:
options bluetooth disable_ertm=Y
Note that ERTM is seldom used by any non-controller devices and it should not interfere with any other normal Bluetooth functionality to disable it. But if you do happen to run into issues with other Bluetooth devices after making this change, it may be helpful to try reverting it.