2,231
edits
(→Linux: Clarifying some steps and adding instructions on getting it working in the flatpak) |
m (highlight the important bit) |
||
(10 intermediate revisions by 3 users not shown) | |||
Line 2: | Line 2: | ||
As of {{revision|4.0-4599}}, Dolphin has built in support for Nintendo's GameCube controller adapters for the Wii U and Switch, the only official USB GameCube adapters available. With Dolphin's implementation, the GameCube controller is auto-configured and calibrated, with full rumble support. Wireless controllers and bongos are supported. | As of {{revision|4.0-4599}}, Dolphin has built in support for Nintendo's GameCube controller adapters for the Wii U and Switch, the only official USB GameCube adapters available. With Dolphin's implementation, the GameCube controller is auto-configured and calibrated, with full rumble support. Wireless controllers and bongos are supported. | ||
In addition to the official adapters, third-party adapters that are compatible with the Wii U are also supported. Such third-party adapters generally have a switch for choosing between PC mode and Wii U mode. If your adapter has a switch, you have to set it to Wii U mode before following these instructions. Official Nintendo adapters don't have a switch. | In addition to the official adapters, third-party adapters that are compatible with the Wii U are also supported. Such third-party adapters generally have a switch for choosing between PC mode and Wii U mode. If your adapter has a switch, you have to set it to '''Wii U mode''' before following these instructions. Official Nintendo adapters don't have a switch. | ||
= Installation = | = Installation = | ||
Line 8: | Line 8: | ||
Linux support does not require any special drivers, as long as Dolphin was built with libusb support. However, a udev rule must be created to allow access to the device. | Linux support does not require any special drivers, as long as Dolphin was built with libusb support. However, a udev rule must be created to allow access to the device. | ||
With root privileges, navigate to the location '''/etc/udev/rules.d/''' (or '''/lib/udev/rules.d/''' if making a package) and locate the file '''51-gcadapter.rules''' (if the file does not already exist, then create a new empty file with that file name). Open that file and paste the following into it: | |||
<code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="0337", MODE="0666"</code> | <code>SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="0337", MODE="0666"</code> | ||
Save and overwrite the existing file, then either restart your PC or reload udev rules with the following terminal command: | |||
<code>sudo udevadm control --reload-rules</code> | <code>sudo udevadm control --reload-rules</code> | ||
If you did not restart your PC, then also re-insert the adapter. | If you did not restart your PC, then also re-insert the adapter. Dolphin should now detect it in the controller settings (refer to [[#Dolphin Setup]] below). | ||
When using the flatpak version of Dolphin, some Linux distributions will additionally require you to specify access to all devices. This can be done with the <code>--device=all</code> command argument, e.g.: | |||
<code>/usr/bin/flatpak run --device=all --command=/app/bin/dolphin-emu-wrapper org.DolphinEmu.dolphin-emu</code>. | |||
For an alternative GUI-based method, you can install and run [https://flathub.org/apps/com.github.tchx84.Flatseal Flatseal] and then enable "All devices (e.g. webcam)" specifically for Dolphin. | |||
If you want 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]. | If you want 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]. | ||
Line 73: | Line 81: | ||
=== Using Zadig === | === Using Zadig === | ||
Plug in the GameCube controller adapter if it hasn't been already. Download and launch [ | Plug in the GameCube controller adapter if it hasn't been already. Download and launch [https://github.com/pbatard/libwdi/releases Zadig]. If you're using the a third party adapter, like the one from Mayflash, make sure you switch it to "Wii U" or "Switch" mode or Zadig won't pick it up properly. | ||
# From the "Options" menu in Zadig, select "List All Devices" | |||
# In the pulldown menu, select "WUP-028". Ensure that its USB ID is "057E 0337".</br>* If it does not appear in the list then try inserting the adapter (specifically its black USB cord) into another USB port. | |||
# On the right column, select "WinUSB" then click "Replace Driver". Select "Yes" to modify the system driver. | |||
When it said the driver is installed successfully then you can close the Zadig setup and continue to [[#Dolphin Setup]] below. | When it said the driver is installed successfully then you can close the Zadig setup and continue to [[#Dolphin Setup]] below. |
edits