使用usbipd-win自动化管理WSL连接的USB设备

在Windows Subsystem for Linux (WSL)环境中工作时，经常需要将USB设备连接到WSL实例。usbipd-win项目提供了强大的工具来实现这一功能。本文将介绍如何利用usbipd-win的自动化功能批量管理USB设备连接。

核心功能概述

usbipd-win项目包含一个PowerShell模块，提供了Get-UsbipdDevice命令，可以查询当前系统中USB设备的状态信息。通过这个命令，我们可以获取以下关键状态：

• IsConnected: 设备是否物理连接到主机
• IsBound: 设备是否已绑定到usbipd服务
• IsAttached: 设备是否已附加到WSL实例

自动化连接脚本

以下PowerShell脚本可以自动将所有已连接且绑定但未附加的USB设备连接到WSL：

# 列出当前USB设备状态
usbipd list

# 导入usbipd PowerShell模块
Import-Module $env:ProgramW6432'\usbipd-win\PowerShell\Usbipd.Powershell.dll'

# 自动连接符合条件的设备
Get-UsbipdDevice | Where-Object {
    $_.IsConnected -and $_.IsBound -and -not $_.IsAttached
} | ForEach-Object {
    usbipd attach --wsl --busid $_.BusId
}

脚本解析

1. 状态检查：首先使用usbipd list命令显示当前所有USB设备的状态，方便用户确认。

2. 模块导入：导入usbipd-win的PowerShell模块，这是使用自动化功能的前提。

3. 设备筛选：通过管道操作筛选出符合以下条件的设备：

   • 物理连接到主机(IsConnected)
   • 已绑定到usbipd服务(IsBound)
   • 尚未附加到WSL实例(-not $_.IsAttached)

4. 批量连接：对筛选出的每个设备执行附加操作，使用--busid参数指定设备总线ID。

应用场景

这个自动化脚本特别适合以下场景：

1. 系统重启后：当Windows主机重启后，可以自动重新连接之前使用的USB设备到WSL。

2. 多设备环境：开发环境中需要同时使用多个USB设备时，可以一次性连接所有必要设备。

3. 自动化部署：在CI/CD流程中，可以确保测试环境总是能访问所需的USB硬件。

注意事项

1. 执行脚本需要管理员权限。

2. 确保WSL实例已经启动并运行。

3. 某些特殊设备可能需要额外的驱动程序才能在WSL中正常工作。

通过这个自动化脚本，开发者可以大大简化WSL环境下USB设备的管理工作，提高工作效率。