Dolphin Emulator Wiki

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

Page Discussion

How to use the Official GameCube Controller Adapter for Wii U in Dolphin (view source)

Revision as of 23:39, 18 December 2023

592 bytes added ,  18 December 2023
m
highlight the important bit
(→‎macOS: Updated instructions for using Gamecube controller adapters in macOS, includes a modern method that avoids needing to disable System Integrity Protection.)
m (highlight the important bit)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[File:Wiiugcpadadapter.jpg|right|thumb|300px|Official GameCube Controller Adapter for Wii U|link=]]
[[File:Wiiugcpadadapter.jpg|right|thumb|300px|Official GameCube Controller Adapter for Wii U|link=]]
As of {{revision|4.0-4599}}, Dolphin has built in support for the [http://www.nintendo.com/wiiu/accessories Nintendo GameCube controller Adapter for Wii U], the only official USB GameCube adapter 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.


This method of connecting controllers is intended to work with all adapters that are compatible with Super Smash Bros. for Wii U, but certain third-party adapters don't seem to work with this method. Adapters by Nintendo and Mayflash are known to work.
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.
 
Compatible third-party adapters generally have a switch for choosing between PC mode and Wii U mode. If your adapter has such 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 10: 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.


Paste the following in the '''/etc/udev/rules.d/51-gcadapter.rules''' file (/lib/udev/rules.d/51-gcadapter.rules if making a package):
 
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>


Reload udev rules with:
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>


Then re-insert the adapter. Dolphin should now detect it in the controller settings (refer to [[#Dolphin Setup]] below).
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 67: Line 75:


== Windows ==
== Windows ==
On Windows, the GameCube controller adapter will need a certain driver to let Dolphin detect it and use it. If you are using {{revision|5.0-2472}} or newer, you need to either install a filter driver using Zadig or install UsbDk. (Doing both is unnecessary, but doesn't lead to any problems.) If you aren't sure which one to pick, use Zadig. If you are using {{revision|5.0-2341}} or older, using Zadig is required.
On Windows, the GameCube controller adapter will need a custom driver to let Dolphin detect it and use it, Zadig can help you with it. From {{revision|5.0-2472}} to {{revision|5.0-10617}} it was possible to alternatively use UsbDk, but it is no longer supported in current versions.


=== Avoid vJoy ===
=== Avoid vJoy ===
Line 73: Line 81:


=== Using Zadig ===
=== Using Zadig ===
Plug in the GameCube controller adapter if it hasn't been already. Download and launch [http://zadig.akeo.ie/ Zadig]. If you're using the Mayflash adapter, make sure you switch it to "Wii U" or Zadig won't pick it up properly.
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.
 
1. From the "Options" menu in Zadig, select "List All Devices"
 
2. In the pulldown menu, select "WUP-028". Ensure that its USB ID is "057E 0337".
* If it does not appear in the list then try inserting the adapter (specifically its black USB cord) into another USB port.


3. On the right column, select "WinUSB" then click "Replace Driver". Select "Yes" to modify the system driver.
# 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.
Flacs
2,231

edits

Retrieved from "https://wiki.dolphin-emu.org/index.php?title=Special:MobileDiff/177960...184868"