Skip to main content
Version: 6

Set up the Torizon IDE Extension 2 Environment

Introduction​

This article provides a step-by-step guide on host machine setup for developing applications with Torizon OS devices using Visual Studio Code and the Torizon VS Code Extension 2. It includes instructions for Installing software and dependencies on your Windows or Linux-based host machine.

This article complies with the Typographic Conventions for Toradex Documentation.

Prerequisites​

caution

You have to install the Visual Studio Code from its Download page. The IDE Extension 2 will not work with VS Code installed via Snap or Flatpak!

For WSL 2, Visual Studio Code has to be installed on the Windows side.

Configure a Windows Host Machine​

Install WSL 2​

The Windows Subsystem for Linux (WSL) enables the use of most Linux command-line tools, utilities and applications directly on Windows. It also lets you leverage the IDE Extension 2 with Visual Studio Code installed on your Windows machine.

  1. Install Linux on Windows with WSL. Remember to change the default Linux distribution installed. Choose one of the Torizon IDE 2 officially supported Linux distributions.

  2. Check which version of WSL you are running. If WSL 1 is installed, upgrade version from WSL 1 to WSL 2.

Install Docker Engine​

Since Docker Desktop is licensed under the Docker Subscription Service Agreement, we recommend using Docker Engine.

  1. Install Docker Engine: The release of Docker provided by some distribution feeds is not up-to-date. To ensure the correct installation of Docker on WSL, follow the instructions for the specific Linux distribution you have installed. In the Docker Engine documentation, see the Server section.

  2. Set up Docker to run Docker without root privileges

Install the WSL Extension​

To use WSL in Visual Studio Code, install the WSL extension:

The WSL extension lets you use VS Code on Windows to build Linux applications that run on the Windows Subsystem for Linux (WSL). You get all the productivity of Windows while developing with Linux-based tools, runtimes, and utilities.

Set up the Torizon IDE Extension 2 on Visual Studio Code​

  1. Uninstall previous versions: it is not recommended to have both IDE Extensions 1 and 2 installed in your VS Code installation at the same time. If you have the V1 extension installed, please uninstall it before proceeding with the next steps.

  2. Connect to the WSL environment: press F1, search for wsl, and select WSL:Connect to WSL. By now, you can install extensions in the WSL environment.

  3. Install & Configure the IDE Extension 2.

    1. Click the Extensions icon from the left menu bar in Visual Studio Code.

    2. Search for Torizon IDE Extension. Click install.

    3. Activate the extension: the Torizon icon will appear in the left menu bar. Click on it to activate the extension.

    4. Installing dependencies: during the first activation, the extension will check the necessary dependencies. If any missing dependencies are detected, the extension will attempt to install them and prompt you to enter your sudo user password.

    5. Accept the package installation.

    6. Install PowerShell: another terminal will open and try to install PowerShell. Enter your sudo user password.

Configure a Linux Host Machine​

Install Docker Engine​

Since Docker Desktop is licensed under the Docker Subscription Service Agreement, we recommend using Docker Engine.

  1. Install Docker Engine: The release of Docker provided by some distribution feeds is not up-to-date. To ensure the correct Docker installation, follow the instructions for your distribution in the Docker documentation.

  2. Set up Docker to run Docker without root privileges

Set up the Torizon IDE Extension 2 on Visual Studio Code​

  1. Uninstall previous versions: it is not recommended to have both IDE Extensions 1 and 2 installed in your VS Code simultaneously. If you have the V1 extension installed, please uninstall it before proceeding with the next steps.

  2. Install & Configure the IDE Extension 2.

    1. Click the Extensions icon from the left menu bar in Visual Studio Code.

    2. Search for Torizon IDE Extension. Click install.

    3. Activate the extension: the Torizon icon will appear in the left menu bar. Click on it to activate the extension.

    4. Installing dependencies: during the first activation, the extension will check the necessary dependencies. If any missing dependencies are detected, the extension will attempt to install them and prompt you to enter your sudo user password.

    5. Accept the package installation.

    6. Install PowerShell: another terminal will open and try to install PowerShell. Enter your sudo user password.



Send Feedback!