FPGA tools

From Robin

(Difference between revisions)
Jump to: navigation, search
(→FPGA tools on windows)
(→GHDL and modelsim)
 
(113 intermediate revisions not shown)
Line 1: Line 1:
-
== FPGA tools on Windows ==
+
= FPGA tools on LISP (2428)=
-
Xilinx ISE, Catapult, etc is currently situated on ifiserv-851.ifi.uio.no
+
Vivado and Vitis is installed locally on the computers in LISP. To launch Vivado go to ''Applications->Education-> '''Vivado'''
-
Please notify the engineer in ROBIN if there are issues.  
+
-
2428, LISP was installed with the newest available ISE, Catapult, Modelsim and Digilent Adept for inf 5430 in the spring semester 2012.
+
Alternatively, you can find it by searching for apps using the ''super''-key (Windows key):
-
== FPGA tools on Linux ==
+
<div style="margin:0 auto;overflow:scroll;width:auto;max-width:100%">
 +
[[Image:Xilinx_suit.png|class=noresize]]</div>
-
Note that the tools available on windows, such as Xilinx ISE and Modelsim is not supported on Linux.
 
-
0in
+
'''Launch in terminal'''
-
Catapult_C
+
-
FormalPro
+
-
Modelsim
+
-
Xilinx
+
-
Digilent Adept to program the Atlys board can be obtained from the Digilent website.
+
Launching the applications is done by entering the following commands in the terminal:
-
Note that some Xilinx scripts require GNU BASH. Ubuntu (and possibly others) come with DASH.
+
Questa with GUI:
-
Disable DASH by reconfiguring it:
+
vsim
-
  sudo dpkg-reconfigure dash
+
Vivado with GUI:
 +
  vivado
-
=== Starting xterm with all tools available ===
+
Vitis with GUI:
-
Note that all files were moved to from midgard to bifrost in december 2011. This means that if you did the following in november 2011, you will have to do it again to make it work.
+
vitis
 +
Vitis HLS with GUI
 +
vitis_hls
-
===First time initialization ===
+
Vlog (terminal only):
-
  >cd ~
+
  vlog
-
>mkdir fpgatools
+
-
>cd fpgatools/
+
-
>/hom/mes/src/FPGATools/init_fpgatools
+
-
Note that when starting using run, you get an xterm with .bash_fpgatools (invisible when using ls-l) as source.
+
Vcom (terminal only):
-
Since spring 2012, we have moved the license file to tollheimtu from pordoi. The .bash_fpgatools will need to be upgraded either manually or by doing the initialization over again.
+
vcom
-
=== Launch ===
+
Help:
-
  >cd ~/fpgatools
+
  <command> -h
-
>run
+
-
Use the new xterm window that pops up to start the FPGA tool you like.
+
== VHDL using VSCode ==
-
Paths to all the major components should be ready in the new xterm.
+
-
To start Modelsim type vsim
+
VHDL code can also be edited using VSCode (Visual Studio Code) which is installed on computers at LISP.
-
To start Xilinx (ISE) type ise
+
-
To start PlanAhead type planAhead
+
-
etc
+
-
=== License server ===
+
* Launch Vscode by searching through applications: ''Applications ->  '''VSCode'''
 +
* Add the extension for VHDL syntax highlighting by:
 +
** ''View -> Extensions'' or ''<Ctrl + Shift + X>'' to open the Extensions window.
 +
* Search VHDL and you will see a list of extensions. Install ''VHDL by Pu Zhao''. (Note: there are other suitable vhdl extensions as well).
 +
* Once installed, ''enable'' the extension (if not done automatically).
 +
 
 +
== Questa and modelsim.ini in write mode ==
 +
 
 +
You might get the following error message when using Questa:
 +
 
 +
# ** Error: (vmap-7) Failed to open ini file "/uio/kant/ifi-project06/robin/CADlib/modelsim.ini" in write mode.
 +
# Permission denied. (errno = EACCES)
 +
 
 +
This is expected behavior because you are using a shared write protected <code>modelsim.ini</code>. To make your own copy of the <code>modelsim.ini</code> file, run;
 +
 
 +
