Go to Qiita Advent Calendar 2024 Top
LoginSignup
74
58

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 1 year has passed since last update.

@baggio

WSL2環境からUSBシリアルデバイスを使う

Last updated at Posted at 2022-01-09

WSL2環境からUSBシリアルデバイスを使う方法についてのメモ書きです。

標準WSL2環境のままではUSBデバイスを認識することができないのですが、ここに書いたusbipd-winツールを使用すればUSBデバイスをWindowsホスト側で使うかWSL2側で使うかを切り替えることができるようになります。

また、Arduino、ESP32、Spresenseといったボードの開発でWSL2を使用する場合、標準のWSL2 kernel(5.10.74.3)にはUSBシリアルドライバが含まれていないので、そのままでは使えません。USBシリアルドライバを有効にしたWSL2 kernelを作成する必要があります。ここに書いた方法でWSL2 kernelを更新することで、WSL2環境からUSBシリアルターミナルを表示したり、WSL2環境からUSBシリアル経由でプログラムの書き込みを実行することができるようになります。

事前環境

インストール

usbipd-winツールをインストールする

  1. usbipd-winのリリースページから 最新のusbipd-win_バージョン.msi (例:usbipd-win_1.3.0.msi)をダウンロードする
  • usbipd-win_バージョン.msi を実行してWindowsPCへインストールする

WSL2環境へUSBIPツールをインストールする

  1. WSL2コマンドプロンプトからlinux-toolsとhwdataをaptコマンドでインストールする
WSL
$ sudo apt install linux-tools-5.4.0-77-generic hwdata
  1. usbipコマンドを実行するためにsudo権限を変更します。visudoコマンドでsudoersファイルを編集するためにnanoエディタを起動します
WSL
$ sudo visudo
  1. secure_pathに/usr/lib/linux-tools/5.4.0-77-genericを追加します
sudoersファイルを編集する
Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."

USBデバイスの接続方法

  1. PowerShellを管理者権限で起動します
  2. WindowsPCとUSB機器を接続した状態で、USBデバイスリストを表示します
  • ここでの例はBUSIDに1-1にSilicon Labs CP210x USB to UART Bridgeが表示されています
  • STATEはNot attached状態になっています
PowerShell(例)
PS C:\windows\system32> usbipd wsl list
BUSID  DEVICE                                         STATE
1-1    Silicon Labs CP210x USB to UART Bridge (COM4)  Not attached
1-3    USB 入力デバイス                                 Not attached
  1. USBデバイスのうちWSL2から使用するデバイスのBUSIDを選択してattachします
  • ここでの例はBUSIDに1-1を指定します
  • attach後にもう一度list表示するとSTATEがAttached状態に変更されていることを確認できます
PowerShell(例)
PS C:\windows\system32> usbipd wsl attach --busid 1-1
[sudo] password for mario: （ここでパスワードを入力する）
PowerShell(例)
PS C:\windows\system32> usbipd wsl list
BUSID  DEVICE                                         STATE
1-1    Silicon Labs CP210x USB to UART Bridge (COM4)  Attached - Ubuntu-20.04
1-3    USB 入力デバイス
  1. WSL2側で、lsusbコマンドを実行する
  • Silicon Labs CP210x UART Bridgeが接続されていることが確認できます
WSL(例)
$ lsusb
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 004: ID 10c4:ea60 Silicon Labs CP210x UART Bridge
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

ただしこの時点では、CP210xドライバがインストールされておらず、/dev/ttyUSB0デバイスが見つかりません。/dev/ttyUSB0として利用するためには、後述する WSL2 kernelのビルドが必要になります

  1. もし、USB接続をWindows側に戻したいときは、BUSIDを指定してdetachを実行するか、もしくはUSBを抜き差しすると元に戻ります
  • ここでの例はBUSIDに1-1を指定してdetachを実行しています
  • detach後にもう一度list表示するとSTATEがNot attached状態に変わっていることが分かります
