Controller Configuration

From Performous

Jump to: navigation, search

Performous supports and autodetects guitars and drumkits from Guitar Hero and Rock Band and also some generic dance pads. For help on configuring microphones, see Audio Configuration.

Contents

[edit] General notes

  • Guitar Hero World Tour guitar/drums cannot be differentiated automatically, so if Performous detects them wrong, use instrument type forcing.
  • Linux kernel driver doesn't allow detecting the tilt sensor from Guitar Hero guitars.
  • Ensure that CONFIG_INPUT_JOYSTICK=y if you've compiled your kernel from source.

[edit] Forcing instrument type

Currently, it is not possible to manually map controls, but you can force Performous to detect a joystick as a certain type. You may need to do this with e.g. Guitar Hero World Tour instruments or if you want to try if your officially non-supported dancepad works.

[edit] Editing config.xml

If you haven't done so already, go to the Configuration screen in the main menu and press Ctrl+S to create your local config file. In Linux, it will be located at ~/.config/performous/config.xml Edit the file with a text editor and add the following entry inside the <performous> and </performous> tags. 

<entry name="game/instruments" type="string_list">
  <stringvalue>SDL_ID:INSTRUMENT_TYPE</stringvalue>
</entry>

Where SDL_ID is an integer id number for the instrument (Performous reports it in console output and it is typically 0, if you have just one instrument connected).

INSTRUMENT_TYPE is the desired type, one of the following:

  • GUITAR_GUITARHERO
  • GUITAR_GUITARHERO_XPLORER
  • GUITAR_HAMA_PS2
  • GUITAR_ROCKBAND_PS3
  • GUITAR_ROCKBAND_XB360
  • DRUMS_GUITARHERO
  • DRUMS_ROCKBAND_PS3
  • DRUMS_ROCKBAND_XB360
  • DRUMS_MIDI
  • DANCEPAD_GENERIC
  • DANCEPAD_EMS2
  • DANCEPAD_TIGERGAME
  • DANCEPAD_2TECH

Note: Versions <= 0.5.0 don't provide separate types for Rock Band PS3/Xbox360.

[edit] New mappings

We are happy to add new mappings and auto-detections to controllers. Follow these steps to get your instrument added:

  1. Check if one of the existing mappings work, e.g. for a dance pad, try forcing each of the available DANCEPAD_* values in turn.
  2. If that didn't work, launch Performous with parameter --jstest and identify the button/axis IDs (printed on the console, the black window is there to be able to capture the events) of your controller. That means writing down what button you just pressed together with the corresponding line printed to the console (containing the IDs).
  3. The name of the controller is also required (as reported to Performous), so check the terminal output (near beginning) and look for a line starting with "SDL joystick:".
  4. The final step is to come to IRC with all that information and if there is no problems, we add it to the next release.
  5. If you feel adventurous, you can also try mapping yourself - the code is in joystick.cc.

[edit] Xbox / Xbox360 Controllers

Linux kernel doesn't have proper driver for XBox360 (or XBox) instruments, so in order for them to work, you must install a kernel module or a userspace driver. At least for the latter, you must also use instrument type forcing (the driver reports wrong names) and supply a custom button mapping. E.g. for Rock Band drums, start the userspace driver with

./xboxdrv --buttonmap green=dd,red=dl,yellow=dr,blue=du,orange=back,start=yellow,back=red,dd=green,du=blue,dl=red,dd=green

Note: After Xbox360 mapping improvements in 0.5.1, the custom mapping might not be needed (the given one applies for PS3-type). Testing needed.

For additional information about mapping the buttons with userspace driver, see http://github.com/Grumbel/xboxdrv/blob/master/README

[edit] Wii Dance Pad with the 3 in 1 Magic Joy Box adapter

It will be recognized as DANCEPAD_TIGERGAME

To use it you need to hold the + button of the dance pad 3 seconds to switch to the digital mode

[edit] PS2 Dance Pad with the EMS usb2 adapter

It will be recognized as DANCEPAD_EMS2

