aboutsummaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorMiodrag Milanovic <mmicko@gmail.com>2022-04-04 16:53:47 +0200
committerMiodrag Milanovic <mmicko@gmail.com>2022-04-04 16:53:47 +0200
commit0d3bf9e725512f944a3265a0cdb70a5361ce4105 (patch)
tree9385a91549c3d26717934d0e22bc0df8b9d42d7f /manual
parent75f484768946e50f02baba1d813e82f980e2c86f (diff)
downloadyosys-0d3bf9e725512f944a3265a0cdb70a5361ce4105.tar.gz
yosys-0d3bf9e725512f944a3265a0cdb70a5361ce4105.tar.bz2
yosys-0d3bf9e725512f944a3265a0cdb70a5361ce4105.zip
Update CHANGELOG and manual
Diffstat (limited to 'manual')
-rw-r--r--manual/command-reference-manual.tex56
1 files changed, 54 insertions, 2 deletions
diff --git a/manual/command-reference-manual.tex b/manual/command-reference-manual.tex
index e3055c0bc..e68da3318 100644
--- a/manual/command-reference-manual.tex
+++ b/manual/command-reference-manual.tex
@@ -2222,6 +2222,40 @@ one-hot encoding and binary encoding is supported.
.map <old_bitpattern> <new_bitpattern>
\end{lstlisting}
+\section{fst2tb -- generate testbench out of fst file}
+\label{cmd:fst2tb}
+\begin{lstlisting}[numbers=left,frame=single]
+ fst2tb [options] [top-level]
+
+This command generates testbench for the circuit using the given top-level module
+and simulus signal from FST file
+
+ -tb <name>
+ generated testbench name.
+ files <name>.v and <name>.txt are created as result.
+
+ -r <filename>
+ read simulation FST file
+
+ -clock <portname>
+ name of top-level clock input
+
+ -clockn <portname>
+ name of top-level clock input (inverse polarity)
+
+ -scope <name>
+ scope of simulation top model
+
+ -start <time>
+ start co-simulation in arbitary time (default 0)
+
+ -stop <time>
+ stop co-simulation in arbitary time (default END)
+
+ -n <integer>
+ number of clock cycles to simulate (default: 20)
+\end{lstlisting}
+
\section{glift -- create GLIFT models and optimization problems}
\label{cmd:glift}
\begin{lstlisting}[numbers=left,frame=single]
@@ -3300,6 +3334,9 @@ are then merged to one cell.
-share_all
Operate on all cell types, not just built-in types.
+
+ -keepdc
+ Do not merge flipflops with don't-care bits in their initial value.
\end{lstlisting}
\section{opt\_muxtree -- eliminate dead trees in multiplexer trees}
@@ -4924,12 +4961,18 @@ This command simulates the circuit using the given top-level module.
-x
ignore constant x outputs in simulation file.
+ -date
+ include date and full version info in output.
+
-clock <portname>
name of top-level clock input
-clockn <portname>
name of top-level clock input (inverse polarity)
+ -multiclock
+ mark that witness file is multiclock.
+
-reset <portname>
name of top-level reset input (active high)
@@ -4955,12 +4998,13 @@ This command simulates the circuit using the given top-level module.
writeback mode: use final simulation state as new init state
-r
- read simulation results file (file formats supported: FST)
+ read simulation results file (file formats supported: FST, VCD, AIW and WIT)
+ VCD support requires vcd2fst external tool to be present
-map <filename>
read file with port and latch symbols, needed for AIGER witness input
- -scope
+ -scope <name>
scope of simulation top model
-at <time>
@@ -4984,6 +5028,9 @@ This command simulates the circuit using the given top-level module.
-sim-gate
co-simulation, x in FST can match any value in simulation
+ -q
+ disable per-cycle/sample log message
+
-d
enable debug output
\end{lstlisting}
@@ -7949,6 +7996,9 @@ invariant constraints.
-vmap <filename>
like -map, but more verbose
+ -no-startoffset
+ make indexes zero based, enable using map files with smt solvers.
+
-I, -O, -B, -L
If the design contains no input/output/assert/flip-flop then create one
dummy input/output/bad_state-pin or latch to make the tools reading the
@@ -8437,6 +8487,7 @@ Where <port_details> is:
"bits": <bit_vector>
"offset": <the lowest bit index in use, if non-0>
"upto": <1 if the port bit indexing is MSB-first>
+ "signed": <1 if the port is signed>
}
The "offset" and "upto" fields are skipped if their value would be 0.They don't affect connection semantics, and are only used to preserve originalHDL bit indexing.And <cell_details> is:
@@ -8483,6 +8534,7 @@ And <net_details> is:
"bits": <bit_vector>
"offset": <the lowest bit index in use, if non-0>
"upto": <1 if the port bit indexing is MSB-first>
+ "signed": <1 if the port is signed>
}
The "hide_name" fields are set to 1 when the name of this cell or net is