Skip to content
ILA template-based Synthesis
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
cmake
docs
example/simple
include/ilasynth
scripts
src
test
tmp
.clang-format
.gitignore
.travis.yml
CMakeLists.txt
Jamroot
LICENSE
README.md

README.md

Build Status Build Status Build status Build status Codacy Badge Language grade: C/C++ Documentation

About

This is an implementation of the templated-based Instruction-Level Abstraction (ILA) synthesis based on TCAD18.

Dependencies

  • z3 4.4.0 or above.
  • boost 1.50.0 or above.

For Debian-based UNIX, you can install by running

apt-get install libboost-all-dev z3 libz3-dev

For OSX, you can install by running

brew install boost boost-python z3

Building

The ILA synthesis engine support build using Boost bjam and CMake. Currently, unit tests are available in the Boost build only.

Boost for Python API

cd /root/of/this/repo
bjam -j$(nproc)

CMake for Cpp Projects

cd /root/of/this/repo
mkdir -p build
cd build
cmake ..
make -j$(nproc)

Python API

You need to first export the library.

# bash
export PYTHONPATH=$(pwd)/build:$PYTHONPATH
# Python 
import ila
abs = ila.Abstraction("test")

CMake Integration

You can use the ilasynth::ilasynth interface target in CMake. This target populates the appropriate usage requirements for include directories, linked libraries, and compile features.

#include <ilasynth/abstraction.hpp>

void foo () {
  auto m = ilasynth::Abstraction("new_abstraction");
}

External

To use the library from a CMake project, you can locate it directly with find_package() and use the namespaced imported target from the generated package configuration:

# CMakeLists.txt
find_package(ilasynth REQUIRED)
...
add_library(my_proj ...)
...
target_link_libraries(my_proj PRIVATE ilasynth::ilasynth)

Embedded

It also supports embedded build, but is not recommended due to its size. To embed the library directly into an existing CMake project, place the entire source tree in a subdirectory and call add_subdirectory() in your CMakeLists.txt file:

add_subdirectory(ilasynth)
...
add_library(my_proj ...)
...
target_link_libraries(my_proj PRIVATE ilasynth::ilasynth)

Supporting Both

To allow your project to support either an externally installed or an embedded library, you can use the following pattern:

# Top level CMakeLists.txt
project(MY_PROJ)
...
option(MY_PROJ_USE_EXTERNAL_ILASYNYH "Use an external library" OFF)
...
add_subdirectory(externals)
...
add_library(my_proj ...)
...
target_link_libraries(my_proj PRIVATE ilasynth::ilasynth)
# externals/CMakeLists.txt
...
if(MY_PROJ_USE_EXTERNAL_ILASYNTH)
  find_package(ilasynth REQUIRED)
else()
  add_subdirectory(ilasynth)
endif()
...

externals/ilasynth is then a complete copy of this source tree, if enabled.

Contributors

You can’t perform that action at this time.