mkdir -p ~/.config/modelsim/                            # Make a directory for modelsim config
 +
cp $CADLIB/modelsim.ini ~/.config/modelsim/modelsim.ini  # Copy modelsim.ini
 +
 
 +
Lastly, you need to alter the <code>MODELSIM</code> variable. Open the <code>.bashrc</code> in your editor of choise (e.g <code>code ~/.bashrc</code>) and add the following line:
 +
 
 +
# Setting MODELSIM variable used in IN3160
 +
export MODELSIM=$HOME/.config/modelsim/modelsim.ini
 +
 
 +
Restart the terminal or run <code>source ~/.bashrc</code> for the changes to take effect.
 +
 
 +
= FPGA tools via share on Linux =
 +
 
 +
This section is not necessary to perform to be able to use the software on LISP and VDI: Digital electronics. The clients in LISP has the Xilinx software installed locally.
 +
 
 +
'''First time initialization'''
 +
 
 +
If you need to use Xilinx' software other places than the RHEL clients at LISP or ALGOL, utilize the following guide:
 +
 
 +
cd
 +
nano .bashrc
 +
 
 +
Append the following lines to the end of the .bashrc file:
 +
<pre class="brush: bash">
 +
# Vitis Unified 2020.2 64-bit version
 +
if ! [ -x "$(command -v vivado)" ]; then
 +
  source /projects/robin/programs/Vivado/2020.2/settings64.sh
 +
  export PATH=$PATH:/projects/robin/programs/Vivado/2020.2/bin
 +
fi
 +
 
 +
# License file
 +
export LM_LICENSE_FILE=5370@lisens.ifi.uio.no
 +
 
 +
# Remove duplicants in the PATH variable
 +
PATH=$(printf "%s" "$PATH" | awk -v RS=':' '!a[$1]++ { if (NR > 1) printf RS; printf $1 }')
 +
</pre>
 +
 
 +
After you have added the latter and saved the .bashrc file, restart the terminal or 'source' the .bashrc file.
 +
 
 +
'''Other versions'''
 +
 
 +
If needed, you can also make use of older or newer versions of the Xilinx products. As of August 2020, we have 2016.4, 2018.3 and 2020.2 available.
 +
 
 +
<!---
 +
= FPGA tools on Windows =
 +
Vivado 2019.1 is situated on /uio/kant/ifi-project06/robin/programs/vivado
 +
it can be accessed from any Windows machine, but it does need to have
 +
the LM_LICENSE_FILE environment variable set to 5370@lisens.ifi.uio.no
 +
 
 +
Questa is installed on SED (1454) and CHILL (3443).
 +
Please notify the engineer in ROBIN if there are issues.
 +
 
 +
'''BUG'''
 +
 
 +
Due to technical issues, you will receive the following error when creating a new project in Questa on '''M:/''':
 +
 
 +
<pre style="color:#ff0000">
 +
# Project file M:/inf3430/my_first_project.mpf is not readable.
 +
# Unable to open project.
 +
</pre>
 +
 
 +
We are sorry to inform that there are no current solutions to this problem. However, we are working on a solution. You may use;
 +
 
 +
C:\users\<username>
 +
 
 +
for storing project files, but be ware that there is no backup and you need to move your files to M:\ before log out of the client.
 +
 
 +
You may also use X-Win32 to get Linux with GUI on IFIs Windows clients: https://termvakt.uio.no/Fjerninnlogging#Xterm_via_X-Win32
 +
 
 +
--->
 +
 
 +
<!-- = Digilent Adept on Linux =
 +
Digilent Adept to program the Atlys board can be obtained from the Digilent website.
 +
 
 +
Note that some Xilinx scripts require GNU BASH. Ubuntu (and possibly others) come with DASH.
 +
Disable DASH by reconfiguring it:
 +
sudo dpkg-reconfigure dash
 +
 
 +
Note that the tools available on Windows, such as Xilinx ISE/PlanAhead and Modelsim are not supported by drift on Linux.
 +
 
 +
To enable autocompletion and history in XMD:
 +
rlwrap xmd-->
 +
 
 +
