**Xbox/Xbox360 USB 游戏手柄驱动用户空间指南**

Xbox/Xbox360 USB 游戏手柄驱动用户空间指南

xboxdrv xboxdrv is discontinued, use the kernel driver 项目地址: https://gitcode.com/gh_mirrors/xb/xboxdrv

Xboxdrv 是专为 Linux 设计的 Xbox 和 Xbox360 游戏手柄驱动程序，它在用户空间运行，提供对 Xbox1 游戏手柄、Xbox360 有线游戏手柄以及无线手柄的支持。此驱动还支持基础的 Xbox360 聊天键盘（限USB连接），但不包含 Xbox 360 竞速方向盘的支持。对于那些xpad内核驱动无法满足需求或需要更多自定义选项的用户来说，xboxdrv是个不错的选择。

安装指南

必要的库与工具

• g++ - GNU C++ 编译器
• libusb-1.0
• pkg-config
• libudev
• Boost
• SCons 构建工具
• uinput 内核模块（用于用户空间输入）
• Git （仅当从源代码下载时需要）
• X11
• libdbus
• glib

在Ubuntu 10.10上安装依赖：

sudo apt-get install g++ libboost1.42-dev scons pkg-config libusb-1.0-0-dev git-core libx11-dev libudev-dev x11proto-core-dev libdbus-glib-1-dev

加载 uinput 模块

自动加载至启动时，在 /etc/modules 中添加 uinput 或手动加载：

sudo modprobe uinput

项目使用说明

1. 下载最新版本的源代码：

   git clone http://pingus.seul.org/~grumbel/xboxdrv.git
   

2. 编译项目： 进入克隆后的目录并执行：

   scons
   

API 使用文档

本驱动主要通过命令行参数进行配置。详细的命令行参数和配置可以通过阅读 doc/xboxdrv.1 文件来获取，若已安装，通过 man xboxdrv 访问；未安装的话，则直接在源码的 doc/ 目录下查找相应的.1文件，并使用 man -l 文件路径 查看。

运行示例

• 基础使用：

  ./xboxdrv
  

• 自定义配置（例如模拟键盘按键）：

  ./xboxdrv --dpad-as-keys
  

项目安装

编译完成后，可以选择安装到系统：

make install

也可以指定安装前缀和目标目录：

make install PREFIX=/usr DESTDIR=/tmp

并非必需安装，直接从源代码目录运行也是完全可行的。

作为守护进程运行

为了在系统启动时自动启动xboxdrv，需将 data/org.seul.Xboxdrv.conf 文件复制到 /etc/dbus-1/system.d/ 目录中，避免权限问题导致的错误。

---

以上即为xboxdrv的安装、使用和配置的基本指南，通过上述步骤，您可以顺利地在Linux系统上配置并使用这款强大的游戏手柄驱动程序。记住，深入理解每个配置项能够帮助您更好地定制化体验。

xboxdrv xboxdrv is discontinued, use the kernel driver 项目地址: https://gitcode.com/gh_mirrors/xb/xboxdrv