Dolphin Emulator Wiki

Wii Remote Plus (RVL-CNT-01-TR) Connection Guide: Difference between revisions

Page Discussion

Wii Remote Plus (RVL-CNT-01-TR) Connection Guide (view source)

Revision as of 16:33, 2 February 2024

319 bytes added ,  2 February
m
Just became aware that Wiimote pairing (even non-TR) is a big mess on recent macOS versions
(add instructions for linux)
m (Just became aware that Wiimote pairing (even non-TR) is a big mess on recent macOS versions)
 
(21 intermediate revisions by 11 users not shown)
Line 1: Line 1:
Released only a year after the Wii MotionPlus accessory, the Wii Remote Plus is a Wii Remote with the MotionPlus addon built into the Wii Remote. Unfortunately, shortly after the Wii Remote Pluses came out, a new Wii Remote Plus type appeared. Whereas the standard Wii Remotes and the very first Wii Remote Pluses register as <samp>RVL-CNT-01</samp>, the new Wii Remotes register as <samp>RVL-CNT-01-TR</samp>. What exactly changed is unknown, but all -TR Wii Remotes do not work with Dolphin by default. Since all Wii Remotes for sale in stores since 2011 are -TR Wii Remotes, this has become a growing problem. Fortunately, they can work with Dolphin, it just takes some work. This guide tells you how to connect and use a <samp>RVL-CNT-01-TR</samp> Wii Remote Plus in Dolphin.
{{Fmbox
|type = warning
|text = '''This guide is outdated!'''
<br/>Nowadays, Dolphin can directly pair and connect to RVL-CNT-01-TR remotes without the aid of 3rd party software/hardware in nearly all currently supported desktop OSes. Most content of this guide is only applicable to older OS versions that are not supported by Dolphin anymore (e.g. Windows 7/8/8.1), or relies on discontinued software, not available anymore (e.g. Toshiba Bluetooth Stack).  
}}


Note that the very first Wii Remote Pluses, such as those included in [[FlingSmash]] and [[The Legend of Zelda: Skyward Sword]], are not <samp>RVL-CNT-01-TR</samp> Wii Remotes. For this reason this guide will not use the blanket "Wii Remote Plus" term, but will use "-TR Wii Remote" to refer to the <samp>RVL-CNT-01-TR</samp> Wii Remotes specifically. While the addition of the sync button on the battery cover is the common way to tell non-TR Wii Remote Pluses from -TR Wii Remote Pluses, even that is not 100% reliable. The only way to know for sure to is connect it to a computer and see if it is registered as <samp>RVL-CNT-01-TR</samp>.


= Linux =
Released only a year after the Wii MotionPlus accessory, the Wii Remote Plus is a Wii Remote with the MotionPlus addon built into the Wii Remote. Unfortunately, shortly after the Wii Remote Pluses came out, a new Wii Remote Plus type appeared. Whereas the standard Wii Remotes and the very first Wii Remote Pluses register as <samp>RVL-CNT-01</samp>, the new Wii Remotes register as <samp>RVL-CNT-01-TR</samp>. What exactly changed is unknown, but all -TR Wii Remotes may need additional hardware/software to work with Dolphin. Since all Wii Remotes for sale in stores since 2011 are -TR Wii Remotes, this has become a growing problem. Fortunately, they can work with Dolphin -- with some special requirements. This guide tells you how to connect and use a <samp>RVL-CNT-01-TR</samp> Wii Remote Plus in Dolphin.
Linux does not require any special treatment. Use the normal connecting methods shown in [[Configuring Controllers]].
 
Note that the very first Wii Remote Pluses, such as those included in [[FlingSmash]] and [[The Legend of Zelda: Skyward Sword]], are not <samp>RVL-CNT-01-TR</samp> Wii Remotes. For this reason, this guide will not use the blanket "Wii Remote Plus" term, but will use "-TR Wii Remote" to refer to the <samp>RVL-CNT-01-TR</samp> Wii Remotes specifically. While the addition of the sync button on the battery cover is the common way to tell non-TR Wii Remote Pluses from -TR Wii Remote Pluses, even that is not 100% reliable. The only way to know for sure to is connect it to a computer and see if it is registered as <samp>RVL-CNT-01-TR</samp>.
 
= Bluetooth Passthrough Mode =
In the Bluetooth Passthrough mode, -TR Wii Remotes are not an issue at all. Refer to [[Bluetooth Passthrough]] for details.


Minimal requirements are :
* Linux kernel 3.1 ('''Linux kernel 3.11''' highly recommended)
* Bluez 4.101 with Wiimote Plus patch ('''Bluez 5.0''' recommended)


