sim - simulate the circuit

yosys> help sim

sim [options] [top-level]
This command simulates the circuit using the given top-level module.
-vcd <filename>
write the simulation results to the given VCD file
-fst <filename>
write the simulation results to the given FST file
-aiw <filename>
write the simulation results to an AIGER witness file
(requires a *.aim file via -map)
use the hdlname attribute when writing simulation results
(preserves hierarchy in a flattened design)
ignore constant x outputs in simulation file.
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)
mark that witness file is multiclock.
-reset <portname>
name of top-level reset input (active high)
-resetn <portname>
name of top-level inverted reset input (active low)
-rstlen <integer>
number of cycles reset should stay active (default: 1)
zero-initialize all uninitialized regs and memories
-timescale <string>
include the specified timescale declaration in the vcd
-n <integer>
number of clock cycles to simulate (default: 20)
do not activate $initstate cells during the first cycle
use all nets in VCD/FST operations, not just those with public names
writeback mode: use final simulation state as new init state
-r <filename>
read simulation or formal results file
    File formats supported: FST, VCD, AIW, WIT and .yw
    VCD support requires vcd2fst external tool to be present
-append <integer>
number of extra clock cycles to simulate for a Yosys witness input
-summary <filename>
write a JSON summary to the given file
-map <filename>
read file with port and latch symbols, needed for AIGER witness input
-scope <name>
scope of simulation top model
-at <time>
sets start and stop time
-start <time>
start co-simulation in arbitary time (default 0)
-stop <time>
stop co-simulation in arbitary time (default END)
simulation with stimulus from FST (default)
co-simulation expect exact match
co-simulation, x in simulation can match any value in FST
co-simulation, x in FST can match any value in simulation
fail the simulation command if, in the course of simulating,
any of the asserts in the design fail
disable per-cycle/sample log message
enable debug output