Help:Peripherals and accessories: Difference between revisions

Help page
(→‎Skylander portal: Added info)
(Rewrote large chunks of the non-techical text to make it more understandable and natural.)
Line 1: Line 1:
''This page is under construction''
RPCS3 supports some USB peripherals through a system called USB passthrough. The supported devices will appear to the games 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.


==cellUsbd device whitelist==
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.
To avoid interfering with all hardware and for ease of use our list of devices is an invisible whitelist of supported hardware, which at the time of writing is:
 
==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
* Skylanders Portal
* Singstar Microphone (currently not working as it uses the streaming usb protocol)
* Singstar Microphone (currently not working as it uses the streaming usb protocol)
Line 14: Line 16:
* Harmonix Button Guitar
* Harmonix Button Guitar
* Harmonix Real Guitar
* Harmonix Real Guitar
* lgFF_c283_c29b(which regroups some Logitech wheels used by GT5/6)
* lgFF_c283_c29b (a group of some Logitech wheels supported by GT5/6)
* Thrustmaster RGT FFB Pro
* Thrustmaster RGT FFB Pro
* Thrustmaster F430
* Thrustmaster F430
Line 21: Line 23:
* Thrustmaster T500 RS Gear Shift
* Thrustmaster T500 RS Gear Shift


==cellUsbd set-up instructions==
==cellUsbd Set-up Instructions==
Now before you go all giddy and plug your favourite wheel to go play GT5, know that there are some limitations.
RPCS3 needs to be able to communicate to the USB device directly. This requires some setup from the user.


===On Windows===
===On Windows===
* You need to change the driver of the accessory you want to use to WinUsb one with [https://zadig.akeo.ie/ zadig] which is a well respected software to handle this.  
* You need to make your device use WinUSB drivers. For this, a popular and respected software is [https://zadig.akeo.ie/ Zadig].  
* Just in case the procedure to REVERT the driver is:  
* IF you need to REVERT the driver changes, to  f.ex. make the device work with other software, the procedure is:  
*# Go to device manager, the device will be listed under "Universal Serial Bus Devices", right click on it,
*# Go to device manager, the device will be listed under "Universal Serial Bus Devices", right click on it,
*# Properties => Driver => Update Driver => Browse my computer for driver software => Let me pick... => USB Input Device (or whatever the previous driver was).
*# Properties => Driver => Update Driver => Browse my computer for driver software => Let me pick... => USB Input Device (or whatever the previous driver was).


===On Linux===
===On Linux===
# Create a file called <code>/etc/udev/rules.d/99-ps3-peripherals.rules</code> (you will need root permissions to create this file), and fill it with the following:
* Create a file called <code>/etc/udev/rules.d/99-ps3-peripherals.rules</code> (you will need root permissions to create this file), and fill it with the following:
#: <code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"</code>
*: <code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"</code>
# ''<u>Note</u>'': this gives r/w access to all USB devices by default, if you want to specify a specific device you can use:
* ''<u>Note</u>'': 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:
#: <code>SUBSYSTEM=="usb", ATTRS{idVendor}=="ABCD", ATTRS{idProduct}=="1234", MODE="0666"</code>
*: <code>SUBSYSTEM=="usb", ATTRS{idVendor}=="ABCD", ATTRS{idProduct}=="1234", MODE="0666"</code>
#: changing idVendor and idProduct values to the VID/PID of the device you want to allow.
*: changing idVendor and idProduct values to the VID/PID of the device you want to allow.
 
==Skylanders Portal==
For Skylanders, there exists a emulated Skylanders portal which can be used with the game if you do not own the device yourself.


==Skylander portal==
To use the emulated Skylanders portal:
To emulate skylander toys:
# Go to Manage => Skylanders Portal
# Go to Manage => Skylanders Portal
# Click ''New'' and create a new file. That file represents a skylander 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.


Note that it is only enabled if it doesn't detect any real skylander portal.
Note that the emulated portal will not be enabled if you have a real Skylanders portal connected.


Also of note is that the Skylander figure data generation is incomplete and the first time you use it, it will either refuse it or some games (such as Skylanders SWAP Force) will detect it as <corrupted> and offer to repair it, once repaired it will work perfectly on all games.
Also of note is that 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.

Revision as of 14:03, 5 October 2020

RPCS3 supports some USB peripherals through a system called USB passthrough. The supported devices will appear to the games 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 some Logitech wheels supported by GT5/6)
  • Thrustmaster RGT FFB Pro
  • Thrustmaster F430
  • Thrustmaster FFB
  • Thrustmaster TRS
  • Thrustmaster T500 RS Gear Shift

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 f.ex. 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:
    SUBSYSTEM=="usb", ATTRS{idVendor}=="ABCD", ATTRS{idProduct}=="1234", MODE="0666"
    changing idVendor and idProduct values to the VID/PID of the device you want to allow.

Skylanders Portal

For Skylanders, there exists a 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 that the emulated portal will not be enabled if you have a real Skylanders portal connected.

Also of note is that 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.