openflex 0.1.3

Framework for Logic Synthesis and EXploration

OpenFLEX

A python module/CLI Framework for Logic Synthesis and EXploration

Installation

The easiest way to install OpenFLEX is using pip. To install OpenFLEX in a Python virtual environment, you can run the following commands:

python -m venv .venv      # this will create a `.venv` directory in your current directory
source .venv/bin/activate # activate the virtual environment
pip install -U pip        # update the default pip version
pip install openflex      # install OpenFLEX and its dependencies inside venv

To de-activate the environment (if you need to delete it, or are switching to another one), simply run the following command:

deactivate

Usage

The following usage instructions will use files from the examples/ directory of this repository. Currently, there are two examples:

1. examples/mult/ : simple combinational logic multiplier with a testbench
2. examples/blinky/ : classic blinky counter/LED example without a testbench

Each example directory contains two types of files: (1) RTL modules and (2) YAML configuration files. The YAML configuration files are used to contain the details/parameters required to simulate or synthesize the RTL modules, e.g., file list, EDA tool, top-level module/testbench parameters, etc.

Examine the mult_sim.yml YAML configuration file contents:

mode: sim
tool: questa
top: mult_tb

files:
  - ./mult.sv
  - ./mult_tb.sv

parameters:
  NUM_TESTS: [1000]
  IS_SIGNED: [0, 1]
  INPUT_WIDTH: [8, 16]

With this configuration, OpenFLEX will run the mult_tb testbench four times (Cartesian product of the IS_SIGNED and INPUT_WIDTH parameters).

To run a simulation using the mult example, make sure any relevant virtual environment is loaded, and run the following commands:

cd examples/mult
openflex mult_sim.yml

This will create a build_questa directory that contains the build artifacts, logs, etc.

Contributing

If you would like to make live modifications to the OpenFLEX source code, then you will need to clone this repository and install it in editable mode.

Start by cloning the repository, and then from its root directory, run the following:

python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .  # install OpenFLEX locally as editable

Now, any modifications you make to the OpenFLEX source code should be reflected the next time you run or use openflex.