FAQ - Frequently Asked QuestionsContents (hide)
1. Troubleshooting1.1 Extra steps to make it work on LinuxTo use the program on Linux you need to download an additional GPL'd library yourself: bluecove-gpl.
I can't distribute this library with my software for legal reasons (as far as I understand). User note: Even after following the instructions linked above, I still had problems getting this to run on an Asus Eee PC running Ubuntu 10.04 (Lucid). I received the following errors when running in debug mode ( 13:22:30.901 error Can't load library file java.lang.UnsatisfiedLinkError: /tmp/bluecove_james_0/libbluecove.so: libbluetooth.so: cannot open shared object file: No such file or directory com.intel.bluetooth.NativeLibLoader.loadAsSystemResource(NativeLibLoader.java:314) java.lang.UnsatisfiedLinkError: /tmp/bluecove_james_0/libbluecove.so: libbluetooth.so: cannot open shared object file: No such file or directory Aug 4, 2010 1:22:31 PM org.uweschmidt.wiimote.whiteboard.WiimoteWhiteboard startup SEVERE: Error on startup java.lang.IllegalStateException: Bluetooth failed to initialize. There is probably a problem with your local Bluetooth stack or API. I found that I had to create a symbolic link as follows: sudo ln -s /usr/lib/libbluetooth.so.3.5.0 /usr/lib/libbluetooth.so
1.2 Erratic mouse cursor behavior
1.3 I get the error message "Not supported on winsock/bluesoleil/X"At the moment, the software can unfortunately only work with the Widcomm Bluetooth stack on Windows. The reason is that Wiimote Whiteboard requires the L2CAP Bluetooth protocol, which is currently only offered through Widcomm on Windows, as indicated by the BlueCove supported stacks page. (BlueCove is a Java library for Bluetooth that the application depends on.) 1.4 Multiple Wiimote Whiteboards in close proximityWhen running multiple Wiimote Whiteboards in close proximity, it can happen that the software is connecting to the "wrong" Wiimote. In order to prevent that, the runtime option 1.5 Using anything else than a standard Wii Remote (Wiimote)The application has been tested and found to be working with the original Wii Remote (Wiimote) and the newer Wii Remote Plus. Wiimote clones, like the Nyko Wand, have not been tested, and some users reported that the software does not work with these devices. 1.6 Can I run the application on device X or operating system Y?The program is based on Java SE (version 5 or newer) and requires BlueCove, a Java library for Bluetooth, in combination with a supported Bluetooth stack that offers L2CAP. If these conditions are not satisfied, adapting the app will probably take as much time as a complete rewrite using other technologies. 1.7 My wiimote(s) won't connect (or it takes many tries)Problems during initiating the connection are not uncommon, but the communication with the Wiimote is usually quite stable after the initial synchronization. Try several connection attempts until successful. It is important that you do not connect the Wiimote(s) via the OS assistants, the software will handle the entire connection process. Try disconnecting previously connected Wiimotes. 1.8 The mouse cursor movements are delayedThis latency is caused by the mouse movement smoothing algorithm. A tradeoff has to be made between smooth movements on one hand, and low latency on the other hand. If you don't like the default setting, you will probably be able to change it starting with release 1.0.4. 1.9 Do I need to download anything else to make the software work?Not if you fulfill these requirements. There are some extra steps to take on Linux. 1.10 The calibration doesn't workTo do the calibration, you must only briefly activate your IR pen while directly pointing at the currently visible crosshair. Also read this about erratic behavior. 2. Features2.1 How can I draw on things or highlight stuff?These features simply do not exist in the application, since they are availabe through other applications, like Desktastic on the Mac. 2.2 Can you please add feature X?Generally, I'll consider adding it if it suits my concept of the app. Also, since the source code is available, you're welcome to create your own version. 2.3 Can I use a webcam instead of a Wiimote?No. 2.4 Can I make use of multiple screens?No, not right now. At the moment, the app only let's you choose which screen to use. 3. Miscellaneous3.1 Compiling the source codeIf you get an error that the class JaiI18N couldn't be found then you don't have Java Advanced Imaging installed. JaiI18N is actually only required to compile the software. The easiest way to fix the problem is to install Java Advanced Imaging. 3.2 Getting TUIO/OSC (Multi-touch) to work with Flash appsRegarding Flash multi-touch apps: I had some difficulties with the latest version of flosc, but success with the version included here. Also make sure that you add the Flash apps you want to run in the browser to the list of trustworthy locations. 3.3 Get more information about what's going onYou can check the Log for error messages (accessible via Help → Log) which can be really helpful if you run into problems.
Please do always include relevant output from the Log when reporting about problems.
Additionally, to get more debug information, run the cross-platform Java version from the command line like this: 3.4 General information/recommendations about BluetoothThe programs relies on the Bluetooth library BlueCove. You can find a list of BlueCove-compatible Bluetooth stacks here. I only heard of few problems on Mac OS X, using the built-in stack. I also got reports from users who got the program running on Windows using either the Widcomm or BlueSoleil stack. It seems like Widcomm works better, see this post about BlueSoleil. Check out this post if you're using Windows Vista. Linux users should use the BlueZ stack. The program sometimes crashes at startup due to Bluetooth errors. It may also happen at startup that the Wiimote is found but no IR data is received (check "Visible IR dots"). Whenever this happens, try the "Reset" button, connect again or simply restart the program. Once the program was working, I never had any problems later on (like lost connections). Issue on PowerPC Macs (excerpt from the WiiRemoteJ-README): "Note for Mac OS X PowerPC (PPC) users: You will have to delete the Wii Remote from your previous devices list in System Preferences → Bluetooth → Devices after each connection (every time you connect a given Wii Remote). Even then, the outgoing connection will still fail every other time. There is some sort of bug relating to HCI devices and Apple's library. Luckily, it was fixed for the Intel Macs."
3.5 Other valuable resourcesThe wiimoteproject.com forums, which also have a thread about Essential Wiimote External Links. 3.6 Can you recommend an infrared (IR) pen?Please read this. This is a read-only archival copy of wiki.uweschmidt.org.
Beware that some links don't work anymore. |