Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
supported_controllers [2023/01/18 23:04] – Added Stadia Controller and 8bitdo Ultimate lbrpdxsupported_controllers [2025/03/18 21:25] (current) – [4dapter] tugg_speedoman
Line 24: Line 24:
  
 ===== 8bitdo controllers ===== ===== 8bitdo controllers =====
-{{pads:sf30pro.png?nolink&250|}} {{:pads:sn30pro_.jpg?nolink&250|}}{{:pads:8bitdo_ultimate.jpg?nolink&250|}}+{{pads:sf30pro.png?nolink&250|}} {{:pads:sn30pro_.jpg?nolink&250|}}
  
-8bitdo Bluetooth controllers are supported. To pair an 8bitdo controller, put it into its X-input mode (for newer models, flick the switch from ''S'' to ''X''; for older models, first turn it on by pressing ''[+start]'' + ''[X]'' at the same time) and then press and hold the sync button (if the controller has one, else hold the ''[-select]'' button for 3 seconds), until the LED blinks rapidly. Then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. It should then automatically be detected and paired.+8bitdo Bluetooth controllers are supported. To pair an 8bitdo controller, turn it on by pressing ''[+start]'' + ''[X]'' at the same time (for activating the X-input Mode, which is recommended), then press and hold the sync button (if the controller has no sync button, press and hold ''[-select]'' for 3 seconds), the LEDs will begin to blink rapidly. Then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. It should then automatically be detected and paired.
  
