Commit 00be27e4 authored by Stefan Tauner's avatar Stefan Tauner
Browse files

Bump Verilog-Perl version number again and update respective documentation

parent 368b547d
......@@ -30,8 +30,8 @@ use List::Util qw[min max];
use Log::Log4perl qw(get_logger :easy);
use File::Basename qw(basename);
use Verilog::Netlist 3.440;
use Verilog::Language 3.440;
use Verilog::Netlist 3.442;
use Verilog::Language 3.442;
use FIJI::VHDL;
use FIJI qw(:fiji_logo :fiji_version);
......
......@@ -122,8 +122,7 @@ Another dialog that is not exclusive to \texttt{fiji\_setup.pl} is \texttt{Tk::F
\label{sec:instrumentation}
The components of the Verilog parsing/generation library named Verilog-Perl contained in the various \texttt{Verilog::*} packages form the backbone of \texttt{fiji\_instrument.pl} that instruments the given user design according to the information in the \ac{FIJI} Settings.
Support for buses and concatenations had to be added to Verilog-Perl by us and is currently in the process of being upstreamed.
Until this is complete you have to use our fork available from \fixme{add link to github or es}.
Support for buses and concatenations had to be added to Verilog-Perl by us and its first version has been merged to upstream in version 3.440.
The interface between Verilog-Perl and \ac{FIJI} is \texttt{FIJI::Netlist} that provides functions to read in Verilog netlists, find drivers of a net and instrumenting nets.
The general idea of the instrumentation process (cf.\ \texttt{FIJI::Netlist::instrument\_net}):
......
......@@ -59,21 +59,14 @@ which can be found in \Cref{tab:perlmod}.
Linux distributions often have Perl interpreters installed by default and we recommend to use the one shipped with the distribution.
The availability of Perl packages varies greatly among distributions but if they are available in the distribution's repository the probably should work fine.
The only exception is Verilog-Perl that was modified quite significantly during the project and is unlikely to include our changes already.
The only exception is Verilog-Perl that was modified quite significantly during the project and is unlikely to include our changes already in any distribution.
The minimum version required is 3.442.
Currently one has to compile Verilog-Perl from source because our modifications have not been merged upstream yet.
You will need the typical build utilities like \texttt{g++}, \texttt{bison}, \texttt{flex} and \texttt{make} for this.
Also, you need to acquire the respective source code from our Github repository at \url{https://github.com/uastw-embsys/Verilog-Perl/archive/pin-selects.zip}.
To build and install it, simply extract the archive, open a shell at the respective location and execute the commands in \Cref{lst:verilog-perl}.
\begin{lstlisting}[caption=Verilog-Perl installation,style=shell,label={lst:verilog-perl}]
perl Makefile.PL # This generates a Makefile suitable for your OS
make # Compiles Verilog-Perl and requires various build utilities as mentioned above
sudo make install # Installs Verilog-Perl into a system-wide directory (usually /usr/local/...)
\end{lstlisting}
To build it from source you would need the typical build utilities like \texttt{g++}, \texttt{bison}, \texttt{flex} and \texttt{make}.
The installation can be done via CPAN or manually as documented at \url{https://www.veripool.org/projects/verilog-perl/wiki/Installing}.
The remaining Perl packages should be available from the distributor in a suitable version.
However, \ac{FIJI} also comes with a script to install all required Perl packages from CPAN as well.
However, \ac{FIJI} also comes with a script to install all required Perl packages (including Verilog-Perl) from CPAN as well.
It is contained in \texttt{bin/install\_prerequisites.sh}.
\subsubsection{Windows}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment