Makefile Project for Synthesis, Routing, and Programming of FPGA Projects - TangNano 9K

This project is a Makefile created entirely with open-source tools to facilitate the synthesis, routing, and programming of FPGA projects using the TangNano 9K FPGA from Gowin. The workflow is simplified using Yosys and Nextpnr via Docker, while OpenFPGALoader must be installed on the user's system.

Introduction

This Makefile was developed to automate the workflow of developing projects with the TangNano 9K, from synthesis to download to the device. Using Docker ensures that all necessary environments are configured automatically, providing an easy-to-use working environment with fully open-source solutions.

Features

• Automatic synthesis of FPGA projects using Yosys
• Routing of FPGA projects with Nextpnr using the Apicula project
• Universal utility for FPGA programming using OpenFPGALoader
• Development environment encapsulated in Docker

Prerequisites

Before starting, make sure you have the following software installed:

• Docker
• Make (to run the Makefile)
• OpenFPGALoader (for downloading the bitstream to the FPGA)

Usage

1. Clone this repository to your local machine:

   git clone https://github.com/Alfredosavi/tangnano-hello.git
   cd tangnano-hello

2. To synthesize and route the project, run:

   make

3. To download the bitstream to the FPGA, run:

   make prog

4. To download the bitstream to the flash memory, run:

   make flash

5. To reset the FPGA, run:

   make reset

6. You can clean up the generated files by running:

   make clean

License

This project is licensed under the MIT License - see the LICENSE file for details.