usbjoysticks Files

Project: USBJoysticks
Author:  Simon Parmenter

This project is free under the BSD license; see the file Copyright.txt.

The project's intent is to provide the user with the facility to:
1. Enumerate and view the USB joysticks on their Linux system desktops.
2. To view the basic properties, current button and absolute axes mappings and the current correction values for each absolute axis.
3. To view the status of the joystick buttons: pressed / released
4. To view the position of each absolute axis – this includes the hats – and their respective numerical values in both non-raw and raw event modes.
5. To calibrate the joystick in a simple and easy manner.
6. To modify the correction values of each absolute axis of the currently selected joystick.
7. To modify the button mapping of the currently selected joystick.
8. To modify the absolute axes mapping of the currently selected joystick.
9. To modify the dead-zone and set the values of the low-range and high-range limits.
10. To invert the responses of the absolute axes.
11. To save the current properties of the joystick to a file.
12. To load a set of properties from a user selected file and apply them to the currently selected joystick.
13. To load mappings from a user selected file and apply them to the currently selected joystick.
14. To load correction values from a user selected file and apply them to the currently selected joystick.
15. To re-enumerate (refresh) the application from the system.

See the document usingJoysticks.odt (OpenOffice) in /docs for example screenshots and descriptions.



Build Requirements:
------------------
Qt 4.7.0   or greater
GCC 4.6.0  or greater
Boost 1.45 or greater


Build Instructions:
-------------------
At the command line change to the main directory where the USBJoysticks.pro file is and issue the command
qmake && make

Two sub-directories will be created in the main directory: bin and libs.
The bin directory is where the Joysticks binary is placed and in the libs the required shared libraries.
The Joysticks binary should work OK from the bin directory.


Library dependencies from ldd for Joysticks binary on the authors system:
-------------------------------------------------------------------------
  libjoystick.so.0 => /../../usbJoysticks/libs/libjoystick.so.0 (0x00007f45cb63b000)
  libfile.so.0     => /../../usbJoysticks/libs/libfile.so.0 (0x00007f45c8bb9000)
	
	linux-vdso.so.1 =>  (0x00007fff9a325000)	
	libQtXmlPatterns.so.4 => /usr/local/Trolltech/Qt-4.7.3/lib/libQtXmlPatterns.so.4 (0x00007f45cafeb000)
	libQtNetwork.so.4 => /usr/local/Trolltech/Qt-4.7.3/lib/libQtNetwork.so.4 (0x00007f45cacaa000)
	libQtGui.so.4 => /usr/local/Trolltech/Qt-4.7.3/lib/libQtGui.so.4 (0x00007f45c9fc6000)
	libQtCore.so.4 => /usr/local/Trolltech/Qt-4.7.3/lib/libQtCore.so.4 (0x00007f45c9b1e000)
	libpthread.so.0 => /lib/libpthread.so.0 (0x00007f45c98de000)
	libstdc++.so.6 => /usr/lib/libstdc++.so.6 (0x00007f45c95da000)
	libm.so.6 => /lib/libm.so.6 (0x00007f45c9356000)
	libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00007f45c9140000)
	libc.so.6 => /lib/libc.so.6 (0x00007f45c8dbd000)
	librt.so.1 => /lib/librt.so.1 (0x00007f45c89b1000)
	libz.so.1 => /lib/libz.so.1 (0x00007f45c8799000)
	libgthread-2.0.so.0 => /usr/lib/libgthread-2.0.so.0 (0x00007f45c8593000)
	libglib-2.0.so.0 => /lib/libglib-2.0.so.0 (0x00007f45c82b1000)
	libpng12.so.0 => /lib/libpng12.so.0 (0x00007f45c808a000)
	libfreetype.so.6 => /usr/lib/libfreetype.so.6 (0x00007f45c7e02000)
	libgobject-2.0.so.0 => /usr/lib/libgobject-2.0.so.0 (0x00007f45c7bb6000)
	libSM.so.6 => /usr/lib/libSM.so.6 (0x00007f45c79ad000)
	libICE.so.6 => /usr/lib/libICE.so.6 (0x00007f45c7791000)
	libXrender.so.1 => /usr/lib/libXrender.so.1 (0x00007f45c7587000)
	libfontconfig.so.1 => /usr/lib/libfontconfig.so.1 (0x00007f45c7352000)
	libXext.so.6 => /usr/lib/libXext.so.6 (0x00007f45c713f000)
	libX11.so.6 => /usr/lib/libX11.so.6 (0x00007f45c6e09000)
	libdl.so.2 => /lib/libdl.so.2 (0x00007f45c6c05000)
	/lib64/ld-linux-x86-64.so.2 (0x00007f45cb85b000)
	libpcre.so.3 => /lib/libpcre.so.3 (0x00007f45c69d3000)
	libuuid.so.1 => /lib/libuuid.so.1 (0x00007f45c67ce000)
	libexpat.so.1 => /lib/libexpat.so.1 (0x00007f45c65a4000)
	libxcb.so.1 => /usr/lib/libxcb.so.1 (0x00007f45c6387000)
	libXau.so.6 => /usr/lib/libXau.so.6 (0x00007f45c6184000)
	libXdmcp.so.6 => /usr/lib/libXdmcp.so.6 (0x00007f45c5f7d000)