Skip to main content

Windows Setup with WSL

The extension runs inside WSL (Windows Subsystem for Linux) with Ubuntu 22.04. Windows is the host OS; Ubuntu is where compilation and device communication happen.
Your machine must support virtualization. This may require an adjustment in BIOS/UEFI settings.

1 โ€” Install WSL and usbipd

Open a Windows Administrator terminal and run:
The WSL installer will prompt you to create a Linux username and password. Do not use root โ€” the extension requires a regular user account.

2 โ€” Restart and enter WSL

Restart your machine. Then in any terminal:

3 โ€” Prepare the Ubuntu environment

Inside the WSL Ubuntu shell:

4 โ€” Launch VS Code from WSL

5 โ€” Install the WSL Extension

In VS Code, install the WSL extension (by Microsoft) from the Marketplace. Refer to the official instructions.Verify that VS Code shows WSL: Ubuntu-22.04 in the status bar โ€” see From VS Code.

6 โ€” Connect a USB device to WSL

With a device plugged in, follow the USB forwarding guide to forward it from Windows into WSL using usbipd.