Installation From Source[edit | edit source]
Simbus is still in early development, so there are not yet any stable releases. The source code releases are available either as snapshots, or from the git repository.
Before compiling/installing SIMBUS, you need to install Icarus Verilog. The compilation process for SIMBUS looks for an Icarus Verilog installation so that is can compile and install the VPI modules. SIMBUS expects Icarus Verilog version at least 0.9.
Obtaining Snapshots[edit | edit source]
The ftp site for the latest snapshot is ftp://ftp.icarus.com/pub/eda/simbus/snapshots. Download a tarball with a name such as simbus-version.tar.gz and un-tar it using:
% tar -zxvf simbus-version.tar.gz
This will create a directory, similar to the name of the tarball, such as simbus-version. Change into this directory using:
% cd simbus-version
The source is then compiled and installed in the manner appropriate for your operating system. See below.
Obtaining Source From git[edit | edit source]
The source code for SIMBUS is stored under the git source code control system. You can use git to get the latest development head or the latest of a specific branch.
To get the development version of the code follow these steps:
% git clone git://github.com/steveicarus/simbus.git
The clone will create a directory, named simbus, containing the source tree, and will populate that directory with the most current source from the HEAD of the repository.
Change into this directory using:
% cd simbus
Normally, this is enough as you are now pointing at the most current development code, and you have implicitly created a branch "master" that tracks the development head.
Now that you've cloned the repository, your local source tree may later be synced upwith the development source by using the git command:
% git pull
The git system remembers the repository that it was cloned from, so you don't need to re-enter it when you pull.
Finally, configuration files are built by the extra step:
The source is then compiled as appropriate for your system.
The icarus.com URL is for the master version of the git repository, but there is a mirror at <git://github.com/steveicarus/simbus.git>. The mirror is updated daily, so there may be some delay.
Compiling on Linux/Unix[edit | edit source]
This is probably the easiest case. Given that you have the source tree from the above instructions, the compile and install is generally as simple as:
% ./configure % make (su to root) # make install
The "make install" typically needs to be done as root so that it can install in directories such as "/usr/local/bin" etc. You can change where you want to install by passing a prefix to the "configure" command:
% ./configure --prefix=/my/special/directory
This will configure the source for eventual installation in the directory that you specify. Note that "rpm" packages of binaries for Linux are typically configured with "--prefix=/usr" per the Linux File System Standard.