caiyu/nextpnr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
nextpnr portable FPGA place and route tool
215 Commits 22 Branches 7 Tags 17 MiB
C++ 83.2%
Python 5.5%
Verilog 4%
C 3.8%
Assembly 1.7%
Other 1.6%
3c6f1548d6
Go to file
Miodrag Milanovic 3c6f1548d6 Create all without ui file, enables more control
2018-06-15 12:22:44 +02:00
3rdparty Made gtest work on MINGW with solution from https://github.com/google/googletest/issues/606 2018-06-12 08:06:27 +02:00
common Add output of estimated total wire delay to router (as metric for placement quality) 2018-06-14 19:13:14 +02:00
dummy Refactor position/delay estimation API 2018-06-14 12:43:00 +02:00
frontend/json Add support for CellInfo->pins in router 2018-06-13 17:52:18 +02:00
gui Create all without ui file, enables more control 2018-06-15 12:22:44 +02:00
ice40 ice40: Another arch_place fix 2018-06-14 21:52:01 +02:00
python ice40: Debugging the packer 2018-06-12 12:46:30 +02:00
tests tests: Fix ice40 tests 2018-06-13 15:16:38 +02:00
.clang-format Fix clang-format include order issues 2018-06-07 12:48:53 +02:00
.gitignore cmake: Fixing the installer 2018-06-13 13:09:37 +02:00
CMakeLists.txt cmake: Fixing the installer 2018-06-13 13:09:37 +02:00
README.md Update README 2018-06-13 13:14:51 +02:00

README.md

nextpnr -- a portable FPGA place and route tool

Supported Architectures

  • iCE40

Prequisites

  • CMake 3.3 or later
  • Modern C++11 compiler (clang-format required for development)
    • Note: clang may run out of memory building the chipdbs (peak memory ~11GB) due to the system currently used. Use gcc, or the 1k-only flag, if this causes a problem.
  • Qt5 or later (qt5-default for Ubuntu 16.04)
  • Python 3.5 or later, including development libraries (python3-dev for Ubuntu)
  • Boost libraries (libboost-dev or libboost-all-dev for Ubuntu)
  • Icestorm, with chipdbs installed in /usr/local/share/icebox
  • Latest git Yosys is required to synthesise the demo design

Building

  • Use CMake to generate the Makefiles (only needs to be done when CMakeLists.txt changes)
    • For a debug build, run cmake -DCMAKE_BUILD_TYPE=Debug .
    • For a debug build with HX1K support only, run cmake -DCMAKE_BUILD_TYPE=Debug -DICE40_HX1K_ONLY=1 .
    • For a release build, run cmake .
    • Add -DCMAKE_INSTALL_PREFIX=/your/install/prefix to use a different install prefix to the default /usr/local
  • Use Make to run the build itself
    • For all targets, just run make
    • For just the iCE40 CLI binary, run make nextpnr-ice40
    • For just the iCE40 Python module, run make nextpnrpy_ice40
    • Using too many parallel jobs may lead to out-of-memory issues due to the significant memory needed to build the chipdbs
    • To install nextpnr, run make install

Running

  • To run the CLI binary, just run ./nextpnr-ice40 (you should see command line help)
  • To start the UI, run ./nextpnr-ice40 --gui
  • The Python module is called nextpnrpy_ice40.so. To test it, run PYTHONPATH=. python3 python/python_mod_test.py
  • Run yosys blinky.ys in ice40/ to synthesise the blinky design and produce blinky.json.
  • To place-and-route the blinky using nextpnr, run ./nextpnr-ice40 --hx1k --json ice40/blinky.json --pcf ice40/blinky.pcf --asc blinky.asc

Notes

  • All code is formatted using clang-format according to the style rules in .clang-format (LLVM based with increased indent widths and brace wraps after classes).
  • To automatically format all source code, run make clangformat.