FPGA ECP5 Colorlight i9 Project

This example creates a minimal Colorlight i9 v7.2 ECP5 project using the open-source OSS CAD Suite flow.

Create

radbuild project create ./workspace \
  --non-interactive \
  --template fpga-ecp5-colorlight-i9 \
  --project-name colorlight-i9-smoke

The template writes:

• settings.json
• hdl/src/top.vhd
• constraints/colorlight_i9_v7_2.lpf

Validate

radbuild project validate --settings ./workspace/colorlight-i9-smoke/settings.json

The system uses:

{
  "id": "colorlight-i9-ecp5",
  "type": "fpga.ecp5",
  "provider": "oss-cad-suite"
}

Build

Install or unpack OSS CAD Suite and set the suite root in settings.json:

{
  "toolchain": {
    "suite_root": "/home/jvincent/oss-cad-suite/oss-cad-suite"
  }
}

Then build:

radbuild build fpga \
  --settings ./workspace/colorlight-i9-smoke/settings.json \
  --system colorlight-i9-ecp5

The provider runs any configured GHDL testbenches, imports VHDL through Yosys/GHDL, runs synth_ecp5, places/routes with nextpnr-ecp5, and packs bitstream artifacts with ecppack.