Skip to content

Commit 08aaac9

Browse files
wanda-phiwhitequark
authored andcommitted
docs/guide: remove warning about lack of combinational loop detection.
1 parent f243cea commit 08aaac9

File tree

1 file changed

+0
-8
lines changed

1 file changed

+0
-8
lines changed

docs/guide.rst

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1250,14 +1250,6 @@ Whenever the signals ``en`` or ``b`` change, the signal ``a`` changes as well. I
12501250

12511251
A combinatorial signal that is computed directly or indirectly based on its own value is a part of a *combinatorial feedback loop*, sometimes shortened to just *feedback loop*. Combinatorial feedback loops can be stable (e.g. implement a constant driver or a transparent latch), or unstable (e.g. implement a ring oscillator). Amaranth prohibits using assignments to describe any kind of a combinatorial feedback loop, including transparent latches.
12521252

1253-
.. warning::
1254-
1255-
The current version of Amaranth does not detect combinatorial feedback loops, but processes the design under the assumption that there aren't any. If the design does in fact contain a combinatorial feedback loop, it will likely be **silently miscompiled**, though some cases will be detected during synthesis or place & route.
1256-
1257-
This hazard will be eliminated in the future.
1258-
1259-
.. TODO: fix this, either as a part of https://github.com/amaranth-lang/amaranth/issues/6 or on its own
1260-
12611253
.. note::
12621254

12631255
In the exceedingly rare case when a combinatorial feedback loop is desirable, it is possible to implement it by directly instantiating technology primitives (e.g. device-specific LUTs or latches). This is also the only way to introduce a combinatorial feedback loop with well-defined behavior in simulation and synthesis, regardless of the HDL being used.

0 commit comments

Comments
 (0)