Erste RTL-Simulation in Digital Design Studio
Erste RTL-Simulation in Digital Design Studio für Windows. Öffnen Sie das Zählerbeispiel, führen Sie seine Testbench auf Ihrem PC aus und lesen Sie die Wellenform.
Digital Design Studio für Windows: Dieses Tutorial führt eine Testbench auf Ihrem PC mit den OSS CAD Suite-Simulatoren aus, die die App erst herunterlädt und installiert, wenn Sie es verlangen. Die veröffentlichten Pakete finden Sie unter Downloads.
Überblick
Digital Design Studio enthält ein kleines Beispielprojekt: einen 4-Bit-Zähler (rtl/counter.sv) und seine Testbench (tb/counter_tb.sv). In diesem Tutorial öffnen Sie das Beispiel, installieren die Simulatoren einmalig, klicken auf Ausführen und lesen die Wellenform. Die Simulation läuft auf Ihrem PC und startet keinen Cloud-Job.
Sie benötigen:
Die Windows-App von Digital Design Studio unter Windows x64.
Ein Altifigence-Konto ist optional: Sie können die Simulatoren ohne Anmeldung ausführen, und die Windows-App benötigt keine Gerätelizenz.
Eine Internetverbindung für einen einmaligen Download von etwa 574 MiB von GitHub. Nach der Installation verbleiben etwa 226 MiB auf Ihrem PC.
Installieren und anmelden
Laden Sie die Windows-App unter Downloads herunter und installieren Sie sie wie in der Windows-Installationsanleitung beschrieben.
Starten Sie Digital Design Studio. Wählen Sie unter Sign in to Digital Design Studio die Option Continue with Altifigence und schließen Sie die Anmeldung im Browser ab.
Wenn Sie stattdessen Continue without login wählen, können Sie das Beispiel trotzdem öffnen, bearbeiten und ausführen; melden Sie sich später an, wenn Sie Kontodienste wie Cloud oder KI benötigen.
Das Zählerbeispiel öffnen
Wenn ein neuer Benutzer die App zum ersten Mal auf einem PC startet, öffnet sich das Zählerbeispiel nach der Anmeldung oder nach dem Fortfahren ohne Anmeldung von selbst. Die App öffnet die Testbench tb/counter_tb.sv und den Tab RTL simulation.
Das Beispiel öffnet sich nicht von selbst, wenn Digital Design Studio auf diesem PC bereits verwendet wurde (zum Beispiel eine gespeicherte Anmeldung, ein zuletzt verwendetes Projekt oder Academy-Projekt oder ein gespeichertes Fenster), wenn die App zum Öffnen eines bestimmten Projekts gestartet wurde oder wenn die Organisation, bei der Sie angemeldet sind, bereits Cloud-Projekte hat. So öffnen Sie es selbst:
Öffnen Sie oben im Navigationsbereich das Umgebungsmenü und wählen Sie Lokal.
Wählen Sie unter Projekte auf diesem PC die Option Beispiel öffnen. Wenn bereits ein Projekt auf diesem PC geöffnet ist, wählen Sie Lokal unterhalb der Projektliste, um zu dieser Seite zurückzukehren.
Speichern Sie zuerst Ihre Änderungen und lassen Sie laufende Aufgaben abschließen: Die App wechselt das Projekt nicht, solange es ungespeicherte Arbeit oder eine laufende Aufgabe gibt.
Das Beispiel ist Ihre eigene Kopie und wird einmalig im Datenordner der App angelegt. Wenn Sie es erneut öffnen, bleiben Ihre Änderungen erhalten.
Datei | Inhalt |
|---|---|
| Ein 4-Bit-Zähler mit asynchronem, Low-aktivem Reset ( |
| Die Testbench. Sie setzt den Zähler zurück, aktiviert ihn für 20 Taktzyklen, prüft, dass der Zählerstand übergelaufen und bei 4 angekommen ist, und schreibt |
| Eine kurze Beschreibung des Beispiels. |
| Hält den Ordner |
Die OSS-Simulatoren installieren (einmalig)
Digital Design Studio liefert die Simulatoren nicht mit. Auf Ihre Anforderung lädt es den offiziellen YosysHQ OSS CAD Suite-Build 2026-10-09 herunter, prüft den Download gegen einen festgelegten SHA-256-Wert und installiert nur die Dateien, die Icarus Verilog, Verilator und GTKWave benötigen.
Lassen Sie im Tab RTL simulation die Option Prüfstand ausgewählt. Solange die Simulatoren nicht installiert sind, zeigt der Bereich »Die OSS CAD Suite-Simulatorerweiterung ist nicht installiert. Run installiert es zuerst.«
Klicken Sie auf Ausführen. Wählen Sie unter Die OSS CAD Suite-Simulatoren installieren? die Option Herunterladen und installieren. Jetzt nicht schließt den Dialog, ohne etwas zu installieren.
Der Dialog zeigt den Download, die SHA-256-Prüfung und die Installation. Abbrechen bricht den Vorgang ab; der teilweise Download bleibt erhalten und wird beim nächsten Mal fortgesetzt.
Wenn die Installation abgeschlossen ist, startet der Lauf.
Sie können die Simulatoren auch vorab installieren: Öffnen Sie Plugins, markieren Sie OSS CAD Suite-Simulatoren und wählen Sie Installieren. Spätere Läufe auf diesem PC verwenden dieselbe Installation.
Die Testbench ausführen
Prüfen Sie den Bereich: Prüfstand ist
counter_tb · tb/counter_tb.sv, Simulator ist Icarus Verilog und Wellenformformat ist VCD. Darunter zeigt der Bereich »2 Quelldatei(en) · oben counter_tb«.Klicken Sie auf Ausführen. Der Lauf speichert zuerst geänderte
.v-,.sv-,.svh- und.vh-Dateien. Anschließend kompiliert er alle.v- und.sv-Dateien im Projekt mit Ausnahme der Dateien unter.alti/,.altifigence/,.git/undnode_modules/, mit der ausgewählten Testbench als Top-Modul.Wenn der Lauf besteht, zeigt der Bereich Bestanden mit der Simulatorversion und der Laufzeit an und öffnet darunter die Wellenform.
Klappen Sie Simulatorprotokoll auf, um die Ausgabe von Compiler und Simulator zu sehen. Die Testbench gibt
counter_tb: PASS count=4 at 260 nsaus.
Das Ergebnis lesen
Die Taktperiode beträgt 10 ns. Die Testbench ändert ihre Eingänge an fallenden Taktflanken, und der Zähler zählt an steigenden Flanken. Die Wellenform zeigt:
Zeit | Signale |
|---|---|
0–20 ns |
|
20 ns |
|
30 ns |
|
35–225 ns |
|
230 ns |
|
260 ns | Die Testbench prüft |
Die Statuszeile zeigt, wie der Lauf geendet hat:
Status | Bedeutung |
|---|---|
Bestanden · … | Der Simulator wurde mit Exit-Code 0 beendet, und das Testbench-Protokoll hat keinen Fehlschlag gemeldet. |
fehlgeschlagen (Exit-Code N) · … | Der Simulator wurde mit einem Exit-Code ungleich null beendet, zum Beispiel nach einem Kompilierungsfehler. Lesen Sie unter Simulatorprotokoll die Meldung des Compilers oder der Testbench. Wenn Digital Design Studio die Eingabe vor der Simulation ablehnt, erklärt das Protokoll den abgelehnten Pfad oder die abgelehnte Einstellung; ein fehlender Exit-Code des Simulators bedeutet keinen abgeschlossenen Lauf. |
Prüfstand meldet einen Fehlschlag · … | Der Simulator wurde mit Exit-Code 0 beendet, aber das Testbench-Protokoll meldete einen Fehler. Lesen Sie die Fehlermeldung im Simulatorprotokoll. |
Nach Ablauf der Frist gestoppt · … | Der Lauf dauerte länger als 2 Minuten, das Limit für Läufe aus diesem Bereich. |
Abgebrochen | Sie haben während des Laufs auf Abbrechen geklickt. |
Jeder Lauf wird in einem eigenen Ordner unter .alti/sim/ des Projekts gespeichert, mit der Wellenform und einer receipt.json. Der Receipt enthält das Simulatorprotokoll und die Version, das OSS CAD Suite-Release und den SHA-256-Wert jeder Quelldatei und jeder eingebundenen Datei. Digital Design Studio behält die 20 neuesten Läufe. Wenn sich während eines Laufs eine Quelldatei, eine eingebundene Datei oder eine Verilog-Einstellung ändert, wird der Lauf als fehlgeschlagen markiert; führen Sie ihn erneut aus.
Häufige Fehler beheben
Symptom | Was zu tun ist |
|---|---|
Das Beispiel hat sich nicht von selbst geöffnet | Der automatische Start gilt nur für neue Benutzer. Wählen Sie Beispiel öffnen unter Projekte auf diesem PC (Lokal). |
»Das Beispielprojekt konnte nicht geöffnet werden. Wählen Sie unter „Lokal“ die Option „Beispiel öffnen“, um es erneut zu versuchen.« | Wählen Sie Beispiel öffnen unter Lokal. Solange das Beispiel nicht existiert, versuchen es auch spätere Starts der App erneut, insgesamt höchstens drei Versuche. |
Es gibt keine Schaltfläche Prüfstand | Öffnen Sie in der Windows-App ein Projekt auf diesem PC und führen Sie die Testbench in der Ansicht Prüfstand aus. |
»Keine Testbench gefunden. …« | Eine Testbench ist ein Modul ohne Ports, das von keinem anderen Modul instanziiert wird, zum Beispiel |
Der Download schlägt fehl oder bleibt hängen | Prüfen Sie Verbindung, Proxy oder Firewall für github.com, release-assets.githubusercontent.com und objects.githubusercontent.com und klicken Sie dann erneut auf Ausführen. Der Download wird dort fortgesetzt, wo er angehalten hat. |
Antivirensoftware hat eine Datei blockiert, oder Icarus Verilog startet nicht | Notieren Sie die genaue Meldung der Sicherheitssoftware und prüfen Sie den offiziellen Download und den erwarteten Hash. Deaktivieren Sie den Schutz nicht und fügen Sie keine weitreichende Ausnahme hinzu, nur um den Lauf zu erzwingen. Bitten Sie den Support oder Ihre Administration, die konkrete Erkennung zu prüfen, bevor Sie es erneut versuchen. |
Nicht genügend freier Speicherplatz | Geben Sie den in der Meldung angezeigten Speicherplatz frei und versuchen Sie es erneut. |
Verilator kann nicht ausgewählt werden | Verilator benötigt auf diesem PC einen C++-Compiler und make, zum Beispiel MSYS2 UCRT64 mit |
»Dieser Lauf hat keine Wellenform geschrieben. …« | Fügen Sie der Testbench |
Die Wellenform ist größer als 32 MiB | Grenzen Sie |
Include-Dateien und Makros
Legen Sie eingebundene
.svh- und.vh-Header im Projekt ab. Die RTL-Kompilierung, Icarus Verilog und Verilator suchen zuerst im Projektstamm, dann in Include-Verzeichnisse in der gespeicherten Reihenfolge und danach in den gefundenen Quellordnern in alphabetischer Reihenfolge. Wenn ein anderer Header neben der einbindenden Datei abweicht, nennen Probleme und Simulatorprotokoll beide Pfade und den verwendeten Header.Wenn Simulatorprotokoll meldet, dass eine eingebundene Datei nicht gefunden wurde, fügen Sie ihren Ordner relativ zum Projektstamm unter Include-Verzeichnisse in Projekt (Flow Navigator → Projektverwaltung → Einstellungen → Projekt → Include-Verzeichnisse) hinzu und klicken Sie dann erneut auf Ausführen. Geben Sie Makros unter Projekt → Definitionen ein, ein
NAMEoderNAME=VALUEpro Zeile.Wird eine Datei von außerhalb des Projekts eingebunden, schlägt der Lauf fehl, bevor die Simulation startet. Simulatorprotokoll meldet dann »… is outside the project: copy it into the project and include it from there«.
Ein Eintrag in Include-Verzeichnisse, der aus dem Projekt hinaus zeigt oder
..enthält, oder ein ungültiger Makroname in Definitionen stoppt den Lauf mit einer Meldung, die den Eintrag nennt. Korrigieren oder entfernen Sie ihn. Ein aufgeführter Ordner, der nicht existiert, wird mit einer Warnung in Simulatorprotokoll übersprungen.Geänderte Einstellungen gelten ab dem nächsten Lauf. Die Editor-Diagnose verwendet sie, nachdem Sie das Projekt erneut geöffnet haben.
Nächste Schritte
Ändern Sie die Testbench, zum Beispiel die Anzahl der aktivierten Taktzyklen und den erwarteten Zählerstand, und klicken Sie dann erneut auf Ausführen. Der Lauf speichert Ihre Änderungen zuerst.
Installieren Sie einen C++-Compiler und make, wählen Sie Verilator unter Simulator und vergleichen Sie das Ergebnis mit Icarus Verilog.
Führen Sie Ihr eigenes Design aus: Wählen Sie unter Projekte auf diesem PC die Option Projektordner öffnen oder Neues Projekt. Fügen Sie Ihre
.v- und.sv-Quellen und eine Testbench hinzu, die mit$dumpfileund$dumpvarseine Wellenform schreibt. Öffnen Sie dann den Tab RTL simulation über Flow Navigator → Simulation → Simulation ausführen → Simulationseinrichtung öffnen. Wenn Sie nicht angemeldet sind, öffnet Simulation ausführen den Tab direkt.Zum Bearbeiten und Speichern von Projekten siehe Workspace; zu Verilog-Dateien siehe Verilog.
Plattformunterschiede sowie die Bedingungen für die Unternehmens-KI, den Speicher und das Konto, die getrennt von dieser lokalen Simulation gelten, finden Sie im Support-Leitfaden.