99 lines
3.9 KiB
Markdown
99 lines
3.9 KiB
Markdown
# Getting Started with OpenFPGA <img src="./docs/source/overview/figures/OpenFPGA_logo.png" width="200" align="right">
|
|
[](https://github.com/LNIS-Projects/OpenFPGA/actions?query=workflow%3Alinux_build)
|
|
[](https://openfpga.readthedocs.io/en/master/?badge=master)
|
|
[](https://mybinder.org/v2/gh/lnis-uofu/OpenFPGA/master?urlpath=vscode)
|
|
|
|
Version: see [`VERSION.md`](VERSION.md)
|
|
|
|
## Introduction
|
|
|
|
The award-winning OpenFPGA framework is the **first open-source FPGA IP generator** supporting highly-customizable homogeneous FPGA architectures. OpenFPGA provides complete EDA support for customized FPGAs, including Verilog-to-bitstream generation and self-testing verification. OpenFPGA opens the door to democratizing FPGA technology and EDA techniques with agile prototyping approaches and constantly evolving EDA tools for chip designers and researchers.
|
|
|
|
**If this is your first time working with OpenFPGA, we strongly **recommend you watch the** [introduction video about OpenFPGA](https://youtu.be/ocODUGcYGqo)**
|
|
|
|
A quick overview of OpenFPGA tools can be found [**here**](https://openfpga.readthedocs.io/en/master/tutorials/getting_started/tools/).
|
|
We also recommend potential users check out the summary of [**technical capabilities**](https://openfpga.readthedocs.io/en/master/overview/tech_highlights/#) before compiling.
|
|
|
|
## Compilation
|
|
|
|
**A tutorial **video about **how to compile** can be** found [here](https://youtu.be/F9sMRmDewM0)**
|
|
|
|
Before starting, we strongly recommend you read the required dependencies at [**compilation guidelines**](https://openfpga.readthedocs.io/en/master/tutorials/getting_started/compile/).
|
|
It also includes detailed information about the docker image.
|
|
|
|
---
|
|
|
|
**Compilation Steps:**
|
|
|
|
```bash
|
|
# Clone the repository and go inside it
|
|
git clone https://github.com/LNIS-Projects/OpenFPGA.git && cd OpenFPGA
|
|
make all
|
|
```
|
|
|
|
---
|
|
|
|
**Quick Compilation Verification**
|
|
|
|
To quickly verify the tool is well compiled, the user can run the following command from the OpenFPGA root directory.
|
|
```bash
|
|
source openfpga.sh
|
|
run-task compilation_verification --debug --show_thread_logs
|
|
```
|
|
|
|
*Python3 and iVerilog v10.1+ are required. GUI will pop up if enabled during compilation.*
|
|
|
|
---
|
|
|
|
**Supported Operating Systems**
|
|
|
|
We currently target OpenFPGA for:
|
|
1. Ubuntu 18.04
|
|
2. Red Hat 7.5
|
|
|
|
*The tool was tested with these operating systems. It might work with earlier versions and other distributions.*
|
|
|
|
## Running with pre-built docker image
|
|
|
|
```bash
|
|
# To get the docker image from the repository,
|
|
docker pull ghcr.io/lnis-uofu/openfpga-master:latest
|
|
|
|
# To invoke openfpga_shell
|
|
docker run -it ghcr.io/lnis-uofu/openfpga-master:latest openfpga/openfpga bash
|
|
```
|
|
|
|
## Backward compatibility with OpenFPGA v1.1
|
|
|
|
OpenFPGA v1.2 is a major upgrade over v1.1, which upgrades the internal VPR engine.
|
|
The (VPR) architecture files used with v1.1 may not be compatible with v1.2.
|
|
|
|
You can upgrade your architecture files with script
|
|
|
|
```bash
|
|
python3 openfpga_flow/scripts/arch_file_updater.py \
|
|
--input_file ${v1.1_arch_file} \
|
|
--output_file ${v1.2_compatible_arch_file}
|
|
```
|
|
|
|
Or, If you want to stay with v1.1, the final build was (tag: [_OpenFPGA:v1.1.541](https://github.com/lnis-uofu/OpenFPGA/tree/v1.1.541
|
|
))
|
|
|
|
```bash
|
|
https://github.com/lnis-uofu/OpenFPGA/tree/v1.1.541
|
|
```
|
|
|
|
or you can download the docker image
|
|
|
|
```bash
|
|
docker pull ghcr.io/lnis-uofu/openfpga-master:v1.1.541
|
|
```
|
|
|
|
## Documentation
|
|
|
|
OpenFPGA's [full documentation](https://openfpga.readthedocs.io/en/master/) includes tutorials, descriptions of the design flow, and tool options.
|
|
|
|
## Tutorials
|
|
|
|
You can find a set of [tutorials](https://openfpga.readthedocs.io/en/master/tutorials/), with which you get familiar with the tool and use OpenFPGA for various purposes.
|