Installation

Linux

Install with pip

PyGears requires a specific version of Python3, namely Python 3.6 or later, so think about using pygears-tools and the procedure given below for installing the correct python version together with PyGears. Otherwise, consider using virtualenv or pyenv to manage your Python version.

Install PyGears package with the command below. Depending on how your Python was installed you might get an error and need to prefix the command with sudo:

pip3 install pygears

[Optional] Obtain examples and tests:

git clone https://github.com/bogdanvuk/pygears.git
cd pygears/tests

Installing using pygears-tools

Below you can find a procedure for installing the PyGears with the correct Python version. On detailed description and capabilities of pygears-tools refer to PyGears tools setup page. The procedure was tested on Ubuntu 18.04, Ubuntu 16.04, Ubuntu 14.04 and openSUSE Leap 15.

sudo apt install python3-pip
sudo pip3 install pygears-tools

# List the system-wide dependencies for the tools
pygears-tools-install -l pyenv python pygears

# copy and run the install commands output by 'pygears-tools-install -l', i.e
# sudo apt install build-essential
# sudo apt install git libxmlsec1-dev curl ...

pygears-tools-install pyenv python pygears

The script will create tools.sh bash file that should be sourced prior to running the cosimulation:

source ~/.pygears/tools/tools.sh

Alternative installation from source

git clone https://github.com/bogdanvuk/pygears.git
cd pygears
python3 setup.py install

Installing Verilator

If you would like to run cosimulations with the Verilator, you need to make sure that it is available on the PATH. You can install it manually by following these instructions. As an alternative, PyGears offers a script that automatically compiles the latest Verilator. The script was tested on Ubuntu.

# List the system-wide dependencies for Verilator
pygears-tools-install -l verilator

# copy and run the install commands output by 'pygears-tools-install -l verilator', i.e:
# sudo apt install build-essential
# sudo apt install autoconf flex bison

pygears-tools-install verilator

The script will create tools.sh bash file that should be sourced prior to running the cosimulation:

source ~/.pygears/tools/tools.sh

Installing GTKWave

PyGears simulator outputs standard VCD format, which can be viewed by an open-source viewer GTKWave. You can install it on Ubuntu via:

.. code-block:: bash

sudo apt install gtkwave