2008-05-02 10:19:59 -06:00
|
|
|
|
[[ Xbox/Xbox360 USB Gamepad Driver for Userspace ]]
|
2008-04-13 12:09:02 -06:00
|
|
|
|
===================================================
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2011-01-26 16:09:18 -07:00
|
|
|
|
Xboxdrv is a Xbox/Xbox360 gamepad driver for Linux that works in
|
2008-12-26 21:13:00 -07:00
|
|
|
|
userspace. It is an alternative to the xpad kernel driver and has
|
2008-05-02 10:19:59 -06:00
|
|
|
|
support for Xbox1 gamepads, Xbox360 USB gamepads and Xbox360 wireless
|
|
|
|
|
gamepads. The Xbox360 guitar and some Xbox1 dancemats might work too.
|
2009-01-06 23:07:42 -07:00
|
|
|
|
The Xbox 360 racing wheel is not supported, but shouldn't be to hard
|
|
|
|
|
to add if somebody is interested.
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2011-01-26 16:09:18 -07:00
|
|
|
|
Some basic support for the Xbox360 Chatpad on USB controller is
|
|
|
|
|
provided, Chatpad on wireless ones is not supported. The headset is
|
|
|
|
|
not supported, but you can dump raw data from it.
|
2008-12-26 21:13:00 -07:00
|
|
|
|
|
2008-06-11 11:11:09 -06:00
|
|
|
|
This driver is only of interest if the xpad kernel driver doesn't work
|
2009-01-06 23:07:42 -07:00
|
|
|
|
for you or if you want more configurabity. If the xpad kernel driver
|
|
|
|
|
works for you there is no need to try this driver.
|
2008-06-11 11:11:09 -06:00
|
|
|
|
|
2009-01-01 19:21:16 -07:00
|
|
|
|
Newest version of the driver can be found at:
|
|
|
|
|
|
|
|
|
|
* http://pingus.seul.org/~grumbel/xboxdrv/
|
|
|
|
|
|
|
|
|
|
The development version can be optained via:
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2009-01-01 19:21:16 -07:00
|
|
|
|
* git clone http://pingus.seul.org/~grumbel/xboxdrv.git
|
|
|
|
|
|
|
|
|
|
|
2008-04-11 05:43:15 -06:00
|
|
|
|
[[ Compilation ]]
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
Required libraries and tools:
|
|
|
|
|
|
2009-08-20 04:00:53 -06:00
|
|
|
|
* g++ - GNU C++ Compiler
|
2011-01-14 05:08:04 -07:00
|
|
|
|
* libusb-1.0
|
2011-01-27 16:01:52 -07:00
|
|
|
|
* pkg-config
|
|
|
|
|
* libudev
|
2008-04-11 05:43:15 -06:00
|
|
|
|
* boost
|
|
|
|
|
* scons
|
2009-01-01 19:21:16 -07:00
|
|
|
|
* uinput (userspace input kernel module)
|
|
|
|
|
* git (only to download the development version)
|
2009-01-18 10:43:00 -07:00
|
|
|
|
* X11
|
2009-02-19 12:16:13 -07:00
|
|
|
|
* python-dbus (for xboxdrv-daemon.py)
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2009-01-06 23:07:42 -07:00
|
|
|
|
Once everything installed, you can compile by typing:
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ scons
|
2008-04-11 05:43:15 -06:00
|
|
|
|
|
2011-01-14 05:08:04 -07:00
|
|
|
|
On Ubuntu 10.10 you can install all the required libraries via:
|
2009-01-01 19:21:16 -07:00
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ sudo apt-get install \
|
2009-08-20 04:00:53 -06:00
|
|
|
|
g++ \
|
2011-01-14 05:08:04 -07:00
|
|
|
|
libboost1.42-dev \
|
|
|
|
|
libboost-thread1.42-dev \
|
2009-01-19 23:29:18 -07:00
|
|
|
|
scons \
|
2011-01-27 16:01:52 -07:00
|
|
|
|
pkg-config \
|
2011-01-14 05:08:04 -07:00
|
|
|
|
libusb-1.0-0-dev \
|
2009-01-19 23:29:18 -07:00
|
|
|
|
git-core \
|
|
|
|
|
libx11-dev \
|
2011-01-27 16:01:52 -07:00
|
|
|
|
libudev-dev \
|
2009-02-19 12:16:13 -07:00
|
|
|
|
x11proto-core-dev \
|
|
|
|
|
python-dbus
|
2009-01-01 19:21:16 -07:00
|
|
|
|
|
|
|
|
|
To load the uinput kernel module automatically on boot add it
|
|
|
|
|
/etc/modules, to load it manually type:
|
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ sudo modprobe uinput
|
2009-01-01 19:21:16 -07:00
|
|
|
|
|
|
|
|
|
On other distributions exact install instructions might be
|
|
|
|
|
slightly different.
|
2010-05-08 09:20:06 -06:00
|
|
|
|
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
|
|
|
|
[[ Installation ]]
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
Once the compilation process is complete you can install xboxdrv with:
|
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ make install
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
You can also change the install PREFIX and DESTDIR as usual with:
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ make install PREFIX=/usr DESTDIR=/tmp
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
|
|
|
|
Note that there is no need to install xboxdrv, you can run it directly
|
|
|
|
|
from the source directory if you prefer.
|
2010-05-08 09:20:06 -06:00
|
|
|
|
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
|
|
|
|
[[ Running ]]
|
|
|
|
|
-------------
|
|
|
|
|
|
2010-05-08 09:20:06 -06:00
|
|
|
|
Extensive documentation on running xboxdrv can be found in the RUNNING
|
|
|
|
|
XBOXDRV section of the xboxdrv manpage. When you haven't installed
|
|
|
|
|
xboxdrv the man page can be found in doc/xboxdrv.1 and be read with:
|
2010-05-07 05:23:03 -06:00
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ man -l doc/xboxdrv.1
|
2010-05-08 09:20:06 -06:00
|
|
|
|
|
|
|
|
|
Documentation on xboxdrv-daemon, a daemon that will automatically
|
|
|
|
|
launch xboxdrv when a pad is plugged in can be read via:
|
|
|
|
|
|
2010-06-02 11:54:33 -06:00
|
|
|
|
$ man -l doc/xboxdrv-daemon.1
|
2008-05-02 15:54:57 -06:00
|
|
|
|
|
2008-12-26 16:41:08 -07:00
|
|
|
|
|
2008-04-11 05:43:15 -06:00
|
|
|
|
# EOF #
|