1. WSL2连接USB设备的背景与需求
作为一名长期使用WSL2进行嵌入式开发的工程师，我深刻体会到这个工具的便利性。WSL2（Windows Subsystem for Linux 2）让我们在Windows环境下就能获得接近原生Linux的开发体验，这对于STM32等嵌入式开发来说简直是福音。但当我第一次尝试通过WSL2连接USB设备时，遇到了不少麻烦。
WSL2的架构决定了它默认无法直接访问主机USB设备。这是因为WSL2运行在一个轻量级虚拟机中，与Windows主机之间存在一层虚拟化隔离。这种设计带来了性能优势，但也造成了硬件访问的限制。对于嵌入式开发者来说，这尤其是个痛点——我们需要通过USB连接开发板（如STM32 Discovery Kit）、烧录器（如ST-Link）、串口调试工具等设备。
2. 官方解决方案解析
微软官方文档提供了USB设备连接的解决方案，核心思路是通过USB/IP协议实现设备共享。这个方法虽然可行，但在实际使用中我发现了一些需要注意的细节。
2.1 基础环境准备
首先确保你的系统满足以下条件：
- Windows 10 2004或更高版本（建议使用Windows 11）
- 已安装WSL2并设置为默认版本
- Linux发行版已更新到最新（我推荐Ubuntu 20.04/22.04 LTS）
重要提示：某些杀毒软件可能会干扰USB/IP服务，建议在操作时暂时关闭实时防护功能。
2.2 安装USB/IP工具链
在Windows主机端需要安装USB/IP客户端工具：
bash复制# 在管理员权限的PowerShell中执行
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
在WSL2的Linux环境中安装服务端组件：
bash复制sudo apt update
sudo apt install linux-tools-virtual hwdata
sudo update-alternatives --install /usr/local/bin/usbip usbip `ls /usr/lib/linux-tools/*/usbip | tail -n1` 20
3. 详细连接步骤与实操
3.1 识别设备与绑定
- 在Windows主机上列出可用USB设备：
powershell复制usbipd wsl list
你会看到类似这样的输出：
code复制BUSID VID:PID DEVICE
1-1 0483:3748 STMicroelectronics STLink Virtual COM Port
1-2 0483:374b STMicroelectronics STLink Debug
- 将目标设备附加到WSL2：
powershell复制usbipd wsl attach --busid <总线ID> --distribution <发行版名称>
例如：
powershell复制usbipd wsl attach --busid 1-2 --distribution Ubuntu-22.04
3.2 Linux端设备识别
在WSL2终端中检查设备是否成功连接：
bash复制lsusb
应该能看到类似输出：
code复制Bus 001 Device 002: ID 0483:374b STMicroelectronics STLink Debug
3.3 配置设备权限（重要）
为了避免每次都需要sudo，我们需要配置udev规则：
bash复制sudo nano /etc/udev/rules.d/99-stlink.rules
添加以下内容（以ST-Link为例）：
code复制# ST-Link/V2
SUBSYSTEM=="usb", ATTR{idVendor}=="0483", ATTR{idProduct}=="3748", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="0483", ATTR{idProduct}=="374b", MODE="0666"
然后重新加载规则：
bash复制sudo udevadm control --reload-rules
sudo service udev restart
4. 常见问题与解决方案
4.1 设备连接不稳定
症状：设备频繁断开或无法识别
解决方法：
- 检查USB线缆质量（劣质线缆是常见问题源）
- 尝试不同的USB端口（建议使用主板原生USB3.0端口）
- 在Windows设备管理器中禁用USB选择性暂停设置
4.2 权限问题
症状：操作设备时提示"Permission denied"
解决方法：
- 确保已正确配置udev规则
- 将用户加入dialout组：
bash复制sudo usermod -aG dialout $USER
- 重启WSL实例（
wsl --shutdown然后重新启动）
4.3 特定设备兼容性问题
某些USB设备可能需要额外驱动支持。以FTDI芯片为例，可能需要：
bash复制sudo apt install libftdi1-2 libftdi1-dev
5. 高级配置与优化
5.1 自动化连接脚本
为了避免每次都要手动附加设备，可以创建自动化脚本。在Windows端创建attach_usb.ps1：
powershell复制$devices = usbipd wsl list | Select-String "STLink"
if ($devices) {
$busid = $devices.Line.Split()[0]
usbipd wsl attach --busid $busid --distribution Ubuntu-22.04
}
5.2 多设备管理技巧
当同时连接多个开发板时，可以通过以下命令筛选特定设备：
powershell复制usbipd wsl list | Where-Object { $_ -match "STLink" }
5.3 性能调优
在%USERPROFILE%\.wslconfig中添加以下配置可改善USB性能：
code复制[wsl2]
kernelCommandLine = usbcore.usbfs_memory_mb=1024
6. 实际开发中的应用示例
6.1 STM32开发环境搭建
连接ST-Link后，可以使用OpenOCD进行调试：
bash复制sudo apt install openocd
openocd -f interface/stlink.cfg -f target/stm32f4x.cfg
6.2 串口调试技巧
对于USB转串口设备，推荐使用screen工具：
bash复制sudo apt install screen
screen /dev/ttyUSB0 115200
退出screen会话：Ctrl+A然后按K和Y。
6.3 设备固件更新
通过USB连接直接更新STM32固件：
bash复制st-flash --reset write firmware.bin 0x08000000
经过几个月的实际使用，我发现这套方案虽然需要一些初始配置，但一旦设置完成就非常稳定。特别是在同时进行多个STM32项目开发时，能够快速在不同开发板之间切换，大大提高了工作效率。对于偶尔出现的连接问题，99%的情况都可以通过重新插拔USB设备或者重启USB/IP服务解决。