USB デバイスを接続する

[アーティクル]
04/16/2024

このガイドでは、USB/IP オープンソースプロジェクト usbipd-win を使用して、WSL 2 で実行されている Linux ディストリビューションに USB デバイスを接続するために必要な手順について説明します。

お使いの Windows マシンで USB/IP プロジェクトを設定すると、Arduino へのフラッシュ書き込みやスマートカードリーダーへのアクセスなど、開発者にとって一般的な USB シナリオが有効になります。

前提条件

Windows 11 (ビルド 22000 以降) が実行されている。 (Windows 10 対応可、詳細は以下の注意を参照)。
x64 プロセッサを搭載したマシンが必要です。 (x86 と Arm64 は現在、usbipd-win ではサポートされていません)。
WSL がインストールされ、最新バージョンで設定されています。
Linux ディストリビューションがインストールされており、かつ WSL 2 に設定されている。

Note

Windows のバージョンとビルド番号を確認するには、Windows ロゴキー + R キーを押して、「winver」と入力し、[OK] を選択します。 [スタート]>[設定]>[Windows Update]>[更新プログラムの確認] を選択して、最新の Windows バージョンに更新できます。 Linux カーネルのバージョンを確認するには、お使いの Linux ディストリビューションを開き、コマンド「uname -a」を入力します。最新のカーネルに手動で更新するには、PowerShell を開き、コマンド wsl --update を入力します。

重要

WSL では、Windows 10 と Windows 11 の両方が Microsoft Store でサポートされるようになりました。つまり、Windows 10 のユーザーは、ソースからコンパイルしなくても、最新のカーネルバージョンにアクセスできるようになりました。 Store でサポートされるバージョンの WSL に更新する方法については、Microsoft Store の WSL で Windows 10 と 11 が一般提供されるようになったことに関する記事をご覧ください。 Store でサポートされるバージョンの WSL に更新できず、カーネルの更新プログラムを自動的に受け取る場合は、独自の USBIP 対応 WSL 2 カーネルをビルドし、WSL 2 で実行されている Linux ディストリビューションに USB デバイスを接続する手順について、USBIPD-WIN プロジェクトのリポジトリをご覧ください。

USBIPD-WIN プロジェクトをインストールする

USB デバイスの接続のサポートは WSL ではネイティブに使用できないので、オープンソースの usbipd-win プロジェクトをインストールする必要があります。

カーネルの要件

Linux 用 Windows サブシステム (WSL) で USBIPD を使用するには、Linux カーネルのバージョン 5.10.60.1 以降が必要です。インストールされているカーネルのバージョンが 5.10.60.1 より以前の場合、最初に wsl --shutdown を使用して WSL の実行中のインスタンスをシャットダウンし、コマンド wsl --update を実行すると更新できます。

WSL に USBIPD をインストールする

usbipd-win プロジェクトの最新リリースのページに移動します。
.msi を選択します。これにより、インストーラーがダウンロードされます。 (このダウンロードを信頼するかどうかを確認する警告が表示される場合があります)。
ダウンロードした usbipd-win_x.msi インストーラーファイルを実行します。

Note

代わりに、Windows パッケージマネージャー (winget) を使用して usbipd-win プロジェクトをインストールすることもできます。 winget が既にインストールされている場合は、単にコマンド winget install --interactive --exact dorssel.usbipd-win を使用して usbipd-win をインストールするだけです。 --interactive を省略すると、ドライバーのインストールに必要な場合に、winget によってコンピューターが即座に再起動されます。

これにより、次のものがインストールされます。

usbipd という名前のサービス (表示名: USBIP Device Host)。このサービスの状態は、Windows のサービスアプリを使用して確認できます。
コマンドラインツールusbipd。このツールの場所は、PATH 環境変数に追加されます。
すべてのローカルサブネットにサービスに接続することを許可する、usbipd と呼ばれるファイアウォール規則。このファイアウォール規則は、アクセス制御を微調整するために変更を加えることができます。