この記事は何？
WSL2からUSBカメラを認識できるようにして、疎通試験として、OpenCV（Python）でカメラ映像を取得するまでの手順メモです。
WSL2はデフォルトではUSBデバイスにアクセスできません。usbipd-win というプログラムを使って、Windows側からWSL2側へデバイスをアタッチする必要があります。
環境
- Windows 11 + WSL2（Ubuntu）
- Python 3.12
- OpenCV（
opencv-python） - usbipd-win
手順
1. usbipd-win のインストール（Windows側）
未インストールの場合、PowerShellで以下を実行します。
winget install usbipd
2. USBカメラのBUSIDを確認（Windows側）
PowerShell（管理者）で実行します。
usbipd list
出力例：
Connected:
BUSID VID:PID DEVICE STATE
1-5 04bb:0556 XX-XXXXXX Not shared
カメラのBUSIDをメモします（この例では 1-5）。
3. WSL2へアタッチ（Windows側）
# 初回のみ必要（一度 bind したデバイスは次回以降スキップ可）
usbipd bind --busid 1-5
usbipd attach --wsl --busid 1-5
成功すると以下のようなメッセージが表示されます。
usbipd: info: Using WSL distribution 'Ubuntu' to attach; the device will be available in all WSL 2 distributions.
4. WSL2側でデバイス確認（WSL2側）
ls /dev/video*
/dev/video0 などが表示されれば認識成功です。
5. OpenCVのインストール（WSL2側）
pip install opencv-python
6. OpenCVで動作確認（WSL2側）
import cv2
cap = cv2.VideoCapture(0)
ret, frame = cap.read()
print(f"取得成功: {ret}, 解像度: {frame.shape}" if ret else "取得失敗")
cap.release()
取得成功: True, 解像度: (576, 1024, 3)
映像フレームが取得できれば、カメラは正常に動作しています。
デタッチ・再アタッチ
カメラを切断したい場合や、接続が切れた場合は以下を実行します。
# デタッチ
usbipd detach --busid 1-5
# 再アタッチ
usbipd attach --wsl --busid 1-5
ハマりポイント
デバイスは見えるのにOpenCVで開けない
/dev/video* が見えているのに cv2.VideoCapture(0) が失敗する場合、パーミッションを確認してください。
ls -la /dev/video*
groups
video グループに所属していなければ追加します。
sudo usermod -aG video $USER
変更後、WSLを完全に終了してから再起動してください。
# Windows側PowerShellで実行
wsl --shutdown
その後、WSLを再度起動すると変更が反映されます。