MOUNT USB DEVICE INTO WSL

[[TOC]]

USAGE

1. Lists connecting USB device

Example devices showing as below:

$ powershell.exe -C usbipd wsl list

Output message:

BUSID  VID:PID    DEVICE                                                        STATE
1-6    0403:6001  USB Serial Converter                                          Not attached
1-9    05ac:024f  USB Input Device                                              Not attached
1-10   320f:221d  USB Input Device                                              Not attached
1-12   0bda:0169  Microsoft Usbccid Smartcard Reader (WUDF), Realtek USB 2....  Not attached

2. Attach USB device

Example to attach USB serial Converter, which BUSID is 1-6 into WSL¹
```
$ powershell.exe -C usbipd wsl attach --busid 1-6
```

Check the attached USB device, will found the STATE of BUSID 1-6 have attached on Ubuntu distribution as Attached - Ubuntu

$ powershell.exe -C usbipd wsl list

output message:

BUSID  VID:PID    DEVICE                                                        STATE
1-6    0403:6001  USB Serial Converter                                          Attached - Ubuntu
1-9    05ac:024f  USB Input Device                                              Not attached
1-10   320f:221d  USB Input Device                                              Not attached
1-12   0bda:0169  Microsoft Usbccid Smartcard Reader (WUDF), Realtek USB 2....  Not attached

3. Check USB lists on WSL

Attached USB device will indicated in WSL USB list.

$ lsusb

output message:

ID is the VID:PID in usbpid wsl list, we can found the example BUSID: 1-6 VID:PID is 0403:6001, which is Bus 001 Device 002 in WSL

Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 0403:6001 Future Technology Devices International, Ltd FT232 Serial (UART) IC
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

4. Detach USB device

Detach USB device to release from WSL and return control to Windows
```
$ powershell.exe -C usbipd wsl detach --busid 1-6
```

TROUBLESHOT

MULTIPLE DISTRIBUTIONS INSTALLED ON WSL

Attach USB device on mutiple installed distributions will indicated errors as below:

$ powershell.exe -C usbipd wsl attach --busid 1-6

output message:

usbipd: info: Using default WSL distribution 'Ubuntu'; specify the '--distribution' option to select a different one.

Solution: specify WSL distribution to use via --distribution

List running WSL

$ powershell -C wsl --list --running

output message:

Windows Subsystem for Linux Distributions:
Ubuntu (Default)

Specify WSL distribution to attach USB device via --distribution on Ubuntu distribution
```
$ powershell.exe -C usbipd wsl attach --busid 1-6 --distribution Ubuntu
```

PRIVILEGE ATTACH USB

First time attach USB device will need privilege access, indicated error as below:

$ powershell.exe -C usbipd wsl attach --busid 1-6 --distribution Ubuntu

output message:

usbipd: error: Access denied; this operation requires administrator privileges.
usbipd: info: The first time attaching a device to WSL requires elevated privileges; subsequent attaches will succeed with standa
rd user privileges.

Solution: Open Powershell.exe as Administrator to attach USB device

Example: usbipd's busid=1-6 and WSL distribution=Ubuntu

PS C:\WINDOWS\system32> usbipd wsl attach --busid 1-6 --distribution Ubuntu

Issue facing on attach, please reference Distribution and Privilege

dotfiles