如何在 Linux 系統上使用 XOW 連接無線 Xbox One 控制器

要在 Linux 系統上使用 XOW 無線連接 Xbox One 控制器，請先編譯並安裝驅動程序，獲取適配器固件，啟動其 systemd 服務，然後將控制器與 Xbox 無線 USB 適配器配對。 XOW 僅支援 USB 轉接器，不支援藍牙。

首先檢查專案狀態： XOW 的維護者將其標記為維護模式，並建議使用 xone。原 xone 專案現在指向一個正在積極開發的分支。如果是新配置，請查看活躍的 xone 分支。以下步驟遵循 XOW 的官方文件。

一台 Linux 筆記型電腦旁邊放著 Xbox One 控制器和無線 USB 轉接器。 — XOW 可與 Xbox 無線 USB 轉接器搭配使用；藍牙則使用另一種設定。

檢查相容性

XOW 是一個用戶空間驅動程式：它透過 libusb 與適配器通信，並透過 Linux 的 uinput 介面公開控制器輸入。核心內建的 xpad 驅動程式無法處理透過此轉接器進行的 Xbox One 無線連線。

XOW 的 README 檔案列出了超薄型和標準尺寸的轉接器，以及 Surface Book 2 的內建轉接器。它指出控制器型號 1537、1697、1698、1708 和 1797 可正常工作；型號 1914 未經測試。其最低配置要求為 Linux 核心 4.5 和 systemd 232。硬體和發行版差異仍可能影響結果。

安裝並建置 XOW

1. 安裝必備組件

在 Ubuntu 或 Debian 系統上，安裝 Git、建置工具、curl、cabextract 和 libusb 開發檔案：

Ubuntu 風格的終端機顯示建置 XOW 所需的軟體包 — 安裝編譯器、建置工具、curl、cabextract 和 libusb 開發套件。

sudo apt update
sudo apt install git build-essential curl cabextract libusb-1.0-0-dev

在 Fedora、Arch、openSUSE 或其他發行版上，使用對應的軟體套件管理器安裝對應的軟體套件。軟體包名稱可能有所不同；請尋找 Git、make、C++ 編譯器、curl、cabextract、libusb 開發檔案和 systemd。

2. 克隆、編譯和安裝

取得上游原始碼，建立發布版本二進位文件，然後安裝它：

使用終端命令克隆 medusalix/xow 並切換到其資料夾 — 克隆 XOW 原始碼庫並開啟專案目錄。

編譯和安裝 XOW 的終端命令 — 編譯發布版本，然後安裝二進位、規則和 systemd 服務。

git clone https://github.com/medusalix/xow
cd xow
make BUILD=RELEASE
sudo make install

安裝前請閱讀上游的 README 文件。sudo make install程式會寫入系統檔案並以管理員權限執行，因此請使用官方倉庫，而不是未經審核的原始程式碼存檔或分支。

3. 取得適配器韌體

XOW 的輔助程式會下載並提取無線適配器所需的韌體。安裝完成後執行該程式：

sudo xow-get-firmware.sh

該專案列出了 curl 和 cabextract 用於此步驟。如果失敗，請查看錯誤訊息和目前的 README 說明，而不是使用不相關的韌體檔案。

4. 啟用並啟動服務

啟用 XOW 開機啟動並立即啟動：

使用終端命令啟用並啟動 XOW systemd 服務 — 啟用 XOW 以便將來啟動時執行，並在目前會話中執行該服務。

sudo systemctl enable xow
sudo systemctl start xow
systemctl status xow --no-pager

XOW 的 README 檔案不建議手動啟動該服務，並指出安裝後可能需要重新啟動。如果服務已啟動但未偵測到適配器，請重新啟動一次並再次檢查狀態。

將控制器配對

Xbox 控制器和無線轉接器放在一台 Linux 筆記型電腦旁邊，配對按鈕清晰可見。 — 按下適配器和控制器上的配對按鈕進行連線。

將 Xbox 無線轉接器插入電腦，等待 XOW 啟動。
按下適配器的配對按鈕，直到指示燈閃爍。
開啟控制器，然後按住其同步按鈕，直到 Xbox 按鈕閃爍。保持設備靠近。
當控制器指示燈常亮時，請在遊戲或 Linux 輸入測試工具中測試搖桿和按鈕。

如果控制器上次是透過 USB 或藍牙連接，則可能無法自動重新連接到轉接器。請將其與適配器重新配對。藍牙連接需要支援藍牙的裝置以及不同的驅動程式；XOW 不提供藍牙支援。

解決常見問題

檢查服務狀態和目前啟動日誌：

終端機指令檢查 XOW 服務狀態和啟動日誌 — 使用 systemd 狀態和日誌輸出診斷連線問題。

systemctl status xow --no-pager
journalctl -u xow -b --no-pager

InputException: No such file or directoryXOW無法存取/dev/uinput。請檢查 uinput 模組是否可用；嘗試sudo modprobe uinput重新啟動 XOW。
Permission denied或LIBUSB_ERROR_ACCESS：檢查 XOW 安裝的 udev 規則並解決衝突規則。修復權限後重新插拔適配器。
LIBUSB_ERROR_BUSY或者LIBUSB_ERROR_NO_DEVICE：其他進程或驅動程式可能正在使用該加密狗。請停止執行重複的 XOW 實例，並避免針對相同適配器執行其他驅動程式。
LIBUSB_ERROR_TIMEOUT嘗試使用另一個 USB 連接埠。 XOW 報告稱，某些 ASMedia USB 控制器有問題；使用 USB 集線器可能有助於解決 USB 3 電源管理逾時問題。
韌體錯誤：請確認韌體助理已完成。如果其他驅動程式可能已載入固件，請拔下適配器，重新連接，然後執行sudo systemctl restart xow。

停止或移除 XOW

使用以下命令暫時停止服務sudo systemctl stop xow。若要阻止開機啟動，請執行下列命令sudo systemctl disable xow。要移除該服務，請停止並停用它，返回克隆的xow目錄，然後按照 README 文件中的清理說明進行操作（該說明使用以下sudo make uninstall命令）。在切換驅動程式之前移除 XOW，以免它們爭奪適配器。

有關最新詳情，請參閱官方 XOW README、原始 xone README和Linux 核心 xpad 文件。