Help:Peripherals and accessories: Difference between revisions

Help page
(Added icons for face buttons)
m (slight edit to RB2 Deluxe link)
 
(25 intermediate revisions by 15 users not shown)
Line 5: Line 5:
==cellUsbd Device Whitelist==
==cellUsbd Device Whitelist==
To avoid interference from various USB devices on your PC, RPCS3 only exposes devices which have been whitelisted. At the time of writing, this list includes:
To avoid interference from various USB devices on your PC, RPCS3 only exposes devices which have been whitelisted. At the time of writing, this list includes:
* Skylanders Portal
* Buzz Buzzers
* Singstar Microphone (currently not working as it uses the streaming USB protocol)
* Disney Infinity Base
* DJ Hero Turntable
* EA Sports Active 2 Dongle
* GCon3 Gun
* Guitar Hero Drums
* Guitar Hero Guitar
* Guitar Hero Guitar
* Guitar Hero Drums
* Guitar Hero Live Guitar
* Guitar Hero Live Guitar
* DJ Hero Turntable
* Harmonix Button Guitar
* Harmonix Drums
* Harmonix Guitar
* Harmonix Guitar
* Harmonix Drums
* Harmonix Keyboard
* Harmonix Keyboard
* Harmonix Button Guitar
* Harmonix Real Guitar
* Harmonix Real Guitar
* Kamen Rider Summonride Portal
* Lego Dimensions Portal
* lgFF_c283_c29b (a group of Logitech wheels supported by GT5/6)
* lgFF_c283_c29b (a group of Logitech wheels supported by GT5/6)
* Thrustmaster RGT FFB Pro
* lgFF_ca03_ca03 (Logitech wheels supported by GT6)
* Oculus DK 1
* PlayTV DVB-T Tuner (SCEH-0036)
* Singstar Microphone (currently not working as it uses the streaming USB protocol)
* Skylanders Portal
* Thrustmaster F430
* Thrustmaster F430
* Thrustmaster FFB
* Thrustmaster FFB
* Thrustmaster RGT FFB Pro
* Thrustmaster T500 RS Gear Shift
* Thrustmaster TRS
* Thrustmaster TRS
* Thrustmaster T500 RS Gear Shift
* uDraw GameTablet
* uDraw GameTablet


Line 54: Line 63:
==Configuring Instruments==
==Configuring Instruments==
First, right click your game and click '''Create Custom Gamepad Configuration'''. Then follow the instructions below:
First, right click your game and click '''Create Custom Gamepad Configuration'''. Then follow the instructions below:
* '''<u>PS3/Wii Guitars</u>:''' Use '''MMJoystick handler'''. Remap the following buttons:
* '''<u>PS3/PS4/Wii Guitars</u>:''' Use '''MMJoystick handler'''. Remap the following buttons:
*: [[File:ds cross.png|20px|alt=Cross]] = Green Fret
*: <span class="image-inline">[[File:ds cross.png|20px|alt=Cross]]</span> = Green Fret
*: [[File:ds circle.png|20px|alt=Circle]] = Red Fret
*: <span class="image-inline">[[File:ds circle.png|20px|alt=Circle]]</span> = Red Fret
*: [[File:ds square.png|20px|alt=Square]] = Yellow Fret
*: <span class="image-inline">[[File:ds square.png|20px|alt=Square]]</span> = Yellow Fret (GH) / Blue Fret (RB)
*: [[File:ds triangle.png|20px|alt=Triangle]] = Blue Fret
*: <span class="image-inline">[[File:ds triangle.png|20px|alt=Triangle]]</span> = Blue Fret (GH) / Yellow Fret (RB)
*: L1 = Orange Fret
*: L1 = Orange Fret
*: DPAD Up = Up Strum
*: DPAD Up = Up Strum
*: DPAD Down= Down Strum
*: DPAD Down = Down Strum
*: Right Stick Right = Whammy Bar
*: L2 = Solo modifier (Rock Band only)
*: R1 = Guitar tilt (Rock Band only)


* '''<u>Xbox 360 Guitars</u>:''' Use '''XInput handler'''. Remap by flipping/switching the Y and X buttons while leaving the rest untouched.
* '''<u>Xbox 360 Guitars</u>:''' Use '''XInput handler'''. Remap by flipping/switching the Y and X buttons while leaving the rest untouched.


