Help:Peripherals and accessories

Help page
Revision as of 15:14, 20 September 2021 by HerrHulaHoop (talk | contribs) (Add instrument config (to be formatted))

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:

  • Skylanders Portal
  • Singstar Microphone (currently not working as it uses the streaming USB protocol)
  • Guitar Hero Guitar
  • Guitar Hero Drums
  • Guitar Hero Live Guitar
  • DJ Hero Turntable
  • Harmonix Guitar
  • Harmonix Drums
  • Harmonix Keyboard
  • Harmonix Button Guitar
  • Harmonix Real Guitar
  • lgFF_c283_c29b (a group of Logitech wheels supported by GT5/6)
  • Thrustmaster RGT FFB Pro
  • Thrustmaster F430
  • Thrustmaster FFB
  • Thrustmaster TRS
  • Thrustmaster T500 RS Gear Shift
  • 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/Wii Guitars: Use MMJoystick handler. Remap the following buttons:
    Cross = Green Fret
    Circle = Red Fret
    Square = Yellow Fret
    Triangle = Blue Fret
    L1 = Orange Fret
    DPAD Up = Up Strum
    DPAD Down= Down Strum
  • 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 Up = Up Strum
      DPAD Down= Down Strum
    • For Guitar Hero drums, remap them the same way as Rock Band drums except:
      R1 = Orange Pad
      L1 = Foot Pedal

Notes:

  • For guitars, change device class to Guitar/Guitar Hero or Guitar/Rock Band depending on the instrument.
  • To use a drum and guitar at the same time you must create a profile for each of them.

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.