Project Tang

For FPGA Toolchain Users

Project Tang enables a fully open-source flow for Anlogic FPGAs using Yosys for Verilog synthesis and nextpnr for place and route. Project Tang itself provides the device database and tools for bitstream creation.

Getting Started

Current Status

Development Boards

For Developers

This repository contains both tools and scripts which allow you to document the bit-stream format of Anlogic series FPGAs.

Translation of offical documents can be found here.

Quickstart Guide

Take latest TD distribution from Sipeed.com Point out TD_HOME to your TangDinasty installation and set environment.

export TD_HOME=/opt/TD
source environment.sh

Process

To extract tilegrid information run:

python get_tilegrid_all.py

In order to get HTML representation of tilegrid data after run:

python html_all.py

Parts

Minitests

There are also "minitests" which are small tests of features used to build fuzers.

Fuzzers

Fuzzers are the scripts which generate the large number of bitstream.

They are called "fuzzers" because they follow an approach similar to the idea of software testing through fuzzing.

Tools

Miscellaneous tools for exploring the database and experimenting with bitstreams.

Util

Python libraries used for fuzzers and other purposes

Database

Running the all fuzzers in order will produce a database which documents the bitstream format in the database directory.

Credits

Contributing

There are a couple of guidelines when contributing to Project Tang which are listed here.

Sending

All contributions should be sent as GitHub Pull requests.

License

All code in the Project Tang repository is licensed under the very permissive ISC Licence. A copy can be found in the COPYING file.

All new contributions must also be released under this license.

Code of Conduct

By contributing you agree to the code of conduct. We follow the open source best practice of using the Contributor Covenant for our Code of Conduct.