Simulationen ausführen

Simulationen laufen auf dem Backend von Subaya. Sie reichen eine Testbench und ein Top-Modul über die CLI ein, warten auf das Ergebnis und lesen dann Bericht, Logs und Waveform. Dieser Leitfaden führt durch den vollständigen Ablauf mit suya sim.

Unterstützte Tools

suya sim run kann mit --tool jeden dieser Simulatoren ansteuern:

Tool	Hinweise
ryusim	RyuSim, der SystemVerilog-Simulator von Subaya
verilator	Verilator
icarus	Icarus Verilog
questa	Questa
xsim	Vivado xsim
renode	Renode (Embedded)

Eine Simulation ausführen

Richten Sie suya sim run mindestens auf Ihre Testbench aus und benennen Sie das Top-Modul:

suya sim run --tb <path-to-testbench> --top <top-module>

Das Projekt wird standardmäßig aus .subaya/config.toml übernommen; übergeben Sie --project <project-id>, um dies zu überschreiben. Nützliche Optionen:

suya sim run \
  --tb tb/top_tb.sv \
  --top top_tb \
  --source rtl/ \
  --tool verilator \
  --tier S \
  --wait \
  --no-cache

• --source <dir> — das Quellverzeichnis, das neben der Testbench einbezogen werden soll.
• --tool <name> — einen Simulator wählen (siehe Tabelle oben).
• --tier <S> — eine Compute-Tier für den Lauf anfordern.
• --wait — blockieren, bis der Lauf abgeschlossen ist, anstatt sofort zurückzukehren.
• --no-cache — einen frischen Lauf erzwingen und zwischengespeicherte Ergebnisse ignorieren.
• --arg <a> — ein zusätzliches Argument an das Tool durchreichen (wiederholbar).

Die Ergebnisse lesen

Listen Sie Ihre letzten Läufe auf, um eine Lauf-ID zu finden:

suya sim list

Rufen Sie den Status und eine Ergebniszusammenfassung für einen Lauf ab:

suya sim report <run-id>

Verfolgen Sie die Logs, optional live mitlaufend:

suya sim logs <run-id>
suya sim logs <run-id> --follow

Neu ausführen

Reichen Sie dieselbe Quelle und Spezifikation als frischen Lauf erneut ein:

suya sim rerun <run-id> --wait

Waveforms — an wf übergeben

Lokalisieren Sie das von einem Lauf erzeugte Waveform-Artefakt:

suya sim wave <run-id>

Dies verweist Sie auf die Waveform, die Sie mit der wf-Waveform-CLI analysieren — dem WAL-basierten Waveform-Analysetool von Subaya.

Nächste Schritte

• Workspaces & Projekte — wo Simulationen leben.
• CLI: sim — die vollständige suya sim-Referenz.