Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

2.1. Installing Windows* Subsystem for Linux* (WSL) on Windows*

Starting with Nios® II EDS in Intel® Quartus® Prime Pro Edition version 19.2 and Intel® Quartus® Prime Standard Edition version 19.1, the Cygwin component in the Windows* version of Nios® II EDS has been removed and replaced with Windows* Subsystem for Linux* (WSL).

The procedure for installing WSL:

  1. Go to Install Linux on Windows with WSL and follow Microsoft*'s instructions to install Ubuntu 18.04 LTS for WSL.
    Note:
    • Intel recommends the following operating system:
      • Windows* 10 build version 16215.0 or higher
      • Windows* 11 build version 22000.1219 or higher
    • Install only WSL 1 and skip the instructions for updating WSL 1 to WSL 2. WSL 2 is not supported.
    • From the Intel® Quartus® Prime Pro Edition 20.4 and Intel® Quartus® Prime Standard Edition 20.1.1, the minimum requirement is Windows 10 Version 1903 build 18362.1256.
    Remember: In Windows Features, ensure to turn on the Windows Subsystem for Linux option.
  2. After installation has successfully completed, launch Ubuntu 18.04.
  3. Install additional distro packages required for Nios® II EDS using the following commands:
    sudo apt update
    sudo apt install wsl
    sudo apt install dos2unix 
    sudo apt install make
    sudo apt install build-essential
    Note: Ensure that all package dependencies, repositories lists, and Internet connection for WSL are set correctly.
Note:
  • For the Nios® II Command Shell, use all command line tools, as before, but you need to add .exe to launch a Windows* executable, like eclipse-nios2.exe or jtagconfig.exe.
  • Nios® II BSP and application projects from previous Intel® Quartus® Prime Pro Edition releases are not compatible with this WSL solution. You are required to regenerate your projects.