* '''<u>PS3/Wii/Xbox 360 Drums</u>:''' Use '''MMJoystick handler''' for PS3/Wii drums, and '''XInput handler''' for Xbox 360 drums.  
* '''<u>PS3/Wii/Xbox 360 Drums</u>:''' Use '''MMJoystick handler''' for PS3/Wii drums, and '''XInput handler''' for Xbox 360 drums.
*: Change ''device class'' to '''Drums/Guitar Hero''' or '''Drums/Rock Band'''.
*: Change ''device class'' to '''Drums/Guitar Hero''' or '''Drums/Rock Band'''.
** Remap the following buttons for Rock Band drums:
** Remap the following buttons for '''Rock Band drums''':
**: [[File:ds cross.png|20px|alt=Cross]] = Green Pad
**: <span class="image-inline">[[File:ds cross.png|20px|alt=Cross]]</span> = Green Pad
**: [[File:ds circle.png|20px|alt=Circle]] = Red Pad
**: <span class="image-inline">[[File:ds circle.png|20px|alt=Circle]]</span> = Red Pad
**: [[File:ds square.png|20px|alt=Square]] = Blue Pad
**: <span class="image-inline">[[File:ds square.png|20px|alt=Square]]</span> = Blue Pad
**: [[File:ds triangle.png|20px|alt=Triangle]] = Yellow Pad
**: <span class="image-inline">[[File:ds triangle.png|20px|alt=Triangle]]</span> = Yellow Pad
**: L1 = Foot Pedal
**: L1 = Foot Pedal
**: DPAD Up = Up Strum
**: DPAD = DPAD
**: DPAD Down= Down Strum
** For '''Rock Band Pro drums''', also map the following buttons:
** For Guitar Hero drums, remap them the same way as Rock Band drums except:  
**: L3 = Pad modifier
**: R3 = Cymbal modifier
**: R1 = Double bass pedal (Requires [https://github.com/hmxmilohax/rock-band-2-deluxe#readme Rock Band 2 Deluxe] mod or Rock Band 3)/Hi-hat pedal
** For '''Guitar Hero drums''', remap them the same way as '''Rock Band drums''' except:
**: R1 = Orange Pad
**: R1 = Orange Pad
**: L1 = Foot Pedal
 
PS4 drum kits have issues and are not recommended. Cymbals will never work.
 
* '''<u>PS3 Turntables</u>:''' Works natively through USB passthrough after following cellUsbd Set-up Instructions section above.
 
* '''<u>Wii/Xbox 360 Turntables</u>:''' Right click your game and click '''Create Custom Configuration.''' In addition to setting your preferred custom configuration settings, in the '''I/O''' tab set ''DJ Hero emulated turntable'' to '''1 controller''' (or '''2 controllers''' if you are binding multiple turntables).
** For '''Xbox 360 turntables on Windows''', you will need to calibrate the turntable using this [https://github.com/TheNathannator/Turntable-Calibrator/releases Xbox 360 Turntable Calibrator tool].
**: Connect your 360 table to your PC, and disconnect all other game controllers.
**: Download the tool, and run <code>Turntable_Calibrator.exe</code>. It should find your turntable & generate 2 <code>.reg</code> files.
**: Double-click the file starting with <code>360table_calibration_install</code> to install the calibration to your registry.
**: See the [https://github.com/TheNathannator/Turntable-Calibrator README] for more details.
** Back in the '''custom gamepad configuration''', use '''MMJoystick handler''' and change ''device class'' to '''DJ/DJ Hero Turntable'''.
** Remap the following buttons:
**: <span class="image-inline">[[File:ds cross.png|20px|alt=Cross]]</span> = Green Button
**: <span class="image-inline">[[File:ds circle.png|20px|alt=Circle]]</span> = Red Button
**: <span class="image-inline">[[File:ds square.png|20px|alt=Square]]</span> = Blue Button
**: <span class="image-inline">[[File:ds triangle.png|20px|alt=Triangle]]</span> = Euphoria (shared with dedicated <span class="image-inline">[[File:ds triangle.png|20px|alt=Triangle]]</span> button at the top of the mixer)
**: Right Stick Down = Crossfade Left
**: Right Stick Up = Crossfade Right
**: Right Stick Left = Effects Dial Left
**: Right Stick Right = Effects Dial Right
**: Left Stick Down = Scratch Down
**: Left Stick Up = Scratch Up
**: Squircle Values Left: 0
**: Squircle Values Right: 0
** The following bind is needed for the Calibration and Tutorial modes, but is otherwise optional:
**: R1: Dedicated <span class="image-inline">[[File:ds cross.png|20px|alt=Cross]]</span> button at the top of the mixer.
** The following binds are not needed, but documented for completeness:
**: L1: Dedicated <span class="image-inline">[[File:ds circle.png|20px|alt=Circle]]</span> button at the top of the mixer.
**: R2: Dedicated <span class="image-inline">[[File:ds square.png|20px|alt=Square]]</span> button at the top of the mixer.


<u>''Notes''</u>:
<u>''Notes''</u>:
* For guitars, change device class to Guitar/Guitar Hero or Guitar/Rock Band depending on the instrument.
* For guitars, change '''device class''' to '''Guitar/Guitar Hero''' or '''Guitar/Rock Band''' depending on the instrument and game. Guitar Hero guitars require Rock Band 1 with title updates, Rock Band 2 or later, or any Guitar Hero game. Rock Band guitars require Guitar Hero World Tour or later, or any Rock Band game.
* To use a drum and guitar at the same time you must create a profile for each of them.
* To use a drum and guitar at the same time you must create a profile for each of them.
* If remapping the buttons isn’t working, click the '''"Filter Noise"''' button in the lower left corner.
* If L2 is bound on a Guitar Hero guitar, you may erroneously auto-strum during solos in Rock Band games. Make sure the button isn't accidentally bound.
* Tilt on Guitar Hero guitars will not function in Rock Band games.


==Skylanders Portal==
==Skylanders Portal==
Line 89: Line 136:
# Go to <code>Manage > Skylanders Portal</code>
# Go to <code>Manage > Skylanders Portal</code>
# Click '''New''' and create a new file. That file represents a Skylanders figure and its stats, it will be automatically saved with each change to the figure in-game. You can use the combobox to choose which figure that file represents.
# Click '''New''' and create a new file. That file represents a Skylanders figure and its stats, it will be automatically saved with each change to the figure in-game. You can use the combobox to choose which figure that file represents.


''<u>Note</u>'':
''<u>Note</u>'':
# The emulated portal will not be enabled if you have a real Skylanders portal connected.
# The emulated portal will not be enabled if you have a real Skylanders portal connected.
# If the Skylander figure data generation is incomplete and the first time you use it, the game will either refuse it, or some games (such as Skylanders SWAP Force) will detect it as <code><corrupted></code> and offer to repair it. Once it has been repaired by a game which supports repairing, it will work perfectly on other Skylanders games as well.
# If the Skylander figure data generation is incomplete and the first time you use it, the game will either refuse it, or some games (such as Skylanders SWAP Force) will detect it as <code><corrupted></code> and offer to repair it. Once it has been repaired by a game which supports repairing, it will work perfectly on other Skylanders games as well.
# For Sensei's and Traps you have to download .bin files and use them instead of the created ones on rpcs3
==Rock Band 3 MIDI Instruments==
There is support for an emulated Rock Band 3 MIDI Pro Adapter for Keyboards and Pro Guitars if you don't own the device yourself.
To use an emulated MIDI Pro Adapter
# Go to <code>Configuration > Input/Output</code>
# Select your MIDI devices and device types.
Keyboards use the following layout:
<pre>
All inputs use MIDI channel 1.
octave 2:
A B  C D E
1 2 3 4 5 6 7
1 - Select
2 - D-Pad Left
3 - D-Pad Right
4 - D-Pad Up
5 - D-Pad Down
6 - Overdrive
7 - Intentionally Left Blank
A - Triangle
B - Square
C - Circle
D - Cross
E - Start
Pitch Wheel - Slider/Whammy
Mod Wheel (MIDI CC 1) - Overdrive
Sustain Pedal (MIDI CC 40) - Overdrive
Octave 3, Octave 4, and Note C5 - Keys used in-game.
</pre>
Pro Guitars use the buttons that are on the guitar itself.

Latest revision as of 22:34, 26 September 2023

RPCS3 supports some USB peripherals through a system called USB passthrough. The supported devices will appear to games the same way as they would when plugged in to a real console, allowing games to discover and communicate with the USB accessories that they support.

Note that hotplugging is not supported yet, which means that the USB devices must be connected before launching the game and remain connected for the entire session.

cellUsbd Device Whitelist

To avoid interference from various USB devices on your PC, RPCS3 only exposes devices which have been whitelisted. At the time of writing, this list includes:

  • Buzz Buzzers
  • Disney Infinity Base
  • DJ Hero Turntable
  • EA Sports Active 2 Dongle
  • GCon3 Gun
  • Guitar Hero Drums
  • Guitar Hero Guitar
  • Guitar Hero Live Guitar
  • Harmonix Button Guitar
  • Harmonix Drums
  • Harmonix Guitar
  • Harmonix Keyboard
  • Harmonix Real Guitar
  • Kamen Rider Summonride Portal
  • Lego Dimensions Portal
  • lgFF_c283_c29b (a group of Logitech wheels supported by GT5/6)
  • lgFF_ca03_ca03 (Logitech wheels supported by GT6)
  • Oculus DK 1
  • PlayTV DVB-T Tuner (SCEH-0036)
  • Singstar Microphone (currently not working as it uses the streaming USB protocol)
  • Skylanders Portal
  • Thrustmaster F430
  • Thrustmaster FFB
  • Thrustmaster RGT FFB Pro
  • Thrustmaster T500 RS Gear Shift
  • Thrustmaster TRS
  • uDraw GameTablet

cellUsbd Set-up Instructions

RPCS3 needs to be able to communicate to the USB device directly. This requires some setup from the user.

On Windows

  • You need to make your device use WinUSB drivers. For this, a popular and respected software is Zadig.
  • IF you need to REVERT the driver changes, to make the device work with other software, the procedure is:
    1. Go to device manager, the device will be listed under "Universal Serial Bus Devices", right click on it,
    2. Properties => Driver => Update Driver => Browse my computer for driver software => Let me pick... => USB Input Device (or whatever the previous driver was).

On Linux

Create a file called /etc/udev/rules.d/99-ps3-peripherals.rules (you will need root permissions to create this file), and fill it with the following:

SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"

Note: the line above will grant RPCS3 full r/w access to all USB devices by default. If this concerns you, you might want to limit it to only specific USB devices using:

SUBSYSTEM=="usb", ATTRS{idVendor}=="ABCD", ATTRS{idProduct}=="1234", MODE="0666"

Change idVendor and idProduct values to the VID/PID of the device you want to allow.

After this you must either:

  1. restart your computer for these settings to apply or
  2. run sudo udevadm control --reload-rules and replug in your controller

Configuring Instruments

First, right click your game and click Create Custom Gamepad Configuration. Then follow the instructions below:

  • PS3/PS4/Wii Guitars: Use MMJoystick handler. Remap the following buttons:
    Cross = Green Fret
    Circle = Red Fret
    Square = Yellow Fret (GH) / Blue Fret (RB)
    Triangle = Blue Fret (GH) / Yellow Fret (RB)
    L1 = Orange Fret
    DPAD Up = Up Strum
    DPAD Down = Down Strum
    Right Stick Right = Whammy Bar
    L2 = Solo modifier (Rock Band only)
    R1 = Guitar tilt (Rock Band only)
  • Xbox 360 Guitars: Use XInput handler. Remap by flipping/switching the Y and X buttons while leaving the rest untouched.
  • PS3/Wii/Xbox 360 Drums: Use MMJoystick handler for PS3/Wii drums, and XInput handler for Xbox 360 drums.
    Change device class to Drums/Guitar Hero or Drums/Rock Band.
    • Remap the following buttons for Rock Band drums:
      Cross = Green Pad
      Circle = Red Pad
      Square = Blue Pad
      Triangle = Yellow Pad
      L1 = Foot Pedal
      DPAD = DPAD
    • For Rock Band Pro drums, also map the following buttons:
      L3 = Pad modifier
      R3 = Cymbal modifier
      R1 = Double bass pedal (Requires Rock Band 2 Deluxe mod or Rock Band 3)/Hi-hat pedal
    • For Guitar Hero drums, remap them the same way as Rock Band drums except:
      R1 = Orange Pad

PS4 drum kits have issues and are not recommended. Cymbals will never work.

  • PS3 Turntables: Works natively through USB passthrough after following cellUsbd Set-up Instructions section above.
  • Wii/Xbox 360 Turntables: Right click your game and click Create Custom Configuration. In addition to setting your preferred custom configuration settings, in the I/O tab set DJ Hero emulated turntable to 1 controller (or 2 controllers if you are binding multiple turntables).
    • For Xbox 360 turntables on Windows, you will need to calibrate the turntable using this Xbox 360 Turntable Calibrator tool.
      Connect your 360 table to your PC, and disconnect all other game controllers.
      Download the tool, and run Turntable_Calibrator.exe. It should find your turntable & generate 2 .reg files.
      Double-click the file starting with 360table_calibration_install to install the calibration to your registry.
      See the README for more details.
    • Back in the custom gamepad configuration, use MMJoystick handler and change device class to DJ/DJ Hero Turntable.
    • Remap the following buttons:
      Cross = Green Button
      Circle = Red Button
      Square = Blue Button
      Triangle = Euphoria (shared with dedicated Triangle button at the top of the mixer)
      Right Stick Down = Crossfade Left
      Right Stick Up = Crossfade Right
      Right Stick Left = Effects Dial Left
      Right Stick Right = Effects Dial Right
      Left Stick Down = Scratch Down
      Left Stick Up = Scratch Up
      Squircle Values Left: 0
      Squircle Values Right: 0
    • The following bind is needed for the Calibration and Tutorial modes, but is otherwise optional:
      R1: Dedicated Cross button at the top of the mixer.
    • The following binds are not needed, but documented for completeness:
      L1: Dedicated Circle button at the top of the mixer.
      R2: Dedicated Square button at the top of the mixer.

Notes:

  • For guitars, change device class to Guitar/Guitar Hero or Guitar/Rock Band depending on the instrument and game. Guitar Hero guitars require Rock Band 1 with title updates, Rock Band 2 or later, or any Guitar Hero game. Rock Band guitars require Guitar Hero World Tour or later, or any Rock Band game.
  • To use a drum and guitar at the same time you must create a profile for each of them.
  • If remapping the buttons isn’t working, click the "Filter Noise" button in the lower left corner.
  • If L2 is bound on a Guitar Hero guitar, you may erroneously auto-strum during solos in Rock Band games. Make sure the button isn't accidentally bound.
  • Tilt on Guitar Hero guitars will not function in Rock Band games.

Skylanders Portal

For Skylanders, there exists an emulated Skylanders portal which can be used with the game if you do not own the device yourself.

To use the emulated Skylanders portal:

  1. Go to Manage > Skylanders Portal
  2. Click New and create a new file. That file represents a Skylanders figure and its stats, it will be automatically saved with each change to the figure in-game. You can use the combobox to choose which figure that file represents.


Note:

  1. The emulated portal will not be enabled if you have a real Skylanders portal connected.
  2. If the Skylander figure data generation is incomplete and the first time you use it, the game will either refuse it, or some games (such as Skylanders SWAP Force) will detect it as <corrupted> and offer to repair it. Once it has been repaired by a game which supports repairing, it will work perfectly on other Skylanders games as well.
  3. For Sensei's and Traps you have to download .bin files and use them instead of the created ones on rpcs3

Rock Band 3 MIDI Instruments

There is support for an emulated Rock Band 3 MIDI Pro Adapter for Keyboards and Pro Guitars if you don't own the device yourself.

To use an emulated MIDI Pro Adapter

  1. Go to Configuration > Input/Output
  2. Select your MIDI devices and device types.

Keyboards use the following layout:

All inputs use MIDI channel 1.

octave 2:
 A B   C D E
1 2 3 4 5 6 7

1 - Select
2 - D-Pad Left
3 - D-Pad Right
4 - D-Pad Up
5 - D-Pad Down
6 - Overdrive
7 - Intentionally Left Blank

A - Triangle
B - Square
C - Circle
D - Cross
E - Start

Pitch Wheel - Slider/Whammy
Mod Wheel (MIDI CC 1) - Overdrive
Sustain Pedal (MIDI CC 40) - Overdrive

Octave 3, Octave 4, and Note C5 - Keys used in-game.

Pro Guitars use the buttons that are on the guitar itself.