To use it you need to hold the up, select and start buttons of the dance pad 3 seconds to switch to the digital mode

[edit] Tested controllers

[edit] Instruments

Note: Most of these are not tested on Mac.

Console Game Instrument USB id Status (with version) Tester Notes
PS3 Guitar Hero III - Legends of Rock Official Guitar 12ba:0100 OK (0.5.1) Yoda [1]
PS3 Guitar Hero - Metallica Official Guitar 12ba:0100 OK (0.5.1) Lordheavy [2]
PS3 Guitar Hero World Tour

Guitar Hero V

Official Guitar 12ba:0100 OK (0.5.1) Yoda [3][4]
PS3 Guitar Hero World Tour Official Drumkit 12ba:0120 OK (0.5.1) Yoda
PS3 The Beatles RockBand Official Guitar (Bass design) 12ba:0200 OK (0.5.1) Yoda [5]
PS3 The Beatles RockBand Official Drumkit 12ba:0210 OK (0.5.1) Yoda
PS3 Rock Band Official Guitar 12ba:0200 OK (>=0.4.0) Aave
PS3 Rock Band Official Drumkit 12ba:0210 OK (>=0.4.0) Aave
PS2 Rock Band Hardware Bundle Hardware Bundle  ????:???? OK (0.5.0) h3ndrik [6]
Xbox360 Rock Band Official Guitar  ????:???? OK mostly (>=0.5.1) Aave [7]
Xbox360 Rock Band Official Drumkit  ????:???? OK (>=0.5.1) Aave [8]
Xbox360 Guitar Hero II X-plorer guitar 1430:4748 OK (>=0.5.0) zaddo
Xbox360 Rock Band Mad Catz Portable Drum Kit  ????:???? OK (>=0.5.1) fatdogem
Wii GHWT Official Guitar - OK (>=0.5.1) Esver [9][10]
Wii RockBand Official Guitar  ????:???? OK (>=0.5.1) fbert68 [11]
Wii RockBand Official Drumkit  ????:???? OK (>=0.5.1) fbert68 [12]

[edit] Dance pads

Console Game Name USB id Status (with version) Tester Notes
PC / PS2 - Play.com PS2 Controller Converter 0b43:0003 OK (>=0.5.2) Lordheavy [13]
PC / PS2 - RedOctane USB Pad  ? OK (>=0.4.0) Aave
Wii - TigerGame USB adapter 0926:2526 OK (>=0.5.1) Esver [14]

[edit] Microphones

Any Alsa capable devices should work under Linux (this includes PS2 Singstar mics, wireless PS2/PS3 mics, GHWT mic, Rock Band mics, Wii mic)

[edit] Notes

  1. ↑ Tilt is not working (you can enable it with Start though)
  2. ↑ Need to be configured as: GUITAR_GUITARHERO
  3. ↑ Tilt is not working and you should press Start instead of Select to activate it. Touch fret (solo) is not working
  4. ↑ Detection should be forced (otherwise guessed as drumkit)
  5. ↑ Tilt is working, Upper and lower frets are working
  6. ↑ Works out of the box incl. Whammy and tilt. USB-Id follows
  7. ↑ Solo frets are currently unusable, tilt untested. Also, see above for Linux notes.
  8. ↑ See above for Linux notes.
  9. ↑ Wii_Linux_Controller
  10. ↑ It's a Bluetooth controller, you need Bluetooth activated on you computer
  11. ↑ Should be forced as RockBand Guitar for PS3 for version <=0.5.1, autodetected for version > 0.5.1
  12. ↑ Should be forced as RockBand Drumkit for PS3 for version <=0.5.1, autodetected for version > 0.5.1
  13. ↑ Controller_Configuration#PS2_Dance_Pad_with_the_EMS_usb2_adapter
  14. ↑ Controller_Configuration#Wii_Dance_Pad_with_the_3_in_1_Magic_Joy_Box_adapter
Retrieved from "http://wiki.performous.org/index.php/Controller_Configuration"
Personal tools