mirror of
https://github.com/YosysHQ/yosys
synced 2025-06-07 06:33:24 +00:00
docs: Some extra bugpoint bullets
This commit is contained in:
parent
80d742fe5a
commit
507e316d92
1 changed files with 21 additions and 1 deletions
|
@ -67,8 +67,11 @@ Minimizing RTLIL designs with bugpoint
|
||||||
+ output design after `bugpoint` with `write_rtlil`
|
+ output design after `bugpoint` with `write_rtlil`
|
||||||
+ use ``-grep "<string>"`` to only accept a minimized design that crashes
|
+ use ``-grep "<string>"`` to only accept a minimized design that crashes
|
||||||
with the ``<string>`` in the log file
|
with the ``<string>`` in the log file
|
||||||
|
|
||||||
|
* only checks log file, will not match runtime errors
|
||||||
|
|
||||||
+ ``-modules``, ``-ports``, ``-cells``, and ``-processes`` will enable those
|
+ ``-modules``, ``-ports``, ``-cells``, and ``-processes`` will enable those
|
||||||
parts of the design to be removed
|
parts of the design to be removed (default is allow removing all)
|
||||||
|
|
||||||
* use the ``bugpoint_keep`` attribute on objects you don't want to be
|
* use the ``bugpoint_keep`` attribute on objects you don't want to be
|
||||||
removed, usually because you already know they are related to the failure
|
removed, usually because you already know they are related to the failure
|
||||||
|
@ -89,6 +92,23 @@ Minimizing RTLIL designs with bugpoint
|
||||||
others such as ``YOSYS_NOVERIFIC`` and ``HOME`` are evaluated each time they
|
others such as ``YOSYS_NOVERIFIC`` and ``HOME`` are evaluated each time they
|
||||||
are used.
|
are used.
|
||||||
|
|
||||||
|
- check minimized design still fails, especially if not using `write_rtlil`
|
||||||
|
|
||||||
|
+ e.g. if you ran :ref:`bugpoint_script` below, then calling ``yosys -s
|
||||||
|
<failure.ys> min.v`` should still fail in the same way
|
||||||
|
+ `write_rtlil` is more reliable since `bugpoint` will have run that exact
|
||||||
|
code through the failing script; other ``write_*`` commands convert from the
|
||||||
|
RTLIL and then back again during the ``read_*`` which can result in
|
||||||
|
differences which mean the design no longer fails
|
||||||
|
|
||||||
|
.. code-block:: yoscrypt
|
||||||
|
:caption: example `bugpoint` minimizer
|
||||||
|
:name: bugpoint_script
|
||||||
|
|
||||||
|
read_verilog design.v
|
||||||
|
bugpoint -script <failure.ys>
|
||||||
|
write_verilog min.v
|
||||||
|
|
||||||
|
|
||||||
.. _minimize your script:
|
.. _minimize your script:
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue