版权归作者所有，如有转发，请注明文章出处：https://cyrus-studio.github.io/blog/
WSL 本身并不支持连接 USB 设备，因此你需要安装开源 usbipd-win 项目。
usbip 可以让你在网络上共享和使用 USB 设备。它由两个主要组件组成：
- usbipd (USB/IP daemon)：服务端，负责共享连接到主机的 USB 设备。
- usbip (USB/IP client)：客户端，允许其他计算机访问共享的 USB 设备。
1. 安装USBIPD-WIN
USBIPD-WIN 是一个在 Windows 上实现 USB/IP 协议的工具。首先，你需要在 Windows 上安装这个工具。
下载并安装 usbipd-win，可以从GitHub页面获取最新版本的安装包。
或者执行下面命令安装
winget install usbipd
2. 列出所有可以共享的USB设备
usbipd list
3. 共享设备
在附加 USB 设备之前，必须使用命令 usbipd bind 来共享设备，从而允许它附加到 WSL（ 需要管理员权限）。
usbipd bind --busid 2-6
这里的 2-6 是 USB 设备对应的 BUSID
4. 将USB设备连接到WSL
使用 usbipd attach 命令将指定的USB设备附加到WSL实例中。
usbipd attach --wsl --busid 2-6
打开 Ubuntu（或首选的 WSL 命令行），使用以下命令列出附加的 USB 设备：
lsusb
你应会看到刚刚附加的设备，并且能够使用常规 Linux 工具与之交互。
5. 安装USBIP
在 WSL 环境下，usbip 允许你在 Linux 子系统中访问连接到 Windows 主机的 USB 设备。
可通过以下两种方式之一实现：
- 编译自定义 Linux 内核，以支持特定的 USB 驱动程序
- 或者单独编译安装 usbip 模块
5.1 编译自定义Linux内核
安装编译内核所需的依赖项
sudo apt install build-essential flex bison libssl-dev libelf-dev libncurses-dev autoconf libudev-dev libtool bc
下载内核源代码，通过 uname -r 命令查看 Linux 内核版本，checkout 对应的版本
git clone https://github.com/microsoft/WSL2-Linux-Kernel.git
cd WSL2-Linux-Kernel
git checkout linux-msft-wsl-5.15.153.1
将当前内核配置复制到新环境中
cp /proc/config.gz config.gz
gunzip config.gz
mv config .config
复制完成后可以通过 ls -al 命令查看当前目录所有文件，检查是否复制成功
使用 menuconfig 菜单选择需要的内核功能（也可以通过修改.config文件实现），特别是 USB 支持相关的选项：
1. sudo make menuconfig
选择以下内核选项：
- Device Drivers -> USB Support
- Device Drivers -> USB Support -> USB announce new devices
- Device Drivers -> USB Support -> USB Modem (CDC ACM) support
- Device Drivers -> USB Support -> USB/IP
- Device Drivers -> USB Support -> USB/IP -> VHCI HCD
- Device Drivers -> USB Support -> USB/IP -> Debug messages for USB/IP
- Device Drivers -> USB Serial Converter Support
- Device Drivers -> USB Serial Converter Support -> USB FTDI Single port Serial Driver
使用多线程编译内核
sudo make -j 8 && sudo make modules_install -j 8 && sudo make install -j 8
配置 WSL 使用自定义内核
将生成的内核镜像复制到 Windows 中，并在 .wslconfig 文件中指定该内核：
- cp arch/x86/boot/bzImage /mnt/e/usbip-bzImage
然后编辑 /mnt/c/Users//.wslconfig 文件，添加以下内容：
1. [wsl2]
2. kernel=E:\\usbip-bzImage
通过以上步骤，WSL 2 将使用你自定义编译的内核来支持额外的驱动程序，特别是 USB 相关的功能。
重启 wsl 使配置生效
wsl --shutdown
5.2 编译 USBIP 工具
安装编译内核所需的依赖项
sudo apt install build-essential flex bison libssl-dev libelf-dev libncurses-dev autoconf libudev-dev libtool bc
编译 USBIP 工具
cd tools/usb/usbip
sudo ./autogen.sh
sudo ./configure
sudo make install -j 12
将 USBIP 工具库复制到 USBIP 可以访问到的位置
sudo cp libsrc/.libs/libusbip.so.0 /lib/libusbip.so.0
7. 卸载USB设备
如果需要卸载设备，可以使用以下命令
# 卸载挂载
usbipd detach --busid 2-6
# 取消设备共享
usbipd unbind --busid 2-6
参考：
连接 USB 设备
WSL support
Connecting USB devices to WSL
让 WSL 2 支持 USB