= License server =
Licenses can be checked out from lisens.ifi.uio.no:
Licenses can be checked out from lisens.ifi.uio.no:
Line 55: Line 142:
  setx LM_LICENSE_FILE 5370@lisens.ifi.uio.no
  setx LM_LICENSE_FILE 5370@lisens.ifi.uio.no
-
=== EDK Scripts ===
+
NOTE: The license server only works from UiOs network.
 +
 
 +
= Academic Xilinx FPGA tools =
Python interface to Xilinx/EDK MHS: https://github.com/EPiCS/reconos/tree/master/tools
Python interface to Xilinx/EDK MHS: https://github.com/EPiCS/reconos/tree/master/tools
-
XDL Format description: http://www.mn.uio.no/ifi/english/research/projects/cosrecos/publications/paper/recosoc11beckhoff.pdf
+
Bitstream Intepretation Library (Virtex5): https://github.com/florianbenz/bil
 +
 
 +
DeBit: http://code.google.com/p/debit/
 +
 
 +
TORC: http://torc-isi.sourceforge.net/
 +
 
 +
ReconOS: http://www.reconos.de
 +
 
 +
= Having problems? =
 +
 
 +
If you are having problems running the tools as mentioned, please ask a group teacher or send an mail to: robin-engineer at ifi.uio.no.
 +
 
 +
== "command not found"  => Not running .bashrc? ==
 +
 
 +
When running ssh from another linux system or Mac, it is possible that only .bash_profile is read, not .bashrc. This will typically lead to "command not found" when trying to launch vsim or any other program that should have been found in the path. This can be further confirmed by listing PATH or the MODELSIM variable
 +
>>echo $PATH
 +
>>echo $MODELSIM
 +
If they don't show traces of what you have put into .bashrc, it has not been run, or the variables have over-written later.
 +
 
 +
To ensure that the .bashrc is run when opening a new xterm or ssh'ing into a new server, append the following to your .bash_profile:
 +
if [ -f ~/.bashrc ]; then
 +
  source ~/.bashrc
 +
fi
 +
 
 +
You can also manually source .bashrc and then open a new xterm that can use vsim
 +
>>source ~/.bashrc
 +
>>xterm &
 +
 
 +
This last solution will of course be a one-time only approach, since it doesn't change any configuration file.
 +
 
 +
Here is an article on how it became two configuration files rather than just one:
 +
