Skip to content
Open-source ECP5 toolchain, including synthesis, place-and-route, and Risc-V GCC
Branch: master
Clone or download
xobs git: windows: use cp and hardlinks to merge files
Signed-off-by: Sean Cross <>
Latest commit e597cfd Nov 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
extras/windows build: add extra windows binaries for soc on windows Nov 15, 2019
.gitattributes initial commit Aug 17, 2019
.gitignore initial commit Aug 17, 2019
.travis.yml travis: specify slug when encrypting token Sep 11, 2019 README: ice40 -> ecp5 Sep 12, 2019 git: windows: use cp and hardlinks to merge files Nov 15, 2019

ECP5 Toolchain

This repository contains prebuilt versions of all the tools you will need to develop for an ECP5 board.


Download the latest release for your platform and extract it somewhere on your disk. Then set your PATH:

  • MacOS: export PATH=[path-to-bin]:$PATH
  • Linux: export PATH=[path-to-bin]:$PATH
  • Windows Powershell: $ENV:PATH = "[path-to-bin];" + $ENV:PATH
  • Windows cmd.exe: PATH=[path-to-bin];%PATH%

To confirm installation, run a command such as nextpnr-ecp5 or yosys.

What's included

This contains almost everything you'll need to develop on Fomu:

  • yosys -- synthesis
  • nextpnr-ecp5 -- place-and-route
  • dfu-util -- upload bitstream to the FPGA
  • python3 -- required for nextpnr-ecp5 and to build litex projects
  • riscv-gcc -- compile code for Risc-V CPUs, such as the Risc-V softcore
  • wishbone-tool -- access the Wishbone debug bus over USB or SPI

Additionally, the macOS and Windows versions include make.

It is strongly recommended that you install git to manage repositories and check out code, though it is not strictly necessary.

You can’t perform that action at this time.