Torii is a Python-based HDL and framework for implementing hardware designs for everything from FPGAs and CPLDs to ASICs and beyond with batteries included.
We are striving to make Torii one of the go-to platforms for the implementation and execution of any silicon-based witchcraft your heart could desire. To meet that end, there is a large collection of pre-defined board files for evaluation boards from various vendors, an ever improving standard library, and a collection of useful external modules.
For an introduction to Torii, installation instructions, and Usage information, please see the online documentation.
The two primary community spots for Torii are the #torii
IRC channel on libera.chat (irc.libera.chat:6697
) which you can join via your favorite IRC client or the web chat, and the discussion forum on GitHub.
Please do join and share your projects using Torii, ask questions, get help with problems, or discuss Torii's development.
We also maintain a list of projects using Torii, so post it in the show and tell section of the discussion forum and we'll add it!
The reporting of bugs and suggestion of features are done GitHub via the issue tracker, there are pre-defined templates for both of them that will walk you though all the information you need to provide.
Be sure to read the reporting issues or the suggesting features sections of the Contribution Guidelines as appropriate as they go into more important details on the finer points.
Torii can be used to target any FPGA or ASIC process that accepts behavioral Verilog-2001 as input. It also offers extended support for many FPGA families, providing toolchain integration, abstractions for device-specific primitives, and more. Specifically:
FPGA | Toolchain | |
---|---|---|
Proprietary | FOSS | |
Lattice iCE40 | iCECube2 | Yosys+nextpnr |
Lattice ECP5 | Lattice Diamond | |
Lattice MachXO3L | ||
Lattice MachXO2 | ||
Xilinx 7-series | Vivado | |
Xilinx UltraScale | ||
Xilinx Spartan 6 | ISE | |
Xilinx Spartan 3A | ||
Altera/Intel | Quartus | |
Quicklogic EOS S3 | Yosys+VPR |
Torii is released under the BSD-2-Clause, the full text of which can be found in the LICENSE
file in the root of the git repository.
The Torii documentation is dual licensed under the BSD-2-Clause for all past contributions and the CC-BY-SA 4.0 for all new and future contributions. The full text of the CC-BY-SA 4.0 can be found in the LICENSE.docs
file in the root of the git repository.