Readme

Embed Size (px)

DESCRIPTION

y

Citation preview

docs\license.txt - The license agreement that this product is released underdocs\html\index.html - API documentationcom\centralnexus\input - The Java source codelib\ - *.DLL and *.LIB files that are needed by the APIwin32\ - Windows implementation of the APIJoystick.jar - Java Joystick Driver interface JAR filerunTest.bat - A demo program for the Java Joystick DriverA special thanks goes out to Ed Burns for giving me useful feedback.The files that you need for a Windows binary distribution is lib\jjstick.dlland Joystick.jar. You must of course agree to the license included in thisdistribution, which includes giving credit to the authors for the creationof this library.Thank you for you interest in the library.George Rhoten (main author)------------------------------------------lib\ - *.so files that are needed by the APIlinux\ - Linux 2.4 implementation of the APIrunTest - shell script to test joystick driverHere is some information on getting your Linux Joystick workingin Java.This doesn't work with the Linux 2.2 kernel, but doesn't reallytake advantage of update only events. The code that was writtenfor Linux requires joydev.o. It should be at"/lib/modules/2.4.18/kernel/drivers/input/".This also requires the driver for your particular joystick. For an HIDjoystick you just need to enable USB and HID support under USB supportand Joystick support under Input Core support in the kernelconfiguration. For something like the Logitech WingMan you need toenable Serial port device support and input line discipline underCharacter Devices->Joysticks, then you turn on that particular Joystickmodule under the Joystick heading. Turning on traditional joysticks issimilar, you just add Game Port support and then add the module for yourparticular joystick.ls -l /dev/js? gives melrwxrwxrwx 1 root root 9 Jun 8 2001 /dev/js0 -> input/js0lrwxrwxrwx 1 root root 9 Jun 8 2001 /dev/js1 -> input/js1lrwxrwxrwx 1 root root 9 Jun 8 2001 /dev/js2 -> input/js2lrwxrwxrwx 1 root root 9 Jun 8 2001 /dev/js3 -> input/js3ls -l dev/input/js? gives mecrw------- 1 danielk root 13, 0 Mar 23 2001 /dev/input/js0crw------- 1 danielk root 13, 1 Mar 23 2001 /dev/input/js1crw------- 1 danielk root 13, 2 Mar 23 2001 /dev/input/js2crw------- 1 danielk root 13, 3 Mar 23 2001 /dev/input/js3The joydev module must be loaded for this API to find anyjoysticks. Depending on a variety of factors this may or may not be autoloaded when you plug in a joystick, if it isn'tyou must do a "modprobe joydev" as root to load it. Ifit doesn't load, you probably don't have the joystick drivers(often the case when you compile your own kernel). I don'tthink anyone using a commercial distibution out of the boxwould have the problem, but programmers are likely to.If you wanted everyone to be able to use the joystick the permissionsshould be crw-rw-rw, this may be the problem you're having since a lotof distributions have the joystick available to root only.lsmod gives meModule Size Used bywarrior 1552 0 (unused)serio 1024 0 [warrior]joydev 5792 0 (unused)input 3328 0 [warrior joydev]... other stuff ...This is for the WingMan USB gamepad (with 7 axes).When compiling on Linux you may need to specify where yourJava C++ headers are located. You can specify the headers whenusing "make" by doing the following in the linux directory:make INCS="-I/usr/java/jdk1.3.1_01/include/ -I/usr/java/jdk1.3.1_01/include/linux/"Daniel Kristjansson (linux port)George Rhoten (main author)