Featured image of post 【经验分享】WSL中使用USB设备

【经验分享】WSL中使用USB设备

本文就WSL中无法使用主机USB设备背景下,通过编译linux内核启用USB设备功能

# 具体步骤:

首先在windows中安装 USBIP 工具,在GitHub上下载安装包并根据README文档的说明进行操作:

下载链接:https://github.com/dorssel/usbipd-win/releases

同时在 WSL Linux 端也需要安装编译内核所需的库和工具,为后续做准备:

1
$ sudo apt install build-essential flex bison libssl-dev libelf-dev libncurses-dev autoconf libudev-dev libtool

打开wsl ubuntu终端使用命令:uname -r得到版本号,同时根据版本号使用管理员模式新建目录

screenshot_image.png

1
$ sudo mkdir /usr/src/5.15.90.1-microsoft-standard-WSL2

同时我们去GitHub下载一份wsl内核源码:https://github.com/microsoft/WSL2-Linux-Kernel/releases

这里的版本就是你使用命令 uname -r 得到的版本号,建议可以先手动安装压缩包,然后使用vscode连接wsl,把文件拖拽到wsl下

然后解压到指定路径下(这部分注意区分版本号,不要一昧照搬命令):

1
2
3
4
$ sudo tar -xzvf WSL2-Linux-Kernel-linux-msft-wsl-5.15.90.1.tar.gz -C /usr/src/5.15.90.1-microsoft-standard-WSL2/

$ cd /usr/src/5.15.90.1-microsoft-standard-WSL2/
$ sudo mv WSL2-Linux-Kernel-linux-msft-wsl-5.15.90.1/* ./ && sudo rm -r WSL2-Linux-Kernel-linux-msft-wsl-5.15.90.1

然后将内核的一些配置信息复制到当前文件夹下:

1
2
3
$ sudo cp /proc/config.gz config.gz
$ sudo gunzip config.gz
$ sudo mv config .config

接着我们执行menuconfig命令打开图形化菜单

1
$ sudo make menuconfig

进入如下路径:> Device Drivers > USB support

下面是一些必须的添加项,一般默认都是选中的,不过最好还是检查下:

1
2
3
4
5
6
7
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 Serial Converter Support
Device Drivers -> USB Serial Converter Support -> USB FTDI Single port Serial Driver

同时记得关闭 Device Drivers -> USB Support -> USB/IP -> Debug messages for USB/IP这一选项,否则调试信息会非常影响你的使用体验

另外也可以添加你具体所需的USB模块勾选上,保存退出后执行内核编译

1
$ sudo make -j8 

内核编译期间发生报错:

screenshot_image.png

这主要是由于系统缺少dwarves软件包导致的,我们使用apt命令安装并继续执行编译:

1
2
3
$ sudo apt install dwarves

$ sudo make -j8 && sudo make modules_install -j8 && sudo make install -j8

发现又产生了报错:

screenshot_image.png

查找资料似乎说明的是这仅仅是个警告,我通过禁用BTF的调试信息解决了这个问题

1
2
3
$ sudo vi .config

# 找到宏`CONFIG_DEBUG_INFO_BTF`并将value改为 `n`

安装内核时发生报错:

screenshot_image.png

解决方式有两种:

  • 1.可以选择在.config中禁用宏CONFIG_X86_X32
  • 2.找到合适的binutils版本使其能够编译

我选择的是第一种,根据我在网上找到的说法是:

1
2
3
# 除非您想要它并且拥有它的用户空间,否则 X32 并不是特别有用。请注意,X32 是 64 位的 x32 ABI,它是编译为在 64 位长模式下运行的“32 位”短指针代码,与真正的本机 32 位二进制/ABI 支持不同。这是一种具有非常具体的利基的特殊模式。

# 您可以在内核配置中禁用[CONFIG_X86_X32](https://cateee.net/lkddb/web-lkddb/X86_X32.html)或获取具有 elf32_x86_64 目标支持的 binutils。如何获取 binutils 取决于您的发行版。

所以我选择禁用宏CONFIG_X86_X32,之后继续执行命令:

1
2
$ sudo make modules_install -j8
$ sudo make install -j8

screenshot_image.png

之后就可以选择编译 USBIP 工具了:

1
2
3
4
$ cd tools/usb/usbip
$ sudo ./autogen.sh
$ sudo ./configure
$ sudo make install -j8

复制工具库位置,以便 usbip 工具可以获取到:

1
$ sudo cp libsrc/.libs/libusbip.so.0 /lib/libusbip.so.0

安装 usb.ids 以便显示 USB 设备的名称:

1
$ sudo apt-get install hwdata

重启WSL:

1
$ wsl --shutdown

下面进行测试是否成功: 打开powershell:

1
$ usbipd wsl list

假设我们需要在wsl使用的 usb 设备为 ST-Link Debug, USB 大容量存储设备, USB 串行设备 (COM3),设备id为 0483:374b

我们使用命令附加设备到 wsl2 中

1
$ usbipd wsl attach --hardware-id "0483:374b"

screenshot_image.png

此时我们打开一个 wsl 终端,使用命令 lsusb 即可看到附加到 wsl 的设备

screenshot_image.png

然后我们再次回到 powershell ,执行 usbipd wsl list命令,可以看到此时的 usb 设备已经成功添加到 wsl 了

screenshot_image.png

Licensed under CC BY-NC-SA 4.0
Last updated on Oct 26, 2023 00:00 UTC
顺颂时祺,秋绥冬禧
Built with Hugo
Theme Stack designed by Jimmy