OpenFPGA/tutorials/building.md

How to build?

Dependancies

OpenFPGA requires all the dependancies listed below:

• autoconf
• automake
• bash
• bison
• build-essential
• cmake (version 3.X at least)
• ctags
• curl
• doxygen
• flex
• fontconfig
• g++-8
• gcc-8
• g++-4.9
• gcc-4.9
• gdb
• git
• gperf
• iverilog
• libcairo2-dev
• libevent-dev
• libfontconfig1-dev
• liblist-moreutils-perl
• libncurses5-dev
• libx11-dev
• libxft-dev
• libxml++2.6-dev
• perl
• python
• texinfo
• time
• valgrind
• zip
• qt5-default

Docker

If all these dependancies are not installed in your machine you can choose to use a Docker (docker tool need to be installed). To ease customer first experience a Dockerfile is provided in OpenFPGA folder. A container ready to use can be created with the following command:

• docker run lnis/open_fpga:release
  Warning: This command is for quick testing. If you want to conserve your work you should certainly use other options as "-v".

Or a container where you can build OpenFPGA yourself can be created with the following commands:

• docker build . -t open_fpga
• docker run -it --rm -v $PWD:/localfile/OpenFPGA -w="/localfile/OpenFPGA" open_fpga bash
  docker download link

Building

To build the tool you have to be in OpenFPGA folder and do:

• mkdir build && cd build
• cmake .. -DCMAKE_BUILD_TYPE=debug
• make (WARNING using docker you cannot use "make -j", errors will happen)