Difference between revisions of "Bluetooth Passthrough"

From Dolphin Emulator Wiki
Jump to: navigation, search
m (Adapter test results: this should handle all Broadcom adapters from the list (couldn't find any information about 21EC and 2198 Broadcom PIDs, though))
(Adapter test results: cleanup time, part 2: purged broken links, updated most adapters to its commercial names (still needs improvement, looks cluttered) and found most OEM-customized Atheros and Broadcom HW IDs. Intel adapters should be the next...)
Line 88: Line 88:
 
{|class="wikitable sortable"
 
{|class="wikitable sortable"
 
! Adapter
 
! Adapter
! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! Revision
+
! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! <abbr title="Hardware Revision">Rev</abbr>
 
! Works?
 
! Works?
 
! Stable?
 
! Stable?
Line 95: Line 95:
 
! Range
 
! Range
 
|-
 
|-
| bgcolor="#fda" | Asus BT-400 [BCM20702]
+
| bgcolor="#afa" | Asus Bluetooth 4.0 Adapter [AR9462]
 +
| 0B05 || 17D0 || 0001
 +
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 +
| Good
 +
| Very long
 +
|-
 +
| bgcolor="#fda" | Asus Bluetooth 4.1 Adapter [QCA6174A]
 +
| 0B05 || 1825 || 0001
 +
| bgcolor="#afa" | Yes
 +
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
 +
| bgcolor="#afa" | Yes
 +
| Good
 +
| Very long
 +
|-
 +
| bgcolor="#fda" | Asus USB-BT400 Bluetooth 4.0 Adapter [BCM20702]
 
| 0B05 || 17CB || ?
 
| 0B05 || 17CB || ?
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 103: Line 117:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B00DJ83070?linkCode=wey&tag=dolphin-emu-20 Asus BT-400] [BCM20702]
+
| bgcolor="#fda" | [https://www.amazon.com/dp/B00DJ83070?linkCode=wey&tag=dolphin-emu-20 Asus USB-BT400 Bluetooth 4.0 Adapter] [BCM20702]
 
| 0B05 || 17CF || ?
 
| 0B05 || 17CF || ?
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 111: Line 125:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#fda" | [https://www.trust.com/en/product/17772-bluetooth-3-0-usb-adapter Trust BT 3.0 (Qualcomm Atheros AR3011)]
+
| bgcolor="#afa" | [https://www.amazon.com/dp/B003765X38?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V201 Bluetooth 2.1 Adapter] [CSR8510]
| 0CF3 || 3002 || 0001
 
| bgcolor="#afa" | Yes
 
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]][[#Notes|[6]]]</sup>
 
| bgcolor="#faa" | No
 
| Good
 
| Average
 
|-
 
| bgcolor="#fda" | Atheros AR3012 (AR9462)
 
| 0CF3 || 3004 || 0001
 
| bgcolor="#afa" | Yes
 
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]]</sup>
 
| bgcolor="#afa" | Yes
 
| Good
 
| Very long
 
|-
 
| bgcolor="#afa" | Atheros AR9462
 
| 0B05 || 17D0 || 0001
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| Good
 
| Very long
 
|-
 
| bgcolor="#afa" | [https://www.amazon.com/dp/B003765X38?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V201] [CSR8510]
 
 
| 0A12 || 0001 || ?
 
| 0A12 || 0001 || ?
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
Line 139: Line 131:
 
| Long
 
| Long
 
|-
 
|-
| bgcolor="#fda" | Belkin Mini BT 4.0 Adapter
+
| bgcolor="#fda" | Belkin Mini Bluetooth 4.0 Adapter [BCM20702]
 
| 050D || 065A || ?
 
| 050D || 065A || ?
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 147: Line 139:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#fda" | CSL BSN23996 [CSR8510]
+
| bgcolor="#fda" | CSL BSN23996 Mini Bluetooth 4.0 Adapter [CSR8510]
 
| 0A12 || 0001 || 8891
 
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 155: Line 147:
 
| Long
 
| Long
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B01EZTR2G6 Gembird BTD-MINI5] [CSR8510]
+
| bgcolor="#fda" | E-Blue Mini Nova EBA012V00 Bluetooth 2.1 Adapter [CSR8510]
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" | Yes
 
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
 
| bgcolor="#faa" | No
 
| Good
 
| Long
 
|-
 
| bgcolor="#fda" | CSR Generic Bluetooth EDR Mini Nova E Blue 2.1 [CSR8510]
 
 
| 0A12 || 0001 || ?
 
| 0A12 || 0001 || ?
 
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
 
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
Line 170: Line 154:
 
| Average
 
| Average
 
|-
 
|-
| bgcolor="#fda" | Foxconn T77H348.02 (AR9462)
+
| bgcolor="#fda" | Foxconn T77H348.02 Bluetooth 4.0 [AR9462]
 
| 0489 || E04E || 0001
 
| 0489 || E04E || 0001
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 178: Line 162:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#faa" | Generic Adapter [CSR8510]
+
| bgcolor="#fda" | [https://www.amazon.com/dp/B01EZTR2G6 Gembird BTD-MINI5 Bluetooth 4.0 Adapter] [CSR8510]
 +
| 0A12 || 0001 || 8891
 +
| bgcolor="#afa" | Yes
 +
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
 +
| bgcolor="#faa" | No
 +
| Good
 +
| Long
 +
|-
 +
| bgcolor="#faa" | Generic Bluetooth Adapter [CSR8510]
 
| 0A12 || 0001 || 3164
 
| 0A12 || 0001 || 3164
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 185: Line 177:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B01HRZCDEG?linkCode=wey&tag=dolphin-emu-20 Generic Adapter] [CSR8510]
+
| bgcolor="#fda" | Generic Bluetooth 2.0 Adapter [IS1032N]
 +
| 1131 || 1004 || 0373
 +
| bgcolor="#afa" | Yes
 +
| bgcolor="#fda" | Limited <sup>[[#Notes|[5]]]</sup>
 +
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
 +
| Short range
 +
| Average
 +
|-
 +
| bgcolor="#fda" | [https://www.amazon.com/dp/B01HRZCDEG?linkCode=wey&tag=dolphin-emu-20 Generic Bluetooth 4.0 Adapter] [CSR8510]
 
| 0A12 || 0001 || 8891
 
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 193: Line 193:
 
| Long
 
| Long
 
|-
 
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B00F85ZPIY?linkCode=wey&tag=dolphin-emu-20 GMYLE Ultra-Mini USB CSR4.0] [CSR8510]
+
| bgcolor="#faa" | [https://www.amazon.com/dp/B00F85ZPIY?linkCode=wey&tag=dolphin-emu-20 GMYLE Ultra-Mini CSR Bluetooth 4.0 Adapter] [CSR8510]
 
| 0A12 || 0001 || 8891
 
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 225: Line 225:
 
| Very Long
 
| Very Long
 
|-
 
|-
| bgcolor="#afa" | [https://www.amazon.com/dp/B0018O9JIG?linkCode=wey&tag=dolphin-emu-20 IOGear GBU421] [BCM92046DG]
+
| bgcolor="#afa" | [https://www.amazon.com/dp/B0018O9JIG?linkCode=wey&tag=dolphin-emu-20 IOGear GBU421 Bluetooth 2.1 Adapter] [BCM2046]
 
| 0A5C || 2148 || ?
 
| 0A5C || 2148 || ?
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
Line 231: Line 231:
 
| Long
 
| Long
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B007GFX0PY?linkCode=wey&tag=dolphin-emu-20 IOGear GBU521] [BCM20702]
+
| bgcolor="#fda" | [https://www.amazon.com/dp/B007GFX0PY?linkCode=wey&tag=dolphin-emu-20 IOGear GBU521 Bluetooth 4.0 Adapter] [BCM20702]
 
| 0A5C || 21E8 || 0112
 
| 0A5C || 21E8 || 0112
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 239: Line 239:
 
| Long
 
| Long
 
|-
 
|-
| bgcolor="#fda" | ISSC EDR Bluetooth Adapter
+
| bgcolor="#fda" | Kinivo BTD-300 Bluetooth 3.0 Adapter [BCM2070]
| 1131 || 1004 || 0373
 
| bgcolor="#afa" | Yes
 
| bgcolor="#fda" | Limited <sup>[[#Notes|[5]]]</sup>
 
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
 
| Short range
 
| Average
 
|-
 
| bgcolor="#fda" | [https://www.amazon.com/dp/B005Z5HT2M?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-300]
 
 
| 0A5C || 2198 || 0391
 
| 0A5C || 2198 || 0391
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 255: Line 247:
 
| Average
 
| Average
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400] [BCM20702]
+
| bgcolor="#fda" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400 Bluetooth 4.0 Adapter] [BCM20702]
 
| 0A5C || 21E8 || 0112
 
| 0A5C || 21E8 || 0112
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 273: Line 265:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#afa" | Orico BTA-403 [CSR8510]
+
| bgcolor="#afa" | Nintendo Wii Bluetooth 2.0 Module (WML-C43) [BCM2045]
 +
| 057E || 0305 || ?
 +
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 +
| Good
 +
| Very long
 +
|-
 +
| bgcolor="#afa" | Nintendo Wii Bluetooth 2.0 Module (J27H002) [BCM2045]
 +
| 057E || 0305 || ?
 +
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 +
| Good
 +
| Very long
 +
|-
 +
| bgcolor="#afa" | Orico BTA-403 Bluetooth 4.0 Adapter [CSR8510]
 
| 0A12 || 0001 || 8891
 
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
Line 279: Line 283:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B0169O12UC?linkCode=wey&tag=dolphin-emu-20 Orico BTA-408] [BCM20702]
+
| bgcolor="#fda" | [https://www.amazon.com/dp/B0169O12UC?linkCode=wey&tag=dolphin-emu-20 Orico BTA-408 Bluetooth 4.0 Adapter] [BCM20702]
 
| 0A5C || 21EC || ?
 
| 0A5C || 21EC || ?
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 287: Line 291:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#fda" | Plugable USB 2.0 Bluetooth Adapter [BCM20702]
+
| bgcolor="#fda" | Plugable USB-BT4LE Bluetooth 4.0 Adapter [BCM20702]
 
| 0A5C || 21E8 || 0112
 
| 0A5C || 21E8 || 0112
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 295: Line 299:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#fda" | Qualcomm Atheros QCA61x4A
+
| bgcolor="#fda" | Qualcomm Atheros AR3012 Bluetooth 4.0 Adapter
| 0B05 || 1825 || 0001
+
| 0CF3 || 3004 || 0001
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
+
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]]</sup>
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
 
| Good
 
| Good
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B001D8CCYK?linkCode=wey&tag=dolphin-emu-20 Rocketfish Bluetooth Adapter]
+
| bgcolor="#faa" | [https://www.amazon.com/dp/B001D8CCYK?linkCode=wey&tag=dolphin-emu-20 Rocketfish RF-MRBTAD Bluetooth 2.1 Adapter] [BCM2046]
 
| 0461 || 4D75 || ?
 
| 0461 || 4D75 || ?
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
 
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
Line 310: Line 314:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#afa" | [http://www.senanetworks.com/ud100-g03.html?sc=14&category=3968 Sena UD100 Bluetooth Adapter] [CSR8510]
+
| bgcolor="#afa" | [http://www.senanetworks.com/ud100-g03.html?sc=14&category=3968 Sena Networks Parani-UD100 Bluetooth 4.0 Adapter] [CSR8510]
 
| 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 316: Line 320:
 
| Very long
 
| Very long
 
|-
 
|-
| bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter
+
| bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter [BCM????]
 
| 0C10 || 0000 || 1915
 
| 0C10 || 0000 || 1915
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 324: Line 328:
 
| ?
 
| ?
 
|-
 
|-
| [https://www.amazon.com/dp/B00F25Z0FS?linkCode=wey&tag=dolphin-emu-20 SoundBot SB340] [CSR8510]
+
| [https://www.amazon.com/dp/B00F25Z0FS?linkCode=wey&tag=dolphin-emu-20 SoundBot SB340 Bluetooth 4.0 Adapter] [CSR8510]
 
| 0A12 || 0001 || ?
 
| 0A12 || 0001 || ?
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 332: Line 336:
 
| Long
 
| Long
 
|-
 
|-
| Trendnet TBW-106UB [CSR8510]
+
| Trendnet TBW-106UB Bluetooth 4.0 Adapter [CSR8510]
 
| 0A12 || 0001 || 8891
 
| 0A12 || 0001 || 8891
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 340: Line 344:
 
| ?
 
| ?
 
|-
 
|-
| bgcolor="#fda" | [https://www.amazon.com/UGREEN-Bluetooth-Wireless-Receiver-Keyboards/dp/B01LX6HISL UGREEN Bluetooth USB Adapter] [CSR8510]
+
| bgcolor="#fda" | [https://www.trust.com/en/product/17772-bluetooth-3-0-usb-adapter Trust Bluetooth 3.0 Adapter] [AR3011]
 +
| 0CF3 || 3002 || 0001
 +
| bgcolor="#afa" | Yes
 +
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]][[#Notes|[6]]]</sup>
 +
| bgcolor="#faa" | No
 +
| Good
 +
| Average
 +
|-
 +
| bgcolor="#fda" | [https://www.amazon.com/UGREEN-Bluetooth-Wireless-Receiver-Keyboards/dp/B01LX6HISL UGREEN Bluetooth 4.0 Adapter] [CSR8510]
 
| 0A12 || 0001 || ?
 
| 0A12 || 0001 || ?
 
| bgcolor="#afa" | Yes
 
| bgcolor="#afa" | Yes
Line 346: Line 358:
 
| Good
 
| Good
 
| Long
 
| Long
|-
 
| bgcolor="#afa" | [http://www.ebay.com/itm/BRAND-NEW-BLUETOOTH-WML-C43-PCB-CIRCUIT-BOARD-FOR-NINTENDO-Wii-VH55-/380860957466 Wii Bluetooth Module (WML-C43)] [BCM2045]
 
| 057E || 0305 || ?
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| Good
 
| Very long
 
|-
 
| bgcolor="#afa" | [http://www.ebay.com/itm/Wii-OEM-Nintendo-Wii-Bluetooth-BT-Board-J27H002-Replacement-/161905837348 Wii Bluetooth Module (J27H002)] [BCM2045]
 
| 057E || 0305 || ?
 
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
 
| Good
 
| Very long
 
 
|}
 
|}
  

Revision as of 01:40, 16 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:

  1. In the "Options" menu in Zadig, make sure "List All Devices" is enabled.
  2. Look through the devices for the device to passthrough.
  3. 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 VID PID Rev Works? Stable? Remembers pairings? Audio Range
Asus Bluetooth 4.0 Adapter [AR9462] 0B05 17D0 0001 Yes Good Very long
Asus Bluetooth 4.1 Adapter [QCA6174A] 0B05 1825 0001 Yes Limited [3] Yes Good Very long
Asus USB-BT400 Bluetooth 4.0 Adapter [BCM20702] 0B05 17CB  ? Yes (Forced) Limited [2] No Good  ?
Asus USB-BT400 Bluetooth 4.0 Adapter [BCM20702] 0B05 17CF  ? Yes (Forced) Limited [3] Limited [8] Good Very long
Azio BTD-V201 Bluetooth 2.1 Adapter [CSR8510] 0A12 0001  ? Yes Good Long
Belkin Mini Bluetooth 4.0 Adapter [BCM20702] 050D 065A  ? Yes (Forced) Limited [1] No Good  ?
CSL BSN23996 Mini Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes Limited [2] Yes Good Long
E-Blue Mini Nova EBA012V00 Bluetooth 2.1 Adapter [CSR8510] 0A12 0001  ? Yes No Good Average
Foxconn T77H348.02 Bluetooth 4.0 [AR9462] 0489 E04E 0001 Yes Limited [1] No Good Very long
Gembird BTD-MINI5 Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes Limited [1] No Good Long
Generic Bluetooth Adapter [CSR8510] 0A12 0001 3164 Yes No Good  ?
Generic Bluetooth 2.0 Adapter [IS1032N] 1131 1004 0373 Yes Limited [5] Limited [7] Short range Average
Generic Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes Limited [2] Limited [7] Good Long
GMYLE Ultra-Mini CSR Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes Limited [1] No Average Short
Intel Dual Band Wireless-AC 3160/7260 (Wilkins Peak) 8087 07DC 0001 Yes Limited [6] Yes Good Long
Intel Dual Band Wireless-AC 3165/7265 (Stony Ridge) 8087 0A2A 0001 Yes  ?  ?  ?
Intel Wireless-AC 9260 8087 0025 0002 Yes Limited [6] Limited [7] Good Very Long
IOGear GBU421 Bluetooth 2.1 Adapter [BCM2046] 0A5C 2148  ? Yes Good Long
IOGear GBU521 Bluetooth 4.0 Adapter [BCM20702] 0A5C 21E8 0112 Yes (Forced) Yes No Good Long
Kinivo BTD-300 Bluetooth 3.0 Adapter [BCM2070] 0A5C 2198 0391 Yes Limited [1] Yes Average Average
Kinivo BTD-400 Bluetooth 4.0 Adapter [BCM20702] 0A5C 21E8 0112 Yes (Forced) Limited [1] Yes Average Very long
Mayflash DolphinBar Not supported [9]
NoteShip Bluetooth Adapter [CSR8510] 0A12 0001 0100 Yes  ?  ?  ?
Nintendo Wii Bluetooth 2.0 Module (WML-C43) [BCM2045] 057E 0305  ? Yes Good Very long
Nintendo Wii Bluetooth 2.0 Module (J27H002) [BCM2045] 057E 0305  ? Yes Good Very long
Orico BTA-403 Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes Good Very long
Orico BTA-408 Bluetooth 4.0 Adapter [BCM20702] 0A5C 21EC  ? Yes (Forced) Limited [3] Yes Good Very long
Plugable USB-BT4LE Bluetooth 4.0 Adapter [BCM20702] 0A5C 21E8 0112 Yes (Forced) Limited [3] Yes Good Very long
Qualcomm Atheros AR3012 Bluetooth 4.0 Adapter 0CF3 3004 0001 Yes Limited [4] Yes Good Very long
Rocketfish RF-MRBTAD Bluetooth 2.1 Adapter [BCM2046] 0461 4D75  ? Yes (Forced) No  ?  ?
Sena Networks Parani-UD100 Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8241 Yes Good Very long
Silicon Wave Bluetooth Wireless Adapter [BCM????] 0C10 0000 1915 Yes Limited [2] Yes  ?  ?
SoundBot SB340 Bluetooth 4.0 Adapter [CSR8510] 0A12 0001  ? Yes  ?  ? Good Long
Trendnet TBW-106UB Bluetooth 4.0 Adapter [CSR8510] 0A12 0001 8891 Yes  ? No Average  ?
Trust Bluetooth 3.0 Adapter [AR3011] 0CF3 3002 0001 Yes Limited [4][6] No Good Average
UGREEN Bluetooth 4.0 Adapter [CSR8510] 0A12 0001  ? Yes Yes [10] Good Long
     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.