asmamohsin997 / FPGA_IGNITE_2024

Files

	README.md
	cover.png

README.md

FPGA_IGNITE_2024

This is a Multi Project Die (MPD) submission which contains designs created during the FPGA Ignite Summer School 2024 at Heidelberg University. The designs include a VGA driver with a Pixel Processing Unit (PPU) (FPGAIgnite-VGA), a random number generator (THE RING), an application-level posit capable RISC-V core (PERCIVAL) and a RISC-V eFPGA with custom instruction extensions (CXBex). All designs are connected to an eFPGA created using the FABulous Framework.

In order to interact with this project, make sure you have provided your ssh key here.

By convention, the original / primary remote repository is called origin.

Instructions

Local Project Setup - Git Commands

If you are starting a brand new project without a local repository, here are the suggested Git commands:

git clone ssh://git@repositories.efabless.com/asmamohsin997/FPGA_IGNITE_2024.git
cd FPGA_IGNITE_2024
... do some changes
git push -u origin main

If you already have a local Git repository, initialized with git init, you will need to associate your local repository with the Efabless Repository remote location. The following Git commands will add Efabless Repository as a remote repository and push your changes to the main branch.

git remote add origin ssh://git@repositories.efabless.com/asmamohsin997/FPGA_IGNITE_2024.git
git pull origin main --rebase --allow-unrelated-histories
git push -u origin main

If you already have a remote repository, for example one on GitHub, use the Git command below to add another remote Git repo (make sure that each repo has its unique ID, e.g. origin, ef-repo in the example below).

git remote add ef-repo ssh://git@repositories.efabless.com/asmamohsin997/FPGA_IGNITE_2024.git
git push -u ef-repo main --force

How To Update Your Project Cover Image

A default cover.png has already been added to the root directory of this remote repository.

If your project is not private, this image can be viewed in the project search results list.

To show your own cover image, replace cover.png with a file called 'cover' and an allowed image extension ('.jpg', '.jpeg', '.png', '.gif', '.webp') and then push your changes.