mirror of https://github.com/lnis-uofu/SOFA.git
46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# SOFA
|
|
[![linux_build](https://github.com/LNIS-Projects/skywater-openfpga/workflows/linux_build/badge.svg)](https://github.com/LNIS-Projects/skywater-openfpga/actions)
|
|
[![Documentation Status](https://readthedocs.org/projects/skywater-openfpga/badge/?version=latest)](https://skywater-openfpga.readthedocs.io/en/latest/?badge=latest)
|
|
|
|
## Introduction
|
|
|
|
SOFA (**S**kywater **O**pensource **F**PG**A**s) are a series of open-source FPGA IPs using the open-source [Skywater 130nm PDK](https://github.com/google/skywater-pdk) and [OpenFPGA](https://github.com/lnis-uofu/OpenFPGA) framework
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
#Clone the repository and go inside it
|
|
git clone https://github.com/LNIS-Projects/skywater-openfpga.git
|
|
python3 SCRIPT/repo_setup.py --openfpga_root_path ${OPENFPGA_PROJECT_DIRECTORY}
|
|
```
|
|
---
|
|
|
|
* If you have openfpga repository cloned at the same level of this project, you can simple call
|
|
```bash
|
|
python3 SCRIPT/repo_setup.py
|
|
```
|
|
|
|
Otherwise, you should provide full path using the option _--openfpga\_root\_path_
|
|
|
|
## Directory Organization
|
|
|
|
* Keep this folder clean and organized as follows
|
|
- **DOC**: documentation of the project
|
|
- **ARCH**: Architecture XML and other input files which OpenFPGA requires to generate Verilog netlists
|
|
- **BENCHMARK**: Benchmarks to be tested on the FPGA fabric
|
|
- **HDL**: Hardware description netlists for the FPGA fabrics
|
|
- **SDC**: design constraints
|
|
- **SCRIPT**: Scripts to setup, run OpenFPGA etc.
|
|
- **TESTBENCH**: Verilog testbenches generated by OpenFPGA
|
|
- **PDK**: Technology files linked from skywater opensource pdk
|
|
- **SNPS\_ICC2**: workspace of Synopsys IC Compiler 2
|
|
Keep a README inside the folder about the ICC2 version and how-to-use.
|
|
- **MSIM**: workspace of verification using Mentor ModelSim
|
|
|
|
---
|
|
|
|
* Note:
|
|
- Please **ONLY** place folders under this directory.
|
|
README should be the **ONLY** file under this directory
|
|
- Each EDA tool should have **independent** workspace in separated directories
|