LinuxでXOWを使ってワイヤレスXbox Oneコントローラーを使用する方法

XOWを使用してLinux上でXbox Oneコントローラーをワイヤレスで使用するには、まずドライバーをビルドしてインストールし、アダプターのファームウェアを取得してsystemdサービスを開始し、次にコントローラーをXboxワイヤレスUSBアダプターとペアリングします。XOWはUSBアダプター用であり、Bluetooth用ではありません。

まずプロジェクトのステータスを確認してください。XOWのメンテナーは、XOWをメンテナンスモードとマークし、xoneを推奨しています。元のxoneプロジェクトは現在、活発に開発されているフォークを指しています。新規設定の場合は、アクティブなxoneフォークを確認してください。以下の手順は、XOWの公式ドキュメントに準拠しています。

互換性を確認してください

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開発ファイルをインストールしてください。

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. クローン、コンパイル、インストール

上流のソースコードを入手し、リリースバイナリをビルドしてインストールします。

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を有効にして、今すぐ起動してください。

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

XOWのREADMEファイルでは、手動での起動は推奨されておらず、インストール後に再起動が必要になる場合があると記載されています。サービスがアクティブになっているにもかかわらずアダプターが検出されない場合は、一度再起動してから再度ステータスを確認してください。

コントローラーをペアリングする

1. Xboxワイヤレスアダプターをコンピューターに接続し、XOWが起動するまで待ちます。
2. アダプターのペアリングボタンを、インジケーターが点滅するまで押し続けてください。
3. コントローラーの電源を入れ、Xboxボタンが点滅するまで同期ボタンを長押ししてください。デバイスは近くに置いてください。
4. コントローラーのランプが点灯したままの場合は、ゲームまたはLinuxの入力テストユーティリティを使用して、スティックとボタンの動作を確認してください。

コントローラーが最後にUSBまたはBluetooth経由で使用された場合、アダプターに自動的に再接続されないことがあります。ドングルと再度ペアリングしてください。Bluetooth接続には、Bluetooth対応のセットアップと別のドライバーが必要です。XOWはBluetoothをサポートしていません。

よくある問題のトラブルシューティング

サービスの状態と現在のブートログを確認してください。

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 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 ドキュメントを参照してください。