xone:Linux内核驱动，支持Xbox One/Series X|S配件，替代xpad兼容GIP协议

xone 是一款适用于 Xbox One 和 Xbox Series X|S 配件的 Linux 内核驱动程序。它作为 xpad 的现代替代品，旨在与微软的 游戏输入协议（GIP）兼容。

兼容性

• 有线设备（通过 USB）
• 无线设备（搭配 Xbox 无线适配器）
• 蓝牙设备（可查看 xpadneo）

安装 xone 会禁用 xpad 内核驱动程序。如果您仍在使用 Xbox 或 Xbox 360 外设，则必须安装 xpad-noone 作为 xpad 的替代品。

功能

• 输入和力反馈（震动）
• 电池状态报告（UPower 集成）
• LED 控制（使用 /sys/class/leds）
• 音频捕获/播放（通过 ALSA）
• 电源管理（挂起/恢复以及远程/无线唤醒）

支持的设备

• 游戏手柄
  • Xbox One 控制器
  • Xbox Series X|S 控制器
  • Xbox 自适应控制器
  • 第三方控制器（PowerA、PDP 等）
• 耳机
  • Xbox One 聊天耳机
  • Xbox One 立体声耳机（带适配器或插孔）
  • Xbox 无线耳机
  • 第三方无线耳机（SteelSeries、Razer 等）
• 吉他和鼓
  • Mad Catz Rock Band 4 无线芬达 Stratocaster 吉他
  • Mad Catz Rock Band 4 无线鼓组
  • PDP Rock Band 4 无线芬达 Jaguar 吉他
• Xbox One 聊天板
• 第三方方向盘（Thrustmaster、Logitech 等）

发布版本

欢迎为任何 Linux 发行版或硬件打包 xone。有关打包的任何问题，请向相应的维护者报告。

安装

先决条件

• Linux（内核 5.13 及以上版本和头文件）
• DKMS
• curl（用于固件下载）
• cabextract（用于固件提取）

指南

1. 拔下您的 Xbox 设备。

2. 克隆仓库：

git clone https://github.com/medusalix/xone

3. 安装 xone：

cd xone
sudo ./install.sh

注意： 你可以使用 --release 标志来禁用调试日志。

4. 下载无线适配器的固件：

sudo xone-get-firmware.sh

注意： --skip-disclaimer 标志可能在脚本编写时有用。

5. 插入您的 Xbox 设备。

更新

更新前请确保完全卸载 xone：

sudo ./uninstall.sh

无线配对

Xbox 设备必须与无线适配器进行配对。如果设备之前已插入 USB 端口或通过蓝牙使用过，则不会自动连接到适配器。

配对设备的说明可在此处找到（请参阅“Xbox Wireless”部分）。

LED 控制

可通过 sysfs 控制指南按钮的 LED：

echo 2 | sudo tee /sys/class/leds/gip*/mode
echo 5 | sudo tee /sys/class/leds/gip*/brightness

通过上述方式更改LED是临时的，仅在设备断开连接前有效。若要在设备连接时自动应用这些设置，你可以在 /etc/udev/rules.d/50-xone.rules 中创建一条新的 udev 规则，内容如下：

ACTION=="add", SUBSYSTEM=="leds", KERNEL=="gip*", ATTR{mode}="2", ATTR{brightness}="5"

如果您想控制特定设备的 LED，请替换通配符（gip*）。

不同设备的模式和最大亮度可能有所不同。

故障排除

卸载发布版本并安装 xone 的调试构建版本（请参阅安装指南）。

运行 sudo dmesg 收集日志，并检查是否有任何与 xone 相关的错误消息。

如果 xone 未自动加载，您可能需要重启系统。

错误消息

• Direct firmware load for xow_dongle.bin failed with error -2
  • 下载无线适配器的固件（请参阅安装指南）。

输入问题

您可以使用 evtest 和 fftest 来检查设备的输入和力反馈功能。

其他问题

如有任何其他问题，请加入 Discord 服务器。

许可证

xone 是根据 GNU 通用公共许可证第 2 版 发布的。

Copyright (C) 2021 Severin von Wnuck-Lipinski

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.