Getting Started Guide Windows (WSL)
Follow this guide to install Infuse-IoT for Windows using WSL (Windows Subsystem for Linux). This process provides a posix style workspace for using Infuse-IoT, without setting up a virtual machine.
Prerequisites
The first step is to install WSL and a Linux Distribution (Ubuntu preferred).
Follow Microsoft’s guide to install WSL along with the default Distribution (Ubuntu).
Note
If using an existing WSL installation, make sure it is using WSL Version 2 (or create a new installation) . Follow Microsoft’s guide to List and Set WSL Versions.
WSL2 is required to use programmers from within the WSL environment.
After installing and setting up your WSL environment, Install WSL-USB. This can be installed via
winget install --interactive --exact dorssel.usbipd-win
This tool is used to allow WSL to access USB devices plugged into the Windows Host such as programmers.
Once installed, the USB programmer will need to be changed from the Windows USB Devices
to the
Forwarded Devices
.
Install Zephyr and Infuse-IoT
Next follow the rest of the Infuse-IoT Getting started guide.
Note
Ensure to follow any instructions specific to Ubuntu, not Windows (Native).
VSCode Setup
VSCode is the preferred development environment for Infuse-IoT. It has many integrations with Kconfig. Setting up VSCode with WSL is slightly different.
Install VScode on the Windows Desktop (not WSL).
Once installed, open VScode and click on the bottom right corner with the blue box with the white arrows and Select “Connect to WSL” and follow the prompts (this may take a little while for the first time).
Then select “Open Folder” and navigate to
~/infuse-iot
.
Useful Tips
You can access the Windows file system from within WSL at
/mnt/c/
(or/mnt/d/
etc).Similarly, you can access WSL files in Windows at
\\wsl$
.