Welcome to F4PGA examples!

This guide explains how to get started with F4PGA and build example designs from the F4PGA Examples GitHub repository. It currently focuses on the following FPGA families:

• Artix-7 from Xilinx,

• EOS-S3 from QuickLogic.

Follow this guide to:

• install F4PGA and all of its dependencies,

• build and upload example designs onto the devboard of your choice.

• compile and run your own designs using the F4PGA toolchain.

• customize the Makefile for your own designs.

About F4PGA

F4PGA is a fully open source toolchain for the development of FPGAs, currently targeting chips from multiple vendors, e.g.:

• Xilinx’s 7-Series.

• Lattice’s ICE40 and ECP5.

• QuickLogic’s EOS-S3.

Gain valuable information about the flows and the tools in section Design Flows at F4PGA Documentation.

Table of Contents

• Getting F4PGA
  • Prerequisites
  • Toolchain installation
    • Conda
      • Choose the install directory
      • Setup and download assets
• Building example designs
  • Xilinx 7-Series
    • Counter test
    • PicoSoC demo
    • LiteX demo
    • Timer
    • Pulse Width
  • QuickLogic EOS S3
    • Button counter
• Running example designs
  • Connecting development boards
    • Arty board
    • Basys 3 board
    • Zybo-Z7 board
  • Connecting to UART
  • Setting up TFTP
  • Configuring your network interfaces
  • Setting up Zynq ARM CPU
    • Prepare SD card
    • Load bitstreams from U-boot

Custom designs

• Building custom designs
  • Preparing Your Design
    • HDL Files
    • Constraint File
    • Makefile
  • Building your personal projects
• Customizing the Makefiles
  • Example
  • Adding HDL Sources and Specifying the Top Module
  • Constraint files
  • A Note on the example designs use of ifeq/else ifeq blocks

Additional example designs

• Running Project F designs
• Additional Basys3 Examples

Development

• Building the documentation
• Running CI locally