Differences between revisions 20 and 21
Revision 20 as of 2020-07-17 07:18:29
Size: 3233
Comment: Update KDE screenshot and instructions, improve article grammar, expand the article with a section for device-specific information
Revision 21 as of 2020-12-25 03:36:06
Size: 4484
Comment: Update to add a troubleshooting section, clarify the state of the Switch Pro Controller, add semantic newlines, and add info on the new DualSense controller
Deletions are marked like this. Additions are marked like this.
Line 33: Line 33:
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. 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 39: Line 42:
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. 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.
Line 42: Line 51:
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. 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.
Line 44: Line 57:
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 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
Line 47: Line 64:
While support is not integrated into Debian yet, [[Steam]] implements its own driver and it should theoretically be usable with Steam games only. An official kernel driver is in-progress. 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 in the staging branch
for Linux 5.10, and the driver will likely become available in
Debian early in the development cycle of Debian 12/Bookworm.
Line 50: Line 72:

== 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.
----

Translation(s): English - Italiano - Brazilian Portuguese

(!) ?Discussion


http://www.debian.org/logos/openlogo-nd-50.png http://www.debian.org/Pics/debian.png

Portal/IDB/logo_portal.png Welcome to the Debian gamepad portal!


Portal/IDB/icon-game-32x32.pngThis 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.


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

KDE_Gamepad_Configuration.png


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 in the staging branch for Linux 5.10, and the driver will likely become available in Debian early in the development cycle of 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.


CategoryPortal | CategoryHardware | CategoryGamepad