Tested Devices (original) (raw)

Device Test Procedure

Preparation

Before testing new devices, please configure your machine and verify your setup with at least one other known good device.

Open a command prompt to your WSL distribution and leave it open throughout this entire procedure; this ensures that WSL and your distribution remain active.

Verify WSL version

From a normal (non-Administrator) Windows prompt, run the following

• wsl --list --verbose
  Verify that you are running as WSL version 2

  NAME      STATE           VERSION
* Ubuntu    Running         2

Verify device

• Plug the USB device into a USB port
  Verify that the device is connected and recognized by Windows

Share and attach USB device

From a Windows Elevated prompt (run as Administrator), run the following

• usbipd list
  Verify that the device is visible and listed as 'Not shared'; note the BUSID
• usbipd bind --busid <BUSID>
  This allows the device to be attached to a client later
• usbipd list
  Verify that the device is visible and listed as 'Shared'

From a normal (non-Administrator) Windows prompt, run the following

• usbipd attach --wsl --busid <BUSID>
  This will attach the device to WSL
• usbipd list
  Verify that the device is visible, and listed as 'Attached'

Verify USB available in WSL

Below steps are based on Ubuntu, details may vary for other distros.

All USB device types

From the WSL command prompt you opened earlier, run the following

• lsusb
  Verify that the device is visible

jos@contoso:/mnt/c/Users/jos$ lsusb  
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub  
Bus 001 Device 002: ID f055:9800 MicroPython Pyboard Virtual Comm Port in FS Mode  
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub  

• dmesg | tail
  There should be a recent message indicating that the the device has been discovered similar to the example below.

jos@contoso:/mnt/c/Users/jos$ dmesg | tail  
[ 2401.168835] vhci_hcd: vhci_device speed not set  
[ 2401.238829] usb 1-1: new full-speed USB device number 2 using vhci_hcd  
[ 2401.318859] vhci_hcd: vhci_device speed not set  
[ 2401.389087] usb 1-1: SetAddress Request (2) to port 0  
[ 2401.453006] usb 1-1: New USB device found, idVendor=f055, idProduct=9800, bcdDevice= 2.00  
[ 2401.453010] usb 1-1: New USB device strings: Mfr=1, Product=2, SerialNumber=3  
[ 2401.453013] usb 1-1: Product: Pyboard Virtual Comm Port in FS Mode  
[ 2401.453014] usb 1-1: Manufacturer: MicroPython  
[ 2401.453015] usb 1-1: SerialNumber: 206437A1304E  
[ 2401.458834] cdc_acm 1-1:1.1: ttyACM0: USB ACM device  

USB serial port devices

• ls /dev/tty*
  Verify that the device is visible as /tty/S<n> or /tty/ACM<n>

For terminal like devices:

• screen /dev/ttyACM0 115200
  Verify that you can connect to the device and interact or send/receive.

USB Composite Devices:

• run lsusb --tree
  Verify that all expected USB interfaces are shown, such as mass storage and communication devices

jos@contoso:/mnt/c/Users/jos$ lsusb --tree  
/:  Bus 02.Port 1: Dev 1, Class=root_hub, Driver=vhci_hcd/8p, 5000M  
    |__ Port 1: Dev 2, If 0, Class=Mass Storage, Driver=, 5000M  
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=vhci_hcd/8p, 480M  
    |__ Port 1: Dev 2, If 0, Class=Mass Storage, Driver=, 12M  
    |__ Port 1: Dev 2, If 1, Class=Communications, Driver=cdc_acm, 12M  
    |__ Port 1: Dev 2, If 2, Class=CDC Data, Driver=cdc_acm, 12M