How to use the Official GameCube Controller Adapter for Wii U in Dolphin: Difference between revisions

m
highlight the important bit
(→‎Linux: added mention of Flatseal and clarified that only some distros require specifying all devices)
m (highlight the important bit)
 
(One intermediate revision by one other user 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.


Inside of the location '''/etc/udev/rules.d/''' (or '''/lib/udev/rules.d/''' if making a package), paste the following into the '''51-gcadapter.rules''' file and save it (if the file does not already exist, then create a new empty file with that file name):
 
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>


Either restart your PC or reload udev rules with the following terminal command:
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>.


Dolphin should now detect it in the controller settings (refer to [[#Dolphin Setup]] below).
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.


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].
2,231

edits