Metadata-Version: 2.1
Name: torii
Version: 0.4.5
Summary: Torii hardware definition language
Home-page: https://torii.shmdn.link/
Author: Aki Van Ness, Rachel Mant
Author-email: aki@lethalbit.net, git@dragonmux.network
License:  BSD-2-Clause
Project-URL: Documentation, https://torii.shmdn.link/
Project-URL: Source Code, https://github.com/shrine-maiden-heavy-industries/torii-hdl
Project-URL: Bug Tracker, https://github.com/shrine-maiden-heavy-industries/torii-hdl/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: ~=3.9
Description-Content-Type: text/markdown
Provides-Extra: remote-build
Provides-Extra: dev
License-File: LICENSE

# Torii-HDL

Torii is a fork of [Amaranth HDL](https://github.com/amaranth-lang) that has been modified for use at [Shrine Maiden Heavy Industries](https://shrine-maiden-heavy.industries/). It has merged several of the components that were separate into a single package, and also adds new functionality, as well as some internal changes for better integration into tooling.

The evaluation board definitions have also been migrated and are located in the [torii-boards](https://github.com/shrine-maiden-heavy-industries/torii-boards) repository.


There is also a list of [projects using Torii](https://torii.shmdn.link/projects.html) that are using Torii, and we'd love to add yours too!


## Introduction

Please see the [Torii Introduction](https://shrine-maiden-heavy-industries.github.io/torii-hdl/intro.html) on the [online documentation](https://shrine-maiden-heavy-industries.github.io/torii-hdl/)


## Installation

Please see the [installation instructions](https://shrine-maiden-heavy-industries.github.io/torii-hdl/install.html) on the [online documentation](https://shrine-maiden-heavy-industries.github.io/torii-hdl/)

## Supported devices

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:

<table>
<thead>
  <tr>
    <th rowspan="3">FPGA</th>
    <th colspan="2">Toolchain</th>
  </tr>
  <tr></tr>
  <tr>
    <th>Proprietary</th>
    <th>FOSS</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td>Lattice iCE40</td>
    <td>iCECube2</td>
    <td rowspan="4">Yosys+nextpnr</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Lattice ECP5</td>
    <td rowspan="6">Lattice Diamond</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Lattice MachXO3L</td>
    <td rowspan="14"></td>
  </tr>
  <tr></tr>
  <tr>
    <td>Lattice MachXO2</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Xilinx 7-series</td>
    <td rowspan="4">Vivado</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Xilinx UltraScale</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Xilinx Spartan 6</td>
    <td rowspan="4">ISE</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Xilinx Spartan 3A</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Altera/Intel</td>
    <td>Quartus</td>
  </tr>
  <tr></tr>
  <tr>
    <td>Quicklogic EOS S3</td>
    <td></td>
    <td>Yosys+VPR</td>
  </tr>
</tbody>
</table>



## License

Torii is released under the [BSD-2-Clause](https://spdx.org/licenses/BSD-2-Clause.html), the full text of which can be found in the [LICENSE](LICENSE) file.
