Difference between revisions of "Wiimote"

(Update Wiimote documentation)
m (Rollback github-sync breakage)
Line 2: Line 2:
 
__NOEDITSECTION__
 
__NOEDITSECTION__
  
SuperTuxKart has support for Nintendo Wii controllers, also called Wiimotes. One current limitation is that we do not yet have support for newer Wiimotes with the text "Wii MotionPlus INSIDE" on them. If you have one of those controllers, you will unfortunately not get it to work with STK. Controllers with a separate MotionPlus nunchuck added should work as far as we are aware.
+
From SuperTuxKart 0.8.1 we have support for Nintendo Wii-controllers called Wiimotes. One current limitation is that we do not yet have support for newer Wiimotes with the text "Wii MotionPlus INSIDE" on them. If you have one of those controllers, you will unfortunately not get it to work with STK. Controllers with a separate MotionPlus nunchuck added should work as far as we are aware.
  
'''Some MotionPlus-Wiimotes will work, but the "RVL-CNT-01-TR" won't work!  If you have one of these, try [https://code.google.com/p/wjoy/ wJoy] or [http://glovepie.org/ GlovePIE]'''
+
'''Some MotionPlus-Wiimotes will work, but the "RVL-CNT-01-TR" won't work!  If you have one of these, try [https://code.google.com/p/wjoy/ wJoy]/[http://glovepie.org/ GlovePIE]'''
  
 
<div id="downloads_container">
 
<div id="downloads_container">
Line 14: Line 14:
 
<div id="download_linux">
 
<div id="download_linux">
 
# Be sure that package 'bluez' is installed and enabled.
 
# Be sure that package 'bluez' is installed and enabled.
# Start STK, go to options, select the "Controls" tab, select "Add a device", "Add Wiimote".
+
# Open up STK.
# Press 1 and 2 buttons on your Wiimote at the same time, and click OK.
+
# Open up the dialog and press 1 and 2 buttons on your Wiimote at the same time.
# Wait for the Wiimote to connect, and click OK if there is a dialog "Found X wiimote(s)".
+
# Click the OK button on your computer.
# If it says "Could not detect any wiimote :/" click "OK" and try again.
+
# Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
 +
# If it shows up "Could not detect any wiimote :/" click "OK" and try it again!
 
</div>
 
</div>
  
Line 27: Line 28:
  
 
# Be sure to enable Bluetooth on your Mac.
 
# Be sure to enable Bluetooth on your Mac.
# Start STK, go to options, select the "Controls" tab, select "Add a device", "Add Wiimote".
+
# Open up STK.
# Press 1 and 2 buttons on your Wiimote at the same time, and click OK.
+
# Open up the dialog and press 1 and 2 buttons on your Wiimote at the same time.
# Wait for the Wiimote to connect, and click OK if there is a dialog "Found X wiimote(s)".
+
# Click the OK button on your computer.
# If it says "Could not detect any wiimote :/" click "OK" and try again.
+
# Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
 +
# If it shows up "Could not detect any wiimote :/" click "OK" and try it again!
 
</div>
 
</div>
  
Line 43: Line 45:
 
# Add a Bluetooth device:  
 
# Add a Bluetooth device:  
 
#; Vista
 
#; Vista
#:Go to "Bluetooth Devices" and add a Bluetooth device
+
#:Go to "Bluetooth Devices" and a a Bluetooth devices
 
#; Windows 7
 
#; Windows 7
 
#:Go to "View devices and printers" in "Hardware & Sound" and click on "Add a device".   
 
#:Go to "View devices and printers" in "Hardware & Sound" and click on "Add a device".   
# Pesss 1+2 on your wiimote, and wait for it to be detected. The Wiimote might first be detected as a generic 'input device', but after a few seconds the device name should change to be "Nintendo RVL-CTN-01" or somthing similar. Make sure the wiimote LEDs are blinking, if they stop before they were connected, press 1+2 again. You should end up with a display like the following:<br><br> [[image:Wii1.png]]
+
# Click 1+2 on your wiimote, and wait for it to be detected. The Wiimote might first be detected as a generic 'input device', but after a few seconds the device name should change to be "Nintendo RVL-CTN-01" or similar. Make sure the wiimote LEDs are blinking, if they stop before they were connected, press 1+2 again. You should end up with a display like the following:<br><br> [[image:Wii1.png]]
 
