PyFPGA containers

A collection of Docker containers featuring a curated selection of Free/Libre and Open-Source Software (FLOSS) tools for FPGA development. They streamline the setup process, ensuring consistency and easy access across diverse environments. Below is a list of the available containers and their included tools.

• langutils: utilities for processing and analyzing HDL languages
  • vhd2vl
  • Slang
  • sv2v
  • svlint
  • Verible
  • Surelog
• synthesis: tools for logic synthesis
  • GHDL
  • Yosys (now including sv-elab)
  • ghdl-yosys-plugin
  • synlig
• simulation: tools for simulation
  • GHDL
  • iVerilog
  • Verilator
  • cocotb
• nextpnr based containers: place and route + bitstream manipulation
  • nextpnr-apicula: for gowin FPGAs (apicula)
  • nextpnr-icestorm: for Lattice iCe40 FPGAs (icestrom)
  • nextpnr-trellis: for Lattice ecp5 FPGAs (trellis)

In the CI pipeline, the Dockerfile is used to build a Docker image, which is then pushed to the GitHub Container Registry. From there, it can be pulled and run as a container whenever needed.

docker run --user $(id -u):$(id -g) --rm -v $PWD:$PWD -w $PWD ghcr.io/pyfpga/<image> <command>

Replace <image> with the appropriate image name and <command> with the command you want to execute inside the container.