211
edits
 |
Progress Continues
We've already had 21455 updates since Dolphin 5.0. Keep up with Dolphin's continuing progress through the Dolphin Blog: August, September, and October 2023 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: Difference between revisions
Jump to navigation
Jump to search
How to use the Official GameCube Controller Adapter for Wii U in Dolphin (view source)
Revision as of 21:49, 3 May 2018
, 3 May 2018Oops, I totally messed up some of the links in my previous edit...
m (Minor formatting adjutments) |
(Oops, I totally messed up some of the links in my previous edit...) |
||
| (15 intermediate revisions by 10 users not shown) | |||
| Line 2: | Line 2: | ||
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 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. | ||
This guide is primarily for the official adapter, but third-party adapters that are compatible with Super Smash Bros. for Wii U generally also work. If your adapter has a switch for choosing between PC mode and Wii U mode, set it to Wii U mode before following these instructions. | |||
= Installation = | = Installation = | ||
== Linux == | == Linux == | ||
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. 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): | Paste the following in the '''/etc/udev/rules.d/51-gcadapter.rules''' file (/lib/udev/rules.d/51-gcadapter.rules if making a package): | ||
| Line 20: | Line 19: | ||
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]. | ||
== | == macOS == | ||
Due to the nature of Apple's HID implementation, ''all'' HID devices (including non-standard ones) are intercepted by IOKit's HID driver. Since the adapter does not supply a valid report descriptor, this makes the IOKit driver useless for direct communication. | Due to the nature of Apple's HID implementation, ''all'' HID devices (including non-standard ones) are intercepted by IOKit's HID driver. Since the adapter does not supply a valid report descriptor, this makes the IOKit driver useless for direct communication. | ||
| Line 31: | Line 25: | ||
==== Easy Install ==== | ==== Easy Install ==== | ||
[https://forums.dolphin-emu.org/attachment.php?aid=13495 Installer | [https://forums.dolphin-emu.org/attachment.php?aid=16638 Installer package for macOS El Capitan (10.11) and later] | ||
[https://forums.dolphin-emu.org/attachment.php?aid=13495 Installer package for older versions of macOS] | |||
==== Terminal Install ==== | ==== Terminal Install ==== | ||
[https://forums.dolphin-emu.org/attachment.php?aid=13485 Standalone | [https://forums.dolphin-emu.org/attachment.php?aid=16637 Standalone kext for macOS El Capitan (10.11) and later] | ||
[https://forums.dolphin-emu.org/attachment.php?aid=13485 Standalone kext for older versions of macOS] | |||
<pre> | <pre> | ||
sudo cp -r ~/Downloads/SmashEnabler.kext /Library/Extensions/SmashEnabler.kext | sudo cp -r ~/Downloads/SmashEnabler.kext /Library/Extensions/SmashEnabler.kext | ||
| Line 44: | Line 43: | ||
Once installed, Dolphin should be able to recognize that the adapter has been plugged in. You do not need to configure the controllers manually within Dolphin's controller settings but any controllers plugged into the adapter should work immediately. | Once installed, Dolphin should be able to recognize that the adapter has been plugged in. You do not need to configure the controllers manually within Dolphin's controller settings but any controllers plugged into the adapter should work immediately. | ||
For questions on any of these | For questions on any of these macOS connection techniques, please see the [https://forums.dolphin-emu.org/Thread-os-x-gcn-adapter-kext-testers-wanted forum thread]. | ||
==== macOS with System Integrity Protection (SIP) ==== | |||
On El Capitan (10.11) and later, the unsigned Kernel Extension will fail to load. | |||
The only current workaround is to disable kernel-extension signing verification, which can be done in macOS Recovery Mode. | |||
This will lessen security, and is not recommended. | |||
<pre> | |||
csrutil enable --without kext | |||
</pre> | |||
See this [http://apple.stackexchange.com/questions/208478/how-do-i-disable-system-integrity-protection-sip-aka-rootless-on-os-x-10-11 StackExchange thread] for more details. | |||
== Windows == | == Windows == | ||
On Windows, the GameCube controller adapter will need a certain driver to let Dolphin detect it and use it. | On Windows, the GameCube controller adapter will need a certain driver to let Dolphin detect it and use it. | ||
=== Avoid vJoy === | |||
The software that utilizes ''vJoy'' drivers, such as ''GameCube USB Adapter Driver'', can treat the GameCube controllers as generic gamepads for Windows. They 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'' (i.e. force feedback), and offer better latency. ''vJoy'' and Dolphin's native support conflict with one another, so to use the native support in Dolphin, driver services must be stopped through ''GameCube USB Adapter Driver'' 's window. You probably already have ran '''''Zadig''''' setup if the ''GameCube USB Adapter Driver'' version is v3.0 or later. Skip to [[#Dolphin Setup]] below if you haven't encountered any problems with it. | |||
=== Windows === | |||
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 and follow the instructions below. | |||
=== | If you are using {{revision|5.0-2341}} or older, using Zadig is required. | ||
Plug in the GameCube controller adapter if it hasn't been already. Download and launch [http://zadig.akeo.ie/ 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. | |||
1. From the "Options" menu in Zadig, select "List All Devices" | 1. From the "Options" menu in Zadig, select "List All Devices" | ||
| Line 82: | Line 93: | ||
=== Input doesn't work === | === Input doesn't work === | ||
There is a bug in Android's USBManager framework that sometimes causes Dolphin to be incapable of reading the adapter. In these instances a toast window will pop up asking you to unplug and replugin the adapter. Do so and Dolphin will be able to read the adapter after that. | There is a bug in Android's USBManager framework that sometimes causes Dolphin to be incapable of reading the adapter. In these instances a toast window will pop up asking you to unplug and replugin the adapter. Do so and Dolphin will be able to read the adapter after that. | ||
= Dolphin Setup = | = Dolphin Setup = | ||
The left slot on the adapter (while engraved "Wii U" facing up) is the first port, and so on, so don't mistake it for being the other way around! | |||
=== Before Dolphin 4.0-4599 === | === Before Dolphin 4.0-4599 === | ||
| Line 93: | Line 104: | ||
* DK Bongo controllers are supported. With DK Bongo controllers plugged in, select "TaruKonga (Bongos)" in the Controller Settings. | * DK Bongo controllers are supported. With DK Bongo controllers plugged in, select "TaruKonga (Bongos)" in the Controller Settings. | ||
* 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). | * 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). | ||
=== Dolphin 4.0-8601 and Newer === | === Dolphin 4.0-8601 and Newer === | ||
With any necessary installation complete, run Dolphin and click the GameCube controller dropdown. Select GameCube Adapter for Wii U on any slot that you wish to use the adapter for. Hitting Configure when this is selected allows you to turn rumble off/on per controller, as well as a toggle for using the DK Bongos. | |||
Unlike 4.0-8593 and before, you will have to choose between '''GameCube Adapter for Wii U''' or '''Standard Controller''' for a real GameCube controller or the device emulating a GameCube controller. The hot-plug properties are also removed. | |||
=== Adapter Not Detected === | === Adapter Not Detected === | ||