The redesign introduces no fundamental incompatibilities, but it does
involve minor breaking changes:
* The simulator commands were moved from hdl.ast to back.pysim
(instead of only being reexported from back.pysim).
* back.pysim.DeadlineError was removed.
Summary of changes:
* The new simulator compiles HDL to Python code and is >6x faster.
(The old one compiled HDL to lots of Python lambdas.)
* The new simulator is a straightforward, rigorous implementation
of the Synchronous Reactive Programming paradigm, instead of
a pile of ad-hoc code with no particular design driving it.
* The new simulator never raises DeadlineError, and there is no
limit on the amount of delta cycles.
* The new simulator robustly handles multiclock designs.
* The new simulator can be reset, such that the compiled design
can be reused, which can save significant runtime with large
designs.
* Generators can no longer be added as processes, since that would
break reset(); only generator functions may be. If necessary,
they may be added by wrapping them into a generator function;
a deprecated fallback does just that. This workaround will raise
an exception if the simulator is reset and restarted.
* The new simulator does not depend on Python extensions.
(The old one required bitarray, which did not provide wheels.)
Fixes #28.
Fixes #34.
Fixes #160.
Fixes #161.
Fixes #215.
Fixes #242.
Fixes #262.
34 lines
846 B
Python
34 lines
846 B
Python
from nmigen import *
|
|
from nmigen.back import rtlil, verilog, pysim
|
|
|
|
|
|
class Counter(Elaboratable):
|
|
def __init__(self, width):
|
|
self.v = Signal(width, reset=2**width-1)
|
|
self.o = Signal()
|
|
self.en = Signal()
|
|
|
|
def elaborate(self, platform):
|
|
m = Module()
|
|
m.d.sync += self.v.eq(self.v + 1)
|
|
m.d.comb += self.o.eq(self.v[-1])
|
|
return EnableInserter(self.en)(m)
|
|
|
|
|
|
ctr = Counter(width=16)
|
|
|
|
print(verilog.convert(ctr, ports=[ctr.o, ctr.en]))
|
|
|
|
sim = pysim.Simulator(ctr)
|
|
sim.add_clock(1e-6)
|
|
def ce_proc():
|
|
yield; yield; yield
|
|
yield ctr.en.eq(1)
|
|
yield; yield; yield
|
|
yield ctr.en.eq(0)
|
|
yield; yield; yield
|
|
yield ctr.en.eq(1)
|
|
sim.add_sync_process(ce_proc)
|
|
with sim.write_vcd("ctrl.vcd", "ctrl.gtkw", traces=[ctr.en, ctr.v, ctr.o]):
|
|
sim.run_until(100e-6, run_passive=True)
|