[http://www.joshstaiger.org/archives/2005/07/bash_profile_vs.html www.joshstaiger.org/archives/2005/07/bash_profile_vs.html ]
 +
 
 +
== Remote access with GUI ==
 +
X11 forwarding is required to be able to see windows opened on a linux server. On windows, X-win32 can be used. For linux ssh -X or ssh -Y can be used, while on MAC you may need XQuartz or something similar to allow X11 forwarding. More on this can be found [https://robin.wiki.ifi.uio.no/Remote_access here].

Current revision as of 11:46, 3 January 2024

Contents

FPGA tools on LISP (2428)

Vivado and Vitis is installed locally on the computers in LISP. To launch Vivado go to Applications->Education-> Vivado

Alternatively, you can find it by searching for apps using the super-key (Windows key):

class=noresize


Launch in terminal

Launching the applications is done by entering the following commands in the terminal:

Questa with GUI: 

vsim

Vivado with GUI: 

vivado

Vitis with GUI: 

vitis

Vitis HLS with GUI 

vitis_hls

Vlog (terminal only): 

vlog

Vcom (terminal only): 

vcom

Help: 

<command> -h

VHDL using VSCode

VHDL code can also be edited using VSCode (Visual Studio Code) which is installed on computers at LISP.

  • Launch Vscode by searching through applications: Applications -> VSCode
  • Add the extension for VHDL syntax highlighting by:
    • View -> Extensions or <Ctrl + Shift + X> to open the Extensions window.
  • Search VHDL and you will see a list of extensions. Install VHDL by Pu Zhao. (Note: there are other suitable vhdl extensions as well).
  • Once installed, enable the extension (if not done automatically).

Questa and modelsim.ini in write mode

You might get the following error message when using Questa: 

# ** Error: (vmap-7) Failed to open ini file "/uio/kant/ifi-project06/robin/CADlib/modelsim.ini" in write mode.
# Permission denied. (errno = EACCES)

This is expected behavior because you are using a shared write protected modelsim.ini. To make your own copy of the modelsim.ini file, run; 

mkdir -p ~/.config/modelsim/                             # Make a directory for modelsim config
cp $CADLIB/modelsim.ini ~/.config/modelsim/modelsim.ini  # Copy modelsim.ini

Lastly, you need to alter the MODELSIM variable. Open the .bashrc in your editor of choise (e.g code ~/.bashrc) and add the following line: 

# Setting MODELSIM variable used in IN3160
export MODELSIM=$HOME/.config/modelsim/modelsim.ini

Restart the terminal or run source ~/.bashrc for the changes to take effect.

FPGA tools via share on Linux

This section is not necessary to perform to be able to use the software on LISP and VDI: Digital electronics. The clients in LISP has the Xilinx software installed locally.

First time initialization

If you need to use Xilinx' software other places than the RHEL clients at LISP or ALGOL, utilize the following guide: 

cd 
nano .bashrc

Append the following lines to the end of the .bashrc file: 

# Vitis Unified 2020.2 64-bit version
if ! [ -x "$(command -v vivado)" ]; then
  source /projects/robin/programs/Vivado/2020.2/settings64.sh
  export PATH=$PATH:/projects/robin/programs/Vivado/2020.2/bin
fi

# License file
export LM_LICENSE_FILE=5370@lisens.ifi.uio.no

# Remove duplicants in the PATH variable
PATH=$(printf "%s" "$PATH" | awk -v RS=':' '!a[$1]++ { if (NR > 1) printf RS; printf $1 }')

After you have added the latter and saved the .bashrc file, restart the terminal or 'source' the .bashrc file.

Other versions

If needed, you can also make use of older or newer versions of the Xilinx products. As of August 2020, we have 2016.4, 2018.3 and 2020.2 available.


License server

Licenses can be checked out from lisens.ifi.uio.no: 

export LM_LICENSE_FILE=5370@lisens.ifi.uio.no

On Windows: 

setx LM_LICENSE_FILE 5370@lisens.ifi.uio.no

NOTE: The license server only works from UiOs network.

Academic Xilinx FPGA tools

Python interface to Xilinx/EDK MHS: https://github.com/EPiCS/reconos/tree/master/tools

Bitstream Intepretation Library (Virtex5): https://github.com/florianbenz/bil

DeBit: http://code.google.com/p/debit/

TORC: http://torc-isi.sourceforge.net/

ReconOS: http://www.reconos.de

Having problems?

If you are having problems running the tools as mentioned, please ask a group teacher or send an mail to: robin-engineer at ifi.uio.no.

"command not found" => Not running .bashrc?

When running ssh from another linux system or Mac, it is possible that only .bash_profile is read, not .bashrc. This will typically lead to "command not found" when trying to launch vsim or any other program that should have been found in the path. This can be further confirmed by listing PATH or the MODELSIM variable 

>>echo $PATH
>>echo $MODELSIM

If they don't show traces of what you have put into .bashrc, it has not been run, or the variables have over-written later.

To ensure that the .bashrc is run when opening a new xterm or ssh'ing into a new server, append the following to your .bash_profile: 

if [ -f ~/.bashrc ]; then
  source ~/.bashrc
fi

You can also manually source .bashrc and then open a new xterm that can use vsim 

>>source ~/.bashrc
>>xterm &

This last solution will of course be a one-time only approach, since it doesn't change any configuration file.

Here is an article on how it became two configuration files rather than just one: www.joshstaiger.org/archives/2005/07/bash_profile_vs.html

Remote access with GUI

X11 forwarding is required to be able to see windows opened on a linux server. On windows, X-win32 can be used. For linux ssh -X or ssh -Y can be used, while on MAC you may need XQuartz or something similar to allow X11 forwarding. More on this can be found here.

Retrieved from "https://robin.wiki.ifi.uio.no/FPGA_tools"
Personal tools
Front page