USB デバイス管理

WSL Dashboard は usbipd-win と統合することで、GUI インターフェース上でローカルの USB デバイスを WSL インスタンスに簡単に接続できるようにします。

事前準備

この機能を使用する前に、以下を確認してください：

1. Windows に usbipd-win がインストールされていること。
2. WSL カーネルが USB をサポートしていること（最新の WSL 2 デフォルトカーネルは通常サポート済み）。

使用手順

1. デバイスのスキャン

「USB」タブに入ると、アプリは現在 Windows に接続されているすべての USB デバイス（ハブ、マウス、ストレージデバイスなど）を自動的に一覧表示します。

2. デバイスのバインド (Bind)

特定の WSL インスタンスにデバイスを接続する前に、そのデバイスを「バインド」する必要があります。バインド操作には管理者権限が必要で、WSL Dashboard は権限昇格の要求を自動的に処理します。

バインド後、そのデバイスは WSL と共有する準備が整います。

3. インスタンスへの接続 (Attach)

実行中の WSL インスタンスを選択し、「接続 (Attach)」をクリックします。

• 接続が成功すると、その USB デバイスは Windows から消え、選択した WSL インスタンス内に表示されます。
• WSL 内で lsusb コマンドを使用して確認できます。

4. 接続の解除 (Detach)

操作が完了したら、「切断 (Detach)」をクリックします。デバイスは Windows の制御下に戻ります。

よくある問題

• デバイスが見つからない？: リストを更新してみるか、デバイスがホストに正しく挿入されているか確認してください。
• 接続に失敗する？: 対象の WSL インスタンスが実行中であることと、十分な権限があることを確認してください。
• usbipd コマンドが見つからない？: usbipd-win がインストールされ、システムの PATH 環境変数に追加されていることを確認してください。