USB Passthrough: Difference between revisions

USB Passthrough (view source)

Revision as of 01:37, 6 February 2017

154 bytes added , 6 February 2017

add info about the upcoming USB branch (which will be merged soon)

Léo

279

edits

@@ Line 1: / Line 1: @@
-Since {{revision|4.0.2}}, Dolphin has the ability to passthrough USB HID devices designed for use with Wii software. This gives emulated Wii software full control of a hardware device connected to your PC.  This is very useful for devices not currently emulated by Dolphin and games that highly depend on extra hardware.
+Since {{revision|4.0.2}}, Dolphin has the ability to passthrough USB HID devices designed for use with Wii software. And since 5.0-XXXX, Dolphin can passthrough arbitrary USB devices. This gives emulated Wii software full control of a hardware device connected to your PC.  This is very useful for devices not currently emulated by Dolphin and games that highly depend on extra hardware.
-== List of Devices and IDs ==
+== List of Wii Devices and IDs ==
 {|class="wikitable sortable width=100%"
 ! Device !! VID !! PID !! Type !! Compatibility
@@ Line 21: / Line 21: @@
 |0A03
 |OH0/VEN
-|Not Supported
+|Supported*
 |-
 |Harmonix Guitar Controller for Nintendo Wii
@@ Line 62: / Line 62: @@
 |0308
 |OH0
-|Not Supported
+|Supported*
 |-
 |YourShape Camera
 |030A
 |VEN
-|Not Supported
+|Supported*
 |-
 |Internal Bluetooth dongle
@@ Line 75: / Line 75: @@
 |-
 |}
+<sup>* Only supported in the USB branch.</sup>
-Dolphin is currently unable to use any USB device which is not a HID (Human Interface Device).
 == Setting up ==
 === Linux ===
 Linux support does not require any special drivers. However, a udev rule must be created to allow access to the devices.  Note, the Vender ID and Product ID SHOULD be verified from the device itself before creating the rule.
-. Paste the following into '''/etc/udev/rules.d/52-dolphin.rules''' (/lib/udev/rules.d/52-dolphin.rules if making a package):
+. Paste the following into '''/etc/udev/rules.d/52-dolphin.rules''' (/lib/udev/rules.d/52-dolphin.rules if making a package). Do not forget to replace the XXXX with the appropriate Vendor and Product IDs.
 <code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTRS{idVendor}=="XXXX", ATTRS{idProduct}=="XXXX", MODE="0666"</code>
-. Replace the XXXX with the appropriate Vendor and Product IDs.
+. Reload udev rules with:
-. Reload udev rules with:
 <code>sudo udevadm control --reload-rules</code>
-. Now, reinsert the accessory. When the game is booted it should be able to access the accessory as if it were plugged into a Wii.
+. Reinsert the accessory.
-To change the rule, links for instructions are available on the [https://github.com/libusb/libusb/wiki/FAQ#Can_I_run_libusb_applications_on_Linux_without_root_privilege libusb FAQ].
 === Windows ===
+==== Before 5.0-XXXX ====
 Download and open [http://zadig.akeo.ie/ Zadig], then:
@@ Line 104: / Line 100: @@
 . On the right column, select "libusbk" then click "Replace Driver". Select "Yes" to modify the system driver.
-The game will then be able to detect the device on next boot.
+==== In the USB branch ====
+Download and install the latest [https://github.com/daynix/UsbDk/releases x64 usbdk driver].
 === macOS ===
@@ Line 111: / Line 108: @@
 === Android ===
 This feature is not supported on Android.
+== Configuring Dolphin ==
+==== Before 5.0-XXXX ====
+No configuration is required for USB HID passthrough.
+==== In the USB branch ====
+. Open Dolphin's configuration dialog.
+. Click on the Wii tab.
+. In the "Whitelisted USB passthrough devices", click on the "Add..." button.
+. Select the device you wish to passthrough.
 [[Category: Tutorials]]