Page History

Note
Beta Version description page is under construction

Instructions

Setup WSL and Install Linux

Expand

title	Prepare PC/OS

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

Expand

title	Change default WSL version from WSL1 to WSL2

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
Reboot
Download and install: https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
Powershell as Admin:
1. wsl --set-default-version 2

Expand

title	List of tested WSL Linux distributionen and Xilinx Tools

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

Expand

title	Linux Distribution installieren

Download Linux Distribution:https://docs.microsoft.com/de-de/windows/wsl/install-manual
1. Check supported Linux distribution for Vivado/Vitis/Petalinux ( ex. "Ubuntu 18.04 LTS" for works for 2020.2)
Open Powershell as Admin
1. Add-AppxPackage <download path>\Ubuntu_1804.2019.522.0_x64.appx
Start Linux console and follow install instruction
1. Start Ubuntu App (Windows Start Button → Ubuntu)
(optional) WSL Configuration on linux console:
1. sudo vim /etc/wsl.conf
  1. [wsl2]
    memory=<size>GB
    processors=<cnt>
2. Other options: https://docs.microsoft.com/en-us/windows/wsl/wsl-config

Expand

title	Setup DNS nameserver

Check that the DNS server is configured on the Linux console:
1. sudo vim /etc/resolv.conf
In case DNS server is correct, skip this instruction otherwise follow instruction below
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
Powershell console:
1. wsl --shutdown
Get DNS Server IP over powershell:
1. ipconfig -all
Restart Linux (over powershell or win start button → Ubuntu)
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

Expand

title	GUI Option 1: GUI with X-Server

Install VcXsrv
Start VcXsrv (XLaunch)
3. (optional) Save Configuration and run XLaunch directly with "XLaunch -run <config.xlaunch>"
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
Add environment to auto start of new console :

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

Expand

title	GUI Option 2: Ubuntu Desktop Modus over RDP

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

Expand

title	Virtual WSL drive as network drive in WinOS

Open explore
Right click on PC icon --> Connect network drive
Select drive
Add to folder \\wsl$\Ubuntu-18.04
Click Finish

Prepare Linux for Xilinx Tools

Expand

title	Additional Packages

Install browser
1. sudo apt-get install firefox
change console from dash to bash
1. sudo dpkg-reconfigure dash
  1. Press "No" to disable dash and activate default bash
Enable i386 architecture
1. sudo dpkg --add-architecture i386sudo apt-get update
Download and run plnx-env-setup.sh: https://www.xilinx.com/support/answers/73296.html
1. chmod 777 ./plnx-env-setup.sh
2. sudo ./plnx-env-setup.sh
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
Additional installation on some OS
1. sudo apt-get install libtinfo5

Expand

title	Install Xilinx Tools

Download Xilinx Vitis All OS installer Single-File(Includes Vitis, Vivado and Petalinux downloader):
1. Downloads (xilinx.com)
Extracted Files on linux drive
1. tar -xvf Xilinx_Unified_2020.2_1118_1232.tar.gz
Create Folder /tools/Xilinx
1. sudo mkdir /tools
2. sudo mkdir /tools/Xilinx
Change owner to user
1. sudo chown <owner>:<owner> /tools/Xilinx
Install Vitis
1. run:$ ./xsetup
2. select Vitis on default installation path
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)
Install petalinux
1. run:$ ./xsetup
2. select petalinux on default installation path
Add source environment to auto start of new console :
1. sudo vim /etc/bash.bashrc
  1. source /tools/Xilinx/PetaLinux/2020.2/tool/settings.sh

Notes and Hints and other stuff

Expand

title	Notes and hints and other stuff

Code Block

language	bash
title	sudo vim /etc/bash.bashrc (complete example)
collapse	true

#...
#(original part)
#...
#all extensions to setup environment and
# load petalinux environment
source /tools/Xilinx/PetaLinux/2020.2/tool/settings.sh
# additional TE environment variables to change timeout and used jobs
export TE_TIMEOUT=200
export TE_RUNNING_JOBS=6
# finish

function x_run () {
  #XServer Display
  export DISPLAY=xxx.xxx.xxx.xxx:0.0
  # replace xxx.xxx.xxx.xxx with your win 10 host IP
  export LIBGL_ALWAYS_INDIRECT=1

  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

Code Block

language	powershell
title	Release reserved memory from Vmmem
collapse	true

#Sometimes Vmmem did not release DDR memory
# ###############
#Solution 1: 
# #######
#shutdown (close all running application before)
wsl --shutdown
#start WSL again
wsl
#Solution 2:
#todo

Code Block

language	powershell
title	Resize WSL VHD
collapse	true

# Resize VHD
# ###############
# see: https://docs.microsoft.com/en-us/windows/wsl/vhd-size

Scroll Only

HTML
<style> .wiki-content .columnLayout .cell.aside { width: 0%; }</style>

Scroll pdf ignore

Custom_fix_page_content

Table of contents

Table of Contents

outline	true

Trenz Electronic Documentation

Versions Compared

Old Version 37

New Version 38

Key

Instructions

Setup WSL and Install Linux

Prepare Linux for Xilinx Tools

Notes and Hints and other stuff

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