xone驱动完全解析：从安装到配置的快速入门教程

【免费下载链接】xoneLinux kernel driver for Xbox One and Xbox Series X|S accessories项目地址: https://gitcode.com/gh_mirrors/xone1/xone

xone是一款专为Linux系统设计的Xbox One和Xbox Series X|S配件内核驱动，作为xpad的现代替代品，它提供了对微软官方及第三方游戏手柄、耳机等设备的全面支持。本教程将带你快速掌握xone驱动的安装与配置方法，让你的Linux系统完美支持Xbox系列游戏配件。

📋 支持设备清单

xone驱动支持丰富的Xbox配件类型，包括但不限于：

• 官方设备：Xbox One/Series X|S无线手柄、聊天耳机、立体声耳机
• 第三方设备：PowerA、PDP等品牌的有线/无线游戏手柄（driver/gamepad.c）
• 音频设备：SteelSeries、Razer等品牌的第三方有线/无线耳机（driver/headset.c）

⚠️ 注意：xone不支持Xbox 360控制器。如果需要同时使用Xbox 360设备，建议安装xpad-noone作为替代驱动。

🚀 快速安装指南

手动安装步骤

1. 克隆仓库

   git clone https://gitcode.com/gh_mirrors/xone1/xone cd xone

2. 安装驱动

   sudo make install

   如需启用调试日志，可使用install-debug目标：sudo make install-debug

3. 安装无线适配器固件（可选）

   sudo install/firmware.sh

   固件文件将安装为xone_dongle_*.bin格式（install/firmware.sh）

Steam Deck专用安装

Steam Deck用户可通过专用脚本一键安装：

sudo sh -c "$(curl -fsSL https://raw.githubusercontent.com/dlundqvist/xone/master/install/steam-deck-install.sh)"

该脚本会自动处理依赖关系并安装xone-dkms包和固件（install/steam-deck-install.sh）

⚙️ 配置与使用

模块冲突处理

xone安装过程中会自动创建黑名单配置，禁用冲突的内核模块：

• 通过/etc/modprobe.d/xone-blacklist.conf禁用xpad驱动（install.sh）
• 避免mt76x2u驱动与无线适配器冲突

无线设备配对

1. 进入配对模式

   echo 1 | sudo tee /sys/bus/usb/drivers/xone-dongle/*/pairing

2. 查看已连接设备

   cat /sys/bus/usb/drivers/xone-dongle/*/active_clients

3. 关闭配对模式

   echo 0 | sudo tee /sys/bus/usb/drivers/xone-dongle/*/pairing

电源管理

关闭无线适配器电源：

sudo tee /sys/bus/usb/drivers/xone-dongle/*/poweroff <<< 1

重新开启：

sudo tee /sys/bus/usb/drivers/xone-dongle/*/poweroff <<< -1

🔧 故障排除

驱动加载问题

如果驱动未自动加载，可尝试：

1. 重启系统
2. 检查DKMS状态：dkms status xone
3. 查看系统日志：sudo dmesg | grep xone

调试构建

如需调试，可安装调试版本：

sudo make uninstall sudo make install-debug

🗑️ 卸载方法

如需卸载xone驱动，执行：

sudo ./uninstall.sh

该脚本会移除DKMS模块、配置文件和固件（uninstall.sh）

📄 许可证信息

xone驱动基于GNU通用公共许可证第2版发布（LICENSE），欢迎为任何Linux发行版或硬件打包该驱动。

通过本教程，你已掌握xone驱动的完整安装、配置和故障排除流程。无论是游戏手柄还是耳机，xone都能为你的Xbox配件提供稳定可靠的Linux支持，让你在开源系统上畅享游戏乐趣！

【免费下载链接】xoneLinux kernel driver for Xbox One and Xbox Series X|S accessories项目地址: https://gitcode.com/gh_mirrors/xone1/xone