Bluez patch can be found here: [http://thread.gmane.org/gmane.linux.bluez.kernel/31250| PATCH wiimote: add Wii-Remote-Plus ID and name detection]
= Linux =
Linux (> 3.11) does not require any special treatment. Use the normal connecting methods shown in [[Configuring Controllers]].


''NOTE: Ubuntu releases before 14.10 provide Bluez 4.101 '''without''' Wiimote Plus patch. You need to patch Bluez yourself !''
Since [https://dolp.in/v5.0-876 5.0-876], the DolphinBar can also be used on Linux.
== Connecting ==
taken from bluez sources /plugins/wiimote.c:
/*
* Nintendo Wii Remote devices require the bdaddr of the host as pin input for
* authentication. This plugin registers a pin-callback and forces this pin
* to be used for authentication.
*
* There are two ways to place the wiimote into discoverable mode.
*  - Pressing the red-sync button on the back of the wiimote. This module
*    supports pairing via this method. Auto-reconnect should be possible after
*    the device was paired once.
*  - Pressing the 1+2 buttons on the front of the wiimote. This module does
*    not support this method since this method never enables auto-reconnect.
*    Hence, pairing is not needed. Use it without pairing if you want.
* After connecting the wiimote you should immediately connect to the input
* service of the wiimote. If you don't, the wiimote will close the connection.
* The wiimote waits about 5 seconds until it turns off again.
* Auto-reconnect is only enabled when pairing with the wiimote via the red
* sync-button and then connecting to the input service. If you do not connect
* to the input service, then auto-reconnect is not enabled.
* If enabled, the wiimote connects to the host automatically when any button
* is pressed.
*/




= Mac OS X =
= macOS =
OS X does not require any special hardware or software. It only requires a device be paired beforehand.
macOS does not require any special hardware or software. It only requires a device be paired beforehand.


# Open Bluetooth Settings and click the plus (+) sign to set up a new device.
# Open Bluetooth Settings and click the plus (+) sign to set up a new device.
Line 48: Line 30:


Once the pairing process is completed, the controller will be usable on Dolphin, as further instruction is available in the [[Configuring Controllers]] guide. However the red Sync button must be pressed instead of '''1''' + '''2''' every time to connect.
Once the pairing process is completed, the controller will be usable on Dolphin, as further instruction is available in the [[Configuring Controllers]] guide. However the red Sync button must be pressed instead of '''1''' + '''2''' every time to connect.
== El Capitan ==
Since the El Capitan update, Bluetooth pairing requires a passcode. To get the Bluetooth passcode you must find the Bluetooth address of the Wii remote.
# Open System Preferences --> Bluetooth.
# Press the red sync button on the back of the Wii remote.
# After pairing fails, right-click on the device and look for the field "address".
# Record the address backwards (e.g. 00-1B-7A-D9-72-0E would be "e0279da7b10").
# Use a Hexadecimal-to-ASCII table or convertor ([http://www.rapidtables.com/convert/number/hex-to-ascii.htm such as this one]) to get ASCII text.
# Go back to Bluetooth settings, find the Wii remote device and click on options.
# Under "Passcode" paste/write the ASCII text into the field (ignore non-character such as "NULL" or "STX").
# Press the red sync button on the back of the Wii remote and click pair.
# If pairing fail, restart the computer and try pairing again.
# If pairing continues to fail, see below.
=== If Pairing Fails ===
For some people, pairing using the method above does not work. If this is the case open Dolphin, click on "Controller", select "Real WiiMote" from the Wiimote settings, press the red sync button on the back of the Wii remote and hit "refresh" under "Real Wiimote".


= Windows =
= Windows =
Windows includes the MS Bluetooth Stack, and most Bluetooth adapters use it by default. However, it lacks a number of Bluetooth functions, some of which the -TR Wii Remote uses. There are now two solutions for this problem, the DolphinBar and the Toshiba Bluetooth Stack. Both have superior Bluetooth functionality and not only allow -TR Wii Remotes to work, but also fix minor Wii Remote bugs that are present in the MS Bluetooth Stack.
Windows includes the MS Bluetooth Stack and most Bluetooth adapters use it by default. Starting with Dolphin {{revision|4.0-8325}}, if you're using Windows 8 or newer, all you need to do to connect -TR Wii Remotes is the typical Wii Remote connectivity as described in [[Configuring Controllers#Wii Remote "Wiimote"|Configuring Controllers]]. If you're running Windows 7 or earlier you'll have a previous version of MS Bluetooth Stack that lacks some Bluetooth functions which the -TR Wii Remote uses. In that case you have two solutions for this problem, the DolphinBar or the Toshiba Bluetooth Stack. Both have superior Bluetooth functionality and not only allow -TR Wii Remotes to work, but also fix minor Wii Remote bugs that are present in the MS Bluetooth Stack used on Windows 7 and earlier.  


== DolphinBar ==
== DolphinBar ==
Line 56: Line 57:


== Toshiba Stack ==
== Toshiba Stack ==
The Toshiba Stack provides full Bluetooth on Windows, for everything, not just Wii Remotes. Though, it requires the additional step of connecting Wii Remotes through the Toshiba Stack instead of just through Dolphin.
The Toshiba Stack provides full Bluetooth on Windows 7, for everything, not just Wii Remotes, and it has full -TR support. However, it requires the additional step of connecting Wii Remotes through the Toshiba Stack instead of just through Dolphin.


The link provided below is the official download page for Toshiba Stack. Use the newest version; it has the highest known compatibility. If the newest version doesn't work feel free to try older ones. Please be aware that Toshiba Stack will start in trial mode when using on a unsupported dongle subjected with forced driver installation, and will eventually require a supported adapter to continue use of the software.
The link provided below is the official download page for Toshiba Stack. Use the newest version; it has the highest known compatibility. If the newest version doesn't work feel free to try older ones. Please be aware that Toshiba Stack will start in trial mode when using on a unsupported dongle subjected with forced driver installation, and will eventually require a supported adapter to continue use of the software.


[http://support.toshiba.com/support/viewContentDetail?contentId=4007183 Download page]
[https://extranet.toshiba-tro.de/en-us/supportquality/bluetoothinfopage/news/downloadtoshiba.aspx Download page]


=== Toshiba Stack and the Bluetooth Adapter ===
=== Toshiba Stack and the Bluetooth Adapter ===
Line 82: Line 83:
*For a quick note, because of the Toshiba Stack, it is recommended that Continuous Scanning is enabled. Dolphin will immediately detect the Wii Remote and it will be used upon starting a game.
*For a quick note, because of the Toshiba Stack, it is recommended that Continuous Scanning is enabled. Dolphin will immediately detect the Wii Remote and it will be used upon starting a game.
*Another thing to note, when turning the Wii Remote off, its device ID will remain in the Bluetooth settings window, but the yellow and green clasped lines will be gone. To reconnect the Wii Remote, just double click it. A window will pop up asking to prepare the Wii Remote once again. Click "OK" and then press the red Sync button on the bottom of the Wii Remote. It will be reconnected in a matter of seconds.
*Another thing to note, when turning the Wii Remote off, its device ID will remain in the Bluetooth settings window, but the yellow and green clasped lines will be gone. To reconnect the Wii Remote, just double click it. A window will pop up asking to prepare the Wii Remote once again. Click "OK" and then press the red Sync button on the bottom of the Wii Remote. It will be reconnected in a matter of seconds.


=== Forcing the Toshiba Drivers Onto the Adapter ===
=== Forcing the Toshiba Drivers Onto the Adapter ===
Line 101: Line 103:


==== Disable Driver Signature Enforcement ====
==== Disable Driver Signature Enforcement ====
By default, 64-bit versions of Windows does not let the users install drivers which are not signed. So, after modifying <var>tosrfusb.inf</var> its signature won't be valid anymore and Windows will block the installation unless Driver Signature Enforcement is disabled. Follow these steps:
By default, 64-bit versions of Windows does not let the users install drivers which are not signed. So, after modifying <var>tosrfusb.inf</var> its signature won't be valid anymore and Windows will block the installation unless Driver Signature Enforcement is disabled. Follow these steps on Windows 7:


'''On Windows 7'''
# During boot-up, continuously press F8 to get to "Advanced Boot Options".
# During boot-up, continuously press F8 to get to "Advanced Boot Options".
# When the boot manager menu appears, use the arrow keys to select "Disable driver signature enforcement".
# When the boot manager menu appears, use the arrow keys to select "Disable driver signature enforcement".
# Press "Enter" and the computer will restart Windows with the driver signature enforcement disabled.
# Press "Enter" and the computer will restart Windows with the driver signature enforcement disabled.
'''On Windows 8 (and onwards)'''
# While holding "Shift", go to the Power Menu and click on "Restart".
# Continue with "Troubleshoot" → "Advanced options" → "Startup Settings", then click "Restart".
# The one we are looking for is "Disable driver signature enforcement". Press "7" or "F7" and the computer will restart Windows with the driver signature enforcement disabled.


==== Installing the Modified Driver Onto the Bluetooth Adapter====
==== Installing the Modified Driver Onto the Bluetooth Adapter====
Retrieved from "https://wiki.dolphin-emu.org/index.php?title=Special:MobileDiff/116062...185101"