Skip to end of metadata
Go to start of metadata

Beta Version description page is under construction


Setup WSL and Install Linux

  1. Enable CPU virtualisation in BIOS
  2. Open Windows Features
    1. Enable Windows-Subsystem for Linux

  1. Powershell as Admin:
    1. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    2. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  2. Reboot
  3. Download and install:
  4. Powershell as Admin:
    1. wsl --set-default-version 2
The list is only a guide that has worked for us, there may still be complications that we cannot help with at this time.
  • Vivado/Vitis/Petalinux 2020.2
    • with WSL Ubuntu 18.04 LTS
  • Vivado/Vitis/Petalinux 2021.2
    • with WSL Ubuntu 18.04 LTS
    • with WSL Ubuntu 20.04 LTS

  1. Download Linux Distribution:
    1. Check supported Linux distribution for Vivado/Vitis/Petalinux   ( ex. "Ubuntu 18.04 LTS" for works for 2020.2)
  2. Open Powershell as Admin
    1. Add-AppxPackage <download path>\Ubuntu_1804.2019.522.0_x64.appx
  3. Start Linux console and follow install instruction
    1. Start Ubuntu App (Windows Start Button → Ubuntu)
  4. (optional) WSL Configuration on linux console:
    1. sudo vim /etc/wsl.conf
      1. [wsl2]

    2. Other options:
  1. Check that the DNS server is configured on the Linux console:
    1. sudo vim /etc/resolv.conf
  2. In case DNS server is correct, skip this instruction otherwise follow instruction below
  3. Linux console:
    1. sudo vim /etc/wsl.conf
      1. [network]
        generateResolvConf = false
    2. (in case file can't be wrote):
      1. sudo rm /etc/.wsl.conf.swp
  4. Powershell console:
    1. wsl --shutdown
  5. Get DNS Server IP over powershell:
    1. ipconfig -all
  6. Restart Linux (over powershell or win start button → Ubuntu)
  7. Linux console:
    1. sudo vim /etc/resolv.conf
      • nameserver <DNS IP>
    2. (in case file can't be wrote, remove) and try again point a:
      1. sudo rm /etc/.resolv.conf.swp
      2. sudo rm etc/resolv.conf
  1. Install VcXsrv
  2. Start VcXsrv (XLaunch)

    1. (optional) Save Configuration and run XLaunch  directly with "XLaunch -run <config.xlaunch>"
  3. Linux console:
    1. sudo apt update && sudo apt upgrade
    2. sudo apt install xfce4
    3. sudo apt install build-essential

    4. sudo apt install net-tools

    5. sudo apt install xrdp -y && sudo systemctl enable xrdp
  4. Add environment to auto start of new console :
    1. sudo vim /etc/bash.bashrc
      1. export DISPLAY=<host IP>:0.0

      2. export LIBGL_ALWAYS_INDIRECT=1

      3. sudo /etc/init.d/dbus start
      4. sudo /etc/init.d/xrdp start
  1. Start Ubuntu App (Windows Start Button → Ubuntu)
  2. Add username and password
  3. Update packet manager:
    1. sudo apt update && sudo apt upgrade
  4. Install:
    1. sudo apt install xfce4 xrdp
  5. Modify Remote Port
    1. sudo sed -i 's/3389/3388/g' /etc/xrdp/xrdp.ini
  6. Start XRDP Server 
    1. sudo /etc/init.d/xrdp start
  7. (optional) XRDP autostart :
    1. sudo vim /etc/bash.bashrc
      1. sudo /etc/init.d/xrdp start
  8. Connect via RDP (Win10 Remote Desktop Connection):
    1. localhost:3388

  1. Open explore
  2. Right click on PC icon --> Connect network drive
  3. Select drive
  4. Add to folder \\wsl$\Ubuntu-18.04
  5. Click Finish

Prepare Linux for Xilinx Tools

  1. Install browser
    1. sudo apt-get install firefox

  2. change console from dash to bash

    1. sudo dpkg-reconfigure dash 

      1. Press "No" to disable dash and activate default bash
  3. Enable i386 architecture

    1. sudo dpkg --add-architecture i386
      sudo apt-get update
  4. Download and run

    1. chmod 777 ./
    2. sudo ./

  5. Install (in case script did not install all) 

    1. sudo apt-get install iproute2 gawk python3 python build-essential gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget git diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3 -y

  6. Additional installation on some OS
    1. sudo apt-get install libtinfo5

  1. Download Xilinx Vitis All OS installer Single-File(Includes Vitis, Vivado and Petalinux downloader):
  2. Extracted Files on linux drive
    1. tar -xvf Xilinx_Unified_2020.2_1118_1232.tar.gz
  3. Create Folder /tools/Xilinx
    1. sudo mkdir /tools
    2. sudo mkdir /tools/Xilinx
  4. Change owner to user
    1. sudo chown <owner>:<owner> /tools/Xilinx

  5. Install Vitis

    1. run:$ ./xsetup

    2. select Vitis on default installation path
  6. Vivado License
    1. Open Xilinx License manager and chose Copy License and select your license file
    2. In case license file is node-locked and shared with WinOS:
      1. sudo vim /etc/bash.bashrc
        1. sudo ip link set dev bond0 address xx:xx:xx:xx:xx:xx
          1. (use MAC from Win OS)
  7. Install petalinux
    1. run:$ ./xsetup
    2. select petalinux on default installation path
  8. Add source environment to auto start of new console :
    1. sudo vim /etc/bash.bashrc
      1. source /tools/Xilinx/PetaLinux/2020.2/tool/

Notes and Hints and other stuff

sudo vim /etc/bash.bashrc (complete example)
#(original part)
#all extensions to setup environment and 
# load petalinux environment, can be overwrite via project scripts
export GLOBAL_VIVADO=2021.2
source /tools/Xilinx/PetaLinux/${GLOBAL_VIVADO}/tool/

# additional TE environment variables to change timeout and used jobs

# additional TE envirnmoent variables
export TE_TIMEOUT=200
export TE_WSL_USAGE=1
export TE_EDITOR=notepad++.exe
#export TE_SERIAL_PS=<path>
export TE_COM=/mnt/<path to putty on winOS>
export TE_PLX_SSTATE_CACHE_DOWNLOAD=~/design/sstate-cache/downloads_${GLOBAL_VIVADO}/downloads
export TE_PLX_SSTATE_CACHE_AARCH64=~/design/sstate-cache/sstate_aarch64_${GLOBAL_VIVADO}/aarch64
export TE_PLX_SSTATE_CACHE_ARM=~/design/sstate-cache/sstate_arm_${GLOBAL_VIVADO}/arm
export TE_PLX_SSTATE_CACHE_MB_FULL=~/design/sstate-cache/sstate_mb-full_${GLOBAL_VIVADO}/mb-full
# finish
echo "TE Enviroment Variables"
echo "TE_COM=${TE_COM}"

function x_run () {
  #XServer Display
  # replace with your win 10 host IP

  sudo /etc/init.d/dbus start
  sudo /etc/init.d/xrdp start
  # replace xx:xx:xx:xx:xx:xx with win 10 MAC
  sudo ip link set dev bond0 address xx:xx:xx:xx:xx:xx

# x-server Setup only needed in case wsl is rebooted
echo "Refresh XSetup? y/N"
read xsetup
if [ "${xsetup}" == "y" ]; then x_run; fi 

#show version
lsb_release -a  
Release reserved memory from Vmmem
#Sometimes Vmmem did not release DDR memory
# ###############
#Solution 1: 
# #######
#shutdown (close all running application before)
wsl --shutdown
#start WSL again
#Solution 2:

Resize WSL VHD
# Resize VHD
# ###############
# see:  
#1 open powershell as admin
#Terminate WSL
wsl --shutdown
#find your distribution installation 
packageGet-AppxPackage -Name "*Ubuntu*" | Select PackageFamilyName
#Copy the path to that file, it should look something like %LOCALAPPDATA%\Packages\CanonicalGroupLimited.Ubuntu20.04onWindows_79xxxx\LocalState\ext4.vhdx
# This path will be called "<pathToVHD>" below
# -------------------------#start diskpartdiskpart# ----------
#inside diskpart console
#select disk
DISKPART> Select vdisk file="<pathToVHD>"
#check details
DISKPART> detail vdisk
#expand for example to 512GB  <sizeInMegaBytes>=512000
DISKPART> expand vdisk maximum=512000 
# ----------
#start WSL from powershell
sudo mount -t devtmpfs none /dev
#  "/dev: none already mounted on /dev." warning can be ignored
mount | grep ext4
#resize fs to 512GB <sizeInMegaBytes>=512000M
sudo resize2fs /dev/sdb 512000M

Table of contents

Preview Screenshots

Vivado Linux GUI on  XServer in WinOS Desktop

Vivado Linux GUI Linux Desktop in RDP

Linux Console on Win OS with Petalinux

Virtual Linux EXT4 Drive on  Win Explorer

  • No labels