xboxdrv/README

103 lines
2.6 KiB
Text
Raw Normal View History

[[ Xbox/Xbox360 USB Gamepad Driver for Userspace ]]
===================================================
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
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
* 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
$ 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
$ 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 \
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 \
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:
$ sudo modprobe uinput
2009-01-01 19:21:16 -07:00
On other distributions exact install instructions might be
slightly different.
2010-05-07 05:23:03 -06:00
[[ Installation ]]
------------------
Once the compilation process is complete you can install xboxdrv with:
$ make install
2010-05-07 05:23:03 -06:00
You can also change the install PREFIX and DESTDIR as usual with:
2010-05-07 05:23:03 -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-07 05:23:03 -06:00
[[ Running ]]
-------------
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
$ man -l doc/xboxdrv.1
Documentation on xboxdrv-daemon, a daemon that will automatically
launch xboxdrv when a pad is plugged in can be read via:
$ man -l doc/xboxdrv-daemon.1
2008-05-02 15:54:57 -06:00
2008-04-11 05:43:15 -06:00
# EOF #