PowerShell(例)
PS C:\windows\system32> usbipd wsl detach --busid 1-1
PowerShell(例)
PS C:\windows\system32> usbipd wsl list
BUSID  DEVICE                                         STATE
1-1    Silicon Labs CP210x USB to UART Bridge (COM4)  Not attached
1-3    USB 入力デバイス                                 Not attached

CP210X USBドライバを認識させるためにkernelをリビルドする

  1. Kerelビルドに必要なツールをaptコマンドでインストールします
WSL
$ sudo apt install build-essential flex bison libssl-dev libelf-dev dwarves libncurses-dev
  1. WSL2リポジトリをクローンします
WSL
$ git clone https://github.com/microsoft/WSL2-Linux-Kernel.git
$ cd WSL2-Linux-Kernel
  1. menuconfigを開いてCONFIG_USB_SERIAL_CP210Xを有効にします
WSL
$ make menuconfig KCONFIG_CONFIG=Microsoft/config-wsl

wsl-menuconfig.png

  • Spresenseで使用するUSB CP210x family of UART Bridge Controllers(CONFIG_USB_SERIAL_CP210X)は次の階層にあります
-> Device Drivers
　　-> USB support (USB_SUPPORT [=y])
　　　　-> USB Serial Converter support (USB_SERIAL [=y])
  1. WSL2 kernelをビルドします
WSL
$ make -j4 KCONFIG_CONFIG=Microsoft/config-wsl
  1. ビルドしたイメージをWindowsディレクトリにコピーします
  • ユーザー名のmarioは、自分のユーザー名に置き換えてください
WSL(例)
$ cp arch/x86/boot/bzImage /mnt/c/Users/mario/wsl_kernel
  1. Windows側に.wslconfigファイルを作成して、kernel=でさきほど作成したwsl_kernelを指定します
WSL(例)
$ nano /mnt/c/Users/mario/.wslconfig
.wslconfig編集(例)
[wsl2]
kernel = C:\\Users\\mario\\wsl_kernel
  1. WSLを一旦シャットダウンします
PowerShell
PS C:\windows\system32> wsl --shutdown
  1. WSL2を再び起動します
  • WSL2起動後にバージョンを確認すると新しいカーネルで起動していることを確認できます
  • /proc/config.gz で CONFIG_USB_SERIAL_CP210Xが有効になっていることを確認できます
WSL
$ cat /proc/version
Linux version 5.10.74.3-microsoft-standard-WSL2+ (mario@DESKTOP-UKT9H1D) (gcc (Ubuntu 9.3.0-17ubuntu1~20.04) 9.3.0, GNU ld (GNU Binutils for Ubuntu) 2.34) #1 SMP Fri Jan 7 00:32:37 JST 2022
WSL
$ zcat /proc/config.gz | grep CONFIG_USB_SERIAL_CP210X
CONFIG_USB_SERIAL_CP210X=y
  1. USBデバイスの接続方法 をもう一度実行します
  • USBシリアルデバイスドライバが正常に動作していれば/dev/ttyUSB0が表示されます

TIPS

usbipdを実行したときにusbipd: warning: Server is currently not running.が表示される

PowerShell
PS C:\windows\system32> usbipd wsl list
BUSID  DEVICE                                         STATE
1-1    Silicon Labs CP210x USB to UART Bridge (COM4)  Not attached
1-3    USB 入力デバイス                                 Not attached
usbipd: warning: Server is currently not running.

usbipd-win_バージョン.msiを起動してRepairを実行すると治ります
usbip-win-repair.png

メモ追記(2022/06/05)

WSL2をUbuntu22.04に更新したときにusbipdの利用手順が変わっていたことに気が付いたので追記。

usbipd-winのリリースページから最新版usbipd-win_2.3.0.msiを落としてきて更新する。

あとはこちらのWikiページを参考に、

WSL
$ sudo apt upgrade
$ sudo apt update
WSL
$ sudo apt install linux-tools-virtual hwdata
$ sudo update-alternatives --install /usr/local/bin/usbip usbip /usr/lib/linux-tools/*/usbip 20
74
58
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
74
58

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?