sphinx-hwt
Extension for Sphinx document generator. Add automatically generated schemes and other visual documentation of hardware. Currently mainly for HWT library (but VHDL,Verilog -> HWT is possible).
Live demo is documentation of hwtLib library, this library contains many components. The schematic is in documentation of compoents for example there in documentation of CRC generator.
Installation
Install as standard python package, using pip. If you have NPM installed javascript in package will be updated.
pip3 install sphinx-hwt
sphinx-hwt package provides sphinx_hwt extension for sphinx doc. gen. In order to use this extension you have to register in in your conf.py sphinx doc. configuration.
extensions = ['sphinx_hwt']
From now Sphinx will be able to use directives from sphinx-hwt to render schematics and others.
Usage
Add hwt-schematic directive in docstring of Unit class like this (will add scheme to a html doc).
from hwt.synthesizer.unit import Unit
def explicit_constructor():
return ExampleCls0()
class ExampleCls0(Unit):
"""
.. hwt-schematic::
or
.. hwt-schematic:: explicit_constructor
There are also other directives, read the feature list below.
"""
Feature list
- hwt-params - generates a list of hwt Params for Interface/Unit classes with a information about value and type
- hwt-interface - generates a list of IO interfaces of the Interface/Unit class
- hwt-components - generates a list of components for the Unit class
- hwt-schematic:
- generate interactive schematic for Unit instances (= module in verilog, entity + architecutere in VHDL).
- zoom, pan, dynamic colapsing, net-select, searching and filtering
- schematic rendered by d3-hwschematic library
- Unit instances to graph conversion by hwtGraph library
- generate interactive schematic for Unit instances (= module in verilog, entity + architecutere in VHDL).
- hwt-autodoc: hwt-params, hwt-interface, hwt-components and hwt-schematic at once
Similar software
- symbolator - Python, hdl component symbol generator also for sphinx
1 maintainer
Release files for sphinx-hwt 2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinx-hwt-2.7.tar.gz | 588.3 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinx_hwt-2.7-py3.9.egg | Legacy Egg format | - | - | Details |
| sphinx_hwt-2.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.8 MB
Release files / sphinx-hwt-2.7.tar.gz
| Download URL | sphinx-hwt-2.7.tar.gz |
|---|---|
| Size | 588.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3c158a4dbefe6c6828eb025f6f9b4f4e3de9a32a64b7971effc5b289493c7c7
|
|
BLAKE2b-256 checksum How to use checksums |
f72ee080407dfe3216070eb099ce3f5497999537e2b4f774ba1b81aa7d678b2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.6
|
Release files / sphinx_hwt-2.7-py3.9.egg
| Download URL | sphinx_hwt-2.7-py3.9.egg |
|---|---|
| Size | 608.4 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
f3e6f04608fb115d96d137dc2b3c16baec0cf0c62f9a8a9097dbf50c6a3006db
|
|
BLAKE2b-256 checksum How to use checksums |
4c7f90feffbde83ccad8edcede70849c8ab8f89e900432a535fb1eee0cbd2008
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.6
|
Release files / sphinx_hwt-2.7-py3-none-any.whl
| Download URL | sphinx_hwt-2.7-py3-none-any.whl |
|---|---|
| Size | 595.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
003caafa250a5ec15d9e593091e5872628b335bd74664779cd32208b5df88404
|
|
BLAKE2b-256 checksum How to use checksums |
6470ad8c6e4d9ee8db656089a2d0522da2ff4853367851a434e9029f439cc36c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.6
|