-8bitdo controllers get excellent support from their manufacturer, so it might be worth to visit their support page and get the newest firmware installed. Users report of a massive improved BT support after [[https://support.8bitdo.com/|updating the firmware]].+<WRAP center round tip> 
 +For newer models, X-input is activated by shifting the mode switch from ''S'' to ''X'' on the bottom of the controller. The following information may or may not be specific to the M30 controller but is useful if you are having issues with the directional pad. 
 +</WRAP>
  
-8bitdo Zero (first generation): +LEFT + Select : set Dpad as left analogue stick.
-To pair, press and hold ''[+start]'' + ''[R1]'' for 2 seconds, then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. Wait for 10-15 seconds and the controller should automatically be detected and paired.+
  
-8bitdo Ultimate controllers: both bluetooth and 2.4GHz versions are supported with Batocera 36 and later.+Up + Select : reset Dpad.
  
-<WRAP center round help> +Right + Select : set Dpad as right analogue stick.
-As of **v31** and higher 8bitdo controllers in X-input mode are having some issues correctly mapping. You can switch to using D-input mode (''[+start]'' + ''[B]'') to avoid these issues.+
  
-8bitdo controllers also have issues using "hold" commands, as the home button glitches out when held down. This can be worked around by holding the home button for a full second before doing any hold commands.+Down + Select : Swap A/B and X/Y mapping (on Switch mode only). 
 + 
 +*Press and hold any of the key combinations above for 5 seconds to map the buttons. 
 + 
 +*LED will blink in red to indicate the success of each button mapping. 
 + 
 +*You need to reset the buttons manually. 
 + 
 +8bitdo controllers get excellent support from their manufacturer, so it might be worth to visit their support page and get the newest firmware installed. Users report Bluetooth connection improvements after [[https://support.8bitdo.com/|updating the firmware]]. 
 + 
 +<WRAP center round help> 
 +8bitdo controllers have issues using "hold" commands, as the home button glitches out when held down. This can be worked around by holding the home button for a full second before doing any hold commands.
 </WRAP> </WRAP>
  
 If preferred, connecting via a USB cable is simpler. The input mode switching is done the same way, just while plugging in the controller instead of while pressing ''[+start]''. If preferred, connecting via a USB cable is simpler. The input mode switching is done the same way, just while plugging in the controller instead of while pressing ''[+start]''.
 +
 +==== 8bitdo Zero (first generation) ====
 +
 +To pair, press and hold ''[+start]'' + ''[R1]'' for 2 seconds, then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. Wait for 10-15 seconds and the controller should automatically be detected and paired.
 +
 +==== 8bitdo Ultimate controllers ====
 +{{:pads:8bitdo_ultimate.jpg?nolink&250|}}
 +
 +The first 8bitdo controllers to use non-standard input drivers, these controllers are only supported in Batocera **v36** and higher.
  
 ===== PlayStation controllers ===== ===== PlayStation controllers =====
Line 75: Line 95:
 {{pads:ps4.jpg?nolink&250|}} {{pads:ps4.jpg?nolink&250|}}
  
-PS4 controllers are supported. In case of issues, it is often the dongle which is not supported by Linux. To pair the PS4 controller, first put it into pairing mode by press and **holding** the PlayStation button and ''[Share]'' button at the same time for 3 seconds. Hold these buttons until the light bar starts rapidly flashing. Then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. It should then automatically be detected and paired.+PS4 controllers are supported. In case of [[:troubleshooting#bluetooth_issues_not_connecting_no_devices_detected_etc|issues]], it is often the dongle which is not [[:hardware:compatible_dongle_list|supported by Linux]]. To pair the PS4 controller, first put it into pairing mode by press and **holding** the PlayStation button and ''[Share]'' button at the same time for 3 seconds. Hold these buttons until the light bar starts rapidly flashing. Then go in the menu to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE**. It should then automatically be detected and paired.
  
 For touch-friendly systems (looking at Nintendo DS emulators for example), the PS4 touch pad is recognized as a mouse, and can be used for that. For touch-friendly systems (looking at Nintendo DS emulators for example), the PS4 touch pad is recognized as a mouse, and can be used for that.
Line 85: Line 105:
 PS4 controllers always work when connected via USB cable. PS4 controllers always work when connected via USB cable.
  
 +=== Alternative connection method ===
 +
 +This method is similar tho the PS3 controller and may help when the pairing mode method above fails. Connect the PS4 controller to the Batocera machine via USB cable, wait a moment for it to register, and then disconnect the PS4 controller. In Batocera, go to **CONTROLLER & BLUETOOTH SETTINGS** -> **PAIR A BLUETOOTH DEVICE** and press the PlayStation button on the PS4 controller while it is scanning. Batocera should then pick up the controller and sync with it.
 ==== PS5 controllers ==== ==== PS5 controllers ====
 {{:pads:sony-ps5-white-controller.png?nolink&250|}} {{:pads:sony-ps5-white-controller.png?nolink&250|}}
Line 119: Line 142:
  
 Xbox controllers always work if connected via USB cable. Xbox controllers always work if connected via USB cable.
 +
 +<WRAP center round tip>
 +As reported by some users, like many other controllers, if you experience issues with your Xbox One controller, make sure its firmware is up to date. It requires access to a Windows machine to upgrade XBox One controller's firmware.
 +</WRAP>
  
 ==== Xbox Core/Series S/Series X controllers ==== ==== Xbox Core/Series S/Series X controllers ====
Line 129: Line 156:
 <WRAP center round help> <WRAP center round help>
 Batocera **v34** and below require the use of the [[https://www.xbox.com/en-US/accessories/adapters/wireless-adapter-windows|official wireless dongle]] (which can be [[https://www.xbox.com/en-us/accessories/controllers/xbox-wireless-controller-adapter-win10|ordered together in a bundle direct from Microsoft]]). Newer versions of Batocera can use these controllers paired via standard Bluetooth LE connection, provided your hardware actually supports that. Batocera **v34** and below require the use of the [[https://www.xbox.com/en-US/accessories/adapters/wireless-adapter-windows|official wireless dongle]] (which can be [[https://www.xbox.com/en-us/accessories/controllers/xbox-wireless-controller-adapter-win10|ordered together in a bundle direct from Microsoft]]). Newer versions of Batocera can use these controllers paired via standard Bluetooth LE connection, provided your hardware actually supports that.
 +
 +[[https://www.reddit.com/r/batocera/comments/10i14rz/got_this_wireless_adapter_from_amazon_and_it/|Users have reported]] that the more readily available [[https://www.amazon.com/dp/B08CY14VGD?ref_=cm_sw_r_apan_dp_7GWY26MATD8R65E35V4F|Cipon wireless third-party adapter]] works with Xbox One/S/X controllers as well.
 </WRAP> </WRAP>
  
Line 155: Line 184:
 From Batocera **v35** onwards, Wiimotes will automatically connect to ES as light guns. This will render the button inputs on the Wiimote to not appear as a controller's inputs (so they can instead be used as a [[emulators:lightgun_games|light gun]]), making them unmappable. If intending to use the Wiimote as an ordinary retro controller, the old gamepad behaviour can be restored by going to **CONTROLLER & BLUETOOTH SETTINGS** -> **WIIMOTE GUN SETTINGS** -> **MODE** and set it to "PAD". From Batocera **v35** onwards, Wiimotes will automatically connect to ES as light guns. This will render the button inputs on the Wiimote to not appear as a controller's inputs (so they can instead be used as a [[emulators:lightgun_games|light gun]]), making them unmappable. If intending to use the Wiimote as an ordinary retro controller, the old gamepad behaviour can be restored by going to **CONTROLLER & BLUETOOTH SETTINGS** -> **WIIMOTE GUN SETTINGS** -> **MODE** and set it to "PAD".
  
-{{:playground:emulators:wii_options_1.png?400|}}+{{:emulators:wii_options_1.png?400|}}
  
 ==== Switch controllers ==== ==== Switch controllers ====
Line 173: Line 202:
 {{:pads:stadia_controller.jpg?250|}} {{:pads:stadia_controller.jpg?250|}}
  
-You can use the Google Stadia Controller with Batocera after you updated its firmware to use Bluetooth LE. Once you switch your Stadia controller to Bluetooth mode, you can’t change it back to use Wi-Fi on Stadia (but the service is now discontinued anyway). You can also play wired with USB in Bluetooth mode. To perform the upgrade, you need to go to [[https://stadia.google.com/controller/index_en_US.html|this Stadia controller update page]] and the controller will be recognized out of the box with Batocera 36 and later. Google currently states that the Bluetooth update will be available until Dec 31, 2023.+With the sunsetting of Google Stadia, Google released an optional firmware update for its controllers to make them function as generic Bluetooth controllers. The update is performed through the browser [[https://stadia.google.com/controller/index_en_US.html|on this page]] (Google initially stated that the Bluetooth update will be available only until 2023, then extended it to 2024 have now extended to December 31st, 2025). This controller is supported in Batocera **v36** and higher. 
 + 
 +Once the controller is switched to Bluetooth mode, it cannot be switched back to Wi-Fi mode for use with Stadia (not that this matters anyway as Stadia is discontinued).
  
 ===== Other controllers ===== ===== Other controllers =====
Line 184: Line 215:
 === Retro-Bit Sega Saturn === === Retro-Bit Sega Saturn ===
  
-  * D-pad to normal, press and hold Up + Start for 3 seconds+The controller’s LED indicates the input mode it is in. To switch between the modes, press 
 +and hold Start + B until it changes color. 
 +  * Red indicates it is in D-Input mode. 
 +  * Blue indicates it is in X-Input mode. 
 + 
 +It has the following macros:
   * D-pad to Left Analog mode, press and hold Left + Start for 3 seconds   * D-pad to Left Analog mode, press and hold Left + Start for 3 seconds
   * D-pad to Right Analog mode, press and hold Right + Start for 3 seconds   * D-pad to Right Analog mode, press and hold Right + Start for 3 seconds
 +  * To flip the face buttons A/B & X/Y, press and hold Down + Start for 3 seconds
 +  * To reset the D-pad back to normal, press and hold Up + Start for 3 seconds
 +
 + === Retro-Bit Mega Drive,Genesis 8-Button Arcade Pad with USB (Model 2 - Switch) ===
 +  
 +Swap between D-Input and X-Input by holding Start + B for 5 seconds
 +
 +  * D-pad Input, press and hold D-pad Up + Start for 5 seconds
 +  * D-pad to Left analog, press and hold D-pad Left + Start for 5 seconds 
 +  * D-pad to Right analog, press and hold D-pad Right + Start for 5 seconds
 +  * Swap A-B & X-Y, press and hold D-pad Down + Start for 5 seconds
  
 === Retro-Bit Tribute64 === === Retro-Bit Tribute64 ===
  
 This controller doesn't work particularly well with most systems due to its atypical design, but this can be worked around by employing the controller configs as [[systems:n64#controls|defined in the N64 system page]]. This controller doesn't work particularly well with most systems due to its atypical design, but this can be worked around by employing the controller configs as [[systems:n64#controls|defined in the N64 system page]].
 +
 +Swap between D-Input and X-Input by holding down the C-Up + C-Left for 5 seconds
  
 ==== GameSir ==== ==== GameSir ====
Line 217: Line 266:
 The controller comes with a 2.4 GHz or Bluetooth receiver, which makes the controller appear as though it were a wired USB controller to the host machine, but the T3S model still works via any ordinary Bluetooth receiver. The controller comes with a 2.4 GHz or Bluetooth receiver, which makes the controller appear as though it were a wired USB controller to the host machine, but the T3S model still works via any ordinary Bluetooth receiver.
  
 +=== Gamesir Nova Lite ===
 +
 +Gamesir Nova Lite controllers have been reported to be working correctly with Batocera when paired with the included dongle, in X-Input mode (press the pair button and Y button).
 ==== X-Arcade Tankstick ==== ==== X-Arcade Tankstick ====
 {{pads:tankstick.png?nolink&250|}} {{pads:tankstick.png?nolink&250|}}
Line 222: Line 274:
 The X-Arcade Tankstick is supported on Batocera when you enable ''controllers.xarcade.enabled=1'' in the ''/userdata/system/batocera.conf'' file. It is done through the ''arcade2jstick'' module, which means that each of the two sticks is seen as an independent joystick by EmulationStation and the emulators. The trackball is recognized as a USB mouse in emulators that support mouse. The X-Arcade Tankstick is supported on Batocera when you enable ''controllers.xarcade.enabled=1'' in the ''/userdata/system/batocera.conf'' file. It is done through the ''arcade2jstick'' module, which means that each of the two sticks is seen as an independent joystick by EmulationStation and the emulators. The trackball is recognized as a USB mouse in emulators that support mouse.
  
 +==== Xtension Controller (from https://recroommasters.com) ====
 +{{::xtension.jpg?300|Xtension 2 Player Controller “Emulator Edition”}}
 +{{::xtensionplus.jpg?300|Xtension 2 Player Plus Controller “Emulator Edition PLUS”}}
 +{{::xtension4.jpg?300|Xtension 4 Player Controller “Emulator Edition”}}
 +
 +For 2 or 4 players, with as options : trackball, extra buttons, artwork.
 +
 +Should work out of the box in batocera 41.
 ==== Rii RK707 ==== ==== Rii RK707 ====
 {{:81c6kwni13l._ac_sl1417_.jpg?200|}} {{:81c6kwni13l._ac_sl1417_.jpg?200|}}
Line 234: Line 294:
 ==== Nexilux Wii U Pro Controller ==== ==== Nexilux Wii U Pro Controller ====
 {{:wii-u-pro-wireless-controller-gamepad-joystick-for-nintend-wii.jpg_q90.jpg_.jpeg?250|}} {{:wii-u-pro-wireless-controller-gamepad-joystick-for-nintend-wii.jpg_q90.jpg_.jpeg?250|}}
 +
 +<WRAP center round important>
 +There are many clones of this controller which do not work with Batocera.
 +</WRAP>
  
 A third-party Wii U style Pro controller. Works fine with all the D-input compatible emulators, but may have issues with Wine (which expects an X-input controller, can be worked around by using a pad2key profile for some games). A third-party Wii U style Pro controller. Works fine with all the D-input compatible emulators, but may have issues with Wine (which expects an X-input controller, can be worked around by using a pad2key profile for some games).
Line 255: Line 319:
 {{:adaptoid.jpg?nolink&250|}} {{:adaptoid.jpg?nolink&250|}}
  
-There are adapters (sometimes called adaptoids) that can be used to convert original controllers over to USB, which should work in most cases. These are usually console specific but sometimes feature multiple ports; the latter of which is always a third-party solution where quality may be questionable.+There are adapters (sometimes called adaptoids) that can be used to convert original controllers over to USB, which should work in most cases. These are usually console specific but sometimes feature multiple ports; the latter of which is always a third-party solution where quality may be questionable, especially with regards to added input lag. 
 + 
 +==== 4dapter ==== 
 +An excellent original controller adapter that connects via USB-C with [[https://rpubs.com/misteraddons/inputlatency|1ms input lag]] is the [[https://www.tindie.com/products/timville/4dapter-switch-mister-retro-controller-adapter/|4dapter: Retro Controller Adapter]] by [[https://www.tindie.com/stores/timville/|Timville]], which is an all-in-one adapter that supports original **NES**, **SNES**, **Genesis** and **Nintendo 64 (N64)** controllers.  
 + 
 +{{:4dapter-side1.jpeg?300|}} {{:4dapter-side2.jpeg?300|}} 
 + 
 +> Note: Make sure to select the Firmware Option -> **Batocera/Retroarch Optimized** at checkout  
 +> Note: NES, SNES and Genesis controllers are automatically configured, Nintendo 64 controllers do require a **manual remap** according to the diagram below 
 +{{::n64-mapping.jpg?800|}}
  
 ==== SNES/NES GPIO controllers ==== ==== SNES/NES GPIO controllers ====
Line 297: Line 370:
   * Some keyboards have anti-ghosting features which may prevent the pressing of multiple keys at the same time.   * Some keyboards have anti-ghosting features which may prevent the pressing of multiple keys at the same time.
   * Some keyboards have a high debounce setting that increases the input delay resulting in a poorer experience.   * Some keyboards have a high debounce setting that increases the input delay resulting in a poorer experience.
 +
 +The default settings for a keyboard in the EmulationStation menu are:
 +  * ''SPACE'' bar for the main menu (i.e. ''START'')
 +  * ''BACKSPACE'' for the contextual menu (i.e. ''SELECT'')
 +  * ''ENTER'' key to select, ''ESC'' key to go back
  
  • supported_controllers.1674083068.txt.gz
  • Last modified: 3 years ago
  • by lbrpdx