Progress Continues
We've already had 21779 updates since Dolphin 5.0. Keep up with Dolphin's continuing progress through the Dolphin Blog: February, March, and April 2024 Dolphin Progress Report. |
The Dolphin Emulator Wiki needs your help! Dolphin can play thousands of games, and changes are happening all the time. Help us keep up! Join in and help us make this the best resource for Dolphin. |
How to use the Official GameCube Controller Adapter for Wii U in Dolphin
As of 4.0-4599, Dolphin has built in support for the Nintendo GameCube controller Adapter for Wii U, the only official USB GameCube adapter available. With Dolphin's implementation, the GC controller is auto-configured and calibrated, with full rumble support. Wireless controllers and bongos are supported.
Installation
Linux
Linux support does not require any special drivers. However, at this time Dolphin must be run as root for the adapter to be detected. User can create a udev rule to get around it. Links for instructions are available on the libusb FAQ.
An example of such a rule is (place the below in a file called /etc/udev/rules.d/50-libusb.rules
):
SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666"
Reload udev rules with sudo udevadm control --reload-rules
, then unplug and plug back in the adapter.
OS X
Dolphin's adapter support does not work in OS X at this time. System level drivers are now available, but they require configuration through the GCpad as any other controller would.
Windows
Windows will need to have a driver to let Dolphin make use of GC Controller adapter.
If you have the vJoy drivers installed on your system, the GC pad will act like a generic gamepad which can be configured in Dolphin like any other controller. Unlike vJoy, Dolphin's native support will offer more straightforward and added missing supports from vJoy, and reduce the input latency. vJoy and Dolphin's native support conflict with one another, so to use the native support in Dolphin, vJoy's drivers must be removed from the system and you may have to lose the ability to use GC controller on another application.
Driver installation
1. Close Dolphin if it is running then plug in the GC adapter.
2. Download and launch Zadig.
3. From the "Options" menu in Zadig, select "List All Devices"
4. In the pulldown menu, select "WUP-028".
- Check if the driver on the left says "HidUsb" and the USB ID is "057E 0337", then you can continue. Otherwise, follow the driver removal instructions below.
5. On the right hand side, select "WinUSB" then click "Replace Driver".
6. Select "Yes" to modify the system driver.
When it said the driver is installed successfully then you can close the Zadig setup. Please continue to "Setup" below.
Adapter not detected
If Dolphin's controller setting says that the adapter is not detected, try inserting the GC adapter into another USB port (try USB 2.0 ports and USB 3.0 ports). Dolphin will detect GC adapters that are plugged into USB hubs.
Driver not detected
If the controller settings says "Driver not detected", go to the Windows "Device Manager", and look for the "WUP-028" device which is usually under the "Universal Serial Bus devices". Select the "Driver" tab. Click "Uninstall". Select "Delete the driver software for this device". Click "OK". Then unplug and re-insert the GC adapter. The steps for driver installation can now be followed.
Setup
With any necessary installation complete, run Dolphin, and check "Direct Connect" under GameCube Adapter in the Controller Settings. Then simply start a game that uses GameCube controllers.
- Ensure that "Standard Controller" or "bongos" is selected in each port you wish to use in the Controller Settings. The ports on the adapter correspond to the numbered ports in the Controller Settings.
- Both USB cables need to be plugged in for wireless controllers and/or rumble.
- Dolphin supports hot-plug, so the pads can be unplugged and plugged into other ports. If a pad is unplugged from the adapter, Dolphin will use what is configured (PC keyboard/mouse, PC gamepad etc).