Progress Continues
We've already had 21453 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. |
Bluetooth Passthrough: Difference between revisions
(→Adapter test results: cleanup time, part 3: purged range column, separated Intel cards again as I couldn't find any reliable source confirming they use the same BT chip, fixed AR3012 to the proper WiFi card model and chipset (AR3012 is USB only)) |
(→Adapter test results: adapter name declutter attempt 1, might reverse later) |
||
Line 88: | Line 88: | ||
{|class="wikitable sortable" | {|class="wikitable sortable" | ||
! Adapter | ! Adapter | ||
! Type | |||
! <abbr title="Supported Bluetooth Version">BT</abbr> | |||
! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! <abbr title="Hardware Revision">Rev</abbr> | ! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! <abbr title="Hardware Revision">Rev</abbr> | ||
! Works? | ! Works? | ||
Line 94: | Line 96: | ||
! Audio | ! Audio | ||
|- | |- | ||
| bgcolor="#afa" | Asus | | bgcolor="#afa" | Asus Generic Adapter [AR9462] | ||
| mPCIe || 4.0 | |||
| 0B05 || 17D0 || 0001 | | 0B05 || 17D0 || 0001 | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Asus | | bgcolor="#fda" | Asus Generic Adapter [QCA6174A] | ||
| M.2 || 4.1 | |||
| 0B05 || 1825 || 0001 | | 0B05 || 1825 || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 106: | Line 110: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Asus USB-BT400 | | bgcolor="#fda" | Asus USB-BT400 [BCM20702] | ||
| USB || 4.0 | |||
| 0B05 || 17CB || ? | | 0B05 || 17CB || ? | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 113: | Line 118: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B00DJ83070?linkCode=wey&tag=dolphin-emu-20 Asus USB-BT400 | | bgcolor="#fda" | [https://www.amazon.com/dp/B00DJ83070?linkCode=wey&tag=dolphin-emu-20 Asus USB-BT400] [BCM20702] | ||
| USB || 4.0 | |||
| 0B05 || 17CF || ? | | 0B05 || 17CF || ? | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 120: | Line 126: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#afa" | [https://www.amazon.com/dp/B003765X38?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V201 | | bgcolor="#afa" | [https://www.amazon.com/dp/B003765X38?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V201] [CSR8510] | ||
| USB || 2.1 | |||
| 0A12 || 0001 || ? | | 0A12 || 0001 || ? | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Belkin Mini | | bgcolor="#fda" | Belkin F8T065BF Mini [BCM20702] | ||
| USB || 4.0 | |||
| 050D || 065A || ? | | 050D || 065A || ? | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 132: | Line 140: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | CSL BSN23996 Mini | | bgcolor="#fda" | CSL BSN23996 Mini [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 139: | Line 148: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | E-Blue Mini Nova EBA012V00 | | bgcolor="#fda" | E-Blue Mini Nova EBA012V00 [CSR8510] | ||
| USB || 2.1 | |||
| 0A12 || 0001 || ? | | 0A12 || 0001 || ? | ||
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | ||
Line 145: | Line 155: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Foxconn T77H348.02 | | bgcolor="#fda" | Foxconn T77H348.02 [AR9462] | ||
| mPCIe || 4.0 | |||
| 0489 || E04E || 0001 | | 0489 || E04E || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 152: | Line 163: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B01EZTR2G6 Gembird BTD-MINI5 | | bgcolor="#fda" | [https://www.amazon.com/dp/B01EZTR2G6 Gembird BTD-MINI5] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 160: | Line 172: | ||
|- | |- | ||
| bgcolor="#faa" | Generic Bluetooth Adapter [CSR8510] | | bgcolor="#faa" | Generic Bluetooth Adapter [CSR8510] | ||
| USB || ? | |||
| 0A12 || 0001 || 3164 | | 0A12 || 0001 || 3164 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 165: | Line 178: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Generic Bluetooth | | bgcolor="#fda" | Generic Bluetooth Adapter [IS1032N] | ||
| USB || 2.0 | |||
| 1131 || 1004 || 0373 | | 1131 || 1004 || 0373 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 172: | Line 186: | ||
| Short range | | Short range | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B01HRZCDEG?linkCode=wey&tag=dolphin-emu-20 Generic Bluetooth | | bgcolor="#fda" | [https://www.amazon.com/dp/B01HRZCDEG?linkCode=wey&tag=dolphin-emu-20 Generic Bluetooth Adapter] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 179: | Line 194: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#faa" | [https://www.amazon.com/dp/B00F85ZPIY?linkCode=wey&tag=dolphin-emu-20 GMYLE Ultra-Mini | | bgcolor="#faa" | [https://www.amazon.com/dp/B00F85ZPIY?linkCode=wey&tag=dolphin-emu-20 GMYLE Ultra-Mini CSR4.0] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 186: | Line 202: | ||
| Average | | Average | ||
|- | |- | ||
| bgcolor="#fda" | Intel Dual Band Wireless-AC 3160 | | bgcolor="#fda" | Intel Dual Band Wireless-AC 3160 | ||
| M.2 || 4.0 | |||
| 8087 || 07DC || 0001 | | 8087 || 07DC || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 193: | Line 210: | ||
| Good | | Good | ||
|- | |- | ||
| Intel Dual Band Wireless-AC 3165 | | Intel Dual Band Wireless-AC 3165 | ||
| M.2 || 4.2 | |||
| 8087 || 0A2A || 0001 | | 8087 || 0A2A || 0001 | ||
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | ||
Line 199: | Line 217: | ||
| ? | | ? | ||
|- | |- | ||
| bgcolor="#fda" | Intel Dual Band Wireless-AC 7260 | | bgcolor="#fda" | Intel Dual Band Wireless-AC 7260 | ||
| M.2 || 4.0 | |||
| 8087 || 07DC || 0001 | | 8087 || 07DC || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 206: | Line 225: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Intel Wireless-AC 9260 | | bgcolor="#fda" | Intel Wireless-AC 9260 | ||
| M.2 || 5.0 | |||
| 8087 || 0025 || 0002 | | 8087 || 0025 || 0002 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 213: | Line 233: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#afa" | [https://www.amazon.com/dp/B0018O9JIG?linkCode=wey&tag=dolphin-emu-20 IOGear GBU421 | | bgcolor="#afa" | [https://www.amazon.com/dp/B0018O9JIG?linkCode=wey&tag=dolphin-emu-20 IOGear GBU421] [BCM2046] | ||
| USB || 2.1 | |||
| 0A5C || 2148 || ? | | 0A5C || 2148 || ? | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B007GFX0PY?linkCode=wey&tag=dolphin-emu-20 IOGear GBU521 | | bgcolor="#fda" | [https://www.amazon.com/dp/B007GFX0PY?linkCode=wey&tag=dolphin-emu-20 IOGear GBU521] [BCM20702] | ||
| USB || 4.0 | |||
| 0A5C || 21E8 || 0112 | | 0A5C || 21E8 || 0112 | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 225: | Line 247: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Kinivo BTD-300 | | bgcolor="#fda" | Kinivo BTD-300 [BCM2070] | ||
| USB || 3.0 | |||
| 0A5C || 2198 || 0391 | | 0A5C || 2198 || 0391 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 232: | Line 255: | ||
| Average | | Average | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400 | | bgcolor="#fda" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400] [BCM20702] | ||
| USB || 4.0 | |||
| 0A5C || 21E8 || 0112 | | 0A5C || 21E8 || 0112 | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 240: | Line 264: | ||
|- | |- | ||
| bgcolor="#faa" | [https://www.amazon.com/dp/B00HZWEB74?linkCode=wey&tag=dolphin-emu-20 Mayflash DolphinBar] | | bgcolor="#faa" | [https://www.amazon.com/dp/B00HZWEB74?linkCode=wey&tag=dolphin-emu-20 Mayflash DolphinBar] | ||
| bgcolor="#faa" | USB | |||
| bgcolor="#faa" colspan="8" style="text-align: center;" | Not supported <sup>[[#Notes|[9]]]</sup> | | bgcolor="#faa" colspan="8" style="text-align: center;" | Not supported <sup>[[#Notes|[9]]]</sup> | ||
|- | |- | ||
| NoteShip Bluetooth Adapter [CSR8510] | | NoteShip Bluetooth Adapter [CSR8510] | ||
| USB || ? | |||
| 0A12|| 0001 || 0100 | | 0A12|| 0001 || 0100 | ||
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="2" style="text-align: center;" | Yes | ||
Line 248: | Line 274: | ||
| ? | | ? | ||
|- | |- | ||
| bgcolor="#afa" | Nintendo Wii Bluetooth | | bgcolor="#afa" | Nintendo Wii Bluetooth Module (WML-C43) [BCM2045] | ||
| ? || 2.0 | |||
| 057E || 0305 || ? | | 057E || 0305 || ? | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#afa" | Nintendo Wii Bluetooth | | bgcolor="#afa" | Nintendo Wii Bluetooth Module (J27H002) [BCM2045] | ||
| ? || 2.0 | |||
| 057E || 0305 || ? | | 057E || 0305 || ? | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#afa" | Orico BTA-403 | | bgcolor="#afa" | Orico BTA-403 [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/dp/B0169O12UC?linkCode=wey&tag=dolphin-emu-20 Orico BTA-408 | | bgcolor="#fda" | [https://www.amazon.com/dp/B0169O12UC?linkCode=wey&tag=dolphin-emu-20 Orico BTA-408] [BCM20702] | ||
| USB || 4.0 | |||
| 0A5C || 21EC || ? | | 0A5C || 21EC || ? | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 270: | Line 300: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Plugable USB-BT4LE | | bgcolor="#fda" | Plugable USB-BT4LE [BCM20702] | ||
| USB || 4.0 | |||
| 0A5C || 21E8 || 0112 | | 0A5C || 21E8 || 0112 | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 277: | Line 308: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | Qualcomm Atheros AR5B22 | | bgcolor="#fda" | Qualcomm Atheros AR5B22 [AR9462] | ||
| mPCIe || 4.0 | |||
| 0CF3 || 3004 || 0001 | | 0CF3 || 3004 || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 284: | Line 316: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#faa" | [https://www.amazon.com/dp/B001D8CCYK?linkCode=wey&tag=dolphin-emu-20 Rocketfish RF-MRBTAD | | bgcolor="#faa" | [https://www.amazon.com/dp/B001D8CCYK?linkCode=wey&tag=dolphin-emu-20 Rocketfish RF-MRBTAD] [BCM2046] | ||
| USB || 2.1 | |||
| 0461 || 4D75 || ? | | 0461 || 4D75 || ? | ||
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | | bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]]) | ||
Line 290: | Line 323: | ||
| ? | | ? | ||
|- | |- | ||
| bgcolor="#afa" | [http://www.senanetworks.com/ud100-g03.html?sc=14&category=3968 Sena Networks Parani-UD100 | | bgcolor="#afa" | [http://www.senanetworks.com/ud100-g03.html?sc=14&category=3968 Sena Networks Parani-UD100] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8241 | | 0A12 || 0001 || 8241 | ||
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | | bgcolor="#afa" colspan="3" style="text-align: center;" | Yes | ||
Line 296: | Line 330: | ||
|- | |- | ||
| bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter [BCM????] | | bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter [BCM????] | ||
| ? || ? | |||
| 0C10 || 0000 || 1915 | | 0C10 || 0000 || 1915 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 302: | Line 337: | ||
| ? | | ? | ||
|- | |- | ||
| [https://www.amazon.com/dp/B00F25Z0FS?linkCode=wey&tag=dolphin-emu-20 SoundBot SB340 | | [https://www.amazon.com/dp/B00F25Z0FS?linkCode=wey&tag=dolphin-emu-20 SoundBot SB340] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || ? | | 0A12 || 0001 || ? | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 309: | Line 345: | ||
| Good | | Good | ||
|- | |- | ||
| Trendnet TBW-106UB | | Trendnet TBW-106UB [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || 8891 | | 0A12 || 0001 || 8891 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 317: | Line 354: | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.trust.com/en/product/17772-bluetooth-3-0-usb-adapter Trust Bluetooth 3.0 Adapter] [AR3011] | | bgcolor="#fda" | [https://www.trust.com/en/product/17772-bluetooth-3-0-usb-adapter Trust Bluetooth 3.0 Adapter] [AR3011] | ||
| USB || 3.0 | |||
| 0CF3 || 3002 || 0001 | | 0CF3 || 3002 || 0001 | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes | ||
Line 323: | Line 361: | ||
| Good | | Good | ||
|- | |- | ||
| bgcolor="#fda" | [https://www.amazon.com/UGREEN-Bluetooth-Wireless-Receiver-Keyboards/dp/B01LX6HISL UGREEN Bluetooth | | bgcolor="#fda" | [https://www.amazon.com/UGREEN-Bluetooth-Wireless-Receiver-Keyboards/dp/B01LX6HISL UGREEN Bluetooth USB Adapter] [CSR8510] | ||
| USB || 4.0 | |||
| 0A12 || 0001 || ? | | 0A12 || 0001 || ? | ||
| bgcolor="#afa" | Yes | | bgcolor="#afa" | Yes |
Revision as of 20:27, 18 December 2019
Since 5.0-910, Dolphin has the ability to passthrough a Bluetooth adapter for emulated Wii software. This gives emulated Wii software full control of a Bluetooth adapter, which, provided a decent, working adapter, notably allows pairing Wii Remotes to Dolphin, third-party Wii Remote support, working Wii Remote audio and more accurate connectivity.
Limitations
- The functionality and quality of the connections heavily depend on the quality of the adapter.
- Even though most adapters work fine in passthrough mode, the only perfect adapter is the Wii's Bluetooth module (so far).
- Save states can be used with some limitations.
- Because Bluetooth Passthrough Mode skips Dolphin's emulated Bluetooth and Wii Remote code entirely, it is not possible to mix passthrough mode and emulated/real Wii Remote. This means that netplay, TAS input, input display, etc. cannot work.
Setting up
Linux
A udev rule has to be installed so Dolphin can use a Bluetooth adapter without having to get root privileges.
SUBSYSTEM=="usb", ATTRS{idVendor}=="YOURVID", ATTRS{idProduct}=="YOURPID", TAG+="uaccess"
Dolphin should be able to automatically unload the USB Bluetooth kernel module (assuming you have permission to; you typically need to be in the plugdev
group). If not, unload it with modprobe -r btusb
.
Windows
WARNING: While a libusb driver is installed, other programs/devices will not be able to use your Bluetooth device. This can be easily reverted in Windows Device Manager and instructions are provided below.
Download and open Zadig as Administrator, then:
- In the "Options" menu in Zadig, make sure "List All Devices" is enabled.
- Look through the devices for the device to passthrough.
- On the right column, select "libusbk" or then click "Replace Driver". Select "Yes" to modify the system driver.
If you wish to return your Bluetooth back to normal, start "Device Manager" and locate "libusbK" devices in the list. Right click the device you wish to restore and uninstall device. Upon plugging it in next time, Windows will install the default Bluetooth driver and it will continue functioning per normal. NOTE: If you used the winUSB driver instead, it will be located under "Universal Serial Bus Devices." Same instructions apply otherwise.
If Dolphin is unable to use your Bluetooth device after doing this, it may not have the necessary hardware features. You can attempt to use the "winUSB" driver from zadig as a last ditch effort.
usbdk
As of 5.0-10617 usbdk is no longer supported.
Some users who wish to maintain use of their Bluetooth Device and use it in Dolphin without swapping drivers have opted to use usbdk. When Dolphin starts up, you will lose control of your Bluetooth Device and regain it when Dolphin is shutdown. While this cuts down on the work if you need to use your Bluetooth device across many controllers, usbdk has many bugs. The worst of which is that any ES_Launch will immediately crash freeze the game due to usbdk losing control of the Bluetooth.
macOS
There is currently no way to use this feature on versions newer than 10.9, because Apple removed the ability to unload the Bluetooth kernel module.
A potential solution would be to force the OS to ignore the adapter with a codeless .kext, but this hasn't been tried yet.
Android
This feature is not supported on Android.
Using passthrough mode in Dolphin
In Dolphin, open the Controller Configuration dialog, then select the "Passthrough a Bluetooth adapter" option in the Wii Remotes section.
While a game is running:
- Wii Remotes can be synced and paired to Dolphin by using the Sync button.
- All saved Wii Remote pairings can be reset by using the Reset button. This will also disconnect all currently connected Wii Remotes.
Advanced usage
Sync button hotkey
It is possible to use the "Press Sync Button" hotkey as an alternative to the buttons in the controller configuration dialog.
You will need to map "Press Sync Button" to a key or combination of keys. This can be done within Dolphin by left clicking on the "Hotkey Settings" tab under "Options" to bring up the appropriate configuration menu. You must then left click on the "Wii and Wii Remote" tab and left click on the box for "Press Sync Button" to map this hotkey.
"Press Sync Button" is designed to work just like the Wii's red sync button:
- Pressing the hotkey will trigger a sync.
- Holding the hotkey for 10 seconds will clear all saved pairings.
Forcing a specific adapter
If you need to use a specific adapter, instead of using the first Bluetooth adapter that is found, you can force Dolphin to use it by editing Dolphin's configuration file (Config/Dolphin.ini). In the BluetoothPassthrough section, set "VID" and "PID" to your adapter's vendor ID and product ID. These values should be converted from hex to decimal, for example a VID of "057E" should be inputted as "1406".
Troubleshooting
"Failed to open Bluetooth device: LIBUSB_ERROR_ACCESS"
This error means that Dolphin doesn't have permission to use the Bluetooth adapter.
If on Linux, make sure the udev rule is set up correctly.
"Failed to open Bluetooth device: LIBUSB_ERROR_NOT_SUPPORTED"
On Windows, this typically means that the libusb/WinUSB driver was not installed for the adapter.
"Failed to detach kernel driver for BT passthrough"
Dolphin tried to automatically unload the Bluetooth USB kernel module and failed to. Unload the module manually before starting a game to avoid this issue.
Wii Remotes do not stay paired after closing the game
This means that your adapter is likely broken and does not remember Wii Remote link keys properly. Use a different adapter to avoid this issue.
This may also happen if your SYSCONF is corrupted or if you changed to a Dolphin version which doesn't have BT passthrough. If your adapter is listed as working with pairing or if you're sure it supports pairings (by having checked the HCI command replies), you can try deleting Wii/shared2/sys/SYSCONF and Wii/btdinf.bak.
Black screen on boot
Games send a reset command to the Bluetooth adapter when they start and wait for it to be acknowledged. If you are getting a black screen for a long time (more than 10 seconds), your adapter may be stuck in a broken state and is unable to respond to any commands. Unplug the adapter and try again.
No usable adapter found
This can happen with some adapters. You'll need to force your adapter to be used.
Adapter test results
Adapter | Type | BT | VID | PID | Rev | Works? | Stable? | Remembers pairings? | Audio |
---|---|---|---|---|---|---|---|---|---|
Asus Generic Adapter [AR9462] | mPCIe | 4.0 | 0B05 | 17D0 | 0001 | Yes | Good | ||
Asus Generic Adapter [QCA6174A] | M.2 | 4.1 | 0B05 | 1825 | 0001 | Yes | Limited [3] | Yes | Good |
Asus USB-BT400 [BCM20702] | USB | 4.0 | 0B05 | 17CB | ? | Yes (Forced) | Limited [2] | No | Good |
Asus USB-BT400 [BCM20702] | USB | 4.0 | 0B05 | 17CF | ? | Yes (Forced) | Limited [3] | Limited [8] | Good |
Azio BTD-V201 [CSR8510] | USB | 2.1 | 0A12 | 0001 | ? | Yes | Good | ||
Belkin F8T065BF Mini [BCM20702] | USB | 4.0 | 050D | 065A | ? | Yes (Forced) | Limited [1] | No | Good |
CSL BSN23996 Mini [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | Limited [2] | Yes | Good |
E-Blue Mini Nova EBA012V00 [CSR8510] | USB | 2.1 | 0A12 | 0001 | ? | Yes | No | Good | |
Foxconn T77H348.02 [AR9462] | mPCIe | 4.0 | 0489 | E04E | 0001 | Yes | Limited [1] | No | Good |
Gembird BTD-MINI5 [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | Limited [1] | No | Good |
Generic Bluetooth Adapter [CSR8510] | USB | ? | 0A12 | 0001 | 3164 | Yes | No | Good | |
Generic Bluetooth Adapter [IS1032N] | USB | 2.0 | 1131 | 1004 | 0373 | Yes | Limited [5] | Limited [7] | Short range |
Generic Bluetooth Adapter [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | Limited [2] | Limited [7] | Good |
GMYLE Ultra-Mini CSR4.0 [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | Limited [1] | No | Average |
Intel Dual Band Wireless-AC 3160 | M.2 | 4.0 | 8087 | 07DC | 0001 | Yes | Limited [6] | Yes | Good |
Intel Dual Band Wireless-AC 3165 | M.2 | 4.2 | 8087 | 0A2A | 0001 | Yes | ? | ? | |
Intel Dual Band Wireless-AC 7260 | M.2 | 4.0 | 8087 | 07DC | 0001 | Yes | Limited [6] | Yes | Good |
Intel Wireless-AC 9260 | M.2 | 5.0 | 8087 | 0025 | 0002 | Yes | Limited [6] | Limited [7] | Good |
IOGear GBU421 [BCM2046] | USB | 2.1 | 0A5C | 2148 | ? | Yes | Good | ||
IOGear GBU521 [BCM20702] | USB | 4.0 | 0A5C | 21E8 | 0112 | Yes (Forced) | Yes | No | Good |
Kinivo BTD-300 [BCM2070] | USB | 3.0 | 0A5C | 2198 | 0391 | Yes | Limited [1] | Yes | Average |
Kinivo BTD-400 [BCM20702] | USB | 4.0 | 0A5C | 21E8 | 0112 | Yes (Forced) | Limited [1] | Yes | Average |
Mayflash DolphinBar | USB | Not supported [9] | |||||||
NoteShip Bluetooth Adapter [CSR8510] | USB | ? | 0A12 | 0001 | 0100 | Yes | ? | ? | |
Nintendo Wii Bluetooth Module (WML-C43) [BCM2045] | ? | 2.0 | 057E | 0305 | ? | Yes | Good | ||
Nintendo Wii Bluetooth Module (J27H002) [BCM2045] | ? | 2.0 | 057E | 0305 | ? | Yes | Good | ||
Orico BTA-403 [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | Good | ||
Orico BTA-408 [BCM20702] | USB | 4.0 | 0A5C | 21EC | ? | Yes (Forced) | Limited [3] | Yes | Good |
Plugable USB-BT4LE [BCM20702] | USB | 4.0 | 0A5C | 21E8 | 0112 | Yes (Forced) | Limited [3] | Yes | Good |
Qualcomm Atheros AR5B22 [AR9462] | mPCIe | 4.0 | 0CF3 | 3004 | 0001 | Yes | Limited [4] | Yes | Good |
Rocketfish RF-MRBTAD [BCM2046] | USB | 2.1 | 0461 | 4D75 | ? | Yes (Forced) | No | ? | |
Sena Networks Parani-UD100 [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8241 | Yes | Good | ||
Silicon Wave Bluetooth Wireless Adapter [BCM????] | ? | ? | 0C10 | 0000 | 1915 | Yes | Limited [2] | Yes | ? |
SoundBot SB340 [CSR8510] | USB | 4.0 | 0A12 | 0001 | ? | Yes | ? | ? | Good |
Trendnet TBW-106UB [CSR8510] | USB | 4.0 | 0A12 | 0001 | 8891 | Yes | ? | No | Average |
Trust Bluetooth 3.0 Adapter [AR3011] | USB | 3.0 | 0CF3 | 3002 | 0001 | Yes | Limited [4][6] | No | Good |
UGREEN Bluetooth USB Adapter [CSR8510] | USB | 4.0 | 0A12 | 0001 | ? | Yes | Yes [10] | Good |
- Unknown. Not enough information to classify.
- Incompatible. Does not work or has significant limitations.
- Partially compatible. Works well in most cases, but there may be some issues.
- Fully compatible. Works well in all cases and will give the same experience as a Wii Bluetooth adapter.
Stability
- [1] May stop working after HCI resets (stopping, resetting emulation or going back to the system menu).
- [2] Has issues with games which send a lot of commands (including New Super Mario Bros. Wii and The Legend of Zelda: Skyward Sword before you get in game).
- [3] Starts having lag issues after ~30 minutes. Reconnecting the Wii remote is required.
- [4] May stop working after HCI resets on Windows, works fine on Linux and macOS.
- [5] Randomly stop working on Windows, works fine on Linux and macOS.
- [6] Has issues connecting multiple Wiimotes.
Pairing
- [7] Has issues reconnecting multiple Wiimotes.
- [8] Limited to 1 remote.
Other
- [9] Doesn't expose its internal Bluetooth adapter, can't be used with Bluetooth Passthrough in any capacity.
- [10] Needs further testing.