mirror of
https://github.com/YosysHQ/sby.git
synced 2025-04-11 08:13:35 +00:00
123 lines
3.1 KiB
ReStructuredText
123 lines
3.1 KiB
ReStructuredText
.. _install-doc:
|
|
|
|
Installation guide
|
|
==================
|
|
|
|
This document will guide you through the process of installing SymbiYosys.
|
|
|
|
CAD suite(s)
|
|
************
|
|
|
|
SymbiYosys (sby) is part of the `Tabby CAD Suite
|
|
<https://www.yosyshq.com/tabby-cad-datasheet>`_ and the `OSS CAD Suite
|
|
<https://github.com/YosysHQ/oss-cad-suite-build>`_! The easiest way to use sby
|
|
is to install the binary software suite, which contains all required
|
|
dependencies, including all supported solvers.
|
|
|
|
* `Contact YosysHQ <https://www.yosyshq.com/contact>`_ for a `Tabby CAD Suite
|
|
<https://www.yosyshq.com/tabby-cad-datasheet>`_ Evaluation License and
|
|
download link
|
|
* OR go to https://github.com/YosysHQ/oss-cad-suite-build/releases to download
|
|
the free OSS CAD Suite
|
|
* Follow the `Install Instructions on GitHub
|
|
<https://github.com/YosysHQ/oss-cad-suite-build#installation>`_
|
|
|
|
Make sure to get a Tabby CAD Suite Evaluation License for extensive
|
|
SystemVerilog Assertion (SVA) support, as well as industry-grade SystemVerilog
|
|
and VHDL parsers!
|
|
|
|
For more information about the difference between Tabby CAD Suite and the OSS
|
|
CAD Suite, please visit https://www.yosyshq.com/tabby-cad-datasheet.
|
|
|
|
Installing from source
|
|
**********************
|
|
|
|
Follow the instructions below to install SymbiYosys and its dependencies.
|
|
Yosys, SymbiYosys, and Z3 are non-optional. The other packages are only
|
|
required for some engine configurations.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Installing prerequisites (this command is for Ubuntu 16.04):
|
|
|
|
.. code-block:: text
|
|
|
|
sudo apt-get install build-essential clang bison flex libreadline-dev \
|
|
gawk tcl-dev libffi-dev git mercurial graphviz \
|
|
xdot pkg-config python python3 libftdi-dev gperf \
|
|
libboost-program-options-dev autoconf libgmp-dev \
|
|
cmake curl
|
|
|
|
Required components
|
|
-------------------
|
|
|
|
Yosys, Yosys-SMTBMC and ABC
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
https://yosyshq.net/yosys/
|
|
|
|
https://people.eecs.berkeley.edu/~alanmi/abc/
|
|
|
|
Next install Yosys, Yosys-SMTBMC and ABC (``yosys-abc``):
|
|
|
|
.. code-block:: text
|
|
|
|
git clone https://github.com/YosysHQ/yosys
|
|
cd yosys
|
|
make -j$(nproc)
|
|
sudo make install
|
|
|
|
SymbiYosys
|
|
^^^^^^^^^^
|
|
|
|
https://github.com/YosysHQ/sby
|
|
|
|
.. code-block:: text
|
|
|
|
git clone https://github.com/YosysHQ/sby
|
|
cd sby
|
|
sudo make install
|
|
|
|
Z3
|
|
^^
|
|
|
|
https://github.com/Z3Prover/z3/wiki
|
|
|
|
.. code-block:: text
|
|
|
|
git clone https://github.com/Z3Prover/z3
|
|
cd z3
|
|
python scripts/mk_make.py
|
|
cd build
|
|
make -j$(nproc)
|
|
sudo make install
|
|
|
|
Optional components
|
|
-------------------
|
|
Additional solver engines can be installed as per their instructions, links are
|
|
provided below.
|
|
|
|
Yices 2
|
|
^^^^^^^
|
|
http://yices.csl.sri.com/
|
|
|
|
https://github.com/SRI-CSL/yices2
|
|
|
|
super_prove
|
|
^^^^^^^^^^^
|
|
https://github.com/sterin/super-prove-build
|
|
|
|
Avy
|
|
^^^
|
|
https://arieg.bitbucket.io/avy/
|
|
|
|
Boolector
|
|
^^^^^^^^^
|
|
http://fmv.jku.at/boolector/
|
|
|
|
https://github.com/boolector/boolector
|
|
|
|
To use the ``btor`` engine you additionally need a newer version of btorsim
|
|
than the boolector setup script builds: https://github.com/boolector/btor2tools
|