TerosHDL command line

Command line version of TerosHDL (https://terostechnology.github.io). Current features:

• Documenter.

Requirements

• nodejs >= v12.0.0

Installation

• Installation from NPM:

npm install -g teroshdl

• From sources:

sudo npm install .

Documentation

Full documentation: https://terostechnology.github.io/terosHDLdoc/documenter/command_line.html

Getting started

• Arguments

-i, --input [path], Directory with the HDL files, path of the YML (with EDAM format) file for documenter or CSV. Check the documentation for more information
-o, --out [type], Documentation format: md, html (default: "markdown")
--dep, --dep', Include dependency graph in the documentation
--fsm, --fsm', Include finite state machines in the documentation
-s, --signals , Include signals/regs/wires in the documentation ['none', 'all', 'only_commented']
-c, --constants , Include constants/types in the documentation ['none', 'all', 'only_commented']
-p, --process , Include process/always in the documentation ['none', 'all', 'only_commented']
--sym-verilog, --symbol_verilog , Special character to parse comments into documentation
--sym-vhdl, --symbol_vhdl , Special character to parse comments into documentation
--pypath, --python_path , Explicit python path
--outpath, --outpath , Explicit outputh documentation path
--self, --self_contained , Documentation generated in a single file for html output

Examples

Documenter with teros project manager file or EDAM file

Check the EDAM format: https://edalize.readthedocs.io/en/latest/edam/api.html

cd /bin/example/doc
teroshdl-hdl-documenter -i example_edam.yml -o markdown
teroshdl-hdl-documenter -i example_edam.yml -o html
teroshdl-hdl-documenter -i example.csv -o html
teroshdl-hdl-documenter -i ../rtl -o html