Dolphin Emulator Wiki

Bluetooth Passthrough: Difference between revisions

Page Discussion

Bluetooth Passthrough (view source)

Revision as of 21:01, 14 April 2024

9,985 bytes added ,  14 April
→‎Adapter test results: correct TP-Link UB400 details
(the usbdk change was made optional)
(→‎Adapter test results: correct TP-Link UB400 details)
(104 intermediate revisions by 27 users not shown)
Line 1: Line 1:
Since {{revision|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.
Since {{revision|5.0-910}}, Dolphin has the ability to passthrough a Bluetooth adapter for emulated Wii software. This is a powerful option that allows for perfect Wii Remote behaviors on Dolphin, given a powerful enough Bluetooth adapter. Unlike standard Bluetooth emulation, Bluetooth Passthrough supports pairing third party Wii Remotes, Wii Remote audio, and can more accurately communicate fine motions. However, because Bluetooth Passthrough gives the Bluetooth adapter directly to the emulated software, there are heaps of limitations that make it only worthwhile for certain situations.
 
== Limitations ==
* Requires a specialized driver on Windows, and on Linux requires a udev rule. The Operating System will not be able to access the Bluetooth adapter while it is in use.
* The functionality and stability of the connection heavily depends on the compatibility of the Bluetooth adapter used.
* Even though most Bluetooth adapters can be used in passthrough mode, perfect compatibility is only guaranteed with the Bluetooth modules from Wii consoles.
* Many features do not work. Netplay, input recordings will be limited. The Wii Remote may disconnect if Dolphin is running too fast or too slow. If the Bluetooth is disconnected from your computer, Dolphin may crash.
* Save states made in Bluetooth Passthrough mode can't be loaded on "Emulate a BT Adapter" mode, nor vice-versa.
* Wii Remote connection state dictates whether save states made in Bluetooth Passthrough mode will work or not:
 
:{|class="wikitable"
! When saving state
! When loading state
! Works?
|-
| One or more Wii Remotes connected
| One or more Wii Remotes connected '''on the same session'''<sup>[[#SaveStateNotes|[1]]]</sup>
| bgcolor="#afa" | Yes
|-
| One or more Wii Remotes connected
| One or more Wii Remotes connected '''on a different session'''<sup>[[#SaveStateNotes|[1]]]</sup>
| bgcolor="#faa" | No
|-
| One or more Wii Remotes connected
| Some or all Wii Remotes disconnected
| bgcolor="#afa" | Yes<sup>[[#SaveStateNotes|[2]]]</sup>
|-
| No Wii Remotes connected
| One or more Wii Remotes connected
| bgcolor="#faa" | No
|-
| No Wii Remotes connected
| No Wii Remotes connected
| bgcolor="#afa" | Yes
|}
 
<div id="SaveStateNotes">
::<sup>[1]</sup> Same session: for instances where Wii Remotes haven't been disconnected and emulation hasn't been stopped during anywhere between saving and loading of a save state.<br/> Different session: when any one of these has been intervened.
::<sup>[2]</sup> First (re)connection will fail, subsequent connections will work. Depending of the Bluetooth adapter, it might be necessary to connect then disconnect the Wii Remotes before loading the saved state.
</div>


== Setting up ==
== Setting up ==
Line 5: Line 44:
A udev rule has to be installed so Dolphin can use a Bluetooth adapter without having to get root privileges.
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"
'''1.''' Paste the following into '''/etc/udev/rules.d/52-dolphin.rules''' (/lib/udev/rules.d/52-dolphin.rules if making a package). Replace 'YOURVID' and 'YOURPID' with the Vendor ID and Product ID respectively.
 
<code>SUBSYSTEM=="usb", ATTRS{idVendor}=="YOURVID", ATTRS{idProduct}=="YOURPID", TAG+="uaccess"</code>
 
'''2.''' Reload udev rules with:
<code>sudo udevadm control --reload-rules</code>
 
'''3.''' Reinsert the adapter.


Dolphin should be able to automatically unload the USB Bluetooth kernel module (assuming you have permission to; you typically need to be in the <code>plugdev</code> group). If not, unload it with <code>modprobe -r btusb</code>.
Dolphin should be able to automatically unload the USB Bluetooth kernel module (assuming you have permission to; you typically need to be in the <code>plugdev</code> group). If not, unload it with <code>modprobe -r btusb</code>.


=== Windows ===
=== Windows ===
Download and open [http://zadig.akeo.ie/ Zadig], then:


1. In the "Options" menu in Zadig, make sure "List All Devices" is enabled.
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 [https://zadig.akeo.ie/ Zadig] as Administrator, then:
# In the "Options" menu in Zadig, make sure "List All Devices" is enabled.
# Look through the devices for the radio to passthrough.
# On the right column, select "libusbK", then click "Replace Driver". Select "Yes" to modify the system driver.
 
If you wish to return your Bluetooth drivers back to normal, start "Device Manager" and locate "libusbK" devices in the list. Right-click the device you wish to restore and select 'Uninstall Device'. Upon plugging it in next time, Windows will install the default Bluetooth driver and it will resume normal functions. NOTE:  If you used the winUSB driver instead, it will be located under "Universal Serial Bus Devices." Same instructions apply otherwise.


2. Look through the devices for the device to passthrough.
If this does not revert your device driver, you may right click on the Bluetooth device in Device Manager, select "Update Driver", "Browse my computer for drivers", then select "Let me pick from a list of available drivers on my computer". From there, select "Generic Bluetooth Adapter". This should permanently revert your Bluetooth driver.


3. On the right column, select "libusbk" then click "Replace Driver". Select "Yes" to modify the system driver.
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 {{revision|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 shuts down. While this cuts down on the work 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 ===
=== macOS ===
Line 30: Line 88:


While a game is running:
While a game is running:
* Wii Remotes can be synced and paired to Dolphin by using the Sync button.
* 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.
* All saved Wii Remote pairings can be reset by using the Reset button. This will also disconnect all currently connected Wii Remotes.
Line 36: Line 93:
=== Advanced usage ===
=== Advanced usage ===
==== Sync button hotkey ====
==== Sync button hotkey ====
It is possible to use the "Press Sync Button" hotkey as an alternative to the buttons in the controller configuration dialog.  
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.  
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:
"Press Sync Button" is designed to work just like the Wii's red sync button:
* Pressing the hotkey will trigger a sync.
* Pressing the hotkey will trigger a sync.
* Holding the hotkey for 10 seconds will clear all saved pairings.
* Holding the hotkey for 10 seconds will clear all saved pairings.


==== Forcing a specific adapter ====  
==== 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 (that you previously converted from hex to decimal).
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. [http://www.rapidtables.com/convert/number/hex-to-decimal.htm These values should be converted from hex to decimal], for example a VID of "057E" should be inputted as "1406".


== Troubleshooting ==
== Troubleshooting ==
Line 70: Line 126:
=== No usable adapter found ===
=== No usable adapter found ===
This can happen with some adapters. You'll need to [[#Forcing_a_specific_adapter|force your adapter to be used]].
This can happen with some adapters. You'll need to [[#Forcing_a_specific_adapter|force your adapter to be used]].
== 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 are not very useful in passthrough mode, since loading a state will break Bluetooth connectivity.
* 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/hybrid Wii Remote. This means that netplay, TAS input, input display, etc. cannot work.


== Adapter test results ==
== Adapter test results ==
{|class="wikitable sortable"
{|class="wikitable sortable"
! Adapter
! Adapter
! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! Revision
! Type
! Works?  
! <abbr title="Supported Bluetooth Version">BT</abbr>
! Stable?  
! <abbr title="Vendor Identification">VID</abbr> !! <abbr title="Product Identification">PID</abbr> !! <abbr title="Hardware Revision">Rev</abbr>
! Works?
! Stable?
! Remembers pairings?
! Remembers pairings?
! Audio
! Audio
! Range
|-
|-
| Asus BT-211
| bgcolor="#afa" | Asus AR9462 Wi-Fi Card
| ? || ? || ?
| mPCIe || 4.0
| bgcolor="#afa" | Yes  
| 0B05 || 17D0 || 0001
| ?
| bgcolor="#afa" colspan="4" style="text-align: center;" | Yes
| ?
|-
| ?
| bgcolor="#fda" | Asus QCA6174A Wi-Fi Card
| ?
| M.2 || 4.1
| 0B05 || 1825 || 0001
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
|-
| bgcolor="#faa" | Asus BT-400 (BCM20702A0)
| bgcolor="#fda" | Asus USB-BT400 [BCM20702]
| USB || 4.0
| 0B05 || 17CB || ?
| 0B05 || 17CB || ?
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Yes <sup>[[#Notes|[5]]]</sup>  
| bgcolor="#fda" | Limited <sup>[[#Notes|[2]]]</sup>
| bgcolor="#faa" | No
| bgcolor="#faa" | No
| Good
| bgcolor="#afa" | Yes
| ?
|-
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B00DJ83070?linkCode=wey&tag=dolphin-emu-20 Asus BT-400 (BCM20702A0)]
| bgcolor="#fda" | Asus USB-BT400 [BCM20702]
| USB || 4.0
| 0B05 || 17CF || ?
| 0B05 || 17CF || ?
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Yes <sup>[[#Notes|[6]]]</sup>  
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
| bgcolor="#fda" | Yes <sup>[[#Notes|[4]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[8]]]</sup>
| Good
| bgcolor="#afa" | Yes
| Very long
|-
|-
| bgcolor="#fda" |Atheros AR3012
| bgcolor="#afa" | Azio BTD-V201 [CSR8510]
| 0CF3 || 3004 || 0001
| USB || 2.1
| bgcolor="#afa" | Yes  
| 0A12 || 0001 || ?
| bgcolor="#fda" | Yes <sup>[[#Notes|[7]]]</sup>  
| bgcolor="#afa" colspan="4" style="text-align: center;" | Yes
|-
| bgcolor="#fda" | Belkin Mini Bluetooth Adapter (F8T065BF) [BCM20702]
| USB || 4.0
| 050D || 065A || ?
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| bgcolor="#faa" | No
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| Very long
|-
|-
| bgcolor="#afa" | Atheros AR9462
| bgcolor="#fda" | Buro BU-BT40B [BCM20702]
| 0B05 || 17D0 || 0001
| USB || 4.0
| bgcolor="#afa" | Yes  
| 0A5C || 21EC || ?
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
| bgcolor="#fda" | CSL USB Bluetooth Nano Adapter (BSN23996) [CSR8510]
| USB || 4.0
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[2]]]</sup>
| Very long
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
|-
| bgcolor="#afa" | [https://www.amazon.com/dp/B003765X38?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V201]
| bgcolor="#fda" | E-Blue Mini Nova (EBA012V00) [CSR8510]
| USB || 2.1
| 0A12 || 0001 || ?
| 0A12 || 0001 || ?
| bgcolor="#afa" | Yes  
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#faa" | No
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| Long
|-
|-
| [https://www.amazon.com/dp/B00JAZGSXY?linkCode=wey&tag=dolphin-emu-20 Azio BTD-V401]
| bgcolor="#faa" | Foxconn T77H114.32 Bluetooth Module [BCM2070]
| ? || ? || ?
| USB <sup>[[#Notes|[14]]]</sup> || 2.1
| bgcolor="#afa" | Yes
| 0489 || E00F || 0596
| ?
| bgcolor="#faa" colspan="4" style="text-align: center;" | No
| ?
| ?
| Short
|-
|-
| Billionth Systems, Inc GUBTCR42I (Class 2)
| bgcolor="#fda" | Foxconn T77H348.02 Wi-Fi Card [AR9462]
| 0A12 || 0001 || ?
| mPCIe || 4.0
| ?
| 0489 || E04E || 0001
| ?
| bgcolor="#afa" | Yes
| ?
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| ?
| bgcolor="#faa" | No
| ?
| bgcolor="#afa" | Yes
|-
|-
| bgcolor="#fda" | CSL BSN23996
| bgcolor="#fda" | Gembird BTD-MINI5 [CSR8510]
| USB || 4.0
| 0A12 || 0001 || 8891
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Yes <sup>[[#Notes|[5]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| Long
| bgcolor="#faa" | No
| bgcolor="#afa" | Yes
|-
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B01HRZCDEG?linkCode=wey&tag=dolphin-emu-20 CSR 8510 A10 (Generic)]
| bgcolor="#faa" | Generic Bluetooth Adapter [CSR8510]
| USB || ?
| 0A12 || 0001 || 2520
| bgcolor="#faa" colspan="4" style="text-align: center;" | No
|-
| bgcolor="#faa" | Generic Bluetooth Adapter [CSR8510]
| USB || ?
| 0A12 || 0001 || 3164
| bgcolor="#afa" | Yes
| bgcolor="#faa" colspan="2" style="text-align: center;" | No
| bgcolor="#afa" | Yes
|-
| bgcolor="#fda" | Generic Bluetooth Adapter [CSR8510]
| USB || 4.0
| 0A12 || 0001 || 8891
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Yes <sup>[[#Notes|[5]]]</sup>  
| bgcolor="#fda" | Limited <sup>[[#Notes|[2]]]</sup>
| bgcolor="#fda" | Yes <sup>[[#Notes|[3]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| Good
| bgcolor="#afa" | Yes
| Long
|-
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B0169O12UC?linkCode=wey&tag=dolphin-emu-20 Orico Bta408 (BCM20702A0)]
| bgcolor="#fda" | Generic Bluetooth Adapter [IS1032N]
| 0A5C || 21EC || ?
| USB || 2.0
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| 1131 || 1004 || 0373
| bgcolor="#fda" | Yes <sup>[[#Notes|[6]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[5]]]</sup>
| Very long
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#fda" | Limited
|-
|-
| bgcolor="#faa" | CSR Generic Bluetooth Edr Mini Nova E Blue 2.1
| bgcolor="#faa" | GMYLE Ultra-Mini USB CSR4.0 [CSR8510]
| 0A12 || 0001 || ?
| USB || 4.0
| bgcolor="#afa" | Yes
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| bgcolor="#faa" | No
| bgcolor="#faa" | No
| Good
| bgcolor="#fda" | Limited
| Average
|-
|-
| bgcolor="#faa" | Generic Adapter
| bgcolor="#fda" | Intel Dual Band Wireless-AC 3160
| 0A12 || 0001 || 3164
| M.2 || 4.0
| bgcolor="#afa" | Yes  
| 8087 || 07DC || 0001
| bgcolor="#faa" | No
| bgcolor="#afa" | Yes
| bgcolor="#faa" | No
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| Good
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| ?
|-
| bgcolor="#fda" | Intel Dual Band Wireless-AC 3165
| M.2 || 4.2
| 8087 || 0A2A || 0001
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|-
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B00F85ZPIY?linkCode=wey&tag=dolphin-emu-20 GMYLE Ultra-Mini USB CSR4.0]
| bgcolor="#fda" | Intel Dual Band Wireless-AC 3168
| 0A12 || 0001 || 8891
| M.2 || 4.2
| bgcolor="#afa" | Yes  
| 8087 || 0AA7 || 0001
| bgcolor="#fda" | Yes <sup>[[#Notes|[2]]]</sup>  
| bgcolor="#afa" | Yes
| bgcolor="#faa" | No
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| Average
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| Short
| bgcolor="#afa" | Yes
|-
|-
| bgcolor="#afa" | 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
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| Long
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
|-
| bgcolor="#afa" | [https://www.amazon.com/dp/B007GFX0PY?linkCode=wey&tag=dolphin-emu-20 IOGear GBU421]
| bgcolor="#fda" | Intel Wireless-AC 9260
| M.2 || 5.1
| 8087 || 0025 || 0002
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|-
| bgcolor="#fda" | Intel Wireless-AC 9462
| M.2 <sup>[[#Notes|[12]]]</sup> || 5.2 <sup>[[#Notes|[13]]]</sup>
| 8087 || 0AAA || 0002
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|-
| bgcolor="#fda" | Intel Wi-Fi 6 AX201
| M.2 <sup>[[#Notes|[12]]]</sup> || 5.2 <sup>[[#Notes|[13]]]</sup>
| 8087 || 0026 || 0002
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|-
| bgcolor="#fda" | IOGear GBU421 [BCM2046]
| USB || 2.1
| 0A5C || 2148 || ?
| 0A5C || 2148 || ?
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| Long
|-
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B0018O9JIG?linkCode=wey&tag=dolphin-emu-20 IOGear GBU521]
| bgcolor="#fda" | IOGear GBU521 [BCM20702]
| USB || 4.0
| 0A5C || 21E8 || 0112
| 0A5C || 21E8 || 0112
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes
| bgcolor="#faa" | No
| bgcolor="#faa" | No
| Good
| bgcolor="#afa" | Yes
| Long
|-
|-
| bgcolor="#fda" | ISSC EDR Bluetooth Adapter
| bgcolor="#fda" | Kinivo BTD-300 [BCM2070]
| 1131 || 1004 || 0373
| USB || 3.0
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Yes <sup>[[#Notes|[8]]]</sup>
| bgcolor="#fda" | Yes <sup>[[#Notes|[3]]]</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="#fda" | Yes <sup>[[#Notes|[2]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Average
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| Average
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Limited
|-
|-
| bgcolor="#afa" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400]
| bgcolor="#fda" | Kinivo BTD-400 [BCM20702]
| USB || 4.0
| 0A5C || 21E8 || 0112
| 0A5C || 21E8 || 0112
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>  
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#afa" | Yes  
| bgcolor="#fda" | Limited <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes
| Average
| bgcolor="#fda" | Limited
| Very long
|-
| bgcolor="#fda" | Lite-On WCBN806A Wi-Fi Card [QCA9377]
| M.2 || 4.1
| 04CA || 3015 || 0001
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|-
|-
| bgcolor="#fda" | [https://www.amazon.com/dp/B007Q45EF4?linkCode=wey&tag=dolphin-emu-20 Kinivo BTD-400]
| bgcolor="#fda" | Lite-On WCBN807A Wi-Fi Card [QCA6174A]
| 0A5C || 21E8 || 0112
| M.2 || 5.0
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>  
| 04CA|| 3016 || 0001
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#faa" | No
| Average
| Very long
|-
|-
| Lenovo X1 Carbon Laptop, built in adapter
| bgcolor="#faa" | Mayflash DolphinBar (W010)
| 8087 || 0A2A || 0001
| USB
| bgcolor="#afa" | Yes
| colspan="4" style="text-align: center;" | N/A
| bgcolor="#afa" | Yes  
| bgcolor="#faa" colspan="4" style="text-align: center;" | Not supported <sup>[[#Notes|[10]]]</sup>
| ?
|-
| NoteShip Bluetooth Adapter [CSR8510]
| USB || ?
| 0A12|| 0001 || 0100
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| ?
| ?
| ?
| ?
|-
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B00HZWEB74?linkCode=wey&tag=dolphin-emu-20 Mayflash DolphinBar]
| bgcolor="#afa" | Nintendo Wii Bluetooth Module (WML-C43) [BCM2045]
| bgcolor="#faa" colspan="8" style="text-align:center" | Not supported
| USB <sup>[[#Notes|[11]]]</sup> || 2.0
| 057E || 0305 || 0100
| bgcolor="#afa" colspan="4" style="text-align: center;" | Yes
|-
| bgcolor="#afa" | Nintendo Wii Bluetooth Module (J27H002) [BCM2045]
| USB <sup>[[#Notes|[11]]]</sup> || 2.0
| 057E || 0305 || 0100
| bgcolor="#afa" colspan="4" style="text-align: center;" | Yes
|-
|-
| NoteShip Bluetooth Adapter
| bgcolor="#fda" | Orico BTA-403 [CSR8510]
| 0A12|| 0001 || 0100
| USB || 4.0
| bgcolor="#afa" | Yes
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| ?
| bgcolor="#fda" | Limited <sup>[[#Notes|[6]]]</sup>
| ?
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| ?
|-
| bgcolor="#fda" | Orico BTA-408 [BCM20702]
| USB || 4.0
| 0A5C || 21EC || ?
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
| bgcolor="#faa" | Orico BTA-508 [RTL8761B]
| USB || 5.1 <sup>[[#Notes|[15]]]</sup>
| 0BDA || 8771 || 0200
| bgcolor="#faa" colspan="4" style="text-align: center;" | No <sup>[[#Notes|[9]]]</sup>
|-
|-
| bgcolor="#fda" | Plugable USB 2.0 Bluetooth Adapter (BCM20702A0)
| bgcolor="#fda" | Plugable USB-BT4LE Bluetooth Adapter [BCM20702]
| USB || 4.0
| 0A5C || 21E8 || 0112
| 0A5C || 21E8 || 0112
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#fda" | Yes <sup>[[#Notes|[6]]]</sup>  
| bgcolor="#fda" | Limited <sup>[[#Notes|[3]]]</sup>
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
| bgcolor="#fda" | Qualcomm Atheros AR5B22 Wi-Fi Card [AR9462]
| mPCIe || 4.0
| 0CF3 || 3004 || 0001
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]]</sup>
| Very long
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
|-
|-
| bgcolor="#fda" | Qualcomm Atheros QCA61x4A
| bgcolor="#fda" | Qualcomm Atheros QCA9377 Wi-Fi Card
| 0B05 || 1825 || 0001
| M.2 || 5.0
| bgcolor="#afa" | Yes  
| 0CF3 || E500 || 0001
| bgcolor="#fda" | Yes <sup>[[#Notes|[6]]]</sup>  
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| Very long
|-
|-
| bgcolor="#faa" | [https://www.amazon.com/dp/B001D8CCYK?linkCode=wey&tag=dolphin-emu-20 Rocketfish Bluetooth Adapter]
| bgcolor="#faa" | Realtek RTL8852AE Wi-Fi Card
| M.2 || 5.2 <sup>[[#Notes|[15]]]</sup>
| 0BDA || 4852 || 0000
| bgcolor="#faa" colspan="4" style="text-align: center;" | No <sup>[[#Notes|[9]]]</sup>
|-
| bgcolor="#faa" | Rocketfish Micro Bluetooth Adapter (RF-MRBTAD) [BCM2046]
| USB || 2.1
| 0461 || 4D75 || ?
| 0461 || 4D75 || ?
| bgcolor="#fda" | Yes <sup>[[#Notes|[1]]]</sup>
| bgcolor="#afa" | Yes ([[#Forcing a specific adapter|Forced]])
| bgcolor="#faa" | No
| bgcolor="#faa" colspan="2" style="text-align: center;" | No
| bgcolor="#faa" | No  
| ?
| ?
| ?
|-
|-
| bgcolor="#afa" | [http://www.senanetworks.com/products/industrial_bluetooth/ud100.php Sena UD100 Bluetooth Adapter]
| bgcolor="#fda" | Sena Networks Parani-UD100 [CSR8510]
| USB || 4.0
| 0A12 || 0001 || 8241
| 0A12 || 0001 || 8241
| bgcolor="#afa" | Yes
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes
| bgcolor="#afa" | Yes  
| bgcolor="#fda" | Limited
| bgcolor="#afa" | Yes
| Good
| Very long
|-
|-
| bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter
| bgcolor="#fda" | Silicon Wave Bluetooth Wireless Adapter
| USB || 2.1
| 0C10 || 0000 || 1915
| 0C10 || 0000 || 1915
| bgcolor="#afa" | Yes
| bgcolor="#fda" | Yes <sup>[[#Notes|[5]]]</sup>
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| ?
| bgcolor="#fda" | Limited <sup>[[#Notes|[2]]]</sup>
| bgcolor="#afa" | Yes
| ?
| ?
|-
|-
| StarTech.com USBBT1EDR4 (Class 1)
| SoundBot SB340 [CSR8510]
| ? || ? || ?
| USB || 4.0
| bgcolor="#afa" | Yes  
| 0A12 || 0001 || ?
| ?
| bgcolor="#afa" | Yes
| ?
| ?
| Short range
| ?
| ?
| bgcolor="#afa" | Yes
|-
|-
| StarTech.com USBBT2EDR4 (Class 2)
| bgcolor="#fda" | TP-Link Bluetooth 4.0 Nano USB Adapter (UB400) [CSR8510]
| ? || ? || ?
| USB || 4.0
| ?
| 0A12 || 0001 || ?
| ?
| bgcolor="#afa" colspan="3" style="text-align: center;" | Yes <sup>[[#Notes|[16]]]</sup>
| ?
| bgcolor="#fda" | Limited
| ?
| ?
|-
|-
| bgcolor="#faa" | Trendnet TBW-105UB
| bgcolor="#faa" | TP-Link Bluetooth 5.0 Nano USB Adapter (UB500) [RTL8761B]
| ? || ? || ?
| USB || 5.0 <sup>[[#Notes|[15]]]</sup>
| bgcolor="#afa" |Yes
| 2357 || 0604 || ?
| bgcolor="#faa" | No  
| bgcolor="#faa" colspan="4" style="text-align: center;" | No <sup>[[#Notes|[9]]]</sup>
| ?
| Garbage
| ?
|-
|-
| bgcolor="#faa" | Trendnet TBW-106UB
| Trendnet TBW-106UB [CSR8510]
| USB || 4.0
| 0A12 || 0001 || 8891
| 0A12 || 0001 || 8891
| bgcolor="#afa" | Yes  
| bgcolor="#afa" | Yes
| ?  
| ?
| bgcolor="#faa" | No
| bgcolor="#faa" | No
| Average
| bgcolor="#fda" | Limited
| ?
|-
|-
| 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)]
| bgcolor="#fda" | Trust Bluetooth 3.0 Adapter [AR3011]
| 057E || 0305 || ?
| USB || 3.0
| bgcolor="#afa" | Yes
| 0CF3 || 3002 || 0001
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| bgcolor="#fda" | Limited <sup>[[#Notes|[4]]][[#Notes|[6]]]</sup>
| Very long
| bgcolor="#faa" | No
|-
| 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" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| bgcolor="#afa" | Yes
| Good
| Very long
|-
| Wii U Bluetooth Module (BCM20702)
| ? || ? || ?
| ?
| ?
| ?
| ?
| ?
|}
{|class="wikitable sortable"
| bgcolor="#faa" width="50px" |
| '''Not recommended.''' Does not work well and has significant limitations.
|-
|-
| bgcolor="#fda" width="50px" |
| bgcolor="#faa" | UGREEN Bluetooth 5.0 Adapter (CM390) [RTL8761B]
| '''Recommended, in some cases.''' This adapter will work well in most cases, but there may be issues in some "Bluetooth intensive" games.
| USB || 5.1 <sup>[[#Notes|[15]]]</sup>
| 2B89 || 8761 || 0200
| bgcolor="#faa" colspan="4" style="text-align: center;" | No <sup>[[#Notes|[9]]]</sup>
|-
|-
| bgcolor="#afa" width="50px" |
| bgcolor="#fda" | UGREEN USB Bluetooth 4.0 Adapter (CM109) [CSR8510]
| '''Recommended'''. This adapter will work well in all cases and will give the same experience as a Wii Bluetooth adapter.
| USB || 4.0
| 0A12 || 0001 || 8891
| bgcolor="#afa" colspan="2" style="text-align: center;" | Yes
| bgcolor="#fda" | Limited <sup>[[#Notes|[7]]]</sup>
| bgcolor="#afa" | Yes
|}
|}
:<span style="background-color:#f9f9f9; border:1px solid #aaa;">&nbsp;&nbsp;&nbsp;&nbsp;</span> '''Unknown.''' Not enough information to classify.
:<span style="background-color:#faa; border:1px solid #aaa;">&nbsp;&nbsp;&nbsp;&nbsp;</span> '''Incompatible.''' Does not work or has significant limitations.
:<span style="background-color:#fda; border:1px solid #aaa;">&nbsp;&nbsp;&nbsp;&nbsp;</span> '''Partially compatible.''' Works well in most cases, but there may be some issues.
:<span style="background-color:#afa; border:1px solid #aaa;">&nbsp;&nbsp;&nbsp;&nbsp;</span> '''Fully compatible.''' Works well in all cases and will give the same experience as a Wii Bluetooth adapter.


<div id="Notes">
<div id="Notes">
<sup>[1]</sup> Needs to [[#No_usable_adapter_found|force Dolphin to use the adapter]]<br>
'''Stability'''
<sup>[2]</sup> May stop working after HCI resets (stopping, resetting emulation or going back to the system menu)<br>
:<sup>[1]</sup> May stop working after HCI resets (stopping, resetting emulation or going back to the system menu).
<sup>[3]</sup> Has issues reconnecting multiple Wiimotes<br>
:<sup>[2]</sup> 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).
<sup>[4]</sup> Limited to 1 remote<br>
:<sup>[3]</sup> Starts having lag issues after ~30 minutes. Reconnecting the Wii remote is required.
<sup>[5]</sup> 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)<br>
:<sup>[4]</sup> May stop working after HCI resets on Windows, works fine on Linux and macOS.
<sup>[6]</sup> Starts having lag issues after ~30 minutes. Reconnecting the Wii remote is required.<br>
:<sup>[5]</sup> Randomly stop working on Windows, works fine on Linux and macOS.
<sup>[7]</sup> May stop working after HCI resets (Windows only, works fine on Linux/macOS)<br>
:<sup>[6]</sup> Has issues connecting multiple Wii Remotes.
<sup>[8]</sup> Randomly stop working on Windows, works fine on Linux/macOS<br>
 
'''Pairing'''
:<sup>[7]</sup> Has issues reconnecting multiple Wii Remotes.
:<sup>[8]</sup> Remembers only one Wii Remote.
:<sup>[9]</sup> Seems to completely ignore all discovery commands sent by the emulated software, rendering it unable to find any Wiimote. Might start working if Dolphin gets the ability to upload firmware binaries to the adapter, like the proprietary Realtek driver does.
 
'''Other'''
:<sup>[10]</sup> Doesn't expose its internal Bluetooth adapter, can't be used with Bluetooth Passthrough in any capacity.
</div>
</div>
:<sup>[11]</sup> Must be modified before use, [https://forums.dolphin-emu.org/Thread-how-to-wire-a-wii-s-bluetooth-module-to-a-pc-usb-port refer to this forum thread].
:<sup>[12]</sup> [https://www.intel.com/content/www/us/en/support/articles/000026155/wireless.html CNVi card], must be paired with a compatible Intel CPU and chipset to work.
:<sup>[13]</sup> Supported Bluetooth version may vary depending of the chipset model paired with this card.
:<sup>[14]</sup> Proprietary 10-pin BTB connector, usually found in older laptops (2010 and earlier).
:<sup>[15]</sup> This is the Bluetooth version supported out of the box, with no drivers installed, can be upgraded/downgraded depending of the proprietary Realtek driver version installed.
:<sup>[16]</sup> Compatible only with Windows; Mac/Linux unsupported.
[[Category:Tutorials]]
[[Category:Tutorials]]
Retrieved from "https://wiki.dolphin-emu.org/index.php?title=Special:MobileDiff/140761...189295"