Open-Source Library for Physical Design Research and Teaching

Master:

Development:

Ophidian is an open-source library developed at Embedded Computing Lab (ECL), Federal University of Santa Catarina (UFSC), Brazil. The main objective of Ophidian project is to provide a multi-platform library to facilitate the research and teaching of topics associated to the physical design of integrated circuits.

Ophidian was conceived by Chrystian Guth, Renan Netto, and Vinicius Livramento, under the advise of Prof. José Güntzel, during their research activities at Federal University of Santa Catarina.

• Getting Started
  • Debian Family
  • Arch Linux
  • Others
• Hello World!
  • Documentation
• Contributing
  • Project Structure
• Build and Installation Guide
  • Build Dependencies
  • Compiling Ophidian
• Credits

Get Ophidian! We support a few of the most used linux environments.

Add the Ophidian repository ppa.

$ sudo add-apt-repository -y -u ppa:eclufsc/ophidian
$ sudo apt install libophidian-dev

First you will need to add the Launchpad PPA for eclufsc gpg key:

$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys A62C1A5EFCB3D41A1FDB35758179B53998C15E64 && apt-get update -qq

Then add the launchpad repository and install ophidian.

$ sudo add-apt-repository -y -u -m "deb https://ppa.launchpad.net/eclufsc/ophidian/ubuntu artful main"
$ sudo apt install libophidian-dev

Just install it via the AUR package ophidian-git:

$ pacaur -S ophidian-git

If we do not support your distro, consider building it from source!

So you want to code? We make avaliable a project template to make your life easier!

Documentation at eclufsc.gitlab.io/ophidian

Make shure to follow CppCoreGuidelines.

For code style, try to keep very close to the C++ Standard Library.

Feel free to fork Ophidian and create a merge request!

So you want to push new code to Ophidian? First you should have an idea of the project structure:

ophidian
|   README.md
|   CMakeLists.txt
|   build_dependencies.sh
|   uncrustify.cfg
|   ...
|
+---cmake
|   |   FindLemon.cmake
|   |   uncrustify_helper.cmake
|   |   ...
|
+---3rdparty
|   |   +---catch
|   |   +---DEF
|   |   +---LEF
|   |   ...
|
+---ophidian
|   |   CMakeLists.txt
|   |   +---circuit
|   |   +---design
|   |   +---floorplan
|   |   ...
|
+---apps
|   |   CMakeLists.txt
|   |   +---gui
|
+---test
    |    CMakeLists.txt
    |   main.cpp
    |   +---circuit
    |   +---design
    |   +---floorplan
    |   ...

This is the main Cmake file for the ophidian project, it's goals are set up project variables, handle dependencies and include the project subdirectories.

This script serves as a c++ npm, gem, pip, equivalent. It will fetch all third party git submodules located at ophidian/3rdparty, compile and install them to ophidian/dependencies by default.

Here you will have all custom made cmake modules used by the CMakeLists.txt files.

This directory holds the git submodules with the source code of ophidian's dependencies.

Here you will have directories for each library developed by the ophidian team. Each library directory will have its own CMakeLists.txt file with its own compilation instructions.

This file handles the installation rules for the ophidian library.

Here you will have directories for each ophidian application developed by the ophidian team. Each application directory will have its own CMakeLists.txt file with its own compilation instructions.

This file handles application directories.

Here you will find graphical user interface directories following the MVC model.

This file handles the installation rules for the graphical user interface.

Here you will find directories for each ophidian library unit tests.

This file handles the compilation instructions for the unit tests binary.

This section will guide you on the compilation process of the Ophidian library. The Ophidian library depends on the following third party software:

• Cmake (>= 3.5.2)
• Boost (>= 1.63)
• Lemmon
• Units
• Flute
• Verilog-Parser
• DEF
• LEF

Although some of this dependencies like Cmake and Boost are realy well supported on any operational system, the others can be a hassle to have on your system. So you can try building them yourself!

First, make shure you have all dependencies dependencies:

• zlib
• Bison
• Flex

Second, if you are going to use the graphical user interface, make shure you have all gui's dependencies:

• SFML (>= 2.0)
• QT (>= 5.0)

Run the provided script build_dependencies.sh located at the source root.

$ bash build_dependencies.sh

Ophidian uses Cmake as a build system generator, if you are familiar with it you probably know the following:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make

Cmake Configuration options:

-DOPHIDIAN_TESTS_FULLY_STATIC=ON will staticly link libc and libc++.

-DUNCRUSTIFY_IT=ON will run uncrustify in all files.

-DUNCRUSTIFY_CHECK=ON will run check all files formating with uncrustify.

-DOPHIDIAN_GUI=ON will able building ophidian graphic user interface.

In order to run the ophidian unity tests, inside the build directory, execute the folowing:

cd test
./ophidian_tests

P.S. ophidian_tests needs to be executed from the test directory due to the inputfile's path being hardcoded.

In order to run the graphic user interface, inside the build directory, execute the folowing:

cd apps/gui
./ophidian_gui

If you wish to install dependencies on your system run:

$ sudo bash build_dependencies.sh --install_to /usr/local

This will install all dependencies to the /usr/local directory.

If you wish to install Ophidian on your system please make shure your have installed all dependencies on your system first then run:

 $ sudo make install

This will install the Ophidian Library to the /usr/local directory.

Currently, Ophidian has many collaborators in the same university that support its development.

• Bernardo Mendonça
• Chrystian Guth
• José Güntzel
• Renan Netto
• Thiago Barbato
• Tiago Augusto Fontana
• Sheiny Fabre Almeida
• Vinicius Livramento
• João Vicente Souto