mirrors/yosys
3
0
Fork 0
mirror of https://github.com/YosysHQ/yosys synced 2026-03-02 11:46:57 +00:00
Code Activity

Cleanup docs.

Browse source
This commit is contained in:
nella 2026-02-18 09:24:41 +01:00
parent e6e57b33e3
commit 2b4f481850
3 changed files with 19 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

24
docs/source/using_yosys/more_scripting/model_checking.rst
View file

@ -121,29 +121,29 @@ Result with fixed :file:`axis_master.v`:
Witness framework and per-property tracking
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When using AIGER-based formal verification flows (such as the ``abc`` engine in
SymbiYosys), Yosys provides infrastructure for tracking individual formal
When using AIGER-based formal verification flows (such as the `abc` engine in
SBY), Yosys provides infrastructure for tracking individual formal
properties through the verification pipeline.
The ``rename -witness`` pass (run automatically by ``prep``) assigns public
The `rename -witness` pass (run automatically by `prep`) assigns public
names to all cells that participate in the witness framework:
- Witness signal cells: ``$anyconst``, ``$anyseq``, ``$anyinit``,
``$allconst``, ``$allseq``
- Formal property cells: ``$assert``, ``$assume``, ``$cover``, ``$live``,
``$fair``, ``$check``
- Witness signal cells: `$anyconst`, `$anyseq`, `$anyinit`,
`$allconst`, `$allseq`
- Formal property cells: `$assert`, `$assume`, `$cover`, `$live`,
`$fair`, `$check`
These public names allow downstream tools to refer to individual properties by
their hierarchical path rather than by anonymous internal identifiers.
The ``write_aiger -ywmap`` option generates a JSON map file that includes, among
The `write_aiger -ywmap` option generates a JSON map file that includes, among
other things, ``"asserts"`` and ``"assumes"`` arrays. Each entry contains the
hierarchical witness path of the corresponding ``$assert`` or ``$assume`` cell.
This lets tools such as SymbiYosys map AIGER bad-state properties and invariant
hierarchical witness path of the corresponding `$assert` or `$assume` cell.
This lets tools such as SBY map AIGER bad-state properties and invariant
constraints back to individual formal properties, enabling features like
per-property pass/fail reporting (e.g. ``abc pdr`` with ``--keep-going`` mode).
per-property pass/fail reporting (e.g. `abc pdr` with ``--keep-going`` mode).
The ``write_smt2`` backend similarly uses the public witness names when emitting
The `write_smt2` backend similarly uses the public witness names when emitting
``yosys-smt2-assert`` and ``yosys-smt2-assume`` comments. Cells whose
``hdlname`` attribute contains the ``_witness_`` marker are treated as having
private names for comment purposes, keeping solver output clean.