# Select the "Nintendo RVL..." icon:<br><br>[[image:Wii2.png]]
 
# Select the "Nintendo RVL..." icon:<br><br>[[image:Wii2.png]]
 
# Click on "Pair without using a code".
 
# Click on "Pair without using a code".
# Start STK, go to options, select the "Controls" tab, select "Add a device", "Add Wiimote".
+
# Start SuperTuxKart.
# Press 1 and 2 buttons on your Wiimote at the same time, and click OK.
+
# Open up the option dialog, select add device, add wiimote.
# Wait for the Wiimote to connect, and click OK if there is a dialog "Found X wiimote(s)".
+
# Click on 'OK'.
# If it says "Could not detect any wiimote :/" click "OK" and try again.
+
# Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
 +
# If it shows up "Could not detect any wiimote :/" click "OK" and try it again.  
  
Note that your wiimote will stay connected to your computer even if you exit SuperTuxKart (which means it will be using battery). The best option is to explicitly disconnect it from the Bluetooth manager. We also have seen connection problems if the wiimote is already listed in the Bluetooth device list when you try to connect it. I could only connect it to SuperTuxKart after I removed the wiimote from the list of Bluetooth devices (and let it be discovered again).
+
Note that your wiimote will stay connected to your computer even if you exit SuperTuxKart (which especially means it will be using battery). The best option is to explicitly disconnect it from the Bluetooth manager. We also have seen connection problems if the wiimote is already listed in the Bluetooth device list when you try to connect it. I could only connect it to SuperTuxKart after I removed the wiimote from the list of Bluetooth devices (and let it be discovered again).
  
 
</div>
 
</div>
 +
 
</div>
 
</div>

Revision as of 23:50, 17 September 2016


From SuperTuxKart 0.8.1 we have support for Nintendo Wii-controllers called Wiimotes. One current limitation is that we do not yet have support for newer Wiimotes with the text "Wii MotionPlus INSIDE" on them. If you have one of those controllers, you will unfortunately not get it to work with STK. Controllers with a separate MotionPlus nunchuck added should work as far as we are aware.

Some MotionPlus-Wiimotes will work, but the "RVL-CNT-01-TR" won't work! If you have one of these, try wJoy/GlovePIE

Linux

  1. Be sure that package 'bluez' is installed and enabled.
  2. Open up STK.
  3. Open up the dialog and press 1 and 2 buttons on your Wiimote at the same time.
  4. Click the OK button on your computer.
  5. Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
  6. If it shows up "Could not detect any wiimote :/" click "OK" and try it again!

Mac OS X

  1. Be sure to enable Bluetooth on your Mac.
  2. Open up STK.
  3. Open up the dialog and press 1 and 2 buttons on your Wiimote at the same time.
  4. Click the OK button on your computer.
  5. Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
  6. If it shows up "Could not detect any wiimote :/" click "OK" and try it again!

Windows

  1. Be sure to enable Bluetooth
  2. Open up the Control panel.
  3. Add a Bluetooth device:
    Vista
    Go to "Bluetooth Devices" and a a Bluetooth devices
    Windows 7
    Go to "View devices and printers" in "Hardware & Sound" and click on "Add a device".
  4. Click 1+2 on your wiimote, and wait for it to be detected. The Wiimote might first be detected as a generic 'input device', but after a few seconds the device name should change to be "Nintendo RVL-CTN-01" or similar. Make sure the wiimote LEDs are blinking, if they stop before they were connected, press 1+2 again. You should end up with a display like the following:

    Wii1.png
  5. Select the "Nintendo RVL..." icon:

    Wii2.png
  6. Click on "Pair without using a code".
  7. Start SuperTuxKart.
  8. Open up the option dialog, select add device, add wiimote.
  9. Click on 'OK'.
  10. Wait for the Wiimote to connect and click OK if there is a dialog "Found X wiimote(s)"
  11. If it shows up "Could not detect any wiimote :/" click "OK" and try it again.

Note that your wiimote will stay connected to your computer even if you exit SuperTuxKart (which especially means it will be using battery). The best option is to explicitly disconnect it from the Bluetooth manager. We also have seen connection problems if the wiimote is already listed in the Bluetooth device list when you try to connect it. I could only connect it to SuperTuxKart after I removed the wiimote from the list of Bluetooth devices (and let it be discovered again).